src/prologue/typography.ch

   1 %
   2 % This is part of LFSbookja package.
   3 %
   4 % This is a CTIE change file for the original XML source of the LFSbook.
   5 %
   6 @x
   7 <?xml version="1.0" encoding="ISO-8859-1"?>
   8 @y
   9 <?xml version="1.0" encoding="UTF-8"?>
  10 @z
  11
  12 @x
  13   <title>Typography</title>
  14 @y
  15   <title>本書の表記</title>
  16 @z
  17
  18 @x
  19   <para>To make things easier to follow, there are a few typographical
  20   conventions used throughout this book. This section contains some
  21   examples of the typographical format found throughout Linux From
  22   Scratch.</para>
  23 @y
  24   <para>
  25   本書では、特定の表記を用いて分かりやすく説明を行っていきます。
  26   ここでは Linux From Scratch ブックを通じて利用する表記例を示します。
  27   </para>
  28 @z
  29
  30 @x
  31   <para>This form of text is designed to be typed exactly as seen unless
  32   otherwise noted in the surrounding text. It is also used in the explanation
  33   sections to identify which of the commands is being referenced.</para>
  34 @y
  35   <para>
  36   この表記は特に説明がない限りは、そのまま入力するテキストを示しています。
  37   またコマンドの説明を行うために用いる場合もあります。
  38   </para>
  39 @z
  40
  41 @x
  42   <para>In some cases, a logical line is extended to two or more physical lines
  43   with a backslash at the end of the line.</para>
  44 @y
  45   <para>
  46   場合によっては、1行で表現される内容を複数行に分けているものがあります。
  47   その場合は各行の終わりにバックスラッシュ (あるいは円記号) を表記しています。
  48   </para>
  49 @z
  50
  51 @x
  52   <para>Note that the backslash must be followed by an immediate return.  Other
  53   whitespace characters like spaces or tab characters will create incorrect
  54   results.</para>
  55 @y
  56   <para>
  57   バックスラッシュ (または円記号) のすぐ後ろには改行文字がきます。
  58   そこに余計な空白文字やタブ文字があると、おかしな結果となるかもしれないため注意してください。
  59   </para>
  60 @z
  61
  62 @x
  63   <para>This form of text (fixed-width text) shows screen output, usually as
  64   the result of commands issued.  This format is also used to show filenames,
  65   such as <filename>/etc/ld.so.conf</filename>.</para>
  66 @y
  67   <para>
  68   上の表記は固定幅フォントで示されており、たいていはコマンド入力の結果として出力される端末メッセージを示しています。
  69   あるいは <filename>/etc/ld.so.conf</filename> といったファイル名を示すのに利用する場合もあります。
  70   </para>
  71 @z
  72
  73 @x
  74     <para>Please configure your browser to display fixed-width text with
  75     a good monospaced font, with which you can distinguish the glyphs of
  76     <literal>Il1</literal> or <literal>O0</literal> clearly.</para>
  77 @y
  78     <para>
  79     ブラウザーの設定において、固定幅テキストに対しては適切なモノスペースフォントを用いるようにしてください。
  80     これを設定していれば、<literal>Il1</literal> や <literal>O0</literal> のグリフを適切に識別できます。
  81     </para>
  82 @z
  83
  84 @x
  85   <para><emphasis>Emphasis</emphasis></para>
  86 @y
  87   <para><emphasis>Emphasis</emphasis></para>
  88 @z
  89
  90 @x
  91   <para>This form of text is used for several purposes in the book. Its main
  92   purpose is to emphasize important points or items.</para>
  93 @y
  94   <para>
  95   上の表記はさまざまな意図で用いています。
  96   特に重要な説明内容やポイントを表します。
  97   </para>
  98 @z
  99
 100 @x
 101   <para>This format is used for hyperlinks both within the LFS community and to
 102   external pages. It includes HOWTOs, download locations, and websites.</para>
 103 @y
 104   <para>
 105   この表記は LFS コミュニティ内や外部サイトへのハイパーリンクを示します。
 106   そこには<quote>ハウツー</quote>やダウンロードサイトなどが含まれます。
 107   </para>
 108 @z
 109
 110 @x
 111   <para>This format is used when creating configuration files. The first command
 112   tells the system to create the file <filename>$LFS/etc/group</filename> from
 113   whatever is typed on the following lines until the sequence End Of File (EOF)
 114   is encountered. Therefore, this entire section is generally typed as
 115   seen.</para>
 116 @y
 117   <para>
 118   上の表記は設定ファイル類を生成する際に示します。
 119   １行目のコマンドは <filename>$LFS/etc/group</filename> というファイルを生成することを指示しています。
 120   そのファイルへは2行目以降 EOF が記述されるまでのテキストが出力されます。
 121   したがってこの表記は通常そのままタイプ入力します。
 122   </para>
 123 @z
 124
 125 @x
 126   <para><replaceable>&lt;REPLACED TEXT&gt;</replaceable></para>
 127 @y
 128   <para><replaceable>&lt;REPLACED TEXT&gt;</replaceable></para>
 129 @z
 130
 131 @x
 132   <para>This format is used to encapsulate text that is not to be typed
 133   as seen or for copy-and-paste operations.</para>
 134 @y
 135   <para>
 136   上の表記は入力するテキストを仮に表現したものです。
 137   これをそのまま入力するものではないため、コピー、ペースト操作で貼り付けないでください。
 138   </para>
 139 @z
 140
 141 @x
 142   <para><replaceable>[OPTIONAL TEXT]</replaceable></para>
 143 @y
 144   <para><replaceable>[OPTIONAL TEXT]</replaceable></para>
 145 @z
 146
 147 @x
 148   <para>This format is used to encapsulate text that is optional.</para>
 149 @y
 150   <para>
 151   上の表記は入力しなくてもよいオプションを示しています。
 152   </para>
 153 @z
 154
 155 @x
 156   <para><filename>passwd(5)</filename></para>
 157 @y
 158   <para><filename>passwd(5)</filename></para>
 159 @z
 160
 161 @x
 162   <para>This format is used to refer to a specific manual (man) page. The number inside parentheses
 163   indicates a specific section inside the manuals. For example,
 164   <command>passwd</command> has two man pages. Per LFS installation instructions,
 165   those two man pages will be located at
 166   <filename>/usr/share/man/man1/passwd.1</filename> and
 167   <filename>/usr/share/man/man5/passwd.5</filename>. When the book uses <filename>passwd(5)</filename> it is
 168   specifically referring to <filename>/usr/share/man/man5/passwd.5</filename>.
 169   <command>man passwd</command> will print the first man page it finds that
 170   matches <quote>passwd</quote>, which will be
 171   <filename>/usr/share/man/man1/passwd.1</filename>. For this example, you will
 172   need to run <command>man 5 passwd</command> in order to read the page
 173   being specified. Note that most man pages do not have duplicate
 174   page names in different sections. Therefore, <command>man <replaceable>&lt;program
 175   name&gt;</replaceable></command> is generally sufficient.</para>
 176 @y
 177   <para>
 178   上の表記はマニュアルページ (<command>man</command> ページ) を参照するものです。
 179   カッコ内の数字は <command>man</command> の内部で定められている特定のセクションを表しています。
 180   例えば <command>passwd</command> コマンドには2つのマニュアルページがあります。
 181   LFS のインストールに従った場合、2つのマニュアルページは <filename>/usr/share/man/man1/passwd.1</filename> と <filename>/usr/share/man/man5/passwd.5</filename> に配置されます。
 182   <filename>passwd(5)</filename> という表記は <filename>/usr/share/man/man5/passwd.5</filename> を参照することを意味します。
 183   <command>man passwd</command> という入力に対しては<quote>passwd</quote>という語に合致する最初のマニュアルページが表示されるものであり <filename>/usr/share/man/man1/passwd.1</filename> が表示されることになります。
 184   特定のマニュアルページを見たい場合は <command>man 5 passwd</command> といった入力を行う必要があります。
 185   マニュアルページが複数あるケースはまれですので、普通は <command>man
 186   &lt;プログラム名&gt;</command> と入力するだけで十分です。
 187   </para>
 188 @z