|
|
53.
|
|
|
If you require an indented bulleted or numbered list, place a free line before the indented list and then indent each line with 3 spaces. There also needs to be an empty line when the indented list ends.
|
|
|
|
|
あなたが字下げされた箇条書きまたは番号を付けられたリストを必要とする場合、字下げされたリストの前に空行を置き、それから、3つの空白で個々の行を字下げします。字下げされたリストの終わりは空行である必要もあります。
|
|
Translated by
Mitsuhiro Yoshida
|
|
Reviewed by
Mitsuhiro Yoshida
|
|
|
|
Located in
../source/documentation_info.rst:162
|
|
|
54.
|
|
|
Emphasized text starts and ends with 1 \*, e.g. ``*this*``. It will then look like *this*.
|
|
|
|
|
強調テキストは1つの\* で開始し、終了します。例) ``*this*`` は次のようになります。 *this* 【訳注】日本語のように分かち書きしない言語では ``*this*`` の前後（が句読点でない場合）に空白を挿入します。
|
|
Translated by
Mitsuhiro Yoshida
|
|
Reviewed by
Mitsuhiro Yoshida
|
|
|
|
Located in
../source/documentation_info.rst:163
|
|
|
55.
|
|
|
Bold text starts and ends with 2 \*, e.g. ``**this**``. It will then look like **this**.
|
|
|
|
|
ボールド体テキストは2つの\* で開始し、終了します。例) ``**this**`` は次のようになります。 **this** 【訳注】日本語のように分かち書きしない言語では ``**this**`` の前後（が句読点でない場合）に空白を挿入します。ここで、 **日本語の場合のDocutilsのSmart Quotesという機能について補足します。** Sphinx の ``config.py`` で、``smartquotes = (True, 'env', [])`` と ``smartquotes_excludes = ({'languages': [ja], 'builders': ['man', 'text']}, 'env', [])`` が設定されているため、**ダブルクォートやシングルクォートで囲んだ文字列は英文と同じようにシングルクォートとダブルクォートはそのまま表示されます。** しかし、 Mahara マニュアルの ``manual-build`` にある ``conf-common.py`` で ``smartquotes_excludes = {'languages': [], 'builders': ['man', 'text']}`` と設定してあるので、 ``"文字列"`` のように **ダブルクォートで囲んだ文字列は** 「文字列」のように **前後を鍵カッコで囲まれます。** 開始ダブルクォートの直前と終了ダブルクォートの直後には必ず空白が必要です（終了ダブルクォートの直後が句読点の場合は空白は不要です）。また、 ``'文字列'`` のように **シングルクォートで囲んだ文字列は** 『文字列』のように **前後を二重鍵カッコで囲まれます。** 開始シングルクォートの直前と終了シングルクォートの直後には必ず空白が必要です（終了シングルクォートの直後が句読点の場合は空白は不要です）。
|
|
Translated and reviewed by
Mitsuhiro Yoshida
|
|
|
|
Located in
../source/documentation_info.rst:164
|
|
|
56.
|
|
|
Hyperlinks
|
|
|
|
|
ハイパーリンク
|
|
Translated and reviewed by
Mitsuhiro Yoshida
|
|
|
|
Located in
../source/documentation_info.rst:167
|
|
|
57.
|
|
|
External links: "```[text that is linked] <URL>`_``" - Translators should only replace "[text that is linked]".
|
|
|
|
|
外部リンク: "```[text that is linked] <URL>`_``" - 翻訳者は "[text that is linked]" だけを置換します。【訳注】日本語のように分かち書きしない言語では ```[text that is linked] <URL>`_`` の前後（が句読点でない場合）に空白を挿入します。
|
|
Translated and reviewed by
Mitsuhiro Yoshida
|
|
|
|
Located in
../source/documentation_info.rst:155
|
|
|
58.
|
|
|
Internal references to which can be linked from elsewhere in the manual are created by placing "``.. [reference_text]:``" in a line right before a heading. I usually leave an empty line between the reference and the heading.
|
|
|
|
|
マニュアルの他の場所からリンクできる内部の参照は見出しのすぐ前の行に "``.. [reference_text]:``"を置くことによって作成されます。私は通常参照と見出しの間の空行を置いています。
|
|
Translated and reviewed by
Mitsuhiro Yoshida
|
|
|
|
Located in
../source/documentation_info.rst:156
|
|
|
59.
|
|
|
Linking to an internal reference: "``:ref:`[text that is linked] <the internal reference>```" - Translators should only replace "[text that is linked]".
|
|
|
|
|
内部の参照にリンクする: "``:ref:`[リンクされるテキスト] <内部の参照>```" - 翻訳者は "[リンクされるテキスト]" を置き換えるだけにすべきです。【訳注】日本語のように分かち書きしない言語では ``:ref:`[リンクされるテキスト] <内部の参照>``` の前後（が句読点でない場合）に空白を挿入します。
|
|
Translated and reviewed by
Mitsuhiro Yoshida
|
|
|
|
Located in
../source/documentation_info.rst:157
|
|
|
60.
|
|
|
The **`** is an accent mark and not a straight single quote.
|
|
|
|
|
**`** はアクセントマークです。垂直の一重引用符ではありません。
|
|
Translated by
Mitsuhiro Yoshida
|
|
Reviewed by
Mitsuhiro Yoshida
|
|
|
|
Located in
../source/documentation_info.rst:172
|
|
|
61.
|
|
|
An in-text target can be achieved by placing the text to be linked within accent marks preceded by an underscrore: ``_`the internal reference```. Referencing is the usual ``:ref:`[text that is linked] <the internal reference>```.
|
|
|
|
|
テキスト中ターゲットはアンダスコアが先行するアクセントマーク内でリンクされるテキストを置くことで達成できます: ``_`内部の参照```。参照することは通常の ``:ref:`[リンクされるテキスト] <内部の参照>``` です。
|
|
Translated and reviewed by
Mitsuhiro Yoshida
|
|
|
|
Located in
../source/documentation_info.rst:173
|
|
|
62.
|
|
|
Index entries
|
|
|
|
|
インデックスエントリ
|
|
Translated and reviewed by
Mitsuhiro Yoshida
|
|
|
|
Located in
../source/documentation_info.rst:107
|
