実践テクニカルライティングセミナー－マニュアル作成の進め方とわかりやすいマニュアルのポイント－

<BODY BGCOLOR="#ffffff" LINK="#ffffff" ALINK="#ebc83d" VLINK="#ffffff"> <P> <img border="0" src="../gif/sec2.gif" alt="執筆のポイント" width="540" height="26"><BR> <IMG SRC="../gif/tw2-2.gif" ALT="段落構成の考え方と箇条書き，図・表，注記の使い方" ALIGN=bottom width="570" height="150"><hr><H1> <span style="font-weight: 400"><font color="#800000">段落構成</font>の考え方</span></H1> <blockquote> <blockquote> <table border="0" cellspacing="0" width="75%" style="border-collapse: collapse" bordercolor="#111111" cellpadding="0"> <tr> <td width="10" bordercolor="#000000" bgcolor="#008080" bordercolorlight="#FFFFFF" bordercolordark="#FFFFFF">　</td> <td bordercolor="#000000" bgcolor="#FFFFFF" bordercolorlight="#FFFFFF" bordercolordark="#FFFFFF"> <p style="line-height: 150%; margin-top: 2; margin-bottom: 0; margin-left:10; margin-right:10; text-indent:15"> 段落は、複数の文で構成するが一般的です。この<font color="#800000">複数の文をいかに関係付けるか</font>によって、それぞれの位置付けとともに要点が明確になります。</p> </td> </tr> </table> </blockquote> </blockquote> <HR> <h2><span style="font-weight: 400">「<FONT COLOR="#800000">1見出し1段落</FONT>」の基本構成</span></h2> <p style="line-height: 150%; margin: 1 10; text-indent:15"> 「<font color="#800000">一つの主題に対し、要点は一つ</font>」が原理です。また、「<font color="#800000">一つの段落に要点は一つ</font>」も道理です。これらを総合すると、「<font color="#800000">1見出し（主題）に対し、明確な要点がある1段落でまとめる</font>」のが適切と言えます。</p> <ul> <li> <p style="line-height: 150%; margin-top:0; margin-bottom:15"> <font color="#000080">とりわけ、製品解説などユーザを対象にした文書では、要点の所在が明確な「1見出し1段落」が適当です。</font></p> </li> <li> <p style="line-height: 150%; margin-top:0; margin-bottom:15"> <font color="#000080"> 読者であるユーザからすると、製品解説あるいはマニュアルをあたかも論文のように論述的に複数段落で構成されると、読むにも疲れますし何が要点でそれがどこにあるのか読み取りづらくなります。</font></p> </li> </ul> <p style="margin:1 10; line-height: 150%; text-indent:15">もし、一つの主題に対し複数の要点があるようにとれてしまうならば、「執筆者が明確な要点にたどりつかずに執筆している」あるいは「主題（見出し名）が曖昧」のいずれかと言えます。</p> <ul> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"><FONT COLOR="#000080"> 先のコーナーでも述べましたが、見出し名を「概要」にすると、そのとらえ方が曖昧になり「文書の概要」、「主題に至る経緯」と続き最後に「主題の概要」を曖昧に述べた1段落あるいは複数段落に陥りやすくなります。</FONT></p> </li> </ul> <p style="margin:1 10; line-height: 150%; text-indent:15"> 「<font color="#800000">1見出し1段落</font>」構成は、表示装置の解像度に制限を伴う電子文書にも有効です。見出しと段落が一度に視野に入りやすくなります。</p> <ul> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"><FONT COLOR="#000080"> HTML文書のようにスクロールによって必要な事項を探す際は、見出しが目標となります。長くかつめりはりがない複数段落が続くと、見出しを見失いやすくなります。</FONT></p> </li> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"> <font color="#000080">PDF文書でも、小さくかつ解像度が低い画面ではページ全体が見やすく表示されないため、見出しと段落が1対になった「1見出し1段落」の構成が適切です。</font></p> </li> </ul> <p style="margin:1 10; line-height: 150%; text-indent:15"> もし、段落が長くなるようであれば、<font color="#800000">新たに見出しを付けて2項目に分割</font>するか、先のセクションで述べたように<font color="#800000">一部を注記あるいは箇条書きなどで表す</font>のが適当です。</p> <ul> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"> <font color="#000080"> けして、「1段落に何もかも要約すべき」と述べているのではありません。長い段落には、複数の要点あるいは主従関係が含まれている可能性があります。これらの関係を的確に表すための「1見出し1段落」です。</font></p> </li> </ul> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15" align="center"> <img border="1" src="1025.jpg" vspace="10" width="384" height="288"></p> <hr> <h2><span style="font-weight: 400"><font color="#800000">最初に要点</font>を置いた<FONT COLOR="#000080">段落</FONT></span></h2> <p style="margin:1 10; line-height: 150%; text-indent:15"> 要点の位置は、<font color="#800000">段落の最初</font>が基本です。段落の最初は読者がもっとも関心を寄せて読んでくれる箇所です。見出しに対応した要点を段落の最初に置き、必要な補足をそれに続けるのが適当です。</p> <ul> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"><FONT COLOR="#000080"> 「要点を最初に置く」のであって、「要点を最初に書く」とは申しません。最初に書きづらければ、後で書いて最初に置き、全体を調整するのでも差し支えありません。</FONT></li> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"> <font color="#000080">段落の最初で要点を述べる文を「主文」とよびます。主文に続き、要点を補完する文を「補足文」とよびます。技術文書を含む実務文書では、この「主文-補足文」構成が有効です。</font></li> </ul> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15" align="center"> <img border="1" src="1026.jpg" vspace="10" width="384" height="288"><p style="line-height: 150%; margin: 1 10; text-indent:15"> 要点を最初に置くのは、読者に要点を明確に示すだけではなく、執筆者にとって<font color="#800000">要点をさらに深める意義</font>があります。要点を述べることによって、“その先”が執筆者から引き出されます。</p> <ul> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"> <font color="#000080">要点が最後になると、要点に至るまでがほとんどの段落に陥りやすくなります。読者にとって「要点に至るまで」の重要度が低ければ、むしろ要点に続けて「要点の先」を述べるのが適当です。</font></li> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"> <font color="#000080"> 報告書を提出して「よくまとまっているが、もの足りない」と言われてしまうならば、「要点に至るまで」に労力を費やしすぎ「要点の先」が不十分なのかもしれません。</font></li> </ul> <P> 　<HR> <p> <A HREF="t-2-2abs03f.htm" TARGET="_parent"> <IMG SRC="../t1/nxt.gif" ALT="" ALIGN=BOTTOM width="37" height="37"></A> <B>次ページに進む（ボタンをクリックしてください）</B></p> <HR> <DIV ALIGN=CENTER> <p style="margin:1 10; line-height:150%; text-indent:15"> <img border="0" src="../gif/trp-000.gif" alt="山之内総合研究所の出張開催セミナー" width="300" height="20"></DIV> <DIV ALIGN=CENTER> <p style="margin:1 10; "> <a target="_parent" href="../t6-1st/gb-smnr-1st.htm"> <img border="0" src="../gif/trp-1st-a.gif" hspace="2" vspace="2" width="282" height="24"></a><a target="_parent" href="../t6/gb-smnr.htm"><img border="0" src="../gif/trp-gb-a.gif" hspace="2" vspace="2" width="282" height="24"></a></DIV> <DIV ALIGN=CENTER> <p style="margin:1 10; "> <a target="_parent" href="../t7/mn-smnr.htm"> <img border="0" src="../gif/trp-mn-a.gif" hspace="2" vspace="2" width="282" height="24"></a><a target="_parent" href="../t5a/tp-smnr.htm"><img border="0" src="../gif/trp-tp-a.gif" hspace="2" vspace="2" width="282" height="24"></a></DIV> <DIV ALIGN=CENTER> <p style="margin:1 10; "> <a TARGET="_parent" href="../t-smnr-faq/faq-101f.htm"> <IMG SRC="../gif/tsub-faq.gif" ALT="セミナー／コンサルティングFAQ" ALIGN=bottom BORDER=0 hspace="2" vspace="2" width="282" height="24"></a><a TARGET="_blank" href="../t-smnr-trf/smnr-trf02.pdf"><IMG SRC="../gif/tsub-trf.gif" ALT="セミナー基本料金［抜粋PDF版］" ALIGN=bottom BORDER=0 hspace="2" vspace="2" width="282" height="24"></a></DIV> <hr> <p align="center" style="margin-top: 0; margin-bottom: 0"><A HREF="../../index.htm" TARGET="_parent"> <IMG SRC="../gif/modoru.gif" ALT="" ALIGN=BOTTOM width="180" height="50"></A></p> <hr> <p> <font color="#000066"><b>実践テクニカルライティングセミナー</b></font><font color="#008000"><BR> </font> <b>マニュアル作成の進め方とわかりやすいマニュアルのポイント</b><BR> Copyright:Takaaki-YAMANOUCHI/2002-2010<BR> 山之内孝明／有限会社　山之内総合研究所<BR> Takaaki Yamanouchi/ Yamanouchi Research Institute,Ltd.<BR> <IMG SRC="../gif/email.gif" ALT="" ALIGN=BOTTOM width="23" height="13"><FONT SIZE=4 COLOR="#000080">　</FONT><A HREF="mailto:takaaki@yamanouchi-yri.com"><FONT SIZE=4 COLOR="#000080">takaaki@yamanouchi-yri.com</FONT></A></p> </BODY>