aboutsummaryrefslogtreecommitdiff
path: root/ja_JP.eucJP
diff options
context:
space:
mode:
authorHideyuki KURASHINA <rushani@FreeBSD.org>2005-01-30 17:28:03 +0000
committerHideyuki KURASHINA <rushani@FreeBSD.org>2005-01-30 17:28:03 +0000
commit56e80eeb2608a5cb854e4082fc7152d8252d0c0d (patch)
treece2830c7eabefeeda664ff7a1abf697f58b08354 /ja_JP.eucJP
parent512b056aad4d3f23e2aad3986ce4f2ebf3758d8b (diff)
downloaddoc-56e80eeb2608a5cb854e4082fc7152d8252d0c0d.tar.gz
doc-56e80eeb2608a5cb854e4082fc7152d8252d0c0d.zip
Merge the following from the English version:
1.38 -> 1.42 books/fdp-primer/writing-style/chapter.sgml Submitted by: Hiroo Ono <hiroo at oikumene dot gcd dot org> Reviewed by: TAOKA Fumiyoshi <fmysh at iijmio-mail dot jp> Reference: [doc-jp-work 1048, 1049, 1052, 1054]
Notes
Notes: svn path=/head/; revision=23687
Diffstat (limited to 'ja_JP.eucJP')
-rw-r--r--ja_JP.eucJP/books/fdp-primer/writing-style/chapter.sgml22
1 files changed, 19 insertions, 3 deletions
diff --git a/ja_JP.eucJP/books/fdp-primer/writing-style/chapter.sgml b/ja_JP.eucJP/books/fdp-primer/writing-style/chapter.sgml
index 367fe858d8..4f9b8d7365 100644
--- a/ja_JP.eucJP/books/fdp-primer/writing-style/chapter.sgml
+++ b/ja_JP.eucJP/books/fdp-primer/writing-style/chapter.sgml
@@ -30,7 +30,7 @@
The FreeBSD Japanese Documentation Project
- Original revision: 1.38
+ Original revision: 1.42
$FreeBSD$
-->
@@ -209,6 +209,22 @@
</sect2>
<sect2>
+ <title>頭字語</title>
+
+ <para>一般的に、頭字語が文書中に最初に表れた時は "Network Time Protocol
+ (<acronym role="Network Time Protocol">NTP</acronym>)"
+ のように略さずに書くべきです。頭字語が定義されたら、以後は一般的には
+ (文脈上完全な表現を用いることに意義がなければ、完全な表現ではなく)
+ その頭字語のみを使用すべきです。通常は頭字語は文書全体で
+ 1 回だけ定義します。ただし、好みに応じて各章で最初に現れる時に
+ 定義してもよいでしょう。</para>
+
+ <para>頭字語を使う最初の 3 回は、<literal>role</literal> 属性に
+ 完全な表現を定義した &lt;acronym&gt; タグで括ってください。
+ こうすると用語解説へのリンクが作成され、マウスポインタを上に
+ もってくると完全な表現が表示されます。</para> </sect2>
+
+ <sect2>
<title>字下げ</title>
<para>それぞれのファイルの字下げは 0 桁目から始まります。
@@ -256,7 +272,7 @@ V
<programlisting>augroup sgmledit
autocmd FileType sgml set formatoptions=cq2l " Special formatting options
- autocmd FileType sgml set textwidth=70 " Wrap lines at 70 spaces
+ autocmd FileType sgml set textwidth=70 " Wrap lines at 70 columns
autocmd FileType sgml set shiftwidth=2 " Automatically indent
autocmd FileType sgml set softtabstop=2 " Tab key indents 2 spaces
autocmd FileType sgml set tabstop=8 " Replace 8 spaces with a tab
@@ -464,7 +480,7 @@ GB. Hardware compression &hellip;</literallayout>
</listitem>
<listitem>
- <para>manual page(s)</para>
+ <para>manual page</para>
</listitem>
<listitem>