文書規約についていろいろ考えるブログ【2025年5月】
文書規約についていろいろ考えるブログ【2025年5月】
文書規約 メニュー
さるでもわかるWEBライティング
文章の書き方
最初に、書き物をするとき、どのような視点で書き物をしていくべきか学びます。ここで重要になるのは「可読性」です。
次に「PCとスマートフォン」の違いについて学ぼます。「装飾」、「ですます調」「である調」を学び、「構造化文書」について学びます。
最後に「HTML」について学びます。
可読性
良い文章とは、誰が読んでも読みやすい文章です。
じっくり時間をかけて、よく考えながら読まないと読めない文章は、「良い文章」とは言えません。※厳密に表記する必要がある法令文書や公文書などは例外です。
読みやすさを専門的には「可読性」と言い、「可読性が高い文章」は良い文章です。
読む人を第一に考えた文章
システムの世界では良くある話で、短いソースコード（プログラムのこと、以降ソースコードと記述）が良いコード、高速に動くソースコードが良いコードと考えているプログラマーは多くいます。
最も重要な事は可読性であり、可読性の高さを優先すると、最短で表記されたソースコードより長くなります。また、最速を重視したソースコードより、やはり長くなります。
なぜ可読性が最重要なのか？読むのが難しいソースコードはバグの温床になりますし、誰も読めないソースコードはメンテナンス（仕様変更など）不能になります。
読みやすいソースコードは大多数のプログラマーが読む事ができ、メンテナンスも容易にできます。
作ってお仕舞いなら可読性を考える必要はありませんが、システムは作ってから毎年、沢山の仕様変更が入るため、可読性が低いソースコードはゴミ同然と考えてよいでしょう。
可読性が低いソースコードを書くプログラマーは、読む人の事を考えないプログラマーです。
文章でも同じ事が言えます。あなたはWEBで読みにくいニュースや雑誌を、一生懸命読みますか？
勉強や調べものではないのに、読みにくい文章は読みませんよね。
読み手の事を第一に考える書き手は、良い書き手（以降ライターと記述）です。読み手の事を第一に考えないライターは、ダメなライターです。
PCからスマートフォンへ
ニュースや雑誌などのWEBサイトの閲覧は、PCではなくスマホユーザーが大多数です。
PCは大画面で長い文章を読めますが、スマートフォンでは狭い画面で文章を読みます。
PCはイスなどに座って画面を閲覧しますが、スマートフォンでは立ったまま、寝転がって、電車の中でなど、様々な状態で利用します。
ライターあるあるなのですが、PCで読みやすかった文章をスマートフォンで読もうとすると、「あれ？」っと思う事は頻繁に発生します。
スマーフォンの特徴を十分理解していれば、スマートフォンでも、PCでも読みやすい文章を書くことができますが、不十分だとスマーフォンでは読みにくい文章になります。
逆の事もあります。スマートフォンで読みやすい文章でも、PCでは読みにくい文章になってしまうことも頻繁に発生します。
両方の特徴を十分に理解し、仕上がった文章を、PC・スマートフォン両方で確認して「最適化」していく作業が必要なのです。
フォントサイズ・スタイル
文章を、より効果的に見せる方法の1つに、フォントサイズ（文字サイズ）を大きくする、太くするという方法があります。
しかし、多くのニュースや雑誌などのWEBサイトは、見出し以外フォントサイズやスタイルに変更は加えません。理由はコストがかかってしまうためです。
フォントサイズやスタイル変更を加えることは簡単ですが、毎日沢山の記事をアップするサイトでは「フォントサイズをいくつにする」「フォントカラーは何色にする」「フォントスタイルは」のようにすべて決め事をしておかないと、全体のデザインがちぐはぐになってしまいます。
文章は常に同じルールで書くことで可読性が高くなります。
また、フォントの変更は思った以上に面倒で、実際にやってみると「このサイズかな？もう少し大きい方が？色は青よりネイビーの方が・・・」のように時間がかかります。
多くのライターは、そのうち「もうこれでいいや」となってしまうことが多いのです。
強調したい単語や文章のフォントサイズやスタイルの決め事をして、コストを許容できる範囲に収めることができるなら、フォントサイズやスタイルで強調表示するのは良い方法です。
規約を作り、ライターが規約を遵守し、リリース前に品質検査を行うことが重要です。
「ですます調」「である調」
「ですます調」「である調」は、誰でも聞いたことがあると思います。文書は「ですます調」「である調」を使い分ける必要があります。
「ですます調」は別名「敬体」と言います
「きょうは良い天気です」「私は電車で行きます」
「である調」は別名「常体」と言います。
「吾輩は猫である」「吾輩はネコだ」
「ですます調」と「である調」は一緒の文章で使用してはいけません。「ですます調」は「敬体」であり、敬語です。「である調」は「常体」であり、一般的な話し言葉です。
丁寧な説明が必要な相手には、基本的に「ですます調」を使用しますが、「論文」「レポート」「議事録」「感想文」「小説」「新聞」「雑誌」では「である調」を使用します。
簡潔な文章を書きたいときは「である調」で書くと効果的です。
構造化文書
構造化文書について学びます。
構造化文書とは
文書には、日記のような「思いつくままに書く文章」と、参考書のような「理解させる事を目的とした文章」があります。
「理解させる事を目的とした文章」は、全体をわかりやすくするために、文章を大きな単位、中くらいの単位、小さな単位でまとめた構造化文書（正規化された文書）で書かれています。
「理解させる事を目的とした文章」は「論理的な文章」とも言えます。
具体的には「国の予算」「法律」「契約書」などは厳密な定義があり、定義に沿って書くことで「書き手」「読み手」共に文書を正解に理解する事ができます。
構造化文書 例
一般的な文章
一般的な文書にも「本のタイトル」「第一章」「項目」などのように目次が振られています。
たとえば「スターウォーズ」だと以下のようになります。
- タイトル スターウォーズ
- エピソード1/ファントム・メナス編
- 第一章 クワイ＝ガン・ジンとオビ＝ワン・ケノービ
- 第一章 第一節 惑星ナブー
- 第一章 第一節 第一項 ジャー・ジャー・ビンクス
- 第一章 第一節 第二項 パドメ・アミダラ
- 第一章 第一節 惑星ナブー
- 第二章 惑星タトゥイーン
- 第二章 第一節 アナキン
- 第二章 第二節 ポッド・レース
- 第三章 ダース・モールの襲撃
- 第一章 クワイ＝ガン・ジンとオビ＝ワン・ケノービ
- エピソード2/クローンの攻撃 編
- エピソード3/シスの復讐 編
- エピソード4/新たなる希望 編
- エピソード5/帝国の逆襲 編
- エピソード6/ジェダイの帰還 編
- エピソード7/フォースの覚醒 編
- エピソード8/最後のジェダイ 編
- エピソード9/スカイウォーカーの夜明け 編
| 一般的な文章の構造 | 英語表記 |
|---|---|
| 目次 | table of contents |
| 編・部 | part |
| 章 | chapter |
| 節 | section |
| 項 | subsection |
| 目 | |
| 細目 |
国の予算
| 予算科目 | 例 |
|---|---|
| 会計 | 一般会計、エネルギー対策特別会計、特許特別会計 |
| 組織 | 経済産業省 |
| 勘定 | エネルギー対策特別会計 エネルギー需給勘定、電源開発促進対策特別会計 電源立地勘定、産業基盤整備勘定 |
| 項 | |
| 目 | |
| 目細 |
法律
| 法律の構造 | 例 |
|---|---|
| 編 | |
| 章 | |
| 節 | |
| 款 | |
| 目 |
契約書
| 契約書の構造 | 英語表記 |
|---|---|
| 目次 | Table of Contents |
| 編 | Part |
| 章 | Chapter |
| 節 | Section |
| 款 | Subsection |
| 目 | Division |
| 条 | Article (Art.) |
| 項 | Paragraph (para.) |
HTML
HTMLについて学びます。
HTMLとは
WEBページを作るための言語であるHTMLも構造化文書です。
HTMLはシンプルな仕様で、誰にでも理解可能な言語です。WEBサイトを作る上でHTMLの理解は必須であり、自分の書きたい文章を構造化し、HTMLにはめ込む必要があります。
HTMLの独自ルール
HTMLの書き方の独自ルールについて学びます。
HTMLで頻繁に使用するタグは、title、h1～h6、title、ul、ol、li、img、link です。
インデント（字下げ）
インデントとはHTMLを読みやすくするため、行を下げる事です。インデントはタブでおこないます。
スペース（空白文字）でインデントをおこなうケースもありますが、スペースでおこなった場合、すべてのライター、コーダー、プログラマーが同一数のスペースで字下げするルールを遵守する必要があり、現実的には徹底する事が難しくなります。
タブおこなうメリットは、「インデントはタブ1つ」を徹底しやすいこと、インデントを抜いて可読性を下げる事が容易である事が上げられます。※可読性をあえて下げるのは、記事やプログラムのコピーを妨害しやすくするためです。
<table width="100%">
<caption>独自ルール titleタグ、目次、h1～h6タグ</caption>
<tr>
<th>独自ルール</th><th>英語表記</th><th>HTML</th><th>表記ルール</th>
<td>タイトル</td><td>Title</td><td><title></td><td>1ページに1つ</td>
</tr>
</table>
titleタグ、目次、h1～h6タグ
h1～h6タグは文章が何を意味しているかを、読み手と検索エンジンに正確に伝えるために使用します。
可読性を向上させる為に使用しても良いです。デザインを目的として使用してはいけません。
| 独自ルール | 英語表記 | HTML | 表記ルール |
|---|---|---|---|
| タイトル | Title | <title> | 1ページに1つ。 文字数は全角28文字以内。上位表示したいターゲットワードを1つ以上入れる。 記述位置は<head></head>内。 |
| 目次 | Table of Contents | なし | 1ページに複数可。 記述位置はページの先頭付近、ページの最後尾付近、文章中で必要と思われる箇所。 |
| 編 | Part | <h1> | 1ページに1つ。 上位表示したいターゲットワードを1つ以上入れる。 一般的には<body>の直後だが、独自ルールで<div id="wrapper">の次の行。 |
| 章 | Chapter | <h2> | 1ページに複数可。 基本的には1ページに1つだが、大きなページでは最大で5つ程度まで。 |
| 節 | Section | <h3> | 1ページに複数可。 多すぎてはダメ。 |
| 項 | Subsection | <h4> | 1ページに複数可。 適度に使う。 |
| 目 | Division | <h5> | 1ページに複数可。 独自ルールで使わない。 |
| 細目 | Particulars | <h6> | 1ページに複数可。 独自ルールで使わない。 |
tableタグ
tableタグは表を作成するタグです。table（表の宣言）、caption（表のタイトル）、tr（行の宣言）、th（行、列の見出し）、td（内容）で構成されます。
「tr」「th」「td」タグはそれぞれ、tr（table row）、th（table header）、td（table data）の略号です。
前述した「titleタグ、目次、h1～h6タグ」の表をHTMLで記述すると、以下のようになります。
<table width="100%">
<caption>独自ルール titleタグ、目次、h1～h6タグ</caption>
<tr>
<th>独自ルール</th><th>英語表記</th><th>HTML</th><th>表記ルール</th>
<td>タイトル</td><td>Title</td><td><title></td><td>1ページに1つ</td>
</tr>
</table>
おすすめ記事
 | HTMLについて学びます。HTMLはシンプルな仕様で、誰にでも理解可能な言語です。 HTMLはシンプルな仕様で、誰にでも理解可能な言語です。WEBサイトを作る上でHTMLの理解は必須であり、自分の書きたい文章を構造化し、HTMLにはめ込む必要があります。・・・ 続きを見る |