技術文書の書き方わかりやすい技術文書を作成するための知識と手法を解説します。2023技術文書をワープロで作成する際は、見出し、段落、図・表などの書式を適切に決める必要があります。最初に決めるのは、見出しでもなく段落でもなく「ページ」に関する書式です。今回は、読者にとって見やすいページの書式を解説してゆきます。段落や見出しなどの書式は、それぞれの回で解説します。2024ブログの本文は、下記のPDFファイルで閲覧できます。PDFファイルの表示に伴うトラブルへの責任は、一切負いません。ブログではタイトルを開いたページに本文を表すのが普通ですが、あえてワープロで作成した本文をPDFファイルにして概要・目次に添付しました。HTML形式ではワープロ文書の表し方を解説しきれないというのがその理由です。PDFファイルは、5MB以内です。使用する閲覧ソフトウェアによって表示の細部が若干異なる場合があります。PDFファイルの利用は、閲覧のみです。共有やダウンロードなどのご要望には応じかねます。2023見出しの階層構成を「見出し構成」と呼びます。見出し構成の一部または全部を書き出してページ番号を添えたのが「目次」です。見出し構成は、読者にとって技術文書を読み進める際の「道しるべ」です。書き手にとっては技術文書を表す際の「設計図」です。ページ数の多少にかかわらず、見出し構成を作ることが文書作成の第一歩です。今回は、見出し構成を作るにあたって基本となる事項を中心にして述べてゆきます。見出し構成の基本を理解すると、技術文書をどのような表すべきかが見えてきます。ファイルで閲覧できます。ファイルの表示に伴うトラブルへの責任は、一切負いません。ファイルにして概要・目次に添付しました。形式ではワープロ文書の表し方を解説しきれないというのがその理由です。使用する閲覧ソフトウェアによって表示の細部が若干異なる場合があります。ファイルの利用は、閲覧のみです。2023「あらかじめ」を「予め」と表している書籍をほとんど見かけません。「規則に従う」などとする際は漢字で表すのに対して、接続詞の「したがって」を「従って」と表している例もほとんどありません。漢字変換を使うと「予め」と表せるが、書籍では漢字で表記される例は少ない。動詞「従う」は漢字書きが通例だが、接続詞「したがって」が漢字で表記される例は少ない。漢字書きと平仮名書きの使い分けには、「原則」がある一方で「許容」とか「慣用」と呼べる部分もあります。これらを根拠とともに整理しておくと、文書を作成する際に迷わなくてすみますし用字用語の統一につながります。今回は、常用漢字表を規範にして漢字書きと平仮名書きの使い分けを解説します。[注]ここでは、常用漢字表での表記に沿ってひらがなを「平仮名」、かたかなを「片仮名」と表します。ファイルで閲覧できます。ファイルの表示に伴うトラブルへの責任は、一切負いません。ファイルにして概要・目次に添付しました。2023段落を表す際は、その主題を示す見出しを付けます。見出しの階層構成を「見出し構成」と呼びます。見出し構成は、ページ数が多い文書に設ける「目次」に相当します。数ページで構成された定型の報告書も数百ページに及ぶマニュアルも、見出し構成の原則は同じです。見出し構成にも、いくつかの原則がある。今回は、技術文書の見出し構成を作る際の原則と禁則を述べてゆきます。[注]今回のテーマは他の回と関連するため、以前に解説した内容と重複する箇所があります。ファイルで閲覧できます。ファイルの表示に伴うトラブルへの責任は、一切負いません。ファイルにして概要・目次に添付しました。形式ではワープロ文書の表し方を解説しきれないというのがその理由です。使用する閲覧ソフトウェアによって表示の細部が若干異なる場合があります。