| Revision | 1ff9e4c01eecc422d0920f87bd3d6e4acc3271f2 (tree) |
|---|---|
| Time | 2011-03-24 22:25:23 |
| Author | nobody <nobody@exam...> |
| Commiter | nobody |
主に句読点の修正。
| @@ -737,14 +737,15 @@ License}). | ||
| 737 | 737 | @cindex Overview of Texinfo |
| 738 | 738 | @cindex Texinfo overview |
| 739 | 739 | |
| 740 | -@dfn{Texinfo}@footnote{「Texinfo」の最初の音節は「hex(ヘックス)」ではなく、「speck(スペック)」のように発音します。 | |
| 741 | -この妙な発音は、@TeX{}の発音に由来しますが、全く同じというわけではありません。 | |
| 740 | +@dfn{Texinfo}@footnote{「Texinfo」の最初の音節は、「hex(ヘックス)」ではなく「speck(スペック)」のように発音します。 | |
| 741 | +この妙な発音は@TeX{}の発音に由来しますが、全く同じというわけではありません。 | |
| 742 | 742 | @TeX{}という言葉では、@samp{X}は、実際には英文字の「ex」ではなく、ギリシア文字の「chi」です。 |
| 743 | 743 | @TeX{}の@samp{X}は、「Bach」という名前の最後の音のように発音してください。 |
| 744 | 744 | Texinfoの@samp{x}は「k」のように発音します。 |
| 745 | 745 | また、「Texinfo」は先頭の「T」だけ大文字で後は全部小文字で綴ります。 |
| 746 | 746 | }は、一つのソースファイルを使ってオンライン用の情報と印刷出力の両方を生成するためのドキュメントシステムです。 |
| 747 | -つまり、オンライン情報用のドキュメントと印刷作業用のドキュメントというように、二つの別々のドキュメントを書くのではなく、ドキュメントをたった一つ書くだけで良いということです。ですので、出来上がったものが改訂されたとしても、その一つのドキュメントだけを改訂するだけで済みます。 | |
| 747 | +つまり、オンライン情報用のドキュメントと印刷作業用のドキュメントというように、二つの別々のドキュメントを書くのではなく、ドキュメントをたった一つ書くだけで良いということです。 | |
| 748 | +ですので、出来上がったものが改訂されたとしても、その一つのドキュメントだけを改訂するだけで済みます。 | |
| 748 | 749 | |
| 749 | 750 | 大半のGNUパッケージのマニュアルはTexinfoで書かれていて、@url{http://www.gnu.org/doc}からオンラインで入手可能です。 |
| 750 | 751 |
| @@ -779,18 +780,19 @@ Texinfoの最新版は、@uref{ftp://ftp.gnu.org/gnu/texinfo/}や世界中のミ | ||
| 779 | 780 | つまり、一般的に言うと次のような情報になります。 |
| 780 | 781 | |
| 781 | 782 | @itemize @bullet |
| 782 | -@item Texinfoのバージョン番号、関係するプログラムやマニュアル。 | |
| 783 | -@item ハードウェアやオペレーティングシステムの名前とバージョン。 | |
| 784 | -@item バグの再現に必要な全ての入力ファイルの内容。 | |
| 785 | -@item 問題の説明とエラー出力のサンプル。 | |
| 786 | -@item @command{configure}に指定した通常とは異なるオプション。 | |
| 787 | -@item その他、役に立ちそうなもの。 | |
| 783 | +@item Texinfoのバージョン番号、関係するプログラムやマニュアル | |
| 784 | +@item ハードウェアやオペレーティングシステムの名前とバージョン | |
| 785 | +@item バグの再現に必要な全ての入力ファイルの内容 | |
| 786 | +@item 問題の説明とエラー出力のサンプル | |
| 787 | +@item @command{configure}に指定した通常とは異なるオプション | |
| 788 | +@item その他、役に立ちそうなもの | |
| 788 | 789 | @end itemize |
| 789 | 790 | |
| 790 | -必要かどうかわからない場合は入れるようにしてください。大事なことが抜け落ちてしまうくらいなら、多過ぎるほうが良いです。 | |
| 791 | +必要かどうかわからない場合は入れるようにしてください。 | |
| 792 | +大事なことが抜け落ちてしまうくらいなら多過ぎるほうが良いです。 | |
| 791 | 793 | |
| 792 | 794 | @cindex Patches, contributing |
| 793 | -パッチは大歓迎ですが、できればパッチは@samp{@w{diff -c}}(@pxref{Top,,Overview, diff, Comparing and Merging Files})で作成し、@file{ChangeLog}の項目(@pxref{Change Log,,, emacs, The GNU Emacs Manual})を含めてください。 | |
| 795 | +パッチは大歓迎ですが、できれば、@samp{@w{diff -c}} (@pxref{Top,,Overview, diff, Comparing and Merging Files})でパッチを作成し、@file{ChangeLog}の項目(@pxref{Change Log,,, emacs, The GNU Emacs Manual})を含めてください。 | |
| 794 | 796 | また、既存のコーディングスタイルに従うようにしてください。 |
| 795 | 797 | |
| 796 | 798 |
| @@ -801,19 +803,19 @@ Texinfoの最新版は、@uref{ftp://ftp.gnu.org/gnu/texinfo/}や世界中のミ | ||
| 801 | 803 | @cindex Texinfo, introduction to |
| 802 | 804 | @cindex Introduction to Texinfo |
| 803 | 805 | |
| 804 | -Texinfoを使えば、章やセクション、クロスリファレンス、索引など、普通の本のような特徴を持った印刷ドキュメントを(組版システムの@TeX{}経由で)生成することが出来ます。 | |
| 805 | -それと全く同一のTexinfoソースファイルから、文書の閲覧を容易にする特別な機能を持ったInfoファイルを生成することが出来ます。 | |
| 806 | -また、同一のソースファイルからウェブブラウでの利用に適したHTMLファイルを出力したり、XMLファイルを出力したりすることも出来ます。 | |
| 807 | -ソースから出力を生成する具体的なコマンドについては次のセクション(@pxref{Output Formats})を参照してください。 | |
| 806 | +Texinfoを使えば、章・セクション・クロスリファレンス・索引など、普通の本のような特徴を持った印刷ドキュメントを(組版システムの@TeX{}経由で)生成することが出来ます。 | |
| 807 | +それと全く同じTexinfoソースファイルから、文書の閲覧を容易にする特別な機能を持ったInfoファイルを生成することが出来ます。 | |
| 808 | +また、同一のソースファイルからウェブブラウザでの利用に適したHTMLファイルを出力したり、XMLファイルを出力したりすることも出来ます。 | |
| 809 | +ソースから出力を生成する具体的なコマンドについては次節を参照してください(@pxref{Output Formats})。 | |
| 808 | 810 | |
| 809 | 811 | @TeX{}は、ほとんど全てのプリンタで動作します。 |
| 810 | 812 | Infoは、ほとんど全てのコンピュータ端末で動作します。 |
| 811 | -HTML出力はほとんど全てのブラウザで動作します。 | |
| 812 | -このため、Texinfoはほとんどの全てのコンピュータユーザが利用可能です。 | |
| 813 | +HTML出力は、ほとんど全てのブラウザで動作します。 | |
| 814 | +即ち、Texinfoはほとんどの全てのコンピュータユーザが利用可能です。 | |
| 813 | 815 | |
| 814 | 816 | @cindex Source file format |
| 815 | -TexinfoのソースファイルはプレインのASCIIファイルで、組版と書式化に使われるプログラムが何を行なうべきかを指示する@dfn{@@-コマンド}(@samp{@@}が前置されたワード)が埋め込まれたテキストが入っています。 | |
| 816 | -Texinfoファイルはどのようなテキストエディタでも編集することが出来ますが、特にGNU Emacsは、Texinfoに関連したさまざまな機能が用意されたTexinfoモードと呼ばれる特別なモードを持っていますので、便利に使えます。(@xref{Texinfo Mode}.) | |
| 817 | +TexinfoのソースファイルはプレインのASCIIファイルで、組版プログラムや書式化プログラムが行なうべきことを指示する@dfn{@@-コマンド}(@samp{@@}が前置されたワード)が埋め込まれたテキストが入っています。 | |
| 818 | +Texinfoファイルはどのようなテキストエディタでも編集することが出来ますが、特にGNU Emacsは、Texinfoに関連したさまざまな機能が用意されたTexinfoモードと呼ばれる特別なモードを持っていますので便利に使えます(@pxref{Texinfo Mode})。 | |
| 817 | 819 | |
| 818 | 820 | オンラインヘルプと印刷マニュアルの両方を作成するため、Texinfoを使用することが可能です。 |
| 819 | 821 | さらにTexinfoは自由に再配布できます。この理由のため、TexinfoはGNUプロジェクトの公式はドキュメントフォーマットになっています。 |
| @@ -825,7 +827,7 @@ Texinfoファイルはどのようなテキストエディタでも編集する | ||
| 825 | 827 | @cindex Output formats |
| 826 | 828 | @cindex Back-end output formats |
| 827 | 829 | |
| 828 | -以下はTexinfoが現在サポートしている出力フォーマットの簡単な要約です。 | |
| 830 | +以下は、Texinfoが現在サポートしている出力フォーマットの簡単な要約です。 | |
| 829 | 831 | |
| 830 | 832 | @table @asis |
| 831 | 833 | @item Info |
| @@ -833,7 +835,7 @@ Texinfoファイルはどのようなテキストエディタでも編集する | ||
| 833 | 835 | (@command{makeinfo}で生成します。) |
| 834 | 836 | この形式は、基本的には、Texinfoソースを書き換えただけのプレインテキストです。 |
| 835 | 837 | ノードを分割したり、メニューやクロスリファレンス、索引などのナビゲーション情報を提供したりする制御文字が少し追加されます。 |
| 836 | -この形式について詳しいことは次のセクション(@pxref{Info Files})を参照してください。 | |
| 838 | +この形式について詳細は次節を参照してください(@pxref{Info Files})。 | |
| 837 | 839 | 特に、EmacsのInfoサブシステム(@pxref{Top,,Getting Started,info, Info})とスタンドアロンの@command{info}プログラム(@pxref{Top,, Info Standalone, info-stnd, GNU Info})はこの種のファイルを読むことが可能です。 |
| 838 | 840 | @xref{Creating and Installing Info Files}. |
| 839 | 841 |
| @@ -861,14 +863,14 @@ HTML言語の詳細と多くの関連情報については、@uref{http://www.w3 | ||
| 861 | 863 | @pindex dvips |
| 862 | 864 | @pindex xdvi |
| 863 | 865 | (@command{texi2dvi}で生成します。) |
| 864 | -このデバイス独立(DeVice Independent)バイナリ形式は、組版プログラムの@TeX{}によって出力されるものです(@uref{http://tug.org})。 | |
| 865 | -ですので、このファイルは実際に閲覧したり印刷したり出来る特定デバイスに固有のコマンドを書き出すためのDVI「ドライバ」というプログラムによって読み込まれます。 | |
| 866 | +このデバイス独立(DeVice Independent)バイナリ形式は、組版プログラムの@TeX{}が出力するものです(@uref{http://tug.org})。 | |
| 867 | +このファイルは、実際に閲覧したり印刷したり出来る特定デバイスに固有のコマンドを書き出すためのDVI「ドライバ」というプログラムによって読み込まれます。 | |
| 866 | 868 | DVIドライバには、PostScriptに変換するためのDvips(@pxref{Invoking Dvips,,, dvips, Dvips})や、Xディスプレイで表示するためのXdviがあります(@uref{http://sourceforge.net/projects/xdvi/})。 |
| 867 | 869 | @xref{Hardcopy}. |
| 868 | 870 | |
| 869 | 871 | Texinfo言語は、@TeX{}の通常言語plain @TeX{}や@LaTeX{}と非常に異なっていて、もっと厳格な言語であることに留意してください。 |
| 870 | -一般的な@TeX{}については、@cite{@TeX{} for the Impatient}という書籍を見てください。 | |
| 871 | -@uref{http://savannah.gnu.org/projects/teximpatient}から取得できます。 | |
| 872 | +一般的な@TeX{}については、@cite{@TeX{} for the Impatient}という本を見てください。 | |
| 873 | +@uref{http://savannah.gnu.org/projects/teximpatient}から入手できます。 | |
| 872 | 874 | |
| 873 | 875 | @item PDF |
| 874 | 876 | @cindex PDF output |
| @@ -878,10 +880,10 @@ Texinfo言語は、@TeX{}の通常言語plain @TeX{}や@LaTeX{}と非常に異 | ||
| 878 | 880 | この形式は、Adobe Systemsが可搬性のあるドキュメントの交換のために開発しました。 |
| 879 | 881 | 同社が以前より開発していたPostScript言語に基づいたものです。 |
| 880 | 882 | この形式は、フォントやグラフィックスを含め、ドキュメントの正確の見た目を表現することが可能で、任意の拡大縮小をサポートしています。 |
| 881 | -設計目標の中でも特に、プラットフォームに依存せず、簡単に閲覧できるということを意図しています。 | |
| 882 | -@uref{http://tug.org/TUGboat/Articles/tb22-3/tb72beebe-pdf.pdf}には背景があります。 | |
| 883 | +特に、プラットフォームに依存せず、簡単に閲覧できるということを意図して設計されています。 | |
| 884 | +@uref{http://tug.org/TUGboat/Articles/tb22-3/tb72beebe-pdf.pdf}には背景となる話があります。 | |
| 883 | 885 | Texinfoは、PDFを出力するのに、@TeX{}の変種である@command{pdftex}プログラムを使用します。 |
| 884 | -@uref{http://tug.org/applications/pdftex}. | |
| 886 | +@uref{http://tug.org/applications/pdftex}を参照してください。 | |
| 885 | 887 | @xref{PDF Output}. |
| 886 | 888 | |
| 887 | 889 | @item XML |
| @@ -897,21 +899,23 @@ XMLは、あらゆる内容に使用できる汎用の構文仕様です(例え | ||
| 897 | 899 | @item Docbook |
| 898 | 900 | @cindex Docbook output |
| 899 | 901 | (@command{makeinfo --docbook}で生成します。) |
| 900 | -これは数年前から開発されているXMLベースの形式の一つで、主に技術ドキュメントのためのものです。 | |
| 902 | +これは数年前から開発されているXMLベースの形式の一つで、主に、技術ドキュメントのためのものです。 | |
| 901 | 903 | ですので、大まかな所でTexinfoといくらか似ています。 |
| 902 | -@uref{http://www.docbook.org}を参照してください。DocbookからTexinfo@emph{に}変換したい場合には、@uref{http://docbook2X.sourceforge.net}を参照してください。 | |
| 904 | +@uref{http://www.docbook.org}を参照してください。 | |
| 905 | +DocbookからTexinfo@emph{に}変換したい場合には、@uref{http://docbook2X.sourceforge.net}を参照してください。 | |
| 903 | 906 | |
| 904 | 907 | @end table |
| 905 | 908 | |
| 906 | 909 | @cindex Man page output, not supported |
| 907 | -時々、伝統的なUnix manページをTexinfoから生成できるようにして欲しいと提案されます。 | |
| 908 | -しかし、manページは厳しい伝統的書式を用いるため、良いmanページを生成するには、良いユーザチュートリアルや良いリファレンスマニュアルを書くための典型的なTexinfoアプリケーションとは完全に異なったソースが必要となります。 | |
| 910 | +Texinfoソースから従来のUnix manページを生成することについて提案されることがあります。 | |
| 911 | +しかし、manページは厳格に決められた書式を用いるため、良いmanページを生成するには、良いユーザチュートリアルや良いリファレンスマニュアルを書くための典型的なTexinfoアプリケーションとは完全に異なったソースが必要となります。 | |
| 909 | 912 | このため、manページの生成と、別々の出力形式に対する同じ情報を別々にドキュメントに記録する必要がないというTexinfoの設計目標とは相容れないものとなっています。 |
| 910 | 913 | manページは単に直接書いたほうが良いでしょう。 |
| 911 | 914 | |
| 912 | 915 | @pindex help2man |
| 913 | 916 | @cindex O'Dea, Brendan |
| 914 | -manページには依然として役割があります。manページをサポートしたいのであれば、@command{help2man}プログラムが便利に思えるかもしれません。 | |
| 917 | +manページには依然として役割があります。 | |
| 918 | +manページをサポートしたいのであれば、@command{help2man}プログラムが便利に思えるかもしれません。 | |
| 915 | 919 | このプログラムは、あるプログラムの@samp{--help}出力から伝統的なmanページを生成するものです。 |
| 916 | 920 | 実際、Texinfoのディストリビューションに含まれるプログラムのmanページを生成するのに現在使用しています。 |
| 917 | 921 | Brendan O'Deaによって書かれたGNUソフトウェアで、@uref{ftp://ftp.gnu.org/gnu/help2man/}から入手可能です。 |
| @@ -937,42 +941,42 @@ Infoファイルは@dfn{ノード}と呼ばれる部分に分けられます。 | ||
| 937 | 941 | 別のノードは名前で識別されます。 |
| 938 | 942 | Infoプログラムはノードを同時に一つだけ表示し、関連するノードへの移動を可能にするコマンドを用意しています。 |
| 939 | 943 | |
| 940 | -Infoの使用については、@xref{Top,,, info, GNU Info}. | |
| 944 | +Infoの使用については別のセクションを参照してください(@pxref{Top,,, info, GNU Info})。 | |
| 941 | 945 | |
| 942 | -Infoファイルの各ノードには、そのノードのトピックのサブトピックを記述している子ノードがいくつもあります。 | |
| 946 | +Infoファイルの各ノードには、そのノードのトピックのサブトピックを記述している子ノードが任意の数だけあります。 | |
| 943 | 947 | 子ノードの名前は、親ノードの@dfn{メニュー(menu)}にリストアップされます。 |
| 944 | -こうすることで、子ノードの一つに移動するのにInfoコマンドを使用することが出来ます。 | |
| 948 | +これによって、Infoコマンドを使って子ノードのいずれかへ移動することが可能になります。 | |
| 945 | 949 | 一般にInfoファイルは本のような構成になっています。 |
| 946 | -ノードが章の論理レベルの場合、子ノードはセクションレベルです。 | |
| 950 | +ノードが章に相当する論理レベルにある場合、子ノードはセクションレベルになります。 | |
| 947 | 951 | 同様にセクションの子ノードはサブセクションレベルです。 |
| 948 | 952 | |
| 949 | -一つの親の全ての子どもは、`Next'と`Previous'で双方向に連鎖していて、お互いにリンクされています。 | |
| 950 | -`Next'ポインタは次のセクションへのリンクを提供し、`Previous'ポインタは前のセクションへのリンクを提供します。 | |
| 951 | -これは、章のセクションレベルにあるノードは、お互いにリンクされていることを意味します。 | |
| 953 | +一つの親の全ての子どもは互いにリンクされ、NextポインタとPreviousポインタで双方向に連鎖しています。 | |
| 954 | +Nextポインタは次のセクションへのリンクを提供し、Previousポインタは前のセクションへのリンクを提供します。 | |
| 955 | +これはつまり、ある章のセクションレベルにあるノードは、お互いにリンクされていることを意味します。 | |
| 952 | 956 | 通常、連鎖の順番は親のメニューでの子の順番と同じです。 |
| 953 | -それぞれの子ノードは、親ノード名を`Up'ポインタに記録しています。 | |
| 954 | -最後の子ノードは`Next'ポインタが無く、最初の子ノードは`Previous'と`Up'ポインタ両方が親になります。 | |
| 955 | -@footnote{ドキュメントには、最初の子に`Previous'ポインタが無いものもあります。 | |
| 956 | -時々、最後の子が`Next'ポインタとして次の上のレベルのノード名を持つものもあります。} | |
| 957 | +それぞれの子ノードは、親ノード名をUpポインタに記録しています。 | |
| 958 | +最後の子ノードはNextポインタが無く、最初の子ノードはPreviousとUpポインタ両方が親になります。@footnote{ドキュメントによっては、最初の子にPreviousポインタが無いものもあります。 | |
| 959 | +最後の子が、続く上位レベルのノード名をNextポインタとして持つ場合もあります。} | |
| 957 | 960 | |
| 958 | -ノードが章やセクションやそれに類するものに対応しているような、Infoファイルの本のような構造は、必要条件ではなく慣習の問題です。 | |
| 959 | -ノードの、`Up'、`Previous'と、`Next'ポインタは他のノードを示し、メニューは他のノードを含んでいます。 | |
| 960 | -このため、ノード構造はどのような方向グラフでも表現することが可能です。 | |
| 961 | -しかし、印刷された本やレポートの章とセクションの構造に対応した構造に従っているほうが、通常はわかりやすいでしょう。@refill | |
| 961 | +Infoファイルを章やセクション類に相当するノードに分割して、本のような構造にすることは必須ではなく、慣習上の問題です。 | |
| 962 | +あるノードのUpポインタ、Previousポインタと、Nextポインタは他のノードを指し、メニューには他のノードを入れられます。 | |
| 963 | +したがって、ノード構造はどのような方向グラフでも表現することが可能です。 | |
| 964 | +しかし、印刷本やレポートの章やセクションの構造に対応した構造に従っているほうが、通常はわかりやすいでしょう。@refill | |
| 962 | 965 | |
| 963 | -メニューと、`Next'、`Previous'、そして`Up'ポインタに加え、Infoは参照と呼ばれるもう一つの種類のポインタを提供していて、テキストのあちこちで使用することが出来ます。 | |
| 966 | +メニューと、Nextポインタ、Previousポインタ、Upポインタに加え、Infoはリファレンスと呼ばれるもう一つの種類のポインタを提供しています。 | |
| 967 | +このリファレンスはテキストのあちこちで使用することが出来ます。 | |
| 964 | 968 | これは通常、階層構造に適さないリンクを表わす最善の方法です。@refill |
| 965 | 969 | |
| 966 | 970 | 通常、ドキュメントを設計する際、印刷出力の章とセクションの構造がノードと一致するようにします。 |
| 967 | -しかし、議論の材料に適さないこともよくあります。 | |
| 971 | +しかし、この構造が記述する事柄に適さないこともよくあります。 | |
| 968 | 972 | そのため、Texinfoでは、Infoファイルに対するノード構造を指定するのと、印刷出力に対するセクション構造を指定するのには別のコマンドを使います。@refill |
| 969 | 973 | |
| 970 | -慣習で`Top'と命名されているノードがあって、通常はこのノードを通じてInfoファイルに入ります。 | |
| 974 | +慣習で「Top」と命名されているノードがあって、通常はこのノードを通じてInfoファイルに入ります。 | |
| 971 | 975 | このノードには通常、ファイルの目的を表わす簡単な説明と、ファイルの残りの部分へ行くための大きなメニューがあります。 |
| 972 | 976 | このノードを起点として、ノードからノードへ移動することで体系的にファイル中を横断していったり、メインメニューにリストされている特定のノードに移動したり、索引メニューで検索して、欲しい情報があるノードに直接行くことが可能になっています。 |
| 973 | 977 | また、スタンドアローンInfoプログラムを使えば、コマンドラインで特定のメニューアイテムを指定することもできます(@pxref{Top,,,info-ja, Info})。 |
| 974 | 978 | |
| 975 | -印刷されたマニュアルのように、順番通りInfoファイルを読みたければ、@key{SPC}キーを繰り返し押してもよいですし、上級のInfoコマンド@kbd{g *}を使えば、そのファイル全体を取得することになります。 | |
| 979 | +印刷されたマニュアルのように順番通りInfoファイルを読みたければ、@key{SPC}キーを繰り返し押してもよいですし、上級のInfoコマンド@kbd{g *}を使えば、そのファイル全体を取得することになります。 | |
| 976 | 980 | (@inforef{Advanced, Advanced Info commands, info-ja}.)@refill |
| 977 | 981 | |
| 978 | 982 | @c !!! dir file may be located in one of many places: |
| @@ -982,7 +986,7 @@ Infoファイルの各ノードには、そのノードのトピックのサブ | ||
| 982 | 986 | @c /usr/local/info |
| 983 | 987 | @c /usr/local/lib/info |
| 984 | 988 | @file{info}ディレクトリの@file{dir}ファイルは、Infoシステム全体の出発点としての役目を果たします。 |
| 985 | -そこから、完全なInfoシステムの中で、それぞれのドキュメントの`Top'ノードに行くことができます。@refill | |
| 989 | +そこから、一つの完全なInfoシステムの中で、それぞれのドキュメントのTopノードに行くことができます。@refill | |
| 986 | 990 | |
| 987 | 991 | @cindex URI syntax for Info |
| 988 | 992 | URIでInfoを参照したい場合、以下で例示された(非公式な)構文を使用することが可能です。 |
| @@ -1007,16 +1011,17 @@ info://localhost/usr/info/emacs#Dissociated%20Press | ||
| 1007 | 1011 | @cindex Knuth, Donald |
| 1008 | 1012 | Texinfoファイルは、印刷された本やマニュアルのように書式化し組版することが出来ます。 |
| 1009 | 1013 | これを行なうには@TeX{}が必要です。 |
| 1010 | -@TeX{}は強力かつ洗練された組版プログラムで、Donald Knuthが書いたものです。 | |
| 1011 | -@footnote{@TeX{}が無い場合には、@pindex texi2roff@r{, unsupported software}@uref{ftp://tug.org/texi2roff.tar.gz, @code{texi2roff}}プログラムを使用することも出来ます。 | |
| 1014 | +@TeX{}は強力かつ洗練された組版プログラムで、Donald Knuthが書いたものです。@footnote{ | |
| 1015 | +@pindex texi2roff@r{, unsupported software} | |
| 1016 | +@TeX{}が無い場合には、@uref{ftp://tug.org/texi2roff.tar.gz, @code{texi2roff}}プログラムを使用することも出来ます。 | |
| 1012 | 1017 | Texinfoは@TeX{}と一緒に使用するよう設計されていますので、@code{texi2roff}についてはここで説明しません。 |
| 1013 | 1018 | @code{texi2roff}はGNUの標準的な配布物の一部ではなく、このマニュアルで説明されているTexinfoの機能全てに対して保守したり追随したりされているわけではありません。} |
| 1014 | 1019 | |
| 1015 | 1020 | Texinfoベースの本は、組版されて印刷されたそれ以外の本とよく似ています。 |
| 1016 | 1021 | タイトルページ、著作権表示、目次、序文などのほかに、章、番号付きあるいは番号無しのセクションとサブセクション、クロスリファレンス、脚注、そして索引も入れることが出来ます。@refill |
| 1017 | 1022 | |
| 1018 | -オンライン情報に変換するつもりがなく、本を書くためにTexinfoを使用することが可能です。 | |
| 1019 | -印刷された小説を書くためにTexinfoを使用することも可能で、メモを書くことすら出来ます。 | |
| 1023 | +オンライン情報に変換するつもりが無いとしても、本を書くのにTexinfoを使用することが可能です。 | |
| 1024 | +印刷された小説を書くのにもTexinfoを使用することが可能で、メモを書くことすら出来ます。 | |
| 1020 | 1025 | もっともメモを書くのに使うのは、Eメールを使うほうがずっと簡単なのでお勧めはしません。@refill |
| 1021 | 1026 | |
| 1022 | 1027 | @TeX{}は汎用の組版プログラムです。 |
| @@ -1026,45 +1031,45 @@ Texinfoでは、@TeX{}がTexinfoファイルを組版する際に使用する情 | ||
| 1026 | 1031 | @file{texinfo.tex}には、ドキュメントを印刷するための指定が入っています。 |
| 1027 | 1032 | @file{texinfo.tex}の最新版は、Texinfoホームページ@uref{http://www.gnu.org/software/texinfo/}から入手できます。 |
| 1028 | 1033 | |
| 1029 | -合州国では、ドキュメントは縦横8.5インチx11インチ(216@dmn{mm}x280@dmn{mm}がデフォルトサイズ)で印刷されることが最も多くなっています。 | |
| 1034 | +米国では、ドキュメントは縦横8.5インチx11インチ(216@dmn{mm}x280@dmn{mm})で印刷されることが最も多くなっています。 | |
| 1030 | 1035 | これはデフォルトの大きさです。 |
| 1031 | -しかし、7インチx9.25インチ(178@dmn{mm}x235@dmn{mm}の@code{@@smallbook}サイズ)や、ヨーロッパのA4サイズの紙(@code{@@afourpaper})でも印刷可能です。 | |
| 1032 | -(@xref{smallbook, , Printing ``Small'' Books}. | |
| 1033 | -また、@ref{A4 Paper, ,Printing on A4 Paper}も参照してください。) | |
| 1036 | +しかし、7インチx9.25インチ(@code{@@smallbook}サイズの178@dmn{mm}x235@dmn{mm})や、ヨーロッパのA4サイズ用紙(@code{@@afourpaper})でも印刷可能です。 | |
| 1037 | +(@xref{smallbook, , Printing ``Small'' Books}. Also, see @ref{A4 Paper, ,Printing on A4 Paper}.) | |
| 1034 | 1038 | |
| 1035 | -@file{texinfo.tex}で変数を変えることで、印刷されるドキュメントのサイズを変えることが可能です。 | |
| 1039 | +@file{texinfo.tex}にある変数を変更することで、印刷されるドキュメントのサイズを変えることが可能です。 | |
| 1036 | 1040 | さらに、書式化される印刷ドキュメントのスタイルを変えることも出来ます。 |
| 1037 | 1041 | 例えば、サイズや使用しているフォント、それぞれの段落に対する字下げの量、ハイフネーションされた単語の度合と、それに類するものを変えることが可能です。 |
| 1038 | 1042 | 指定を変更することで、本を格調高く古臭く真面目に見せたり、気楽に若々しく陽気に見せたりすることも可能です。 |
| 1039 | 1043 | |
| 1040 | 1044 | @TeX{}は自由に配布できます。 |
| 1041 | -それは、WEBと呼ばれるPascalのスーパーセットで書かれていて、Pascalでも(@TeX{}配布物と同梱の変換プログラムを使用しながら)Cでもコンパイルすることが可能です。 | |
| 1042 | -(@TeX{}の詳細は、@xref{TeX Mode, ,@TeX{} Mode, emacs, The GNU Emacs Manual}.)@refill | |
| 1045 | +WEBと呼ばれるPascalのスーパーセットで書かれていて、Pascalコンパイルしたり、(@TeX{}配布物と同梱の変換プログラムを使用しながら)Cでコンパイルしたりすることが出来ます。 | |
| 1046 | +@TeX{}の詳細は別のマニュアルを参照してください(@pxref{TeX Mode, ,@TeX{} Mode, emacs, The GNU Emacs Manual})。@refill | |
| 1043 | 1047 | |
| 1044 | 1048 | @TeX{}は非常に強力で、非常に多くの機能があります。 |
| 1045 | 1049 | Texinfoファイルは、文字端末上でのInfo形式と、組版された本の両方で情報を表現できる必要がありますので、Texinfoがサポートする書式化コマンドは必然的に限られたものとなります。 |
| 1046 | 1050 | |
| 1047 | -@TeX{}のコピーを入手するには、@ref{Obtaining TeX, , How to Obtain @TeX{}}を参照してください。 | |
| 1051 | +@TeX{}のコピーを入手する場合は別の節を参照してください(@pxref{Obtaining TeX, , How to Obtain @TeX{}})。 | |
| 1048 | 1052 | |
| 1049 | 1053 | |
| 1050 | 1054 | @node Formatting Commands |
| 1051 | -@c @section @@-コマンド | |
| 1052 | -@section @@-commands | |
| 1055 | +@section @@-コマンド | |
| 1053 | 1056 | @cindex @@-commands |
| 1054 | 1057 | @cindex Formatting commands |
| 1055 | 1058 | |
| 1056 | -Texinfoファイルでは、@TeX{}に印刷マニュアルの組版方法を指示したり、@code{makeinfo}と@code{texinfo-format-buffer}にInfoファイルの作成方法を指示したりするコマンドの前には@samp{@@}が付きます。 | |
| 1057 | -これを@dfn{@@-コマンド}と呼びます。例えば、@code{@@node}はノードを示すコマンドで、@code{@@chapter}は章の開始を示すコマンドです。@refill | |
| 1059 | +Texinfoファイルでは、@TeX{}に印刷マニュアルの組版方法を指示したり、@code{makeinfo}と@code{texinfo-format-buffer}にInfoファイルの作成方法を指示したりするコマンドの前には@samp{@@}を付けます。 | |
| 1060 | +これを@dfn{@@-コマンド}と呼びます。 | |
| 1061 | +例えば、@code{@@node}はノードを示すコマンドで、@code{@@chapter}は章の開始を示すコマンドです。@refill | |
| 1058 | 1062 | |
| 1059 | 1063 | @quotation Note |
| 1060 | 1064 | ほぼ全ての@@-コマンドは、名前全部を小文字で書きます。 |
| 1061 | 1065 | @end quotation |
| 1062 | 1066 | |
| 1063 | -Texinfoの@@-コマンドは、完全に有限のコンストラクトからなる集合です。制限することにより、Texinfoファイルを、@TeX{}が解釈したり、Infoファイルへ変換するプログラムコードが解釈したり出来るようになります。 | |
| 1067 | +Texinfoの@@-コマンドは、完全に数が決まっているコンストラクトの集合です。 | |
| 1068 | +この制限により、@TeX{}がTexinfoファイルを解釈したり、Infoファイルへ変換するプログラムコードがTexinfoファイルを解釈したり出来るようになります。 | |
| 1064 | 1069 | Infoファイルは英数字を表示する端末ならばどれでも表示することが出来ます。 |
| 1065 | -同様に、@TeX{}で生成した出力は様々なプリンタで出力することが出来ます。@refill | |
| 1070 | +同じように、@TeX{}で生成した出力は様々なプリンタで出力することが出来ます。@refill | |
| 1066 | 1071 | |
| 1067 | -@@-コマンドは、何を実行するコマンドなのか、あるいはコマンドが取る引数@footnote{@dfn{引数(argument)}という言葉は数学での使用法に由来しています。 | |
| 1072 | +@@-コマンドは、何を実行するコマンドなのか、あるいはコマンドが取る引数@footnote{@dfn{argument}(引数)という言葉は数学での使用法に由来しています。 | |
| 1068 | 1073 | 二人の人物が議論していることを指すわけではありません。 |
| 1069 | 1074 | そのコマンドに引き渡される情報のことを言います。 |
| 1070 | 1075 | @cite{Oxford English Dictionary}によると、@dfn{明らかにする、証明する(to make clear, prove)}という意味を持つラテン語に由来する言葉です。 |
| @@ -1075,27 +1080,28 @@ Infoファイルは英数字を表示する端末ならばどれでも表示す | ||
| 1075 | 1080 | |
| 1076 | 1081 | @itemize @bullet |
| 1077 | 1082 | @item |
| 1078 | -@code{@@quotation}のようなコマンドは行の冒頭に書いてください。 | |
| 1083 | +@code{@@quotation}のようなコマンドは行頭に書いてください。 | |
| 1079 | 1084 | その行にはそのコマンドだけとなるようにします。 |
| 1080 | 1085 | (@code{@@quotation}は字下げされた環境を開始するものです。) |
| 1081 | 1086 | |
| 1082 | 1087 | @item |
| 1083 | -@code{@@chapter}のようなコマンドは行の冒頭に書き、続けてその行の残りの部分にコマンドの引数を書きます。 | |
| 1088 | +@code{@@chapter}のようなコマンドは行頭に書いてください。 | |
| 1089 | +続けてその行の残りの部分にコマンドの引数を書きます。 | |
| 1084 | 1090 | この場合は章のタイトルが引数です。 |
| 1085 | 1091 | (@code{@@chapter}コマンドは章のタイトルを生成します。)@refill |
| 1086 | 1092 | |
| 1087 | 1093 | @item |
| 1088 | -@code{@@dots@{@}}のようなコマンドは好きなところへ書きます。通常はセンテンスの中になります。 | |
| 1094 | +@code{@@dots@{@}}のようなコマンドは任意の場所へ書くことが出来ますが、通常はセンテンスの中になります。 | |
| 1089 | 1095 | (@code{@@dots@{@}}は省略を表わす@dots{}を作成するものです。)@refill |
| 1090 | 1096 | |
| 1091 | 1097 | @item |
| 1092 | -@code{@@code@{@var{sample-code}@}}のようなコマンドは、ブレースで括った引数を付けて好きなところに(通常は文中ですが)書きます。 | |
| 1093 | -この例では@var{sample-code}が引数です。 | |
| 1098 | +@code{@@code@{@var{sample-code}@}}のようなコマンドは、中括弧で括った引数を付けて任意の場所(通常は文中)に書きます。 | |
| 1099 | +この例だと@var{sample-code}が引数です。 | |
| 1094 | 1100 | (@code{@@code}コマンドは、引数のテキストがコードであるという印を付けます。)@refill |
| 1095 | 1101 | |
| 1096 | 1102 | @item |
| 1097 | 1103 | @code{@@example}のようなコマンドは、そのコマンドだけの行に書きます。 |
| 1098 | -本文はそれに続く行に書きます。 | |
| 1104 | +本文はそのコマンドに続く行に書きます。 | |
| 1099 | 1105 | そして対応する@code{@@end}コマンドも書いてください。 |
| 1100 | 1106 | この場合には本文の後に、単独行として@code{@@end example}と書きます。 |
| 1101 | 1107 | (@code{@@example} @dots{} @code{@@end example}は本文を、例示として字下げし、組版します。) |
| @@ -1104,13 +1110,13 @@ Infoファイルは英数字を表示する端末ならばどれでも表示す | ||
| 1104 | 1110 | |
| 1105 | 1111 | @noindent |
| 1106 | 1112 | @cindex Braces, when to use |
| 1107 | -一般的な規則として、他のテキストの間に混ぜる場合、コマンドには括弧が必要です。 | |
| 1108 | -しかし単独のコマンド行を開始する場合はブレースが不要です。 | |
| 1109 | -@code{@@:}のようなアルファベットでないコマンドは、例外でブレースを必要としません。@refill | |
| 1113 | +一般的な規則として、他のテキストの間にコマンドを混ぜて書く場合、そのコマンドには括弧が必要です。 | |
| 1114 | +しかし単独のコマンド行を開始する場合は中括弧は不要です。 | |
| 1115 | +@code{@@:}のようなアルファベットでないコマンドは例外で、中括弧を必要としません。@refill | |
| 1110 | 1116 | |
| 1111 | 1117 | Texinfoの経験を積むにつれ、様々なコマンドの書き方をすぐに覚えられるでしょう。 |
| 1112 | -コマンドの書き方が様々ありますので、全てのコマンドが全く同じ構文だったとしたらということを思えば、Texinfoファイルを読み書きするのは実際簡単になっています。 | |
| 1113 | -(@@-コマンド構文の詳細は、@ref{Command Syntax, ,@@-Command Syntax}を参照してください。)@refill | |
| 1118 | +仮に全てのコマンドが全く同じ構文だった場合のことを思えば、コマンドの書き方が様々あることで、Texinfoファイルを読み書きするのは実際簡単になっています。 | |
| 1119 | +@@-コマンド構文の詳細は別の節を参照してください(@pxref{Command Syntax, ,@@-Command Syntax})。@refill | |
| 1114 | 1120 | |
| 1115 | 1121 | |
| 1116 | 1122 | @node Conventions |
| @@ -1120,31 +1126,32 @@ Texinfoの経験を積むにつれ、様々なコマンドの書き方をすぐ | ||
| 1120 | 1126 | @cindex Conventions, syntactic |
| 1121 | 1127 | @cindex Characters, basic input |
| 1122 | 1128 | |
| 1123 | -このセクションでは、全てのTexinfoドキュメントで使用されている一般的な慣習を記述しています。 | |
| 1129 | +このセクションでは、全てのTexinfoドキュメントで使用されている一般的な慣習を説明します。 | |
| 1124 | 1130 | |
| 1125 | 1131 | @itemize @bullet |
| 1126 | 1132 | @item |
| 1127 | 1133 | @cindex Source files, characters used |
| 1128 | -@samp{@@}、@samp{@{}、そして@samp{@}}を除き、表示可能な全てのASCII文字はTexinfoファイルに書くことが可能で、それらの文字はその文字自身を意味しています。 | |
| 1129 | -@samp{@@}はコマンドを導入するエスケープ文字で、@samp{@{}と@samp{@}}は特定のコマンドの引数を囲むためだけに使用されます。 | |
| 1130 | -これらの特別な文字をドキュメントに書くには、@samp{@@}文字を前に付けてください。 | |
| 1131 | -@samp{@@@@}、@samp{@@@{}、そして@samp{@@@}}のようになります。 | |
| 1134 | +@samp{@@}、@samp{@{}、@samp{@}}を除いた表示可能なASCII文字は全て、Texinfoファイルに記述して、その文字自身を表現することが出来ます。 | |
| 1135 | +@samp{@@}はコマンドを導入するのに使うエスケープ文字です。 | |
| 1136 | +@samp{@{}と@samp{@}}はコマンドの引数を囲むために使用されます。 | |
| 1137 | +これら三つの特別な文字をドキュメントに書くには、@samp{@@}文字をその文字の前に付けてください。 | |
| 1138 | +@samp{@@@@}、@samp{@@@{}、そして@samp{@@@}}のように記述します。 | |
| 1132 | 1139 | |
| 1133 | 1140 | @item |
| 1134 | 1141 | @cindex Paragraph separator |
| 1135 | 1142 | @cindex Blank lines, as paragraph separator |
| 1136 | 1143 | @cindex Newlines, as blank lines |
| 1137 | -段落と段落の間は一つ以上の空行で分けます。 | |
| 1144 | +段落と段落の間は一行以上の空行で分けます。 | |
| 1138 | 1145 | 現在のところTexinfoは改行文字(LF)だけを行末として認識します。 |
| 1139 | -システムによって使用されるCRLFという並びではありません。 | |
| 1140 | -ですので、@dfn{空行}とは連続する二つの改行文字と全く同じ意味です。 | |
| 1146 | +システムによっては使用されることのあるCRLFという文字並びではありません。 | |
| 1147 | +そのため、@dfn{空行}とは連続する二つの改行文字と全く同じ意味となります。 | |
| 1141 | 1148 | これ以外の場合にも空行が役に立ったり、重宝したりすることがあります。 |
| 1142 | 1149 | 必要に応じて@code{@@noindent}コマンドを使えば、段落の字下げを抑制することが出来ます。 |
| 1143 | -(@pxref{noindent,,@code{@@noindent}}). | |
| 1150 | +@xref{noindent,,@code{@@noindent}}. | |
| 1144 | 1151 | |
| 1145 | 1152 | @item |
| 1146 | 1153 | Texinfoでは、英語で使用される通常の引用符や、その他の言語で使用される引用符をサポートしています。 |
| 1147 | -@ref{Inserting Quotation Marks}を参照してください。 | |
| 1154 | +@xref{Inserting Quotation Marks}. | |
| 1148 | 1155 | |
| 1149 | 1156 | @item |
| 1150 | 1157 | @cindex Multiple dashes in source |
| @@ -1157,14 +1164,15 @@ em dashは文を区切るのに使用されます。 | ||
| 1157 | 1164 | @samp{--}のようにハイフンを二つ使うと中くらいのダッシュが生成されます(@dfn{en dash}と呼びます)。 |
| 1158 | 1165 | en dashは「June 25--26」のように、主として数値範囲を示すのに使われます。 |
| 1159 | 1166 | @samp{-}のようにハイフンを一つ使うと、複合語で使用する標準的なハイフンが生成されます。 |
| 1160 | -画面表示の場合、Infoは、三つのハイフンは二つに、二つのハイフンは一つに減らして表示します(過渡的なものではありません)。 | |
| 1167 | +画面表示の場合、Infoは、三つのハイフンは二つに、二つのハイフンは一つに減らして表示します(推移的なものではありません@footnote{訳注:ハイフン一つがハイフン三つで表示されるわけではないという意味か})。 | |
| 1161 | 1168 | もちろん、@code{@@code}や@code{@@example}のような、テキストが字面そのままの意味を持つコンテキストの場合、ソース中にハイフンがいくつあってもそのまま表示されます。 |
| 1162 | 1169 | |
| 1163 | 1170 | @item |
| 1164 | 1171 | @cindex Tabs; don't use! |
| 1165 | 1172 | @strong{注意:} 最後にですが、Texinfoファイルの中ではタブ文字を使用しないようにしてください(逐語的なモード(verbatim modes)の場合は除きます)。 |
| 1166 | -@TeX{}は可変幅のフォントを使用します。つまり、あらゆる状況でタブが機能するように定義しようとするのは、全く実際的ではないということです。 | |
| 1167 | -ですので、@TeX{}はタブ文字を空白一つとして処理しますので、それはソース中に見るようなものとは異なります。 | |
| 1173 | +@TeX{}は可変幅のフォントを使用します。 | |
| 1174 | +つまり、あらゆる状況でタブが機能するように定義しようとするのは、全く実際的ではないということです。 | |
| 1175 | +@TeX{}はタブ文字を空白一つとして処理しますので、それはソース中に見るようなものとは異なります。 | |
| 1168 | 1176 | また、@code{makeinfo}プログラムはタブについて特別なことを何もしませんので、入力ファイルにタブ文字があると、通常は全く違うように出力に現われることになります。 |
| 1169 | 1177 | |
| 1170 | 1178 | @noindent |
| @@ -1182,21 +1190,21 @@ en dashは「June 25--26」のように、主として数値範囲を示すの | ||
| 1182 | 1190 | @findex comment |
| 1183 | 1191 | @findex c @r{(comment)} |
| 1184 | 1192 | |
| 1185 | -Infoファイルや印刷されたマニュアルに現れないコメントを、Texinfoファイルに@code{@@comment}コマンドを使用して書くことが可能です(@code{@@c}と省略することも出来ます)。 | |
| 1186 | -そのようなコメントは、Texinfoファイルを修正する人に対するものです。 | |
| 1187 | -行の@code{@@comment}や@code{@@c}の後ろにあるテキストは全てコメントです。 | |
| 1193 | +@code{@@comment}(@code{@@c}と省略可)コマンドを使って、Infoファイルや印刷されたマニュアルに現れないコメントを書くことが出来ます。 | |
| 1194 | +そのようなコメントは、Texinfoファイルを改訂する人に向けたものです。 | |
| 1195 | +ある行の@code{@@comment}や@code{@@c}の後ろにあるテキストは全てコメントです。 | |
| 1188 | 1196 | その部分はInfoファイルにも印刷されたマニュアルにも現れません。 |
| 1189 | 1197 | |
| 1190 | -大抵の場合、@code{@@comment}や@code{@@c}を行の途中に書くことも可能で、その場合は@code{@@comment}や@code{@@c}コマンドの後のテキストのみが現れません。 | |
| 1191 | -しかし、@code{@@settitle}と@code{@@setfilename}のようなコマンドは行全体に作用します。 | |
| 1192 | -そのようなコマンドで始まる行の場合には、@code{@@comment}や@code{@@c}を使用することは出来ません。 | |
| 1198 | +大抵の場合、@code{@@comment}コマンドや@code{@@c}コマンドを行の途中に書くことも可能で、その場合は@code{@@comment}コマンドや@code{@@c}コマンドの後のテキストのみが現れません。 | |
| 1199 | +しかし、@code{@@settitle}や@code{@@setfilename}のようなコマンドは行全体に作用します。 | |
| 1200 | +そのようなコマンドで始まる行の場合には、@code{@@comment}コマンドや@code{@@c}コマンドを使用することは出来ません。 | |
| 1193 | 1201 | |
| 1194 | 1202 | @cindex Ignored text |
| 1195 | 1203 | @cindex Unprocessed text |
| 1196 | 1204 | @findex ignore |
| 1197 | -Infoファイルや印刷されたマニュアルのどちらにも現れないテキスト範囲を書くことも出来ます。 | |
| 1198 | -それには@code{@@ignore}と@code{@@end ignore}コマンドを使用します。 | |
| 1199 | -この二つのコマンドは、それぞれそのコマンド単独の行として、行の冒頭から書いてください。 | |
| 1205 | +テキストのある範囲について、Infoファイルや印刷されたマニュアルのどちらにも現れないようにすることも出来ます。 | |
| 1206 | +これには@code{@@ignore}コマンドと@code{@@end ignore}コマンドを使用します。 | |
| 1207 | +この二つのコマンドは、それぞれそのコマンド単独の行として、行頭に書いてください。 | |
| 1200 | 1208 | 二つのコマンドに挟まれたテキストは処理後の出力には現われません。 |
| 1201 | 1209 | @code{@@ignore}コマンドと@code{@@end ignore}コマンドはコメントを記述するのに使用できます。 |
| 1202 | 1210 |
| @@ -1212,11 +1220,11 @@ Infoファイルや印刷されたマニュアルのどちらにも現れない | ||
| 1212 | 1220 | @cindex Required in Texinfo file |
| 1213 | 1221 | @cindex Texinfo file minimum |
| 1214 | 1222 | |
| 1215 | -慣習では、Texinfoファイルの名前は、(優先順で)拡張子@file{.texinfo}、@file{.texi}、@file{.txi}、または@file{.tex}で終ります。 | |
| 1216 | -長い拡張子が好まれるのは、人が読むときファイルの性質がより明確に記述されるためです。 | |
| 1217 | -短い拡張子は、長いファイル名を扱えないオペレーティングシステムのためです。 | |
| 1223 | +Texinfoファイルの名前は、慣習としてよく使われる順に、拡張子@file{.texinfo}、あるいは@file{.texi}、@file{.txi}、@file{.tex}で終わります。 | |
| 1224 | +長い拡張子が好まれるのは、人が読んでファイルの性質がより明確になるように記述できるためです。 | |
| 1225 | +短い拡張子は、長いファイル名を扱えないオペレーティングシステムのためのものです。 | |
| 1218 | 1226 | |
| 1219 | -印刷マニュアルやInfoファイルにするため、Texinfoファイルは以下のような行で始め@strong{なければなりません}。 | |
| 1227 | +印刷マニュアルやInfoファイルにするため、Texinfoファイルは以下のような行で@strong{始めなければなりません}。 | |
| 1220 | 1228 | |
| 1221 | 1229 | @example |
| 1222 | 1230 | @group |
| @@ -1227,7 +1235,8 @@ Infoファイルや印刷されたマニュアルのどちらにも現れない | ||
| 1227 | 1235 | @end example |
| 1228 | 1236 | |
| 1229 | 1237 | @noindent |
| 1230 | -この冒頭部分にファイルの内容が続きます。そしてTexinfoファイルは以下の行で終わら@strong{なければなりません}。 | |
| 1238 | +この冒頭部分に続けてファイルの内容を書きます。 | |
| 1239 | +そしてTexinfoファイルは以下の行で@strong{終わらなければなりません}。 | |
| 1231 | 1240 | |
| 1232 | 1241 | @example |
| 1233 | 1242 | @@bye |
| @@ -1242,10 +1251,11 @@ Infoファイルや印刷されたマニュアルのどちらにも現れない | ||
| 1242 | 1251 | @samp{\input texinfo}という行は、@TeX{}に@file{texinfo.tex}ファイルを使用するよう指示するものです。 |
| 1243 | 1252 | @file{texinfo.tex}ファイルは、Texinfoの@@-コマンドを@TeX{}の組版コマンドに変換する方法を@TeX{}に指示するものです。 |
| 1244 | 1253 | (バックスラッシュ@samp{\}を使っていることに注意してください。 |
| 1245 | -これは@TeX{}に対するものです。) | |
| 1254 | +このバックスラッシュが@TeX{}では適切なものです。) | |
| 1246 | 1255 | |
| 1247 | 1256 | @item |
| 1248 | -@code{@@setfilename}という行はInfoファイルに対する名前を示すもので、@TeX{}に対して補助ファイルを開くように指示します。 | |
| 1257 | +@code{@@setfilename}という行はInfoファイルに対する名前を示すものです。 | |
| 1258 | +@TeX{}に対しては補助ファイルを開くように指示します。 | |
| 1249 | 1259 | @strong{@code{@@setfilename}コマンドより前にあるテキストは全て無視されます。} |
| 1250 | 1260 | |
| 1251 | 1261 | @item |
| @@ -1254,11 +1264,11 @@ Infoファイルや印刷されたマニュアルのどちらにも現れない | ||
| 1254 | 1264 | 厳密に言えば、@code{@@settitle}コマンドは省略可能です---ドキュメントに「Untitled」というタイトルが付けられるのを気にしなければですが。 |
| 1255 | 1265 | |
| 1256 | 1266 | @item |
| 1257 | -ファイルの末尾にある単独の@code{@@bye}という行は、ファイルが終わるので書式化処理を終了するように指示するものです。 | |
| 1267 | +ファイルの末尾にある単独の@code{@@bye}という行は、ファイルが終わりにおいて、書式化処理を終了するように指示するものです。 | |
| 1258 | 1268 | |
| 1259 | 1269 | @end itemize |
| 1260 | 1270 | |
| 1261 | -通常はそのようなまったく貧弱なフォーマットを使用することは無いでしょうが、以下のように、Texinfoファイルの最初に、モード設定と、start-of-header行、end-of-header行を入れることが出来ます。 | |
| 1271 | +通常はこのようなまったく簡素なフォーマットを使用することは無く、以下のように、Texinfoファイルの最初に、モード設定と、start-of-header行、end-of-header行を入れます。 | |
| 1262 | 1272 | |
| 1263 | 1273 | @example |
| 1264 | 1274 | @group |
| @@ -1273,19 +1283,21 @@ Infoファイルや印刷されたマニュアルのどちらにも現れない | ||
| 1273 | 1283 | @noindent |
| 1274 | 1284 | 最初の行の@samp{-*-texinfo-*-}によって、Emacsは、ファイル編集時にTexinfoモードに切り替えます。 |
| 1275 | 1285 | |
| 1276 | -@samp{@@setfilename}と@samp{@@settitle}行の前後にある@code{@@c}行は省略可能ですが、ファイルの一部について@TeX{}やInfoを実行するために必要です。 | |
| 1277 | -(詳細は@xref{Start of Header}.)@refill | |
| 1286 | +@samp{@@setfilename}行と@samp{@@settitle}行の前後にある@code{@@c}行は省略可能ですが、ファイルの一部について@TeX{}やInfoを実行する場合に必要となります。 | |
| 1287 | +詳細は別の節を参照してください(@pxref{Start of Header})。@refill | |
| 1278 | 1288 | |
| 1279 | -さらに通常は、Texinfoファイルに対し、タイトルページ、索引、あるいは類似のものを用意します。 | |
| 1280 | -それら全てについてはこのマニュアルで説明しています。 | |
| 1281 | -しかし、短いドキュメントでは役に立つ最小限のものは、始めの三行と終りの一行だけです。 | |
| 1289 | +さらに通常は、Texinfoファイルに対し、タイトルページ、索引などを用意します。 | |
| 1290 | +それらについては全てこのマニュアルの中で説明します。 | |
| 1291 | +最小限必要なものは、最初の3行と終わりの一行だけです。 | |
| 1292 | +簡単なドキュメントならそれだけで十分でしょう。 | |
| 1282 | 1293 | |
| 1283 | 1294 | |
| 1284 | 1295 | @node Six Parts |
| 1285 | 1296 | @section Texinfoファイルの六つの部品 |
| 1286 | 1297 | |
| 1287 | -一般にTexinfoファイルには、前のセクションで述べたファイル冒頭末尾の最小限の行以外のものも含まれています---通常は以下にリストする六つの部分が含まれています。 | |
| 1288 | -それらについては続くセクションで完全に説明します。 | |
| 1298 | +Texinfoファイルには一般に、前節で述べたファイル冒頭とファイル末尾の最小限の行以外のものも記述します。 | |
| 1299 | +ドキュメントには通常、以下にリストする六つの部分が含まれています。 | |
| 1300 | +この六つについては次節以降で完全に説明します。 | |
| 1289 | 1301 | |
| 1290 | 1302 | @table @r |
| 1291 | 1303 | @item 1. ヘッダ |
| @@ -1299,10 +1311,10 @@ Infoファイルや印刷されたマニュアルのどちらにも現れない | ||
| 1299 | 1311 | @dfn{タイトルと著作権}の部分は、印刷マニュアルに対するタイトルページと著作権のページが入っています。 |
| 1300 | 1312 | この部分は@code{@@titlepage}と@code{@@end titlepage}コマンドで挟まなければなりません。タイトルと著作権のページは、印刷されたマニュアルのみに現れます。 |
| 1301 | 1313 | |
| 1302 | -@item 4. `Top'ノードとマスターメニュー | |
| 1303 | -`Top'ノードはオンライン出力の出発点です。 | |
| 1314 | +@item 4. Topノードとマスターメニュー | |
| 1315 | +Topノードはオンライン出力の出発点となります。 | |
| 1304 | 1316 | 印刷マニュアルには現れません。 |
| 1305 | -複製許可情報を前述の部分だけでなく、ここにも含めることを推奨します。また、`Top'ノードには少なくとも章をリストした最上位のメニューが入っています。 | |
| 1317 | +複製許可情報を前述の部分だけでなく、ここにも含めることを推奨します。また、Topノードには少なくとも章をリストした最上位のメニューが入っています。 | |
| 1306 | 1318 | 場合によっては、ドキュメントの全ノードがリストされた@dfn{マスターメニュー}がある場合もあります。 |
| 1307 | 1319 | |
| 1308 | 1320 | @item 5. 本体 |
| @@ -1318,18 +1330,18 @@ Infoファイルや印刷されたマニュアルのどちらにも現れない | ||
| 1318 | 1330 | @cindex Sample Texinfo file, with comments |
| 1319 | 1331 | |
| 1320 | 1332 | ごく簡単ですが、完全なTexinfoファイルを以下に示します。 |
| 1321 | -前のセクションで列挙した標準的な六つの部分に分けています。 | |
| 1322 | -これでTexinfoソースが実際にはどのようなものなかが分かるでしょう。 | |
| 1333 | +前節で列挙した標準的な六つの部分に分けています。 | |
| 1334 | +これでTexinfoソースが実際にはどのようなものなのかが分かるでしょう。 | |
| 1323 | 1335 | このファイルの@samp{\input texinfo}から@samp{@@end titlepage}まで至る最初の三つの部分は、手強い感じがしますが、実際はそうではありません。 |
| 1324 | 1336 | そこに書かれている大半は決まりきった言い回しです。 |
| 1325 | 1337 | Texinfoでマニュアルを書く際には、名前の部分を適切なものにただ変えるだけでいいのです。 |
| 1326 | 1338 | |
| 1327 | -ここでリストされているコマンドの詳しい説明は@ref{Beginning a File}を参照してください。 | |
| 1328 | -GNUのマニュアルで使用する場合の完全なテキストについては、@ref{GNU Sample Texts}を参照してください。 | |
| 1339 | +ここでリストされているコマンドの詳しい説明は別の節を参照してください(@pxref{Beginning a File})。 | |
| 1340 | +GNUのマニュアルで使用する場合の完全なテキストについても別の節を参照してください@pxref{GNU Sample Texts})。 | |
| 1329 | 1341 | |
| 1330 | 1342 | 以下では、サンプルテキストは@emph{字下げ}されています。 |
| 1331 | 1343 | コメントは字下げされていません。 |
| 1332 | -コメントが入っていない完全なファイルは@ref{Short Sample Texinfo File}にあります。 | |
| 1344 | +コメントが入っていない完全なファイルは別の節にあります(@pxref{Short Sample Texinfo File})。 | |
| 1333 | 1345 | |
| 1334 | 1346 | @subheading Part 1: ヘッダ |
| 1335 | 1347 |
| @@ -1351,8 +1363,7 @@ GNUのマニュアルで使用する場合の完全なテキストについて | ||
| 1351 | 1363 | @subheading Part 2: 要約と著作権 |
| 1352 | 1364 | |
| 1353 | 1365 | @noindent |
| 1354 | -実際のマニュアルでは、配布するライセンスに応じ、ここにさらに多くのテキストが入ります。 | |
| 1355 | -@xref{GNU Sample Texts}. | |
| 1366 | +実際のマニュアルでは、配布するライセンスに応じ、ここにさらに多くのテキストが入ります(@pxref{GNU Sample Texts})。 | |
| 1356 | 1367 | |
| 1357 | 1368 | @example |
| 1358 | 1369 | @group |
| @@ -1368,7 +1379,7 @@ Copyright @@copyright@{@} 2005 Free Software Foundation, Inc. | ||
| 1368 | 1379 | |
| 1369 | 1380 | @noindent |
| 1370 | 1381 | タイトルページの部分はオンラインの出力には現れず、印刷マニュアルのみに現れます。 |
| 1371 | -前のセクションにあった複製許諾のテキストは再度ここへ記述する代わりに、@code{@@insertcopying}コマンドでインクルードします。 | |
| 1382 | +前節にあった複製許諾のテキストは、再度ここへ記述する代わりに、@code{@@insertcopying}コマンドでインクルードします。 | |
| 1372 | 1383 | この部分はタイトルページに続いて出力されます。 |
| 1373 | 1384 | @code{@@contents}コマンドは目次を生成するものです。 |
| 1374 | 1385 |
| @@ -1390,13 +1401,13 @@ Copyright @@copyright@{@} 2005 Free Software Foundation, Inc. | ||
| 1390 | 1401 | @@contents |
| 1391 | 1402 | @end example |
| 1392 | 1403 | |
| 1393 | -@subheading Part 4: `Top'ノードとマスターメニュー | |
| 1404 | +@subheading Part 4: Topノードとマスターメニュー | |
| 1394 | 1405 | |
| 1395 | 1406 | @noindent |
| 1396 | -`Top'ノードには、そのInfoファイルのマスターメニューが含まれます。 | |
| 1397 | -印刷マニュアルではメニューではなく目次が使用されますので、`Top'ノードは排除されます。 | |
| 1407 | +Topノードには、そのInfoファイルのマスターメニューが含まれます。 | |
| 1408 | +印刷マニュアルではメニューではなく目次が使用されますので、Topノードは排除されます。 | |
| 1398 | 1409 | @samp{@@copying}のテキストの最初にある簡単な説明を再度記述しますが、著作権情報を繰り返す必要はありませんので、ここでは@samp{@@insertcopying}コマンドは使いません。 |
| 1399 | -@samp{@@top}コマンド自体は、@command{makeinfo}がノード間の関係を決定するのに利用されます。 | |
| 1410 | +@samp{@@top}コマンド自体は、@command{makeinfo}がノード間の関係を決定するのに利用します。 | |
| 1400 | 1411 | |
| 1401 | 1412 | @example |
| 1402 | 1413 | @@ifnottex |
| @@ -1419,8 +1430,8 @@ This is a short sample Texinfo file. | ||
| 1419 | 1430 | @subheading Part 5: ドキュメントの本体 |
| 1420 | 1431 | |
| 1421 | 1432 | @noindent |
| 1422 | -本体部分は、ドキュメントの索引と目次以外の全テキストを含んでいます。 | |
| 1423 | -この例では、ノードが一つと、列挙リストの入った章を一つ示します。 | |
| 1433 | +本体部分には、ドキュメントの索引と目次以外の全テキストが入ります。 | |
| 1434 | +ここでは、ノードが一つと、列挙リストの入った章を一つ例示します。 | |
| 1424 | 1435 | |
| 1425 | 1436 | @example |
| 1426 | 1437 | @group |
| @@ -1449,10 +1460,10 @@ This is the second item. | ||
| 1449 | 1460 | @end example |
| 1450 | 1461 | |
| 1451 | 1462 | |
| 1452 | -@subheading Part 6: ドキュメントの終り | |
| 1463 | +@subheading Part 6: ドキュメントの終わり | |
| 1453 | 1464 | |
| 1454 | 1465 | @noindent |
| 1455 | -終わりの部分には、単独のノードと番号の振られない章として、索引を生成するコマンドが含まれています。 | |
| 1466 | +終わりの部分には、一つのノードと番号の振られない章として、索引を生成するコマンドが含まれています。 | |
| 1456 | 1467 | また、ドキュメントの終わりを示す@code{@@bye}コマンドがあります。 |
| 1457 | 1468 | |
| 1458 | 1469 | @example |
| @@ -1471,7 +1482,7 @@ This is the second item. | ||
| 1471 | 1482 | |
| 1472 | 1483 | @subheading その結果 |
| 1473 | 1484 | |
| 1474 | -サンプルの第1章の内容は以下のように見えます。 | |
| 1485 | +以下にサンプルの第1章の内容がどのように見えるかを示します。 | |
| 1475 | 1486 | |
| 1476 | 1487 | @sp 1 |
| 1477 | 1488 | @need 700 |
| @@ -1502,7 +1513,7 @@ Richard M. StallmanはTexinfoフォーマットを考案し、最初の処理プ | ||
| 1502 | 1513 | Robert@tie{}J. Chasselはこのマニュアルを大幅に改訂加筆して、Edition 1.1を開始しました。 |
| 1503 | 1514 | Brian Foxはバージョン3.8までスタンドアロンのTexinfo配布物を任されていました。 |
| 1504 | 1515 | また、スタンドアロンの@command{makeinfo}プログラムと@command{info}プログラムを書いています。 |
| 1505 | -そしてKarl BerryはTexinfo 3.8(マニュアル Edition 2.22)以来保守作業を継続中です。 | |
| 1516 | +そしてKarl BerryはTexinfo 3.8(マニュアルEdition 2.22)以来保守作業を継続中です。 | |
| 1506 | 1517 | |
| 1507 | 1518 | @cindex Pinard, Fran@,{c}ois |
| 1508 | 1519 | @cindex Zuhn, David D. |
| @@ -1582,7 +1593,7 @@ Texinfoモードは、Texinfoファイルで作業するための特別な機能 | ||
| 1582 | 1593 | Texinfoソースファイルの構造を表示。@refill |
| 1583 | 1594 | |
| 1584 | 1595 | @item |
| 1585 | -ノードの、`Next'、`Previous'、そして`Up'ポインタの自動的な作成と更新。 | |
| 1596 | +ノードのNextポインタ、Previousポインタ、Upポインタの自動的な作成と更新。 | |
| 1586 | 1597 | |
| 1587 | 1598 | @item |
| 1588 | 1599 | メニューの自動的な作成と更新。@refill |
| @@ -1602,16 +1613,16 @@ Infoに対するファイルの一部または全部の書式化。@refill | ||
| 1602 | 1613 | @node Emacs Editing |
| 1603 | 1614 | @section 通常のGNU Emacs編集コマンド |
| 1604 | 1615 | |
| 1605 | -ほとんどの状況で、通常のテキストモードのコマンドは、Texinfoモードでもテキストモード同様に動作します。 | |
| 1616 | +大抵の場合、テキストモードの通常のコマンドは、Texinfoモードでも同様に動作します。 | |
| 1606 | 1617 | Texinfoモードでは、新しい編集コマンドやツールをGNU Emacsの汎用の編集機能に追加します。 |
| 1607 | 1618 | 両者の主な違いは追い込み処理(filling)に関することです。 |
| 1608 | -Texinfoモードでは、パラグラフを分けるのに使われる変数とシンタックステーブルが再定義され、単独行に存在しなければならないTexinfoコマンドが、うっかりとパラグラフ内に取り込まれてしまわないようになっています。 | |
| 1609 | -ですので、@kbd{M-q} (@code{fill-paragraph})コマンドを使った場合でも、パラグラフは文字の追い込みが仕直されますが、パラグラフに隣接する索引コマンドをパラグラフに混ぜ込んでしまうことはありません。@refill | |
| 1619 | +Texinfoモードでは、段落を分けるのに使われる変数とシンタックステーブルが再定義され、単独行に存在しなければならないTexinfoコマンドが、うっかりと段落内に取り込まれてしまわないようになっています。 | |
| 1620 | +ですので、@kbd{M-q} (@code{fill-paragraph})コマンドを使った場合でも、段落は文字の追い込みが仕直されますが、段落に隣接する索引コマンドを段落に混ぜ込んでしまうことはありません。@refill | |
| 1610 | 1621 | |
| 1611 | 1622 | さらに、Texinfoモードでは、@code{page-delimiter}変数を@code{texinfo-chapter-level-regexp}の値に設定します。 |
| 1612 | -デフォルトでは、これは、章、あるいは補遺のような章に類似するものにマッチする正規表現です。 | |
| 1623 | +デフォルトでは、これは、章や章に類似のappendixなどにマッチする正規表現です。 | |
| 1613 | 1624 | ページ区切りに使われるこの値によって、@kbd{C-x ]} (@code{forward-page})コマンドや@kbd{C-x [} (@code{backward-page})コマンドを使って、章題から章題へとジャンプしたり、@kbd{C-x n p} (@code{narrow-to-page})コマンドを使って、ナローイングを行なったりすることが出来ます。 |
| 1614 | -これらのページコマンドについて詳しくは、@ref{Pages, , ,emacs, The GNU Emacs Manual}を参照してください。@refill | |
| 1625 | +これらのページコマンドについて詳しくは別のマニュアルを参照してください(@pxref{Pages, , ,emacs, The GNU Emacs Manual})。@refill | |
| 1615 | 1626 | |
| 1616 | 1627 | Texinfoファイルの名前は好きなように付けて構いませんが、慣習として、Texinfoファイルの名前は、@file{.texinfo}、@file{.texi}、@file{.txi}、@file{.tex}の内いずれかの拡張子で終わることになっています。 |
| 1617 | 1628 | 長い拡張子を使うほうが意味が明確になるので好ましいですが、ファイル名の長さに制限があるオペレーティングシステムであれば、短かい名前が必要となることもあります。 |
| @@ -1621,7 +1632,7 @@ GNU Emacsでは、@file{.texinfo}、@file{.texi}、@file{.txi}といった拡張 | ||
| 1621 | 1632 | |
| 1622 | 1633 | 他の全てのEmacsの機能と同様、望みのままにTexinfoモードをカスタマイズしたり拡張したりすることが可能です。 |
| 1623 | 1634 | 特にキーバインドは非常に簡単に変更できます。 |
| 1624 | -以下で、デフォルトのキーバインドあるいは標準的なキーバインドを説明します。@refill | |
| 1635 | +ここで説明するキーバインドはデフォルトキーバインドあるいは標準的なキーバインドです。@refill | |
| 1625 | 1636 | |
| 1626 | 1637 | @node Inserting |
| 1627 | 1638 | @comment node-name, next, previous, up |
| @@ -1631,9 +1642,9 @@ GNU Emacsでは、@file{.texinfo}、@file{.texi}、@file{.txi}といった拡張 | ||
| 1631 | 1642 | @cindex Commands, inserting them |
| 1632 | 1643 | |
| 1633 | 1644 | Texinfoモードは、よく使用する様々な@@-コマンドをバッファに挿入するコマンドを提供しています。 |
| 1634 | -これらのコマンドでキーストロークを減らすことができます。@refill | |
| 1645 | +これらのコマンドを使えばキーストロークを減らすことができます。@refill | |
| 1635 | 1646 | |
| 1636 | -この挿入コマンドは、@kbd{C-c}を2度入力した後、@@-コマンドの最初の文字を入力して呼び出します。@refill | |
| 1647 | +挿入コマンドは、@kbd{C-c}を2度入力した後、@@-コマンドの最初の文字を入力して呼び出します。@refill | |
| 1637 | 1648 | |
| 1638 | 1649 | @table @kbd |
| 1639 | 1650 | @item C-c C-c c |
| @@ -1665,7 +1676,7 @@ Texinfoモードは、よく使用する様々な@@-コマンドをバッファ | ||
| 1665 | 1676 | @item C-c C-c n |
| 1666 | 1677 | @itemx M-x texinfo-insert-@@node |
| 1667 | 1678 | @findex texinfo-insert-@@node |
| 1668 | -@code{@@node}とコメント行を挿入し、`Next'、`Previous'、そして`Up'ノードに対するシーケンスをリストします。 | |
| 1679 | +@code{@@node}とコメント行を挿入し、Nextノード、Previousノード、Upノードに対するシーケンスをリストします。 | |
| 1669 | 1680 | @code{@@node}の後にポイントが移動します。@refill |
| 1670 | 1681 | |
| 1671 | 1682 | @item C-c C-c o |
| @@ -1704,10 +1715,10 @@ Texinfoモードは、よく使用する様々な@@-コマンドをバッファ | ||
| 1704 | 1715 | @itemx C-c ] |
| 1705 | 1716 | @itemx M-x up-list |
| 1706 | 1717 | @findex up-list |
| 1707 | -ブレースのペアの間から、その閉じブレースを前方へ過ぎた所へ移動します。 | |
| 1718 | +中括弧のペアの間から、その閉じ中括弧を前方へ過ぎた所へ移動します。 | |
| 1708 | 1719 | @kbd{C-c @}}と入力するより@kbd{C-c ]}と入力する方が簡単ですが、@kbd{C-c @}}の方が覚え易いですね。 |
| 1709 | -そういうわけでキーバインドが二つあることになっています。 | |
| 1710 | -(また、ブレース間からは@kbd{C-f}を入力すれば出ることが出来ます。)@refill | |
| 1720 | +そういうわけでキーバインドが二つあります。 | |
| 1721 | +(また、中括弧間からは@kbd{C-f}を入力すれば出ることが出来ます。)@refill | |
| 1711 | 1722 | @end table |
| 1712 | 1723 | |
| 1713 | 1724 | @emph{既存の}ワードの前後に@w{@code{@@code@{@dots{}@}}}のようなコマンドを書くには、そのワードの前にカーソルを置き、@kbd{C-u 1 C-c C-c c}と入力します。 |
| @@ -1737,7 +1748,7 @@ Texinfoモードは、よく使用する様々な@@-コマンドをバッファ | ||
| 1737 | 1748 | |
| 1738 | 1749 | このコマンドはメニューエントリのデスクリプションを書く手伝いをするだけです。 |
| 1739 | 1750 | 必要なことを全てやるわけではありません。 |
| 1740 | -タイトルにはノード名と全く同じ文言が使われることが多いわけですが、デスクリプションが用を成すようにするには、別の文言を使うことになりますので、挿入テキストをユーザが編集しなければならないわけです。@refill | |
| 1751 | +タイトルにはノード名と全く同じ文言が使われることが多いわけですが、デスクリプションが用を成すようにするには、別の文言を使うことになりますので、挿入テキストをユーザが編集しなければなりません。@refill | |
| 1741 | 1752 | |
| 1742 | 1753 | |
| 1743 | 1754 | @node Showing the Structure |
| @@ -1751,17 +1762,17 @@ Texinfoモードは、よく使用する様々な@@-コマンドをバッファ | ||
| 1751 | 1762 | @cindex File section structure, showing it |
| 1752 | 1763 | @cindex Texinfo file section structure, showing it |
| 1753 | 1764 | |
| 1754 | -@kbd{C-c C-s}コマンド(@code{texinfo-show-structure})を使用すれば、Texinfoファイルのセクション構造を表示することが出来ます。 | |
| 1765 | +@kbd{C-c C-s}コマンド(@code{texinfo-show-structure}コマンド)を使用すれば、Texinfoファイルのセクション構造を表示することが出来ます。 | |
| 1755 | 1766 | このコマンドは、@code{@@chapter}や@code{@@section}のような、@@-コマンドで始まる行をリストアップし、Texinfoファイルのセクション構造を表示します。 |
| 1756 | 1767 | それは、結果として目次を構成します。 |
| 1757 | 1768 | このセクション構造は@samp{*Occur*}と呼ばれる別のバッファに表示されます。 |
| 1758 | -そのバッファでは、いずれかの行にカーソルを置いて、@kbd{C-c C-c}コマンド(@code{occur-mode-goto-occurrence})を使用すると、Texinfoファイルの対応する場所へジャンプすることが出来ます。@refill | |
| 1769 | +そのバッファでは、いずれかの行にカーソルを置いて、@kbd{C-c C-c}コマンド(@code{occur-mode-goto-occurrence}コマンド)を使用すると、Texinfoファイルの対応する場所へジャンプすることが出来ます。@refill | |
| 1759 | 1770 | |
| 1760 | 1771 | @table @kbd |
| 1761 | 1772 | @item C-c C-s |
| 1762 | 1773 | @itemx M-x texinfo-show-structure |
| 1763 | 1774 | @findex texinfo-show-structure |
| 1764 | -Texinfoファイルの@code{@@chapter}、@code{@@section}、そしてそれに類似し | |
| 1775 | +Texinfoファイルの@code{@@chapter}行や@code{@@section}行、そしてそれに類似し | |
| 1765 | 1776 | た行を表示します。@refill |
| 1766 | 1777 | |
| 1767 | 1778 | @item C-c C-c |
| @@ -1770,23 +1781,20 @@ Texinfoファイルの@code{@@chapter}、@code{@@section}、そしてそれに | ||
| 1770 | 1781 | @file{*Occur*}バッファのカーソル位置の行に対応するTexinfoファイルの行に移動します。@refill |
| 1771 | 1782 | @end table |
| 1772 | 1783 | |
| 1773 | -@w{@kbd{C-u C-c C-s}}と入力して、前置引数付きで | |
| 1774 | -@code{texinfo-show-structure}を呼び出した場合、@code{@@chapter}、 | |
| 1775 | -@code{@@section}、そしてこれに類する@@-コマンドがある行だけでなく、 | |
| 1776 | -@code{@@node}行もリストアップします。前置引数を付けて | |
| 1777 | -@code{texinfo-show-structure}を使えば、@code{@@node}行の、`Next'、`Previous'、`Up'ポインタが正しいかどうか調査することが出来ます。 | |
| 1784 | +@w{@kbd{C-u C-c C-s}}と入力して、前置引数付きで@code{texinfo-show-structure}を呼び出した場合、@code{@@chapter}、@code{@@section}、そしてこれに類する@@-コマンドがある行だけでなく、@code{@@node}行もリストアップします。 | |
| 1785 | +前置引数を付けて @code{texinfo-show-structure}を使えば、@code{@@node}行のNextポインタ、Previousポインタ、Upポインタが正しいかどうか調査することが出来ます。 | |
| 1778 | 1786 | |
| 1779 | 1787 | 何らかのマニュアルの作業中、現在の章の構造のみに注目したいこともよくあります。 |
| 1780 | 1788 | そういう場合には、バッファの関心のあるリージョンに対し、@kbd{C-x n n}(@code{narrow-to-region})コマンドを使ってマークすることが出来ます。 |
| 1781 | 1789 | そうすると、@code{texinfo-show-structure}はそのリージョンに対してだけ動作します。 |
| 1782 | 1790 | 再びバッファ全体を参照するには、@w{@kbd{C-x n w}}(@code{widen})コマンドを使用してください。 |
| 1783 | -(ナローイングコマンドについては、@xref{Narrowing, , , emacs, The GNU Emacs Manual}.)@refill | |
| 1791 | +ナローイングコマンドについては別のマニュアルを参照してください(@pxref{Narrowing, , , emacs, The GNU Emacs Manual})。@refill | |
| 1784 | 1792 | |
| 1785 | 1793 | @vindex page-delimiter |
| 1786 | 1794 | @cindex Page delimiter in Texinfo mode |
| 1787 | 1795 | @code{texinfo-show-structure}コマンドの提供に加えて、Texinfoモードは、ページ区切り子の変数の値を、章レベルの@@-コマンドに一致するように設定します。 |
| 1788 | 1796 | これにより、@kbd{C-x ]}(@code{forward-page})と@kbd{C-x [} (@code{backward-page})コマンドを使って章単位で前後に移動したり、@kbd{C-x n p} (@code{narrow-to-page})コマンドを使って、章の範囲になるようにナローイングしたりすることが出来るようになります。 |
| 1789 | -ページコマンドの詳細は、@xref{Pages, , , emacs, The GNU Emacs Manual}.@refill | |
| 1797 | +ページコマンドの詳細は別のマニュアルを参照してください(@pxref{Pages, , , emacs, The GNU Emacs Manual})。@refill | |
| 1790 | 1798 | |
| 1791 | 1799 | @node Updating Nodes and Menus |
| 1792 | 1800 | @comment node-name, next, previous, up |
| @@ -1796,9 +1804,9 @@ Texinfoファイルの@code{@@chapter}、@code{@@section}、そしてそれに | ||
| 1796 | 1804 | @cindex Insert nodes, menus automatically |
| 1797 | 1805 | @cindex Automatically insert nodes, menus |
| 1798 | 1806 | |
| 1799 | -Texinfoモードは、自動的にメニューとノードポインタを作成し更新するコマンドを提供しています。 | |
| 1800 | -コマンドは``更新''コマンドと呼ばれ、その理由は、作業後にTexinfoファイルを更新するため最もよく使用されているためです。 | |
| 1801 | -しかし、これらのコマンドを、そういったポインタを持たない@code{@@node}行の中に`Next'、`Previous'、`Up'ポインタを挿入したり、メニューを持たないファイルにメニューを作成したりするのにも使用することが出来ます。 | |
| 1807 | +Texinfoモードは、メニューとノードポインタを自動的に作成し更新するコマンドを提供しています。 | |
| 1808 | +これらのコマンドは、作業後にTexinfoファイルを更新するのに最も利用されているため、更新コマンドと呼ばれます。 | |
| 1809 | +更新コマンドは、Nextポインタ、Previousポインタ、Upポインタを持たない@code{@@node}行にポインタを挿入したり、メニューを持たないファイルにメニューを作成したりすることに使うことが出来ます。 | |
| 1802 | 1810 | |
| 1803 | 1811 | 更新コマンドを使用しない場合、メニューとノードポインタを手で書く必要があり、それは退屈な仕事です。@refill |
| 1804 | 1812 |
| @@ -1814,23 +1822,24 @@ Texinfoモードは、自動的にメニューとノードポインタを作成 | ||
| 1814 | 1822 | @node Updating Commands |
| 1815 | 1823 | @subsection 更新コマンド |
| 1816 | 1824 | |
| 1817 | -以下を行なうために、更新コマンドを使用することが可能です。@refill | |
| 1825 | +次のような場合に更新コマンドを使用できます。@refill | |
| 1818 | 1826 | |
| 1819 | 1827 | @itemize @bullet |
| 1820 | 1828 | @item |
| 1821 | -ノードに、`Next'、`Previous'、そして`Up'ポインタを挿入したり更新したりします。@refill | |
| 1829 | +ノードに、Nextポインタ、Previousポインタ、Upポインタを挿入または更新する。@refill | |
| 1822 | 1830 | |
| 1823 | 1831 | @item |
| 1824 | -セクションに対するメニューを挿入したり更新したりします。@refill | |
| 1832 | +セクションに対するメニューを挿入あるいは更新する。@refill | |
| 1825 | 1833 | |
| 1826 | 1834 | @item |
| 1827 | -Texinfoソースファイルのためのマスターメニューを作成します。@refill | |
| 1835 | +Texinfoソースファイルのためのマスターメニューを作成する。@refill | |
| 1828 | 1836 | @end itemize |
| 1829 | 1837 | |
| 1830 | -これらのコマンドは、リージョン内やTexinfoファイル全体にある全てのノードとメニューを更新するのにも使用することが出来ます。@refill | |
| 1838 | +これらのコマンドは、リージョン内やTexinfoファイル全体にある全てのノードとメニューを更新するのにも使用できます。@refill | |
| 1831 | 1839 | |
| 1832 | -更新コマンドは慣習に従っているTexinfoファイルでしか動作せず、それは本に似た階層構造をしているものです。 | |
| 1833 | -そのようなファイルでは、構造を作るコマンド行は、`Top'@code{@@node}行を除く、各@code{@@node}行の直後に続いているはずです。 | |
| 1840 | +更新コマンドはよくある型通りのTexinfoファイルでしか機能しません。 | |
| 1841 | +よくあるTexinfoファイルとは、本に似た階層構造をしたものです。 | |
| 1842 | +そのようなファイルでは、Topの@code{@@node}行を除く各@code{@@node}行の直後に構造を作るコマンド行が続いているはずです。 | |
| 1834 | 1843 | (@dfn{構造を作るコマンド行}というのは@code{@@chapter}、@code{@@section}、および類似のコマンドで始まる行のことです。) |
| 1835 | 1844 | |
| 1836 | 1845 | 構造を作るコマンド行は@code{@@node}行の直後の行に書くことが出来ます。 |
| @@ -1838,21 +1847,22 @@ Texinfoソースファイルのためのマスターメニューを作成しま | ||
| 1838 | 1847 | @code{@@node}行と構造を作るコマンド行の間には、複数の行を挟むことは出来ません。 |
| 1839 | 1848 | @code{@@comment}行あるいは@code{@@ifinfo}行だけ間に入れることが出来ます。 |
| 1840 | 1849 | |
| 1841 | -バッファ全体で動作するコマンドには、@code{@@chapter}や同等のレベルコマンドを持つノードの前に`Top'ノードが無ければなりません。 | |
| 1850 | +バッファ全体で動作するコマンドでは、@code{@@chapter}や同等のレベルコマンドを持つノードの前にTopノードが無ければなりません。 | |
| 1842 | 1851 | メニュー更新コマンドは、@code{@@chapter}レベルのノードしか持たないTexinfoファイルに対して、メインメニューやマスターメニューを作成しません。 |
| 1843 | -メニュー更新コマンドは、より低レベルのノードの@emph{の中に}メニューを作成するだけです。 | |
| 1844 | -章を並べたメニューを作成するには`Top'ノードを用意する必要があります。 | |
| 1852 | +メニュー更新コマンドは、より低レベルのノードの@emph{中に}メニューだけを作成します。 | |
| 1853 | +章を並べたメニューを作成するにはTopノードを用意する必要があります。 | |
| 1845 | 1854 | |
| 1846 | 1855 | メニュー更新コマンドは別のInfoファイルを参照するメニューエントリを削除します。 |
| 1847 | 1856 | これはそのメニューエントリが現在のバッファ内のノードを参照していないためですが、これは不完全な部分です。 |
| 1848 | 1857 | 別のInfoファイルを参照するのに、メニューエントリを使わず、クロスリファレンスを使うことも可能です。 |
| 1849 | -更新コマンドがクロスリファレンスに作用することはありません。@refill | |
| 1858 | +更新コマンドはクロスリファレンスに影響することはありません。@refill | |
| 1850 | 1859 | |
| 1851 | -Texinfoモードには、よく使用される五つの更新コマンドがあります。二つは、一つのノード(や領域)のノードポインタやメニューを更新するものです。 | |
| 1860 | +Texinfoモードには、よく使用される五つの更新コマンドがあります。 | |
| 1861 | +そのうち二つのコマンドは、一つのノード(や領域)のノードポインタやメニューを更新するものです。 | |
| 1852 | 1862 | 次の二つは、ファイルの全てのノードポインタとメニューを更新するものです。 |
| 1853 | 1863 | そして最後の一つ、@code{texinfo-master-menu}コマンドは、完結したファイルのマスターメニューを作成し、さらに、これは任意ですが、Texinfoファイル全体の全てのノードとメニューを更新します。@refill |
| 1854 | 1864 | |
| 1855 | -@code{texinfo-master-menu}コマンドは中心となるコマンドです。@refill | |
| 1865 | +@code{texinfo-master-menu}コマンドが中心となるコマンドです。@refill | |
| 1856 | 1866 | |
| 1857 | 1867 | @table @kbd |
| 1858 | 1868 | @item C-c C-u m |
| @@ -1861,9 +1871,9 @@ Texinfoモードには、よく使用される五つの更新コマンドがあ | ||
| 1861 | 1871 | 全ての他のメニューを含むマスターメニューを作成更新します(既存のメニューがあれば、そこからデスクリプションを取り込みます)。@refill |
| 1862 | 1872 | |
| 1863 | 1873 | 引数(対話的な場合は前置引数@kbd{C-u})があると、マスターメニューを構築する前に、バッファ中の全てのノードと通常のメニューを最初に作成更新します。 |
| 1864 | -(マスターメニューについては,@xref{The Top Node, , The Top Node and Master Menu}.)@refill | |
| 1874 | +マスターメニューについては別の節を参照してください(@pxref{The Top Node, , The Top Node and Master Menu})。@refill | |
| 1865 | 1875 | |
| 1866 | -@code{texinfo-master-menu}を動作させるため、Texinfoファイルは、`Top'ノードと、少なくとも一つ後に続くノードがある必要があります。@refill | |
| 1876 | +@code{texinfo-master-menu}を動作させるためには、TexinfoファイルはTopノードと少なくとも一つ後に続くノードが必要となります。@refill | |
| 1867 | 1877 | |
| 1868 | 1878 | 広範囲にTexinfoファイルを編集した後は、以下のように入力できます。 |
| 1869 | 1879 |
| @@ -1874,11 +1884,11 @@ C-u C-c C-u m | ||
| 1874 | 1884 | @end example |
| 1875 | 1885 | |
| 1876 | 1886 | @noindent |
| 1877 | -これにより、一度に全てのノードとメニューを、完全に更新します。@refill | |
| 1887 | +これにより、一度に全てのノードとメニューを完全に更新します。@refill | |
| 1878 | 1888 | @end table |
| 1879 | 1889 | |
| 1880 | 1890 | その他の主要な更新コマンドはもう少し小さい仕事をします。 |
| 1881 | -Texinfoファイルを書きながら、ノードやメニューを更新する人向けに設計されています。@refill | |
| 1891 | +Texinfoファイルを書きながらノードやメニューを更新する人向けに設計されています。@refill | |
| 1882 | 1892 | |
| 1883 | 1893 | @need 1000 |
| 1884 | 1894 | 以下がそのコマンドです。@refill |
| @@ -1887,8 +1897,8 @@ Texinfoファイルを書きながら、ノードやメニューを更新する | ||
| 1887 | 1897 | @item C-c C-u C-n |
| 1888 | 1898 | @itemx M-x texinfo-update-node |
| 1889 | 1899 | @findex texinfo-update-node |
| 1890 | -`Next'、`Previous'、そして`Up'ポインタを、カーソルがあるノード(すなわち、カーソルよりも前にある@code{@@node}に対して)に挿入します。 | |
| 1891 | -@code{@@node}行に、`Next'、`Previous'、`Up'ポインタが既にある場合、古いポインタは削除され新しいものが挿入されます。 | |
| 1900 | +Nextポインタ、Previousポインタ、Upポインタを、カーソルがあるノード(すなわち、カーソルよりも前にある@code{@@node}に対して)に挿入します。 | |
| 1901 | +@code{@@node}行にNextポインタ、Previousポインタ、Upポインタが既にある場合、古いポインタは削除され新しいものが挿入されます。 | |
| 1892 | 1902 | 引数(対話的に実行する場合は前置引数@kbd{C-u})を用いると、このコマンドはリージョン中の全ての@code{@@node}行を更新します(リージョンというのはポイント(カーソル位置)とマークの間のテキストのことです)。@refill |
| 1893 | 1903 | |
| 1894 | 1904 | @item C-c C-u C-m |
| @@ -1904,16 +1914,16 @@ Texinfoファイルを書きながら、ノードやメニューを更新する | ||
| 1904 | 1914 | @item C-c C-u C-e |
| 1905 | 1915 | @itemx M-x texinfo-every-node-update |
| 1906 | 1916 | @findex texinfo-every-node-update |
| 1907 | -バッファ内の全てのノードに対し、`Next'、`Previous'、そして`Up'ポインタを挿入する、または更新します。@refill | |
| 1917 | +バッファ内の全てのノードに対し、Nextポインタ、Previousポインタ、Upポインタを挿入または更新します。@refill | |
| 1908 | 1918 | |
| 1909 | 1919 | @item C-c C-u C-a |
| 1910 | 1920 | @itemx M-x texinfo-all-menus-update |
| 1911 | 1921 | @findex texinfo-all-menus-update |
| 1912 | -バッファ内の全てのメニューを作成するまたは更新します。 | |
| 1922 | +バッファ内の全てのメニューを作成または更新します。 | |
| 1913 | 1923 | 引数(対話的な場合は前置引数@kbd{C-u})を用いると、メニューに対して操作する前に、最初に全てのノードを挿入更新します。@refill |
| 1914 | 1924 | |
| 1915 | 1925 | マスターメニューがある場合、@code{texinfo-all-menus-update}コマンドはマスターメニューを更新します。 |
| 1916 | -しかし、マスターメニューがまだ無くても、このコマンドは新しいマスターメニューを作成したりはしません。 | |
| 1926 | +しかし、マスターメニューがまだ無い場合、このコマンドは新しいマスターメニューを作成したりはしません。 | |
| 1917 | 1927 | (そうするには、@code{texinfo-master-menu}コマンドを使用してください。)@refill |
| 1918 | 1928 | |
| 1919 | 1929 | マスターメニューを作成するメリットが無いドキュメントで作業する場合、以下のように入力できます。 |
| @@ -1929,25 +1939,26 @@ C-u M-x texinfo-all-menus-update | ||
| 1929 | 1939 | @end table |
| 1930 | 1940 | |
| 1931 | 1941 | @code{texinfo-column-for-description}変数は、メニューのデスクリプションが字下げされるカラム数を指定します。 |
| 1932 | -デフォルトでは、その値は32ですが、24まで小さくすると便利なこともあります。 | |
| 1942 | +デフォルトではその値は32ですが、24まで小さくすると便利なこともあります。 | |
| 1933 | 1943 | この変数は、カスタマイゼーション(@pxref{Changing an Option,,, emacs, The GNU Emacs Manual})や@kbd{M-x set-variable}コマンド(@pxref{Examining, , Examining and Setting Variables, emacs, The GNU Emacs Manual})を使って設定することが出来ます。 |
| 1934 | 1944 | |
| 1935 | 1945 | また、@code{texinfo-indent-menu-description}コマンドは、既存メニューのデスクリプションを指定カラムに字下げするのにも使用することが出来ます。 |
| 1936 | 1946 | 終わりに、希望があれば@code{texinfo-insert-node-lines}コマンドを、足りない@code{@@node}行をファイルに挿入するために使用することが可能です。 |
| 1937 | -(詳細は @xref{Other Updating Commands}.)@refill | |
| 1947 | +@xref{Other Updating Commands}.@refill | |
| 1938 | 1948 | |
| 1939 | 1949 | @node Updating Requirements |
| 1940 | 1950 | @subsection 更新の必要条件 |
| 1941 | 1951 | @cindex Updating requirements |
| 1942 | 1952 | @cindex Requirements for updating commands |
| 1943 | 1953 | |
| 1944 | -更新コマンドを使用するためには、章、セクション、サブセクション、そしてそれに類するものを用いて、Texinfoファイルを階層的に組織化する必要があります。 | |
| 1954 | +更新コマンドを使用するためには、章、セクション、サブセクションなどを使って、Texinfoファイルを階層的に構成する必要があります。 | |
| 1945 | 1955 | マニュアルの階層構造を構築するとき、複数階層を一度に「飛び降り」ないでください。 |
| 1946 | -章を`Top'ノードの次にすることは可能ですが、セクションでは不可能です。 | |
| 1947 | -セクションを章の次にすることは可能ですが、サブセクションを章の次にすることは不可能です。 | |
| 1956 | +Topノードの次に章を置くことは可能ですが、セクションは置けません。 | |
| 1957 | +章の次にセクションを置くことは可能ですが、サブセクションは置けません。 | |
| 1948 | 1958 | しかし、一度に何レベルでも「飛び上がる」ことは可能です --- 例えば、サブセクション次を章にすることは可能です。@refill |
| 1949 | 1959 | |
| 1950 | -それぞれの@code{@@node}行は、`Top'ノードの行は例外として、@code{@@chapter}、@code{@@section}、または@code{@@unnumberedsubsec}のような、構造的なコマンドの行が続かなければなりません。@refill | |
| 1960 | +各@code{@@node}行には続けて、@code{@@chapter}コマンド、@code{@@section}コマンド、@code{@@unnumberedsubsec}コマンドのような、構造的なコマンド行を記述しなければなりません。 | |
| 1961 | +但し、Topノードの行は例外です。@refill | |
| 1951 | 1962 | |
| 1952 | 1963 | それぞれの@code{@@node}行や構造的なコマンド行は、以下のような組合せにする必要があります。 |
| 1953 | 1964 |
| @@ -1978,18 +1989,18 @@ C-u M-x texinfo-all-menus-update | ||
| 1978 | 1989 | @end example |
| 1979 | 1990 | |
| 1980 | 1991 | @noindent |
| 1981 | -この例では、`Comments'はノードとセクションの名前です。 | |
| 1982 | -次のノードは`Minimum'と呼ばれ、前のノードは`Conventions'と呼ばれます。 | |
| 1983 | -`Comments'セクションは`Overview'ノードにあり、`Up'ポインタで指定されています。 | |
| 1992 | +この例では、「Comments」というのはノードとセクションの名前です。 | |
| 1993 | +次のノードは「Minimum」という名前で、前のノードは「Conventions」という名前です。 | |
| 1994 | +「Comments」セクションは「Overview」ノードにあり、Upポインタで指定されています。 | |
| 1984 | 1995 | (@code{@@comment}行の代わりに、@code{@@ifinfo}行を書いてもかまいません。) |
| 1985 | 1996 | |
| 1986 | -ファイルに`Top'ノードがある場合、それは、@samp{top}や@samp{Top}と呼ばれ、ファイルの最初のノードにする必要があります。 | |
| 1997 | +ファイルにTopノードがある場合、Topノードは、@samp{top}あるいは@samp{Top}という名前で、ファイルの最初のノードにする必要があります。 | |
| 1987 | 1998 | |
| 1988 | -メニュー更新コマンドは、章の中のセクションメニュー、セクションの中のサブセクションメニューなどというようにメニューを作成します。 | |
| 1989 | -これは、章のメニューが欲しい場合、`Top'ノードが必要だということを意味します。@refill | |
| 1999 | +メニュー更新コマンドは、章の中にセクションメニュー、セクションの中にサブセクションメニューなどというようにメニューを作成します。 | |
| 2000 | +つまり、章のメニューが欲しい場合、Topノードが必要だということを意味します。@refill | |
| 1990 | 2001 | |
| 1991 | -ところで、@code{makeinfo}コマンドは、`Next'、`Previous'、そして`Up'ポインタが無い階層的に組織化されたTexinfoファイルに対し、Infoファイルを作成します。 | |
| 1992 | -このため、Texinfoファイルが@code{makeinfo}で書式化されることが確実な場合、ノード更新コマンドは不要です(@code{makeinfo}の詳細は、@pxref{Creating an Info File})。 | |
| 2002 | +ところで、@code{makeinfo}コマンドは、Nextポインタ、Previousポインタ、Upポインタが無い階層的に組織化されたTexinfoファイルに対し、Infoファイルを作成することが出来ます。 | |
| 2003 | +このため、Texinfoファイルが@code{makeinfo}で書式化されることが確実な場合、ノード更新コマンドは不要です(@code{makeinfo}の詳細は別の節を参照してください(@pxref{Creating an Info File}))。 | |
| 1993 | 2004 | しかし、@code{makeinfo}と@code{texinfo-format-@dots{}}コマンドでは、どちらもユーザがファイルにメニューを挿入する必要があります。 |
| 1994 | 2005 | |
| 1995 | 2006 |
| @@ -2019,9 +2030,9 @@ C-x h C-u M-x texinfo-insert-node-lines | ||
| 2019 | 2030 | |
| 2020 | 2031 | @item M-x texinfo-multiple-files-update |
| 2021 | 2032 | @findex texinfo-multiple-files-update @r{(in brief)} |
| 2022 | -分割されているファイルから構築されたドキュメントのノードとメニューを更新します。 | |
| 2033 | +分割されているファイルから構築されるドキュメントのノードとメニューを更新します。 | |
| 2023 | 2034 | 前置引数として@kbd{C-u}を使用すると、外側のファイルにマスターメニューを作成し挿入します。 |
| 2024 | -@kbd{C-u 2}のように前置数値引数を使用すると、外側のファイルにマスターメニューを作成し挿入する前に、全てのメニューと全てのインクルードファイルの、全ての`Next'、`Previous'、そして`Up' ポインタを最初に更新します。 | |
| 2035 | +@kbd{C-u 2}のように前置数値引数を使用すると、外側のファイルにマスターメニューを作成し挿入する前に、全てのインクルードファイルの全メニューと全てのNextポインタ、Previousポインタ、Upポインタを最初に更新します。 | |
| 2025 | 2036 | @xref{texinfo-multiple-files-update}. |
| 2026 | 2037 | |
| 2027 | 2038 | @item M-x texinfo-indent-menu-description |
| @@ -2033,8 +2044,8 @@ C-x h C-u M-x texinfo-insert-node-lines | ||
| 2033 | 2044 | |
| 2034 | 2045 | @item M-x texinfo-sequential-node-update |
| 2035 | 2046 | @findex texinfo-sequential-node-update |
| 2036 | -現在のノードの直前直後にあるノードの名前を、それらのノードの階層レベルに係わらず、`Next'や`Previous'ポインタとして挿入します。 | |
| 2037 | -つまり、サブセクションの`Next'ノードが次の章になることもありうるということです。 | |
| 2047 | +現在のノードの直前直後にあるノードの名前を、それらのノードの階層レベルに係わらず、NextポインタやPreviousポインタとして挿入します。 | |
| 2048 | +つまり、サブセクションのNextノードが次の章になることもありうるということです。 | |
| 2038 | 2049 | 連続してノードが並んでいると、小説や、順番に読み通していくドキュメントでは便利です。 |
| 2039 | 2050 | (しかしInfoでは、@kbd{g *} コマンドでファイルを順番に見ていくことができますので、厳密には、連続してノードが並ぶ必要はありません。) |
| 2040 | 2051 | 引数(対話的な場合は、前置引数)を使用すると、@code{texinfo-sequential-node-update}コマンドはリージョン内のの全てのノードを連続して更新します。@refill |
| @@ -2048,9 +2059,9 @@ C-x h C-u M-x texinfo-insert-node-lines | ||
| 2048 | 2059 | @cindex Info formatting |
| 2049 | 2060 | |
| 2050 | 2061 | Texinfoモードは、Texinfoファイルの一部または全体をInfoに書式化するコマンドも提供しています。 |
| 2051 | -ドキュメントを書いているとき、ファイルの一部だけ、すなわちリージョンを書式化したいことがよくあります。@refill | |
| 2062 | +ドキュメントを書いているとき、ファイルの一部だけ、すなわちリージョンだけを書式化したいことがよくあります。@refill | |
| 2052 | 2063 | |
| 2053 | -リージョンを書式化するためには、@code{texinfo-format-region}や@code{makeinfo-region}コマンドを使用します。@refill | |
| 2064 | +リージョンを書式化するためには、@code{texinfo-format-region}コマンドや@code{makeinfo-region}コマンドを使用します。@refill | |
| 2054 | 2065 | |
| 2055 | 2066 | @table @kbd |
| 2056 | 2067 | @findex texinfo-format-region |
| @@ -2061,7 +2072,7 @@ Texinfoモードは、Texinfoファイルの一部または全体をInfoに書 | ||
| 2061 | 2072 | 現在のリージョンをInfoに書式化します。@refill |
| 2062 | 2073 | @end table |
| 2063 | 2074 | |
| 2064 | -バッファ全体を書式化するには、@code{texinfo-format-buffer}や@code{makeinfo-buffer}コマンドを使用してください。@refill | |
| 2075 | +バッファ全体を書式化するには、@code{texinfo-format-buffer}コマンドや@code{makeinfo-buffer}コマンドを使用してください。@refill | |
| 2065 | 2076 | |
| 2066 | 2077 | @table @kbd |
| 2067 | 2078 | @findex texinfo-format-buffer |
| @@ -2091,9 +2102,9 @@ C-c C-m C-b | ||
| 2091 | 2102 | M-x makeinfo-buffer |
| 2092 | 2103 | @end example |
| 2093 | 2104 | |
| 2094 | -@TeX{}やInfo書式化コマンドを動作させるため、ファイルのヘッダに@code{@@setfilename}行を含める@emph{必要が}あります。 | |
| 2105 | +@TeX{}やInfo書式化コマンドを動作させるため、ファイルのヘッダに@code{@@setfilename}行を@emph{含める必要があります}。 | |
| 2095 | 2106 | |
| 2096 | -Infoの書式化の詳細は、@xref{Creating an Info File}.@refill | |
| 2107 | +Infoの書式化の詳細は別の節を参照してください(@pxref{Creating an Info File})。@refill | |
| 2097 | 2108 | |
| 2098 | 2109 | @node Printing |
| 2099 | 2110 | @comment node-name, next, previous, up |
| @@ -2104,22 +2115,22 @@ Infoの書式化の詳細は、@xref{Creating an Info File}.@refill | ||
| 2104 | 2115 | @cindex Buffer formatting and printing |
| 2105 | 2116 | @cindex Part of file formatting and printing |
| 2106 | 2117 | |
| 2107 | -Texinfoファイルの組版と印刷は、まず印刷するための(DVIと呼ばれる)ファイルを作成しその後でファイルを印刷するという、複数のステップによる処理になります。 | |
| 2118 | +Texinfoファイルの組版と印刷は、まず印刷するための(DVIと呼ばれる)ファイルを作成し、その後ファイルを印刷するという、複数ステップの処理になります。 | |
| 2108 | 2119 | オプションで索引を作成することも可能です。 |
| 2109 | -これを行なうには、最初に@code{tex}組版コマンドを実行した後、@code{texindex}コマンドを実行する必要があります。 | |
| 2120 | +索引を作成するには、最初に@code{tex}組版コマンドを実行した後、@code{texindex}コマンドを実行する必要があります。 | |
| 2110 | 2121 | そして、もう一度@code{tex}コマンドを実行しなければなりません。 |
| 2111 | -また別の方法として、@code{texi2dvi}コマンドを実行してください(@pxref{Format with texi2dvi})。 | |
| 2122 | +また別の方法として、@code{texi2dvi}コマンドを実行することも出来ます(@pxref{Format with texi2dvi})。 | |
| 2112 | 2123 | このコマンドは必要な索引を自動的に作成します。 |
| 2113 | 2124 | |
| 2114 | -ドキュメントを書いているとき、どのように見えるかを確認するため、ファイルの一部だけを組版し印刷したいときがよくあります。 | |
| 2115 | -この目的には、@code{texinfo-tex-region}と関連するコマンドを使用することが可能です。 | |
| 2116 | -@code{texinfo-tex-buffer}コマンドは、バッファ全体の書式化に使用してください。@refill | |
| 2125 | +ドキュメントを書いているとき、どのように見えるかを確認するため、ファイルの一部だけを組版し印刷したいことがよくあります。 | |
| 2126 | +この目的には、@code{texinfo-tex-region}と関連するコマンドを利用できます。 | |
| 2127 | +@code{texinfo-tex-buffer}コマンドは、バッファ全体の書式化に使用します。@refill | |
| 2117 | 2128 | |
| 2118 | 2129 | @table @kbd |
| 2119 | 2130 | @item C-c C-t C-b |
| 2120 | 2131 | @itemx M-x texinfo-tex-buffer |
| 2121 | 2132 | @findex texinfo-tex-buffer |
| 2122 | -バッファで@code{texi2dvi}を実行します。 | |
| 2133 | +バッファに対し@code{texi2dvi}を実行します。 | |
| 2123 | 2134 | このコマンドは、バッファ上で@TeX{}を実行するのに加え、必要な場合は自動的に索引を作成更新します。@refill |
| 2124 | 2135 | |
| 2125 | 2136 | @item C-c C-t C-r |
| @@ -2139,27 +2150,27 @@ Texinfoファイルの組版と印刷は、まず印刷するための(DVIと呼 | ||
| 2139 | 2150 | @item C-c C-t C-p |
| 2140 | 2151 | @itemx M-x texinfo-tex-print |
| 2141 | 2152 | @findex texinfo-tex-print |
| 2142 | -前もって@code{texinfo-tex-buffer}や@code{texinfo-tex-region}で書式化されているファイル(またはファイルの一部)を印刷します。@refill | |
| 2153 | +事前に@code{texinfo-tex-buffer}コマンドや@code{texinfo-tex-region}コマンドで書式化されているファイル(またはファイルの一部)を印刷します。@refill | |
| 2143 | 2154 | @end table |
| 2144 | 2155 | |
| 2145 | -@code{texinfo-tex-region}や@code{texinfo-tex-buffer}が動作するためには、ファイルを@samp{\input texinfo}行で始める@emph{必要}があり、また@code{@@settitle}行を含める必要があります。 | |
| 2156 | +@code{texinfo-tex-region}コマンドや@code{texinfo-tex-buffer}コマンドが動作するためには、ファイルを@samp{\input texinfo}行で始める@emph{必要}があり、また@code{@@settitle}行を含める必要があります。 | |
| 2146 | 2157 | ファイルは、単独の@code{@@bye}行で終える必要があります。 |
| 2147 | 2158 | (@code{texinfo-tex-region}を使用するときは、@code{@@settitle}行を、start-of-headerとend-of-header行で囲む必要があります。)@refill |
| 2148 | 2159 | |
| 2149 | -@code{tex-show-print-queue}のような、@TeX{}に関連する他のコマンドの説明は、@xref{Hardcopy}.@refill | |
| 2160 | +@code{tex-show-print-queue}のような、@TeX{}に関連する他のコマンドの説明は別の節を参照してください(@pxref{Hardcopy})。@refill | |
| 2150 | 2161 | |
| 2151 | 2162 | @node Texinfo Mode Summary |
| 2152 | 2163 | @comment node-name, next, previous, up |
| 2153 | 2164 | @section Texinfoモードのまとめ |
| 2154 | 2165 | |
| 2155 | -Texinfoモードでは、それぞれのコマンドの組に、同じキーで始まるデフォルトのキーバインドがあります。 | |
| 2166 | +Texinfoモードでは、それぞれのコマンドの組ごとに、同じキーで始まるデフォルトのキーバインドがあります。 | |
| 2156 | 2167 | Texinfoモード用にカスタムで作成された全てのコマンドは@kbd{C-c}で始まります。 |
| 2157 | 2168 | キーは多少覚え易くなっています。@refill |
| 2158 | 2169 | |
| 2159 | 2170 | @subheading 挿入コマンド |
| 2160 | 2171 | |
| 2161 | 2172 | 挿入コマンドは、@kbd{C-c}を2度入力し、挿入する@@-コマンドの最初の文字を入力し呼び出します。 |
| 2162 | -(それは、`カスタム挿入'に対する@kbd{C-c C-i}の使用より記憶力が必要かもしれませんが、@kbd{C-c C-c}は素早く入力できます。) | |
| 2173 | +(それは、「カスタム挿入」に対する@kbd{C-c C-i}の使用より記憶力が必要かもしれませんが、@kbd{C-c C-c}は素早く入力できます。) | |
| 2163 | 2174 | @refill |
| 2164 | 2175 | |
| 2165 | 2176 | @example |
| @@ -2321,7 +2332,7 @@ M-x texinfo-sequential-node-update | ||
| 2321 | 2332 | @cindex Texinfo file beginning |
| 2322 | 2333 | @cindex File beginning |
| 2323 | 2334 | |
| 2324 | -特定の情報は、Texinfoファイルの最初に用意しておく必要があります。 | |
| 2335 | +特定の情報については、Texinfoファイルの最初に用意しておく必要があります。 | |
| 2325 | 2336 | 例えば、出力ファイルの名前、ドキュメントタイトル、Topノードなどです。 |
| 2326 | 2337 | 目次も普通はここで生成します。 |
| 2327 | 2338 |
| @@ -2352,10 +2363,10 @@ Topノードの前には、コマンドの他にはテキストを書くのを | ||
| 2352 | 2363 | @cindex Example beginning of Texinfo file |
| 2353 | 2364 | |
| 2354 | 2365 | 以下のサンプルでは必要とされるものを示しています。 |
| 2355 | -ここで指定されている要素は続くセクションで詳細に説明します。 | |
| 2366 | +ここで指定されている要素は次節以降で詳細に説明します。 | |
| 2356 | 2367 | それ以外のコマンドも、Texinfoファイルの最初に含められることがよくありますが、ここにあるものが最も重要なものです。 |
| 2357 | 2368 | |
| 2358 | -GNUマニュアルで使用されるテキストの完全なものは、@xref{GNU Sample Texts}. | |
| 2369 | +GNUマニュアルで使用されるテキストの完全なものは別の節を参照してください(@pxref{GNU Sample Texts})。 | |
| 2359 | 2370 | |
| 2360 | 2371 | @example |
| 2361 | 2372 | \input texinfo @@c -*-texinfo-*- |
| @@ -2438,9 +2449,9 @@ start-of-headerとend-of-headerの行はオプションですが無害なので | ||
| 2438 | 2449 | |
| 2439 | 2450 | ドキュメント全体の書式化に影響のあるコマンドは、ヘッダに含める意味があります。 |
| 2440 | 2451 | 例えば、@code{@@synindex} (@pxref{synindex})はヘッダに含められることが多いコマンドです。 |
| 2441 | -見本のテキストの完全なものは、@xref{GNU Sample Texts}. | |
| 2452 | +見本のテキストの完全なものは別の節を参照してください(@pxref{GNU Sample Texts})。 | |
| 2442 | 2453 | |
| 2443 | -従って、Texinfoファイルの冒頭は以下のようになります。 | |
| 2454 | +したがって、Texinfoファイルの冒頭は以下のようになります。 | |
| 2444 | 2455 | |
| 2445 | 2456 | @example |
| 2446 | 2457 | @group |
| @@ -2506,7 +2517,8 @@ start-of-headerとend-of-headerの行で、Texinfoファイルの一部だけを | ||
| 2506 | 2517 | @xref{texinfo-format commands}. |
| 2507 | 2518 | |
| 2508 | 2519 | @samp{%**}という奇妙な文字列は、他のコメントが偶然start-of-header行だと思われないことを保証します。 |
| 2509 | -Emacs変数@code{tex-start-of-header}と/や@code{tex-end-of-header}を設定することで、希望のものに変更することが可能です。@xref{Texinfo Mode Printing}. | |
| 2520 | +Emacs変数@code{tex-start-of-header}と/や@code{tex-end-of-header}を設定することで、希望のものに変更することが可能です。 | |
| 2521 | +@xref{Texinfo Mode Printing}. | |
| 2510 | 2522 | |
| 2511 | 2523 | |
| 2512 | 2524 | @node setfilename |
| @@ -2520,8 +2532,9 @@ Emacs変数@code{tex-start-of-header}と/や@code{tex-end-of-header}を設定す | ||
| 2520 | 2532 | @@setfilename @var{info-file-name} |
| 2521 | 2533 | @end example |
| 2522 | 2534 | |
| 2523 | -@code{@@setfilename}コマンドを行の最初に書き、同じ行にInfoファイル名を続けてください。 | |
| 2524 | -その行に他のものは書かないでください、その行のコマンド後は、コメントであっても、全てファイル名の一部とみなされます。 | |
| 2535 | +@code{@@setfilename}コマンドを行頭に書き、同じ行にInfoファイル名を続けて書いてください。 | |
| 2536 | +その行に他のものは書かないでください。 | |
| 2537 | +その行のコマンド後は、コメントであっても、全てファイル名の一部とみなされます。 | |
| 2525 | 2538 | |
| 2526 | 2539 | @cindex Ignored before @code{@@setfilename} |
| 2527 | 2540 | @cindex @samp{\input} source line ignored |
| @@ -2562,7 +2575,7 @@ HTML出力を生成する際、@code{makeinfo}は拡張子を@samp{html}に置 | ||
| 2562 | 2575 | @@settitle @var{title} |
| 2563 | 2576 | @end example |
| 2564 | 2577 | |
| 2565 | -@code{@@settitle}コマンドを行の最初に書き、同じ行にタイトルを続けてください。 | |
| 2578 | +@code{@@settitle}コマンドを行頭に書き、その同じ行にタイトルを続けて書いてください。 | |
| 2566 | 2579 | これは、ヘッダやフッタで使用するタイトルを@TeX{}に指示するものです。 |
| 2567 | 2580 | その行には他に何も書かないでください。 |
| 2568 | 2581 | 他の場所だとコメントになるはずのものであっても、コマンドより後ろの部分はタイトルの一部とみなされます。 |
| @@ -2586,10 +2599,10 @@ HTML出力を生成する際、@code{makeinfo}は拡張子を@samp{html}に置 | ||
| 2586 | 2599 | |
| 2587 | 2600 | 片面スタイルで印刷する場合でも、@TeX{}は@code{@@settitle}コマンド行を探し、マニュアルタイトルをヘッダに含める場合に備えます。 |
| 2588 | 2601 | |
| 2589 | -@TeX{}は、Texinfoファイルの@code{@@end titlepage}以降のテキストや、見出しを付ける@code{@@headings}コマンド以降のテキストに対してのみ、ページ見出しを印刷します(詳細は、@pxref{headings on off, , The @code{@@headings} Command})。 | |
| 2602 | +@TeX{}は、Texinfoファイルの@code{@@end titlepage}以降のテキストや、見出しを付ける@code{@@headings}コマンド以降のテキストに対してのみ、ページ見出しを印刷します(詳細は別の節を参照してください(@pxref{headings on off, , The @code{@@headings} Command}))。 | |
| 2590 | 2603 | |
| 2591 | 2604 | 希望があれば、独自のカスタムヘッダとフッタを作成することが可能です。 |
| 2592 | -この処理の詳細な記述は、@xref{Headings, , Page Headings}. | |
| 2605 | +この処理の詳細な記述は別の節を参照してください(@pxref{Headings, , Page Headings})。 | |
| 2593 | 2606 | |
| 2594 | 2607 | |
| 2595 | 2608 | @node End of Header |
| @@ -2597,7 +2610,7 @@ HTML出力を生成する際、@code{makeinfo}は拡張子を@samp{html}に置 | ||
| 2597 | 2610 | @cindex End of header line |
| 2598 | 2611 | |
| 2599 | 2612 | ヘッダ行の後に@w{end-of-header}行を続けます。 |
| 2600 | -この行は次のようなTexinfoのコメントになっています。 | |
| 2613 | +この行は次のようなTexinfoのコメントです。 | |
| 2601 | 2614 | |
| 2602 | 2615 | @example |
| 2603 | 2616 | @@c %**end of header |
| @@ -2607,7 +2620,7 @@ HTML出力を生成する際、@code{makeinfo}は拡張子を@samp{html}に置 | ||
| 2607 | 2620 | |
| 2608 | 2621 | |
| 2609 | 2622 | @node Document Permissions |
| 2610 | -@section ドキュメントの許可情報 | |
| 2623 | +@section ドキュメントの許諾情報 | |
| 2611 | 2624 | @cindex Document Permissions |
| 2612 | 2625 | @cindex Copying Permissions |
| 2613 | 2626 |
| @@ -2645,9 +2658,9 @@ Permission is granted to @dots{} | ||
| 2645 | 2658 | @code{@@quotation}は法的に重要なわけではありません。 |
| 2646 | 2659 | 前後関係の読み易さを改善するために存在します。 |
| 2647 | 2660 | |
| 2648 | -GNUのマニュアルで使用されている完全なテキストは、@xref{GNU Sample Texts}. | |
| 2649 | -GNUやそれ以外のフリーなマニュアル自身を配布するライセンスは、@xref{GNU Free Documentation License}. | |
| 2650 | -ドキュメントの付録としてライセンスを含める必要があります。 | |
| 2661 | +GNUのマニュアルで使用されている完全なテキストは別の節を参照してください(@pxref{GNU Sample Texts})。 | |
| 2662 | +GNUやそれ以外のフリーなマニュアル自身を配布するライセンスは別の節を参照してください(@pxref{GNU Free Documentation License})。 | |
| 2663 | +ドキュメントのappendixとしてライセンスを含める必要があります。 | |
| 2651 | 2664 | |
| 2652 | 2665 | @code{@@copying}のテキストは、Info、HTML、そしてXMLの出力ファイルの最初にコメントとして出力されます。 |
| 2653 | 2666 | プレインテキストや@TeX{}では、暗黙的に出力されることは@emph{ありません}。 |
| @@ -2663,7 +2676,7 @@ Copyright @copyright{} @var{years} @var{copyright-owner}. | ||
| 2663 | 2676 | @end example |
| 2664 | 2677 | |
| 2665 | 2678 | @cindex Copyright word, always in English |
| 2666 | -単語`Copyright'は、たとえ他の言語でマニュアルが書かれている場合でも、常に英語で書く必要があります。 | |
| 2679 | +単語「Copyright」は、たとえ他の言語でマニュアルが書かれている場合でも、常に英語で書く必要があります。 | |
| 2667 | 2680 | これは国際法によるものです。 |
| 2668 | 2681 | |
| 2669 | 2682 | @cindex Years, in copyright line |
| @@ -2674,13 +2687,13 @@ Copyright @copyright{} @var{years} @var{copyright-owner}. | ||
| 2674 | 2687 | @cindex Holder of copyright for FSF works |
| 2675 | 2688 | @cindex Owner of copyright for FSF works |
| 2676 | 2689 | 著作権の保有者(達)は、その作業に対して法的な著作権を保持するものなら誰でもです。 |
| 2677 | -作業をFSFに属している場合だと、保有者は`Free Software Foundation, Inc.'になります。 | |
| 2690 | +作業をFSFに属している場合だと、保有者は「Free Software Foundation, Inc.」になります。 | |
| 2678 | 2691 | |
| 2679 | -著作権の`行'は、ソースドキュメントと出力の両方で、実際には複数の行に分割されていることがあります。 | |
| 2692 | +著作権の「行」は、ソースドキュメントと出力の両方で、実際には複数の行に分割されていることがあります。 | |
| 2680 | 2693 | こういうことは、ドキュメントに長い歴史があり、出版した年が多いときによくあります。 |
| 2681 | 2694 | 複数行使う場合には、ソースファイルでは、それを(あるいは、@code{@@copying}ブロックにある他のものを)で字下げしないようにしてください。 |
| 2682 | 2695 | |
| 2683 | -追加情報は、@xref{Copyright Notices,,,maintain,GNU Maintenance Instructions}. | |
| 2696 | +追加情報は別のマニュアルを参照してください(@pxref{Copyright Notices,,,maintain,GNU Maintenance Instructions})。 | |
| 2684 | 2697 | |
| 2685 | 2698 | |
| 2686 | 2699 | @node insertcopying |
| @@ -2697,13 +2710,13 @@ Copyright @copyright{} @var{years} @var{copyright-owner}. | ||
| 2697 | 2710 | @end example |
| 2698 | 2711 | |
| 2699 | 2712 | これは、@code{@@copying}で前もって定義されているテキストを挿入します。 |
| 2700 | -法的な要求に対処するため、印刷されたマニュアルの著作権のページで使用する必 | |
| 2701 | -要があります。 | |
| 2713 | +法的な要求に対処するため、印刷されたマニュアルの著作権のページで使用する必要があります。 | |
| 2702 | 2714 | |
| 2703 | 2715 | @code{@@copying}コマンド自身によって、許諾テキストはInfoファイルの最初のノードの@emph{前に}表示されることになります。 |
| 2704 | 2716 | テキストは、分割された各Info出力ファイルの冒頭にも、法的な必要性からそのままコピーされます。 |
| 2705 | 2717 | この場所では、Infoを使用してマニュアルを読んでいる人がこのテキストを見ることは@emph{ありません}(例外は、上級のInfoコマンド@kbd{g *}を使用しているときです)。 |
| 2706 | -しかし、これは法的な目的に対しては問題となりません。なぜなら、そのテキストは存在しているからです。 | |
| 2718 | +しかし、これは法的な目的に対しては問題となりません。 | |
| 2719 | +なぜなら、そのテキストは存在しているからです。 | |
| 2707 | 2720 | |
| 2708 | 2721 | 同様に、@code{@@copying}のテキストは、それぞれのHTML出力ファイルの先頭に、コメントとして、自動的に含められます。 |
| 2709 | 2722 | また、このテキストは、(読者がHTMLのソースを見ない限り)見ることができません。 |
| @@ -2717,7 +2730,7 @@ Copyright @copyright{} @var{years} @var{copyright-owner}. | ||
| 2717 | 2730 | ハードコピーの出力では、マニュアルの名前と著作者は、通常はタイトルページに印刷されます。 |
| 2718 | 2731 | 著作権情報は通常、タイトルページの裏に印刷されます。 |
| 2719 | 2732 | |
| 2720 | -タイトルページと著作権ページは印刷されたマニュアルには現れますが、Infoファイルには現れません。 | |
| 2733 | +タイトルページと著作権ページは印刷マニュアルには現れますが、Infoファイルには現れません。 | |
| 2721 | 2734 | このため、Infoファイルで使用不可能な、少し分かりにくい@TeX{}組版コマンドを、いくつか使用することが可能です。 |
| 2722 | 2735 | さらに、Texinfoファイル冒頭のこの部分には、印刷されたマニュアルに現れる複製許諾 |
| 2723 | 2736 | のテキストを含んでいます。 |
| @@ -2750,43 +2763,45 @@ Copyright @copyright{} @var{years} @var{copyright-owner}. | ||
| 2750 | 2763 | |
| 2751 | 2764 | タイトルページと、それに続く著作権ページのための材料は、@code{@@titlepage}の単独行で開始し、@code{@@end titlepage}の単独行で終了します。 |
| 2752 | 2765 | |
| 2753 | -@code{@@end titlepage}コマンドは、新しいページから始め、ページの番号付けを開始します。 | |
| 2754 | -(ページヘッダ生成の詳細は、@xref{Headings, , Page Headings}.) | |
| 2766 | +@code{@@end titlepage}コマンドは改ページを行ない、ページの番号付けを開始します。 | |
| 2767 | +(ページヘッダ生成の詳細は別の節を参照してください(@pxref{Headings, , Page Headings})。) | |
| 2755 | 2768 | 番号付けされないページにしたいものは、@code{@@titlepage}と@code{@@end titlepage}コマンドの間に書きます。 |
| 2756 | -@code{@@setcontentsaftertitlepage}コマンドで、目次をその場所に表示することが可能です(@pxref{Contents})。 | |
| 2769 | +目次をその場所に強制的に表示するには、@code{@@setcontentsaftertitlepage}コマンドを使用します(@pxref{Contents})。 | |
| 2757 | 2770 | |
| 2758 | 2771 | @findex page@r{, within @code{@@titlepage}} |
| 2759 | -@code{@@page}コマンドを使用することで、@code{@@titlepage}と@code{@@end titlepage}コマンドで線引きをした領域の中で強制的に改ページすることが出来ます。 | |
| 2772 | +@code{@@page}コマンドを使用すると、@code{@@titlepage}と@code{@@end titlepage}コマンドで線引きをした領域の中で強制的に改ページすることが出来ます。 | |
| 2760 | 2773 | これによって番号付けされないページを複数作成することが出来ます。 |
| 2761 | 2774 | これは、著作権ページを作成する方法です。 |
| 2762 | 2775 | (@code{@@titlepage}コマンドは、おそらく@code{@@titleandadditionalpages}と名付けた方がいいのですが、それは長すぎます!) |
| 2763 | 2776 | |
| 2764 | 2777 | コンピュータプログラムのマニュアルを書く場合は、マニュアルが適合するプログラムのバージョンをタイトルページに書くべきです。 |
| 2765 | -マニュアルがプログラムより変更頻度が高いとか、あるいは、プログラムとは独立したものである場合には、マニュアルのエディション番号@footnote{独立したマニュアルのバージョンを`edition'として、プログラムのバージョンを`version'として参照することが便利だと分かっています。 | |
| 2778 | +マニュアルがプログラムより変更頻度が高いとか、あるいは、プログラムとは独立したものである場合には、マニュアルのエディション番号@footnote{独立したマニュアルのバージョンを「edition」として、プログラムのバージョンを「version」として参照することが便利だと分かっています。 | |
| 2766 | 2779 | そうしない場合、ドキュメントとソフトウェアの両方を同じ単語で言及することで、お互いに混乱しやすいことが分かりました。 |
| 2767 | 2780 | }を含めるべきです。 |
| 2768 | -これは、マニュアルがどのプログラムのバージョンに対するものかを、読者が追跡する助けとなります(`Top'ノードもこの情報も含むべきでしょう。 | |
| 2769 | -@ref{The Top Node}を参照してください。)。 | |
| 2781 | +これは、マニュアルがどのプログラムのバージョンに対するものかを、読者が追跡する助けとなります。 | |
| 2782 | +Topノードにもこの情報も入れるべきでしょう。 | |
| 2783 | +@xref{The Top Node}. | |
| 2770 | 2784 | |
| 2771 | -Texinfoでは、タイトルページの作成に対して二つの主な方法を提供しています。 | |
| 2772 | -一つの方法は、@code{@@titlefont}、@code{@@sp}、そして@code{@@center}コマンドを、ページの単語を中央揃えしたタイトルページを生成するために使います。 | |
| 2785 | +Texinfoでは、タイトルページの作成する主たる方法を二つ用意しています。 | |
| 2786 | +一つは、@code{@@titlefont}コマンド、@code{@@sp}コマンド、@code{@@center}コマンドを使って、ページの単語を中央揃えしたタイトルページを生成する方法です。 | |
| 2773 | 2787 | |
| 2774 | -二番目の方法は、@code{@@title}、@code{@@subtitle}、そして@code{@@author}コマンドを、タイトルの下に黒い罫線をつけてタイトルページを作成し、著作者の行とサブタイトルテキストをページで右寄せするために使用します。 | |
| 2788 | +もう一つは、@code{@@title}コマンド、@code{@@subtitle}コマンド、@code{@@author}コマンドを使って、タイトルに黒い下線を付けてタイトルページを作成し、著作者名とサブタイトルテキストをページで右寄せする方法です。 | |
| 2775 | 2789 | この方法では、タイトルページの実際の書式化を何も指定しません。 |
| 2776 | 2790 | ユーザは必要なテキストを指定するだけで、後はTexinfoが書式化を行います。 |
| 2777 | 2791 | |
| 2778 | 2792 | どちらか一方だけを使用してもよいですし、両方を組み合わせてもかまいません。 |
| 2779 | -以下のセクションでサンプルを参照してください。 | |
| 2793 | +次節以降のサンプルを参照してください。 | |
| 2780 | 2794 | |
| 2781 | 2795 | @findex shorttitlepage |
| 2782 | 2796 | @cindex Bastard title page |
| 2783 | 2797 | @cindex Title page, bastard |
| 2784 | -ごく簡単なドキュメントや、本の伝統的な前付けに使われる通常のものとは異なるタイトルページについては、Texinfoは、残りの部分をタイトルとして使う@code{@@shorttitlepage}コマンドも提供しています。 | |
| 2798 | +ごく簡単なドキュメントや、本の伝統的な前付けに使われる通常のものとは異なるタイトルページについては、Texinfoは@code{@@shorttitlepage}コマンドを用意しています。 | |
| 2799 | +このコマンドは、行の残りの部分をタイトルとして使用します。 | |
| 2785 | 2800 | その引数は、単独でページに組版され、空白のページがそれに続きます。 |
| 2786 | 2801 | |
| 2787 | 2802 | |
| 2788 | 2803 | @node titlefont center sp |
| 2789 | -@subsection @code{@@titlefont}、@code{@@center}、そして@code{@@sp} | |
| 2804 | +@subsection @code{@@titlefont}・@code{@@center}・@code{@@sp} | |
| 2790 | 2805 | @findex titlefont |
| 2791 | 2806 | @findex center |
| 2792 | 2807 | @findex sp @r{(titlepage line spacing)} |
| @@ -2798,10 +2813,10 @@ Texinfoでは、タイトルページの作成に対して二つの主な方法 | ||
| 2798 | 2813 | 特に長いタイトルの場合には複数回@code{@@titlefont}を使うことも出来ます。 |
| 2799 | 2814 | |
| 2800 | 2815 | HTML出力では、各@code{@@titlefont}コマンドは@code{<h1>}の見出しを生成しますが、HTMLドキュメントの@code{<title>}には影響しません。 |
| 2801 | -そのためには、@code{titlefont}コマンドの前に@code{@@settitle}コマンドを置かなければなりません(@pxref{settitle})。 | |
| 2816 | +@code{<title>}を変更するには、@code{titlefont}コマンドの前に@code{@@settitle}コマンドを置かなければなりません(@pxref{settitle})。 | |
| 2802 | 2817 | |
| 2803 | 2818 | @need 700 |
| 2804 | -例えば、以下のようにします。 | |
| 2819 | +例を挙げます。 | |
| 2805 | 2820 | |
| 2806 | 2821 | @example |
| 2807 | 2822 | @@titlefont@{Texinfo@} |
| @@ -2826,7 +2841,8 @@ HTML出力では、各@code{@@titlefont}コマンドは@code{<h1>}の見出し | ||
| 2826 | 2841 | @end example |
| 2827 | 2842 | |
| 2828 | 2843 | @noindent |
| 2829 | -これで印刷されたページに二行の空白行が挿入されます(@code{@@sp}コマンドの詳細は、@pxref{sp, , @code{@@sp}})。 | |
| 2844 | +これで印刷されたページに二行の空白行が挿入されます。 | |
| 2845 | +@code{@@sp}コマンドの詳細は別の節を参照してください(@pxref{sp, , @code{@@sp}})。 | |
| 2830 | 2846 | |
| 2831 | 2847 | この手法のテンプレートは、以下のようになります。 |
| 2832 | 2848 |
| @@ -2851,15 +2867,16 @@ HTML出力では、各@code{@@titlefont}コマンドは@code{<h1>}の見出し | ||
| 2851 | 2867 | しかし、論理的なマークアップコマンドではありませんので、推奨はしません。 |
| 2852 | 2868 | |
| 2853 | 2869 | @node title subtitle author |
| 2854 | -@subsection @code{@@title}、@code{@@subtitle}、そして@code{@@author} | |
| 2870 | +@subsection @code{@@title}・@code{@@subtitle}・@code{@@author} | |
| 2855 | 2871 | @findex title |
| 2856 | 2872 | @findex subtitle |
| 2857 | 2873 | @findex author |
| 2858 | 2874 | |
| 2859 | 2875 | @code{@@title}コマンド、@code{@@subtitle}コマンド、@code{@@author}コマンドを使うと、垂直方向、水平方向の空白調整が自動的に行なわれたタイトルページを生成することが出来ます。 |
| 2860 | -これは前のセクションで説明した、垂直方向の空白調整に@code{@@sp}コマンドが必要となる方法とは対照的です。 | |
| 2876 | +これは前節で説明した、垂直方向の空白調整に@code{@@sp}コマンドが必要となる方法とは対照的です。 | |
| 2861 | 2877 | |
| 2862 | -@code{@@title}コマンド、@code{@@subtitle}コマンド、@code{@@author}コマンドは行頭に書いて、それぞれタイトル、サブタイトル、著作者を続けて記述してください。 | |
| 2878 | +@code{@@title}コマンド、@code{@@subtitle}コマンド、@code{@@author}コマンドは行頭に書きます。 | |
| 2879 | +続けてそれぞれにはタイトル、サブタイトル、著作者を続けて記述します。 | |
| 2863 | 2880 | これらのコマンドは@TeX{}出力でだけ効果があります。 |
| 2864 | 2881 | @code{@@titlepage}の中以外の場所で使用するとエラーとなります。 |
| 2865 | 2882 |
| @@ -2873,7 +2890,7 @@ HTML出力では、各@code{@@titlefont}コマンドは@code{<h1>}の見出し | ||
| 2873 | 2890 | @code{@@subtitle}コマンドは、通常の大きさのフォントでページの右側にサブタイトルを設定します。 |
| 2874 | 2891 | |
| 2875 | 2892 | @code{@@author}コマンドは、著作者の名前を中間の大きさのフォントで、タイトルページの一番下あたりに左揃えで配置します。 |
| 2876 | -名前は、タイトルに引かれる下線より細い黒い下線が引かれます。 | |
| 2893 | +名前は、タイトルに引かれる黒い下線より細い下線が引かれます。 | |
| 2877 | 2894 | (黒い下線は、@code{@@author}コマンド行に、@code{@@page}コマンド行が続く場合にだけ表示されます。) |
| 2878 | 2895 | |
| 2879 | 2896 | @code{@@author}コマンドには使い方が二つあります。 |
| @@ -2884,7 +2901,7 @@ HTML出力では、各@code{@@titlefont}コマンドは@code{<h1>}の見出し | ||
| 2884 | 2901 | @end example |
| 2885 | 2902 | |
| 2886 | 2903 | @noindent |
| 2887 | -あるいは、二つ(またはそれ以上)の@code{@@author}コマンドを使って、上記の名前を一つずつ書くことも出来ます。 | |
| 2904 | +もう一つは、二つ(またはそれ以上)の@code{@@author}コマンドを使って、上記の名前を一つずつ書く方法です。 | |
| 2888 | 2905 | |
| 2889 | 2906 | @example |
| 2890 | 2907 | @group |
| @@ -2894,7 +2911,7 @@ HTML出力では、各@code{@@titlefont}コマンドは@code{<h1>}の見出し | ||
| 2894 | 2911 | @end example |
| 2895 | 2912 | |
| 2896 | 2913 | @noindent |
| 2897 | -(下の名前のみ、黒い罫線の下線がつきます。) | |
| 2914 | +(一番下の名前のみ、黒い罫線の下線がつきます。) | |
| 2898 | 2915 | |
| 2899 | 2916 | @need 950 |
| 2900 | 2917 | A template for this method looks like this: |
| @@ -2928,7 +2945,7 @@ A template for this method looks like this: | ||
| 2928 | 2945 | @end example |
| 2929 | 2946 | |
| 2930 | 2947 | @noindent |
| 2931 | -(ここでの@code{@@value}の使い方は、@ref{value Example}で説明されています。) | |
| 2948 | +ここでの@code{@@value}の使い方は別の節で説明しています(@pxref{value Example})。 | |
| 2932 | 2949 | |
| 2933 | 2950 | |
| 2934 | 2951 | @node Copyright |
| @@ -2953,9 +2970,9 @@ A template for this method looks like this: | ||
| 2953 | 2970 | @noindent |
| 2954 | 2971 | これは、Info書式化コマンドがサポートしていない@TeX{}コマンドです。 |
| 2955 | 2972 | @code{@@vskip}コマンドは空白を挿入します。 |
| 2956 | -@samp{0pt plus 1filll}は、0ポイントの必須の空白を書き、以下のテキストをページの下に書くことに必要な追加の空白を配置することを意味します。 | |
| 2973 | +@samp{0pt plus 1filll}は、0ポイントの必須の空白を起き、以降のテキストをそのページの下部に配置するのに必要なだけの空白を配置するということを意味します。 | |
| 2957 | 2974 | @samp{filll}の三つの@samp{l}を使用していることに注意してください。 |
| 2958 | -これは正しい使い方です。 | |
| 2975 | +これが正しい使い方です。 | |
| 2959 | 2976 | |
| 2960 | 2977 | 著作権のテキスト自身を挿入するためには、次のように@code{@@insertcopying}を書いてください(@pxref{Document Permissions})。 |
| 2961 | 2978 |
| @@ -2994,7 +3011,7 @@ Cover art by @dots{} | ||
| 2994 | 3011 | このコマンドは、タイトルページと著作権ページの終わりを示すだけでなく、@TeX{}に対して、ページヘッダとページ番号の生成を開始するよう指示するものになります。 |
| 2995 | 3012 | |
| 2996 | 3013 | 他で述べた繰り返しですが、Texinfoにはページヘッダの標準的な書式が二つあります。 |
| 2997 | -一つは紙のそれぞれの片側に印刷されたドキュメント(片面印刷)のためのもの、もう一はそれぞれの用紙の両側に印刷されたドキュメント(両面印刷)のためのものです。 | |
| 3014 | +一つは各用紙の片側に印刷されたドキュメント(片面印刷)のためのもの、もう一は各用紙の両側に印刷されたドキュメント(両面印刷)のためのものです。 | |
| 2998 | 3015 | これらの書式をさまざまな方法で指定することが可能です。 |
| 2999 | 3016 | |
| 3000 | 3017 | @itemize @bullet |
| @@ -3003,12 +3020,12 @@ Cover art by @dots{} | ||
| 3003 | 3020 | |
| 3004 | 3021 | @item |
| 3005 | 3022 | 他の方法として、@code{@@headings}コマンドを使って、ページヘッダの生成を抑制したり、片面印刷用や両面印刷用にページヘッダの生成を開始したり出来ます。 |
| 3006 | -(@code{@@headings}コマンドは、@code{@@end titlepage}コマンドの直後に書いてください。 | |
| 3007 | -詳細は、@xref{headings on off, , The @code{@@headings} Command}.)@refill | |
| 3023 | +@code{@@headings}コマンドは@code{@@end titlepage}コマンドの直後に書いてください。 | |
| 3024 | +@xref{headings on off, , The @code{@@headings} Command}.@refill | |
| 3008 | 3025 | |
| 3009 | 3026 | @item |
| 3010 | 3027 | あるいは、独自にページヘッダやフッタの書式を指定できます。 |
| 3011 | -ページヘッダとフッタの詳細は、@xref{Headings, , Page Headings}. | |
| 3028 | +ページヘッダとフッタの詳細は別の節を参照してください(@pxref{Headings, , Page Headings})。 | |
| 3012 | 3029 | @end itemize |
| 3013 | 3030 | |
| 3014 | 3031 | ほとんどのドキュメントは標準的な片面または両面の書式で書式化されます。 |
| @@ -3061,8 +3078,7 @@ Cover art by @dots{} | ||
| 3061 | 3078 | @noindent |
| 3062 | 3079 | @code{@@headings off}コマンドは、@code{@@end titlepage}コマンドに優先し、それ以外の場合は@TeX{}にページヘッダを印刷させます。 |
| 3063 | 3080 | |
| 3064 | -ページヘッダとフッタの独自のスタイルを指定することも可能です。 | |
| 3065 | -詳細は、@xref{Headings, , Page Headings}. | |
| 3081 | +ページヘッダとフッタの独自のスタイルを指定することも可能です(@pxref{Headings, , Page Headings})。 | |
| 3066 | 3082 | |
| 3067 | 3083 | |
| 3068 | 3084 | @node Contents |
| @@ -3081,14 +3097,14 @@ Cover art by @dots{} | ||
| 3081 | 3097 | @table @code |
| 3082 | 3098 | @item @@contents |
| 3083 | 3099 | 印刷マニュアルに目次を生成します。 |
| 3084 | -その目次には、章やセクション、サブセクションなどと一緒に、付録や番号付けされない章も含まれます。 | |
| 3100 | +その目次には、章やセクション、サブセクションなどと一緒に、appendixや番号付けされない章も含まれます。 | |
| 3085 | 3101 | @code{@@majorheading}コマンドや@code{@@chapheading}、その他の@code{@@@dots{}heading}コマンドは目次の中に現われません(@pxref{Structuring Command Types})。 |
| 3086 | 3102 | |
| 3087 | 3103 | @item @@shortcontents |
| 3088 | 3104 | @itemx @@summarycontents |
| 3089 | 3105 | (@code{@@summarycontents}は@code{@@shortcontents}の別名です。) |
| 3090 | 3106 | |
| 3091 | -章や付録、番号付けされない章だけを一覧する簡略された目次を生成します。 | |
| 3107 | +章やappendix、番号付けされない章だけを一覧する簡略された目次を生成します。 | |
| 3092 | 3108 | セクションやサブセクション、サブサブセクションは省略されます。 |
| 3093 | 3109 | 詳細な目次に加えて簡略目次が必要となるのは、長いマニュアルだけです。 |
| 3094 | 3110 |
| @@ -3105,7 +3121,7 @@ Infoファイルでは目次ではなくメニューを使用しますので、I | ||
| 3105 | 3121 | 詳細目次のリンクは本文を指しています。 |
| 3106 | 3122 | |
| 3107 | 3123 | これまで目次コマンドは、全ての索引の後ろで@code{@@bye}コマンドのすぐ前のファイルの終わりの部分に置かれることがありました。 |
| 3108 | -しかし、このようにするのはこれ以上推奨しません。 | |
| 3124 | +しかし、このようにするのは今後は推奨しません。 | |
| 3109 | 3125 | |
| 3110 | 3126 | @findex setcontentsaftertitlepage |
| 3111 | 3127 | @findex setshortcontentsaftertitlepage |
| @@ -3127,22 +3143,24 @@ texi2dvi --texinfo=@@setcontentsaftertitlepage foo.texi | ||
| 3127 | 3143 | |
| 3128 | 3144 | |
| 3129 | 3145 | @node The Top Node |
| 3130 | -@section `Top'ノードとマスターメニュー | |
| 3146 | +@section Topノードとマスターメニュー | |
| 3131 | 3147 | @cindex Top node |
| 3132 | 3148 | @cindex Node, `Top' |
| 3133 | 3149 | |
| 3134 | -`Top'ノードは、Infoマニュアルへの読者の入口です。 | |
| 3135 | -そのため、`Top'ノードは、バージョン番号を含めたマニュアルの簡単な説明で始め、マニュアル全体に対するマスターメニューで終わるべきです。 | |
| 3150 | +Topノードは、Infoマニュアルへの読者の入口です。 | |
| 3151 | +そのため、Topノードは、バージョン番号を含めたマニュアルの簡単な説明で始め、マニュアル全体に対するマスターメニューで終わるべきです。 | |
| 3136 | 3152 | もちろん、読者が有用だと思うであろうその他の一般的な情報も含めるべきです。 |
| 3137 | 3153 | |
| 3138 | 3154 | @findex top |
| 3139 | 3155 | @code{@@node Top}行の直後に、ドキュメントのタイトルが入った区切りコマンドの@code{@@top}を記述するのは一般に行なわれていて、望ましいものです(@pxref{makeinfo top command, , The @code{@@top} Sectioning Command})。 |
| 3140 | 3156 | |
| 3141 | -`Top'ノードの内容はオンラインの出力だけに現れます。 | |
| 3157 | +Topノードの内容はオンラインの出力だけに現れます。 | |
| 3142 | 3158 | 印刷されたマニュアルには何も現われませんので、@code{@@ifnottex}コマンドと@code{@@end ifnottex}コマンドで挟んでください。 |
| 3143 | -(@TeX{}は@code{@@node}行もメニューも印刷しません。 | |
| 3144 | -それらはInfoだけに現れます。厳密には、@code{@@ifnottex}と@code{@@end ifnottex}でこれらの部分を囲む必要はありませんが、そうするのが最も簡単です。 | |
| 3145 | -@xref{Conditionals, , Conditionally Visible Text}.) | |
| 3159 | + | |
| 3160 | +@TeX{}は@code{@@node}行もメニューも印刷しません。 | |
| 3161 | +それらはInfoだけに現れます。 | |
| 3162 | +厳密には、@code{@@ifnottex}と@code{@@end ifnottex}でこれらの部分を囲む必要はありませんが、そうするのが最も簡単です。 | |
| 3163 | +@xref{Conditionals, , Conditionally Visible Text}. | |
| 3146 | 3164 | |
| 3147 | 3165 | @menu |
| 3148 | 3166 | * Top Node Example:: |
| @@ -3186,16 +3204,16 @@ Additional general information. | ||
| 3186 | 3204 | @cindex Menu, master |
| 3187 | 3205 | @cindex Parts of a master menu |
| 3188 | 3206 | |
| 3189 | -@dfn{マスターメニュー(master menu)}は、ファイル全体のノードをリストアップする詳細なメインメニューです。 | |
| 3207 | +@dfn{マスターメニュー}は、ファイル全体のノードをリストアップする詳細なメインメニューです。 | |
| 3190 | 3208 | |
| 3191 | -マスターメニューは、@code{@@menu}と@code{@@end menu}コマンドで囲まれていて、印刷されたドキュメントには現れません。 | |
| 3209 | +マスターメニューは、@code{@@menu}と@code{@@end menu}コマンドで囲まれていて、印刷ドキュメントには現れません。 | |
| 3192 | 3210 | |
| 3193 | 3211 | 一般に、マスターメニューはいくつかの部分に分かれています。 |
| 3194 | 3212 | |
| 3195 | 3213 | @itemize @bullet |
| 3196 | 3214 | @item |
| 3197 | 3215 | 最初の部分には、Texinfoファイルの主要なノードが入っています。 |
| 3198 | -章のノード、章のような部分、そして付録です。 | |
| 3216 | +章のノード、章のような部分、そしてappendixです。 | |
| 3199 | 3217 | |
| 3200 | 3218 | @item |
| 3201 | 3219 | 二番目の部分には索引のノードが入ります。 |
| @@ -3213,7 +3231,7 @@ Additional general information. | ||
| 3213 | 3231 | |
| 3214 | 3232 | メニューの各セクションの前には、それを説明する行を置くことが出来ます。 |
| 3215 | 3233 | 行がアスタリスクで始まらない行は、メニューエントリとしては扱われません。 |
| 3216 | -(詳細は、@xref{Writing a Menu}.) | |
| 3234 | +(詳細は別の節を参照してください(@pxref{Writing a Menu})。) | |
| 3217 | 3235 | |
| 3218 | 3236 | 例えば、このマニュアルのマスターメニューは、以下のようになっています(もっと多くの項目がありますが)。 |
| 3219 | 3237 |
| @@ -3254,7 +3272,7 @@ Beginning a Texinfo File | ||
| 3254 | 3272 | @section 大域的なドキュメントコマンド |
| 3255 | 3273 | @cindex Global Document Commands |
| 3256 | 3274 | |
| 3257 | -前のセクションで言及した基本的なコマンドに加え、以下のようなドキュメント全体に影響のあるコマンドがあります。 | |
| 3275 | +前節で言及した基本的なコマンドに加え、以下のようなドキュメント全体に影響のあるコマンドがあります。 | |
| 3258 | 3276 | そういったコマンドが指定されるとしたならば、通常はすべてTopノードの前で指定されます。 |
| 3259 | 3277 | |
| 3260 | 3278 | @menu |
| @@ -3301,14 +3319,14 @@ descriptive text. | ||
| 3301 | 3319 | @cindex Pages, starting odd |
| 3302 | 3320 | @findex setchapternewpage |
| 3303 | 3321 | |
| 3304 | -本格的に製本された本では、通常テキストは紙の両面に印刷され、章は右側のページから始まり、そして右のページは奇数番号です。 | |
| 3322 | +本格的に製本された本では、通常、テキストは紙の両面に印刷され、章は右側のページから始まります。 | |
| 3323 | +右のページは奇数番号です。 | |
| 3305 | 3324 | しかし、簡単なレポートではテキストが紙の片面だけに印刷されることもよくあります。 |
| 3306 | -また簡単なレポートでは、ページを改めずに章が始まり、小量の縦方向の空白の後、前の章が終わったのと同じページで印刷されることもあります。 | |
| 3325 | +また簡単なレポートだと、前の章が終わったのと同じページで、改ページすることなく、縦方向に少量の空白を入れた後、新しい章が開始されることもあります。 | |
| 3307 | 3326 | |
| 3308 | -様々な引数を付けて@code{@@setchapternewpage}コマンドを使うと、@TeX{}が章を開始する方法や、@TeX{}がヘッダを書式化する際に、片面印刷にするか、両面印刷にするかを指定することが出来ます。 | |
| 3327 | +様々な引数を付けて@code{@@setchapternewpage}コマンドを使うことで、@TeX{}が章を開始する方法や、@TeX{}がヘッダを書式化する際に片面印刷にするか、両面印刷にするかを指定することが出来ます。 | |
| 3309 | 3328 | |
| 3310 | -@code{@@setchapternewpage}コマンドは行頭に書き、続けて引数を書いてくださ | |
| 3311 | -い。 | |
| 3329 | +@code{@@setchapternewpage}コマンドは行頭に書き、続けて引数を書いてください。 | |
| 3312 | 3330 | |
| 3313 | 3331 | 例えば、それぞれの章を新しい奇数ページから始めるため、以下のように書きます。 |
| 3314 | 3332 |
| @@ -3316,7 +3334,7 @@ descriptive text. | ||
| 3316 | 3334 | @@setchapternewpage odd |
| 3317 | 3335 | @end example |
| 3318 | 3336 | |
| 3319 | -@code{@@setchapternewpage}コマンドで、三つの選択肢の一つを指定することが可能です。 | |
| 3337 | +@code{@@setchapternewpage}コマンドでは、以下の三つの選択肢の一つを指定できます。 | |
| 3320 | 3338 | |
| 3321 | 3339 | @table @asis |
| 3322 | 3340 |
| @@ -3327,7 +3345,7 @@ descriptive text. | ||
| 3327 | 3345 | |
| 3328 | 3346 | @item @code{@@setchapternewpage on} |
| 3329 | 3347 | @TeX{}に、新しいページで章を開始し、片面印刷用のページヘッダを書式化させます。 |
| 3330 | -簡単なレポートや個人的な印刷で最も多用させる形式です。 | |
| 3348 | +簡単なレポートや個人的な印刷で最も多用される形式です。 | |
| 3331 | 3349 | これがデフォルトです。 |
| 3332 | 3350 | |
| 3333 | 3351 | @item @code{@@setchapternewpage odd} |
| @@ -3341,8 +3359,9 @@ Texinfoには@code{@@setchapternewpage even}というコマンドはありませ | ||
| 3341 | 3359 | @code{@@setchapternewpage}が設定するデフォルトのヘッダが好みではない場合、@code{@@headings}コマンドを用いて明示的に制御することが可能です。 |
| 3342 | 3360 | @xref{headings on off, , The @code{@@headings} Command}. |
| 3343 | 3361 | |
| 3344 | -マニュアルや本の最初では、ページの番号付けはされません --- 例えば、本のタイトルページや著作権のページは番号付けされていません。 | |
| 3345 | -慣習で、目次のページと前付けのページはローマ数字で番号付けされ、それはドキュメントの残りの部分と連番にはなっていません。 | |
| 3362 | +マニュアルや本の最初では、ページの番号付けはされません。 | |
| 3363 | +例えば、本のタイトルページや著作権のページは番号付けされていません。 | |
| 3364 | +慣習では、目次のページと前付けのページはローマ数字で番号付けされますが、それはドキュメントの残りの部分とは連番にはなっていません。 | |
| 3346 | 3365 | |
| 3347 | 3366 | Infoファイルにはページというものが無いので、@code{@@setchapternewpage}はInfoファイルには効果がありません。 |
| 3348 | 3367 |
| @@ -3381,10 +3400,10 @@ Info出力では@var{n}個のスペース文字、@TeX{}では@var{n}字下げ | ||
| 3381 | 3400 | @end table |
| 3382 | 3401 | |
| 3383 | 3402 | @var{indent}のデフォルト値は3です。 |
| 3384 | -@code{@@paragraphindent}は、HTML出力では無視されます。 | |
| 3403 | +@code{@@paragraphindent}はHTML出力では無視されます。 | |
| 3385 | 3404 | |
| 3386 | 3405 | @code{@@paragraphindent}コマンドは、Texinfoファイル冒頭のend-of-header行の前に書くのが最適です。 |
| 3387 | -そうすればリージョンの書式化コマンドは指定した通りに段落を字下げします。 | |
| 3406 | +そうすればリージョンを書式化するコマンドが指定した通りに段落を字下げできます。 | |
| 3388 | 3407 | @xref{Start of Header}. |
| 3389 | 3408 | |
| 3390 | 3409 | @code{texinfo-format-buffer}コマンドと@code{texinfo-format-region}コマンドの特別なところは、@code{@@w}や@code{@@*}コマンドを含む段落を字下げしない(または追い込みしない)ことです。 |
| @@ -3416,8 +3435,8 @@ Info出力では@var{n}個のスペース文字、@TeX{}では@var{n}字下げ | ||
| 3416 | 3435 | @code{@@paragraphindent asis}が有効の場合、@command{makeinfo}はこのオプションを無視します。 |
| 3417 | 3436 | |
| 3418 | 3437 | @item @code{insert} |
| 3419 | -通常の段落字下げを入れます。 | |
| 3420 | -この設定は@code{@@paragraphindent}コマンドで設定される段落字下げを尊重します(@pxref{paragraphindent})。 | |
| 3438 | +通常の段落の字下げを入れます。 | |
| 3439 | +この設定は@code{@@paragraphindent}コマンドで設定される段落の字下げを尊重します(@pxref{paragraphindent})。 | |
| 3421 | 3440 | @end table |
| 3422 | 3441 | |
| 3423 | 3442 | HTMLやXMLの出力では、@code{@@firstparagraphindent}の設定は無視されます。 |
| @@ -3442,7 +3461,7 @@ Texinfoの処理プログラムは、@code{@@example}や類似の環境の各行 | ||
| 3442 | 3461 | @@exampleindent @var{indent} |
| 3443 | 3462 | @end example |
| 3444 | 3463 | |
| 3445 | -HTML出力では、@code{@@exampleindent}を無視します。 | |
| 3464 | +HTML出力では@code{@@exampleindent}を無視します。 | |
| 3446 | 3465 | それ以外では、字下げは@var{indent}の値に従います。 |
| 3447 | 3466 | |
| 3448 | 3467 | @table @asis |
| @@ -3473,7 +3492,7 @@ Info出力において、環境を@var{n}個の空白文字で字下げします | ||
| 3473 | 3492 | @cindex Distribution |
| 3474 | 3493 | @cindex License agreement |
| 3475 | 3494 | |
| 3476 | -「General Public License」と、ドキュメントの対象になっているソフトウェアに関する配布情報や無保証の宣言などが入ったセクションがTexinfoファイルにある場合、これを`Top'ノードの直後に置くことをお勧めします。 | |
| 3495 | +「General Public License」と、ドキュメントの対象になっているソフトウェアに関する配布情報や無保証の宣言などが入ったセクションがTexinfoファイルにある場合、これをTopノードの直後に置くことをお勧めします。 | |
| 3477 | 3496 | General Public Licenseは、GNUプロジェクトのソフトウェアにとって非常に重要なもので、皆さんがそのソフトウェアを使用し、共有し続けるということを確かなものにします。 |
| 3478 | 3497 | |
| 3479 | 3498 | 複写や配布に関する情報や無保証条項の後には、マニュアルの第1章として、導入部分などが続きます。 |
| @@ -3525,9 +3544,9 @@ Texinfoファイルの最後の部分には索引を生成するコマンドと | ||
| 3525 | 3544 | また、印刷マニュアルを作成する処理の中で、@code{texindex} (@pxref{Hardcopy})と呼ばれるプログラムを実行して生データをソートすることで、ソート済みの索引ファイルを作らなければなりません。 |
| 3526 | 3545 | ソート済みの索引ファイルは、その索引を印刷するのに実際に使用されるものです。 |
| 3527 | 3546 | |
| 3528 | -Texinfoは別々の定義済みの索引を6種類用意しています。 | |
| 3547 | +Texinfoは定義済みの索引を別々に6種類用意しています。 | |
| 3529 | 3548 | 大抵これで十分でしょう。 |
| 3530 | -定義済み索引についてや、独自の索引の定義、索引の結合、そして、実際の索引エントリを書く場合の最重要のアドバイスについては、@xref{Indices}. | |
| 3549 | +定義済み索引についてや、独自の索引の定義、索引の結合、そして、実際の索引エントリを書く場合の最重要のアドバイスについては別の節を参照してください(@pxref{Indices})。 | |
| 3531 | 3550 | このセクションは、@code{@@printindex}コマンドで行なわれる、索引の印刷に焦点を当てます。 |
| 3532 | 3551 | |
| 3533 | 3552 | @findex printindex |
| @@ -3607,7 +3626,7 @@ XML出力では、印刷する索引を単に記録します。 | ||
| 3607 | 3626 | これらの注釈は書式化されず、Infoや印刷されたマニュアルに現れません。 |
| 3608 | 3627 | @code{@@bye}後のテキストが@code{@@ignore}@dots{}@code{@@end ignore}の中にあるかのように処理されます。 |
| 3609 | 3628 | また、@code{@@bye}行にEmacsに対するローカルな変数リストを続けてもかまいません。 |
| 3610 | -詳細は、@xref{Compile-Command, , Using Local Variables and the Compile Command}. | |
| 3629 | +@xref{Compile-Command, , Using Local Variables and the Compile Command}. | |
| 3611 | 3630 | |
| 3612 | 3631 | |
| 3613 | 3632 | @node Structuring |
| @@ -3617,7 +3636,7 @@ XML出力では、印刷する索引を単に記録します。 | ||
| 3617 | 3636 | |
| 3618 | 3637 | @dfn{章の構造化(chapter structuring)}コマンドは、ドキュメントを、章、セクション、サブセクション、そしてサブサブセクションからなる階層構造に分割します。 |
| 3619 | 3638 | これらのコマンドは大きな見出しを生成します。 |
| 3620 | -またそれらのコマンドは印刷マニュアルの目次情報も提供します(@pxref{Contents, , Generating a Table of Contents})。@refill | |
| 3639 | +また印刷マニュアルの目次情報も提供します(@pxref{Contents, , Generating a Table of Contents})。@refill | |
| 3621 | 3640 | |
| 3622 | 3641 | 章の構造化コマンドはInfoノード構造を作成しませんので、通常は@code{@@node}コマンドをそれぞれの章の構造化コマンドの直前に書くべきです(@pxref{Nodes})。 |
| 3623 | 3642 | ノードの構造化コマンドを使用せず章の構造化コマンドを使用する可能性があるのは、クロスリファレンスを含まず、Info形式に決して変換しないドキュメントを書く場合だけです。@refill |
| @@ -3676,25 +3695,24 @@ Section Section Section Section Section Section | ||
| 3676 | 3695 | @end group |
| 3677 | 3696 | @end example |
| 3678 | 3697 | |
| 3679 | -章の構造化コマンドは以降のセクションで説明します。 | |
| 3680 | -@code{@@node}と@code{@@menu}コマンドは以降の章で説明します。 | |
| 3681 | -(@xref{Nodes}. | |
| 3682 | -そして、@ref{Menus}を参照してください。)@refill | |
| 3698 | +章の構造化コマンドは次節以降で説明します。 | |
| 3699 | +@code{@@node}と@code{@@menu}コマンドは次章以降で説明します。 | |
| 3700 | +@xref{Nodes}, and see @ref{Menus}.@refill | |
| 3683 | 3701 | |
| 3684 | 3702 | |
| 3685 | 3703 | @node Structuring Command Types |
| 3686 | 3704 | @section 構造化コマンドの種類 |
| 3687 | 3705 | |
| 3688 | -章を構造化するコマンドは、四つのグループ、またはシリーズに分類され、それぞれは、章、セクション、サブセクション、そしてサブサブセクションの階層レベルに対応する構造化コマンドを含んでいます。@refill | |
| 3706 | +章を構造化するコマンドは、四つのグループ、すなわちシリーズに分類され、それぞれは、章、セクション、サブセクション、そしてサブサブセクションの階層レベルに対応する構造化コマンドを含んでいます。@refill | |
| 3689 | 3707 | |
| 3690 | 3708 | 四つのグループは、@code{@@chapter}シリーズ、@code{@@unnumbered}シリーズ、@code{@@appendix}シリーズ、そして@code{@@heading}シリーズです。@refill |
| 3691 | 3709 | |
| 3692 | -それぞれのコマンドは、印刷されたページやInfoファイルで異なる見掛けを持つタイトルを生成します。 | |
| 3693 | -いくつかのコマンドのみ、印刷された本やマニュアルの目次でリストアップされるタイトルを生成します。@refill | |
| 3710 | +それぞれのコマンドは、印刷されたページやInfoファイルにおいて、様々な見掛けを持つタイトルを生成します。 | |
| 3711 | +いくつかのコマンドについては、印刷された本やマニュアルの目次にリストアップされるタイトルを生成します。@refill | |
| 3694 | 3712 | |
| 3695 | 3713 | @itemize @bullet |
| 3696 | 3714 | @item |
| 3697 | -@code{@@chapter}シリーズや@code{@@appendix}シリーズのコマンドは、印刷物の本体やその目次に、番号や文字が付いたエントリを生成します。@refill | |
| 3715 | +@code{@@chapter}コマンドや@code{@@appendix}コマンドのシリーズは、印刷物の本体やその目次に、番号や文字が付いたエントリを生成します。@refill | |
| 3698 | 3716 | |
| 3699 | 3717 | @item |
| 3700 | 3718 | @code{@@unnumbered}シリーズのコマンドは、印刷物の本体やその目次に、番号の付かないエントリを生成します。 |
| @@ -3702,8 +3720,9 @@ Section Section Section Section Section Section | ||
| 3702 | 3720 | @code{@@unnumbered}セクションは、ノードと関連付けられ、ドキュメント構造の通常部分であるべきでしょう。 |
| 3703 | 3721 | |
| 3704 | 3722 | @item |
| 3705 | -@code{@@heading}シリーズのコマンドは、目次に現われず、ノードと関連付けされていなくて、クロスリファレンスされない、番号無しの単純な見出しを生成します。 | |
| 3706 | -見出しコマンドは決して改ページすることはありません。 | |
| 3723 | +@code{@@heading}シリーズのコマンドは、番号無しの単純な見出しを生成します。 | |
| 3724 | +この見出しは、目次に現われず、ノードと関連付けされていなくて、クロスリファレンスされません。 | |
| 3725 | +この見出しコマンドは決して改ページすることはありません。 | |
| 3707 | 3726 | |
| 3708 | 3727 | @item |
| 3709 | 3728 | @code{@@majorheading}コマンドは@code{@@chapheading}コマンドと似ていますが、ただし、見出しの前の縦方向の空白を少し大きく生成します。 |
| @@ -3738,9 +3757,9 @@ Section Section Section Section Section Section | ||
| 3738 | 3757 | @section @code{@@top} |
| 3739 | 3758 | |
| 3740 | 3759 | @code{@@top}コマンドは、Texinfoファイル冒頭の@samp{@@node Top}行の後にだけ使用する特別なセクションコマンドです。 |
| 3741 | -@code{@@top}コマンドは、@code{makeinfo}フォーマッタに`Top'ノードがどれなのかを伝えますので、そのマニュアルで暗黙のノードポインタを使用する場合、@code{makeinfo}は、そのノードをノードツリーのルートとして使用することが出来ます。 | |
| 3760 | +@code{@@top}コマンドは、@code{makeinfo}フォーマッタにTopノードがどれなのかを伝えますので、そのマニュアルで暗黙のノードポインタを使用する場合、@code{makeinfo}は、そのノードをノードツリーのルートとして使用することが出来ます。 | |
| 3742 | 3761 | このコマンドは@code{@@unnumbered}(@pxref{unnumbered & appendix, , @code{@@unnumbered} and @code{@@appendix}})と同じ組版の効果を持ちます。 |
| 3743 | -詳細は、@ref{makeinfo top command, , The @code{@@top} Command}を参照してください。 | |
| 3762 | +詳細は別の節を参照してください(@pxref{makeinfo top command, , The @code{@@top} Command})。 | |
| 3744 | 3763 | |
| 3745 | 3764 | @code{@@top}ノードと(あれば)そのメニューは、慣習として、@code{@@ifnottex}条件で挟まれています。 |
| 3746 | 3765 | そのため、Info出力やHTML出力でだけ現われます。 |
| @@ -3755,7 +3774,7 @@ Section Section Section Section Section Section | ||
| 3755 | 3774 | @code{@@chapter}はドキュメントの章を識別します。 |
| 3756 | 3775 | このコマンドを行頭に書き、続けて同じ行に章のタイトルを書いてください。@refill |
| 3757 | 3776 | |
| 3758 | -例えば、このマニュアルのこの章は、``章の構造(Chapter Structuring)''というタイトルが付けられています。 | |
| 3777 | +例えば、このマニュアルのこの章は、「章の構造(Chapter Structuring)」というタイトルが付けられています。 | |
| 3759 | 3778 | @code{@@chapter}行は以下のようになります。@refill |
| 3760 | 3779 | |
| 3761 | 3780 | @example |
| @@ -3766,7 +3785,7 @@ Section Section Section Section Section Section | ||
| 3766 | 3785 | 章は自動的に番号付けされます。@refill |
| 3767 | 3786 | |
| 3768 | 3787 | Infoでは、@code{@@chapter}コマンドはタイトルを単独行に現し、下にはアスタリスクによる線が挿入されます。 |
| 3769 | -従って、Infoで上の例は以下の出力を生成します。@refill | |
| 3788 | +したがって、Infoで上の例は以下の出力を生成します。@refill | |
| 3770 | 3789 | |
| 3771 | 3790 | @example |
| 3772 | 3791 | Chapter Structuring |
| @@ -3776,7 +3795,7 @@ Chapter Structuring | ||
| 3776 | 3795 | @findex centerchap |
| 3777 | 3796 | また、Texinfoは@code{@@centerchap}コマンドを用意しています。 |
| 3778 | 3797 | @code{@@unnumbered}に似ていますが、印刷出力でその引数を中央揃えします。 |
| 3779 | -この種の形式上の選択は、通常Texinfoでは提案されません。 | |
| 3798 | +通常は、この種のスタイル上の選択肢がTexinfoで提示されることはありません。 | |
| 3780 | 3799 | @c but the Hacker's Dictionary wanted it ... |
| 3781 | 3800 | |
| 3782 | 3801 |
| @@ -3785,8 +3804,8 @@ Chapter Structuring | ||
| 3785 | 3804 | @findex unnumbered |
| 3786 | 3805 | @findex appendix |
| 3787 | 3806 | |
| 3788 | -@code{@@unnumbered}コマンドは、印刷されたマニュアルであらゆる種類の数字が付かない章を作成するために使用してください。 | |
| 3789 | -@code{@@appendix}コマンドは、印刷されたマニュアルで数字の代わりに文字(`A', `B', @dots{})でラベルが付く付録を作成するために使用してください。@refill | |
| 3807 | +@code{@@unnumbered}コマンドは、印刷マニュアルにおいて、番号が全く振られない章を作成するのに使用します。 | |
| 3808 | +@code{@@appendix}コマンドは、印刷マニュアルにおいて、番号の代わりに文字(`A', `B', @dots{})でラベルが付くappendixを作成するのに使用します。@refill | |
| 3790 | 3809 | |
| 3791 | 3810 | @code{@@appendix}コマンドや@code{@@unnumbered}コマンドは、章を作成する時と同じように、コマンドを行頭に書き、続けて同じ行にタイトルを書いてください。 |
| 3792 | 3811 |
| @@ -3796,24 +3815,25 @@ Chapter Structuring | ||
| 3796 | 3815 | @findex majorheading |
| 3797 | 3816 | @findex chapheading |
| 3798 | 3817 | |
| 3799 | -@code{@@majorheading}と@code{@@chapheading}コマンドは、ドキュメントの本体に章のような見出しを書き出します。@refill | |
| 3818 | +@code{@@majorheading}と@code{@@chapheading}コマンドは、ドキュメントの本体に章のような見出しを配置します。@refill | |
| 3800 | 3819 | |
| 3801 | -しかし、いずれのコマンドも番号付の見出しや目次エントリを@TeX{}に生成させません。 | |
| 3802 | -また、どちらのコマンドも、印刷マニュアルにおいて@TeX{}に新しいページを開始させません。@refill | |
| 3820 | +しかし、いずれのコマンドの場合も、@TeX{}は、番号付の見出しや目次エントリを生成しません。 | |
| 3821 | +また、どちらのコマンドの場合も、@TeX{}は、印刷マニュアルにおいて改ページを行ないません。@refill | |
| 3803 | 3822 | |
| 3804 | -@TeX{}では、@code{@@majorheading}コマンドが見出しの前に生成するは垂直方向の空白は、@code{@@chapheading}コマンドが生成するより大きいですが、それ以外は全く同じです。 | |
| 3823 | +@TeX{}では、@code{@@majorheading}コマンドが見出しの前に生成する垂直方向の空白は、@code{@@chapheading}コマンドが生成するより大きいですが、それ以外は全く同じです。 | |
| 3805 | 3824 | |
| 3806 | 3825 | Infoでは、@code{@@majorheading}と@code{@@chapheading}コマンドは@code{@@chapter}と同じで、下にアスタリスクの行が付いた単独行にタイトルを出力します。 |
| 3807 | -(@xref{chapter, , @code{@@chapter}}.)@refill | |
| 3826 | +@xref{chapter, , @code{@@chapter}}.@refill | |
| 3808 | 3827 | |
| 3809 | 3828 | |
| 3810 | 3829 | @node section |
| 3811 | 3830 | @section @code{@@section} |
| 3812 | 3831 | @findex section |
| 3813 | 3832 | |
| 3814 | -@code{@@section}コマンドは、@code{@@chapter}コマンドや@code{@@unnumbered}コマンド、@code{@@appendix}コマンドで生成される章の中でセクションを識別できるようにし、章レベルのコマンドの番号付けの仕組みに従います。 | |
| 3815 | -ですので、`1'と番号が付けられた@code{@@chapter}の章の中では、セクションは`1.2'のように番号付けされます。 | |
| 3816 | -`A'とラベル付けされた@code{@@appendix}の「章」の中では、セクションは`A.2'のように番号付けされます。 | |
| 3833 | +@code{@@section}コマンドは、@code{@@chapter}コマンドや@code{@@unnumbered}コマンド、@code{@@appendix}コマンドで生成される章の中でセクションを識別できるようにします。 | |
| 3834 | +また、章レベルのコマンドの番号付けの仕組みに従います。 | |
| 3835 | +ですので、「1」と番号が付けられた@code{@@chapter}の章の中では、セクションは「1.2」のように番号付けされます。 | |
| 3836 | +「A」とラベル付けされた@code{@@appendix}の「章」の中では、セクションは「A.2」のように番号付けされます。 | |
| 3817 | 3837 | @code{@@unnumbered}の章の中では、セクションは番号付けされません。 |
| 3818 | 3838 | |
| 3819 | 3839 | 例えば、このセクションは@code{@@section}コマンドで見出しが付けられていますので、Texinfoファイルでは次のようになります。 |
| @@ -3843,16 +3863,16 @@ Infoでは、出力に@samp{=}による下線が引かれます。 | ||
| 3843 | 3863 | |
| 3844 | 3864 | |
| 3845 | 3865 | @node unnumberedsec appendixsec heading |
| 3846 | -@section @code{@@unnumberedsec}と@code{@@appendixsec}、@code{@@heading} | |
| 3866 | +@section @code{@@unnumberedsec}・@code{@@appendixsec}・@code{@@heading} | |
| 3847 | 3867 | @findex unnumberedsec |
| 3848 | 3868 | @findex appendixsec |
| 3849 | 3869 | @findex heading |
| 3850 | 3870 | |
| 3851 | -@code{@@unnumberedsec}コマンドや@code{@@appendixsec}コマンド、@code{@@heading}コマンドは、前のセクションで述べたように、それぞれ@code{@@section}コマンドの番号無しバージョン、appendixのようなバージョン、headingのようなバージョンです。 | |
| 3871 | +@code{@@unnumberedsec}コマンドや@code{@@appendixsec}コマンド、@code{@@heading}コマンドはそれぞれ、前節で述べた@code{@@section}コマンドの番号無しバージョン、appendixのようなバージョン、headingのようなバージョンです。 | |
| 3852 | 3872 | |
| 3853 | 3873 | @table @code |
| 3854 | 3874 | @item @@unnumberedsec |
| 3855 | -@code{@@unnumberedsec}コマンドは、番号無しの章の中や、通常の章、付録の中で、番号無しのセクションを提供するために使用できます。@refill | |
| 3875 | +@code{@@unnumberedsec}コマンドは、番号無しの章の中や、通常の章、appendixの中で、番号無しのセクションを提供するために使用できます。@refill | |
| 3856 | 3876 | |
| 3857 | 3877 | @item @@appendixsec |
| 3858 | 3878 | @itemx @@appendixsection |
| @@ -3860,14 +3880,14 @@ Infoでは、出力に@samp{=}による下線が引かれます。 | ||
| 3860 | 3880 | この二つのコマンドは同じです。@refill |
| 3861 | 3881 | @findex appendixsection |
| 3862 | 3882 | |
| 3863 | -慣習的に、@code{@@appendixsec}コマンドや@code{@@appendixsection}コマンドは、付録の中でのみ使用します。@refill | |
| 3883 | +慣習的に、@code{@@appendixsec}コマンドや@code{@@appendixsection}コマンドは、appendixの中でのみ使用します。@refill | |
| 3864 | 3884 | |
| 3865 | 3885 | @item @@heading |
| 3866 | -@code{@@heading}コマンドは、目次に現われないセクションスタイルの見出しを作るために使用するもので、好きな所で使用することが出来ます。@refill | |
| 3886 | +@code{@@heading}コマンドは、目次に現われない、セクションスタイルの見出しを作るために使用するもので、好きな所で使用することが出来ます。@refill | |
| 3867 | 3887 | @end table |
| 3868 | 3888 | |
| 3869 | 3889 | @code{@@unnumberedsec}コマンドと@code{@@appendixsec}コマンドは、@code{@@section}コマンドが@code{@@unnumbered}や@code{@@appendix}の章の中でも使用することが出来ますので、通常の状況では必要ありません。 |
| 3870 | -前のセクションをご覧ください。 | |
| 3890 | +前節をご覧ください。 | |
| 3871 | 3891 | |
| 3872 | 3892 | |
| 3873 | 3893 | @node subsection |
| @@ -3875,7 +3895,7 @@ Infoでは、出力に@samp{=}による下線が引かれます。 | ||
| 3875 | 3895 | @findex subsection |
| 3876 | 3896 | |
| 3877 | 3897 | サブセクションとセクションの関係は、セクションと章の関係のようなものです。 |
| 3878 | -(@xref{section, , @code{@@section}}.) | |
| 3898 | +@xref{section, , @code{@@section}}. | |
| 3879 | 3899 | Infoで、サブセクションのタイトルは、@samp{-}で下線が引かれます。 |
| 3880 | 3900 | 例えば以下のようにします。 |
| 3881 | 3901 |
| @@ -3903,8 +3923,8 @@ Infoで、サブセクションのタイトルは、@samp{-}で下線が引か | ||
| 3903 | 3923 | @findex appendixsubsec |
| 3904 | 3924 | @findex subheading |
| 3905 | 3925 | |
| 3906 | -@code{@@unnumberedsubsec}コマンド、@code{@@appendixsubsec}コマンド、@code{@@subheading}コマンドは、それぞれ、@code{@@subsection}コマンドの番号無しバージョン、付録のようなバージョン、見出しのようなバージョンです。 | |
| 3907 | -(@xref{subsection, , @code{@@subsection}}.) | |
| 3926 | +@code{@@unnumberedsubsec}コマンド、@code{@@appendixsubsec}コマンド、@code{@@subheading}コマンドは、それぞれ、@code{@@subsection}コマンドの番号無しバージョン、appendixのようなバージョン、headingのようなバージョンです。 | |
| 3927 | +@xref{subsection, , @code{@@subsection}}. | |
| 3908 | 3928 | |
| 3909 | 3929 | Infoでは、@code{@@subsection}のようなコマンドはハイフンで下線が引かれたタイトルを生成します。 |
| 3910 | 3930 | 印刷されたマニュアルでは、@code{@@subheading}コマンドは、番号が付けられず、目次に現われないことを除けば、サブセクションと同じような見出しを生成します。 |
| @@ -3915,30 +3935,30 @@ Infoでは、@code{@@subsection}のようなコマンドはハイフンで下線 | ||
| 3915 | 3935 | |
| 3916 | 3936 | |
| 3917 | 3937 | @node subsubsection |
| 3918 | -@section `subsub'コマンド | |
| 3938 | +@section 「subsub」コマンド | |
| 3919 | 3939 | @cindex Subsub commands |
| 3920 | 3940 | @findex subsubsection |
| 3921 | 3941 | @findex unnumberedsubsubsec |
| 3922 | 3942 | @findex appendixsubsubsec |
| 3923 | 3943 | @findex subsubheading |
| 3924 | 3944 | |
| 3925 | -Texinfoにおける四番目で最も下のレベルのセクションコマンドが、`subsub'コマンドです。 | |
| 3945 | +Texinfoにおける四番目で最も下のレベルのセクションコマンドが、「subsub」コマンドです。 | |
| 3926 | 3946 | 以下のものがあります。@refill |
| 3927 | 3947 | |
| 3928 | 3948 | @table @code |
| 3929 | 3949 | @item @@subsubsection |
| 3930 | 3950 | サブサブセクションとサブセクションの関係は、サブセクションとセクションの関係のようなものです。 |
| 3931 | -(@xref{subsection, , @code{@@subsection}}.) | |
| 3951 | +@xref{subsection, , @code{@@subsection}}. | |
| 3932 | 3952 | 印刷されたマニュアルで、サブサブセクションのタイトルは目次に現われ、四番目の深さのレベルで番号を付けられます。@refill |
| 3933 | 3953 | |
| 3934 | 3954 | @item @@unnumberedsubsubsec |
| 3935 | -番号付けされていないサブサブセクションのタイトルは、番号はありませんが、印刷されたマニュアルの目次に現われます。 | |
| 3936 | -それ以外では、番号付けされていないサブサブセクションはサブサブセクションと同じです。 | |
| 3937 | -実際にInfoでは、番号付けされていないサブサブセクションは、普通のサブサブセクションのように見えます。@refill | |
| 3955 | +番号付けされないサブサブセクションのタイトルは、番号はありませんが、印刷されたマニュアルの目次に現われます。 | |
| 3956 | +それ以外では、番号付けされないサブサブセクションはサブサブセクションと同じです。 | |
| 3957 | +実際にInfoでは、番号付けされないサブサブセクションは、普通のサブサブセクションのように見えます。@refill | |
| 3938 | 3958 | |
| 3939 | 3959 | @item @@appendixsubsubsec |
| 3940 | -慣習的に、appendixのコマンド類は付録のためのみに使用され、印刷されたマニュアルでは文字と番号が適切に付けられます。 | |
| 3941 | -それらは目次にも現われます。実際にInfoでは、付録のサブサブセクションは普通のサブサブセクションのように見えます。@refill | |
| 3960 | +慣習的に、appendixのコマンド類はappendixのためのみに使用され、印刷されたマニュアルでは文字と番号が適切に付けられます。 | |
| 3961 | +それらは目次にも現われます。実際にInfoでは、appendixのサブサブセクションは普通のサブサブセクションのように見えます。@refill | |
| 3942 | 3962 | |
| 3943 | 3963 | @item @@subsubheading |
| 3944 | 3964 | @code{@@subsubheading}コマンドは、目次に現われない小さい見出しが必要なあらゆる場所で使用できます。 |
| @@ -3946,10 +3966,10 @@ Texinfoにおける四番目で最も下のレベルのセクションコマン | ||
| 3946 | 3966 | @end table |
| 3947 | 3967 | |
| 3948 | 3968 | @code{@@unnumberedsubsubsec}コマンドと@code{@@appendixsubsubsec}コマンドは、@code{@@subsubsection}が@code{@@unnumbered}の章や@code{@@appendix}の章のサブセクションの中で使用できますので、通常の状況では使う必要はありません。 |
| 3949 | -(@pxref{section,,@code{section}}). | |
| 3969 | +@xref{section,,@code{section}}. | |
| 3950 | 3970 | |
| 3951 | 3971 | |
| 3952 | -Infoでは、`subsub'タイトルはピリオドで下線が引かれます。 | |
| 3972 | +Infoでは、「subsub」タイトルはピリオドで下線が引かれます。 | |
| 3953 | 3973 | 例えば以下のようにします。@refill |
| 3954 | 3974 | |
| 3955 | 3975 | @example |
| @@ -3998,7 +4018,7 @@ Infoでは、`subsub'タイトルはピリオドで下線が引かれます。 | ||
| 3998 | 4018 | ノードポインタを暗黙に決定するという@command{makeinfo}の(推奨されている)機能を使ったドキュメントでは、もう一つの難題が発生することがあります。 |
| 3999 | 4019 | @command{makeinfo}はポインタを決定するために、階層的に構成されたドキュメントであることを想定しなければなりませんので、ドキュメント中に@code{@@raisesections}や@code{@@lowersections}を好きなように混ぜ込むことが出来ないのです。 |
| 4000 | 4020 | 最終的に得られる結果では、階層の上げ下げに配慮したメニューとならなければなりません。 |
| 4001 | -従って、実際問題として、一般にユーザは、前述の外部ファイルのような、大きなかたまりを上げ下げしたいだけです。 | |
| 4021 | +したがって、実際問題として、一般にユーザは、前述の外部ファイルのような、大きなかたまりを上げ下げしたいだけです。 | |
| 4002 | 4022 | |
| 4003 | 4023 | この階層を上げ下げするコマンドを繰り返し使用すると、一回に一段階ずつ階層の上げ下げを続けます。 |
| 4004 | 4024 | 「章」の上に階層を引き上げるとchapterコマンドが再生されます。 |
| @@ -4011,8 +4031,8 @@ Infoでは、`subsub'タイトルはピリオドで下線が引かれます。 | ||
| 4011 | 4031 | @node Nodes |
| 4012 | 4032 | @chapter ノード |
| 4013 | 4033 | |
| 4014 | -@dfn{ノード}はTexinfoファイルの第一の区分です。 | |
| 4015 | -ノードそれ自体としては、ファイル上の階層的な構造だったり、その他の構造だったりを強制するものではありません。 | |
| 4034 | +@dfn{ノード}はTexinfoファイルの一番重要な区分です。 | |
| 4035 | +ノードそれ自体は、ファイル上の階層的な構造だったり、その他の構造だったりを強制するものではありません。 | |
| 4016 | 4036 | ノードには他のノードを指す@dfn{ノードポインタ}を持ち、ノードの一覧である@dfn{メニュー}を入れることが出来ます。 |
| 4017 | 4037 | Infoでは、移動コマンドを使うと、ポインタで指定されているノードや、メニューにリストされているノードへ移動することが出来ます。 |
| 4018 | 4038 |
| @@ -4034,12 +4054,13 @@ Infoでは、移動コマンドを使うと、ポインタで指定されてい | ||
| 4034 | 4054 | @node Two Paths |
| 4035 | 4055 | @section 二つの経路 |
| 4036 | 4056 | |
| 4037 | -ノードとメニューコマンドと章の構造化コマンドは、厳密にには互いに独立しています。 | |
| 4057 | +ノードとメニューコマンドと章の構造化コマンドは、厳密には互いに独立しています。 | |
| 4038 | 4058 | |
| 4039 | 4059 | @itemize @bullet |
| 4040 | 4060 | @item |
| 4041 | 4061 | Infoでは、ノードとメニューコマンドが構造を提供しています。 |
| 4042 | -章の構造化コマンドは、様々な下線が引かれた見出しを生成します --- 下線は章ではアスタリスク、セクションではハイフンのようになっています。 | |
| 4062 | +章の構造化コマンドは、様々な下線が引かれた見出しを生成します。 | |
| 4063 | +下線は章ではアスタリスク、セクションではハイフンなどのようになっています。 | |
| 4043 | 4064 | 章の構造化コマンドは他には何もしません。@refill |
| 4044 | 4065 | |
| 4045 | 4066 | @item |
| @@ -4060,12 +4081,11 @@ Info出力が印刷出力とは異なる構造を持つようにTexinfoファイ | ||
| 4060 | 4081 | @node Node Menu Illustration |
| 4061 | 4082 | @section ノードとメニューの図 |
| 4062 | 4083 | |
| 4063 | -前で示した、章が三つでそれぞれが二つのセクションを含むTexinfoファイル図の、コピーは以下のようになります。@refill | |
| 4084 | +以下は、前に示した、章が三つでそれぞれが二つのセクションを含むTexinfoファイル図のコピーです。@refill | |
| 4064 | 4085 | |
| 4065 | -``root''は図の最上部で、``leaves''が最下部です。 | |
| 4066 | -これはそのような図を書く慣習的な方法です。 | |
| 4067 | -それは、さかさまの木を描きます。 | |
| 4068 | -このため、ルートノードは`Top'ノードと呼ばれ、`Up'ノードはルートに近い方向へ導きます。@refill | |
| 4086 | +「root」は図の最上部で、「leaves」が最下部です。 | |
| 4087 | +これはそのような図を書く慣習的な方法で、さかさまになった木を描きます。 | |
| 4088 | +このため、ルートノードはTopノードと呼ばれ、Upノードはルートに近い方向へ導かれることになります。@refill | |
| 4069 | 4089 | |
| 4070 | 4090 | @example |
| 4071 | 4091 | @group |
| @@ -4082,7 +4102,7 @@ Section Section Section Section Section Section | ||
| 4082 | 4102 | @end group |
| 4083 | 4103 | @end example |
| 4084 | 4104 | |
| 4085 | -Chapter 2を開始するため、完全に記述されたコマンドは以下のようになります。 | |
| 4105 | +Chapter 2を開始する場合の完全に記述されたコマンドは以下のようになります。 | |
| 4086 | 4106 | |
| 4087 | 4107 | @example |
| 4088 | 4108 | @group |
| @@ -4092,20 +4112,23 @@ Chapter 2を開始するため、完全に記述されたコマンドは以下 | ||
| 4092 | 4112 | @end example |
| 4093 | 4113 | |
| 4094 | 4114 | @noindent |
| 4095 | -この@code{@@node}行は、このノード名が``Chapter 2''で、`Next'ノードが``Chapter 3''で、`Previous'ノードが``Chapter 1''で、`Up'ノードが``Top''だということを告げています。 | |
| 4096 | -ドキュメントが階層的に組織化されている場合(@pxref{makeinfo Pointer Creation})、これらのノード名を書くことを省略可能ですが、ポインタの関係は得られます。 | |
| 4115 | +この@code{@@node}行が示しているのは、このノードの名前名が「Chapter 2」、Nextノードが「Chapter 3」、Previousノードが「Chapter 1」、Upノードが「Top」だということです。 | |
| 4116 | +ドキュメントが階層的に組織化されている場合(@pxref{makeinfo Pointer Creation})、これらのノード名は省略可能ですが、その場合もポインタの関係は得られます。 | |
| 4097 | 4117 | |
| 4098 | 4118 | @quotation Note |
| 4099 | -@strong{注意してください:}`Next'は、マニュアルで同じ階層レベルの次のノードを参照し、それは、Texinfoファイル内での次のノードである必要はありません。 | |
| 4100 | -Texinfoファイルでは、次のノードは下のレベルかもしません --- 例えば、セクションレベルノードが章レベルのノードに続くことが多くあります。 | |
| 4101 | -`Next'と`Previous'は、@emph{同じ}階層レベルのノードを参照します。 | |
| 4102 | -(`Top'ノードはこの規則の例外です。 | |
| 4103 | -`Top'ノードはそのレベルでの唯一のノードなので、`Next'は続く最初のノードを参照し、通常それは、章や章レベルのノードです。)@refill | |
| 4119 | +@strong{注意してください:}Nextは、マニュアルで同じ階層レベルの次のノードを参照します。 | |
| 4120 | +Texinfoファイル内での次のノードである必要はありません。 | |
| 4121 | +Texinfoファイルでは、次のノードは下位のレベルのことがあります。 | |
| 4122 | +例えば、セクションレベルノードが章レベルのノードに続くことがよくあります。 | |
| 4123 | +NextとPreviousは、@emph{同じ}階層レベルのノードを参照します。 | |
| 4124 | +(Topノードはこの規則には当て嵌りません。 | |
| 4125 | +Topノードはそのレベルでの唯一のノードなので、Nextは続く最初のノードを参照します。 | |
| 4126 | +通常それは、章や章レベルのノードです。)@refill | |
| 4104 | 4127 | @end quotation |
| 4105 | 4128 | |
| 4106 | -Infoを使用して、セクション2.1と2.2に行くため、2章の内部にメニューが必要です。 | |
| 4107 | -(@xref{Menus}.) | |
| 4108 | -以下のように、セクション2.1をはじめる前に、メニューを書きます。@refill | |
| 4129 | +Infoを使用して、セクション2.1やセクション2.2に行くには、2章の内部にメニューが必要です。 | |
| 4130 | +@xref{Menus}. | |
| 4131 | +以下のように、セクション2.1を開始する前にメニューを書きます。@refill | |
| 4109 | 4132 | |
| 4110 | 4133 | @example |
| 4111 | 4134 | @group |
| @@ -4125,16 +4148,16 @@ Infoを使用して、セクション2.1と2.2に行くため、2章の内部に | ||
| 4125 | 4148 | @end group |
| 4126 | 4149 | @end example |
| 4127 | 4150 | |
| 4128 | -Info形式では、ノードの`Next'と`Previous'ポインタは通常、同じレベルの他のノードへ導きます --- 章から章や、セクションからセクションのようになります(ここまで見てきたように、`Previous'ポインタが上を指すこともあります)。 | |
| 4129 | -`Up'ポインタは通常、上のレベルのノードへ導きます(`Top'ノードに近い方向です)。 | |
| 4130 | -`Menu'は下のレベルのノードへ導きます(`leaves'に近い方向です)。 | |
| 4131 | -(クロスリファレンスは、あらゆるレベルのノードを指し示します。 | |
| 4132 | -@ref{Cross References}を参照してください。)@refill | |
| 4151 | +Info形式では、ノードのNextポインタとPreviousポインタは、通常、同じレベルの他のノードへ誘導します。 | |
| 4152 | +つまり、章から章や、セクションからセクションのようになります(ここまで見てきたように、Previousポインタが上位を指すこともあります)。 | |
| 4153 | +Upポインタは、通常、上位レベルのノードへ誘導します(Topノードに近い方向です)。 | |
| 4154 | +Menuは下のレベルのノードへ導きます(「leaves」に近い方向です)。 | |
| 4155 | +クロスリファレンスはあらゆるレベルのノードを指し示します(@pxref{Cross References})。@refill | |
| 4133 | 4156 | |
| 4134 | 4157 | 通常、@code{@@node}コマンドと章の構造化コマンドは、索引コマンドと一緒に順番に使用されます。 |
| 4135 | 4158 | (@code{@@node}行に、指し示すものを覚えておくためのコメント行を続けてもかまいません。)@refill |
| 4136 | 4159 | |
| 4137 | -このマニュアルの``Ending a Texinfo File''という章の最初は以下のようになっています。 | |
| 4160 | +このマニュアルの「Ending a Texinfo File」という章の最初は以下のようになっています。 | |
| 4138 | 4161 | これには、@code{@@node}行、それに続くコメント行、@code{@@chapter}行、そして索引行があります。@refill |
| 4139 | 4162 | |
| 4140 | 4163 | @example |
| @@ -4158,34 +4181,34 @@ Info形式では、ノードの`Next'と`Previous'ポインタは通常、同じ | ||
| 4158 | 4181 | @dfn{ノード(node)}とは、@code{@@node}コマンドで始まり、次の@code{@@node}コマンドまで続くテキストの塊です。 |
| 4159 | 4182 | ノードの定義は章やセクションとは異なります。 |
| 4160 | 4183 | 章にセクションを含めてもかまいませんし、セクションにサブセクションを含めてもかまいません。 |
| 4161 | -しかし、ノードにサブノードを含めることは不可能です。 | |
| 4162 | -ノードのテキストは、ファイルの次の@code{@@node}コマンドまで続くだけです。 | |
| 4184 | +しかし、ノードにサブノードを含めることは出来ません。 | |
| 4185 | +ノードのテキストは、そのファイルの次の@code{@@node}コマンドまで続くだけです。 | |
| 4163 | 4186 | ノードは通常、章の構造化コマンドを一つだけ含み、そのコマンドは@code{@@node}行に続けて書きます。 |
| 4164 | 4187 | 一方、印刷出力ではノードはクロスリファレンスとしてのみ使用されるので、章やセクションに複数のノードを含めてもかまいません。 |
| 4165 | 4188 | 実際、章は通常、それぞれのセクション、サブセクション、そしてサブサブセクションとなる複数のノードを含んでいます。 |
| 4166 | 4189 | |
| 4167 | 4190 | ノードを記述するには、行頭に@code{@@node}コマンドを書き、続けて同じ行に、カンマで区切られた最大で四つの引数を書きます。 |
| 4168 | -最初の引数は必須で、そのノードの名前です(ノード名の詳細は@pxref{Node Line Requirements}))。 | |
| 4169 | -続く引数は順番に、`Next'、`Previous'、`Up'ポインタの名前です。 | |
| 4191 | +最初の引数は必須で、そのノードの名前となります(ノード名の詳細は別の節を参照してください(@pxref{Node Line Requirements}))。 | |
| 4192 | +続く引数は順番に、Nextポインタ、Previousポインタ、Upポインタの名前です。 | |
| 4170 | 4193 | そのTexinfoドキュメントが階層構造になっていれば省略してもかまいません(@pxref{makeinfo Pointer Creation})。 |
| 4171 | 4194 | |
| 4172 | 4195 | @opindex accesskey@r{, in HTML output} |
| 4173 | -ノードポインタの指定が暗黙的か明示的かに関わらず、@command{makeinf}のHTML出力では、各ノードについて、`Next'ノード、`Previous'ノード、`Up'ノードへのリンクが入っています。 | |
| 4196 | +ノードポインタの指定が暗黙的か明示的かに関わらず、@command{makeinf}のHTML出力では、各ノードについて、Nextノード、Previousノード、Upノードへのリンクが入っています。 | |
| 4174 | 4197 | また、HTMLでは、それぞれ@samp{n}、@samp{p}、@samp{u}という値を持つ@code{accesskey}属性を使っています。 |
| 4175 | -こうすることで、ウェブブラウザを使う場合に(通常)@kbd{M-@var{letter}}キーを使用したナビゲーション、例えば、`Next'ノードについては@kbd{M-n}などを利用して、そのノードのどこにいても移動できるようになります。 | |
| 4198 | +こうすることで、ウェブブラウザを使う場合に(通常)@kbd{M-@var{letter}}キーを使用したナビゲーション、例えば、Nextノードについては@kbd{M-n}などを利用して、そのノードのどこにいても移動できるようになります。 | |
| 4176 | 4199 | |
| 4177 | 4200 | @code{@@node}行の名前の前に複数の空白を入れたい場合は、入れてもかまいません。 |
| 4178 | -空白は無視されます。ノード名と、(あれば)`Next'ポインタの名前、`Previous'ポインタの名前、`Up'ポインタの名前は全て同じ行に書かなければなりません。 | |
| 4201 | +空白は無視されます。ノード名と、(あれば)Nextポインタの名前、Previousポインタの名前、Upポインタの名前は全て同じ行に書かなければなりません。 | |
| 4179 | 4202 | そうしなかった場合はフォーマッタが失敗することになります。 |
| 4180 | 4203 | (Infoにおけるノードについては@inforef{Top, info, info}を参照してください。) |
| 4181 | 4204 | |
| 4182 | -通常は章の構造化コマンド行の一つ、例えば@code{@@section}コマンドや@code{@@subsection}コマンドの行は@code{@@node}の直後に書きます。 | |
| 4183 | -(@xref{Structuring Command Types}.) | |
| 4205 | +通常は章の構造化コマンド行を一つ@code{@@node}の直後に記述します。 | |
| 4206 | +例えば@code{@@section}コマンドや@code{@@subsection}コマンドの行を書くことになります。 | |
| 4207 | +@xref{Structuring Command Types}. | |
| 4184 | 4208 | |
| 4185 | 4209 | @TeX{}は@code{@@node}行を、クロスリファレンスで使用する名前を識別するのに使用します。 |
| 4186 | 4210 | このため、Info形式で書式化するつもりが無い場合でも、印刷用に書式化するつもりのTexinfoファイルの中に@code{@@node}コマンドの行を書かなければなりません。 |
| 4187 | -(このセンテンスの最後にあるようなクロスリファレンスは@code{@@xref}コマンドや関係するコマンドで作成されます。 | |
| 4188 | -@ref{Cross References}を参照してください。) | |
| 4211 | +このセンテンスの最後にあるようなクロスリファレンスは@code{@@xref}コマンドや関係するコマンドで作成されます(@pxref{Cross References})。 | |
| 4189 | 4212 | |
| 4190 | 4213 | @menu |
| 4191 | 4214 | * Node Names:: How to choose node and pointer names. |
| @@ -4198,24 +4221,24 @@ Info形式では、ノードの`Next'と`Previous'ポインタは通常、同じ | ||
| 4198 | 4221 | |
| 4199 | 4222 | |
| 4200 | 4223 | @node Node Names |
| 4201 | -@subsection ノードとポインタの名前の選択 | |
| 4224 | +@subsection ノードの名前とポインタの名前の選択 | |
| 4202 | 4225 | |
| 4203 | 4226 | @cindex Node names, choosing |
| 4204 | -ノードの名前はそのノードを区別するものです(ノード名については@pxref{Node Line Requirements})。 | |
| 4227 | +ノードの名前はそのノードを区別するものです(ノード名については別の節を参照してください(@pxref{Node Line Requirements}))。 | |
| 4205 | 4228 | ポインタはユーザが他のノードへ到達できるようにするもので、単にそういったノードの名前から構成されます。 |
| 4206 | 4229 | |
| 4207 | -通常、あるノードの`Up'ポインタには、そのノードの名前が記載されているメニューを持つノードの名前が入っています。 | |
| 4208 | -そのノードの`Next'ポインタには、そのメニュー内の当該ノードに続くノードの名前が入っています。 | |
| 4209 | -そして、`Previous'ポインタには、メニューの当該ノードの前にあるノード名が入ってい | |
| 4210 | -ます。 | |
| 4211 | -あるノードの`Previous'ノードが`Up'ノードと同じであれば、ノードポインタは両方とも同じノードを指します。 | |
| 4230 | +通常、あるノードのUpポインタには、そのノードの名前が記載されているメニューを持つノードの名前が入っています。 | |
| 4231 | +そのノードのNextポインタには、そのメニュー内の当該ノードに続くノードの名前が入っています。 | |
| 4232 | +そして、Previousポインタには、メニューの当該ノードの前にあるノード名が入っています。 | |
| 4233 | +あるノードのPreviousノードがUpノードと同じであれば、ノードポインタは両方とも同じノードを指します。 | |
| 4212 | 4234 | |
| 4213 | -通常、Texinfoファイルの最初のノードは`Top'ノードで、`Top'ノードの`Up'ポインタと`Previous'ポインタは@file{dir}ファイルを指し示しています。 | |
| 4235 | +通常、Texinfoファイルの最初のノードはTopノードです。 | |
| 4236 | +TopノードのUpポインタとPreviousポインタは@file{dir}ファイルを指し示しています。 | |
| 4214 | 4237 | @file{dir}ファイルにはInfo全てに対するメインメニューが入っています。 |
| 4215 | 4238 | |
| 4216 | -`Top'ノード自体には、そのマニュアルに対するメインメニューあるいはマスターメニューが入っています。 | |
| 4217 | -また、`Top'ノードには、そのマニュアルの簡単な説明があると役立ちます。 | |
| 4218 | -Texinfoファイルの最初のノードを書く方法については@xref{First Node}. | |
| 4239 | +Topノード自体には、そのマニュアルに対するメインメニューあるいはマスターメニューが入っています。 | |
| 4240 | +また、Topノードには、そのマニュアルの簡単な説明があると便利です。 | |
| 4241 | +Texinfoファイルの最初のノードを書く方法については別の節を参照してください(@pxref{First Node})。 | |
| 4219 | 4242 | |
| 4220 | 4243 | ポインタを全て明示的に書いた場合でも、Texinfoのソースファイル中にあるノードを好きな順番に書けるわけではありません。 |
| 4221 | 4244 | @TeX{}はノードポインタとは無関係にファイルをシーケンシャルに処理しますので、出力に現われて欲しい順番でノードを記述する必要があります。 |
| @@ -4236,26 +4259,27 @@ Texinfoファイルの最初のノードを書く方法については@xref{Firs | ||
| 4236 | 4259 | |
| 4237 | 4260 | GNU Emacsを使用している場合は、Texinfoモードに用意されているノードを更新するコマンドを使用すれば、ポインタの名前を挿入することが出来ます。 |
| 4238 | 4261 | あるいは、Texinfoファイルにポインタを記述せず、@code{makeinfo}によって、生成するInfoファイル中にノードポインタを挿入させることも出来ます。 |
| 4239 | -(@xref{Texinfo Mode}, and @ref{makeinfo Pointer Creation}.) | |
| 4262 | +@xref{Texinfo Mode}, and @ref{makeinfo Pointer Creation}. | |
| 4240 | 4263 | |
| 4241 | -あるいはまた、`Next'ポインタ、`Previous'ポインタ、`Up'ポインタをユーザ自身が挿入することも出来ます。 | |
| 4264 | +あるいはまた、Nextポインタ、Previousポインタ、Upポインタをユーザ自身が挿入することも出来ます。 | |
| 4242 | 4265 | この場合は、Texinfoモードのキーボードコマンド@kbd{C-c C-c n}が役に立つでしょう。 |
| 4243 | 4266 | このコマンドは@samp{@@node}を挿入し、また、ポインタの名前をその適切な順番でリストにしたコメント行を挿入します。 |
| 4244 | 4267 | このコメント行があると、どの引数がどのポインタのためのものなのかを追跡しやすくなります。 |
| 4245 | 4268 | このコメント行は特に、ユーザがTexinfoに慣れていない場合に役に立ちます。 |
| 4246 | 4269 | |
| 4247 | -`Next'ポインタ、`Previous'ポインタ、`Up'ポインタを付けて完全に書き出されたnode行のテンプレートは次のようなものになります。 | |
| 4270 | +Nextポインタ、Previousポインタ、Upポインタを付けて完全に書き出されたnode行のテンプレートは次のようなものになります。 | |
| 4248 | 4271 | |
| 4249 | 4272 | @example |
| 4250 | 4273 | @@node @var{node-name}, @var{next}, @var{previous}, @var{up} |
| 4251 | 4274 | @end example |
| 4252 | 4275 | |
| 4253 | -引数@var{node-name}は存在しなければなりませんが、それ以外は省略可能です。 | |
| 4276 | +引数@var{node-name}は必須ですが、それ以外は省略可能です。 | |
| 4254 | 4277 | 省略可能な引数全部ではなく、一部だけを指定したい場合には、例えば@samp{@@node mynode,,,uppernode}のように、必要に応じてカンマだけを挿入してください。 |
| 4255 | 4278 | しかし、前述のように、ポインタを全て省略して@code{makeinfo}にポインタを決定させるようにすることをお勧めします。 |
| 4256 | 4279 | |
| 4257 | 4280 | 望むなら、最初の草稿では@code{@@node}行を全く無視してしまって、後で@code{texinfo-insert-node-lines}コマンドを使って、@code{@@node}行を作成することも可能です。 |
| 4258 | -しかし、この方法はお勧めしません。一区切りの文章を書いたならば、同時にそのノード自体に名前を付けるのがより良い方法です。 | |
| 4281 | +しかし、この方法はお勧めしません。 | |
| 4282 | +文章をひとしきり書いたならば、すぐそのノード自体に名前を付けるのがより良い方法です。 | |
| 4259 | 4283 | そうすれば、クロスリファレンスを作成するのも簡単になります。 |
| 4260 | 4284 | クロスリファレンスが十分あるということは、良いInfoファイルの特に大切な特徴です。 |
| 4261 | 4285 |
| @@ -4267,7 +4291,7 @@ GNU Emacsを使用している場合は、Texinfoモードに用意されてい | ||
| 4267 | 4291 | |
| 4268 | 4292 | |
| 4269 | 4293 | @node Node Line Tips |
| 4270 | -@subsection @code{@@node}行の助言 | |
| 4294 | +@subsection @code{@@node}行のTips | |
| 4271 | 4295 | |
| 4272 | 4296 | ここに三つの提案があります。 |
| 4273 | 4297 |
| @@ -4283,7 +4307,8 @@ Infoファイルでは、ファイル名、ノード名、そしてポインタ | ||
| 4283 | 4307 | これで、Infoの自動的な名前補完が使用しやすくなります。@refill |
| 4284 | 4308 | |
| 4285 | 4309 | @item |
| 4286 | -慣例により、ノード名は、ちょうどセクションや章のタイトルで使われるかのように語頭が大文字で書かれます---最初の単語と重要な単語の語頭は大文字で書かれ、それ以外は大文字で書かれません。@refill | |
| 4310 | +慣例により、ノード名は、ちょうどセクションや章のタイトルで使われるかのように語頭を大文字で書きます。 | |
| 4311 | +最初の単語と重要な単語の語頭は大文字を使い、それ以外は大文字を使いません。@refill | |
| 4287 | 4312 | @end itemize |
| 4288 | 4313 | |
| 4289 | 4314 |
| @@ -4301,10 +4326,10 @@ Infoファイルでは、ファイル名、ノード名、そしてポインタ | ||
| 4301 | 4326 | 単一のInfoファイルにおけるノード名は、他に同じ名前のノードがあってはいけません。 |
| 4302 | 4327 | |
| 4303 | 4328 | 同じ名前のノードがあるとInfoの移動コマンドが混乱します。 |
| 4304 | -すなわち、例えば、各章の最後に必ず概要(summary)を書く場合と、各章の概要のノードは全て違う名前を付けなければならないという意味です。 | |
| 4305 | -全部のノードを単に「Summary」と呼ぶわけにはいきません。 | |
| 4306 | -しかしながら、章やセクションなどのタイトルは重複することが出来ます。 | |
| 4307 | -ですので、ノード名が全て異なってさえいれば、本の各章の最後に「Summary」と言うセクションであってもかまいません。 | |
| 4329 | +すなわち、例えば、各章の最後に必ず概要(summary)を書く場合、各章の概要のノードは全て違う名前を付けなければならないという意味です。 | |
| 4330 | +全部のノードを単に「Summary」と名付けることは出来ません。 | |
| 4331 | +但し、章やセクションなどのタイトルは重複することが出来ます。 | |
| 4332 | +ノード名が全て異なってさえいれば、「Summary」と言う名前のセクションが各章の最後にあってもかまいません。 | |
| 4308 | 4333 | |
| 4309 | 4334 | @item |
| 4310 | 4335 | ポインタ名はノード名でなければなりません。 |
| @@ -4316,8 +4341,7 @@ Infoファイルでは、ファイル名、ノード名、そしてポインタ | ||
| 4316 | 4341 | @item |
| 4317 | 4342 | ノード名の中で@@-コマンドを使うことは出来ません。 |
| 4318 | 4343 | これには、@code{@@}や@code{@{}のような@samp{@@}でエスケープされる文字や、@samp{@@'}のようなアクセントコマンドのような文字も含まれます。 |
| 4319 | -(これが有用となる少数のケースについて、Texinfoは、ノード名での@w{@@-コマンド}の使用を限定的にサポートしています。 | |
| 4320 | -@ref{Pointer Validation}を参照してください。) | |
| 4344 | +これが有用となる少数のケースについて、Texinfoは、ノード名での@w{@@-コマンド}の使用を限定的にサポートしています(@pxref{Pointer Validation})。 | |
| 4321 | 4345 | 恐らく、この制約はいつか取り除かれることになるでしょう。 |
| 4322 | 4346 | |
| 4323 | 4347 | @item |
| @@ -4333,7 +4357,7 @@ Infoファイルでは、ファイル名、ノード名、そしてポインタ | ||
| 4333 | 4357 | 恐らく、この制約も将来取り除かれることになるでしょう。 |
| 4334 | 4358 | |
| 4335 | 4359 | @need 700 |
| 4336 | -例えば、以下はこのマニュアルにあるセクションのタイトルです。 | |
| 4360 | +以下はこのマニュアルにあるセクションのタイトルです。 | |
| 4337 | 4361 | |
| 4338 | 4362 | @smallexample |
| 4339 | 4363 | @@code@{@@@@unnumberedsec@}, @@code@{@@@@appendixsec@}, @@code@{@@@@heading@} |
| @@ -4372,9 +4396,9 @@ unnumberedsec appendixsec heading | ||
| 4372 | 4396 | @cindex Top node is first |
| 4373 | 4397 | @cindex First node |
| 4374 | 4398 | |
| 4375 | -インクルードファイル中の場合は別とすると(@pxref{Include Files})、Texinfoファイルの最初のノードは@dfn{トップ(Top)}ノードです。 | |
| 4376 | -トップノードには、ドキュメントの簡単な要約、複製の許諾条件、マスターメニューが入っているはずです。 | |
| 4377 | -Topノードの内容と例の詳細は、@xref{The Top Node}. | |
| 4399 | +インクルードファイル中の場合は別とすると(@pxref{Include Files})、Texinfoファイルの最初のノードは@dfn{Top}ノードです。 | |
| 4400 | +Topノードには、ドキュメントの簡単な要約、複製の許諾条件、マスターメニューが入っているはずです。 | |
| 4401 | +Topノードの内容と例の詳細は別の節を参照してください(@pxref{The Top Node})。 | |
| 4378 | 4402 | |
| 4379 | 4403 | 以下では、Topノードで使用されるノードポインタを説明します。 |
| 4380 | 4404 |
| @@ -4383,7 +4407,7 @@ Topノードの内容と例の詳細は、@xref{The Top Node}. | ||
| 4383 | 4407 | @item |
| 4384 | 4408 | @cindex Up node of Top node |
| 4385 | 4409 | @cindex (dir) as Up node of Top node |
| 4386 | -Topノード(@samp{top}もしくは@samp{Top}という名前でなければなりません)は、`Up'ノードとして別ファイルのノード名を保持しています。 | |
| 4410 | +Topノード(@samp{top}もしくは@samp{Top}という名前でなければなりません)は、Upノードとして別ファイルのノード名を保持しています。 | |
| 4387 | 4411 | その別ファイルのノードには、このファイルへ誘導するためのメニューがあります。 |
| 4388 | 4412 | ファイル名を括弧で括って指定してください。 |
| 4389 | 4413 |
| @@ -4394,15 +4418,15 @@ Topノード(@samp{top}もしくは@samp{Top}という名前でなければな | ||
| 4394 | 4418 | |
| 4395 | 4419 | @item |
| 4396 | 4420 | @cindex Prev node of Top node |
| 4397 | -Topノードの`Prev'ノードも@samp{(dir)}ファイルにします。 | |
| 4421 | +TopノードのPrevノードも@samp{(dir)}ファイルにします。 | |
| 4398 | 4422 | |
| 4399 | 4423 | @item |
| 4400 | 4424 | @cindex Next node of Top node |
| 4401 | -Topノードの`Next'ノードはドキュメントの最初の章にします。 | |
| 4425 | +TopノードのNextノードはドキュメントの最初の章にします。 | |
| 4402 | 4426 | |
| 4403 | 4427 | @end itemize |
| 4404 | 4428 | |
| 4405 | -@file{info}ディレクトリへのInfoファイルのインストールについては、@xref{Installing an Info File}. | |
| 4429 | +@file{info}ディレクトリへのInfoファイルのインストールについては別の節を参照してください(@pxref{Installing an Info File})。 | |
| 4406 | 4430 | |
| 4407 | 4431 | ポインタを完全に省略して、黙ってツールにポインタを定義させてしまうのが通常はベストです。 |
| 4408 | 4432 | ポインタを省略して得られた結果はシンプルな次のようなものとなります。 |
| @@ -4416,14 +4440,14 @@ Topノードの`Next'ノードはドキュメントの最初の章にします | ||
| 4416 | 4440 | @subsection 区切りコマンドの@code{@@top} |
| 4417 | 4441 | @findex top @r{(@@-command)} |
| 4418 | 4442 | |
| 4419 | -特別な区切りコマンドである@code{@@top}は、@code{@@node Top}行と一緒に使います。 | |
| 4420 | -区切りコマンド@code{@@top}は、ファイル中の`Top'ノードに印を付けていることを@code{makeinfo}に通知します。 | |
| 4443 | +特別な区切りコマンドである@code{@@top}コマンドは、@code{@@node Top}行と一緒に使います。 | |
| 4444 | +区切りコマンド@code{@@top}は、そのノードがファイル中のTopノードであることを@code{makeinfo}に通知します。 | |
| 4421 | 4445 | これは、@code{makeinfo}がノードポインタを自動的に挿入するのに必要な情報を提供するものです。 |
| 4422 | 4446 | @code{@@top}コマンドは@code{@@node Top}行の直後の行の行頭に書いてください。 |
| 4423 | 4447 | @code{@@top}コマンドの同じ行の残りの部分にはタイトルを書いてください |
| 4424 | 4448 | 。 |
| 4425 | 4449 | |
| 4426 | -Infoでは、区切りコマンド@code{@@top}は、タイトルが単独行に現れるようにし、他の区切りコマンドと同様、アスタリスクの線を下に挿入します。 | |
| 4450 | +Infoでは、区切りコマンドの@code{@@top}コマンドによって、そのタイトルが単独行で表示され、他の区切りコマンドと同様、アスタリスクの線が下に挿入されます。 | |
| 4427 | 4451 | |
| 4428 | 4452 | @TeX{}と@code{texinfo-format-buffer}では、区切りコマンド@code{@@top}は、@code{@@unnumbered}の単なる別名に過ぎません。 |
| 4429 | 4453 | こういったフォーマッタのいずれも@code{@@top}コマンドを必要としていませんし、このコマンドに対して何ら特別なことは行ないません。 |
| @@ -4445,20 +4469,20 @@ Infoでは、区切りコマンド@code{@@top}は、タイトルが単独行に | ||
| 4445 | 4469 | @cindex Pointer creation with @code{makeinfo} |
| 4446 | 4470 | @cindex Automatic pointer creation with @code{makeinfo} |
| 4447 | 4471 | |
| 4448 | -@code{makeinfo}プログラムには、階層的構造を持つドキュメントに対して、ノードポインタを自動的に決定する機能があります。 | |
| 4472 | +@code{makeinfo}プログラムには、階層構造を持つドキュメントに対して、ノードポインタを自動的に決定する機能があります。 | |
| 4449 | 4473 | この機能の使用を強く推奨します。 |
| 4450 | 4474 | |
| 4451 | -この機能を利用する場合、ノード名の後に、`Next'ポインタ、`Previous'ポインタ、`Up'ポインタを書く必要がありません。 | |
| 4475 | +この機能を利用する場合、Nextポインタ、Previousポインタ、Upポインタをノード名の後ろに書く必要はありません。 | |
| 4452 | 4476 | しかし、その短かく切り詰められた@code{@@node}行の直後には、@code{@@chapter}や@code{@@section}などの区切りコマンドを書かなければなりません(間に挟まれるコメント行は除きます)。 |
| 4453 | 4477 | |
| 4454 | -加えて、`Top'の@code{@@node}行には@code{@@top}で始まる行を続けて、ファイルの`Top'ノードに印を付けなければなりません。 | |
| 4478 | +加えて、Topノードの@code{@@node}行には@code{@@top}で始まる行を続けて記述し、ファイルのTopノードとして印を付けなければなりません。 | |
| 4455 | 4479 | @xref{makeinfo top, , @code{@@top}}. |
| 4456 | 4480 | |
| 4457 | -最後に、各ノードの名前(`Top'ノード以外)を、そのノードの階層レベルよりも一つ以上階層レベルが上のメニューに書かなければなりません。 | |
| 4481 | +Topノード以外の各ノードの名前を、そのノードの階層レベルよりも上にある階層レベルのメニューに書かなければなりません。 | |
| 4458 | 4482 | |
| 4459 | 4483 | @cindex Detail menu |
| 4460 | 4484 | @findex detailmenu |
| 4461 | -マスタメニューで詳細メニューを使用している場合(@pxref{Master Menu Parts})、@code{@@detailmenu @@dots@{@} @@end detailmenu}環境で囲んでください。 | |
| 4485 | +マスターメニューで詳細メニューを使用している場合(@pxref{Master Menu Parts})、@code{@@detailmenu @@dots@{@} @@end detailmenu}環境で囲んでください。 | |
| 4462 | 4486 | そうでなければ、主にドキュメントの最後のノードあるいは最初のノードについて@command{makeinfo}が混乱してしまいます。 |
| 4463 | 4487 | |
| 4464 | 4488 | @code{makeinfo}におけるこの暗黙のノードポインタ生成機能は、メニューやポインタを手作業で更新したり、Texinfoモードのコマンドで更新したりする必要からユーザを解放してくれます。 |
| @@ -4478,7 +4502,7 @@ Infoでは、区切りコマンド@code{@@top}は、タイトルが単独行に | ||
| 4478 | 4502 | |
| 4479 | 4503 | @dfn{アンカー}というのは、ノードを参照できるのと同様に、クロスリファレンスが参照できるようにラベル付けされた、ドキュメント内の位置を表わします。 |
| 4480 | 4504 | アンカーを作るには@code{@@anchor}コマンドを使います。 |
| 4481 | -コマンドには通常のブレースで区切られた引数をラベルとして指定します。 | |
| 4505 | +コマンドには通常の中括弧で区切られた引数をラベルとして指定します。 | |
| 4482 | 4506 | 例えば次のようになります。 |
| 4483 | 4507 | |
| 4484 | 4508 | @example |
| @@ -4495,20 +4519,20 @@ This marks the spot. | ||
| 4495 | 4519 | See [the spot], page 1. |
| 4496 | 4520 | @end example |
| 4497 | 4521 | |
| 4498 | -御覧のように、@code{@@anchor}コマンド自身は出力を生成しません。 | |
| 4522 | +これで分かるように、@code{@@anchor}コマンド自体は出力を生成しません。 | |
| 4499 | 4523 | この例では「spot」という単語の直前に「x-spot」というアンカーを定義しています。 |
| 4500 | 4524 | 示されている通り、@code{@@xref}コマンドや他のクロスリファレンスコマンドを使ってこのアンカーを後で参照することが出来ます。 |
| 4501 | -クロスリファレンスコマンドについては、@xref{Cross References}. | |
| 4525 | +クロスリファレンスコマンドについては別の節を参照してください(@pxref{Cross References})。 | |
| 4502 | 4526 | |
| 4503 | 4527 | @code{@@anchor}コマンドは参照したい位置の直前に置くのが最適です。 |
| 4504 | 4528 | そうすれば、アンカーへジャンプした場合に、読者の目を適切なテキストへと誘導することが出来ます。 |
| 4505 | -ソースが読み易くするために、@code{@@anchor}コマンドを単独行に書くことも出来ます。 | |
| 4529 | +ソースを読み易くするために、@code{@@anchor}コマンドを単独行に書くことも出来ます。 | |
| 4506 | 4530 | @code{@@anchor}コマンドの後ろの空白(改行を含むは無視されます。 |
| 4507 | 4531 | |
| 4508 | 4532 | アンカー名とノード名は衝突してはいけません。 |
| 4509 | 4533 | アンカーとノードは同じように扱われることもあります。 |
| 4510 | 4534 | 例えば、スタンドアローンInfoの@code{goto-node}コマンドは、アンカー名やノード名を引数としてとります。 |
| 4511 | -(@xref{goto-node,,,info-stnd-ja,GNU Info}.) | |
| 4535 | +@xref{goto-node,,,info-stnd-ja,GNU Info}. | |
| 4512 | 4536 | |
| 4513 | 4537 | また、ノード名と同様、アンカー名も使用できない文字があります(@pxref{Node Line Requirements})。 |
| 4514 | 4538 |
| @@ -4519,12 +4543,12 @@ See [the spot], page 1. | ||
| 4519 | 4543 | @findex menu |
| 4520 | 4544 | |
| 4521 | 4545 | @dfn{メニュー}には、下位のノードへのポインタが入っています。 |
| 4522 | -オンライン用の出力では、メニューを使ってそういったノードへ移動することになります。 | |
| 4523 | -メニューは印刷されたマニュアルでは無効で、そこへ表われることはありません。 | |
| 4546 | +オンライン用の出力では、メニューを使って下位ノードへ移動することになります。 | |
| 4547 | +メニューは印刷されたマニュアルでは無効で、現われることはありません。 | |
| 4524 | 4548 | |
| 4525 | 4549 | メニューがあるノードにはテキストを沢山入れるべきではありません。 |
| 4526 | -メニューの前にテキストを沢山書いていることに気付いたら、そのテキストの大半、一つ二つの段落を残した全てを新たなサブノードへ移動することを通常は推奨します。 | |
| 4527 | -そうでない場合、僅かな行しか表示出来ない端末を使っている読者がメニューとその関連テキストを見落としてしまうかもしれません。 | |
| 4550 | +メニューの前にテキストを沢山書いている場合は、そのテキストの大半、一つ二つの段落を残した全てを新たなサブノードへ移動することを通常は推奨します。 | |
| 4551 | +そうしなければ、僅かな行しか表示出来ない端末を使っている読者がメニューとその関連テキストを見落としてしまうかもしれません。 | |
| 4528 | 4552 | 実際問題として、ノードの最初の20行目辺りまでにメニューを置くのが最適です。 |
| 4529 | 4553 | |
| 4530 | 4554 | @menu |
| @@ -4543,7 +4567,7 @@ See [the spot], page 1. | ||
| 4543 | 4567 | @cindex Location of menus |
| 4544 | 4568 | |
| 4545 | 4569 | メニューはノードの最後の位置に配置しなければなりません。 |
| 4546 | -@code{@@end menu}と次のノードの開始位置との間には通常のテキストや余分なコマンドを置かないようにします。 | |
| 4570 | +@code{@@end menu}コマンドと次のノードの開始位置との間には通常のテキストや余分なコマンドを置かないようにします。 | |
| 4547 | 4571 | (当然、ノードにはメニューを一つだけしか入れられません。) |
| 4548 | 4572 | |
| 4549 | 4573 | @cindex Info format, and menus |
| @@ -4552,16 +4576,16 @@ See [the spot], page 1. | ||
| 4552 | 4576 | ですのでこの制限が必要なのです。 |
| 4553 | 4577 | |
| 4554 | 4578 | @cindex Hierarchical documents, and menus |
| 4555 | -技術的に言えば、メニューは、ドキュメントの構造とは無関係にどのようなノードにでもユーザが移動できるようにするものです。 | |
| 4579 | +技術的に言えば、メニューとは、ドキュメントの構造とは無関係にどのようなノードにでもユーザが移動できるようにするものです。 | |
| 4556 | 4580 | 別のInfoファイルのノードであっても移動できます。 |
| 4557 | 4581 | しかし、これを常用するのはお勧めしません。 |
| 4558 | 4582 | @command{makeinfo}の自動ポインタ生成機能(@pxref{makeinfo Pointer Creation})やGNU EmacsのTexinfoモードでの更新コマンドは、階層的に構造化されたドキュメントにおける、下位ノードのメニュー作成でだけ機能するからです。 |
| 4559 | 4583 | 自由にノードを参照するには、代わりにクロスリファレンスを使用してください。 |
| 4560 | 4584 | |
| 4561 | -過去に、メニューがある極短かいノードの後に通常の区切りコマンドを書くのではなく、@code{@@ifinfo}条件で囲んだ@samp{@@heading}コマンドを使うように推奨していました。 | |
| 4562 | -二つの見出しに挟まれた非常に短かいテキストがページ上に現われませんので、より良い印刷出力を得る上でこの方法は利点がありました。 | |
| 4585 | +以前は、メニューがあるごく短かいノードの後に、通常の区切りコマンドではなく、@code{@@ifinfo}条件で囲んだ@samp{@@heading}コマンドを使うように推奨していました。 | |
| 4586 | +そのページ上の二つの見出しに挟まれた非常に短かいテキストがありませんので、より良い印刷出力を得る上でこの方法は利点がありました。 | |
| 4563 | 4587 | しかし、これは@command{makeinfo}の自動ポインタ生成と一緒には使えず、また、実際のドキュメント構造を反映しないため、正しくXML出力を生成することもできません。 |
| 4564 | -ですので、遺憾てすが、もはやこの方法を推奨することは出来ません。 | |
| 4588 | +ですので、遺憾ですが、もはやこの方法を推奨することは出来ません。 | |
| 4565 | 4589 | |
| 4566 | 4590 | |
| 4567 | 4591 | @node Writing a Menu |
| @@ -4569,7 +4593,9 @@ See [the spot], page 1. | ||
| 4569 | 4593 | @cindex Writing a menu |
| 4570 | 4594 | @cindex Menu writing |
| 4571 | 4595 | |
| 4572 | -メニューを構成するには、@code{@@menu}コマンドを単独行に書き、続けてメニューエントリの行やメニューコメントの行を書き、そして、@code{@@end menu}コマンドを単独で書きます。 | |
| 4596 | +メニューを構成するには、@code{@@menu}コマンドを単独行に書きます。 | |
| 4597 | +続けてメニューエントリの行やメニューコメントの行を記述します。 | |
| 4598 | +そして、@code{@@end menu}コマンドを単独で書きます。 | |
| 4573 | 4599 | |
| 4574 | 4600 | メニューは以下のようになります。 |
| 4575 | 4601 |
| @@ -4585,14 +4611,13 @@ Larger Units of Text | ||
| 4585 | 4611 | @end group |
| 4586 | 4612 | @end example |
| 4587 | 4613 | |
| 4614 | +@cindex Spaces, in menus | |
| 4588 | 4615 | メニューにおいて、@w{@samp{* }}で始まる行は全て@dfn{メニューエントリ}です。 |
| 4589 | 4616 | (アスタリスクの後ろの空白に注意してください。) |
| 4590 | 4617 | @w{@samp{* }}で開始されない行もメニューに現われます。 |
| 4591 | 4618 | そういった行はメニューエントリではなく、Infoファイルに現われるメニューコメント行です。 |
| 4592 | 4619 | 上記の例では、@samp{Larger Units of Text}というのがメニューコメント行です。 |
| 4593 | -@w{@samp{* }}で始まる二 | |
| 4594 | -@cindex Spaces, in menus | |
| 4595 | -行はメニューエントリです。 | |
| 4620 | +@w{@samp{* }}で始まる二行はメニューエントリです。 | |
| 4596 | 4621 | メニュー内の空白文字はそのまま保持されます。 |
| 4597 | 4622 | これによって、好きなようにメニューを書式化することが出来ます。 |
| 4598 | 4623 |
| @@ -4611,25 +4636,26 @@ Larger Units of Text | ||
| 4611 | 4636 | |
| 4612 | 4637 | @enumerate |
| 4613 | 4638 | @item |
| 4614 | -メニューエントリ名(省略可能)。 | |
| 4639 | +メニューエントリ名(省略可能) | |
| 4615 | 4640 | |
| 4616 | 4641 | @item |
| 4617 | -ノード名(必須)。 | |
| 4642 | +ノード名(必須) | |
| 4618 | 4643 | |
| 4619 | 4644 | @item |
| 4620 | -項目の説明(省略可能)。 | |
| 4645 | +項目の説明(省略可能) | |
| 4621 | 4646 | @end enumerate |
| 4622 | 4647 | |
| 4623 | -一般的なメニューエントリのテンプレートは次のようになります(別の形のものについては次のセクションを参照してください)。 | |
| 4648 | +一般的なメニューエントリのテンプレートは次のようになります(別の形のものについては次節を参照してください)。 | |
| 4624 | 4649 | |
| 4625 | 4650 | @example |
| 4626 | 4651 | * @var{menu-entry-name}: @var{node-name}. @var{description} |
| 4627 | 4652 | @end example |
| 4628 | 4653 | |
| 4629 | -メニューエントリ名に続けてシングルコロン、そしてノード名に続けてタブやカンマ、改行、あるいはピリオドと空白の二文字(@samp{. })を続けます。 | |
| 4654 | +メニューエントリ名に続けてシングルコロンを置きます。 | |
| 4655 | +そしてノード名に続けてタブやカンマ、改行、あるいはピリオドと空白の二文字(@samp{. })を記述します。 | |
| 4630 | 4656 | |
| 4631 | -Infoでは、ユーザはノードを@kbd{m}(@code{Info-menu})コマンドで選択します。 | |
| 4632 | -メニューエントリ名は、@kbd{m}コマンドの後でユーザが入力します。 | |
| 4657 | +Infoでは、ユーザは@kbd{m}(@code{Info-menu})コマンドでノードを選択します。 | |
| 4658 | +メニューエントリ名は、@kbd{m}コマンドの後でユーザが入力するものです。 | |
| 4633 | 4659 | |
| 4634 | 4660 | メニューエントリの3番目の部分は説明の語句や文章です。 |
| 4635 | 4661 | メニューエントリ名とノード名は短かいことがよくあります。 |
| @@ -4736,7 +4762,7 @@ Larger Units of Text | ||
| 4736 | 4762 | メニューに現われますがエントリではありません。@refill |
| 4737 | 4763 | |
| 4738 | 4764 | @samp{Files}や@samp{Buffers}のどちらにもファイル名が指定されていませんので、同じInfoファイルにあるノード名ということになります。 |
| 4739 | -(@pxref{Other Info Files, , Referring to Other Info Files}).@refill | |
| 4765 | +@xref{Other Info Files, , Referring to Other Info Files}.@refill | |
| 4740 | 4766 | |
| 4741 | 4767 | @node Other Info Files |
| 4742 | 4768 | @comment node-name, next, previous, up |
| @@ -4747,12 +4773,12 @@ Larger Units of Text | ||
| 4747 | 4773 | @cindex Going to other Info files' nodes |
| 4748 | 4774 | @cindex Info; other files' nodes |
| 4749 | 4775 | |
| 4750 | -ノード名の直前で括弧の中にファイル名を書くことで、別のInfoファイルのノードへ移動することが出来るようにするメニューエントリを作成することが出来ます。 | |
| 4776 | +括弧の中にファイル名を入れてノード名の直前に書くと、別のInfoファイルのノードへ移動できるメニューエントリを作成することが出来ます。 | |
| 4751 | 4777 | この場合、三つの項目から成るメニューエントリ形式を使用すべきです。 |
| 4752 | -この形式だと、Infoの読者はファイル名を入力しなくてもよくなります。@refill | |
| 4778 | +この形式だと、Infoの読者がファイル名を入力しなくてもよくなります。@refill | |
| 4753 | 4779 | |
| 4754 | 4780 | @need 800 |
| 4755 | -この書式は以下のようになります。@refill | |
| 4781 | +書式は以下のようになります。@refill | |
| 4756 | 4782 | |
| 4757 | 4783 | @example |
| 4758 | 4784 | @group |
| @@ -4776,11 +4802,11 @@ Larger Units of Text | ||
| 4776 | 4802 | @end group |
| 4777 | 4803 | @end example |
| 4778 | 4804 | |
| 4779 | -ノード名を記述せず、ファイル名だけであれば、Infoは`Top'ノードを参照しているものとみなします。@refill | |
| 4805 | +ノード名を記述せず、ファイル名だけであれば、InfoはTopノードを参照しているものとみなします。@refill | |
| 4780 | 4806 | |
| 4781 | 4807 | Infoのメインメニューが入っている@file{dir}ファイルには、ファイル名だけを記載したメニューエントリが入っています。 |
| 4782 | -これらのエントリによって、各Infoドキュメントの`Top'ノードへ直接移動します。 | |
| 4783 | -(@xref{Installing an Info File}.) | |
| 4808 | +これらのエントリによって、各InfoドキュメントのTopノードへ直接移動します。 | |
| 4809 | +@xref{Installing an Info File}. | |
| 4784 | 4810 | |
| 4785 | 4811 | @need 700 |
| 4786 | 4812 | 例えば、以下のようになります。 |
| @@ -4807,7 +4833,7 @@ GNU EmacsのTexinfoモードでのメニュー更新コマンドはカレント | ||
| 4807 | 4833 | @cindex References |
| 4808 | 4834 | |
| 4809 | 4835 | @dfn{クロスリファレンス}は、同じTexinfoファイルの他の部分か、もしくは別のTexinfoファイルを読者に参照させるために使用するものです。 |
| 4810 | -Texinfoでは、クロスリファレンスが参照できる場所はノードとアンカーです。 | |
| 4836 | +Texinfoでは、クロスリファレンスによって参照できる場所はノードとアンカーです。 | |
| 4811 | 4837 | |
| 4812 | 4838 | @menu |
| 4813 | 4839 | * References:: What cross references are for. |
| @@ -4825,23 +4851,23 @@ Texinfoでは、クロスリファレンスが参照できる場所はノード | ||
| 4825 | 4851 | @node References |
| 4826 | 4852 | @section リファレンスの目的 |
| 4827 | 4853 | |
| 4828 | -印刷されるドキュメントは、常にではありませんが、連続して読むことが出来るように設計されていることが多いです。 | |
| 4829 | -必要な時に、欲しい情報を探してページを前後にめくるのには疲れます。@refill | |
| 4854 | +いつもというわけではありませんが、印刷ドキュメントは、連続して読むことが出来るように設計されていることが多いです。 | |
| 4855 | +必要な時に、欲しい情報を探してページを前後にめくるのは疲れます。@refill | |
| 4830 | 4856 | |
| 4831 | -しかし、どんなドキュメントでも、現在の文脈に対して詳細に過ぎたり、大して重要でなかったりするような情報がある場合があります。 | |
| 4857 | +しかし、どのようなドキュメントにおいても、現在の文脈に対して詳しすぎたり、大して重要でなかったりするような情報がある場合があります。 | |
| 4832 | 4858 | クロスリファレンスは、そういった情報へアクセスするのに使用してください。 |
| 4833 | 4859 | また、オンラインのヘルプシステムやリファレンスマニュアルは小説ではありません。 |
| 4834 | 4860 | そういったドキュメントを最初から最後まで順番に読む人はほとんどいません。 |
| 4835 | 4861 | そうではなく、必要なところを探して読むのです。 |
| 4836 | 4862 | こういったことから、そのようなドキュメントは、沢山のクロスリファレンスを入れることによって、読者が読まなかったかもしれないその他の情報を見つけられるよう手助けをするべきでしょう。@refill |
| 4837 | 4863 | |
| 4838 | -印刷されたマニュアルでは、完全に別のマニュアルを指すものでなければ、ページ参照となります。 | |
| 4864 | +印刷マニュアルでは、完全に別のマニュアルを指すものでなければ、ページを参照するものとなります。 | |
| 4839 | 4865 | 別のマニュアルを参照する場合には、クロスリファレンスはそのマニュアルを指すものとなります。@refill |
| 4840 | 4866 | |
| 4841 | 4867 | Infoでは、クロスリファレンスはInfoの@samp{f}コマンドを使って辿ることの出来るエントリになります。 |
| 4842 | 4868 | (@inforef{Help-Xref, Following cross-references, info}.) |
| 4843 | 4869 | |
| 4844 | -様々なクロスリファレンスコマンドが、クロスリファレンスの場所を定義するのにノード(およびアンカー@pxref{anchor,,@code{@@anchor}})を使用します。 | |
| 4870 | +様々なクロスリファレンスコマンドが、クロスリファレンスの場所を定義するのにノード(およびアンカー(@pxref{anchor,,@code{@@anchor}}))を使用します。 | |
| 4845 | 4871 | このことは、クロスリファレンスによって指定場所へ移動できるInfoでははっきりと分かります。 |
| 4846 | 4872 | @TeX{}もまたクロスリファレンスの場所を定義するのにノードを使用しますが、その効果はそれほど明らかではありません。 |
| 4847 | 4873 | @TeX{}でDVIファイルを生成する時、@TeX{}は各ノードのページ番号を記録し、リファレンスの作成にそのページ番号を使用します。 |
| @@ -4853,23 +4879,23 @@ Infoでは、クロスリファレンスはInfoの@samp{f}コマンドを使っ | ||
| 4853 | 4879 | @section 様々なクロスリファレンスコマンド |
| 4854 | 4880 | @cindex Different cross reference commands |
| 4855 | 4881 | |
| 4856 | -クロスリファレンスのコマンドは別々に四つあります。@refill | |
| 4882 | +クロスリファレンスのコマンドは四つあります。@refill | |
| 4857 | 4883 | |
| 4858 | 4884 | @table @code |
| 4859 | 4885 | @item @@xref |
| 4860 | -印刷されたマニュアルで、@w{`See @dots{}'}という文章を開始するのに使用されます。 | |
| 4886 | +印刷されたマニュアルで、@w{「See @dots{}」}という文章を開始するのに使用されます。 | |
| 4861 | 4887 | Infoのクロスリファレンスでは@samp{*Note @var{name}: @var{node}.}というようになります。 |
| 4862 | 4888 | |
| 4863 | 4889 | @item @@ref |
| 4864 | 4890 | 文中で使用されます。 |
| 4865 | 4891 | よくあるのは文末です。 |
| 4866 | 4892 | Infoの場合は@code{@@xref}と同じです。 |
| 4867 | -印刷されたマニュアルでは`See'が前に付かないリファレンスだけを生成します。@refill | |
| 4893 | +印刷されたマニュアルでは「See」が前に付かないリファレンスだけを生成します。@refill | |
| 4868 | 4894 | |
| 4869 | 4895 | @item @@pxref |
| 4870 | 4896 | 括弧内で使用し、Infoファイルや印刷されたマニュアルの両方に適したリファレンスを生成します。 |
| 4871 | -印刷マニュアルでは小文字の`see'から始まります。 | |
| 4872 | -(@samp{p}は`parenthesis'の意味です。)@refill | |
| 4897 | +印刷マニュアルでは小文字の「see」から始まります。 | |
| 4898 | +(@samp{p}は「parenthesis」の意味です。)@refill | |
| 4873 | 4899 | |
| 4874 | 4900 | @item @@inforef |
| 4875 | 4901 | 印刷されたマニュアルが無いInfoファイルに対してリファレンスを生成するのに使用されます。@refill |
| @@ -4887,8 +4913,8 @@ Infoの場合は@code{@@xref}と同じです。 | ||
| 4887 | 4913 | @cindex Parts of a cross reference |
| 4888 | 4914 | |
| 4889 | 4915 | クロスリファレンスのコマンドは必須な引数を一つだけ取ります。 |
| 4890 | -引数は参照先のノード名です。 | |
| 4891 | -しかし、クロスリファレンスのコマンドには、最大四つまでの追加の引数を付けることが出来ます。 | |
| 4916 | +参照先のノード名です。 | |
| 4917 | +クロスリファレンスのコマンドには、最大四つまでの追加の引数を付けることが出来ます。 | |
| 4892 | 4918 | 追加の引数を使うと、Infoにおいてクロスリファレンスの名前を指定したり、印刷されたマニュアルにおいてトピックの説明やセクションのタイトルを指定したり、別のInfoファイル名を指定したり、あるいは、別の印刷マニュアルの名前を指定したりすることが出来ます。@refill |
| 4893 | 4919 | |
| 4894 | 4920 | 以下に単純なクロスリファレンスの例を挙げます。:@refill |
| @@ -5038,8 +5064,8 @@ See Section @var{section-number} [@var{title-or-topic}], page @var{page}. | ||
| 5038 | 5064 | @code{@@xref}コマンドは、Infoファイルでも印刷出力でも、クロスリファレンスの最後にピリオドやカンマを生成することはありません。 |
| 5039 | 5065 | ピリオドやカンマは自分で記述しなければなりません。 |
| 5040 | 5066 | 記述しなかった場合、Infoはリファレンスの終わりを認識しません。 |
| 5041 | -(The @code{@@pxref} command works differently. | |
| 5042 | -@xref{pxref, , @code{@@pxref}}.)@refill | |
| 5067 | + | |
| 5068 | +@code{@@pxref}コマンドは違う動作をします(@pxref{pxref, , @code{@@pxref}})。 | |
| 5043 | 5069 | |
| 5044 | 5070 | @quotation Caution |
| 5045 | 5071 | @code{@@xref}コマンドは、閉じ括弧に続けてピリオドかカンマを書かなければなりません。 |
| @@ -5048,7 +5074,7 @@ See Section @var{section-number} [@var{title-or-topic}], page @var{page}. | ||
| 5048 | 5074 | @end quotation |
| 5049 | 5075 | |
| 5050 | 5076 | @code{@@xref}はInfoをノード名で参照する必要があります。 |
| 5051 | -@code{@@node}をノードの定義に使用してください(@pxref{Writing a Node})。@refill | |
| 5077 | +ノードを定義するには、@code{@@node}コマンドを使用してください(@pxref{Writing a Node})。@refill | |
| 5052 | 5078 | |
| 5053 | 5079 | @code{@@xref}に続けて、カンマで区切られた複数の引数を括弧の中に書きます。 |
| 5054 | 5080 | カンマの前後の空白は無視されます。@refill |
| @@ -5382,16 +5408,13 @@ Meteorology}, for details. | ||
| 5382 | 5408 | こういう場合には、4番目の引数だけを指定する必要があります。5番目の引数は必要ありません。@refill |
| 5383 | 5409 | |
| 5384 | 5410 | @node Top Node Naming |
| 5385 | -@section `Top'ノードの指定 | |
| 5411 | +@section Topノードの指定 | |
| 5386 | 5412 | @cindex Naming a `Top' Node in references |
| 5387 | 5413 | @cindex @samp{@r{Top}} node naming for references |
| 5388 | 5414 | |
| 5389 | -クロスリファレンスでは、常にノード名を指定する必要があります。 | |
| 5390 | -これは、マニュアル全体を参照するためには、@code{@@xref}コマンドの1番目の引数として`Top'ノードを書いて、ノードを識別しなければならないということを意味して | |
| 5391 | -います。 | |
| 5392 | -(これは、メニューエントリを書く場合とは異なります。 | |
| 5393 | -@ref{Other Info Files, , Referring to Other Info Files}.) | |
| 5394 | -同時に、印刷されるクロスリファレンスにおいて(`Top'という言葉でなく)意味のあるセクショントピックやタイトルを付けるためには、@code{@@xref}コマンドの3番目の引数に適切なエントリを記述する必要があります。@refill | |
| 5415 | +クロスリファレンスでは常にノード名を指定する必要があります。 | |
| 5416 | +これは、マニュアル全体を参照するためには、@code{@@xref}コマンドの1番目の引数としてTopノードを書いて、ノードを識別しなければならないということを意味しています(これは、メニューエントリを書く場合とは異なります(@pxref{Other Info Files, , Referring to Other Info Files}))。 | |
| 5417 | +同時に、印刷されるクロスリファレンスにおいて(「Top」という言葉でなく)意味のあるセクショントピックやタイトルを付けるためには、@code{@@xref}コマンドの3番目の引数に適切なエントリを記述する必要があります。@refill | |
| 5395 | 5418 | |
| 5396 | 5419 | @noindent |
| 5397 | 5420 | ですので、@cite{The GNU Make Manual}へのクロスリファレンスを作成するとしたら、次のように書いてください。@refill |
| @@ -5545,11 +5568,12 @@ Infoの書式化コマンドは、終わりのコロンやピリオドを使っ | ||
| 5545 | 5568 | @end quotation |
| 5546 | 5569 | |
| 5547 | 5570 | @code{@@pxref}コマンドは、@code{@@xref}コマンドとのように、最大五つまでの引数を付けて使用することが出来ます。 |
| 5548 | -(@pxref{xref, , @code{@@xref}}). | |
| 5571 | +@xref{xref, , @code{@@xref}}. | |
| 5549 | 5572 | |
| 5550 | -Texinfoの以前のバージョンでは@code{@@pxref}の後ろに句読点を書くことが許されていませんでしたので、右括弧の前で@emph{only}使用することが出来ました。 | |
| 5573 | +Texinfoの以前のバージョンでは@code{@@pxref}の後ろに句読点を書くことが許されていませんでしたので、右括弧の前で@emph{だけ}使用することが出来ました。 | |
| 5551 | 5574 | しかし、もうこれは当て嵌りません。現在は、(例えば)文末で使用することが出来ます。 |
| 5552 | -文末では小文字の「see」が一番上手くいきます。以下に例を挙げます。 | |
| 5575 | +文末では小文字の「see」が一番上手くいきます。 | |
| 5576 | +以下に例を挙げます。 | |
| 5553 | 5577 | |
| 5554 | 5578 | @example |
| 5555 | 5579 | @dots{} For more information, @@pxref@{More@}. |
| @@ -5586,13 +5610,13 @@ Texinfoの以前のバージョンでは@code{@@pxref}の後ろに句読点を | ||
| 5586 | 5610 | |
| 5587 | 5611 | @enumerate |
| 5588 | 5612 | @item |
| 5589 | -ノード名。 | |
| 5613 | +ノード名 | |
| 5590 | 5614 | |
| 5591 | 5615 | @item |
| 5592 | -クロスリファレンス名(省略可能)。 | |
| 5616 | +クロスリファレンス名(省略可能) | |
| 5593 | 5617 | |
| 5594 | 5618 | @item |
| 5595 | -Infoファイル名。 | |
| 5619 | +Infoファイル名 | |
| 5596 | 5620 | @end enumerate |
| 5597 | 5621 | |
| 5598 | 5622 | @noindent |
| @@ -5636,15 +5660,16 @@ for more information. | ||
| 5636 | 5660 | See Info file @file{info}, node @samp{Advanced}, for more information. |
| 5637 | 5661 | @end quotation |
| 5638 | 5662 | |
| 5639 | -(InfoマニュアルがTexinfoで書かれているために、全ての形式が利用可能ですので、この例は実際的なものではありません。) | |
| 5663 | +(InfoのマニュアルはTexinfoで書かれています。 | |
| 5664 | +そのため全ての形式が利用可能ですので、この例は実際的なものではありません。) | |
| 5640 | 5665 | |
| 5641 | 5666 | @code{@@inforef}の逆は@code{@@cite}です。 |
| 5642 | -@code{@@cite}はInfo形式が存在しない印刷物を参照するのに使用されます。 | |
| 5667 | +@code{@@cite}はInfo形式が存在しない印刷物を参照するのに使用します。 | |
| 5643 | 5668 | @xref{cite, , @code{@@cite}}. |
| 5644 | 5669 | |
| 5645 | 5670 | |
| 5646 | 5671 | @node uref |
| 5647 | -@section @code{@@url}, @code{@@uref@{@var{url}[, @var{text}][, @var{replacement}]@}} | |
| 5672 | +@section @code{@@url}・@code{@@uref@{@var{url}[, @var{text}][, @var{replacement}]@}} | |
| 5648 | 5673 | @findex uref |
| 5649 | 5674 | @cindex Uniform resource locator, referring to |
| 5650 | 5675 | @cindex URL, referring to |
| @@ -5670,7 +5695,8 @@ InfoやDVIの出力ではURLも出力されますが、HTMLの出力ではURLは | ||
| 5670 | 5695 | 3番目の引数が指定されると、2番目の引数は無視されます。 |
| 5671 | 5696 | |
| 5672 | 5697 | 改行されて問題が起きるほどURLが長い場合、改行を入れても良い場所(例えば、@samp{/}文字の後ろ)へ@code{@@/}を挿入すると便利です。 |
| 5673 | -これは、そこで改行することを許す(強制的に改行するわけではない)よう@TeX{}に指示するものです。 | |
| 5698 | +これは、そこで改行することを許すよう@TeX{}に指示するものです。 | |
| 5699 | +強制的に改行するわけではありません。 | |
| 5674 | 5700 | @xref{Line Breaks}. |
| 5675 | 5701 | |
| 5676 | 5702 | 引数一つの単純な形式の例を以下へ示します。 |
| @@ -5726,7 +5752,7 @@ The @uref{/man.cgi/1/ls,,ls} program @dots{} | ||
| 5726 | 5752 | The <a href="/man.cgi/1/ls">ls</a> program @dots{} |
| 5727 | 5753 | @end example |
| 5728 | 5754 | |
| 5729 | -辿ることが出来るリンクを作成せずに単にURLを示す場合には、@code{@@indicateurl}を使用してください(@pxref{indicateurl, @code{@@indicateurl}}).。 | |
| 5755 | +辿ることが出来るリンクを作成せずに単にURLを示す場合には、@code{@@indicateurl}を使用してください(@pxref{indicateurl, @code{@@indicateurl}})。 | |
| 5730 | 5756 | |
| 5731 | 5757 | 明確な書式でURLを表示するのを好む人もいます。 |
| 5732 | 5758 |
| @@ -5737,7 +5763,7 @@ The <a href="/man.cgi/1/ls">ls</a> program @dots{} | ||
| 5737 | 5763 | @noindent |
| 5738 | 5764 | @cindex <URL: convention, not used |
| 5739 | 5765 | 好みにより入力ファイルでこの形式を使うことも出来ます。 |
| 5740 | -テキスト中のURLの検出を試みるどんなソフトウェアも、前々から利便のために、@samp{<URL:}無しでURLを検出しなければなりませんので、l@samp{<URL:}と@samp{>}を出力中に含める必要性を感じません。 | |
| 5766 | +テキスト中のURLの検出を試みるどんなソフトウェアも、前々から利便のために、@samp{<URL:}無しでURLを検出しなければなりませんので、@samp{<URL:}と@samp{>}を出力中に含める必要性を感じません。 | |
| 5741 | 5767 | |
| 5742 | 5768 | |
| 5743 | 5769 | @node cite |
| @@ -5760,8 +5786,8 @@ Texinfoで本が記述されている場合は、クロスリファレンスコ | ||
| 5760 | 5786 | @cindex Text, marking up |
| 5761 | 5787 | |
| 5762 | 5788 | Texinfoでは、語句を様々な方法でマークすることが出来ます。 |
| 5763 | -Texinfoのフォーマッタは、この情報を使って、テキストを目立たせる方法を決定します。 | |
| 5764 | -語句が、例えば、定義の発生なのか、メタ構文変数なのか、プログラムで使用されるシンボルなのかということを指定することが出来ます。 | |
| 5789 | +Texinfoのフォーマッタは、この情報を使ってテキストを目立たせる方法を決定します。 | |
| 5790 | +例えば、言葉の定義があるのか、メタ構文変数なのか、プログラムで使用されるシンボルなのかということをその語句に指定することが出来ます。 | |
| 5765 | 5791 | また、テキストを複数の異なる方法で強調することも出来ます。 |
| 5766 | 5792 | |
| 5767 | 5793 | @menu |
| @@ -5771,7 +5797,7 @@ Texinfoのフォーマッタは、この情報を使って、テキストを目 | ||
| 5771 | 5797 | |
| 5772 | 5798 | |
| 5773 | 5799 | @node Indicating |
| 5774 | -@section 定義、コマンド等の表示 | |
| 5800 | +@section 定義やコマンド等の表示 | |
| 5775 | 5801 | @cindex Highlighting text |
| 5776 | 5802 | @cindex Indicating commands, definitions, etc. |
| 5777 | 5803 |
| @@ -5821,7 +5847,8 @@ Texinfoには、あるテキストの断片が参照しているものの種類 | ||
| 5821 | 5847 | @xref{code,,@code{@@code}}. |
| 5822 | 5848 | |
| 5823 | 5849 | @item @@kbd@{@var{keyboard-characters}@} |
| 5824 | -キーボード入力を示します。@xref{kbd,,@code{@@kbd}}. | |
| 5850 | +キーボード入力を示します。 | |
| 5851 | +@xref{kbd,,@code{@@kbd}}. | |
| 5825 | 5852 | |
| 5826 | 5853 | @item @@key@{@var{key-name}@} |
| 5827 | 5854 | キーボードのキーに対する慣習的な名前を示します。 |
| @@ -5832,22 +5859,28 @@ Texinfoには、あるテキストの断片が参照しているものの種類 | ||
| 5832 | 5859 | @xref{samp,,@code{@@samp}}. |
| 5833 | 5860 | |
| 5834 | 5861 | @item @@verb@{@var{text}@} |
| 5835 | -そのままの文字並びを書きます。@xref{verb,,@code{@@verb}}. | |
| 5862 | +そのままの文字並びを書きます。 | |
| 5863 | +@xref{verb,,@code{@@verb}}. | |
| 5836 | 5864 | |
| 5837 | 5865 | @item @@var@{@var{metasyntactic-variable}@} |
| 5838 | -メタ構文変数を示します。@xref{var,,@code{@@var}}. | |
| 5866 | +メタ構文変数を示します。 | |
| 5867 | +@xref{var,,@code{@@var}}. | |
| 5839 | 5868 | |
| 5840 | 5869 | @item @@env@{@var{environment-variable}@} |
| 5841 | -環境変数を示します。 @xref{env,,@code{@@env}}. | |
| 5870 | +環境変数を示します。 | |
| 5871 | +@xref{env,,@code{@@env}}. | |
| 5842 | 5872 | |
| 5843 | 5873 | @item @@file@{@var{file-name}@} |
| 5844 | -ファイル名を示します。@xref{file,,@code{@@file}}. | |
| 5874 | +ファイル名を示します。 | |
| 5875 | +@xref{file,,@code{@@file}}. | |
| 5845 | 5876 | |
| 5846 | 5877 | @item @@command@{@var{command-name}@} |
| 5847 | -コマンド名を示します。 @xref{command,,@code{@@command}}. | |
| 5878 | +コマンド名を示します。 | |
| 5879 | +@xref{command,,@code{@@command}}. | |
| 5848 | 5880 | |
| 5849 | 5881 | @item @@option@{@var{option}@} |
| 5850 | -コマンドラインオプションを示します。@xref{option,,@code{@@option}}. | |
| 5882 | +コマンドラインオプションを示します。 | |
| 5883 | +@xref{option,,@code{@@option}}. | |
| 5851 | 5884 | |
| 5852 | 5885 | @item @@dfn@{@var{term}@} |
| 5853 | 5886 | 用語が最初に使用されていることや用語がよく表わされていることを示します。 |
| @@ -5866,10 +5899,13 @@ Texinfoには、あるテキストの断片が参照しているものの種類 | ||
| 5866 | 5899 | @item @@indicateurl@{@var{uniform-resource-locator}@} |
| 5867 | 5900 | ユニフォームリソースロケータ(URL)の例示(つまり機能しないもの)であることを示します。 |
| 5868 | 5901 | @xref{indicateurl,,@code{@@indicateurl}}. |
| 5869 | -(生きたURLには@code{@@url}を使用してください(@pxref{uref,,@code{@@url}})。) | |
| 5902 | + | |
| 5903 | +生きたURLには@code{@@url}を使用してください。 | |
| 5904 | +@xref{uref,,@code{@@url}}. | |
| 5870 | 5905 | |
| 5871 | 5906 | @item @@email@{@var{email-address}[, @var{displayed-text}]@} |
| 5872 | -電子メールアドレスを示します。@xref{email,,@code{@@email}}. | |
| 5907 | +電子メールアドレスを示します。 | |
| 5908 | +@xref{email,,@code{@@email}}. | |
| 5873 | 5909 | |
| 5874 | 5910 | @ignore |
| 5875 | 5911 | @item @@ctrl@{@var{ctrl-char}@} |
| @@ -5925,7 +5961,7 @@ The function returns `nil'. | ||
| 5925 | 5961 | @end example |
| 5926 | 5962 | @end iftex |
| 5927 | 5963 | |
| 5928 | -@code{@@code}を@emph{使用しない}ようにするほうが望ましい場合を以下に示します。 | |
| 5964 | +@code{@@code}を@emph{使用しない}ほうが望ましい場合を以下に示します。 | |
| 5929 | 5965 | |
| 5930 | 5966 | @itemize @bullet |
| 5931 | 5967 | @item |
| @@ -5947,8 +5983,7 @@ The function returns `nil'. | ||
| 5947 | 5983 | |
| 5948 | 5984 | @item |
| 5949 | 5985 | 一般に、トークンで使用されている文字について書く場合。 |
| 5950 | -例えば、関数名で使用することの出来る文字や表示シンボルを説明しているような場合には、@code{@@code}を使わないようにしてください。 | |
| 5951 | -(@code{@@samp}を使うようにしてください。) | |
| 5986 | +例えば、関数名で使用することの出来る文字や表示シンボルを説明しているような場合には、@code{@@code}を使わないようにしてください(@code{@@samp}を使うようにしてください)。 | |
| 5952 | 5987 | また、プログラム言語のような言語で書かれた入力データでなければ、そのプログラムへの入力とみなされるテキストを@code{@@code}でマークすべきではありません。 |
| 5953 | 5988 | 例えば、キー入力によって起動されるEmacs Lispの関数名については@code{@@code}を使用できますが、GNU Emacsへのキー入力コマンド自体については@code{@@code}を使用すべきではありません(代わりに@code{@@kbd}を使ってください)。 |
| 5954 | 5989 |
| @@ -5983,7 +6018,7 @@ The function returns `nil'. | ||
| 5983 | 6018 | |
| 5984 | 6019 | @cindex User input |
| 5985 | 6020 | @cindex Slanted typewriter font, for @code{@@kbd} |
| 5986 | -デフォルトでは、@code{@@kbd}コマンドは、印刷されたマニュアルでは異なったフォント(ノーマルタイプライターではなく斜体タイプライター)を生成しますので、タイプするはずの文字をコンピュータの出力する文字とは区別できるようになります。 | |
| 6021 | +@code{@@kbd}コマンドは、デフォルトでは印刷されたマニュアルでは異なったフォント(ノーマルタイプライターではなく斜体タイプライター)を生成しますので、タイプされる文字をコンピュータの出力する文字とは区別できるようになります。 | |
| 5987 | 6022 | |
| 5988 | 6023 | Infoの出力では、@code{@@kbd}は通常@code{@@code}コマンドと同じで、引数の前後に「引用符」を生成します。 |
| 5989 | 6024 | しかし、@code{@@example}環境(@pxref{example})や@code{@@code}コマンド自体のようなタイプライター風のコンテキストでは、引用符が省略されます。 |
| @@ -6016,8 +6051,7 @@ Infoの出力では、@code{@@kbd}は通常@code{@@code}コマンドと同じで | ||
| 6016 | 6051 | @end example |
| 6017 | 6052 | |
| 6018 | 6053 | @noindent |
| 6019 | -これは@kbd{r @key{RET}}を生成します。 | |
| 6020 | -(このマニュアルでは@code{@@kbdinputstyle}についてはデフォルトを使用しています。) | |
| 6054 | +これは@kbd{r @key{RET}}を生成します(このマニュアルでは@code{@@kbdinputstyle}についてはデフォルトを使用しています)。 | |
| 6021 | 6055 | |
| 6022 | 6056 | また、入力した文字を詳しく説明するのに@code{@@kbd}コマンドを使用することも可能です。 |
| 6023 | 6057 | 例えば、以下のようにします。 |
| @@ -6035,8 +6069,8 @@ To give the @code{logout} command, | ||
| 6035 | 6069 | type the characters @kbd{l o g o u t @key{RET}}. |
| 6036 | 6070 | @end quotation |
| 6037 | 6071 | |
| 6038 | -(また、この例は分かりやすさのためにスペース文字を追加できることを示しています。 | |
| 6039 | -入力される文字の一つとしてのスペース文字に言及したい場合には、@kbd{@@key@{SPC@}}と記述してください。)@refill | |
| 6072 | +また、この例は分かりやすさのためにスペース文字を追加できることを示しています。 | |
| 6073 | +入力される文字の一つとしてのスペース文字に言及したい場合には、@kbd{@@key@{SPC@}}と記述してください。@refill | |
| 6040 | 6074 | |
| 6041 | 6075 | |
| 6042 | 6076 | @node key |
| @@ -6155,9 +6189,9 @@ In English, the vowels are @samp{a}, @samp{e}, | ||
| 6155 | 6189 | @cindex Verbatim in-line text |
| 6156 | 6190 | |
| 6157 | 6191 | @cindex Delimiter character, for verbatim |
| 6158 | -そのままの文字並びを表示するには、@code{@@verb}コマンドを使用してください。 | |
| 6192 | +そのままの文字並びを表示するには@code{@@verb}コマンドを使用してください。 | |
| 6159 | 6193 | |
| 6160 | -@LaTeX{}の@code{\verb}コマンドと同様、字面そのままのテキストは、任意のユニークな区切り文字を使って示すことが出来ます。 | |
| 6194 | +@LaTeX{}の@code{\verb}コマンドと同様、任意のユニークな区切り文字を使って、字面そのままのテキストを示すことが出来ます。 | |
| 6161 | 6195 | 字面そのままのテキストは、括弧の中に区切り文字を含めて括ってください。 |
| 6162 | 6196 | テキストは等幅フォントで印刷されます。 |
| 6163 | 6197 |
| @@ -6174,7 +6208,7 @@ How many @verb{|@|}-escapes does one need to print this | ||
| 6174 | 6208 | @verb{.@a @b @c.} string or these @verb{+@'e?`{}!`\+} this? |
| 6175 | 6209 | @end example |
| 6176 | 6210 | |
| 6177 | -これは、@code{@@samp}コマンド(前のセクションを参照)や@code{@@code}コマンド、そして類似のコマンドとは対照的です。 | |
| 6211 | +これは、@code{@@samp}コマンド(前節参照)や@code{@@code}コマンド、そして類似のコマンドとは対照的です。 | |
| 6178 | 6212 | これらのコマンドの場合は、引数は通常のTexinfoのテキストで、@code{@@@{@}}という3文字は特別扱いが成されます。 |
| 6179 | 6213 | @code{@@verb}の場合は、ユーザが選択した区切り文字を除けば特別扱いされるものはありません。 |
| 6180 | 6214 |
| @@ -6186,8 +6220,8 @@ How many @verb{|@|}-escapes does one need to print this | ||
| 6186 | 6220 | @subsection @code{@@var}@{@var{metasyntactic-variable}@} |
| 6187 | 6221 | @findex var |
| 6188 | 6222 | |
| 6189 | -メタ構文変数を示すには、@code{@@var}コマンドを使用してください。 | |
| 6190 | -@dfn{メタ構文変数}とは別のテキストを表わすものです。 | |
| 6223 | +メタ構文変数を示すには@code{@@var}コマンドを使用してください。 | |
| 6224 | +@dfn{メタ構文変数}とは別のテキスト断片の代わりとして使われるものです。 | |
| 6191 | 6225 | 例えば、ある関数のドキュメントの中で、その関数に引き渡される引数を記述するのにメタ構文変数を使うべきでしょう。@refill |
| 6192 | 6226 | |
| 6193 | 6227 | プログラミング言語の特定の変数名に対して@code{@@var}コマンドを使用しないようにしてください。 |
| @@ -6195,9 +6229,9 @@ How many @verb{|@|}-escapes does one need to print this | ||
| 6195 | 6229 | 例えば、Emacs Lispの変数@code{texinfo-tex-command}はメタ構文変数ではありませんので、@code{@@code}コマンドを使って適切に書式化されます。 |
| 6196 | 6230 | |
| 6197 | 6231 | 環境変数に対しても@code{@@var}コマンドを使用しないようにしてください。 |
| 6198 | -@code{@@env}コマンドが正しいです(次のセクションを参照してください)。 | |
| 6232 | +@code{@@env}コマンドを使うのが正しいです(次節参照)。 | |
| 6199 | 6233 | |
| 6200 | -Infoファイルにおける@code{@@var}コマンドの効果は、引数を全て大文字に変更することです。 | |
| 6234 | +Infoファイルにおいては、@code{@@var}コマンドによって引数が全て大文字に変換されます。 | |
| 6201 | 6235 | 印刷されたマニュアルやHTML出力では引数が斜体で印刷されます。 |
| 6202 | 6236 | |
| 6203 | 6237 | @need 700 |
| @@ -6257,9 +6291,9 @@ To delete file @var{filename}, type @samp{rm @var{filename}}. | ||
| 6257 | 6291 | @subsection @code{@@env}@{@var{environment-variable}@} |
| 6258 | 6292 | @findex env |
| 6259 | 6293 | |
| 6260 | -GNUを含め多くのオペレーティングシステムで使用されような環境変数を示すには、@code{@@env}コマンドを使用してください。 | |
| 6294 | +GNUを含め多くのオペレーティングシステムで使用されるような環境変数を示す場合は、@code{@@env}コマンドを使用してください。 | |
| 6261 | 6295 | このコマンドはメタ構文変数に対して使用しないようにしてください。 |
| 6262 | -代わりに@code{@@var}コマンドを使用します(前のセクションを参照してください)。 | |
| 6296 | +メタ構文変数に対しては、代わりに@code{@@var}コマンドを使用します(前節参照)。 | |
| 6263 | 6297 | |
| 6264 | 6298 | @code{@@env}コマンドは、効果の上では、@code{@@code}コマンドと同じです。 |
| 6265 | 6299 | 例えば以下を見てください。 |
| @@ -6277,7 +6311,7 @@ The @env{PATH} environment variable @dots{} | ||
| 6277 | 6311 | @subsection @code{@@file}@{@var{file-name}@} |
| 6278 | 6312 | @findex file |
| 6279 | 6313 | |
| 6280 | -ファイル、バッファ、ディレクトリの名前、あるいは、Infoにおけるノード名のテキストを示すには、@code{@@file}コマンドを使用してください。 | |
| 6314 | +ファイル、バッファ、ディレクトリの名前、Infoにおけるノード名のテキストを示すには、@code{@@file}コマンドを使用してください。 | |
| 6281 | 6315 | このコマンドをファイル名の接尾辞に使用することも出来ます。 |
| 6282 | 6316 | プログラミング言語のシンボルに対して@code{@@file}コマンドを使わないようにしてください。 |
| 6283 | 6317 | その場合@code{@@code}コマンドを使用します。 |
| @@ -6341,7 +6375,7 @@ The option @@option@{-l@} produces a long listing. | ||
| 6341 | 6375 | The option @option{-l} produces a long listing. |
| 6342 | 6376 | @end quotation |
| 6343 | 6377 | |
| 6344 | -表の中の場合、@code{@@code}コマンドの中にオプションを書くと、より満足できる効果が得られます。 | |
| 6378 | +表の中の場合、@code{@@code}コマンドの中にオプションを書くとより満足できる効果が得られます。 | |
| 6345 | 6379 | |
| 6346 | 6380 | @node dfn |
| 6347 | 6381 | @comment node-name, next, previous, up |
| @@ -6365,8 +6399,8 @@ Getting rid of a file is called @@dfn@{deleting@} it. | ||
| 6365 | 6399 | Getting rid of a file is called @dfn{deleting} it. |
| 6366 | 6400 | @end quotation |
| 6367 | 6401 | |
| 6368 | -原則として、用語を定義的に使用する一文は、その用語の定義となるはずです。 | |
| 6369 | -その一文が、定義であることを明示的に述べている必要はありませんが、定義に関する情報が入っているべきです。 | |
| 6402 | +原則として、用語を定義的に使用する一文はその用語の定義となるはずです。 | |
| 6403 | +その一文が定義であることを明示的に述べている必要はありませんが、定義に関する情報が入っているべきです。 | |
| 6370 | 6404 | つまり、その情報によって用語の意味が明確になるはずです。 |
| 6371 | 6405 | |
| 6372 | 6406 | @ignore |
| @@ -6429,7 +6463,7 @@ identify that control character: an uparrow followed by the character | ||
| 6429 | 6463 | スタイルの問題として、あるいは特定の略語について、@samp{@@abbr@{Mr@} Stallman}のように、ピリオドを省略する場合もあるでしょう。 |
| 6430 | 6464 | |
| 6431 | 6465 | @code{@@abbr}コマンドは2番目の引数を受け付けます。 |
| 6432 | -2番目の引数は省略可能で、その略語の意味を表わすのに使うことを意図したものです。 | |
| 6466 | +2番目の引数は略語の意味を表わすのに使うためのもので、省略可能です。 | |
| 6433 | 6467 | |
| 6434 | 6468 | 略語が小文字とピリオドで終了し、かつ文末でなく、2番目の引数を持たない場合、@code{@@.}コマンド(@pxref{Not Ending a Sentence})を使って正しく空白調整することを覚えておいてください。 |
| 6435 | 6469 | しかしながら、その略語自体の中で@code{@@.}コマンドを使用しなければならないわけではありません。 |
| @@ -6467,9 +6501,9 @@ Docbookでは、@code{<abbrev>}タグが使用されます。 | ||
| 6467 | 6501 | スタイルの問題として、あるいは、特定の頭字語に対して、@samp{@@acronym@{N.A.S.A.@}}のようにピリオドを使うことがあるかもしれません。 |
| 6468 | 6502 | |
| 6469 | 6503 | @code{@@acronym}コマンドは二つ目の引数を受け付けます。 |
| 6470 | -この二つ目の引数は省略可能で、その頭字語の意味を表わすために使うことを意図しています。 | |
| 6504 | +この二つ目の引数は、その頭字語の意味を表わすために使うもので、省略可能です。 | |
| 6471 | 6505 | |
| 6472 | -頭字語が文末にあって、かつ2番目の引数が無い場合、@code{@@.}コマンドや類似のコマンドを使って(@pxref{Ending a Sentence})、正しく空白調整するようにすることを覚えておいてください。 | |
| 6506 | +頭字語が文末にあって、かつ、2番目の引数が無い場合、@code{@@.}コマンドや類似のコマンドを使って(@pxref{Ending a Sentence})、正しく空白調整するようにすることを覚えておいてください。 | |
| 6473 | 6507 | |
| 6474 | 6508 | @cindex <acronym> tag |
| 6475 | 6509 | @TeX{}では、頭字語は少しだけ小さなフォントで印刷されます。 |
| @@ -6529,8 +6563,7 @@ Texinfoでは、(略語ではない)頭字語は、大文字とピリオドだ | ||
| 6529 | 6563 | |
| 6530 | 6564 | ワールドワイドウェブ(WWW)上のユニフォームリソースロケータ(URL)を示すには、@code{@@indicateurl}コマンドを使用してください。 |
| 6531 | 6565 | これは@code{@@file}コマンドや@code{@@var}コマンドなどと類似のもので、純粋にマークアップすることが目的です。 |
| 6532 | -このコマンドでは、HTML出力において辿ることの可能なリンクを生成することはありません(そういう場合は@code{@@uref}コマンドを使用してください。 | |
| 6533 | -@pxref{uref,, @code{@@uref}})。 | |
| 6566 | +このコマンドでは、HTML出力において辿ることの可能なリンクを生成することはありません(そういう場合は@code{@@uref}コマンドを使用してください(@pxref{uref,, @code{@@uref}}))。 | |
| 6534 | 6567 | このコマンドは、実際には存在しないURLに対して使用すると便利です。 |
| 6535 | 6568 | 例えば以下を見てください。 |
| 6536 | 6569 |
| @@ -6554,9 +6587,10 @@ For example, the url might be @indicateurl{http://example.org/path}. | ||
| 6554 | 6587 | また、省略可能な引数として、表示するテキスト(デフォルトではアドレスそのもの)を取ります。 |
| 6555 | 6588 | |
| 6556 | 6589 | @cindex Mailto link |
| 6557 | -Infoでは、アドレスが山括弧に括られて表示され、表示テキストが存在すれば、そのアドレスの前に出力されます。 | |
| 6558 | -@TeX{}では、山括弧は省略されます。 | |
| 6559 | -HTML出力では、@code{@@email}コマンドは、大抵はメール作成ウィンドウが開くことになる@samp{mailto}リンクを生成します。 | |
| 6590 | +Infoではアドレスが山括弧に括られて表示され、表示テキストが存在すれば、そのアドレスの前に出力されます。 | |
| 6591 | +@TeX{}では山括弧は省略されます。 | |
| 6592 | +HTML出力では@code{@@email}コマンドは@samp{mailto}リンクを生成します。 | |
| 6593 | +このリンクを使うと、大抵、メール作成ウィンドウが開きます。 | |
| 6560 | 6594 | 例えば以下を見てください。 |
| 6561 | 6595 | |
| 6562 | 6596 | @example |
| @@ -6574,12 +6608,13 @@ suggestions to the @email{bug-texinfo@@gnu.org, same place}. | ||
| 6574 | 6608 | @section テキストの強調 |
| 6575 | 6609 | @cindex Emphasizing text |
| 6576 | 6610 | |
| 6577 | -通常、Texinfoは、テキスト中の語が属すカテゴリに応じてフォントを変更し、その語に印付けします。 | |
| 6578 | -例えば@code{@@code}コマンドです。殆どの場合、こうするのが語をマークする一番良い方法です。 | |
| 6611 | +通常、Texinfoはテキスト中の語が属すカテゴリに応じてフォントを変更し、その語に印付けします。 | |
| 6612 | +例えば、@code{@@code}コマンドです。 | |
| 6613 | +ほとんどの場合、こういったコマンドを使ってマークするのがベストです。 | |
| 6579 | 6614 | しかし、カテゴリを示すことなくテキストを強調したいようなこともあるでしょう。 |
| 6580 | -Texinfoはそのためののコマンドを二つ用意しています。 | |
| 6615 | +Texinfoはそのためのコマンドを二つ用意しています。 | |
| 6581 | 6616 | また、Texinfoは、@TeX{}がテキストを組版する際に使用するフォントを指定するコマンドを複数用意しています。 |
| 6582 | -これらのコマンドは、Infoでは効果がありません。 | |
| 6617 | +これらのコマンドはInfoでは効果がありません。 | |
| 6583 | 6618 | また、これらのコマンドの一つ、@code{@@r}コマンドだけが常用されます。@refill |
| 6584 | 6619 | |
| 6585 | 6620 | @menu |
| @@ -6589,7 +6624,7 @@ Texinfoはそのためののコマンドを二つ用意しています。 | ||
| 6589 | 6624 | @end menu |
| 6590 | 6625 | |
| 6591 | 6626 | @node emph & strong |
| 6592 | -@subsection @code{@@emph}@{@var{text}@}と@code{@@strong}@{@var{text}@} | |
| 6627 | +@subsection @code{@@emph}@{@var{text}@}・@code{@@strong}@{@var{text}@} | |
| 6593 | 6628 | @cindex Emphasizing text, font for |
| 6594 | 6629 | @findex emph |
| 6595 | 6630 | @findex strong |
| @@ -6641,7 +6676,7 @@ Infoがクロスリファレンスの連携に失敗してしまいます。 | ||
| 6641 | 6676 | @cindex Small caps font |
| 6642 | 6677 | @findex sc @r{(small caps font)} |
| 6643 | 6678 | |
| 6644 | -(可能な場所では)テキストを@sc{a small caps font}に設定するには、@samp{@@sc}コマンドを使います。 | |
| 6679 | +(可能な場所で)テキストを@sc{a small caps font}に設定するには、@samp{@@sc}コマンドを使います。 | |
| 6645 | 6680 | 次のように、small capsを使用したいテキストを括弧の中に小文字で書いてください。 |
| 6646 | 6681 | |
| 6647 | 6682 | @example |
| @@ -6660,7 +6695,7 @@ Richard @sc{Stallman} founded @acronym{GNU}. | ||
| 6660 | 6695 | その出力は全く同じにはなりませんが(@code{@@acronym}コマンドはより小さなフォントで表示します。 |
| 6661 | 6696 | small capsフォントというわけではありません)、重要なのは、実際のテキストがより的確に表わされるということです。 |
| 6662 | 6697 | |
| 6663 | -また、ここで示されているように、姓は、small capitalsが望ましい場合の一つです。 | |
| 6698 | +また、ここで示されているように、姓はsmall capitalsが望ましい場合の一つです。 | |
| 6664 | 6699 | |
| 6665 | 6700 | @cindex <small> tag |
| 6666 | 6701 | @TeX{}は、@code{@@sc}コマンドの括弧の間にある大文字を全てフルサイズの大文字として植字します。 |
| @@ -6691,16 +6726,16 @@ Texinfoでは、ドキュメントの@TeX{}出力で本文のフォントサイ | ||
| 6691 | 6726 | @end example |
| 6692 | 6727 | |
| 6693 | 6728 | @cindex Printing cost, reducing |
| 6694 | -その効果は、本文のフォントを10@dmn{pt}のサイズに縮小することです(デフォルトは11@dmn{pt}です)。 | |
| 6729 | +このコマンドによって、本文のフォントが10@dmn{pt}のサイズに縮小されます(デフォルトは11@dmn{pt}です)。 | |
| 6695 | 6730 | 他の要素に対するフォント、例えばセクションや章なども、それに合わせて縮小されます。 |
| 6696 | 6731 | このコマンドは、@code{@@smallbook}コマンド(@pxref{smallbook,,Printing ``Small'' Books})や類似のコマンドと組み合わせる場合にだけ使用されます。 |
| 6697 | 6732 | 標準的な紙面(8.5x11 or A4)に10@dmn{pt}フォントで印刷するのは小さ過ぎるからです。 |
| 6698 | 6733 | このコマンドを使う理由の一つは、ページ数を抑制して、それによって物理的な本に対する印刷コストを削減することです。 |
| 6699 | 6734 | |
| 6700 | -Texinfoには、現時点では、使用するフォントファミリーを切り替えるコマンドや、もっと汎用的なサイズ変更コマンドはありません。 | |
| 6735 | +現時点では、Texinfoには、使用するフォントファミリーを切り替えるコマンドや、もっと汎用的なサイズ変更コマンドはありません。 | |
| 6701 | 6736 | |
| 6702 | 6737 | @cindex Styles, font |
| 6703 | -Texinfoはまた、印刷されたマニュアルにおけるフォントや(可能であれば)HTML出力におけるフォントを指定する数々のフォントコマンドを用意しています。 | |
| 6738 | +Texinfoはまた、印刷マニュアルにおけるフォントや(可能であれば)HTML出力におけるフォントを指定する数々のフォントコマンドを用意しています。 | |
| 6704 | 6739 | しかし、これらはInfoファイルでは効果を持ちません。 |
| 6705 | 6740 | これらのコマンドは全てコマンドに続く括弧に括られた引数に対して適用されます。 |
| 6706 | 6741 |
| @@ -6744,7 +6779,7 @@ Texinfoはまた、印刷されたマニュアルにおけるフォントや(可 | ||
| 6744 | 6779 | |
| 6745 | 6780 | @end table |
| 6746 | 6781 | |
| 6747 | -(長い名前を持つコマンドは、その他のものに比べてかなり遅く作られました。 | |
| 6782 | +長い名前を持つコマンドは、他のものに比べてかなり後になってから作られました。 | |
| 6748 | 6783 | その時点で、そのような滅多に必要とされない機能に対して非常に短かい名前を使用する価値はあまり無いように思えました。 |
| 6749 | 6784 | |
| 6750 | 6785 | @cindex <lineannotation> Docbook tag |
| @@ -6770,19 +6805,21 @@ exampleのような環境では、等幅フォントではなく、標準的な | ||
| 6770 | 6805 | @end lisp |
| 6771 | 6806 | |
| 6772 | 6807 | 一般に、これ以外のフォントコマンドを使うのは避けるべきです。 |
| 6773 | -それらのフォントコマンドの中には、@TeX{}や関連パッケージでのように、特定のフォントの効果についての機能をドキュメント化する際にだけ役に立ちます。 | |
| 6808 | +それらのフォントコマンドの中には、@TeX{}や関連パッケージでのように、特定のフォントの効果についての機能をドキュメント化する際にだけ役に立つものもあります。 | |
| 6774 | 6809 | |
| 6775 | 6810 | |
| 6776 | 6811 | @node Quotations and Examples |
| 6777 | 6812 | @chapter 引用(quotation)と例示(example) |
| 6778 | 6813 | |
| 6779 | -引用(quotation)と例示(example)は、一つ以上の完全な段落から構成されるテキストブロックで、大部分のテキストの中で強調され、異なった取り扱いがなされます。 | |
| 6814 | +引用(quotation)と例示(example)は、一つ以上の完全な段落から構成されるテキストブロックです。 | |
| 6815 | +大部分のテキストの中で強調され、異なった取り扱いがなされます。 | |
| 6780 | 6816 | 出力において、引用と例示は通常字下げされます。 |
| 6781 | 6817 | |
| 6782 | 6818 | @findex end |
| 6783 | 6819 | Texinfoでは、引用(quotation)あるいは例示(example)を開始するには、必ず行頭に単独で@@-コマンドを書きます。 |
| 6784 | -終了するには、@code{@@end}コマンドを、これも行頭に単独で書きます。 | |
| 6785 | -例えば、例示を開始するには、@code{@@example}コマンドを行頭に単独で書き、その例示を終了するには、@code{@@end example}コマンドを行頭に単独で書きます。 | |
| 6820 | +終了する場合にも、@code{@@end}コマンドを行頭に単独で書きます。 | |
| 6821 | +例えば、例示を開始するには、@code{@@example}コマンドを行頭に単独で書きます。 | |
| 6822 | +その例示を終了するには、@code{@@end example}コマンドを行頭に単独で書きます。 | |
| 6786 | 6823 | @code{@@end}と@code{example}の間にはスペースが一つだけです。 |
| 6787 | 6824 | |
| 6788 | 6825 | @menu |
| @@ -6806,44 +6843,52 @@ Texinfoでは、引用(quotation)あるいは例示(example)を開始するに | ||
| 6806 | 6843 | @node Block Enclosing Commands |
| 6807 | 6844 | @section ブロックを囲むコマンド |
| 6808 | 6845 | |
| 6809 | -続くセクションでさらに説明しますが、以下は引用(quotation)と例示(example)のためのコマンドです。 | |
| 6846 | +以下は引用(quotation)と例示(example)のためのコマンドです。 | |
| 6847 | +次節以降で詳述します。 | |
| 6810 | 6848 | |
| 6811 | 6849 | @table @code |
| 6812 | 6850 | @item @@quotation |
| 6813 | 6851 | 引用されるテキストを示します。 |
| 6814 | -テキストは追い込みや(両側から)字下げが行なわれ、デフォルトではローマンフォントで印刷されます。 | |
| 6852 | +テキストは追い込みや(両側から)字下げが行なわれます。 | |
| 6853 | +デフォルトではローマンフォントで印刷されます。 | |
| 6815 | 6854 | |
| 6816 | 6855 | @item @@example |
| 6817 | 6856 | プログラムコードやコマンドのようなものを示します。 |
| 6818 | -テキストは等幅フォントで印刷され、字下げはされますが、追い込みはされません。 | |
| 6857 | +テキストは等幅フォントで印刷されます。 | |
| 6858 | +字下げされます。 | |
| 6859 | +追い込みはされません。 | |
| 6819 | 6860 | |
| 6820 | 6861 | @item @@verbatim |
| 6821 | 6862 | 文字そのままに印刷されるテキストの一片をマークします。 |
| 6822 | 6863 | 次の@code{@@end verbatim}コマンドが来るまで、文字の置換は行なわれず、コマンドは全て無視されます。 |
| 6823 | -テキストは等幅フォントで印刷されますが、字下げも追い込みもされません。 | |
| 6864 | +テキストは等幅フォントで印刷されます。 | |
| 6865 | +字下げも追い込みもされません。 | |
| 6824 | 6866 | 余分な空白や空行も全て意味を持ち、タブ文字は展開されます。 |
| 6825 | 6867 | |
| 6826 | 6868 | @item @@smallexample |
| 6827 | 6869 | @code{@@example}コマンドと同じです。 |
| 6828 | -但し@TeX{}では、このコマンドを使うと、テキストがより小さいフォントで植字されます。 | |
| 6870 | +但し、@TeX{}ではテキストがより小さいフォントで植字されます。 | |
| 6829 | 6871 | |
| 6830 | 6872 | @item @@lisp |
| 6831 | 6873 | @code{@@example}コマンドに似ていますが、特にLispコードを示すためのものです。 |
| 6832 | -テキストは等幅フォントで表示され、字下げされますが、追い込みはされません。 | |
| 6874 | +テキストは等幅フォントで表示されます。 | |
| 6875 | +字下げされます。 | |
| 6876 | +追い込みはされません。 | |
| 6833 | 6877 | |
| 6834 | 6878 | @item @@smalllisp |
| 6835 | 6879 | @code{@@example}コマンドに対する@code{@@smallexample}コマンドと同じく、@code{@@lisp}コマンドに対するものです。 |
| 6836 | 6880 | |
| 6837 | 6881 | @item @@display |
| 6838 | 6882 | 実例的なテキストを表示します。 |
| 6839 | -テキストは字下げされますが、追い込みはされません。 | |
| 6883 | +テキストは字下げされます。 | |
| 6884 | +追い込みはされません。 | |
| 6840 | 6885 | また、フォントは選択されません(ですので、デフォルトでは、フォントはローマンフォントです)。@refill |
| 6841 | 6886 | |
| 6842 | 6887 | @item @@smalldisplay |
| 6843 | 6888 | @code{@@example}コマンドに対する@code{@@smallexample}コマンドと同じく、@code{@@display}コマンドに対するものです。 |
| 6844 | 6889 | |
| 6845 | 6890 | @item @@format |
| 6846 | -@code{@@display}コマンド(テキストは追い込みが行なわれず、フォントも選択されません)と似ていますが、テキストは字下げされません。 | |
| 6891 | +@code{@@display}コマンドと同様、追い込みが行なわれず、フォントも選択されませんが、字下げ処理は行なわれません。 | |
| 6847 | 6892 | |
| 6848 | 6893 | @item @@smallformat |
| 6849 | 6894 | @code{@@example}コマンドに対する@code{@@smallexample}コマンドと同じく、@code{@@format}コマンドに対するものです。 |
| @@ -6876,8 +6921,8 @@ quotationのテキストは、次のことを除いて、通常通り処理さ | ||
| 6876 | 6921 | @end itemize |
| 6877 | 6922 | |
| 6878 | 6923 | @quotation |
| 6879 | -これは、@code{@@quotation}コマンドと@code{@@end quotation}コマンドで挟まれて書かれたテキストの実例です。 | |
| 6880 | -@code{@@quotation}コマンドは大抵の場合、別の(実際のまたは不確定の)出版物から引用されたテキストを示すのに使用されます。 | |
| 6924 | +このテキストは、@code{@@quotation}コマンドと@code{@@end quotation}コマンドで挟まれて書かれたテキストの実例です。 | |
| 6925 | +@code{@@quotation}コマンドは大抵の場合、別の(実際の、または、不確定の)出版物から引用されたテキストを示すのに使用されます。 | |
| 6881 | 6926 | @end quotation |
| 6882 | 6927 | |
| 6883 | 6928 | @code{@@quotation}コマンドは単独行のテキストとして書いてください。 |
| @@ -6905,7 +6950,7 @@ This is | ||
| 6905 | 6950 | a foo. |
| 6906 | 6951 | @end quotation |
| 6907 | 6952 | |
| 6908 | -@code{@@quotation}コマンドの引数が、次の語の中のいずれかと正確に同じであるとします。 | |
| 6953 | +ここで、@code{@@quotation}コマンドの引数が、次の語の中のいずれかと正確に同じである場合を考えます。 | |
| 6909 | 6954 | |
| 6910 | 6955 | @example |
| 6911 | 6956 | Caution Important Note Tip Warning |
| @@ -6962,18 +7007,17 @@ cp foo @var{dest1}; \ | ||
| 6962 | 7007 | 他方、開始の@code{@@example}コマンドと終了の@code{@@end example}コマンドの中にある空行は全て出力に現われます。 |
| 6963 | 7008 | |
| 6964 | 7009 | @quotation Caution |
| 6965 | -exampleの中の行ではタブを使用しないようにしてください。 | |
| 6966 | -(あるいは、Texinfoでは、verbatim環境以外のどのような場所でもそうです。) | |
| 7010 | +exampleの中の行ではタブを使用しないようにしてください(あるいは、Texinfoでは、verbatim環境以外のどのような場所でもそうです)。 | |
| 6967 | 7011 | @TeX{}は、タブ文字をそれぞれ一つの空白として処理します。 |
| 6968 | 7012 | そしてそれはタブの見え方とは異なるものとなります。 |
| 6969 | 7013 | Emacsでは、@kbd{M-x untabify}コマンドを使って、リージョン内のタブを複数のスペースに変換することが出来ます。 |
| 6970 | 7014 | @end quotation |
| 6971 | 7015 | |
| 6972 | 7016 | 論理的に言うと、exampleは段落の「途中」であることが多いです。 |
| 6973 | -また、その後に続くテキストは、その上のexampleのように、字下げされるべきではありません。 | |
| 6974 | -@code{@@noindent}コマンドを使うと、あるテキストの断片が、新しい段落であるかのように字下げされてしまうのを抑制します(@pxref{noindent,,@code{@@noindent}})。 | |
| 7017 | +example環境に続くテキストは、その上のexample環境のようには字下げされるべきではありません。 | |
| 7018 | +@code{@@noindent}コマンドを使うと、新しい段落であるかのようにテキストを字下げしてしまうのを抑制します(@pxref{noindent,,@code{@@noindent}})。 | |
| 6975 | 7019 | |
| 6976 | -文章中にプログラムコードを埋め込みたい場合には、displayコマンドを使うのではなく、@code{@@code}コマンドか、関連コマンドを使用してください(@pxref{code,,@code{@@code}})。 | |
| 7020 | +文章中にプログラムコードを埋め込みたい場合には、displayコマンドを使うのではなく、@code{@@code}コマンドか関連コマンドを使用してください(@pxref{code,,@code{@@code}})。 | |
| 6977 | 7021 | |
| 6978 | 7022 | exampleの行に、ノーマルのローマンフォントで「コメント」を書きたい場合には、@code{@@r}コマンドを利用できます(@pxref{Fonts})。 |
| 6979 | 7023 |
| @@ -6989,8 +7033,8 @@ exampleの行に、ノーマルのローマンフォントで「コメント」 | ||
| 6989 | 7033 | |
| 6990 | 7034 | 通常、出力は入力と全く同じになります。 |
| 6991 | 7035 | 置換されてしまうような文字はありません。 |
| 6992 | -例えば、空白や空行は、タブ文字も含め、全て意味を持ちます。 | |
| 6993 | -印刷されたマニュアルでは、テキストは等幅フォントで植字され、字下げも追い込みも行なわれません。 | |
| 7036 | +例えば、空白や空行は、タブ文字も含め全て意味を持ちます。 | |
| 7037 | +印刷マニュアルでは、テキストは等幅フォントで植字され、字下げも追い込みも行なわれません。 | |
| 6994 | 7038 | |
| 6995 | 7039 | @code{@@verbatim}コマンドは、行頭に単独で記述してください。 |
| 6996 | 7040 | この行は出力には現われません。 |
| @@ -7136,9 +7180,10 @@ programs; and that you know you can do these things. | ||
| 7136 | 7180 | @findex display |
| 7137 | 7181 | |
| 7138 | 7182 | @code{@@display}コマンドはexample環境の一種を開始します。 |
| 7139 | -その中では、入力の各行が出力の行を生成し、出力は字下げされます。 | |
| 7140 | -ですので、印刷されたマニュアルで@code{@@display}環境が等幅フォントを選択しないことを除けば、このコマンドは@code{@@example}コマンドのようなものです。 | |
| 7141 | -実際、このコマンドはフォントを全く指定しませんので、@code{@@display}コマンドが無かった場合に表示されるであろうフォントと同じフォントでテキストが表示されます。 | |
| 7183 | +この環境の中では、入力されるそれぞれの行が出力の行を生成します。 | |
| 7184 | +また、出力は字下げされます。 | |
| 7185 | +印刷マニュアルでは、@code{@@display}環境が等幅フォントとならないことを除けば、このコマンドは@code{@@example}コマンドに似ています。 | |
| 7186 | +実際、このコマンドはフォントを全く指定しませんので、@code{@@display}コマンドが無かった場合に表示されるフォントと同じフォントでテキストが表示されます。 | |
| 7142 | 7187 | |
| 7143 | 7188 | @display |
| 7144 | 7189 | This is an example of text written between an @code{@@display} command |
| @@ -7154,9 +7199,9 @@ Texinfoは@code{@@smalldisplay}コマンドも用意しています。 | ||
| 7154 | 7199 | このコマンドは@code{@@display}コマンドのようなものですが、@code{@@smallbook}形式の中で小さいフォントを使用するものです。 |
| 7155 | 7200 | @xref{small}. |
| 7156 | 7201 | |
| 7157 | -@code{@@table}コマンド(@pxref{table})は@code{@@display}環境の中では機能しません。 | |
| 7202 | +@code{@@table}コマンドは@code{@@display}環境の中では機能しません(@pxref{table})。 | |
| 7158 | 7203 | @code{@@display}環境は行指向ですので、それらのコマンドを一緒に使う意味はありません。 |
| 7159 | -表を字下げしたいのであれば、@code{@@quotation}環境(@pxref{quotation})を試してみてください。 | |
| 7204 | +表を字下げしたいのであれば、@code{@@quotation}環境を試してみてください(@pxref{quotation})。 | |
| 7160 | 7205 | |
| 7161 | 7206 | |
| 7162 | 7207 | @node format |
| @@ -7164,7 +7209,8 @@ Texinfoは@code{@@smalldisplay}コマンドも用意しています。 | ||
| 7164 | 7209 | @findex format |
| 7165 | 7210 | |
| 7166 | 7211 | @code{@@format}コマンドは@code{@@example}コマンドと似ています。 |
| 7167 | -但し、@code{@@format}コマンドは、印刷されたマニュアルでは等幅フォントを選択せず、また、マージンを狭くすることがありません。 | |
| 7212 | +但し、印刷マニュアルでは等幅フォントを選択しません。 | |
| 7213 | +また、マージンを狭くすることはありません。 | |
| 7168 | 7214 | |
| 7169 | 7215 | @format |
| 7170 | 7216 | This is an example of text written between an @code{@@format} command |
| @@ -7177,7 +7223,8 @@ the @code{@@format} command does not fill the text. | ||
| 7177 | 7223 | @end format |
| 7178 | 7224 | |
| 7179 | 7225 | @findex smallformat |
| 7180 | -Texinfoは@code{@@smallformat}も提供していて、それは、@code{@@format}に似ていますが、@code{@@smallbook}書式でより小さいフォントを使用します。 | |
| 7226 | +Texinfoは@code{@@smallformat}コマンドも提供しています。 | |
| 7227 | +@code{@@format}コマンドに似ていますが、@code{@@smallbook}書式において、より小さいフォントを使用します。 | |
| 7181 | 7228 | @xref{small}. |
| 7182 | 7229 | |
| 7183 | 7230 |
| @@ -7190,7 +7237,7 @@ Texinfoは@code{@@smallformat}も提供していて、それは、@code{@@format | ||
| 7190 | 7237 | @code{@@exdent}コマンドは行が持つ字下げを全て削除します。 |
| 7191 | 7238 | このコマンドは行頭に記述し、同じ行にあるこのコマンドに続くテキストにだけ適用されます。 |
| 7192 | 7239 | テキストの前後に括弧を書かないようにしてください。 |
| 7193 | -印刷されたマニュアルでは、@code{@@exdent}コマンドの行にあるテキストはローマンフォントで印刷されます。@refill | |
| 7240 | +印刷マニュアルでは、@code{@@exdent}コマンドの行にあるテキストはローマンフォントで印刷されます。@refill | |
| 7194 | 7241 | |
| 7195 | 7242 | @code{@@exdent}コマンドは通常example環境の中で使用されます。 |
| 7196 | 7243 | ですので次のようになります。@refill |
| @@ -7289,11 +7336,11 @@ left end ragged. | ||
| 7289 | 7336 | @cindex Indentation, omitting |
| 7290 | 7337 | @findex noindent |
| 7291 | 7338 | |
| 7292 | -exampleやその他段落に入れ込まれるものは、段落を分断してしまうことになります。 | |
| 7339 | +exampleなど段落に入れ込まれるものは、その段落を分断してしまうことになります。 | |
| 7293 | 7340 | 通常、フォーマッタはexampleに続くテキストを新しい段落として字下げします。 |
| 7294 | 7341 | この動作は、その継続するテキストの前で、@code{@@noindent}コマンドを行頭に書くことによってその都度抑制することが出来ます。 |
| 7295 | 7342 | @code{@@paragraphindent}コマンドを使うと、全ての段落の字下げをグローバルに無効化することも出来ます。 |
| 7296 | -(@pxref{paragraphindent, Paragraph Indenting}). | |
| 7343 | +@xref{paragraphindent, Paragraph Indenting}. | |
| 7297 | 7344 | |
| 7298 | 7345 | ほとんどの環境の中では、コマンドに続く空白は無視されませんので、@code{@@noindent}コマンドは単独で書くのがベストです。 |
| 7299 | 7346 | どの環境の中にも無い場合は、コマンドを行頭に書いて、続けてテキストを書いてもかまいません。 |
| @@ -7337,7 +7384,7 @@ Infoファイル出力において空行の数を正しく調整するため、@ | ||
| 7337 | 7384 | |
| 7338 | 7385 | @code{@@noindent}コマンドの後ろには括弧を置かないようにしてください。 |
| 7339 | 7386 | @code{@@noindent}は段落の外で使用されるコマンドですので括弧は不要です。 |
| 7340 | -(@pxref{Command Syntax})。 | |
| 7387 | +@xref{Command Syntax}. | |
| 7341 | 7388 | |
| 7342 | 7389 | |
| 7343 | 7390 | @node indent |
| @@ -7348,7 +7395,7 @@ Infoファイル出力において空行の数を正しく調整するため、@ | ||
| 7348 | 7395 | @findex indent |
| 7349 | 7396 | |
| 7350 | 7397 | @indent |
| 7351 | -@code{@@noindent}コマンドを補完するため(前セクションを参照)、Texinfoは段落を強制的に字下げする@code{@@indent}コマンドを用意しています。 | |
| 7398 | +@code{@@noindent}コマンドを補完するため(前節参照)、Texinfoは段落を強制的に字下げする@code{@@indent}コマンドを用意しています。 | |
| 7352 | 7399 | 例えば、この段落は@code{@@indent}コマンドを使って字下げされています。 |
| 7353 | 7400 | セクションの最初の段落は@code{@@indent}コマンドを使うのに最も相応しい場所です。 |
| 7354 | 7401 | そこでは字下げが行なわれないという通常の動作をオーバーライドすることになります。 |
| @@ -7363,12 +7410,12 @@ Info出力において、環境の中では@code{@@indent}コマンドの行が | ||
| 7363 | 7410 | |
| 7364 | 7411 | |
| 7365 | 7412 | @node cartouche |
| 7366 | -@section @code{@@cartouche}: (カルトゥーシュ)example周囲の丸みを帯びた矩形 | |
| 7413 | +@section @code{@@cartouche}: example周囲の丸みを帯びた矩形 | |
| 7367 | 7414 | @findex cartouche |
| 7368 | 7415 | @cindex Box with rounded corners |
| 7369 | 7416 | @cindex Rounded rectangles, around examples |
| 7370 | 7417 | |
| 7371 | -印刷されるマニュアルでは、@code{@@cartouche}コマンドは、角が丸みを帯びた枠を描いて、その内容を囲みます。 | |
| 7418 | +印刷されるマニュアルでは、@code{@@cartouche}(カルトゥーシュ)コマンドは、角が丸みを帯びた枠を描いて、その内容を囲みます。 | |
| 7372 | 7419 | HTMLでは、通常の矩形が描かれます(HTMLで最大限可能なことです)。 |
| 7373 | 7420 | @code{@@cartouche}コマンドはInfo出力には影響しません。 |
| 7374 | 7421 |
| @@ -7412,7 +7459,7 @@ HTMLで正しく出力するには、@code{@@example}環境の周りに@code{@@c | ||
| 7412 | 7459 | |
| 7413 | 7460 | Texinfoにはリストと表を作成する方法がいくつかあります。 |
| 7414 | 7461 | リストは黒丸または番号が付きます。 |
| 7415 | -二列の表は、最初の列の項目が強調されます。 | |
| 7462 | +二列の表は最初の列の項目が強調されます。 | |
| 7416 | 7463 | 複数列の表もサポートされています。 |
| 7417 | 7464 | |
| 7418 | 7465 | @menu |
| @@ -7427,13 +7474,17 @@ Texinfoにはリストと表を作成する方法がいくつかあります。 | ||
| 7427 | 7474 | @section Introducing Lists |
| 7428 | 7475 | |
| 7429 | 7476 | Texinfoは、リストや表のテキストの字下げや、列挙リストの番号付けを自動的に行ないます。 |
| 7430 | -この番号付けの機能は、自分で番号を振り直す必要がありませんので、リストを修正する場合に便利です。@refill | |
| 7477 | +自分で番号を振り直す必要がありませんので、リストを修正する場合に便利です。@refill | |
| 7431 | 7478 | |
| 7432 | -番号付きリストと表は、行頭に適切な@@-コマンドを記述することで開始し、対応する@code{@@end}コマンドを単独で書くことによって終了します。 | |
| 7479 | +番号付きリストと表は、行頭に適切な@@-コマンドを記述することで開始します。 | |
| 7480 | +対応する@code{@@end}コマンドを単独で書いて終了します。 | |
| 7433 | 7481 | 表のコマンドとitemizeリストのコマンドでは、開始の@@-コマンドと同じ行に、書式化のための情報を記述する必要があります。@refill |
| 7434 | 7482 | |
| 7435 | -例えば、列挙リストを開始するには、@code{@@enumerate}コマンドを使い、リストを終了するには、@code{@@end enumerate}コマンドを使ってください。 | |
| 7436 | -itemizeリストを開始するには、@code{@@itemize}コマンドを使い、@code{@@bullet}のような書式化コマンドを同じ行に記述して、また、@code{@@end itemize}コマンドを使って、そのリストを終了させます。@refill | |
| 7483 | +例えば、列挙リストを開始するには、@code{@@enumerate}コマンドを使います。 | |
| 7484 | +このリストを終了するには、@code{@@end enumerate}コマンドを使ってください。 | |
| 7485 | +itemizeリストを開始するには、@code{@@itemize}コマンドを使います。 | |
| 7486 | +このコマンドの同じ行に、@code{@@bullet}のような書式化コマンドを記述します。 | |
| 7487 | +@code{@@end itemize}コマンドを使って、そのリストを終了させます。@refill | |
| 7437 | 7488 | @findex end |
| 7438 | 7489 | |
| 7439 | 7490 | リストの各要素の前には、@code{@@item}コマンドや@code{@@itemx}コマンドを置きます。@refill |
| @@ -7444,13 +7495,13 @@ itemizeリストを開始するには、@code{@@itemize}コマンドを使い、 | ||
| 7444 | 7495 | |
| 7445 | 7496 | @itemize @bullet |
| 7446 | 7497 | @item |
| 7447 | -黒点有りと無しのitemizeリスト。 | |
| 7498 | +黒点有りと無しのitemizeリスト | |
| 7448 | 7499 | |
| 7449 | 7500 | @item |
| 7450 | -番号や文字を使用した列挙(enumerate)リスト。 | |
| 7501 | +番号や文字を使用した列挙(enumerate)リスト | |
| 7451 | 7502 | |
| 7452 | 7503 | @item |
| 7453 | -強調のある二列の表。 | |
| 7504 | +強調のある2列の表 | |
| 7454 | 7505 | @end itemize |
| 7455 | 7506 | |
| 7456 | 7507 | @sp 1 |
| @@ -7459,18 +7510,18 @@ itemizeリストを開始するには、@code{@@itemize}コマンドを使い、 | ||
| 7459 | 7510 | |
| 7460 | 7511 | @enumerate |
| 7461 | 7512 | @item |
| 7462 | -黒点有りと無しのitemizeリスト。 | |
| 7513 | +黒点有りと無しのitemizeリスト | |
| 7463 | 7514 | |
| 7464 | 7515 | @item |
| 7465 | -番号や文字を使用した列挙(enumerate)リスト。 | |
| 7516 | +番号や文字を使用した列挙(enumerate)リスト | |
| 7466 | 7517 | |
| 7467 | 7518 | @item |
| 7468 | -強調のある二列の表。 | |
| 7519 | +強調のある2列の表 | |
| 7469 | 7520 | @end enumerate |
| 7470 | 7521 | |
| 7471 | 7522 | @sp 1 |
| 7472 | 7523 | @noindent |
| 7473 | -そして、同じ項目とその@w{@@-コマンド}の二列の表は以下のようになります。 | |
| 7524 | +そして、同じ項目とその@w{@@-コマンド}の2列の表は以下のようになります。 | |
| 7474 | 7525 | @refill |
| 7475 | 7526 | |
| 7476 | 7527 | @table @code |
| @@ -7483,7 +7534,7 @@ itemizeリストを開始するには、@code{@@itemize}コマンドを使い、 | ||
| 7483 | 7534 | @item @@table |
| 7484 | 7535 | @itemx @@ftable |
| 7485 | 7536 | @itemx @@vtable |
| 7486 | -強調のある二列の表。 | |
| 7537 | +強調のある2列の表。 | |
| 7487 | 7538 | 索引化も可能。 |
| 7488 | 7539 | @end table |
| 7489 | 7540 |
| @@ -7493,15 +7544,16 @@ itemizeリストを開始するには、@code{@@itemize}コマンドを使い、 | ||
| 7493 | 7544 | @cindex Itemization |
| 7494 | 7545 | @findex itemize |
| 7495 | 7546 | |
| 7496 | -@code{@@itemize}コマンドは字下げされた段落の並びを生成するもので、マークが必要な各段落の冒頭では、左マージンの中に黒丸やその他のマークを付けます。 | |
| 7547 | +@code{@@itemize}コマンドは字下げされた段落の並びを生成するものです。 | |
| 7548 | +マークが必要な各段落の冒頭では、左マージンの中に黒丸やその他のマークが付けられます。 | |
| 7497 | 7549 | @refill |
| 7498 | 7550 | |
| 7499 | 7551 | @cindex @code{@@w}, for blank items |
| 7500 | 7552 | itemizeリストを開始するには、行頭に@code{@@itemize}コマンドを記述します。 |
| 7501 | -コマンドの続けて同じ行に、文字を一つ、あるいはマークを生成するTexinfoのコマンドを一つ書きます。 | |
| 7553 | +コマンドに続けて同じ行に、文字を一つ、あるいはマークを生成するTexinfoのコマンドを一つ書きます。 | |
| 7502 | 7554 | 通常@code{@@itemize}コマンドの後には@code{@@bullet}コマンドを書きますが、@code{@@minus}コマンドや、Infoファイルの中で最終的に一文字となるようなコマンドや文字を何でも書くことができます。 |
| 7503 | 7555 | マークを全く付けたくないのでしたら、@code{@@w}コマンドを使用してください。 |
| 7504 | -(@code{@@itemize}コマンドの後ろに@code{@@bullet}のようなマークコマンドを書く際には、@samp{@{@}}を省略することが出来ます。) | |
| 7556 | +@code{@@itemize}コマンドの後ろに@code{@@bullet}のようなマークコマンドを書く際には、@samp{@{@}}を省略することが出来ます。 | |
| 7505 | 7557 | マークコマンドを指定しなければ、デフォルトは@code{@@bullet}コマンドになります。 |
| 7506 | 7558 | |
| 7507 | 7559 | @code{@@itemize}コマンドの後には、@code{@@end itemize}と記述された行に至るまで、字下げされる段落自体のテキストを記述してください。@refill |
| @@ -7511,8 +7563,7 @@ itemizeリストを開始するには、行頭に@code{@@itemize}コマンドを | ||
| 7511 | 7563 | その@code{@@item}コマンドの後ろにテキストが続いてもかまいません。 |
| 7512 | 7564 | |
| 7513 | 7565 | 通常、@code{@@item}コマンドの前には空行を置くべきです。 |
| 7514 | -こうすることによって、Infoファイルでも空行が置かれることになります。 | |
| 7515 | -(@TeX{}は、どちらにしても行間の空白を適切に挿入します。) | |
| 7566 | +こうすることによって、Infoファイルでも空行が置かれることになります(@TeX{}は、どちらにしても行間の空白を適切に挿入します)。 | |
| 7516 | 7567 | 各エントリが極端に短かい場合を除けば、空行があるほうがリストの見た目が良くなります。@refill |
| 7517 | 7568 | |
| 7518 | 7569 | 以下は、@code{@@itemize}コマンドを使用した例です。 |
| @@ -7600,15 +7651,16 @@ Second outer item. | ||
| 7600 | 7651 | |
| 7601 | 7652 | @code{@@enumerate}コマンドは行頭に書いてください。 |
| 7602 | 7653 | このコマンドは引数を必須としませんが、オプションとして数字か文字のどちらかを受け付けます。 |
| 7603 | -引数が指定されない場合、@code{@@enumerate}コマンドは、番号@samp{1}からリストを開始します。 | |
| 7604 | -例えば@samp{3}のような数値の引数を付けると、@code{@@enumerate}コマンドはその数字からリストを開始します。 | |
| 7605 | -例えば、@samp{a}や@samp{A}のように、大文字もしくは小文字の引数を付けた場合、@code{@@enumerate}コマンドはその文字からリストを開始します。 | |
| 7654 | +引数が指定されない場合、番号@samp{1}からリストを開始します。 | |
| 7655 | +例えば、@samp{3}のような数値の引数を付けると、その数字からリストを開始します。 | |
| 7656 | +例えば、@samp{a}や@samp{A}のように、大文字もしくは小文字の引数を付けた場合、その文字からリストを開始します。 | |
| 7606 | 7657 | |
| 7607 | 7658 | enumerateリストのテキストはitemizeリストの場合と同じ方法で記述してください。 |
| 7608 | -列挙したい各段落の冒頭で@code{@@item}コマンドで始まる行を書きます。 | |
| 7659 | +列挙したい各段落の冒頭に@code{@@item}コマンドで始まる行を書きます。 | |
| 7609 | 7660 | @code{@@item}の後ろにテキストを続けて書いても構いません。 |
| 7610 | 7661 | |
| 7611 | -リストの各エントリの間には空行を置くべきです。こうすることで、通常、Infoファイルが読み易くなります。 | |
| 7662 | +リストの各エントリの間には空行を置くべきです。 | |
| 7663 | +通常は、こうすることでInfoファイルが読み易くなります。 | |
| 7612 | 7664 | |
| 7613 | 7665 | @need 1500 |
| 7614 | 7666 | 以下は、引数を付けない@code{@@enumerate}コマンドの例です。 |
| @@ -7698,12 +7750,13 @@ Perpetuating causes. | ||
| 7698 | 7750 | アウトラインのように、enumerateリストを入れ子にすることも可能です。 |
| 7699 | 7751 | |
| 7700 | 7752 | @node Two-column Tables |
| 7701 | -@section 二列の表の作成 | |
| 7753 | +@section 2列の表の作成 | |
| 7702 | 7754 | @cindex Tables, making two-column |
| 7703 | 7755 | @findex table |
| 7704 | 7756 | |
| 7705 | 7757 | @code{@@table}コマンドは@code{@@itemize}コマンド(@pxref{itemize,,@code{@@itemize}})と似ていますが、各項目に対して名前や見出しの行を指定することが可能です。 |
| 7706 | -@code{@@table}コマンドは2列の表を生成するのに使用され、特に、用語集や説明表示、コマンドラインオプションの概要などを記述するのに便利です。 | |
| 7758 | +2列の表を生成するのに使用されます。 | |
| 7759 | +特に、用語集や説明表示、コマンドラインオプションの概要などを記述するのに便利です。 | |
| 7707 | 7760 | |
| 7708 | 7761 | @menu |
| 7709 | 7762 | * table:: How to construct a two-column table. |
| @@ -7727,7 +7780,8 @@ Perpetuating causes. | ||
| 7727 | 7780 | |
| 7728 | 7781 | @findex asis |
| 7729 | 7782 | @code{@@table}コマンドの引数として@code{@@asis}コマンドを使用することも出来ます。 |
| 7730 | -@code{@@asis}コマンドは何もしないコマンドです。このコマンドを@code{@@table}コマンドの後に記述した場合、第一カラムのエントリは強調が加えられることなく出力されます(``as is'')。 | |
| 7783 | +@code{@@asis}コマンドは何もしないコマンドです。 | |
| 7784 | +このコマンドを@code{@@table}コマンドの後に記述した場合、第1カラムのエントリは強調が加えられることなく出力されます(「as is」)。 | |
| 7731 | 7785 | |
| 7732 | 7786 | @code{@@table}コマンドは、ここで明示的に述べたコマンドに加え、他のコマンドと一緒に使用することが出来ます。 |
| 7733 | 7787 | しかし、使用できるのは通常は括弧の中に引数を取るコマンドだけです。 |
| @@ -7735,13 +7789,11 @@ Perpetuating causes. | ||
| 7735 | 7789 | |
| 7736 | 7790 | @findex item |
| 7737 | 7791 | 行頭に@code{@@item}コマンドを書いて、表の各エントリを開始します。 |
| 7738 | -第一カラムのテキストは@code{@@item}コマンドと同じ行に記述してください。 | |
| 7739 | -第二カラムのテキストは@code{@@item}コマンドの行に続く行とそれ以降の行に書きま | |
| 7740 | -す。 | |
| 7741 | -(第二カラムのエントリが空の場合は何も入力する必要はありません。) | |
| 7792 | +第1カラムのテキストは@code{@@item}コマンドと同じ行に記述してください。 | |
| 7793 | +第2カラムのテキストは@code{@@item}コマンドの行の次の行以降に記述します(第2カラムのエントリが空の場合は何も入力する必要はありません)。 | |
| 7742 | 7794 | サポートテキストは好きな行数だけ書くことが出来ます。 |
| 7743 | 7795 | 複数の段落があっても構いません。 |
| 7744 | -しかし、@code{@@item}コマンドと同じ行にあるテキストだけが、第一カラムに配置されます(脚注も全て含まれます)。 | |
| 7796 | +しかし、@code{@@item}コマンドと同じ行にあるテキストだけが、第1カラムに配置されます(脚注も全て含まれます)。 | |
| 7745 | 7797 | |
| 7746 | 7798 | 通常、@code{@@item}コマンドの行の前に空行を置くべきです。 |
| 7747 | 7799 | こうすることで、Infoファイルに空行が入ります。 |
| @@ -7779,40 +7831,42 @@ Text for @samp{bar}. | ||
| 7779 | 7831 | @end table |
| 7780 | 7832 | |
| 7781 | 7833 | 二つ以上の名前を持つ項目を、一つのテキストブロックでリストにしたい場合には、@code{@@itemx}コマンドを使用してください。 |
| 7782 | -(@xref{itemx,,@code{@@itemx}}.) | |
| 7834 | +@xref{itemx,,@code{@@itemx}}. | |
| 7783 | 7835 | |
| 7784 | 7836 | |
| 7785 | 7837 | @node ftable vtable |
| 7786 | -@subsection @code{@@ftable}と@code{@@vtable} | |
| 7838 | +@subsection @code{@@ftable}・@code{@@vtable} | |
| 7787 | 7839 | @cindex Tables with indexes |
| 7788 | 7840 | @cindex Indexing table entries automatically |
| 7789 | 7841 | @findex ftable |
| 7790 | 7842 | @findex vtable |
| 7791 | 7843 | |
| 7792 | -@code{@@ftable}コマンドと@code{@@vtable}コマンドは@code{@@table}コマンドと同じですが、但し、@code{@@ftable}コマンドが、表の第一カラムの各項目を関数索引の中に自動的に入れ、@code{@@vtable}コマンドが、表の第一カラムの各項目を変数索引に自動的に入れるというところが異なります。 | |
| 7844 | +@code{@@ftable}コマンドと@code{@@vtable}コマンドは@code{@@table}コマンドと同じです。 | |
| 7845 | +但し、@code{@@ftable}コマンドは、表の第1カラムの各項目を関数索引の中に自動的に入れます。 | |
| 7846 | +また、@code{@@vtable}コマンドは、表の第1カラムの各項目を変数索引に自動的に入れます。 | |
| 7793 | 7847 | これによって、索引を作成する作業が簡単になります。 |
| 7794 | 7848 | @code{@@item}コマンドと同じ行の項目だけが、その行に表われる形式と全く同様にインデックスされます。 |
| 7795 | -索引については、@xref{Indices}.@refill | |
| 7849 | +索引については別の節を参照してください(@pxref{Indices})。@refill | |
| 7796 | 7850 | |
| 7797 | 7851 | @code{@@ftable}コマンドや@code{@@vtable}コマンドを使って2列の表を開始するには、行頭に@@-コマンドを記述してください。 |
| 7798 | 7852 | 続けて同じ行に、@code{@@code}コマンドのようなTexinfoコマンドを引数として書きます。 |
| 7799 | 7853 | これは@code{@@table}コマンドに対して行なうのと全く同じです。 |
| 7800 | 7854 | そして、その表を終了させるには、@code{@@end ftable}コマンドや@code{@@end vtable}コマンドを単独で記述します。 |
| 7801 | 7855 | |
| 7802 | -前のセクションの@code{@@table}の例を参照してください。 | |
| 7856 | +前節の@code{@@table}の例を参照してください。 | |
| 7803 | 7857 | |
| 7804 | 7858 | @node itemx |
| 7805 | 7859 | @subsection @code{@@itemx} |
| 7806 | 7860 | @cindex Two named items for @code{@@table} |
| 7807 | 7861 | @findex itemx |
| 7808 | 7862 | |
| 7809 | -それぞれ単独行に表示される第一カラムのエントリが、同じ項目に対して二つ以上あるような場合は、tableの中で@code{@@itemx}コマンドを使用してください。 | |
| 7863 | +それぞれ単独行に表示される第1カラムのエントリが、同じ項目に対して二つ以上あるような場合は、tableの中で@code{@@itemx}コマンドを使用してください。 | |
| 7810 | 7864 | |
| 7811 | 7865 | 最初のエントリについては@code{@@item}コマンドを使用し、続く残りのエントリに対しては全て@code{@@itemx}コマンドを使用してください。 |
| 7812 | 7866 | @code{@@itemx}は必ず@code{@@item}コマンドに続けなければなりません。 |
| 7813 | 7867 | 間には空行を入れません。 |
| 7814 | 7868 | |
| 7815 | -@code{@@itemx}コマンドは、第一カラムの上に縦方向の余分なスペースを生成しないことを除けば@code{@@item}コマンドと全く同じです。 | |
| 7869 | +@code{@@itemx}コマンドは、第1カラムの上に縦方向の余分なスペースを生成しないことを除けば@code{@@item}コマンドと全く同じです。 | |
| 7816 | 7870 | 連続する@code{@@itemx}コマンドが複数ある場合は、それらの間に空行を挿入しないようにしてください。 |
| 7817 | 7871 | |
| 7818 | 7872 | 例えば、以下のようにします。 |
| @@ -7841,7 +7895,7 @@ case) character or string.@refill | ||
| 7841 | 7895 | @end table |
| 7842 | 7896 | |
| 7843 | 7897 | @noindent |
| 7844 | -(この例では、2列の表における複数行のサポートテキストについて説明していることにも注意してください。)@refill | |
| 7898 | +この例では、2列の表における複数行のサポートテキストについて説明していることにも注意してください。@refill | |
| 7845 | 7899 | |
| 7846 | 7900 | |
| 7847 | 7901 | @node Multi-column Tables |
| @@ -7852,10 +7906,11 @@ case) character or string.@refill | ||
| 7852 | 7906 | @code{@@multitable}コマンドを使うと、いくつもの列を持った表を作成することが出来ます。 |
| 7853 | 7907 | 各列には好きな幅を持たせることが出来ます。 |
| 7854 | 7908 | |
| 7855 | -列の幅は@code{@@multitable}コマンドの行自体で定義し、@code{@@item}コマンドに続けて実際の各行を記述します。 | |
| 7856 | -その際各列は@code{@@tab}コマンドを使って分割します。 | |
| 7909 | +列の幅は@code{@@multitable}コマンドの行自体で定義します。 | |
| 7910 | +実際の各行は、@code{@@item}コマンドに続けて記述します。 | |
| 7911 | +その際、各列は@code{@@tab}コマンドを使って分割します。 | |
| 7857 | 7912 | 最後に、@code{@@end multitable}コマンドで表を終了します。 |
| 7858 | -詳細は次のセクションを見てください。 | |
| 7913 | +詳細は次節を見てください。 | |
| 7859 | 7914 | |
| 7860 | 7915 | @menu |
| 7861 | 7916 | * Multitable Column Widths:: Defining multitable column widths. |
| @@ -7863,13 +7918,13 @@ case) character or string.@refill | ||
| 7863 | 7918 | @end menu |
| 7864 | 7919 | |
| 7865 | 7920 | @node Multitable Column Widths |
| 7866 | -@subsection 複数列の表の幅 | |
| 7921 | +@subsection マルチカラムの表の幅 | |
| 7867 | 7922 | @cindex Multitable column widths |
| 7868 | 7923 | @cindex Column widths, defining for multitables |
| 7869 | 7924 | @cindex Widths, defining multitable column |
| 7870 | 7925 | |
| 7871 | 7926 | 複数列の表のカラム幅は二通りの方法で定義できます。 |
| 7872 | -一つは行長に対する割合で指定する方法、もう一つは、プロトタイプ行を使用する方法です。 | |
| 7927 | +一つは行長に対する割合で指定する方法で、もう一つは、プロトタイプ行を使用する方法です。 | |
| 7873 | 7928 | この二つの方法を混用することはサポートしていません。 |
| 7874 | 7929 | どちらの場合も、@code{@@multitable}コマンドと同じ行に全て定義します。 |
| 7875 | 7930 |
| @@ -7877,8 +7932,9 @@ case) character or string.@refill | ||
| 7877 | 7932 | @item |
| 7878 | 7933 | @findex columnfractions |
| 7879 | 7934 | @cindex Line length, column widths as fraction of |
| 7880 | -行長に対する割合としてカラム幅を指定するには、@code{@@columnfractions}コマンドと10進数(当然1より小さい。 | |
| 7881 | -先行する0は書いても良いですが無視されます)を、@code{@@multitable}コマンドの後に書いてください。 | |
| 7935 | +行長に対する割合としてカラム幅を指定するには、@code{@@multitable}コマンドの後ろに、@code{@@columnfractions}コマンドと10進数を記述してください。 | |
| 7936 | +当然、この10進数は1より小さいものです。 | |
| 7937 | +先行する0は書いても構いませんが、無視されます。 | |
| 7882 | 7938 | 次のようになります。 |
| 7883 | 7939 | |
| 7884 | 7940 | @example |
| @@ -7909,13 +7965,13 @@ case) character or string.@refill | ||
| 7909 | 7965 | |
| 7910 | 7966 | |
| 7911 | 7967 | @node Multitable Rows |
| 7912 | -@subsection 複数カラムの表の行 | |
| 7968 | +@subsection マルチカラムの表の行 | |
| 7913 | 7969 | @cindex Multitable rows |
| 7914 | 7970 | @cindex Rows, of a multitable |
| 7915 | 7971 | |
| 7916 | 7972 | @findex item |
| 7917 | 7973 | @findex tab |
| 7918 | -カラム幅(前節を参照)を定義する@code{@@multitable}コマンドの後、@code{@@item}コマンドを使ってmultitableの本体の各行を開始します。 | |
| 7974 | +カラム幅(前節参照)を定義する@code{@@multitable}コマンドの後、@code{@@item}コマンドを使ってmultitableの本体の各行を開始します。 | |
| 7919 | 7975 | その際、カラムのエントリは@code{@@tab}コマンドを使って分割します。 |
| 7920 | 7976 | 改行は表の本体では特別な意味を持たず、必要に応じてソースファイルの入力行に改行を入れることが出来ます。 |
| 7921 | 7977 |
| @@ -7926,7 +7982,7 @@ case) character or string.@refill | ||
| 7926 | 7982 | そういう行の@TeX{}の出力はboldフォントとなり、HTMLやXML、Docbookの出力では@code{<thead>}タグが使用されます。 |
| 7927 | 7983 | Infoでは、見出し行に続けてダッシュ(@samp{-}文字)で出来た分割線が入れられます。 |
| 7928 | 7984 | |
| 7929 | -以下は、複数カラムの表の完全な例です(このテキストは@cite{The GNU Emacs Manual}のものです@pxref{Split Window,, Splitting Windows, emacs, The GNU Emacs Manual})。 | |
| 7985 | +以下は、複数カラムの表の完全な例です(このテキストは@cite{The GNU Emacs Manual}のものです(@pxref{Split Window,, Splitting Windows, emacs, The GNU Emacs Manual}))。 | |
| 7930 | 7986 | |
| 7931 | 7987 | @example |
| 7932 | 7988 | @@multitable @@columnfractions .15 .45 .4 |
| @@ -7972,7 +8028,8 @@ split that window. | ||
| 7972 | 8028 | この章で紹介するコマンドは、通常のドキュメントの流れから離れて、特別に表示されるテキストを書けるようにするものです。 |
| 7973 | 8029 | |
| 7974 | 8030 | そういうコマンドのセットの一つは、「フロート」を作成するものです。 |
| 7975 | -フロートとは即ち図表などのことで、本文とは区切られていて、番号やキャプションを付けることが可能で、ドキュメントの他の部分から参照されることがあります。 | |
| 8031 | +フロートとは即ち図表などのことで、本文とは区切られています。 | |
| 8032 | +番号やキャプションを付けることが可能で、ドキュメントの他の部分から参照されることがあります。 | |
| 7976 | 8033 | 画像はこの表示に含めることが多いです。 |
| 7977 | 8034 | |
| 7978 | 8035 | もう一つのコマンドグループはTexinfoに脚注を作成するものです。 |
| @@ -7992,10 +8049,9 @@ split that window. | ||
| 7992 | 8049 | 通常は「Figure」「Table」「Example」あるいは同様な種類のラベルが付けられます。 |
| 7993 | 8050 | |
| 7994 | 8051 | @cindex Floating, not yet implemented |
| 7995 | -フロートは、印刷出力において、原則として、現在のページの上部や下部、あるいは次のページに移動することがあるということからその名前が付けられています。 | |
| 7996 | -(他の出力フォーマットではフロートさせる意味がありません。) | |
| 7997 | -しかしながら、Texinfoの現在のバージョンでは、このフロート機能は残念ながらまだ実装されていません。 | |
| 7998 | -そういう動作の代わりに、フロートの素材は、おおよそ@code{@@group}コマンドのように、現在位置に単に出力されます(@pxref{group,,@code{@@group}})。 | |
| 8052 | +フロートは、印刷出力において、原則として、現在のページの上部や下部、あるいは次のページに移動することがあるということからその名前が付けられています(他の出力フォーマットではフロートさせる意味がありません)。 | |
| 8053 | +残念ながら、Texinfoの現在のバージョンでは、このフロート機能はまだ実装されていません。 | |
| 8054 | +そういう動作の代わりに、フロートの素材は、おおよそ@code{@@group}コマンドのように、単純に現在位置に出力されます(@pxref{group,,@code{@@group}})。 | |
| 7999 | 8055 | |
| 8000 | 8056 | @menu |
| 8001 | 8057 | * float:: Producing floating material. |
| @@ -8011,7 +8067,7 @@ split that window. | ||
| 8011 | 8067 | |
| 8012 | 8068 | フロート素材を作るには、表示したい素材を、単独で別々に書いた@code{@@float}コマンドと@code{@@end float}コマンドで囲んでください。 |
| 8013 | 8069 | |
| 8014 | -フロート素材は、既存の図(@pxref{Images})を表示するのに@code{@@image}コマンドを使用し、表(@pxref{Multi-column Tables})を表示するのに@code{@@multitable}コマンドを使用します。 | |
| 8070 | +フロート素材では、既存の図(@pxref{Images})を表示する場合、@code{@@image}コマンドを使用し、表(@pxref{Multi-column Tables})を表示する場合、@code{@@multitable}コマンドを使用します。 | |
| 8015 | 8071 | しかし、フロートする内容は何でも構いません。 |
| 8016 | 8072 | 以下は単純なテキストを表示する例です。 |
| 8017 | 8073 |
| @@ -8039,12 +8095,13 @@ This is an example float. | ||
| 8039 | 8095 | |
| 8040 | 8096 | @item label |
| 8041 | 8097 | このフロートに対するクロスリファレンスのラベルを指定します。 |
| 8042 | -この引数が指定されると、このフロートは自動的に番号が振られ、@code{@@listoffloats}(@pxref{listoffloats})の出力に現われるようになります。 | |
| 8098 | +この引数が指定されると、このフロートは自動的に番号が振られ、@code{@@listoffloats} (@pxref{listoffloats})の出力に現われるようになります。 | |
| 8043 | 8099 | @var{label}へのクロスリファレンスは可能です。 |
| 8044 | 8100 | |
| 8045 | 8101 | @cindex Floats, making unnumbered |
| 8046 | 8102 | @cindex Unnumbered float, creating |
| 8047 | -反対に@var{label}が指定されない場合、フロートには番号が振られず、その結果、@code{@@listoffloats}の出力に現われなかったり、クロスリファレンスで使用できなかったりします。 | |
| 8103 | +反対に、@var{label}が指定されない場合、フロートには番号が振られません。 | |
| 8104 | +その結果、@code{@@listoffloats}の出力に現われなかったり、クロスリファレンスで使用できなかったりします。 | |
| 8048 | 8105 | @end table |
| 8049 | 8106 | |
| 8050 | 8107 | @noindent 通常は、ラベルが付けられ、番号の振られたフロートにするため、@var{type}と@var{label}の両方を指定します。 |
| @@ -8219,8 +8276,7 @@ pdf@TeX{}は@file{@var{filename}.png}あるいは@file{@var{filename}.jpg}、@fi | ||
| 8219 | 8276 | HTML出力では、@code{@@image}コマンドに対する省略可能な4番目の引数@var{alttext}が指定されていれば、@code{makeinfo}は、この引数をインライン画像の@dfn{ALT属性}に設定します。 |
| 8220 | 8277 | 引数が指定されていなければ、@code{makeinfo}は、表示される画像の完全なファイル名を使用します。 |
| 8221 | 8278 | @var{alttext}はTexinfoのテキストとして解釈されますので、例えば@samp{"}や@samp{<}、@samp{&}のような特殊な文字は、HTMLやXMLの出力ではエスケープされます。 |
| 8222 | -また、@code{alt}の文字列を空にしたい場合には、@code{@@-}コマンドを使うことで可能です(このコマンドは何も出力しないコマンドです。 | |
| 8223 | -@pxref{- and hyphenation})。 | |
| 8279 | +また、@code{alt}の文字列を空にしたい場合には、@code{@@-}コマンドを使うことで可能です(このコマンドは何も出力しないコマンドです(@pxref{- and hyphenation}))。 | |
| 8224 | 8280 | |
| 8225 | 8281 | Info出力では、@code{alt}文字列もTexinfoテキストとして処理され、出力されます。 |
| 8226 | 8282 | この場合、@samp{\}は@samp{\\}とエスケープされ、@samp{"}は@samp{\"}とエスケープされます。 |
| @@ -8328,10 +8384,9 @@ HTMLやその他の出力では実装されていません。 | ||
| 8328 | 8384 | @cindex Footnotes |
| 8329 | 8385 | @findex footnote |
| 8330 | 8386 | |
| 8331 | -@dfn{脚注}は、本文に注釈を付けたり、本文を明確にする際に参照されるものです。 | |
| 8332 | -@footnote{脚注は本文を補足したり、詳述したりするものですが、読者が本文を理解するために読まなければならないものであってはなりません。 | |
| 8387 | +@dfn{脚注}は、本文に注釈を付けたり、本文を明確にする際に参照されるものです@footnote{脚注は本文を補足したり、詳述したりするものですが、読者が本文を理解するために読まなければならないものであってはなりません。 | |
| 8333 | 8388 | 脚注に関する深い議論は@cite{The Chicago Manual of Style}を参照してください。 |
| 8334 | -これはthe University of Chicago Pressから出版されています。} | |
| 8389 | +これはthe University of Chicago Pressから出版されています。}。 | |
| 8335 | 8390 | 脚注は気が散るものです。 |
| 8336 | 8391 | 使う場合には慎重に使うようにしてください。 |
| 8337 | 8392 | 普通であれば、参考文献への参照は、始めから終わりまで脚注を使用するよりも、ドキュメントの最後に参考文献目録を配置するほうが良いです。 |
| @@ -8345,7 +8400,7 @@ HTMLやその他の出力では実装されていません。 | ||
| 8345 | 8400 | @node Footnote Commands |
| 8346 | 8401 | @subsection 脚注コマンド |
| 8347 | 8402 | |
| 8348 | -Texinfoでは、脚注は@code{@@footnote}コマンドで作成します。 | |
| 8403 | +脚注は@code{@@footnote}コマンドで作成します。 | |
| 8349 | 8404 | このコマンドの直後には左括弧を書き、続けて脚注のテキスト、そして脚注を終了するための右括弧を書きます。 |
| 8350 | 8405 | 脚注はどのような長さになっても構いません(必要なら複数のページに渡って分割されます)が、通常は短かいものです。 |
| 8351 | 8406 | テンプレートは次のようになります。 |
| @@ -8368,9 +8423,9 @@ footnote.@}; in the Texinfo source@dots{} | ||
| 8368 | 8423 | |
| 8369 | 8424 | これで分かるように、このソースには二つの句読点記号が隣り合って存在しています。 |
| 8370 | 8425 | この場合は、@samp{.@};}というのがその並びです。 |
| 8371 | -これは正常ですので、奇妙な感じに見えますが、気にしないようにしてください(最初の記号は脚注を終わらせるもの、2番目の記号は脚注が付けられている一文に属するものです)。 | |
| 8426 | +奇妙な感じに見えますが、これで正常ですので気にしないようにしてください(最初の記号は脚注を終わらせるもの、2番目の記号は脚注が付けられている一文に属するものです)。 | |
| 8372 | 8427 | |
| 8373 | -印刷されたマニュアルや本では、脚注に対する参照記号として、小さな上付きの数字が付けられます。 | |
| 8428 | +印刷マニュアルや本では、脚注に対する参照記号として、小さな上付きの数字が付けられます。 | |
| 8374 | 8429 | そして脚注のテキストはページの一番下の水平線の下に示されます。 |
| 8375 | 8430 | |
| 8376 | 8431 | Infoでは、脚注に対する参照記号として、@samp{(1)}のような括弧の中に脚注番号が書かれたものが使われます。 |
| @@ -8461,9 +8516,10 @@ Infoファイルの脚注スタイルを指定するには@code{@@footnotestyle} | ||
| 8461 | 8516 | @chapter 索引 |
| 8462 | 8517 | @cindex Indices |
| 8463 | 8518 | |
| 8464 | -Texinfoを使用すると、手作業でエントリを並べ替えたり、照合したりすることなく索引を生成することが出来ます。 | |
| 8465 | -索引では、エントリがアルファベット順にリストされ、各エントリについて論述されている場所の情報も一緒に示されます。 | |
| 8466 | -印刷されたマニュアルでは場所の情報はページ番号です。 | |
| 8519 | +Texinfoを使用すると、手作業でエントリを並べ替えたり照合したりすることなく、索引を生成することが出来ます。 | |
| 8520 | +索引では、エントリがアルファベット順にリストされます。 | |
| 8521 | +各エントリについて論述されている場所の情報も一緒に示されます。 | |
| 8522 | +印刷マニュアルでは場所の情報がページ番号となります。 | |
| 8467 | 8523 | Infoファイルでは、参照されている最初のノードへ誘導するメニューエントリとなっています。 |
| 8468 | 8524 | |
| 8469 | 8525 | Texinfoでは数種類の索引が予め用意されています。 |
| @@ -8471,7 +8527,7 @@ Texinfoでは数種類の索引が予め用意されています。 | ||
| 8471 | 8527 | 索引を組み合わせたり、標準的な目的とは違うものに対して索引を使用することも出来ます。 |
| 8472 | 8528 | 独自の新たな索引を定義することも可能です。 |
| 8473 | 8529 | |
| 8474 | -索引の印刷方法については@xref{Printing Indices & Menus}. | |
| 8530 | +索引の印刷方法については別の節を参照してください(@pxref{Printing Indices & Menus})。 | |
| 8475 | 8531 | |
| 8476 | 8532 | @menu |
| 8477 | 8533 | * Index Entries:: Choose different words for index entries. |
| @@ -8499,7 +8555,7 @@ Texinfoでは数種類の索引が予め用意されています。 | ||
| 8499 | 8555 | 組版と同じように、索引の作成は高度に熟練した腕が必要な、専門的な作業です。 |
| 8500 | 8556 | 自分で索引作りをやってみない限り、繊細な索引のありがたみを感じることは無いでしょう。 |
| 8501 | 8557 | |
| 8502 | -巻末での索引の印刷や、Infoファイルにおける索引メニューの作成については、@xref{Printing Indices & Menus}. | |
| 8558 | +巻末での索引の印刷や、Infoファイルにおける索引メニューの作成については別の節を参照してください(@pxref{Printing Indices & Menus})。 | |
| 8503 | 8559 | |
| 8504 | 8560 | |
| 8505 | 8561 | @node Predefined Indices |
| @@ -8563,7 +8619,7 @@ Texinfoは六つの定義済み索引を用意しています。 | ||
| 8563 | 8619 | |
| 8564 | 8620 | 索引エントリは、行頭に書いた索引コマンドと、続けてその行の残りの部分に書いたエントリによって構成されます。@refill |
| 8565 | 8621 | |
| 8566 | -例えば、このセクションは概念索引に対する以下のような五つのエントリで始まります。:@refill | |
| 8622 | +例えば、このセクションは概念索引に対する以下のような五つのエントリで始まります。@refill | |
| 8567 | 8623 | |
| 8568 | 8624 | @example |
| 8569 | 8625 | @@cindex Defining indexing entries |
| @@ -8581,15 +8637,14 @@ Texinfoは六つの定義済み索引を用意しています。 | ||
| 8581 | 8637 | @cindex Index entry writing |
| 8582 | 8638 | 概念索引のエントリはテキストで出来ています。 |
| 8583 | 8639 | 索引を書く最も良い方法は、簡潔でなおかつ分かりやすいエントリを選択することです。 |
| 8584 | -こうすることが出来れば、そのエントリが大文字化しないほうが大抵見栄えが良くなりますが、文の途中に書かれているかのようになります。 | |
| 8585 | -(常に大文字で書かれる固有名詞は頭字語は大文字で書くようにしてください。) | |
| 8640 | +こうすることが出来れば、そのエントリが大文字化しないほうが大抵見栄えが良くなりますが、文の途中に書かれているかのようになります(常に大文字で書かれる固有名詞は頭字語は大文字で書くようにしてください)。 | |
| 8586 | 8641 | これが、大部分のGNUマニュアルの索引で行なわれている慣習です。 |
| 8587 | 8642 | |
| 8588 | 8643 | エントリを簡潔かつ分かりやすいものとする方法が見出せない場合には、より長くて分かりやすいものを選んでください。 |
| 8589 | -簡潔だが分かりにくいものではありません。 | |
| 8590 | -数語からなるエントリが多くある場合、各エントリの最初の語の語頭を大文字化するという、違った慣習を使うほうが索引の見栄えが良くなることがあります。 | |
| 8644 | +簡潔だが分かりにくいものを選ぶのではありません。 | |
| 8645 | +数語からなるエントリが多数ある場合、各エントリの最初の語の語頭を大文字化するという、別の慣習を使うほうが索引の見栄えが良くなることがあります。 | |
| 8591 | 8646 | C言語やLisp言語の関数名あるいはシェルコマンドのように、大文字小文字が区別される名前を大文字化して変更してしまわないようにしてください。 |
| 8592 | -綴を間違ってしまうことになると思います。 | |
| 8647 | +綴りを間違ってしまうことになると思います。 | |
| 8593 | 8648 | |
| 8594 | 8649 | どちらの慣習を使っていたとしても、それを首尾一貫使うようにしてください。 |
| 8595 | 8650 |
| @@ -8597,14 +8652,16 @@ C言語やLisp言語の関数名あるいはシェルコマンドのように、 | ||
| 8597 | 8652 | こういった名前は通常大文字小文字が区別されますので、その必要に応じて大文字あるいは小文字を使用するようにしてください。 |
| 8598 | 8653 | |
| 8599 | 8654 | @cindex Index font types |
| 8600 | -デフォルトでは、概念索引のエントリは小さいローマンフォントで印刷され、それ以外の索引のエントリは小さい@code{@@code}のフォントで印刷されます。 | |
| 8655 | +デフォルトでは、概念索引のエントリは小さいローマンフォントで印刷されます。 | |
| 8656 | +それ以外の索引のエントリは小さい@code{@@code}のフォントで印刷されます。 | |
| 8601 | 8657 | エントリの一部が印刷される方法は通常のTexinfoコマンドを使って変更することが出来ます。 |
| 8602 | 8658 | 例えば、ファイル名については@code{@@file}コマンドを使う(@pxref{Marking Text})とか、ノーマルのローマンフォントに変更するのに@code{@@r}コマンドを使う(@pxref{Fonts})などしてください。 |
| 8603 | 8659 | |
| 8604 | 8660 | @quotation Caution |
| 8605 | 8661 | 索引エントリの中ではコロンを使用しないようにしてください。 |
| 8606 | -Infoでは、コロンを使ってメニューエントリの名前とノード名を分けていますので、エントリ自体にコロンが含まれるとInfoが混乱することになります。 | |
| 8607 | -メニューエントリの構造については、@xref{Menu Parts}. | |
| 8662 | +Infoでは、コロンを使ってメニューエントリの名前とノード名を分けています。 | |
| 8663 | +エントリ自体にコロンが含まれるとInfoが混乱することになります。 | |
| 8664 | +メニューエントリの構造については別の節を参照してください(@pxref{Menu Parts})。 | |
| 8608 | 8665 | @end quotation |
| 8609 | 8666 | |
| 8610 | 8667 |
| @@ -8614,10 +8671,10 @@ Infoでは、コロンを使ってメニューエントリの名前とノード | ||
| 8614 | 8671 | @cindex Indices, combining them |
| 8615 | 8672 | |
| 8616 | 8673 | 関数索引と概念索引のように、本質的に異なる二つの索引を一つにまとめたいことがあります。 |
| 8617 | -それは恐らく、十分な数のエントリが無く、別々の索引にしておくと間の抜けた感じに見えてしまうからというような理由でしょう。 | |
| 8674 | +それは恐らく、十分な数のエントリが無く、別々の索引にしておくと間の抜けた感じに見えてしまうからというような理由だったりするでしょう。 | |
| 8618 | 8675 | |
| 8619 | 8676 | @code{@@findex}コマンドでなく@code{@@cindex}コマンドを記述すれば関数を概念索引に入れることが出来ます。 |
| 8620 | -そして概念索引を「Function and Concept Index」とタイトルを付けて印刷し、「Function Index」を全く印刷しないようにすれば、一貫したマニュアルを生成できます。 | |
| 8677 | +そして、概念索引を「Function and Concept Index」とタイトルを付けて印刷し、「Function Index」を全く印刷しないようにすれば、一貫したマニュアルを生成できます。 | |
| 8621 | 8678 | しかし、これはしっかりとした手順ではありません。 |
| 8622 | 8679 | そのドキュメントが、関数索引を別に持つように設計された他のドキュメントの一部としてインクルードされないのであれば、こういう方法で上手く行きます。 |
| 8623 | 8680 | ドキュメントがそういった別のドキュメントにインクルードされるものであったとしたら、そのドキュメントに記載された関数と別のドキュメントに記載された関数とが最終的に一緒になることはありません。 |
| @@ -8634,10 +8691,11 @@ Infoでは、コロンを使ってメニューエントリの名前とノード | ||
| 8634 | 8691 | @subsection @code{@@syncodeindex} |
| 8635 | 8692 | @findex syncodeindex |
| 8636 | 8693 | |
| 8637 | -関数と概念を一つの索引にまとめたい場合、関数は@code{@@findex}コマンドで、概念は@code{@@cindex}コマンドでインデックスし、そして、@code{@@syncodeindex}コマンドを使って関数索引のエントリを概念索引の方へリダイレクトするようにしなければなりません。@refill | |
| 8694 | +関数と概念を一つの索引にまとめたい場合、関数は@code{@@findex}コマンドでインデックスし、概念は@code{@@cindex}コマンドでインデックスします。 | |
| 8695 | +そして、@code{@@syncodeindex}コマンドを使って関数索引のエントリを概念索引の方へリダイレクトするようにしなければなりません。@refill | |
| 8638 | 8696 | |
| 8639 | 8697 | @code{@@syncodeindex}コマンドは引数が二つあります。 |
| 8640 | -リダイレクトする索引の名前と、リダイレクト先の索引の名前です。 | |
| 8698 | +リダイレクトする索引の名前とリダイレクト先の索引の名前です。 | |
| 8641 | 8699 | テンプレートは次のようになります。@refill |
| 8642 | 8700 | |
| 8643 | 8701 | @example |
| @@ -8665,7 +8723,7 @@ Infoでは、コロンを使ってメニューエントリの名前とノード | ||
| 8665 | 8723 | データ型索引(data type index) |
| 8666 | 8724 | @end table |
| 8667 | 8725 | |
| 8668 | -@code{@@syncodeindex}コマンドは、Texinfoファイルの冒頭のend-of-header行の前あるいはすぐ後ろに書いてください。 | |
| 8726 | +@code{@@syncodeindex}コマンドは、Texinfoファイルの冒頭のend-of-header行の前か、すぐ後ろに書いてください。 | |
| 8669 | 8727 | 例えば、関数索引を概念索引にマージするには次のように記述します。@refill |
| 8670 | 8728 | |
| 8671 | 8729 | @example |
| @@ -8693,9 +8751,9 @@ Infoでは、コロンを使ってメニューエントリの名前とノード | ||
| 8693 | 8751 | @findex synindex |
| 8694 | 8752 | |
| 8695 | 8753 | @code{@@sysindex}コマンドは@code{@@syncodeindex}コマンドとほぼ同じですが、「from」索引のエントリを@code{@@code}のフォントにしないところだけが異なります。 |
| 8696 | -従って、@code{@@synindex}コマンドは、概念索引を関数索引にマージするような場合に使います。@refill | |
| 8754 | +したがって、@code{@@synindex}コマンドは、概念索引を関数索引にマージするような場合に使います。@refill | |
| 8697 | 8755 | |
| 8698 | -本の巻末の索引を印刷したり、Infoファイルにおける索引メニューを作成したりすることについては、@xref{Printing Indices & Menus}.@refill | |
| 8756 | +本の巻末の索引を印刷したり、Infoファイルにおける索引メニューを作成したりすることについては別の節を参照してください(@pxref{Printing Indices & Menus})。@refill | |
| 8699 | 8757 | |
| 8700 | 8758 | |
| 8701 | 8759 | @node New Indices |
| @@ -8753,7 +8811,8 @@ Infoでは、コロンを使ってメニューエントリの名前とノード | ||
| 8753 | 8811 | @end group |
| 8754 | 8812 | @end example |
| 8755 | 8813 | |
| 8756 | -@code{@@defcodeindex}コマンドは@code{@@defindex}コマンドと似ていますが、印刷出力において、ローマンフォントではなく、デフォルトで@code{@@code}のフォントを使用してエントリを印刷することが異なります。 | |
| 8814 | +@code{@@defcodeindex}コマンドは@code{@@defindex}コマンドと似ています。 | |
| 8815 | +但し、印刷出力において、ローマンフォントではなく、デフォルトで@code{@@code}のフォントを使用してエントリを印刷することが異なります。 | |
| 8757 | 8816 | |
| 8758 | 8817 | 新しい索引は、Texinfoファイルのend-of-header行の前、(当然@code{@@synindex}コマンドもしくは@code{@@syncodeindex}コマンドの前で定義すべきでしょう(@pxref{Texinfo File Header})。 |
| 8759 | 8818 |
| @@ -8763,7 +8822,7 @@ Infoでは、コロンを使ってメニューエントリの名前とノード | ||
| 8763 | 8822 | @cindex Inserting special characters and symbols |
| 8764 | 8823 | @cindex Special insertions |
| 8765 | 8824 | |
| 8766 | -Texinfoでは、ブレース(中括弧)のようなTexinfoで特殊な意味を持つ文字を挿入するコマンドや、その他タイプ可能な単純文字とは異なるグラフィック要素に対するコマンドなどを用意しています。 | |
| 8825 | +ブレース(中括弧)のようなTexinfoで特殊な意味を持つ文字を挿入するコマンドや、その他タイプ可能な単純文字とは異なるグラフィック要素に対するコマンドなどが用意されています。 | |
| 8767 | 8826 | |
| 8768 | 8827 | @iftex |
| 8769 | 8828 | そういったコマンドは次の通りです。 |
| @@ -8807,14 +8866,14 @@ Texinfoでは、ブレース(中括弧)のようなTexinfoで特殊な意味を | ||
| 8807 | 8866 | |
| 8808 | 8867 | |
| 8809 | 8868 | @node Atsign Braces Comma |
| 8810 | -@section @@、@{@}、@comma{}の挿入 | |
| 8869 | +@section @@・@{@}・@comma{}の挿入 | |
| 8811 | 8870 | @cindex Special characters, inserting |
| 8812 | 8871 | @cindex Commands to insert special characters |
| 8813 | 8872 | |
| 8814 | -@samp{@@}と波括弧はTexinfoにおいて特別な意味を持っています。 | |
| 8873 | +@samp{@@}と中括弧(波括弧)はTexinfoにおいて特別な意味を持っています。 | |
| 8815 | 8874 | テキスト中に現われるようにこれらの文字を挿入するには、Texinfoが誤って解釈しないように、文字の前に@samp{@@}文字を置かなければなりません。 |
| 8816 | 8875 | |
| 8817 | -カンマ「,」は、ある通常とは異なるコンテキストにおいてだけ特別な意味を持ちます。 | |
| 8876 | +カンマ「,」は、通常とは異なるあるコンテキストにおいてだけ特別な意味を持ちます。 | |
| 8818 | 8877 | 即ち、複数の引数を取るコマンドに対する引数を区切るのに使用されます。 |
| 8819 | 8878 | |
| 8820 | 8879 | @menu |
| @@ -8835,7 +8894,6 @@ Texinfoでは、ブレース(中括弧)のようなTexinfoで特殊な意味を | ||
| 8835 | 8894 | |
| 8836 | 8895 | |
| 8837 | 8896 | @node Inserting Braces |
| 8838 | -@subsection Inserting `@{' and `@}' with @code{@@@{} and @code{@@@}} | |
| 8839 | 8897 | @subsection @code{@@@{}コマンドと@code{@@@}}コマンドによる「@{」と「@}」の挿入 |
| 8840 | 8898 | @cindex Braces, inserting |
| 8841 | 8899 | @findex @{ @r{(literal @samp{@{})} |
| @@ -8855,11 +8913,12 @@ Texinfoでは、ブレース(中括弧)のようなTexinfoで特殊な意味を | ||
| 8855 | 8913 | |
| 8856 | 8914 | 通常、カンマ「,」は必要な場所で単にタイプして入力することの出来る普通の文字です。 |
| 8857 | 8915 | |
| 8858 | -しかしTexinfoでは、通常とは異なるコンテキストにおいて、カンマを特殊文字として使用します。 | |
| 8859 | -例えば、@code{@@acronym}コマンド(@pxref{acronym})や@code{@@xref}コマンド(@pxref{Cross References})、そしてユーザ定義マクロ(@pxref{Defining Macros})のように、複数の引数を取ることがあるコマンドがあります。 | |
| 8916 | +しかし、Texinfoでは、通常とは異なるコンテキストにおいて、カンマを特殊文字として使用します。 | |
| 8917 | +例えば、@code{@@acronym}コマンド(@pxref{acronym})、@code{@@xref}コマンド(@pxref{Cross References})、ユーザ定義マクロ(@pxref{Defining Macros})のように、複数の引数を取ることがあるコマンドがあります。 | |
| 8860 | 8918 | こういう場合、カンマ文字は引数を区切るのに使用されます。 |
| 8861 | 8919 | |
| 8862 | -カンマ文字があると、複数の引数を取るコマンドを解釈する場合にTexinfoが混乱することになりますので、実際にカンマを引き渡したい場合には、代わりに@samp{@@comma@{@}}コマンドを使わなければなりません。 | |
| 8920 | +カンマ文字があると、複数の引数を取るコマンドを解釈する場合にTexinfoが混乱することになります。 | |
| 8921 | +実際にカンマを引き渡したい場合には、代わりに@samp{@@comma@{@}}コマンドを使わなければなりません。 | |
| 8863 | 8922 | 以下に例を示します。 |
| 8864 | 8923 | |
| 8865 | 8924 | @example |
| @@ -8883,8 +8942,7 @@ Texinfoの一般的な入力慣習に関して述べた最初のほうのセク | ||
| 8883 | 8942 | |
| 8884 | 8943 | これはテキストについては全て上手く機能します。 |
| 8885 | 8944 | しかし、コンピュータコードの例示の場合だと、読者がテキストをそのままカットアンドペーストすることが特に多くあるでしょう。 |
| 8886 | -残念なことに、ドキュメントを閲覧するプログラムによっては、こういった文字を滅茶苦茶にしてしまうことがあります。 | |
| 8887 | -(フリーのPDFリーダ@command{xpdf}は上手く動作しますが、その他のPDFリーダは、フリーのものでもノンフリーのものでも問題が起きます。) | |
| 8945 | +残念なことに、ドキュメントを閲覧するプログラムによっては、こういった文字を滅茶苦茶にしてしまうことがあります(フリーのPDFリーダ@command{xpdf}は上手く動作しますが、その他のPDFリーダは、フリーのものでもノンフリーのものでも問題が起きます)。 | |
| 8888 | 8946 | |
| 8889 | 8947 | これがドキュメントにとって大事である場合を考えて、Texinfoには、@code{@@set}コマンドを使った二つの特別な設定が用意されています。 |
| 8890 | 8948 |
| @@ -8911,7 +8969,7 @@ Texinfoの一般的な入力慣習に関して述べた最初のほうのセク | ||
| 8911 | 8969 | |
| 8912 | 8970 | これらの設定は@code{@@code}コマンド、@code{@@example}コマンド、@code{@@verbatim}コマンドに影響します。 |
| 8913 | 8971 | @code{@@samp}コマンドには影響しません。 |
| 8914 | -(@xref{Useful Highlighting}.) | |
| 8972 | +@xref{Useful Highlighting}. | |
| 8915 | 8973 | |
| 8916 | 8974 | |
| 8917 | 8975 | @node Inserting Space |
| @@ -8931,16 +8989,16 @@ Texinfoの一般的な入力慣習に関して述べた最初のほうのセク | ||
| 8931 | 8989 | |
| 8932 | 8990 | |
| 8933 | 8991 | @node Not Ending a Sentence |
| 8934 | -@subsection Not Ending a Sentence | |
| 8992 | +@subsection 文末外での空白調整 | |
| 8935 | 8993 | |
| 8936 | 8994 | @cindex Not ending a sentence |
| 8937 | 8995 | @cindex Sentence non-ending punctuation |
| 8938 | 8996 | @cindex Periods, inserting |
| 8939 | 8997 | 組版されるマニュアルでは、ピリオド、感嘆符、疑問符が文の途中なのか文末なのかによって、ピリオドの後ろに挿入される空白の量が変わります。 |
| 8940 | 8998 | ピリオドが文を終了させるのか、略語で使用されているのかを確定するのは常に可能とは限りませんので、場合によっては特殊なコマンドが必要となります。 |
| 8941 | -通常Texinfoはピリオドの処理方法を推測によって決めることが出来ますので、特殊なコマンドを使用する必要はありません。 | |
| 8999 | +通常、Texinfoはピリオドの処理方法を推測によって決めることが出来ますので、特殊なコマンドを使用する必要はありません。 | |
| 8942 | 9000 | タイプライターを打っているかのようにピリオドを打つだけです。 |
| 8943 | -つまりセンテンスを終わらせるピリオド、疑問符、感嘆符の後ろにはスペースを二つ入力してください。 | |
| 9001 | +つまり、センテンスを終わらせるピリオド、疑問符、感嘆符の後ろにはスペースを二つ入力してください。 | |
| 8944 | 9002 | |
| 8945 | 9003 | @findex <colon> @r{(suppress end-of-sentence space)} |
| 8946 | 9004 | 余分なスペースが後ろに付いて欲しくないピリオド、疑問符、感嘆符、コロンの後では@code{@@:}@:コマンドを使用してください。 |
| @@ -8976,7 +9034,7 @@ DocbookとXMLでは、前の句読点文字(.?!:)は、通常の文字の代わ | ||
| 8976 | 9034 | |
| 8977 | 9035 | |
| 8978 | 9036 | @node Ending a Sentence |
| 8979 | -@subsection Ending a Sentence | |
| 9037 | +@subsection 文末での空白調整 | |
| 8980 | 9038 | |
| 8981 | 9039 | @cindex Ending a Sentence |
| 8982 | 9040 | @cindex Sentence ending punctuation |
| @@ -9016,7 +9074,7 @@ Texinfoにおける@code{@@:}と@code{@@.}@:の意味は、Emacsのセンテン | ||
| 9016 | 9074 | |
| 9017 | 9075 | |
| 9018 | 9076 | @node Multiple Spaces |
| 9019 | -@subsection 複数の空白 | |
| 9077 | +@subsection 複数空白の挿入 | |
| 9020 | 9078 | |
| 9021 | 9079 | @cindex Multiple spaces |
| 9022 | 9080 | @cindex Whitespace, inserting |
| @@ -9025,7 +9083,7 @@ Texinfoにおける@code{@@:}と@code{@@.}@:の意味は、Emacsのセンテン | ||
| 9025 | 9083 | @findex <tab> |
| 9026 | 9084 | @findex <newline> |
| 9027 | 9085 | |
| 9028 | -通常@TeX{}では複数の空白文字(スペース、タブ、改行)は単一のスペースへと畳み込んでしまいます。 | |
| 9086 | +通常、@TeX{}では、複数の空白文字(スペース、タブ、改行)は単一のスペースへと畳み込んでしまいます。 | |
| 9029 | 9087 | 他方、Info出力は入力された通りの空白を保持します。 |
| 9030 | 9088 | 但し、改行はスペースに変換されます。 |
| 9031 | 9089 | これが、Texinfoのドキュメントでセンテンスの末尾に二つスペースを入力することが大切である理由です。 |
| @@ -9052,11 +9110,10 @@ example. | ||
| 9052 | 9110 | |
| 9053 | 9111 | これらのコマンドに続けて中括弧を書かないようにしてください。 |
| 9054 | 9112 | |
| 9055 | -改行されないスペースを生成する場合は、@ref{tie, @code{@@tie}}を参照してください。 | |
| 9113 | +改行されないスペースを生成する場合は、別の節を参照してください(@pxref{tie, @code{@@tie}})。 | |
| 9056 | 9114 | |
| 9057 | 9115 | |
| 9058 | 9116 | @node frenchspacing |
| 9059 | -@subsection @code{@@frenchspacing} @var{val}: Control sentence spacing | |
| 9060 | 9117 | @subsection @code{@@frenchspacing} @var{val}: センテンススペースの制御 |
| 9061 | 9118 | @findex frenchspacing |
| 9062 | 9119 | @cindex French spacing |
| @@ -9092,7 +9149,7 @@ This is text. Two sentences. Three sentences. Non-French spacing. | ||
| 9092 | 9149 | @code{@@frenchspacing}コマンドは主に印刷出力に作用します。 |
| 9093 | 9150 | それには、@code{@@.}や@code{@@!}、@code{@@?}の後ろの出力も含まれます(@pxref{Ending a Sentence})。 |
| 9094 | 9151 | |
| 9095 | -Infoでは通常、入力中の空白文字は変更されずに出力へ書き出されます。 | |
| 9152 | +通常、Infoでは、入力中の空白文字は変更されずに出力へ書き出されます。 | |
| 9096 | 9153 | @code{@@frenchspacing}コマンドはこれを変更することはありません。 |
| 9097 | 9154 | このコマンドは、@command{makeinfo}が独自のスペースを出力する場合にだけ変更を行ないます。 |
| 9098 | 9155 | つまり、ソース中において改行でセンテンスが終わるような場合です。 |
| @@ -9162,15 +9219,16 @@ A4 paper is 8.27@dmn{in} wide. | ||
| 9162 | 9219 | |
| 9163 | 9220 | 以下に示すのは、フローティングアクセントを挿入するためにTexinfoが用意しているコマンドの表です。 |
| 9164 | 9221 | これらのコマンドにはそれぞれ引数が一つ必要です。 |
| 9165 | -引数はアクセントを付ける文字で、通常のように中括弧の中に引数を書く(@code{@@'@{e@}})か、あるいは、特別な場合として、括弧を省略して引数を書くことが出来ます。 | |
| 9166 | -括弧を省略した場合は引数は次の文字です(@code{@@'e})。 | |
| 9222 | +引数はアクセントを付ける文字です。 | |
| 9223 | +通常通り中括弧の中に引数を書く(@code{@@'@{e@}})か、あるいは、特別な場合として、括弧を省略して引数を書くことが出来ます。 | |
| 9224 | +括弧を省略した場合は次の文字が引数となります(@code{@@'e})。 | |
| 9167 | 9225 | 言語によってはアクセントの付いた文字が非常によく使用されますので、括弧を省略して書くことで可能な限りソースを読み書きしやすく出来ます。 |
| 9168 | 9226 | |
| 9169 | 9227 | @code{@@dotaccent}コマンドのように、コマンドがアルファベットの名前の場合、中括弧を使わないのであれば、コマンド名と引数の間にスペースが一つ必要です。 |
| 9170 | 9228 | @code{@@'}コマンドのように、コマンドがアルファベットでない名前の場合、スペースを@emph{入れてはいけません}。 |
| 9171 | 9229 | 引数は直後の文字となります。 |
| 9172 | 9230 | |
| 9173 | -例外: @code{@@tieaccent}コマンドの引数は中括弧で括らなければなりません(このコマンドは一文字ではなく二文字だからです)。 | |
| 9231 | +例外: @code{@@tieaccent}コマンドの引数は中括弧で括らなければなりません(このコマンドは1文字ではなく2文字だからです)。 | |
| 9174 | 9232 | |
| 9175 | 9233 | @findex documentencoding |
| 9176 | 9234 | Infoにおいて、ASCIIによる置き換えでなく、実際にアクセントの付いた文字の出力を得るには、必要とされる文字をサポートするエンコードを@code{@@documentencoding}コマンドに指定する必要があります(@pxref{documentencoding,,@code{@@documentencoding}})。 |
| @@ -9293,9 +9351,6 @@ Infoにおいて、ASCIIによる置き換えでなく、実際にアクセン | ||
| 9293 | 9351 | @cindex Quotation characters (`'), in source |
| 9294 | 9352 | 引用を開始終了するには、@w{@t{`@w{}`@dots{}'@w{}'}}のように、単引用符を重ねて使用してください。 |
| 9295 | 9353 | @TeX{}では、単引用符が二つあると、左右の二重引用符に変換します。 |
| 9296 | -Use doubled single-quote characters to begin and end quotations: | |
| 9297 | -@w{@t{`@w{}`@dots{}'@w{}'}}. @TeX{} converts two single quotes to | |
| 9298 | -left- and right-hand doubled quotation marks, | |
| 9299 | 9354 | @c this comes out as "like this" in Info, which is just confusing. |
| 9300 | 9355 | @iftex |
| 9301 | 9356 | ``このように''なります。 |
| @@ -9401,13 +9456,14 @@ Texinfoでは、英語以外で使用される引用符を他にいくつかサ | ||
| 9401 | 9456 | 二重の三角引用符については、Adobeと@LaTeX{}のグリフ名もサポートされています。 |
| 9402 | 9457 | @code{@@guillemotleft}と@code{@@guillemotright}です。 |
| 9403 | 9458 | この名前は実際には正しくありません。 |
| 9404 | -「guillemot」というのは鳥の一種(ウミスズメの一種ですね。 | |
| 9459 | +「guillemot」というのは鳥の一種(ウミスズメの一種)ですね。 | |
| 9405 | 9460 | |
| 9406 | 9461 | 引用符の使用法に関する慣習というのは言語間で大きく異なります(@url{http://@/en.wikipedia.org/@/wiki/@/Quotation_mark%2C_non-English_usage@/#Overview})。 |
| 9407 | 9462 | Texinfoは、数多ある慣習に応じた引用符の組版に対してコマンドを用意しているわけではありません。 |
| 9408 | 9463 | ですので、ユーザが、作成するマニュアルの言語に対して適切なコマンドを選択しなければなりません。 |
| 9409 | 9464 | エイリアス(@pxref{alias,,@code{@@alias}})を使うことで、引用符の使い方が単純化され、ソースコードが読み易くなることもあります。 |
| 9410 | -例えばドイツ語では、@code{@@quotedblbase}コマンドが左の二重引用符に対して使用され、右の二重引用符は実際@code{@@quotedblleft}です。 | |
| 9465 | +例えば、ドイツ語では、@code{@@quotedblbase}コマンドが左の二重引用符に対して使用されます。 | |
| 9466 | +右の二重引用符は実際は@code{@@quotedblleft}です。 | |
| 9411 | 9467 | これは直感的ではありません。 |
| 9412 | 9468 | ですので、こういう場合以下のようにエイリアスを使用すると便利になります。 |
| 9413 | 9469 |
| @@ -9432,7 +9488,7 @@ Texinfoは、数多ある慣習に応じた引用符の組版に対してコマ | ||
| 9432 | 9488 | コマンド名と括弧の間に空白は入れません。 |
| 9433 | 9489 | (コマンド直後に別のテキストを書くことが出来るように、これらのコマンドには括弧を使う必要があります。 |
| 9434 | 9490 | 括弧が無いと書式化するプログラムが混乱することになるでしょう。 |
| 9435 | -詳細は@xref{Command Syntax, ,@@-Command Syntax}.)@refill | |
| 9491 | +@xref{Command Syntax, ,@@-Command Syntax}.)@refill | |
| 9436 | 9492 | |
| 9437 | 9493 | @menu |
| 9438 | 9494 | * dots:: How to insert dots @dots{} |
| @@ -9441,7 +9497,6 @@ Texinfoは、数多ある慣習に応じた引用符の組版に対してコマ | ||
| 9441 | 9497 | |
| 9442 | 9498 | |
| 9443 | 9499 | @node dots |
| 9444 | -@subsection @code{@@dots}@{@} (@dots{}) and @code{@@enddots}@{@} (@enddots{}) | |
| 9445 | 9500 | @subsection @code{@@dots}@{@} (@dots{})と@code{@@enddots}@{@} (@enddots{}) |
| 9446 | 9501 | @findex dots |
| 9447 | 9502 | @findex enddots |
| @@ -9470,14 +9525,14 @@ Texinfoは、数多ある慣習に応じた引用符の組版に対してコマ | ||
| 9470 | 9525 | @subsection @code{@@bullet}@{@} (@bullet{}) |
| 9471 | 9526 | @findex bullet |
| 9472 | 9527 | |
| 9473 | -大きな丸い点、もしくはそれに近いものを生成するには@code{@@bullet@{@}}コマンドを使用してください。 | |
| 9528 | +大きな丸い点、もしくは、それに近いものを生成するには@code{@@bullet@{@}}コマンドを使用してください。 | |
| 9474 | 9529 | Infoではアスタリスクが使用されます。@refill |
| 9475 | 9530 | |
| 9476 | 9531 | これが黒丸(bullet)です: @bullet{} |
| 9477 | 9532 | |
| 9478 | 9533 | @code{@@itemize}コマンドの中で@code{@@bullet}コマンドを使用する場合には、中括弧を入力する必要はありません。 |
| 9479 | 9534 | @code{@@itemize}コマンドが中括弧を補ってくれます。 |
| 9480 | -(@xref{itemize, , @code{@@itemize}}.)@refill | |
| 9535 | +@xref{itemize, , @code{@@itemize}}.@refill | |
| 9481 | 9536 | |
| 9482 | 9537 | |
| 9483 | 9538 | @node TeX and copyright |
| @@ -9508,9 +9563,10 @@ Infoではアスタリスクが使用されます。@refill | ||
| 9508 | 9563 | Infoでは、@samp{TeX}と同じようになります。 |
| 9509 | 9564 | |
| 9510 | 9565 | 同様に、「@LaTeX{}」を生成するには@code{@@LaTeX@{@}}コマンドを使用してください。 |
| 9511 | -このロゴは印刷ではさらに特別です(そして、誤った書き方の@code{La@@TeX@{@}}とは違います)。 | |
| 9566 | +このロゴは印刷ではさらに特別です(@code{La@@TeX@{@}}は間違った書き方で、出力が異なります)。 | |
| 9512 | 9567 | Infoでは@samp{LaTeX}と同じ結果となります。 |
| 9513 | -(@LaTeX{}は@TeX{}上に構築されたマクロパッケージの一つで、論理構造を強調する点においてTexinfoと何となく似たものですが、Texinfoと比べて、かなり(かなり)巨大なものです。) | |
| 9568 | +(@LaTeX{}は@TeX{}上に構築されたマクロパッケージの一つです。 | |
| 9569 | +論理構造を強調する点においてTexinfoと何となく似たものですが、Texinfoと比べて、かなり(かなり)巨大なものです。) | |
| 9514 | 9570 | |
| 9515 | 9571 | これらのコマンドの綴りは大文字小文字の両方を使うため、Texinfoのコマンドの中では特異なものとなっています。 |
| 9516 | 9572 |
| @@ -9552,8 +9608,7 @@ Texinfoは、下位のシステム(フォントやソフトウェアなど何で | ||
| 9552 | 9608 | |
| 9553 | 9609 | @cindex ISO 8859-15 |
| 9554 | 9610 | @cindex Latin 9 |
| 9555 | -エンコードされているInfo出力においてユーロ記号を得るには、例えば、@code{@@documentencoding ISO-8859-15}と記述する必要があります。 | |
| 9556 | -(@xref{documentencoding,,@code{@@documentencoding}}.) | |
| 9611 | +エンコードされているInfo出力においてユーロ記号を得るには、例えば、@code{@@documentencoding ISO-8859-15}と記述する必要があります(@pxref{documentencoding,,@code{@@documentencoding}})。 | |
| 9557 | 9612 | ユーロ記号はISO 8859-15 (別名Latin@tie{}9)にはありますが、より広く使われてサポートされているISO 8859-1 (Latin@tie{}1)には@emph{含まれていません}。 |
| 9558 | 9613 | |
| 9559 | 9614 | @pindex feymr10 |
| @@ -9611,7 +9666,7 @@ Infoで使用される等幅フォントでは、@code{@@minus@{@}}はハイフ | ||
| 9611 | 9666 | そこで使用される等幅フォントの中では幅の区別がつかないからです。 |
| 9612 | 9667 | |
| 9613 | 9668 | itemizeリストの各エントリを開始するマークを指定するのに@code{@@minus}コマンドを使用する場合は、中括弧を入力する必要はありません。 |
| 9614 | -(@pxref{itemize, , @code{@@itemize}}). | |
| 9669 | +@xref{itemize, , @code{@@itemize}}. | |
| 9615 | 9670 | |
| 9616 | 9671 | |
| 9617 | 9672 | @node geq leq |
| @@ -9946,7 +10001,7 @@ In a Texinfo source file, this example is written as follows: | ||
| 9946 | 10001 | @end ifnottex |
| 9947 | 10002 | |
| 9948 | 10003 | @need 700 |
| 9949 | -従って以下を見てください。 | |
| 10004 | +したがって、以下を見てください。 | |
| 9950 | 10005 | |
| 9951 | 10006 | @example |
| 9952 | 10007 | @@lisp |
| @@ -9988,7 +10043,7 @@ Wrong type argument: integer-or-marker-p, x | ||
| 9988 | 10043 | @code{@@equiv@{@}}コマンドはInfoやHTMLでは@samp{@equiv{}}と表示され、印刷出力では等価を表わす標準的符号(平行な三本の横線)として表示されます。 |
| 9989 | 10044 | @end ifnottex |
| 9990 | 10045 | |
| 9991 | -従って以下を見てください。 | |
| 10046 | +したがって、以下を見てください。 | |
| 9992 | 10047 | |
| 9993 | 10048 | @example |
| 9994 | 10049 | @@lisp |
| @@ -10074,7 +10129,7 @@ This is the changed @@point@{@}contents of foo. | ||
| 10074 | 10129 | |
| 10075 | 10130 | @cindex Line breaks |
| 10076 | 10131 | 通常、Texinfoファイルは@TeX{}といずれかのInfo書式化コマンドの両方で処理されます。 |
| 10077 | -出力形式のいずれかで、改行あるいは改パラグラフ、改ページが「間違った」場所で発生することがあります。 | |
| 10132 | +出力形式のいずれかで、改行あるいは改段落、改ページが「間違った」場所で発生することがあります。 | |
| 10078 | 10133 | 印刷されたマニュアルでもInfoファイルでも、テキストが正しく見えるように確認しなければなりません。 |
| 10079 | 10134 | |
| 10080 | 10135 | @cindex White space, excessive |
| @@ -10101,7 +10156,7 @@ This is the changed @@point@{@}contents of foo. | ||
| 10101 | 10156 | @node Break Commands |
| 10102 | 10157 | @section ブレイクコマンド |
| 10103 | 10158 | |
| 10104 | -ブレイクコマンドは改行や改パラグラフを行なったり許可したりするコマンドです。 | |
| 10159 | +ブレイクコマンドは改行や改段落を行なったり許可したりするコマンドです。 | |
| 10105 | 10160 | |
| 10106 | 10161 | @table @code |
| 10107 | 10162 | @item @@* |
| @@ -10199,17 +10254,17 @@ The official Texinfo home page is on the GNU web site: | ||
| 10199 | 10254 | @cindex Hyphenation, helping @TeX{} do |
| 10200 | 10255 | @cindex Fine-tuning, and hyphenation |
| 10201 | 10256 | |
| 10202 | -@TeX{}のハイフン処理アルゴリズムは一般的にはかなり良いものなのですが、時々ハイフン処理に有効な箇所を逃がしてしまいます。 | |
| 10203 | -(あるいは、滅多にありませんが、間違った所にハイフンを挿入してしまいます。) | |
| 10204 | -ですので、一般的でない語彙を用いたドキュメントや、印刷版の微調整をしたいような場合、@TeX{}の処理を手伝いたいと思うことがあるかもしれません。 | |
| 10257 | +@TeX{}のハイフン処理アルゴリズムは一般的にはかなり良いものです。 | |
| 10258 | +しかし、時々ハイフン処理に有効な箇所を逃がしてしまいます(あるいは、滅多にありませんが、間違った所にハイフンを挿入してしまいます)。 | |
| 10259 | +ですので、一般的でない語彙を用いたドキュメントや、印刷版の微調整をしたいような場合、@TeX{}の処理を補助したいと思うことがあるかもしれません。 | |
| 10205 | 10260 | このため、Texinfoは二つのコマンドを用意しています。 |
| 10206 | 10261 | |
| 10207 | 10262 | @table @code |
| 10208 | 10263 | @item @@- |
| 10209 | 10264 | 任意のハイフンを挿入します。 |
| 10210 | -任意のハイフンとは、即ち@TeX{}がハイフンを入れることの出来る(しかし、必ず入れなければならないわけではない)位置のことです。 | |
| 10211 | -これは特に、@TeX{}のハイフン処理が上手くいかなかったことによるoverfull hboxが発生した際に役に立ちます(@pxref{Overfull hboxes})。 | |
| 10212 | -@TeX{}は@code{@@-}コマンドが含まれる単語の中にどのようなハイフネーションポイントも挿入しません。 | |
| 10265 | +任意のハイフンとは、即ち、@TeX{}がハイフンを入れられる(しかし、必ず入れなければならないわけではない)位置のことです。 | |
| 10266 | +特に、@TeX{}のハイフン処理が上手くいかなかったことによるoverfull hboxが発生した際に役に立ちます(@pxref{Overfull hboxes})。 | |
| 10267 | +@TeX{}は、@code{@@-}コマンドが含まれる単語の中にどのようなハイフネーションポイントも挿入しません。 | |
| 10213 | 10268 | |
| 10214 | 10269 | @item @@hyphenation@{@var{hy-phen-a-ted words}@} |
| 10215 | 10270 | @var{hy-phen-a-ted words}にハイフンを入れる方法を@TeX{}に指示します。 |
| @@ -10221,7 +10276,7 @@ The official Texinfo home page is on the GNU web site: | ||
| 10221 | 10276 | @noindent @TeX{}は語が正確に一致した時にだけ指定されたハイフネーションポイントを使用しますので、複数形のような変化形も必要であれば全て指定してください。 |
| 10222 | 10277 | @end table |
| 10223 | 10278 | |
| 10224 | -InfoやHTML、その他@TeX{}ではない出力はハイフン処理が為されませんので、これらのコマンドはそこでは全く効果を持ちません。 | |
| 10279 | +InfoやHTML、その他@TeX{}ではない出力はハイフン処理が為されませんので、これらのコマンドは全く効果を持ちません。 | |
| 10225 | 10280 | |
| 10226 | 10281 | |
| 10227 | 10282 | @node allowcodebreaks |
| @@ -10238,8 +10293,8 @@ InfoやHTML、その他@TeX{}ではない出力はハイフン処理が為され | ||
| 10238 | 10293 | 通常@TeX{}は、@code{@@code}コマンドや関連コマンド(@pxref{code,,@code{@@code}})の中では、@samp{-}文字や@samp{_}文字のある場所での改行を考慮します。 |
| 10239 | 10294 | これはそういった位置が「空」のハイフネーションポイントであるのとほぼ同じです。 |
| 10240 | 10295 | |
| 10241 | -この振る舞いは、非常に長い識別子を記述しなければならない多数のマニュアル、特にLisp系の言語のマニュアルなどで必要とされるものです。 | |
| 10242 | -他方、そういうマニュアルでなければこういう問題はありませんし、例えば@code{SIZE_MAX}のアンダースコアや、あるいは、さらに悪い@code{__typeof__}の四つのアンダースコア全ての後ろで改行させたいとは思わないでしょう。 | |
| 10296 | +この動作は、非常に長い識別子を記述しなければならない多数のマニュアル、特にLisp系の言語のマニュアルなどで必要となります。 | |
| 10297 | +他方、そういうマニュアルでなければこういう問題はありませんし、例えば、@code{SIZE_MAX}のアンダースコアや、あるいは、さらに悪い@code{__typeof__}の四つのアンダースコア全ての後ろで改行させたいとは思わないでしょう。 | |
| 10243 | 10298 | |
| 10244 | 10299 | ですので、Texinfoでは次のコマンドを用意しています。 |
| 10245 | 10300 |
| @@ -10247,12 +10302,12 @@ InfoやHTML、その他@TeX{}ではない出力はハイフン処理が為され | ||
| 10247 | 10302 | @@allowcodebreaks false |
| 10248 | 10303 | @end example |
| 10249 | 10304 | |
| 10250 | -@noindent これは@TeX{}が、@code{@@code}内の@samp{-}や@samp{_}で改行しないようにするためのコマンドです。 | |
| 10305 | +@noindent これは、@TeX{}が、@code{@@code}内の@samp{-}や@samp{_}で改行しないようにするためのコマンドです。 | |
| 10251 | 10306 | その種の改行を元に戻して許可するためには@code{@@allowcodebreaks true}コマンドを利用します。 |
| 10252 | 10307 | これらのコマンドは単独行に記述してください。 |
| 10253 | 10308 | |
| 10254 | 10309 | これらのコマンドはドキュメントのあらゆる場所で使用できます。 |
| 10255 | -例えば、この改行を無効にする必要がある問題パラグラフは一つだけで、通常はこの改行を有効にしたいという場合があるでしょうし、あるいはその逆のこともあるでしょう。 | |
| 10310 | +例えば、この改行を無効にする必要がある段落が一つだけで、通常はこの改行を有効にしたいという場合があるでしょうし、あるいは、その逆のこともあるでしょう。 | |
| 10256 | 10311 | |
| 10257 | 10312 | このコマンドはInfoやHTML、その他の@TeX{}以外の出力では効果を持ちません。 |
| 10258 | 10313 |
| @@ -10278,8 +10333,8 @@ InfoやHTML、その他@TeX{}ではない出力はハイフン処理が為され | ||
| 10278 | 10333 | @w{ } @w{ } @w{ } indentation. |
| 10279 | 10334 | @end display |
| 10280 | 10335 | |
| 10281 | -@code{@@w@{@w{ }@}}のスペース改行されないと同時に、広がったり縮んだりすることもありません。 | |
| 10282 | -それが必要な場合もあるでしょう。 | |
| 10336 | +@code{@@w@{@w{ }@}}のスペースは改行されないと同時に、広がったり縮んだりすることもありません。 | |
| 10337 | +こういったスペースが必要な場合もあるでしょう。 | |
| 10283 | 10338 | 例えば、手動で字下げするような場合です。 |
| 10284 | 10339 | しかし、通常は伸び縮みする普通の単語間スペースが(印刷出力では)必要です。 |
| 10285 | 10340 | 次節の@code{@@tie}コマンドを参照してください。 |
| @@ -10303,7 +10358,7 @@ InfoやHTML、その他@TeX{}ではない出力はハイフン処理が為され | ||
| 10303 | 10358 | @cindex Unbreakable space, variable |
| 10304 | 10359 | |
| 10305 | 10360 | @code{@@tie@{@}}コマンドは、そこで改行されることのない通常の単語間スペースを生成します。 |
| 10306 | -パラグラフ内で使用される通常のコマンドと同様、必ず続けて(空の)中括弧を書いてください。 | |
| 10361 | +段落内で使用される通常のコマンドと同様、必ず続けて(空の)中括弧を書いてください。 | |
| 10307 | 10362 | 以下に例を示します。 |
| 10308 | 10363 | |
| 10309 | 10364 | @example |
| @@ -10320,7 +10375,7 @@ InfoやHTML、その他@TeX{}ではない出力はハイフン処理が為され | ||
| 10320 | 10375 | |
| 10321 | 10376 | @itemize |
| 10322 | 10377 | @item |
| 10323 | -@code{@@tie@{@}}コマンドで生成されるスペースは、パラグラフ内の通常の単語間スペースに同調して、わずかに伸び縮みします。 | |
| 10378 | +@code{@@tie@{@}}コマンドで生成されるスペースは、段落内の通常の単語間スペースに同調して、わずかに伸び縮みします。 | |
| 10324 | 10379 | @code{@@w@{@w{ }@}}コマンドによって生成されるスペースは変化しません。 |
| 10325 | 10380 | |
| 10326 | 10381 | @item |
| @@ -10337,8 +10392,8 @@ InfoやHTML、その他@TeX{}ではない出力はハイフン処理が為され | ||
| 10337 | 10392 | @cindex Blank lines |
| 10338 | 10393 | @cindex Line spacing |
| 10339 | 10394 | |
| 10340 | -行頭から始めて@code{@@sp @var{n}}とだけ書いてある行があると、印刷されたマニュアルでもInfoファイルでも@var{n}行の空行分のスペースを生成します。 | |
| 10341 | -@code{@@sp}コマンドはまたパラグラフを強制的に分割します。 | |
| 10395 | +行頭から@code{@@sp @var{n}}とだけ書いてある行があると、印刷されたマニュアルでもInfoファイルでも@var{n}行の空行分のスペースを生成します。 | |
| 10396 | +@code{@@sp}コマンドはまた段落を強制的に分割します。 | |
| 10342 | 10397 | 例を挙げます。 |
| 10343 | 10398 | |
| 10344 | 10399 | @example |
| @@ -10396,7 +10451,7 @@ The @code{@@br} command is seldom used. | ||
| 10396 | 10451 | @cindex Page breaks |
| 10397 | 10452 | @findex page |
| 10398 | 10453 | |
| 10399 | -@code{@@page}コマンドだけの行があると印刷されたマニュアルでは新しいページが開始されます。 | |
| 10454 | +@code{@@page}コマンドだけの行があると、印刷マニュアルでは新しいページが開始されます。 | |
| 10400 | 10455 | Infoファイルはページというものがありませんので、このコマンドはInfoファイルには影響しません。 |
| 10401 | 10456 | @code{@@page}コマンドは、Texinfoファイルの@code{@@titlepage}のセクションで、著作権のページを開始するためによく使用されます。 |
| 10402 | 10457 |
| @@ -10409,10 +10464,11 @@ Infoファイルはページというものがありませんので、このコ | ||
| 10409 | 10464 | @cindex Vertically holding text together |
| 10410 | 10465 | @findex group |
| 10411 | 10466 | |
| 10412 | -単独行の@code{@@group}コマンドは、@code{@@example}環境や類似のコンストラクトの中で、分割できない縦方向のグループ(group)を開始するのに使用されます。 | |
| 10413 | -このgroupは印刷出力において全体が一ページに入るように出力されます。 | |
| 10414 | -このgroupは@code{@@end group}コマンドが単独で存在する行によって終了します。 | |
| 10415 | -これら二つのコマンド行自体は何ら出力を生成しませんし、また、Infoファイルの出力では、これらのコマンドは全く効果を持ちません。@refill | |
| 10467 | +単独で@code{@@group}コマンドを記述すると、@code{@@example}環境や類似のコンストラクトの中で、分割できない縦方向のグループ(group)を開始します。 | |
| 10468 | +このグループは印刷出力において全体が1ページに収まるように出力されます。 | |
| 10469 | +このグループは@code{@@end group}コマンドが単独で存在する行によって終了します。 | |
| 10470 | +これら二つのコマンド行自体は何ら出力を生成しません。 | |
| 10471 | +また、Infoファイルの出力では、これらのコマンドは全く効果を持ちません。@refill | |
| 10416 | 10472 | |
| 10417 | 10473 | @c Once said that these environments |
| 10418 | 10474 | @c turn off vertical spacing between ``paragraphs''. |
| @@ -10436,13 +10492,13 @@ Infoファイルはページというものがありませんので、このコ | ||
| 10436 | 10492 | @end example |
| 10437 | 10493 | |
| 10438 | 10494 | @noindent |
| 10439 | -つまり、@code{@@example}コマンドと@code{@@end example}コマンドの間に@code{@@group}コマンドと@code{@@end group}コマンドがあります。 | |
| 10495 | +つまり、@code{@@example}コマンドと@code{@@end example}コマンドの間に@code{@@group}コマンドと@code{@@end group}コマンドを書きます。 | |
| 10440 | 10496 | |
| 10441 | -@code{@@group}コマンドはexampleを一ページにまとめるのに最もよく使用されます。 | |
| 10497 | +@code{@@group}コマンドはexampleを1ページにまとめるのに最もよく使用されます。 | |
| 10442 | 10498 | このTexinfoのマニュアルでは、100以上のexampleにおいて、@code{@@group}コマンドと@code{@@end group}コマンドの間にテキストを記述しています。 |
| 10443 | 10499 | |
| 10444 | -groupを終了させるのを忘れてしまった場合、@TeX{}を実行すると、奇妙で理解しがたいエラーメッセージを受け取るかもしれません。 | |
| 10445 | -これは、Texinfoファイルの残りの部分を何とか一ページに入れようとしつづけ、かなりの量のテキストを処理してしまうまでエラーメッセージが生成されないために起こることです。 | |
| 10500 | +groupを終了させるのを忘れてしまった場合、@TeX{}を実行すると、奇妙で理解しがたいエラーメッセージが出力されることがあります。 | |
| 10501 | +これは、Texinfoファイルの残りの部分を何とか1ページに入れようとしつづけ、かなりの量のテキストを処理してしまうまでエラーメッセージが生成されないために起こることです。 | |
| 10446 | 10502 | @TeX{}で不可解なエラーメッセージが出力された場合には、@code{@@end group}を書き忘れていないかどうか調べてみるというのが間違いのない経験則です。@refill |
| 10447 | 10503 | |
| 10448 | 10504 | @node need |
| @@ -10456,7 +10512,7 @@ groupを終了させるのを忘れてしまった場合、@TeX{}を実行する | ||
| 10456 | 10512 | Infoファイルの場合はページ処理がありませんので、@code{@@need}コマンドは効果を持ちません。@refill |
| 10457 | 10513 | |
| 10458 | 10514 | @need 800 |
| 10459 | -このパラグラフの前には、ページの残りが800 mils (10分の8インチ)よりも少なければ新しいページを開始するよう@TeX{}に指示する@code{@@need}コマンドが置かれています。 | |
| 10515 | +この段落の前には、ページの残りが800 mils (10分の8インチ)よりも少なければ新しいページを開始するよう@TeX{}に指示する@code{@@need}コマンドが置かれています。 | |
| 10460 | 10516 | 次のようになっています。@refill |
| 10461 | 10517 | |
| 10462 | 10518 | @example |
| @@ -10473,16 +10529,16 @@ This paragraph is preceded by @dots{} | ||
| 10473 | 10529 | @chapter 定義コマンド |
| 10474 | 10530 | @cindex Definition commands |
| 10475 | 10531 | |
| 10476 | -@code{@@deffn}コマンドとその他の@dfn{定義コマンド}は、関数や変数、マクロ、コマンド、ユーザオプション、特殊形式、その他そういったアーチファクトを統一した書式で説明できるようにします。 | |
| 10532 | +@code{@@deffn}コマンドとその他の@dfn{定義コマンド}は、関数、変数、マクロ、コマンド、ユーザオプション、特殊形式、その他そういったアーチファクトを統一した書式で説明できるようにします。 | |
| 10477 | 10533 | |
| 10478 | -Infoファイルでは定義を使うと、その実体のカテゴリ、つまり「Function」や「Variable」などがその定義の最初の行の冒頭に現われ、その実体の名前と引数がそれに続きます。 | |
| 10479 | -印刷されたマニュアルでは、定義コマンドを使うと、@TeX{}は、実体の名前と引数を左余白に表示し、右余白の隣にカテゴリを表示します。 | |
| 10534 | +Infoファイルで定義を使うと、その実体のカテゴリ、つまり「Function」「Variable」などがその定義の最初の行の冒頭に現われ、その実体の名前と引数がそれに続きます。 | |
| 10535 | +印刷マニュアルでは、定義コマンドを使うと、@TeX{}は、実体の名前と引数を左余白に表示し、右余白の隣にカテゴリを表示します。 | |
| 10480 | 10536 | 両方の出力フォーマットとも、定義の本体は字下げされます。 |
| 10481 | 10537 | また、実体の名前は適切な索引に入れられます。 |
| 10482 | -つまり@code{@@deffn}コマンドは実体名を関数索引に入れますし、@code{@@defvr}コマンドは変数索引に入れます。 | |
| 10538 | +つまり、@code{@@deffn}コマンドは実体名を関数索引に入れますし、@code{@@defvr}コマンドは変数索引に入れます。 | |
| 10483 | 10539 | 他も同様です(@pxref{Predefined Indices})。 |
| 10484 | 10540 | |
| 10485 | -マニュアルには、一つの指定された名前に対して複数の定義は必要ではありませんし、複数の定義を入れるべきではありません。 | |
| 10541 | +マニュアルには一つの指定された名前に対して複数の定義は必要ではありませんし、複数の定義を入れるべきではありません。 | |
| 10486 | 10542 | 概要を入れるappendixには定義コマンドよりも@code{@@table}コマンドを使用すべきでしょう。@refill |
| 10487 | 10543 | |
| 10488 | 10544 | @menu |
| @@ -10502,9 +10558,10 @@ Infoファイルでは定義を使うと、その実体のカテゴリ、つま | ||
| 10502 | 10558 | @cindex Template for a definition |
| 10503 | 10559 | |
| 10504 | 10560 | @code{@@deffn}コマンドは関数などのような実体の定義に使用します。 |
| 10505 | -@code{@@deffn}コマンドを使って定義を書く場合には、@code{@@deffn}コマンドを行頭に書き、続けて同じ行にその実体のカテゴリ、実体自体の名前、そして引数があればその引数を記述してください。 | |
| 10506 | -そして、定義の本体を次の行以降に記述します。 | |
| 10507 | -(本体にexampleを使うことも出来ます。) | |
| 10561 | +@code{@@deffn}コマンドを使って定義を書く場合には、@code{@@deffn}コマンドを行頭に書きます。 | |
| 10562 | +続けて同じ行にその実体のカテゴリ、実体自体の名前を書きます。 | |
| 10563 | +引数がある場合はその引数を記述してください。 | |
| 10564 | +そして、定義の本体を次行以降に記述します(本体にexampleを使うことも出来ます)。 | |
| 10508 | 10565 | 最後に、@code{@@end deffn}コマンドを単独で記述してその定義を終了させます。 |
| 10509 | 10566 | |
| 10510 | 10567 | その他の定義コマンドも同じ書式に沿っています。 |
| @@ -10557,25 +10614,24 @@ This command moves point forward @var{count} words | ||
| 10557 | 10614 | |
| 10558 | 10615 | @noindent |
| 10559 | 10616 | このようにしなかった場合、2番目の単語が実体の名前と間違って解釈されてしまいます。 |
| 10560 | -原則として、最初の行の引数のうち最後の一語を除く引数の語数が複数であれば、それらの引数を括弧で括る必要があります。 | |
| 10561 | -またこれは、テキストがコマンドを含んでいる場合にも必要となります。 | |
| 10562 | -例えばスペイン語で@samp{@{declaraci@@'on@}}と書いている場合などです。 | |
| 10617 | +原則として、最初の行の引数のうち、最後の一語を除く引数の語数が複数であれば、それらの引数を括弧で括る必要があります。 | |
| 10618 | +また、これは、テキストがコマンドを含んでいる場合にも必要となります。 | |
| 10619 | +例えば、スペイン語で@samp{@{declaraci@@'on@}}と書いている場合などです。 | |
| 10563 | 10620 | |
| 10564 | 10621 | 定義コマンドの中には他のものに比べてより汎用的なものもあります。 |
| 10565 | 10622 | 例えば、@code{@@deffn}コマンドは、関数やその類似のもの、つまり引数を取るものに対する汎用の定義コマンドです。 |
| 10566 | 10623 | このコマンドを使用する時には、その実体が属するカテゴリを指定します。 |
| 10567 | -このコマンドを特化させた変種のコマンドが三つ定義されていて(@code{@@defun}コマンド、@code{@@defmac}コマンド、@code{@@defspec}コマンド)、それぞれ「Function」「Macro」「Special Form」というカテゴリをユーザに代わって指定してくれます。 | |
| 10568 | -(Lisp言語では、特殊形式(special form)というのは関数とよく似たものです。) | |
| 10624 | +このコマンドを特化させた変種のコマンドが三つ定義されています(@code{@@defun}コマンド、@code{@@defmac}コマンド、@code{@@defspec}コマンド)。 | |
| 10625 | +それぞれ「Function」「Macro」「Special Form」というカテゴリをユーザに代わって指定してくれます(Lisp言語では、特殊形式(special form)というのは関数とよく似たものです)。 | |
| 10569 | 10626 | 同様に、汎用の@code{@@defvr}コマンドにも、特定の種類の変数を記述するために特化した変種コマンドがいくつか用意されています。 |
| 10570 | 10627 | |
| 10571 | -定義中での@code{@@example}の使い方など、関数定義の詳細な例は@xref{Sample Function Definition}. | |
| 10628 | +定義中での@code{@@example}の使い方など、関数定義の詳細な例は別の節を参照してください(@pxref{Sample Function Definition})。 | |
| 10572 | 10629 | |
| 10573 | 10630 | @cindex Macros in definition commands |
| 10574 | -残念ながら実装が難しいため、@code{@@deffn}コマンドや他の全ての定義コマンドの中ではマクロは展開されません。 | |
| 10631 | +残念ながら、実装が難しいため、@code{@@deffn}コマンドや他の全ての定義コマンドの中ではマクロは展開されません。 | |
| 10575 | 10632 | |
| 10576 | 10633 | |
| 10577 | 10634 | @node Def Cmd Continuation Lines |
| 10578 | -@section Definition Command Continuation Lines | |
| 10579 | 10635 | @section 定義コマンドの継続行 |
| 10580 | 10636 | @cindex Continuation lines in definition commands |
| 10581 | 10637 | @cindex Definition command headings, continuing |
| @@ -10678,7 +10734,7 @@ Texinfoのソースファイルでは、この@code{@@defspec}コマンドの行 | ||
| 10678 | 10734 | |
| 10679 | 10735 | |
| 10680 | 10736 | @node deffnx |
| 10681 | -@section 「一行目」の二行以上の記述 | |
| 10737 | +@section 「一行目」の2行以上の記述 | |
| 10682 | 10738 | @cindex Two `First' Lines for @code{@@deffn} |
| 10683 | 10739 | @cindex Grouping two definitions together |
| 10684 | 10740 | @cindex Definitions grouped together |
| @@ -10716,11 +10772,11 @@ These two search commands are similar except @dots{} | ||
| 10716 | 10772 | @node Def Cmds in Detail |
| 10717 | 10773 | @section 定義コマンド |
| 10718 | 10774 | |
| 10719 | -Texinfoは、1ダースを超える定義コマンドが用意しています。 | |
| 10720 | -それらのコマンドは全てこのセクションで説明します。@refill | |
| 10775 | +Texinfoでは、1ダースを超える定義コマンドが用意されています。 | |
| 10776 | +全てこの節で説明します。@refill | |
| 10721 | 10777 | |
| 10722 | 10778 | 定義コマンドはその実体の名前を適切な索引に自動的に入れます。 |
| 10723 | -例えば、@code{@@deffn}コマンドや@code{@@defun}コマンド、@code{@@defmac}コマンド | |
| 10779 | +例えば、@code{@@deffn}コマンド、@code{@@defun}コマンド、@code{@@defmac}コマンド | |
| 10724 | 10780 | は関数名を関数索引に入れます。 |
| 10725 | 10781 | また、@code{@@defvr}コマンドや@code{@@defvar}コマンドは変数名を変数索引に入れます。@refill |
| 10726 | 10782 |
| @@ -10744,7 +10800,7 @@ Texinfoは、1ダースを超える定義コマンドが用意しています。 | ||
| 10744 | 10800 | @table @code |
| 10745 | 10801 | @findex deffn |
| 10746 | 10802 | @item @@deffn @var{category} @var{name} @var{arguments}@dots{} |
| 10747 | -@code{@@deffn}コマンドは、引数を取ることのある関数や対話的コマンド、あるいは、それらに類似したものに使われる汎用の定義コマンドです。 | |
| 10803 | +@code{@@deffn}コマンドは、引数を取ることのある関数、対話的コマンド、あるいは、それらに類似したものに使われる汎用の定義コマンドです。 | |
| 10748 | 10804 | 定義されるものが属すカテゴリを説明する用語を選択しなければなりません。 |
| 10749 | 10805 | 例えば、その実体が関数であるならば「Function」を使うことが出来るでしょう。 |
| 10750 | 10806 | @code{@@deffn}コマンドは行頭に記述し、続けて同じ行にそのコマンドが説明しようとしている実体のカテゴリと、この特定の実体の名前、そして引数があればその引数を記述します。 |
| @@ -10765,8 +10821,8 @@ Move point forward @@var@{nchars@} characters. | ||
| 10765 | 10821 | これは、引数@var{nchars}を一つ取る@code{forward-char}という名前の「コマンド」についてのかなり簡単な定義を示しています。 |
| 10766 | 10822 | |
| 10767 | 10823 | @code{@@deffn}コマンドは@var{nchars}のような引数名を印刷出力では斜体として出力します。 |
| 10768 | -これはこれらの名前が、メタ構文変数、つまり実際の引数の値の代わりと考えられるからです。 | |
| 10769 | -しかし、デスクリプションのテキスト中では、引数の値を参照するのに、@code{@@var}コマンドを使って明示的に引数名を記述してください。 | |
| 10824 | +これはこれらの名前が、メタ構文変数、つまり、実際の引数の値の代わりと考えられるからです。 | |
| 10825 | +しかし、説明のテキスト中では、引数の値を参照する場合、@code{@@var}コマンドを使って明示的に引数名を記述してください。 | |
| 10770 | 10826 | 上述の例では、この方法で@samp{@@var@{nchars@}}を使用しました。 |
| 10771 | 10827 | |
| 10772 | 10828 | 引数名に@samp{--}が含まれているとか、その他の特殊な処理がされる文字並びが含まれているような特別な場合には(@pxref{Conventions})、その引数を@code{@@var}コマンドで囲んでください。 |
| @@ -10788,7 +10844,7 @@ Move point forward @@var@{nchars@} characters. | ||
| 10788 | 10844 | @code{@@defun}コマンドは関数に対する定義コマンドです。 |
| 10789 | 10845 | @code{@@defun}コマンドは@samp{@@deffn Function @dots{}}コマンドと等価です。 |
| 10790 | 10846 | @code{@@end defun}コマンドを単独で記述して定義を終了してください。 |
| 10791 | -従ってテンプレートは次のようになります。 | |
| 10847 | +したがって、テンプレートは次のようになります。 | |
| 10792 | 10848 | |
| 10793 | 10849 | @example |
| 10794 | 10850 | @group |
| @@ -10805,9 +10861,7 @@ Move point forward @@var@{nchars@} characters. | ||
| 10805 | 10861 | |
| 10806 | 10862 | @findex defspec |
| 10807 | 10863 | @item @@defspec @var{name} @var{arguments}@dots{} |
| 10808 | -@code{@@defspec}コマンドは特殊形式に対する定義コマンドです。 | |
| 10809 | -(Lisp言語において、特殊形式とは関数とよく似たものです。 | |
| 10810 | -@pxref{Special Forms,,, elisp, GNU Emacs Lisp Reference Manual}) | |
| 10864 | +@code{@@defspec}コマンドは特殊形式に対する定義コマンドです(特殊形式とは、Lisp言語にあるもので、関数とよく似たものです(@pxref{Special Forms,,, elisp, GNU Emacs Lisp Reference Manual}))。 | |
| 10811 | 10865 | @code{@@defspec}コマンドは@samp{@@deffn @{Special Form@} @dots{}}コマンドと等価で、@code{@@defun}コマンドと同様に機能します。 |
| 10812 | 10866 | @end table |
| 10813 | 10867 |
| @@ -10822,13 +10876,13 @@ Move point forward @@var@{nchars@} characters. | ||
| 10822 | 10876 | @table @code |
| 10823 | 10877 | @findex defvr |
| 10824 | 10878 | @item @@defvr @var{category} @var{name} |
| 10825 | -@code{@@defvr}コマンドは変数のようなもの、つまり値を記録するものに対する汎用の定義コマンドです。 | |
| 10879 | +@code{@@defvr}コマンドは変数のようなもの、つまり、値を記録するものに対する汎用の定義コマンドです。 | |
| 10826 | 10880 | 定義する実体が属するカテゴリを説明する用語を選択しなければなりません。 |
| 10827 | 10881 | 例えば、その実体が変数であれば「Variable」を使うことが出来るでしょう。 |
| 10828 | 10882 | @code{@@defvr}コマンドを行頭に記述し、その同じ行に続けて、その実体のカテゴリと名前を記述してください。 |
| 10829 | 10883 | |
| 10830 | -カテゴリ名は、タイトルにするのと同じように各語頭を大文字にしてください。 | |
| 10831 | -例えば「User Option」のように、カテゴリ名にスペースが入る場合には、カテゴリ名を中括弧で括ってください。 | |
| 10884 | +カテゴリ名は、タイトルにするのと同じように、各語頭を大文字にしてください。 | |
| 10885 | +例えば、「User Option」のように、カテゴリ名にスペースが入る場合には、カテゴリ名を中括弧で括ってください。 | |
| 10832 | 10886 | そうしなければ、2番目の単語がその実体の名前として誤って解釈されてしまいます。 |
| 10833 | 10887 | 例を挙げます。 |
| 10834 | 10888 |
| @@ -10892,7 +10946,7 @@ the maximum width of filled lines. | ||
| 10892 | 10946 | ユーザオプションはつまり、ユーザが好みに合わせて変更できる変数のことです。 |
| 10893 | 10947 | Emacsにはそういったオプションが多数あります(@pxref{Variables,,, emacs, The GNU Emacs Manual})。 |
| 10894 | 10948 | @code{@@defopt}コマンドは@samp{@@defvr @{User Option@} @dots{}}コマンドと等価で、@code{@@defvar}コマンドと同様に機能します。 |
| 10895 | -またこのコマンドは変数索引にエントリを作成します。 | |
| 10949 | +また、このコマンドは変数索引にエントリを作成します。 | |
| 10896 | 10950 | @end table |
| 10897 | 10951 | |
| 10898 | 10952 |
| @@ -10922,7 +10976,7 @@ Emacsにはそういったオプションが多数あります(@pxref{Variables, | ||
| 10922 | 10976 | |
| 10923 | 10977 | @need 1000 |
| 10924 | 10978 | @noindent |
| 10925 | -(「@dots{}」の前にあるテキストは上記では二行で示されていますが、これは実際のTexinfoファイルでは一行で書かれます。) | |
| 10979 | +(「@dots{}」の前にあるテキストは上記では2行で示されていますが、これは実際のTexinfoファイルでは1行で書かれます。) | |
| 10926 | 10980 | 上記はInfoファイルにおいて以下を生成します。 |
| 10927 | 10981 | |
| 10928 | 10982 | @smallexample |
| @@ -10933,7 +10987,7 @@ Emacsにはそういったオプションが多数あります(@pxref{Variables, | ||
| 10933 | 10987 | @end smallexample |
| 10934 | 10988 | @iftex |
| 10935 | 10989 | |
| 10936 | -印刷されたマニュアルでは、以下のように生成されます。 | |
| 10990 | +印刷されたマニュアルでは以下のように生成されます。 | |
| 10937 | 10991 | |
| 10938 | 10992 | @quotation |
| 10939 | 10993 | @deftypefn {Library Function} int foobar (int @var{foo}, float @var{bar}) |
| @@ -10963,7 +11017,7 @@ Emacsにはそういったオプションが多数あります(@pxref{Variables, | ||
| 10963 | 11017 | @noindent |
| 10964 | 11018 | @var{category}や@var{data type}の語数が複数ある場合には、一つの引数として扱うように中括弧で括らなければなりませんので注意してください。@refill |
| 10965 | 11019 | |
| 10966 | -Adaのようにパッケージを持つ言語のプロシージャを記述している場合、前のパラグラフで説明した慣習とは幾分対照的な方法で@code{@@deftypefn}コマンドを使うことを考慮しても良いでしょう。 | |
| 11020 | +Adaのようにパッケージを持つ言語のプロシージャを記述している場合、前の段落で説明した慣習とは幾分対照的な方法で@code{@@deftypefn}コマンドを使うことを考慮しても良いでしょう。 | |
| 10967 | 11021 | 例えば以下を見てください。 |
| 10968 | 11022 | |
| 10969 | 11023 | @example |
| @@ -10977,7 +11031,7 @@ Adaのようにパッケージを持つ言語のプロシージャを記述し | ||
| 10977 | 11031 | @end example |
| 10978 | 11032 | |
| 10979 | 11033 | @noindent |
| 10980 | -(この@code{@@deftypefn}の引数は継続(@pxref{Def Cmd Continuation Lines})を使用して示されていますが、実際のTexinfoファイルでは一行にすることが出来ます。) | |
| 11034 | +(この@code{@@deftypefn}の引数は継続(@pxref{Def Cmd Continuation Lines})を使用して示されていますが、実際のTexinfoファイルでは1行にすることが出来ます。) | |
| 10981 | 11035 | |
| 10982 | 11036 | この例では、このプロシージャは、「procedure」として分類するのではなく、@code{stacks}というパッケージに属しているものとして分類されています。 |
| 10983 | 11037 | データ型は@code{private}として記述されています。 |
| @@ -11014,9 +11068,9 @@ Adaのようにパッケージを持つ言語のプロシージャを記述し | ||
| 11014 | 11068 | @table @code |
| 11015 | 11069 | @findex deftypevr |
| 11016 | 11070 | @item @@deftypevr @var{category} @var{data-type} @var{name} |
| 11017 | -@code{@@deftypevr}コマンドは型付き言語における変数のようなもの、つまり値を記録するものに対する汎用の定義コマンドです。 | |
| 11071 | +@code{@@deftypevr}コマンドは型付き言語における変数のようなもの、つまり、値を記録するものに対する汎用の定義コマンドです。 | |
| 11018 | 11072 | 定義しようとしている実体のカテゴリを説明する用語を選択しなければなりません。 |
| 11019 | -例えばその実体が変数であれば「Variable」を使うことが出来るでしょう。@refill | |
| 11073 | +例えば、その実体が変数であれば「Variable」を使うことが出来るでしょう。@refill | |
| 11020 | 11074 | |
| 11021 | 11075 | @code{@@deftypevr}コマンドは行頭に記述し、同じ行に続けて、説明している実 |
| 11022 | 11076 | 体の属すカテゴリ、データ型、この特定の実体の名前を記述します。@refill |
| @@ -11090,11 +11144,11 @@ Adaのようにパッケージを持つ言語のプロシージャを記述し | ||
| 11090 | 11144 | @item @@deftp @var{category} @var{name} @var{attributes}@dots{} |
| 11091 | 11145 | @code{@@deftp}コマンドはデータ型用の汎用定義コマンドです。 |
| 11092 | 11146 | このコマンドは行頭に記述し、同じ行に続けて、カテゴリ、型名(@code{int}や@code{float}のような語)、そして、その型のオブジェクトのアトリビュート名を記述します。 |
| 11093 | -従って、このコマンドは@code{int}や@code{float}を説明するのに使用することが出来ます。 | |
| 11147 | +したがって、このコマンドは@code{int}や@code{float}を説明するのに使用することが出来ます。 | |
| 11094 | 11148 | その場合、カテゴリとしては@code{data type}を使うことが出来るでしょう。 |
| 11095 | 11149 | (データ型は、あるオブジェクトに対して実行可能な操作を決定するために使われるカテゴリです。)@refill |
| 11096 | 11150 | |
| 11097 | -例えばLisp言語において、@dfn{pair}はある特定のデータ型を指し、その型のオジェクトには@sc{car}と@sc{cdr}と呼ばれるスロットが二つあります。 | |
| 11151 | +例えば、Lisp言語において、@dfn{pair}はある特定のデータ型を指し、その型のオジェクトには@sc{car}と@sc{cdr}と呼ばれるスロットが二つあります。 | |
| 11098 | 11152 | 以下に、@code{pair}の定義の一行目をどのように書くかということを示します。@refill |
| 11099 | 11153 | |
| 11100 | 11154 | @example |
| @@ -11126,7 +11180,7 @@ Adaのようにパッケージを持つ言語のプロシージャを記述し | ||
| 11126 | 11180 | @cindex Object-oriented programming |
| 11127 | 11181 | |
| 11128 | 11182 | 以下は、オブジェクト指向プログラミングで使用されるような抽象オブジェクトについての説明を書式化するのに使用されるコマンドです。 |
| 11129 | -クラスは抽象オブジェクトの定義された型です。 | |
| 11183 | +クラスは定義された抽象オブジェクト型です。 | |
| 11130 | 11184 | クラスのインスタンスはそのクラスの型を持つ特定のオブジェクトのことです。 |
| 11131 | 11185 | インスタンス変数はそのクラスに属す変数ですが、各インスタンスがその変数に対して独自の値を保持することが出来ます。 |
| 11132 | 11186 |
| @@ -11254,7 +11308,7 @@ Adaのようにパッケージを持つ言語のプロシージャを記述し | ||
| 11254 | 11308 | |
| 11255 | 11309 | メソッドと@dfn{オペレーション}を区別するほうが便利な場合もあります。 |
| 11256 | 11310 | オペレーションとはメソッドの仕様とみなすことが出来ます。 |
| 11257 | -従って、例えばあるウィンドウシステムは全てのウィンドウクラスが@code{expose}という名前のメソッドを持っていると条件付けているかもしれません。 | |
| 11311 | +したがって、例えば、あるウィンドウシステムは全てのウィンドウクラスが@code{expose}という名前のメソッドを持っていると条件付けているかもしれません。 | |
| 11258 | 11312 | このウィンドウシステムでは、ウィンドウには普通@code{expose}というオペレーションが定義されていると言えるでしょう。 |
| 11259 | 11313 | 通常、オペレーションには名前があり、引数のパターンも指定されています。 |
| 11260 | 11314 | そのオペレーションを実装するメソッドは全て同じ引数を受け付けなければなりません。 |
| @@ -11331,7 +11385,7 @@ they were usually defined with @code{defmethod}. | ||
| 11331 | 11385 | @cindex Definition conventions |
| 11332 | 11386 | @cindex Conventions for writing definitions |
| 11333 | 11387 | |
| 11334 | -@code{@@deffn}コマンドや@code{@@defun}コマンド、あるいはその他の定義コマンドのいずれかを使って定義を書く場合、例えば@code{forward-word}関数に対する@var{count}引数のように、その意味を表す引数を使うように十分注意してください。 | |
| 11388 | +@code{@@deffn}コマンドや@code{@@defun}コマンド、あるいは、その他の定義コマンドのいずれかを使って定義を書く場合、例えば@code{forward-word}関数に対する@var{count}引数のように、その意味を表す引数を使うように十分注意してください。 | |
| 11335 | 11389 | また、引数の名前に@var{integer}のような型名が含まれている場合、その引数が実際にその型を持つのか注意するようにしてください。@refill |
| 11336 | 11390 | |
| 11337 | 11391 |
| @@ -11345,7 +11399,7 @@ they were usually defined with @code{defmethod}. | ||
| 11345 | 11399 | 関数定義には@code{@@defun}コマンドと@code{@@end defun}コマンドを使用します。 |
| 11346 | 11400 | @code{@@defun}コマンドの直後に関数名を記述し、同じ行に続けてパラメータリストを記述します。 |
| 11347 | 11401 | |
| 11348 | -以下は、@ref{Calling Functions,,, elisp, The GNU Emacs Lisp Reference Manual}からの定義です。 | |
| 11402 | +以下は別のマニュアルからの定義です(@pxref{Calling Functions,,, elisp, The GNU Emacs Lisp Reference Manual})。 | |
| 11349 | 11403 | |
| 11350 | 11404 | @quotation |
| 11351 | 11405 | @defun apply function &rest arguments |
| @@ -11611,11 +11665,11 @@ This will be in Info, but not plain text. | ||
| 11611 | 11665 | @cindex Plain @TeX{} |
| 11612 | 11666 | |
| 11613 | 11667 | @code{@@iftex}コマンドと@code{@@end iftex}コマンドで区切られた領域の内部には生の@TeX{}コマンドをいくつか埋め込むことが出来ます。 |
| 11614 | -Texinfoの処理プログラムは、@TeX{}出力が生成されない場合、そういった領域を無視します。 | |
| 11668 | +@TeX{}出力が生成されない場合、Texinfoの処理プログラムはそういった領域を無視します。 | |
| 11615 | 11669 | 通常の@TeX{}ファイルにコマンドを記述するのと同じように@TeX{}コマンドを記述することが出来ます。 |
| 11616 | 11670 | ただし、@TeX{}で使用される@samp{\}文字を@samp{@@}に置き換えなければなりません。 |
| 11617 | 11671 | 例えば、Texinfoファイルの@code{@@titlepage}セクションにおいて、@TeX{}の@code{@@vskip}コマンドを使って、著作権のページを書式化することが出来ます。 |
| 11618 | -(@code{@@titlepage}コマンドを使うと、@code{@@iftex}コマンドの場合と同じように、Infoはその領域を自動的に無視するようになります。) | |
| 11672 | +(@code{@@titlepage}コマンドを使うと、@code{@@iftex}コマンドの場合と同じようにInfoはその領域を自動的に無視するようになります。) | |
| 11619 | 11673 | |
| 11620 | 11674 | しかし、plain @TeX{}の機能の大半はTexinfoの機能でオーバーライドされていて、@code{@@iftex}内では動作しません。 |
| 11621 | 11675 | @code{@@iftex}コマンドの目的は、Texinfoソースの条件付処理を提供することにあります。 |
| @@ -11626,11 +11680,11 @@ Texinfoの処理プログラムは、@TeX{}出力が生成されない場合、 | ||
| 11626 | 11680 | また、@TeX{}コマンドでは@samp{\}を使うことが出来ます。 |
| 11627 | 11681 | plain @TeX{}のコマンドとカテゴリコードは全て、@code{@@tex}の領域内では元に戻されます。 |
| 11628 | 11682 | 唯一の例外は、@code{@@end tex}コマンドを正しく認識できるように、@code{@@}文字が依然としてコマンドを開始する機能を持っていることです。 |
| 11629 | -@code{@@iftex}コマンドの場合と同様、Texinfoの処理プログラムは、@TeX{}出力が生成されない場合には、このような領域を無視します。 | |
| 11683 | +@code{@@iftex}コマンドの場合と同様、@TeX{}出力が生成されない場合には、Texinfoの処理プログラムはこのような領域を無視します。 | |
| 11630 | 11684 | |
| 11631 | 11685 | @findex \gdef @r{within @code{@@tex}} |
| 11632 | 11686 | 複雑なケースでは、@code{@@tex}の内部で@TeX{}の新しいマクロを定義したくなることがあるかもしれません。 |
| 11633 | -それを実現するには@code{\def}ではなく、@code{\gdef}を使用しなければなりません。 | |
| 11687 | +それを実現するには、@code{\def}ではなく@code{\gdef}を使用しなければなりません。 | |
| 11634 | 11688 | これは、@code{@@tex}領域が@TeX{}のグループの中で処理されるからです。 |
| 11635 | 11689 | |
| 11636 | 11690 | @cindex Mathematical expressions |
| @@ -11645,8 +11699,8 @@ $$ \chi^2 = \sum_@{i=1@}^N | ||
| 11645 | 11699 | @end example |
| 11646 | 11700 | |
| 11647 | 11701 | @noindent |
| 11648 | -この例の出力は印刷されたマニュアルにだけ現われます。 | |
| 11649 | -これをInfoで読んでいる場合には、印刷されたマニュアルでは現われる等式は見えないでしょう。 | |
| 11702 | +この例の出力は印刷マニュアルにだけ現われます。 | |
| 11703 | +これをInfoで読んでいる場合には、印刷マニュアルでは現われる等式は見えないでしょう。 | |
| 11650 | 11704 | @iftex |
| 11651 | 11705 | 印刷されたマニュアルでは、上記の式は次のように見えます。 |
| 11652 | 11706 | @end iftex |
| @@ -11659,35 +11713,36 @@ $$ \chi^2 = \sum_{i=1}^N | ||
| 11659 | 11713 | |
| 11660 | 11714 | @findex ifhtml |
| 11661 | 11715 | @findex html |
| 11662 | -同様に、@code{@@ifhtml @dots{} @@end ifhtml}を使ってHTML出力にだけインクルードされる領域を区切ることが出来ます。 | |
| 11663 | -また@code{@@html @dots{} @@end html}を使うと生のHTMLを記述できる領域となります。 | |
| 11716 | +同様に、@code{@@ifhtml @dots{} @@end ifhtml}を使って、HTML出力にだけインクルードされる領域を区切ることが出来ます。 | |
| 11717 | +また、@code{@@html @dots{} @@end html}を使うと、生のHTMLを記述できる領域となります。 | |
| 11664 | 11718 | |
| 11665 | 11719 | @findex ifxml |
| 11666 | 11720 | @findex xml |
| 11667 | -また同様に、@code{@@ifxml @dots{} @@end ifxml}を使ってXML出力にだけインクルードされる領域を区切ることが出来ます。 | |
| 11668 | -また、@code{@@xml @dots{} @@end xml}を使うと生のXMLを記述できる領域となります。 | |
| 11721 | +また、同様に、@code{@@ifxml @dots{} @@end ifxml}を使って、XML出力にだけインクルードされる領域を区切ることが出来ます。 | |
| 11722 | +また、@code{@@xml @dots{} @@end xml}を使うと、生のXMLを記述できる領域となります。 | |
| 11669 | 11723 | |
| 11670 | 11724 | @findex ifdocbook |
| 11671 | 11725 | @findex docbook |
| 11672 | -さらに同様に、@code{@@ifdocbook @dots{} @@end ifdocbook}を使ってDocbook出力にだけインクルードされる領域を区切ることが出来ます。 | |
| 11673 | -また、@code{@@docbook @dots{} @@end docbook}を使うと生のDocbookを記述できる領域となります。 | |
| 11726 | +さらに、同様に、@code{@@ifdocbook @dots{} @@end ifdocbook}を使って、Docbook出力にだけインクルードされる領域を区切ることが出来ます。 | |
| 11727 | +また、@code{@@docbook @dots{} @@end docbook}を使うと、生のDocbookを記述できる領域となります。 | |
| 11674 | 11728 | |
| 11675 | 11729 | これら全ての場合において、生のデータ処理の例外となっているのは、@code{@@}が依然としてエスケープ文字であることです。 |
| 11676 | -そうすることで@code{@@end}コマンドが認識できることになります。 | |
| 11730 | +そうすることで、@code{@@end}コマンドが認識できることになります。 | |
| 11677 | 11731 | |
| 11678 | 11732 | |
| 11679 | 11733 | @node set clear value |
| 11680 | -@section @code{@@set}、@code{@@clear}、@code{@@value} | |
| 11734 | +@section @code{@@set}・@code{@@clear}・@code{@@value} | |
| 11681 | 11735 | |
| 11682 | 11736 | @code{@@set}コマンド、@code{@@clear}コマンド、@code{@@ifset}コマンド、@code{@@ifclear}コマンドを使ってTexinfoの書式化コマンドに指示することで、Texinfoファイルの各部分を書式化したり無視したりすることが出来ます。 |
| 11683 | 11737 | |
| 11684 | 11738 | これらのコマンドの簡単な説明を以下に示します。 |
| 11685 | -詳細は後節を参照してください。 | |
| 11739 | +詳細は後の節を参照してください。 | |
| 11686 | 11740 | |
| 11687 | 11741 | @table @code |
| 11688 | 11742 | @item @@set @var{flag} [@var{value}] |
| 11689 | 11743 | 変数@var{flag}を設定します。 |
| 11690 | -@var{value}は省略可能で、指定されていれば値を@var{value}に設定します。 | |
| 11744 | +@var{value}は省略可能です。 | |
| 11745 | +指定されていれば値を@var{value}に設定します。 | |
| 11691 | 11746 | |
| 11692 | 11747 | @item @@clear @var{flag} |
| 11693 | 11748 | 変数@var{flag}を未定義にします。 |
| @@ -11715,8 +11770,8 @@ $$ \chi^2 = \sum_{i=1}^N | ||
| 11715 | 11770 | @findex value |
| 11716 | 11771 | @findex clear |
| 11717 | 11772 | |
| 11718 | -@code{@@set}コマンドを使ってフラグの値を指定することが出来ます。 | |
| 11719 | -フラグの値は後で@code{@@value}コマンドを使って展開されます。 | |
| 11773 | +@code{@@set}コマンドを使って、フラグの値を指定することが出来ます。 | |
| 11774 | +後で@code{@@value}コマンドを使って、フラグの値は展開されます。 | |
| 11720 | 11775 | |
| 11721 | 11776 | @dfn{フラグ}(別名:@dfn{変数})は識別子です。 |
| 11722 | 11777 | フラグ名には@samp{-}や@samp{_}を使わず、文字と数字だけを使うのがベストです。 |
| @@ -11732,10 +11787,10 @@ $$ \chi^2 = \sum_{i=1}^N | ||
| 11732 | 11787 | @end example |
| 11733 | 11788 | |
| 11734 | 11789 | @noindent |
| 11735 | -これはフラグ@code{foo}の値を「This is a string.」に設定します。 | |
| 11790 | +これは、フラグ@code{foo}の値を「This is a string.」に設定します。 | |
| 11736 | 11791 | |
| 11737 | -Texinfoの書式化プログラムは@code{@@value@{@var{flag}@}}コマンドをフラグ@var{flag}に設定されている文字列で置き換えます。 | |
| 11738 | -従って、フラグ@code{foo}が上記の通りに設定されていれば、Texinfoの書式化プログラムは次の変換を行ないます。 | |
| 11792 | +Texinfoの書式化プログラムは、@code{@@value@{@var{flag}@}}コマンドを、フラグ@var{flag}に設定されている文字列で置き換えます。 | |
| 11793 | +したがって、フラグ@code{foo}が上記の通りに設定されていれば、Texinfoの書式化プログラムは次の変換を行ないます。 | |
| 11739 | 11794 | |
| 11740 | 11795 | @example |
| 11741 | 11796 | @group |
| @@ -11745,8 +11800,8 @@ This is a string. | ||
| 11745 | 11800 | @end group |
| 11746 | 11801 | @end example |
| 11747 | 11802 | |
| 11748 | -パラグラフの中で@code{@@value}コマンドを記述することも可能です。 | |
| 11749 | -しかし@code{@@set}コマンドはその行にそのコマンドだけ単独で記述しなければなりません。 | |
| 11803 | +段落の中で@code{@@value}コマンドを記述することも可能です。 | |
| 11804 | +しかし、@code{@@set}コマンドは単独でその行に記述しなければなりません。 | |
| 11750 | 11805 | |
| 11751 | 11806 | @code{@@set}コマンドを次のように書いたとします。 |
| 11752 | 11807 |
| @@ -11756,7 +11811,7 @@ This is a string. | ||
| 11756 | 11811 | |
| 11757 | 11812 | @noindent |
| 11758 | 11813 | 文字列は指定していません。 |
| 11759 | -この場合@code{foo}の値は空文字列となります。 | |
| 11814 | +この場合、@code{foo}の値は空文字列となります。 | |
| 11760 | 11815 | |
| 11761 | 11816 | @code{@@clear @var{flag}}コマンドを使って前に設定されていたフラグをクリアした場合、それ以降の@code{@@value@{flag@}}コマンドはエラーを報告します。 |
| 11762 | 11817 |
| @@ -11767,7 +11822,7 @@ This is a string. | ||
| 11767 | 11822 | @end example |
| 11768 | 11823 | |
| 11769 | 11824 | @noindent |
| 11770 | -すると書式化プログラムは次の変換を行ないます。 | |
| 11825 | +すると、書式化プログラムは次の変換を行ないます。 | |
| 11771 | 11826 | |
| 11772 | 11827 | @example |
| 11773 | 11828 | @group |
| @@ -11800,7 +11855,7 @@ It is a @{No value for "howmuch"@} wet day. | ||
| 11800 | 11855 | |
| 11801 | 11856 | @findex ifset |
| 11802 | 11857 | @var{flag}フラグが設定されている場合、Texinfoの書式化コマンドは、それ以降の@code{@@ifset @var{flag}}コマンドと@code{@@end ifset}コマンドの組について、その間にあるテキストを書式化します。 |
| 11803 | -@var{flag}フラグがクリアされている場合、Texinfoの書式化コマンドは、同じテキストを@emph{書式化しません}。 | |
| 11858 | +@var{flag}フラグがクリアされている場合、Texinfoの書式化コマンドは同じテキストを@emph{書式化しません}。 | |
| 11804 | 11859 | @code{@@ifclear}コマンドも同様な操作を行ないます。 |
| 11805 | 11860 | |
| 11806 | 11861 | 条件付きで書式化されるテキストは、@code{@@ifset @var{flag}}コマンドと@code{@@end ifset}コマンドの間に記述してください。 |
| @@ -11836,9 +11891,10 @@ Remember to replant promptly @dots{} | ||
| 11836 | 11891 | @var{flag}フラグがクリアされている場合、Texinfoの書式化コマンドは@code{@@ifset @var{flag}}コマンドと@code{@@end ifset}コマンドに挟まれたテキストを@emph{書式化しません}。 |
| 11837 | 11892 | 該当するテキストは無視され、印刷出力にもInfo出力にも現われません。 |
| 11838 | 11893 | |
| 11839 | -例えば、@code{@@set large}コマンドの後ろ(しかし条件コマンドの前)で@code{@@clear large}コマンドを使用して上記の例のフラグをクリアした場合、Texinfoの書式化コマンドは@code{@@ifset large}コマンドと@code{@@end ifset}コマンドに挟まれたテキストを無視します。 | |
| 11894 | +例えば、@code{@@set large}コマンドの後ろ(しかし条件コマンドの前)で@code{@@clear large}コマンドを使用して、上記の例のフラグをクリアしたとします。 | |
| 11895 | +その場合、Texinfoの書式化コマンドは、@code{@@ifset large}コマンドと@code{@@end ifset}コマンドに挟まれたテキストを無視します。 | |
| 11840 | 11896 | 書式化された出力には当該テキストは現われません。 |
| 11841 | -印刷出力でもInfo出力でも「You can use this machine to dig up shrubs without hurting them. Remember to replant promptly @dots{}」という行が表示されるだけです。 | |
| 11897 | +印刷出力でもInfo出力でも、「You can use this machine to dig up shrubs without hurting them. Remember to replant promptly @dots{}」という行が表示されるだけです。 | |
| 11842 | 11898 | |
| 11843 | 11899 | @findex ifclear |
| 11844 | 11900 | @code{@@clear @var{flag}}コマンドを使ってフラグをクリアした場合、書式化コマンドは、それ以降にある@code{@@ifclear}コマンドと@code{@@end ifclear}コマンドの組で挟まれたテキストを書式化します。 |
| @@ -11855,9 +11911,9 @@ Remember to replant promptly @dots{} | ||
| 11855 | 11911 | @subsection @code{@@value}コマンドの使用例 |
| 11856 | 11912 | |
| 11857 | 11913 | @code{@@value}コマンドを使用すると、マニュアルの更新時に変更する必要がある箇所を最小限にすることが出来ます。 |
| 11858 | -Automakeの配布物で使用するためにこの機能を利用する例の完全なテキストについては、@xref{GNU Sample Texts}. | |
| 11914 | +Automakeの配布物で使用するためにこの機能を利用する例の完全なテキストについては別の節を参照してください(@pxref{GNU Sample Texts})。 | |
| 11859 | 11915 | |
| 11860 | -この例は@ref{Top,, Overview, make, The GNU Make Manual}を作り変えたものです。 | |
| 11916 | +この例は、別のマニュアルのものを作り変えたものです(@pxref{Top,, Overview, make, The GNU Make Manual})。 | |
| 11861 | 11917 | |
| 11862 | 11918 | @enumerate |
| 11863 | 11919 | @item |
| @@ -11937,7 +11993,7 @@ of `The GNU Make Manual', for `make', Version 3.63 Beta. | ||
| 11937 | 11993 | @end example |
| 11938 | 11994 | @end enumerate |
| 11939 | 11995 | |
| 11940 | -このマニュアルを更新する際には、フラグの値を変更するだけです。 | |
| 11996 | +このマニュアルを更新する際にはフラグの値を変更するだけです。 | |
| 11941 | 11997 | 三つあるセクションは編集する必要がありません。 |
| 11942 | 11998 | |
| 11943 | 11999 |
| @@ -11967,7 +12023,7 @@ Somevar is set, anothervar is not. | ||
| 11967 | 12023 | @@end ifset |
| 11968 | 12024 | @end example |
| 11969 | 12025 | |
| 11970 | -厳密には、Texinfoは、無視されるテキストが、失敗する条件コマンドに対して適切にネストしているということを必要としています。 | |
| 12026 | +厳密には、Texinfoは、無視されるテキストが失敗する条件コマンドに対して適切にネストしているということを必要としています。 | |
| 11971 | 12027 | 残念ながら、@emph{全ての}条件コマンドが正しくネストされていることを常に調べられるわけではありません。 |
| 11972 | 12028 | そうするには、処理プログラムが無視されるテキストを完全に解釈できなければならないからです。 |
| 11973 | 12029 | それではこのコマンドの目的には合致しません。 |
| @@ -11994,7 +12050,7 @@ Somevar is set, anothervar is not. | ||
| 11994 | 12050 | Texinfoは英語以外の言語で記述することをサポートしています。 |
| 11995 | 12051 | しかし、この領域については今後も相当な作業が必要です。 |
| 11996 | 12052 | |
| 11997 | -Texinfoがサポートしている様々なアクセント文字や特殊文字の一覧については、@ref{Inserting Accents}を参照してください。 | |
| 12053 | +Texinfoがサポートしている様々なアクセント文字や特殊文字の一覧については別の節を参照してください(@pxref{Inserting Accents})。 | |
| 11998 | 12054 | |
| 11999 | 12055 | @menu |
| 12000 | 12056 | * documentlanguage:: Declaring the current language. |
| @@ -12011,7 +12067,7 @@ Texinfoがサポートしている様々なアクセント文字や特殊文字 | ||
| 12011 | 12067 | @cindex Document language, declaring |
| 12012 | 12068 | |
| 12013 | 12069 | @code{@@documentlanguage}コマンドはドキュメントの現在のロケールを宣言するものです。 |
| 12014 | -ファイルの冒頭付近の@code{@@setfilename}コマンドの後に、このコマンド単独の行で記述してください(@pxref{setfilename,,@code{@@setfilename}})。 | |
| 12070 | +ファイルの冒頭付近の@code{@@setfilename}コマンドの後にこのコマンド単独の行で記述してください(@pxref{setfilename,,@code{@@setfilename}})。 | |
| 12015 | 12071 | |
| 12016 | 12072 | @example |
| 12017 | 12073 | @@documentlanguage @var{ll}[_@var{cc}] |
| @@ -12037,11 +12093,11 @@ Infoやその他のオンライン用の出力では、このコマンドは、 | ||
| 12037 | 12093 | 例えば、@code{@@setdocumentlanguage de_DE}が指定されている場合、@TeX{}はまず、@file{txi-de_DE.tex}というファイルを探し、次に@file{txi-de.tex}というファイルを探します。 |
| 12038 | 12094 | |
| 12039 | 12095 | これらの@file{txi-*}ファイルは、例えば「Chapter」や「See」など、@TeX{}の出力で使用される様々な英単語を再定義するのに使用されます。 |
| 12040 | -こういった個々の単語は必ずしも個別に翻訳が可能ではないことは分かっていますし、中でも表意文字で書かれるものに対しては、全く異なった戦略が必要となるでしょう。 | |
| 12096 | +こういった個々の単語は必ずしも個別に翻訳が可能ではないことは分かっていますし、中でも、表意文字で書かれるものに対しては全く異なった戦略が必要となるでしょう。 | |
| 12041 | 12097 | Texinfoにおける言語サポートを改善するための支援は喜んで受け入れます。 |
| 12042 | 12098 | |
| 12043 | 12099 | @cindex Hyphenation patterns, language-dependent |
| 12044 | -このコマンドによって、@TeX{}で使用されるハイフン処理の現在のパターンも変更できると良いのでしょうが、現在のところ実装には至っていません。 | |
| 12100 | +@TeX{}で使用されるハイフン処理の現在のパターンもこのコマンドによって変更できると良いのでしょうが、現在のところ実装には至っていません。 | |
| 12045 | 12101 | |
| 12046 | 12102 | 2006年9月、W3C Internationalization Activityが言語指定に関する新たな勧告をリリースしました。 |
| 12047 | 12103 | @url{http://www.rfc-editor.org/rfc/bcp/bcp47.txt}です。 |
| @@ -12074,7 +12130,7 @@ Gettextがこの新しいスキームをサポートする時にTexinfoもそう | ||
| 12074 | 12130 | @@documentencoding @var{enc} |
| 12075 | 12131 | @end example |
| 12076 | 12132 | |
| 12077 | -現時点ではTexinfoは以下のエンコーディングだけをサポートしています。 | |
| 12133 | +現時点では、Texinfoは、以下のエンコーディングだけをサポートしています。 | |
| 12078 | 12134 | |
| 12079 | 12135 | @table @code |
| 12080 | 12136 | @item US-ASCII |
| @@ -12088,7 +12144,7 @@ Texinfoの処理プログラムは、Unicodeに対する細かい部分まで処 | ||
| 12088 | 12144 | @itemx ISO-8859-1 |
| 12089 | 12145 | @itemx ISO-8859-15 |
| 12090 | 12146 | @item ISO-8859-2 |
| 12091 | -これらはそれぞれ西欧における言語(最初の二つ)と東欧における言語(三番目のもの)の標準的なエンコーディングを指定するものです。 | |
| 12147 | +これらは、それぞれ、西欧における言語(最初の二つ)と東欧における言語(三番目のもの)の標準的なエンコーディングを指定するものです。 | |
| 12092 | 12148 | ISO-8859-15は、8859-1からあまり使われない文字(例えば分数記号)を、ユーロのシンボル(@euro{})のように、もう少し広く必要とされる文字に置き換えたものです。 |
| 12093 | 12149 | |
| 12094 | 12150 | このエンコーディングに関するちゃんとした説明はここでは埒外です。 |
| @@ -12117,7 +12173,7 @@ coding: @var{enc} | ||
| 12117 | 12173 | End: |
| 12118 | 12174 | @end example |
| 12119 | 12175 | |
| 12120 | -また、Info出力やプレインテキストの出力では、@option{--disable-encoding}が無い場合、例えば@code{@@'e}のようなアクセントコンストラクトや特殊文字が、指定エンコーディングにおける実際の8ビット文字として出力されます。 | |
| 12176 | +また、Info出力やプレインテキストの出力では、@option{--disable-encoding}が無い場合、例えば、@code{@@'e}のようなアクセントコンストラクトや特殊文字が、指定エンコーディングにおける実際の8ビット文字として出力されます。 | |
| 12121 | 12177 | |
| 12122 | 12178 | @cindex HTML output, and encodings |
| 12123 | 12179 | @cindex @code{http-equiv}, and charset specification |
| @@ -12136,7 +12192,7 @@ HTML出力では、@samp{<head>}セクション内に、@var{enc}を指定する | ||
| 12136 | 12192 | XML出力とDocbook出力においては、それぞれの書式で通常行なわれる方法によって、指定されたドキュメントエンコーディングがファイルに書き出されます。 |
| 12137 | 12193 | |
| 12138 | 12194 | @TeX{}出力では、標準のComputer Modernフォントでサポートされている文字はそれなりに出力されます。 |
| 12139 | -(例えばこれは、事前に用意されたグリフではなく構成されたアクセントを使用するという意味です。) | |
| 12195 | +(例えば、これは、事前に用意されたグリフではなく構成されたアクセントを使用するという意味です。) | |
| 12140 | 12196 | 見当らない文字を使うと、未実装のエンコーディングを指定したのと同じく、警告メッセージが生成されます。 |
| 12141 | 12197 | |
| 12142 | 12198 |
| @@ -12196,7 +12252,7 @@ Texinfoの@code{@@macro}コマンドを使ってマクロを定義します。 | ||
| 12196 | 12252 | @cindex Macro names, valid characters in |
| 12197 | 12253 | @cindex Names of macros, valid characters of |
| 12198 | 12254 | マクロを常に@TeX{}と一緒に使えるようにするためには、@var{macroname}は完全に英文字だけで構成しなければなりません。 |
| 12199 | -つまり数字やハイフン、アンダースコア、その他特殊な文字は使えません。 | |
| 12255 | +つまり、数字、ハイフン、アンダースコア、その他特殊な文字は使えません。 | |
| 12200 | 12256 | ですので、英文字だけ使用することを推奨します。 |
| 12201 | 12257 | しかし、@command{makeinfo}は@samp{@{@}_^=}以外は何でも受け付けます。 |
| 12202 | 12258 | 後ろにスペースを付けなくても@code{@@math}モードでマクロを呼び出せるように、@samp{_}と@samp{^}は除外されています(@pxref{math,,@code{@@math}})。 |
| @@ -12207,11 +12263,11 @@ Texinfoの@code{@@macro}コマンドを使ってマクロを定義します。 | ||
| 12207 | 12263 | @cindex Body of a macro |
| 12208 | 12264 | @cindex Mutually recursive macros |
| 12209 | 12265 | @cindex Recursion, mutual |
| 12210 | -マクロの定義、つまり@dfn{本体}には、Texinfoコマンドの大半を書くことが出来ます。 | |
| 12266 | +マクロの定義、つまり、@dfn{本体}には、Texinfoコマンドの大半を書くことが出来ます。 | |
| 12211 | 12267 | それ以前に定義されたマクロも記述できます。 |
| 12212 | 12268 | 定義されていないマクロの呼び出しは許されません。 |
| 12213 | 12269 | ですので、Texinfoマクロを相互再帰することは出来ません。 |
| 12214 | -また、別のマクロを定義するマクロ定義は、@code{@@macro}コマンドの設計上の制約により@TeX{}では動作しません。 | |
| 12270 | +また、@code{@@macro}コマンドの設計上の制約により、別のマクロを定義するマクロ定義は@TeX{}では動作しません。 | |
| 12215 | 12271 | |
| 12216 | 12272 | @cindex Parameters to macros |
| 12217 | 12273 | マクロの本体では、上の例の@samp{\@var{param1}\}のように前後をバックスラッシュで挟まれたパラメータ名のインスタンスは、マクロ呼び出しで指定された対応する引数に置き換えられます。 |
| @@ -12225,12 +12281,12 @@ Texinfoの@code{@@macro}コマンドを使ってマクロを定義します。 | ||
| 12225 | 12281 | @cindex Spaces in macros |
| 12226 | 12282 | @cindex Whitespace in macros |
| 12227 | 12283 | @code{@@macro}行の後ろにある改行と@code{@@end macro}行の前にある改行は無視されます。 |
| 12228 | -つまりマクロ本体には含まれません。 | |
| 12229 | -他の空白は全て通常のTexinfoのルールに沿って処理されます。 | |
| 12284 | +つまり、マクロ本体には含まれません。 | |
| 12285 | +他の空白は、通常のTexinfoのルールに沿って全て処理されます。 | |
| 12230 | 12286 | |
| 12231 | 12287 | @cindex Recursive macro invocations |
| 12232 | 12288 | @findex rmacro |
| 12233 | -マクロを再帰的に使えるようにするため、つまりマクロの呼び出しにそのマクロ自身を入れられるようにするためには、@samp{@@rmacro}コマンドを使ってマクロを定義しなければななりません。 | |
| 12289 | +マクロを再帰的に使えるようにするため、つまり、マクロの呼び出しにそのマクロ自身を入れられるようにするためには、@samp{@@rmacro}コマンドを使ってマクロを定義しなければななりません。 | |
| 12234 | 12290 | 次のようになります。 |
| 12235 | 12291 | |
| 12236 | 12292 | @example |
| @@ -12241,7 +12297,7 @@ a\arg\b | ||
| 12241 | 12297 | @@rmac@{1@@rmac@{text@}2@} |
| 12242 | 12298 | @end example |
| 12243 | 12299 | |
| 12244 | -これによって「a1atextb2b」という出力が生成されます。 | |
| 12300 | +これによって、「a1atextb2b」という出力が生成されます。 | |
| 12245 | 12301 | @samp{@@rmacro}でなく@samp{@@macro}を使用すると、エラーメッセージが出力されます。 |
| 12246 | 12302 | |
| 12247 | 12303 | @findex unmacro |
| @@ -12263,7 +12319,7 @@ a\arg\b | ||
| 12263 | 12319 | @cindex Running macros |
| 12264 | 12320 | @cindex Macro invocation |
| 12265 | 12321 | |
| 12266 | -マクロが定義されると(前節参照)、次のようにドキュメントの中でそのマクロを使用する(@dfn{呼び出す})ことが出来ます。 | |
| 12322 | +マクロが定義されると(前節参照)、次のように、ドキュメントの中でそのマクロを使用する(@dfn{呼び出す})ことが出来ます。 | |
| 12267 | 12323 | |
| 12268 | 12324 | @example |
| 12269 | 12325 | @@@var{macroname} @{@var{arg1}, @var{arg2}, @dots{}@} |
| @@ -12278,15 +12334,15 @@ Together: \p\ & \q\. | ||
| 12278 | 12334 | @@foo@{a, b@} |
| 12279 | 12335 | @end example |
| 12280 | 12336 | |
| 12281 | -@noindent これは以下を静止します。 | |
| 12337 | +@noindent これは以下を生成します。 | |
| 12282 | 12338 | |
| 12283 | 12339 | @display |
| 12284 | 12340 | Together: a & b. |
| 12285 | 12341 | @end display |
| 12286 | 12342 | |
| 12287 | 12343 | @cindex Backslash, and macros |
| 12288 | -従って、引数とパラメータはカンマによって区切られ、中括弧で括られます。 | |
| 12289 | -カンマの後ろ(前ではない)空白は全て無視されます。 | |
| 12344 | +したがって、引数とパラメータはカンマによって区切られ、中括弧で括られます。 | |
| 12345 | +カンマの後ろ(前ではない)の空白は全て無視されます。 | |
| 12290 | 12346 | 中括弧は呼び出し時には必要です(定義時は不要です)。 |
| 12291 | 12347 | Texinfoの他の全てのコマンドと同じで、マクロが引数を取らない時でも中括弧は必要となりす。 |
| 12292 | 12348 | 例えば以下を見てください。 |
| @@ -12308,11 +12364,11 @@ No arguments here. | ||
| 12308 | 12364 | マクロの引数としてカンマを含む文字列を引き渡す場合、特別な注意を払って、そういったカンマと引数のセパレータを@command{makeinfo}が混同しないように正しく@dfn{クォートし}なければなりません。 |
| 12309 | 12365 | 手作業でカンマをクォートする場合は、バックスラッシュをカンマの前に付けてください。 |
| 12310 | 12366 | @code{\,}のようになります。 |
| 12311 | -代わりに@code{@@comma}コマンドを使用することも出来ます(@pxref{Inserting a Comma})。 | |
| 12367 | +代わりに、@code{@@comma}コマンドを使用することも出来ます(@pxref{Inserting a Comma})。 | |
| 12312 | 12368 | しかし、マクロの使用を簡単にするため、@command{makeinfo}は@dfn{自動クォート}と呼ばれる一連のルールを実装しています。 |
| 12313 | 12369 | |
| 12314 | 12370 | @enumerate 1 |
| 12315 | -@item マクロが引数を一つだけ取る場合、呼び出し時のカンマは全てデフォルトで引用されます。 | |
| 12371 | +@item マクロが引数を一つだけ取る場合、呼び出し時のカンマはデフォルトで全て引用されます。 | |
| 12316 | 12372 | 例えば以下を見てください。 |
| 12317 | 12373 | |
| 12318 | 12374 | @example |
| @@ -12332,17 +12388,18 @@ No arguments here. | ||
| 12332 | 12388 | @strong{FIXME: A nice feature, though it can be dangerous.} |
| 12333 | 12389 | @end example |
| 12334 | 12390 | |
| 12335 | -そして確かに可能です。 | |
| 12336 | -これはつまり、@command{makeinfo}は引数一つのマクロへ渡される引数の数を制御しないということですので、呼び出し時には注意が必要です。 | |
| 12391 | +そして、確かに可能です。 | |
| 12392 | +これは、つまり、@command{makeinfo}は引数一つのマクロへ渡される引数の数を制御しないということですので、呼び出し時には注意が必要です。 | |
| 12337 | 12393 | |
| 12338 | -@item もしマクロ呼び出しに別のコマンドが含まれていれば(再帰呼び出しの場合も含む)、入れ子になっているコマンド呼び出しのカンマはデフォルトでクォートされます。 | |
| 12394 | +@item もし、マクロ呼び出しに別のコマンドが含まれていれば(再帰呼び出しの場合も含む)、入れ子になっているコマンド呼び出しのカンマはデフォルトでクォートされます。 | |
| 12339 | 12395 | 例えば以下を見てください。 |
| 12340 | 12396 | |
| 12341 | 12397 | @example |
| 12342 | 12398 | @@say@{@@strong@{Yes, I do@}, person one@} |
| 12343 | 12399 | @end example |
| 12344 | 12400 | |
| 12345 | -この中@samp{Yes}の後ろにあるカンマは暗黙のうちにクォートされます。以下は再帰マクロを使った別の例です。 | |
| 12401 | +この@samp{Yes}の後ろにあるカンマは暗黙のうちにクォートされます。 | |
| 12402 | +以下は再帰マクロを使った別の例です。 | |
| 12346 | 12403 | |
| 12347 | 12404 | @example |
| 12348 | 12405 | @group |
| @@ -12357,11 +12414,12 @@ No arguments here. | ||
| 12357 | 12414 | @noindent |
| 12358 | 12415 | これは@samp{foobarbaz}という文字列を生成します。 |
| 12359 | 12416 | |
| 12360 | -@item それ以外の場合、前述のようにカンマは明示的にクォートしなければなりません。そうすれば引数の一部として処理されます。 | |
| 12417 | +@item それ以外の場合、前述のようにカンマは明示的にクォートしなければなりません。 | |
| 12418 | +そうすれば、引数の一部として処理されます。 | |
| 12361 | 12419 | @end enumerate |
| 12362 | 12420 | |
| 12363 | 12421 | @cindex Braces, in macro arguments |
| 12364 | -マクロの引数の中でクォートする必要のある文字には他に、波括弧とバックスラッシュがあります。 | |
| 12422 | +マクロの引数の中でクォートする必要のある文字には、他に、波括弧とバックスラッシュがあります。 | |
| 12365 | 12423 | 例えば以下を見てください。 |
| 12366 | 12424 | |
| 12367 | 12425 | @example |
| @@ -12370,10 +12428,10 @@ No arguments here. | ||
| 12370 | 12428 | |
| 12371 | 12429 | @noindent |
| 12372 | 12430 | これは、@var{macname}に引数として@samp{\@{@},}を渡します。 |
| 12373 | -しかし、パラメータ中のカンマは、バックスラッシュでエスケープしていたとしても、@TeX{}において問題を発生させることがあるでしょう。 | |
| 12431 | +しかし、バックスラッシュでエスケープしていたとしても、パラメータ中のカンマは@TeX{}において問題を発生させることがあるでしょう。 | |
| 12374 | 12432 | |
| 12375 | 12433 | このマクロが一つの引数を取るように定義されていて、括弧を全く付けずに呼び出された場合、その行のマクロ名の後ろの残りの部分が全て引数として引き渡されます。 |
| 12376 | -例えば以下を見てください。 | |
| 12434 | +例えば、以下を見てください。 | |
| 12377 | 12435 | |
| 12378 | 12436 | @example |
| 12379 | 12437 | @@macro bar @{p@} |
| @@ -12391,7 +12449,7 @@ Twice: aah & aah. | ||
| 12391 | 12449 | |
| 12392 | 12450 | マクロが引数一つを取るように定義されていて、中括弧を付けて呼び出された場合、その中括弧で括られたテキストが引数として引き渡されます。 |
| 12393 | 12451 | この場合カンマは無関係です。 |
| 12394 | -例えば以下を見てください。 | |
| 12452 | +例えば、以下を見てください。 | |
| 12395 | 12453 | |
| 12396 | 12454 | @example |
| 12397 | 12455 | @@macro bar @{p@} |
| @@ -12425,23 +12483,23 @@ Twice: a,b & a,b. | ||
| 12425 | 12483 | 残念ながら、これらに属する名前は膨大な量がありますので、エラーとなり得るようなものを前もってお知らせすることは出来ません。 |
| 12426 | 12484 | |
| 12427 | 12485 | @item |
| 12428 | -マクロは全て少なくとも一つの@TeX{}グループの中で展開されます。 | |
| 12429 | -これはつまり、@code{@@set}や他のそういったコマンドはマクロ内では効果が無いということを意味します。 | |
| 12486 | +マクロは、少なくとも一つの@TeX{}グループの中で全て展開されます。 | |
| 12487 | +これは、つまり、@code{@@set}や他のそういったコマンドはマクロ内では効果が無いということを意味します。 | |
| 12430 | 12488 | |
| 12431 | 12489 | @item |
| 12432 | -マクロの引数にあるカンマは、バックスラッシュでエスケープされていたとしても、必ず上手くいくとは限りません。 | |
| 12490 | +バックスラッシュでエスケープされていたとしても、マクロの引数にあるカンマは必ず上手くいくとは限りません。 | |
| 12433 | 12491 | |
| 12434 | 12492 | @item |
| 12435 | 12493 | マクロの引数は複数行に渡って書くことは出来ません。 |
| 12436 | 12494 | |
| 12437 | 12495 | @item |
| 12438 | 12496 | マクロ定義内のコメントは書かないのが(通常は)ベストです。 |
| 12439 | -しかし次の項目も見てください。 | |
| 12497 | +しかし、次の項目も見てください。 | |
| 12440 | 12498 | |
| 12441 | 12499 | @item |
| 12442 | -条件コマンドのような単独行に書く必要があるコマンドが入ったマクロは、行の途中で呼び出すことは出来ません。 | |
| 12500 | +条件コマンドのような単独行に書く必要があるコマンドが入ったマクロは行の途中で呼び出すことは出来ません。 | |
| 12443 | 12501 | 一般に、マクロ定義中とマクロ呼び出し中の改行の関係は、具体的なコマンドとコンテキストに依存します。 |
| 12444 | -問題によっては@code{@@c}コマンドを慎重に使用することで対処可能かもしれません。 | |
| 12502 | +問題によっては、@code{@@c}コマンドを慎重に使用することで対処可能かもしれません。 | |
| 12445 | 12503 | 常に単独行で使用されることが期待されているマクロを次のように定義しているとしましょう。 |
| 12446 | 12504 | |
| 12447 | 12505 | @example |
| @@ -12455,7 +12513,7 @@ foo | ||
| 12455 | 12513 | bar |
| 12456 | 12514 | @end example |
| 12457 | 12515 | |
| 12458 | -@code{@@c}コマンドを使わなかった場合、@samp{@@cindex whatever}と@samp{bar}の間に望まない空行が入ります(一つはマクロ定義によるもの。もう一つは呼び出し後のものです)。 | |
| 12516 | +@code{@@c}コマンドを使わなかった場合、@samp{@@cindex whatever}と@samp{bar}の間に望まない空行が入ります(一つはマクロ定義によるもの、もう一つは呼び出し後のものです)。 | |
| 12459 | 12517 | これによって段落が中断されることになります。 |
| 12460 | 12518 | |
| 12461 | 12519 | その一方で、そのマクロが行の途中で呼び出されることがあるのであれば、@code{@@c}コマンドを使いたくないと思います(その呼び出しの後ろにあるテキストがコメントとして処理されてしまいます)。 |
| @@ -12480,7 +12538,7 @@ off | ||
| 12480 | 12538 | @item |
| 12481 | 12539 | マクロは自然な方法ではマクロを定義することは出来ません。 |
| 12482 | 12540 | マクロでマクロを定義するには、条件コマンドと生の@TeX{}を使わなければなりません。 |
| 12483 | -例えば以下を見てください。 | |
| 12541 | +例えば、以下を見てください。 | |
| 12484 | 12542 | |
| 12485 | 12543 | @example |
| 12486 | 12544 | @@ifnottex |
| @@ -12504,13 +12562,13 @@ something involving \arg\ somehow | ||
| 12504 | 12562 | @item |
| 12505 | 12563 | @code{@@verbatim}コマンドとマクロは相性が悪いです。 |
| 12506 | 12564 | 例えば、マクロの内部でverbatimブロックを開始し、マクロの外で終了させることは出来ません。 |
| 12507 | -(@xref{verbatim}.) | |
| 12508 | -さらに言えば、マクロ内部で何らかの環境を開始し、マクロ外で終了させるのは、上手くいったり、いかなかったりします。 | |
| 12565 | +@xref{verbatim}. | |
| 12566 | +さらに言えば、マクロ内部で何らかの環境を開始し、マクロ外で終了させるのは上手くいったりいかなかったりします。 | |
| 12509 | 12567 | |
| 12510 | 12568 | @item |
| 12511 | 12569 | 完全にマクロを定義してしまうマクロはokですが、不適切に入れ子になったマクロ定義は出来ません。 |
| 12512 | 12570 | つまり、@code{@@macro}コマンドと@code{@@end macro}コマンドは正しくペアになっていなければなりません(@code{@@rmacro}コマンドでも同様です)。 |
| 12513 | -例えば、あるマクロでマクロ定義を開始し、そのマクロの外でその入れ子になった定義を終了させることは出来ません。 | |
| 12571 | +例えば、あるマクロでマクロ定義を開始し、そのマクロの外で、その入れ子になった定義を終了させることは出来ません。 | |
| 12514 | 12572 | |
| 12515 | 12573 | @item |
| 12516 | 12574 | @code{@@rmacro}はあまり上手に実装されていません。 |
| @@ -12529,25 +12587,26 @@ something involving \arg\ somehow | ||
| 12529 | 12587 | @findex alias |
| 12530 | 12588 | |
| 12531 | 12589 | @samp{@@alias}コマンドは既存のコマンドと全く同じ新たなコマンドを定義します。 |
| 12532 | -このコマンドは、追加的なマークアップ名を定義するのに使われ、たとえ出力結果が全く同一であっても、入力データ中に意味的な情報を保持することが出来るようになります。 | |
| 12590 | +このコマンドは、追加的なマークアップ名を定義するのに使われます。 | |
| 12591 | +たとえ出力結果が全く同一であっても、入力データ中に意味的な情報を保持することが出来るようになります。 | |
| 12533 | 12592 | |
| 12534 | 12593 | @samp{@@alias}コマンドは単独行に記述し、続けて新しいコマンド名、イコール記号、既存のコマンド名を記述してください。 |
| 12535 | 12594 | イコール記号の前後の空白は無視されます。 |
| 12536 | -従って次のようになります。 | |
| 12595 | +したがって、次のようになります。 | |
| 12537 | 12596 | @example |
| 12538 | 12597 | @@alias @var{new} = @var{existing} |
| 12539 | 12598 | @end example |
| 12540 | 12599 | |
| 12541 | -例えば、ドキュメントにおいて、図書への言及と図書以外の何らかのメディア(例えば映画)への言及が共になされている場合、通常の@code{@@cite@{@}}コマンドと全く同じことを行なう@code{@@moviecite@{@}}マクロを定義すると良いでしょう。このマクロを使うことで意味的な情報も余分に伝えることが出来ます。 | |
| 12600 | +例えば、ドキュメントにおいて、図書への言及と図書以外の何らかのメディア(例えば映画)への言及が共になされている場合、通常の@code{@@cite@{@}}コマンドと全く同じことを行なう@code{@@moviecite@{@}}マクロを定義すると良いでしょう。 | |
| 12601 | +このマクロを使うことで、意味的な情報も余分に伝えることが出来ます。 | |
| 12542 | 12602 | 以下のようにすれば実現できるでしょう。 |
| 12543 | 12603 | |
| 12544 | 12604 | @example |
| 12545 | 12605 | @@alias moviecite = cite |
| 12546 | 12606 | @end example |
| 12547 | 12607 | |
| 12548 | -引数の解析には気紛れところがあるため、マクロは必ずしもエイリアスと全く同じ効果を持つわけではありません。 | |
| 12549 | -また、マクロと比べるとエイリアスのほうが定義するのがかなり簡単ですので、このコマンドは冗長なところがありません。 | |
| 12550 | -(そしてまたエイリアスはJargon Fileでもガンガン使われました。) | |
| 12608 | +引数の解析には気紛れところがあるため、必ずしも、エイリアスと全く同じ効果をマクロが持つわけではありません。 | |
| 12609 | +また、マクロと比べると、エイリアスのほうが定義するのがかなり簡単ですので、このコマンドは冗長なところがありません(そして、また、エイリアスはJargon Fileでもガンガン使われました)。 | |
| 12551 | 12610 | |
| 12552 | 12611 | エイリアスは直接間接問わず再帰してはなりません。 |
| 12553 | 12612 |
| @@ -12561,7 +12620,8 @@ something involving \arg\ somehow | ||
| 12561 | 12620 | @cindex Customized highlighting |
| 12562 | 12621 | @findex definfoenclose |
| 12563 | 12622 | |
| 12564 | -@code{@@definfoenclose}コマンドは、Infoに対する強調コマンドを定義するのに使用されることがあります。@TeX{}に対するものではありません。 | |
| 12623 | +@code{@@definfoenclose}コマンドは、Infoに対する強調コマンドを定義するのに使用されることがあります。 | |
| 12624 | +@TeX{}に対するものではありません。 | |
| 12565 | 12625 | @code{@@definfoenclose}コマンドを使って定義されたコマンドは、テキストの前後を文字列で挟んで括ることによってテキストをマークします。 |
| 12566 | 12626 | これによって、Info出力をより細かく制御できるようになります。 |
| 12567 | 12627 |
| @@ -12569,12 +12629,12 @@ something involving \arg\ somehow | ||
| 12569 | 12629 | |
| 12570 | 12630 | @code{@@definfoenclose}コマンドを行に書いて、続けて三つの引数をカンマで区切って記述します。 |
| 12571 | 12631 | @code{@@definfoenclose}コマンドの最初の引数は@@-コマンドの名前です(@code{@@}は書きません)。 |
| 12572 | -2番目の引数はInfoの開始区切り文字列、そして3番目の引数はInfoの終了区切り文字列です。 | |
| 12632 | +2番目の引数はInfoの開始区切り文字列、3番目の引数はInfoの終了区切り文字列です。 | |
| 12573 | 12633 | 後の二つの引数は、Infoファイルにおいて強調されるテキストを囲むものです。 |
| 12574 | 12634 | 区切り文字列にはスペースを含めることが出来ます。 |
| 12575 | 12635 | 開始区切り文字列も終了区切り文字列も必須ではありません。 |
| 12576 | 12636 | 開始区切り文字列は不要で、終了区切り文字列が必要な場合、コマンド名の後ろにカンマを二つ記述しなければなりません。 |
| 12577 | -そうしなければ、Infoの書式化コマンドは当然、終了区切り文字列のはずだったものを開始区切り文字列として誤って解釈してしまうでしょう。 | |
| 12637 | +そうしなければ、当然、Infoの書式化コマンドは、終了区切り文字列のはずだったものを開始区切り文字列として誤って解釈してしまうでしょう。 | |
| 12578 | 12638 | |
| 12579 | 12639 | 定義済みマクロ(例えば、@code{@@emph}、@code{@@strong}、@code{@@t}、@code{@@i}))に対して@code{@@definfoenclose}コマンドを実行する場合、その封入の定義は組み込みの定義をオーバーライドします。 |
| 12580 | 12640 |
| @@ -12589,9 +12649,9 @@ something involving \arg\ somehow | ||
| 12589 | 12649 | |
| 12590 | 12650 | @noindent |
| 12591 | 12651 | これをTexinfoファイルの冒頭に記述し、@code{@@phoo}の引数の前に`//'、後ろに`\\'を挿入するInfoの書式化コマンドとして@code{@@phoo}を定義します。 |
| 12592 | -そして、Infoで強調される`//bar\\'という文字列が必要な場所に、@code{@@phoo@{bar@}}と記述することが出来ます。 | |
| 12652 | +そして、Infoで強調される`//bar\\'という文字列が必要な場所に@code{@@phoo@{bar@}}と記述することが出来ます。 | |
| 12593 | 12653 | |
| 12594 | -また@TeX{}の書式化では、次のように書けるでしょう。 | |
| 12654 | +また、@TeX{}の書式化では次のように書けるでしょう。 | |
| 12595 | 12655 | |
| 12596 | 12656 | @example |
| 12597 | 12657 | @@iftex |
| @@ -12614,7 +12674,7 @@ something involving \arg\ somehow | ||
| 12614 | 12674 | @end example |
| 12615 | 12675 | |
| 12616 | 12676 | @noindent |
| 12617 | -これをファイルの冒頭近くに記述してください。 | |
| 12677 | +これを、ファイルの冒頭近くに記述してください。 | |
| 12618 | 12678 | @code{@@headword}に対する引数の前には何も付けず、後ろにはコロンを挿入するInfoの書式化コマンドとして@code{@@headword}を定義されます。 |
| 12619 | 12679 | |
| 12620 | 12680 | @samp{@@definfoenclose}の定義は直接間接問わず再帰的であってはなりません。 |
| @@ -12631,11 +12691,14 @@ something involving \arg\ somehow | ||
| 12631 | 12691 | @cindex @TeX{} index sorting |
| 12632 | 12692 | @pindex texindex |
| 12633 | 12693 | |
| 12634 | -Texinfoファイルから印刷されたマニュアルを作成するための主要なシェルコマンドが三つあります。 | |
| 12635 | -一つ目、Texinfoファイルを印刷されるファイルへ変換するためのもの、二つ目は索引を並べ替えるためのもの、三つ目は書式化済みのドキュメントを印刷するためのものです。 | |
| 12694 | +Texinfoファイルから印刷マニュアルを作成するための主要なシェルコマンドは三つあります。 | |
| 12695 | +一つ目は、Texinfoファイルを印刷されるファイルへ変換するためのものです。 | |
| 12696 | +二つ目は、索引を並べ替えるためのものです。 | |
| 12697 | +そして、三つ目は、書式化済みのドキュメントを印刷するためのものです。 | |
| 12636 | 12698 | これらのシェルコマンドを使用する際には、オペレーティングシステムで直接作業することも出来ますし、GNU Emacs上のシェルで作業することも出来ます。 |
| 12637 | 12699 | |
| 12638 | -GNU Emacsを使用しているならば、シェルコマンドではなくTexinfoモードが提供しているコマンドを利用できます。ファイルを書式化する三つのコマンドに加え、ファイルの書式化、索引の並べ替え、結果の印刷などを行なうため、Texinfoモードでは、出力バッファをリセンター(recenter)したり、プリントキューを表示したり、プリントキューのジョブを削除したりするコマンドに対してキーバインドを提供しています。 | |
| 12700 | +GNU Emacsを使用しているならば、シェルコマンドではなくTexinfoモードが提供しているコマンドを利用できます。 | |
| 12701 | +ファイルを書式化する三つのコマンドに加え、ファイルの書式化、索引の並べ替え、結果の印刷などを行なうため、Texinfoモードでは、出力バッファをリセンター(recenter)したり、プリントキューを表示したり、プリントキューのジョブを削除したりするコマンドに対してキーバインドを提供しています。 | |
| 12639 | 12702 | |
| 12640 | 12703 | @menu |
| 12641 | 12704 | * Use TeX:: Use @TeX{} to format for hardcopy. |
| @@ -12660,11 +12723,12 @@ GNU Emacsを使用しているならば、シェルコマンドではなくTexin | ||
| 12660 | 12723 | @node Use TeX |
| 12661 | 12724 | @section @TeX{}の使用 |
| 12662 | 12725 | |
| 12663 | -@TeX{}と呼ばれる組版プログラムはTexinfoファイルを書式化するのに使用されます。 | |
| 12664 | -@TeX{}は非常に強力な組版プログラムで、正しく使用すれば、非常良い仕事をします。 | |
| 12665 | -(@xref{Obtaining TeX, , How to Obtain @TeX{}}, for information on how to obtain @TeX{}.) | |
| 12726 | +@TeX{}と呼ばれる組版プログラムは、Texinfoファイルを書式化するのに使用されます。 | |
| 12727 | +@TeX{}は非常に強力な組版プログラムです。 | |
| 12728 | +正しく使用すれば、非常良い仕事をします。 | |
| 12729 | +@TeX{}の入手方法については別の節を参照してください(@pxref{Obtaining TeX, , How to Obtain @TeX{}})。 | |
| 12666 | 12730 | |
| 12667 | -スタンドアロンの@code{makeinfo}プログラムやEmacs関数の@code{texinfo-format-region}コマンド、@code{texinfo-format-buffer}コマンドは、@TeX{}が行なうの全く同じTexinfoファイルの@@-コマンドを読み込みますが、そられに対して異なった処理を行なってInfoファイルを作成します(@pxref{Creating an Info File})。 | |
| 12731 | +スタンドアロンの@code{makeinfo}プログラム、Emacs関数の@code{texinfo-format-region}コマンド、@code{texinfo-format-buffer}コマンドは、@TeX{}が行なうの全く同じTexinfoファイルの@@-コマンドを読み込みますが、それらに対して異なった処理を行なってInfoファイルを作成します(@pxref{Creating an Info File})。 | |
| 12668 | 12732 | |
| 12669 | 12733 | |
| 12670 | 12734 | @node Format with tex/texindex |
| @@ -12681,26 +12745,27 @@ tex foo.texi | ||
| 12681 | 12745 | @end example |
| 12682 | 12746 | |
| 12683 | 12747 | @noindent @TeX{}は、索引やクロスリファレンスなどの情報が入ったいくつかの補助的なファイルと共に@dfn{DVIファイル}を生成します。 |
| 12684 | -このDVIファイル(@dfn{DeVice Independent}ファイル)は、事実上あらゆるデバイスに出力できるものです(後節参照)。 | |
| 12748 | +このDVIファイル(@dfn{DeVice Independent}ファイル)は、事実上、あらゆるデバイスに出力できるものです(後節参照)。 | |
| 12685 | 12749 | |
| 12686 | 12750 | @pindex texindex |
| 12687 | 12751 | @code{tex}という書式化コマンド自体は索引の並べ替えは行なわず、ソートされていない索引データの出力ファイルを生成します。 |
| 12688 | -@command{tex}コマンドの実行後、印刷される索引を生成するには、まず作業を開始するためのソート済み索引が必要となります。 | |
| 12752 | +@command{tex}コマンドの実行後、印刷される索引を生成するには、まず、作業を開始するためのソート済み索引が必要となります。 | |
| 12689 | 12753 | @command{texindex}コマンドは索引をソートします。 |
| 12690 | 12754 | (ソースファイルの@file{texindex.c}は、他にもありますが、標準のTexinfo配布物の一部として含まれています。) |
| 12691 | 12755 | (@command{texi2dv}コマンドは必要に応じて@command{tex}コマンドや@command{texindex}を実行します。) |
| 12692 | 12756 | |
| 12693 | 12757 | @cindex Names of index files |
| 12694 | 12758 | @cindex Index file names |
| 12695 | -書式化コマンドの@code{tex}は未ソート索引ファイルを出力します。この索引ファイルの名前は標準的な慣習に従って名前が付けられます。 | |
| 12696 | -この慣習とはつまり、メインの入力ファイルの@samp{.tex} (あるいは類似のもの@pxref{tex invocation,,, web2c, Web2c})という拡張子を取り除き、索引を表わす二文字名を付けたものです。 | |
| 12697 | -例えば、入力ファイル@file{foo.texinfo}に対する生の索引出力ファイルは@file{foo.cp}、@file{foo.vr}、@file{foo.fn}、@file{foo.tp}、@file{foo.pg}、@file{foo.ky}になります。 | |
| 12759 | +書式化コマンドの@code{tex}は未ソート索引ファイルを出力します。 | |
| 12760 | +この索引ファイルの名前は標準的な慣習に従って名前が付けられます。 | |
| 12761 | +この慣習とは、つまり、メインの入力ファイルの@samp{.tex} (あるいは、類似のもの(@pxref{tex invocation,,, web2c, Web2c}))という拡張子を取り除き、索引を表わす二文字名を付けたものです。 | |
| 12762 | +例えば、入力ファイル@file{foo.texinfo}に対する生の索引出力ファイルは、@file{foo.cp}、@file{foo.vr}、@file{foo.fn}、@file{foo.tp}、@file{foo.pg}、@file{foo.ky}になります。 | |
| 12698 | 12763 | これらは@code{texindex}へ渡される引数そのものです。 |
| 12699 | 12764 | |
| 12700 | 12765 | @need 1000 |
| 12701 | 12766 | @cindex Wildcards |
| 12702 | 12767 | @cindex Globbing |
| 12703 | -未ソートの索引ファイルを全て明示的に指定するのではなく、シェルのワイルドカードとして@samp{??}を使用して、コマンドに指定することも出来ます。 | |
| 12768 | +未ソートの索引ファイルを全て明示的に指定するのではなく、シェルのワイルドカードとして@samp{??}を使用してコマンドに指定することも出来ます。 | |
| 12704 | 12769 | 次のような形式になります。 |
| 12705 | 12770 | |
| 12706 | 12771 | @example |
| @@ -12708,18 +12773,18 @@ texindex foo.?? | ||
| 12708 | 12773 | @end example |
| 12709 | 12774 | |
| 12710 | 12775 | @noindent |
| 12711 | -このコマンドは全ての未ソートの索引ファイルに対して@code{texindex}コマンドを実行します。 | |
| 12776 | +このコマンドは、全ての未ソートの索引ファイルに対して@code{texindex}コマンドを実行します。 | |
| 12712 | 12777 | @code{@@defindex}や@code{@@defcodeindex}を使ってユーザが定義した索引も含まれます。 |
| 12713 | -(例えば@samp{foo.el}のように、索引ファイルではないが二文字拡張子の付いた似た名前を持つファイルがあった場合でも@samp{texindex foo.??}を実行できます。 | |
| 12778 | +(例えば@samp{foo.el}のように、索引ファイルではないが二文字拡張子の付いた似た名前を持つファイルがあった場合でも、@samp{texindex foo.??}を実行できます。 | |
| 12714 | 12779 | @code{texindex}コマンドはそのことを報告するだけで、そういったファイルを無視します。) |
| 12715 | 12780 | |
| 12716 | -指定された各ファイルに対して、@code{texindex}はソート済み索引ファイルを生成します。 | |
| 12781 | +指定された各ファイルに対して@code{texindex}はソート済み索引ファイルを生成します。 | |
| 12717 | 12782 | この索引ファイルの名前は入力ファイル名の後ろに@samp{s}を付加したものです。 |
| 12718 | 12783 | @code{@@printindex}コマンドはそういう名前のファイルを探します(@pxref{Printing Indices & Menus})。 |
| 12719 | 12784 | @code{texindex}コマンドは生の索引出力ファイルを変更することはありません。 |
| 12720 | 12785 | |
| 12721 | 12786 | 索引をソートした後は、当該Texinfoファイルに対して@code{tex}コマンドを再実行する必要があります。 |
| 12722 | -これによってDVIファイルが再生成され、今回は索引エントリが最新の状態になります。 | |
| 12787 | +これによってDVIファイルが再生成され、この時点で索引エントリが最新の状態になります。 | |
| 12723 | 12788 | |
| 12724 | 12789 | 最後に、@code{tex}コマンドをもう一度実行して、クロスリファレンスのページ番号を取得する必要があるかもしれません。 |
| 12725 | 12790 |
| @@ -12732,19 +12797,19 @@ Texinfoファイルに対して@code{tex}を実行してください。 | ||
| 12732 | 12797 | |
| 12733 | 12798 | @item |
| 12734 | 12799 | 生の索引ファイルに対して@code{texindex}を実行してください。 |
| 12735 | -これによって対応するソート済み索引ファイル(三文字拡張子)が作成されます。 | |
| 12800 | +これによって、対応するソート済み索引ファイル(三文字拡張子)が作成されます。 | |
| 12736 | 12801 | |
| 12737 | 12802 | @item |
| 12738 | 12803 | Texinfoファイルに対して再度@code{tex}を実行してください。 |
| 12739 | -これによってDVIファイルが再生成されます。 | |
| 12740 | -今回は索引付きで、クロスリファレンスが定義されていますが、前回作成されたクロスリファレンスのページ番号が付いていますので、通常は正しくありません。 | |
| 12804 | +これによって、DVIファイルが再生成されます。 | |
| 12805 | +今回は索引付きでクロスリファレンスが定義されていますが、前回作成されたクロスリファレンスのページ番号が付いていますので、通常は正しくありません。 | |
| 12741 | 12806 | |
| 12742 | 12807 | @item |
| 12743 | 12808 | @code{texindex}コマンドを使って索引を再度ソートします。 |
| 12744 | 12809 | |
| 12745 | 12810 | @item |
| 12746 | 12811 | @code{tex}コマンドを最後にもう一度実行してください。 |
| 12747 | -今度はクロスリファレンスに正しいページ番号が書き出されます。 | |
| 12812 | +今度は、クロスリファレンスに正しいページ番号が書き出されます。 | |
| 12748 | 12813 | @end enumerate |
| 12749 | 12814 | |
| 12750 | 12815 | @pindex texi2dvi |
| @@ -12752,19 +12817,19 @@ Texinfoファイルに対して再度@code{tex}を実行してください。 | ||
| 12752 | 12817 | @code{texi2dvi}を実行する方法です(@pxref{Format with texi2dvi})。 |
| 12753 | 12818 | |
| 12754 | 12819 | @code{tex}コマンドを実行するたびに@code{texindex}コマンドを実行する必要はありません。 |
| 12755 | -次の実行時に、@code{texindex}コマンドを実行しない場合には、前回@code{texindex}が使ったソート済み索引ファイルがたまたま存在すれば、書式化コマンドの@code{tex}はその索引ファイルを何でも使用します。 | |
| 12756 | -これはデバッグ中は通常問題ありません。 | |
| 12820 | +次の実行時に@code{texindex}コマンドを実行しない場合には、前回@code{texindex}が使ったソート済み索引ファイルがたまたま存在すれば、書式化コマンドの@code{tex}はその索引ファイルを何でも使用します。 | |
| 12821 | +通常、これはデバッグ中には問題ありません。 | |
| 12757 | 12822 | |
| 12758 | 12823 | @cindex Auxiliary files, avoiding |
| 12759 | 12824 | @findex novalidate |
| 12760 | 12825 | @cindex Pointer validation, suppressing |
| 12761 | 12826 | @cindex Chapters, formatting one at a time |
| 12762 | 12827 | ドキュメントが不完全であったとしても、印刷したいと思うことがあります。 |
| 12763 | -あるいはドキュメントの一つの章だけを印刷したいこともあります。 | |
| 12828 | +あるいは、ドキュメントの一つの章だけを印刷したいこともあります。 | |
| 12764 | 12829 | そういった場合には、@TeX{}が作成する通常の補助ファイルや、クロスリファレンスが不十分な際に@TeX{}が出す警告は邪魔なだけになります。 |
| 12765 | -@code{@@novalidate}コマンドを使えばそういった邪魔なものを避けることが出来ます。 | |
| 12830 | +@code{@@novalidate}コマンドを使えば、そういった邪魔なものを避けることが出来ます。 | |
| 12766 | 12831 | このコマンドは、@code{@@setfilename}コマンドの@emph{前に}指定しなければなりません(@pxref{setfilename,,@code{@@setfilename}})。 |
| 12767 | -従ってファイルの冒頭は大体次のようになります。 | |
| 12832 | +したがって、ファイルの冒頭は大体次のようになります。 | |
| 12768 | 12833 | |
| 12769 | 12834 | @example |
| 12770 | 12835 | \input texinfo |
| @@ -12773,18 +12838,18 @@ Texinfoファイルに対して再度@code{tex}を実行してください。 | ||
| 12773 | 12838 | @dots{} |
| 12774 | 12839 | @end example |
| 12775 | 12840 | |
| 12776 | -@noindent @code{@@novalidate}コマンドはまた、@code{makeinfo}コマンドにおける検証機能を無効にします。 | |
| 12777 | -これは丁度@code{makeinfo}コマンドの@code{--no-validate}オプションを使ったのと同じになります(@pxref{Pointer Validation})。 | |
| 12841 | +@noindent また、@code{@@novalidate}コマンドは、@code{makeinfo}コマンドにおける検証機能を無効にします。 | |
| 12842 | +これは、丁度、@code{makeinfo}コマンドの@code{--no-validate}オプションを使ったのと同じになります(@pxref{Pointer Validation})。 | |
| 12778 | 12843 | |
| 12779 | 12844 | |
| 12780 | 12845 | @node Format with texi2dvi |
| 12781 | 12846 | @section @code{texi2dvi}を使った書式化 |
| 12782 | 12847 | @pindex texi2dvi @r{(shell script)} |
| 12783 | 12848 | |
| 12784 | -@code{texi2dvi}コマンドは、ソート済み索引を持ち、クロスリファレンスを完全に解決したDVIファイルを生成するのに必要な回数だけ、@TeX{}と@command{texindex}を自動的に繰り返し実行します。 | |
| 12849 | +ソート済み索引を持ち、クロスリファレンスを完全に解決したDVIファイルを生成するのに必要な回数だけ、@code{texi2dvi}コマンドは@TeX{}と@command{texindex}を自動的に繰り返し実行します。 | |
| 12785 | 12850 | そのため、前節で説明した@code{tex}---@code{texindex}---@code{tex}---@code{tex}というシーケンスを手作業で実行するよりも簡単です。 |
| 12786 | 12851 | |
| 12787 | -@file{foo.texi}という入力ファイルに対して@code{texi2dvi}コマンドを実行するには次のようにしてください(@samp{prompt$ }というのはユーザのシェルプロンプトです)。 | |
| 12852 | +@file{foo.texi}という入力ファイルに対して@code{texi2dvi}コマンドを実行するには、次のようにしてください(@samp{prompt$ }というのはユーザのシェルプロンプトです)。 | |
| 12788 | 12853 | |
| 12789 | 12854 | @example |
| 12790 | 12855 | prompt$ @kbd{texi2dvi foo.texi} |
| @@ -12795,28 +12860,28 @@ MS-DOSや恐らくその他の環境においては、オペレーティング | ||
| 12795 | 12860 | |
| 12796 | 12861 | @opindex --command @r{(@command{texi2dvi})} |
| 12797 | 12862 | @code{texi2dvi}コマンドに対する便利なオプションの一つは@samp{--command=@var{cmd}}です。 |
| 12798 | -このオプションは@TeX{}を実行する前に、入力ファイルの一時的なコピーの@code{@@setfilename}コマンドの後ろに単独行として@var{cmd}を挿入するものです。 | |
| 12799 | -これを使うことで、ドキュメントのソースを実際に変更することなく、例えば@code{@@smallbook} (@pxref{smallbook})や@code{@@afourpaper} (@pxref{A4 Paper})、@code{@@pagesizes} (@pxref{pagesizes})のような違う印刷書式を指定できるようになります。 | |
| 12800 | -(また、@file{texinfo.cnf}ファイルを使ってサイト全体に対してこういうことを行なうことも出来ます。@pxref{Preparing for TeX,,Preparing for @TeX{}}) | |
| 12863 | +このオプションは、@TeX{}を実行する前に、入力ファイルの一時的なコピーの@code{@@setfilename}コマンドの後ろに単独行として@var{cmd}を挿入するものです。 | |
| 12864 | +これを使うことで、ドキュメントのソースを実際に変更することなく、例えば、@code{@@smallbook} (@pxref{smallbook})や@code{@@afourpaper} (@pxref{A4 Paper})、@code{@@pagesizes} (@pxref{pagesizes})のような違う印刷書式を指定できるようになります。 | |
| 12865 | +また、@file{texinfo.cnf}ファイルを使ってサイト全体に対してこういうことを行なうことも出来ます(@pxref{Preparing for TeX,,Preparing for @TeX{}})。 | |
| 12801 | 12866 | |
| 12802 | 12867 | @opindex --pdf @r{(@command{texi2dvi})} |
| 12803 | 12868 | @option{--pdf}オプションを使うと、@command{texi2dvi}は@command{tex}ではなく@command{pdftex}を実行して、DVIの代わりにPDF出力を生成します。 |
| 12804 | 12869 | また、@samp{texi2dvi --pdf}の短縮形である@command{texi2pdf}コマンドを使うことも出来ます。 |
| 12805 | 12870 | AUC-@TeX{}ユーザへの利便として@command{pdftexi2dvi}コマンドもサポートされています。 |
| 12806 | -後者のものは、DVIの生成ツールに対しただ単に@samp{pdf}を前置してPDFの生成ツールの用意をするというものだからです。 | |
| 12871 | +後者のものは、DVIの生成ツールに対し、ただ単に、@samp{pdf}を前置してPDFの生成ツールの用意をするというものだからです。 | |
| 12807 | 12872 | |
| 12808 | 12873 | @cindex @LaTeX{}, processing with @command{texi2dvi} |
| 12809 | 12874 | @command{texi2dvi}は@LaTeX{}ファイルを処理するのに使用することも出来ます。 |
| 12810 | 12875 | 単に@samp{texi2dvi filename.ext}を実行してください。 |
| 12811 | 12876 | |
| 12812 | 12877 | @opindex --language @r{(@command{texi2dvi})} |
| 12813 | -通常@command{texi2dvi}は入力ファイルの言語をその内容とファイル名の拡張子から推測することが出来ます。 | |
| 12878 | +通常、@command{texi2dvi}は、入力ファイルの内容とファイル名の拡張子から言語を推測することが出来ます。 | |
| 12814 | 12879 | しかし、推測に失敗した場合には、@option{--language=@var{lang}}というコマンドラインオプションを使って入力言語を指定することが出来ます。 |
| 12815 | 12880 | @var{lang}は@samp{latex}か@samp{texinfo}のどちらかです。 |
| 12816 | 12881 | |
| 12817 | -@command{texi2dvi}は、利用可能であれば@command{etex} (もしくは@command{pdfetex})を使用します。 | |
| 12882 | +利用可能であれば、@command{texi2dvi}は@command{etex} (もしくは、@command{pdfetex})を使用します。 | |
| 12818 | 12883 | この@TeX{}の拡張版は必須ではなく、DVI(あるいはPDF)の出力は同一となります。 |
| 12819 | -しかしこれを使うことで、状況によっては@TeX{}のプログラミングを簡単にすることが出来ます。 | |
| 12884 | +しかし、これを使うことで、状況によっては、@TeX{}のプログラミングを簡単にすることが出来ます。 | |
| 12820 | 12885 | また、@file{texinfo.tex}のデバッグ時に追加的なトレース情報を提供することが出来ます。 |
| 12821 | 12886 | |
| 12822 | 12887 | @opindex --translate-file @r{(@command{texi2dvi})} |
| @@ -12828,8 +12893,8 @@ ASCII以外の文字セットで記述されたドキュメントを処理する | ||
| 12828 | 12893 | @option{--recode}オプションはドキュメントを、@samp{@@documentencoding}コマンド(@pxref{documentencoding,,@code{documentencoding}})で指定されたエンコーディングからプレインの7ビット@samp{texinfo}エンコーディングに再コード化します。 |
| 12829 | 12894 | |
| 12830 | 12895 | @opindex --recode-from @r{(@command{texi2dvi})} |
| 12831 | -@option{--recode-from=@var{enc}}オプションはドキュメントを@var{enc}エンコーディングから@samp{@@documentencoding}コマンドで指定されているエンコーディングに再コード化します。 | |
| 12832 | -例えばこれは、ドキュメントが@samp{UTF-8}エンコーディングで書かれていて、等価な8ビットエンコーディングが@command{makeinfo}でサポートされている場合に便利です。 | |
| 12896 | +@option{--recode-from=@var{enc}}オプションは、@var{enc}エンコーディングから@samp{@@documentencoding}コマンドで指定されているエンコーディングにドキュメントを再コード化します。 | |
| 12897 | +例えば、これは、ドキュメントが@samp{UTF-8}エンコーディングで書かれていて、等価な8ビットエンコーディングが@command{makeinfo}でサポートされている場合に便利です。 | |
| 12833 | 12898 | |
| 12834 | 12899 | @option{--recode}オプションと@option{--recode-from=@var{enc}}オプションの両方とも@command{recode}ユーティリティを使って変換を実行します。 |
| 12835 | 12900 | @command{recode}がファイルを処理するのに失敗した場合、@command{texi2dvi}は警告を表示し、変更されていない入力ファイルを使って処理を継続します。 |
| @@ -12844,7 +12909,7 @@ ASCII以外の文字セットで記述されたドキュメントを処理する | ||
| 12844 | 12909 | DVIファイルを出力するための正確なコマンドは、ユーザが使用しているシステムのインストール状態によって異なります。 |
| 12845 | 12910 | 広く使われるものは@samp{dvips foo.dvi -o}と@samp{lpr -d foo.dvi}という二つのコマンドです。 |
| 12846 | 12911 | |
| 12847 | -例えば、@cite{Bison Manual}について、索引をソートし、書式化し、印刷するには以下のコマンドで(恐らく)十分間に合うでしょう。 | |
| 12912 | +例えば、@cite{Bison Manual}について索引をソートし、書式化し、印刷するには以下のコマンドで(恐らく)十分間に合うでしょう。 | |
| 12848 | 12913 | |
| 12849 | 12914 | @example |
| 12850 | 12915 | @group |
| @@ -12857,9 +12922,9 @@ lpr -d bison.dvi | ||
| 12857 | 12922 | |
| 12858 | 12923 | @noindent |
| 12859 | 12924 | (使用している環境によってシェルコマンドが異なることがありますので注意してください。 |
| 12860 | -ですがここに示したのは一般的なものです。) | |
| 12925 | +ですが、ここに示したのは一般的なものです。) | |
| 12861 | 12926 | |
| 12862 | -@code{texi2dvi}シェルスクリプト(前節参照)を使用する場合は次のようになります。 | |
| 12927 | +@code{texi2dvi}シェルスクリプト(前節参照)を使用する場合、次のようになります。 | |
| 12863 | 12928 | |
| 12864 | 12929 | @example |
| 12865 | 12930 | @group |
| @@ -12872,16 +12937,17 @@ lpr -d bison.dvi | ||
| 12872 | 12937 | @cindex Shell printing, on MS-DOS/MS-Windows |
| 12873 | 12938 | @cindex Printing DVI files, on MS-DOS/MS-Windows |
| 12874 | 12939 | @pindex lpr@r{-d, replacements on MS-DOS/MS-Windows} |
| 12875 | -@code{lpr}コマンドはUnixシステムでは標準的なプログラムですが、MS-DOS/MS-Windowsには普通ありません。 | |
| 12876 | -ネットワークパッケージには@code{lpr}という名前のプログラムが付属することもありますが、これらは通常、ネットワーク越しでプリントサーバにファイルを送るよう制限されていて、一般には@samp{-d}オプションをサポートしていません。 | |
| 12940 | +@code{lpr}コマンドはUnixシステムでは標準的なプログラムですが、普通、MS-DOS/MS-Windowsにはありません。 | |
| 12941 | +ネットワークパッケージには、@code{lpr}という名前のプログラムが付属することもあります。 | |
| 12942 | +しかし、通常、これらは、ネットワーク越しでプリントサーバにファイルを送るよう制限されていて、@samp{-d}オプションを一般にはサポートしていません。 | |
| 12877 | 12943 | 残念なことにこういったシステムで作業している場合は、DVIファイルを印刷する代替手段がいくつかあります。 |
| 12878 | 12944 | |
| 12879 | 12945 | @itemize @bullet{} |
| 12880 | -@item Unixライクな@code{lpr}プログラム、つまりクローンプログラムを探してインストールします。 | |
| 12946 | +@item Unixライクな@code{lpr}プログラム、つまり、クローンプログラムを探してインストールします。 | |
| 12881 | 12947 | これが可能であれば、前述の通りにDVIファイルを印刷できるようになるでしょう。 |
| 12882 | 12948 | |
| 12883 | 12949 | @item DVIファイル用のネットワークプリンタキューにDViファイルを送ります。 |
| 12884 | -ネットワークプリンタによってはDVIファイル用に特別に用意されたキューがあることがあります。 | |
| 12950 | +ネットワークプリンタによっては、DVIファイル用に特別に用意されたキューがあることがあります。 | |
| 12885 | 12951 | そういったキューへファイルを送るためのネットワークソフトウェアをセットアップできる必要があります。 |
| 12886 | 12952 | 場合によっては、ネットワークソフトウェア付属の@code{lpr}プログラムに、特定のキューに対してファイルを送る特別なオプションが用意されています。 |
| 12887 | 12953 | 次のようになります。 |
| @@ -12892,7 +12958,7 @@ lpr -Qdvi -hprint.server.domain bison.dvi | ||
| 12892 | 12958 | |
| 12893 | 12959 | @item DVIファイルをPostscriptファイルかPCLファイルに変換して、そのファイルをローカルプリンタに送ります。 |
| 12894 | 12960 | そういったツールの詳しい説明は@code{dvilj}のmanページを見てください。 |
| 12895 | -あるいは@xref{Invoking Dvips,,, dvips, Dvips}. | |
| 12961 | +あるいは、dvipsのマニュアルを見てください(@pxref{Invoking Dvips,,, dvips, Dvips})。 | |
| 12896 | 12962 | DVIファイルをローカルプリンタで直接解釈可能なフォーマットに変換すれば、適切なポートへそれを送るだけです。 |
| 12897 | 12963 | 通常は@samp{PRN}です。 |
| 12898 | 12964 | @end itemize |
| @@ -12909,10 +12975,10 @@ DVIファイルをローカルプリンタで直接解釈可能なフォーマ | ||
| 12909 | 12975 | GNU Emacs内部のシェルで書式化コマンドや印刷コマンドを指定することが可能です。 |
| 12910 | 12976 | Emacs内にシェルを作成するには、@kbd{M-x shell}と入力してください。 |
| 12911 | 12977 | このシェル内ではドキュメントを書式化したり印刷したりが可能です。 |
| 12912 | -詳細は、@xref{Hardcopy, , Format and Print Hardcopy}. | |
| 12978 | +@xref{Hardcopy, , Format and Print Hardcopy}. | |
| 12913 | 12979 | |
| 12914 | -@code{tex}が実行されている間、シェルバッファと別のバッファの間を自由に切り替えて、他の編集作業を行なうことが出来ます。 | |
| 12915 | -遅いマシン上で大きなドキュメントを書式化している場合に、この機能は非常に便利でしょう。@refill | |
| 12980 | +@code{tex}が実行されている間、シェルバッファと別のバッファの間を自由に切り替えて他の編集作業を行なうことが出来ます。 | |
| 12981 | +遅いマシン上で大きなドキュメントを書式化している場合、この機能は非常に便利でしょう。@refill | |
| 12916 | 12982 | |
| 12917 | 12983 | また、Emacsシェルから@code{texi2dvi}を使うことも可能です。 |
| 12918 | 12984 | 例えば、@code{texi2dvi}を使って、Emacs内から@cite{Using and Porting GNU CC}を書式化し、印刷する方法を以下に示します。 |
| @@ -12978,9 +13044,7 @@ Texinfoモードでは、@TeX{}の書式化や印刷のための定義済みキ | ||
| 12978 | 13044 | @end table |
| 12979 | 13045 | |
| 12980 | 13046 | @need 1000 |
| 12981 | -バッファを書式化する場合の通常のコマンドシーケンスウは以下のようになります(右側にコメントを付けます)。@refill | |
| 12982 | -Thus, the usual sequence of commands for formatting a buffer is as | |
| 12983 | -follows (with comments to the right):@refill | |
| 13047 | +バッファを書式化する場合の通常のコマンドシーケンスは以下のようになります(右側にコメントを付けます)。@refill | |
| 12984 | 13048 | |
| 12985 | 13049 | @example |
| 12986 | 13050 | @group |
| @@ -13019,8 +13083,8 @@ tex-show-queue-command "lpq" | ||
| 13019 | 13083 | これらの変数値は@kbd{M-x set-variable}コマンド(@pxref{Examining, , Examining and Setting Variables, emacs, The GNU Emacs Manual})や@file{.emacs}初期化ファイル(@pxref{Init File, , , emacs, The GNU Emacs Manual})を使って変更できます。 |
| 13020 | 13084 | |
| 13021 | 13085 | @cindex Customize Emacs package (@t{Development/Docs/Texinfo}) |
| 13022 | -バージョン20から、GNU Emacsは@dfn{Customize}と呼ばれるユーザフレンドリなインターフェイスを提供して、ユーザが定義できる変数の値を変更できるようにしています。 | |
| 13023 | -詳細は、@xref{Easy Customization, , Easy Customization Interface, emacs, The GNU Emacs Manual}. | |
| 13086 | +GNU Emacsは、バージョン20から、@dfn{Customize}と呼ばれるユーザフレンドリなインターフェイスを提供して、ユーザが定義できる変数の値を変更できるようにしています。 | |
| 13087 | +@xref{Easy Customization, , Easy Customization Interface, emacs, The GNU Emacs Manual}. | |
| 13024 | 13088 | @kbd{M-x customize}コマンドを実行すれば、Texinfoの変数は@samp{Development/Docs/Texinfo}グループで見つけられます。 |
| 13025 | 13089 | |
| 13026 | 13090 |
| @@ -13032,8 +13096,8 @@ tex-show-queue-command "lpq" | ||
| 13032 | 13096 | |
| 13033 | 13097 | @TeX{}の書式化コマンドをTexinfoファイルに適用するもう一つの方法は、Texinfoファイル末尾の@dfn{ローカル変数リスト}にコマンドを記述する方法です。 |
| 13034 | 13098 | そして、@code{tex}や@code{texi2dvi}を@code{compile-command}として指定し、@kbd{M-x compile}を入力することによってEmacsに実行させることができます。 |
| 13035 | -これによって、@file{*compilation*}バッファと呼ばれる特殊なシェルが作成され、その中でEmacsがコンパイルコマンドを実行します。 | |
| 13036 | -例えば、@file{gdb.texinfo}ファイルの末尾の@code{@@bye}コマンドの後ろには、次のようなものを記述することが出来るでしょう。@refill | |
| 13099 | +これによって、@file{*compilation*}バッファと呼ばれる特殊なシェルが作成され、その中で、コンパイルコマンドをEmacsが実行します。 | |
| 13100 | +例えば、@file{gdb.texinfo}ファイルの末尾の@code{@@bye}コマンドの後ろには次のようなものを記述することが出来るでしょう。@refill | |
| 13037 | 13101 | |
| 13038 | 13102 | @example |
| 13039 | 13103 | @group |
| @@ -13044,19 +13108,18 @@ End: | ||
| 13044 | 13108 | @end example |
| 13045 | 13109 | |
| 13046 | 13110 | @noindent |
| 13047 | -このテクニックはこういうやり方でプログラムもコンパイルするプログラマによって最もよく使われます。 | |
| 13048 | -@ref{Compilation, , , emacs, The GNU Emacs Manual}を見てください。@refill | |
| 13111 | +このテクニックは、こういうやり方でプログラムもコンパイルするプログラマによって最もよく使われます。 | |
| 13112 | +@xref{Compilation, , , emacs, The GNU Emacs Manual}.@refill | |
| 13049 | 13113 | |
| 13050 | 13114 | |
| 13051 | 13115 | @node Requirements Summary |
| 13052 | -@section @TeX{} Formatting Requirements Summary | |
| 13053 | 13116 | @section @TeX{}による書式化の要件のまとめ |
| 13054 | 13117 | @cindex Requirements for formatting |
| 13055 | 13118 | @cindex Minimal requirements for formatting |
| 13056 | 13119 | @cindex Formatting requirements |
| 13057 | 13120 | |
| 13058 | -@TeX{}に入力されるTexinfoファイルは全て、@code{\input}コマンドで開始しなければなりません。 | |
| 13059 | -また@code{@@setfilename}コマンドが記述されていなければなりません。 | |
| 13121 | +@TeX{}に入力されるTexinfoファイルは@code{\input}コマンドで全て開始しなければなりません。 | |
| 13122 | +また、@code{@@setfilename}コマンドが記述されていなければなりません。 | |
| 13060 | 13123 | |
| 13061 | 13124 | @example |
| 13062 | 13125 | \input texinfo |
| @@ -13064,10 +13127,10 @@ End: | ||
| 13064 | 13127 | @end example |
| 13065 | 13128 | |
| 13066 | 13129 | @noindent |
| 13067 | -この最初のコマンドはTexinfoファイルを処理するのに必要なマクロをロードするよう@TeX{}に指示します。 | |
| 13130 | +この最初のコマンドは、Texinfoファイルを処理するのに必要なマクロをロードするよう@TeX{}に指示します。 | |
| 13068 | 13131 | 2番目のコマンドは補助的なファイルを開きます。 |
| 13069 | 13132 | |
| 13070 | -Texinfoファイルは全て@TeX{}の処理を終了させて、未完のページを強制的に出力させる行で終わらなければなりません。 | |
| 13133 | +Texinfoファイルは@TeX{}の処理を全て終了させて、未完のページを強制的に出力させる行で終わらなければなりません。 | |
| 13071 | 13134 | 次のようになります。 |
| 13072 | 13135 | |
| 13073 | 13136 | @example |
| @@ -13076,8 +13139,8 @@ Texinfoファイルは全て@TeX{}の処理を終了させて、未完のペー | ||
| 13076 | 13139 | |
| 13077 | 13140 | 厳密に言うと、Texinfoファイルが@TeX{}で上手く処理されるのに必要なものはこれらの行で全てとなります。 |
| 13078 | 13141 | |
| 13079 | -しかし通常は、ファイルの冒頭に、タイトルを定義する@code{@@settitle}コマンドや@code{@@setchapternewpage}コマンド、タイトルページ、著作権ページ、許諾などをインクルードします。 | |
| 13080 | -ファイルの末尾には通常、@code{@@bye}コマンドに加えて、索引や目次がインクルードされます。 | |
| 13142 | +しかし、通常は、ファイルの冒頭に、タイトルを定義する@code{@@settitle}コマンドや@code{@@setchapternewpage}コマンド、タイトルページ、著作権ページ、許諾などをインクルードします。 | |
| 13143 | +通常、ファイルの末尾には、@code{@@bye}コマンドに加えて索引や目次がインクルードされます。 | |
| 13081 | 13144 | (もちろん大半のマニュアルには本文というものもあります。) |
| 13082 | 13145 | |
| 13083 | 13146 | 詳細は以下を参照してください。 |
| @@ -13102,31 +13165,32 @@ Texinfoファイルは全て@TeX{}の処理を終了させて、未完のペー | ||
| 13102 | 13165 | |
| 13103 | 13166 | @TeX{}は、最初の行にある@samp{\input texinfo}コマンドが読み込む@file{texinfo.tex}ファイルが置かれている場所を知っている必要があります。 |
| 13104 | 13167 | @file{texinfo.tex}ファイルは@@-コマンドの処理方法を@TeX{}に指示するもので、標準のGNUの配布物には全て含まれています。 |
| 13105 | -最新版はTexinfoのソースリポジトリから常に取得可能です。 | |
| 13168 | +最新版は、Texinfoのソースリポジトリから常に取得可能です。 | |
| 13106 | 13169 | @smalldisplay |
| 13107 | 13170 | @uref{http://savannah.gnu.org/cgi-bin/viewcvs/texinfo/texinfo/doc/texinfo.tex?rev=HEAD} |
| 13108 | 13171 | @end smalldisplay |
| 13109 | 13172 | |
| 13110 | 13173 | @pindex texinfo.tex@r{, installing} |
| 13111 | 13174 | |
| 13112 | -通常は、GNU TexinfoやEmacs、あるいはその他のGNUソフトウェアがインストールされた際、そのインストーラが、@TeX{}のマクロが置かれるデフォルトディレクトリに@file{texinfo.tex}ファイルを配置します。 | |
| 13175 | +通常、GNU Texinfo、Emacs、その他のGNUソフトウェアがインストールされた際、そのインストーラが、@TeX{}のマクロが置かれるデフォルトディレクトリに@file{texinfo.tex}ファイルを配置します。 | |
| 13113 | 13176 | この場合だと、@TeX{}はファイルの場所が分かりますので、ユーザが何か特別なことをする必要はありません。 |
| 13114 | 13177 | これが行なわれなかった場合、@TeX{}を実行する際のカレントディレクトリに@file{texinfo.tex}ファイルを置いておくことが出来ます。 |
| 13115 | 13178 | そうすれば、@TeX{}がファイルを見つけられるでしょう。 |
| 13116 | 13179 | |
| 13117 | 13180 | @pindex epsf.tex@r{, installing} |
| 13118 | 13181 | また、@file{epsf.tex}ファイルが別の配布物によってまだインストールされていない場合は、このファイルもインストールすべきでしょう。 |
| 13119 | -詳しいことは@code{@@image}コマンドの説明の終わりの部分にあります(@pxref{Images})。 | |
| 13182 | +詳細は、@code{@@image}コマンドの説明の終わりの部分にあります(@pxref{Images})。 | |
| 13120 | 13183 | |
| 13121 | 13184 | @cindex European Computer Modern fonts, installing |
| 13122 | 13185 | @cindex EC fonts, installing |
| 13123 | 13186 | @cindex CM-Super fonts, installing |
| 13124 | 13187 | 英語以外の言語で使用される引用符を使えるようにする場合、European Computer ModernフォントとCM-Superフォントがまだインストールされていなければ、インストールする必要があるでしょう。 |
| 13125 | -CM-Superは無くても構いません。(@pxref{Inserting Quotation Marks}) | |
| 13188 | +CM-Superは無くても構いません(@pxref{Inserting Quotation Marks})。 | |
| 13126 | 13189 | |
| 13127 | 13190 | @pindex feymr10@r{, installing} |
| 13128 | 13191 | @cindex Euro font, installing |
| 13129 | -@code{@@euro}コマンドを使うことがある場合、まだインストールされていなければ、Euroフォントもインストールすべきです。@xref{euro}. | |
| 13192 | +@code{@@euro}コマンドを使うことがある場合、まだインストールされていなければ、Euroフォントもインストールすべきです。 | |
| 13193 | +@xref{euro}. | |
| 13130 | 13194 | |
| 13131 | 13195 | @pindex texinfo.cnf @r{installation} |
| 13132 | 13196 | @cindex Customizing of @TeX{} for Texinfo |
| @@ -13134,16 +13198,16 @@ CM-Superは無くても構いません。(@pxref{Inserting Quotation Marks}) | ||
| 13134 | 13198 | 任意ですが、@file{texinfo.cnf}ファイルを追加的に作成して、インストールすることも出来ます。 |
| 13135 | 13199 | このファイルは、@code{@@setfilename}コマンドが実行される際に@TeX{}によって読み込まれます(@pxref{setfilename,, @code{@@setfilename}})。 |
| 13136 | 13200 | その中には、ローカルサイト全体の慣習に応じて、好きなコマンドを何でも入れることが可能です。 |
| 13137 | -ここに書かれたコマンドは、あらゆるTexinfoドキュメントが処理されるたびに、@TeX{}によって読み込まれることになります。 | |
| 13138 | -例えば、@file{texinfo.cnf}ファイルに@samp{@@afourpaper} (@pxref{A4 Paper})という行があると、Texinfoドキュメントは全てそのページサイズで処理されるようになります。 | |
| 13201 | +ここに書かれたコマンドは、あらゆるTexinfoドキュメントが処理されるたびに@TeX{}によって読み込まれることになります。 | |
| 13202 | +例えば、@file{texinfo.cnf}ファイルに@samp{@@afourpaper} (@pxref{A4 Paper})という行があると、Texinfoドキュメントはそのページサイズで全て処理されるようになります。 | |
| 13139 | 13203 | @file{texinfo.cnf}ファイルに入れるものが何も無ければ、ファイルを作成する必要はありません。 |
| 13140 | 13204 | |
| 13141 | 13205 | @cindex Environment variable @code{TEXINPUTS} |
| 13142 | 13206 | @vindex TEXINPUTS |
| 13143 | -これらシステムファイルについて上述した場所のいずれでも不足の場合には、ディレクトリを明示的に指定することも出来ます。 | |
| 13207 | +これらシステムファイルについて、上述した場所のいずれでも不足の場合には、ディレクトリを明示的に指定することも出来ます。 | |
| 13144 | 13208 | @file{texinfo.tex}ファイルについては、@code{\input}コマンドの後ろにファイルへの完全なパスを記述することで対処できます。 |
| 13145 | 13209 | 別の方法として、ユーザが使用する@file{.cshrc}ファイルや@file{.profile}ファイルの中で@code{TEXINPUTS}環境変数を設定する方法があります。 |
| 13146 | -これは@file{texinfo.tex}ファイルと@file{texinfo.cnf}ファイル(およびその他@TeX{}が読み込むかもしれないファイル)のいずれにも効果があります。 | |
| 13210 | +これは、@file{texinfo.tex}ファイルと@file{texinfo.cnf}ファイル(および、その他@TeX{}が読み込むかもしれないファイル)のいずれにも効果があります。 | |
| 13147 | 13211 | |
| 13148 | 13212 | @file{.cshrc}ファイルか@file{.profile}ファイルのどちらを使うのかは、ユーザが使用しているコマンドインタプリタがBourneシェル互換(@code{sh}、@code{bash}、@code{ksh}、@dots{})なのかCシェル互換(@code{csh}、@code{tcsh})なのかによって変わります。 |
| 13149 | 13213 | 後者は初期化情報として@file{.cshrc}を読み込みますし、前者は@file{.profile}を読み込みます。 |
| @@ -13164,7 +13228,7 @@ export TEXINPUTS | ||
| 13164 | 13228 | @end group |
| 13165 | 13229 | @end example |
| 13166 | 13230 | |
| 13167 | -MS-DOS/MS-Windowsの場合、同じことを次のように書けます。@footnote{これらのシステムではディレクトリセパレータとして@samp{:}文字ではなく、@samp{;}文字を使いますので注意してください。} | |
| 13231 | +MS-DOS/MS-Windowsの場合、同じことを次のように書けます@footnote{これらのシステムでは、ディレクトリセパレータとして、@samp{:}文字ではなく@samp{;}文字を使いますので注意してください。}。 | |
| 13168 | 13232 | |
| 13169 | 13233 | @example |
| 13170 | 13234 | @group |
| @@ -13173,7 +13237,7 @@ set TEXINPUTS=.;d:/home/me/mylib;c: | ||
| 13173 | 13237 | @end example |
| 13174 | 13238 | |
| 13175 | 13239 | @noindent |
| 13176 | -DOS/Windowsユーザは、こういったコマンドを@file{autoexec.bat}ファイルに入れるか、あるいはウィンドウズのレジストリに入れるのが通例となっています。 | |
| 13240 | +DOS/Windowsユーザは、こういったコマンドを@file{autoexec.bat}ファイルに入れるか、あるいは、ウィンドウズのレジストリに入れるのが通例となっています。 | |
| 13177 | 13241 | |
| 13178 | 13242 | @noindent |
| 13179 | 13243 | これらの設定を使うと、@TeX{}は、まず@samp{.}で示されているカレントディレクトリの中で@file{\input}のファイルを探索します。 |
| @@ -13184,7 +13248,7 @@ DOS/Windowsユーザは、こういったコマンドを@file{autoexec.bat}フ | ||
| 13184 | 13248 | @cindex Format file, dumping |
| 13185 | 13249 | @TeX{}がTexinfoをより速くロードできるように、@file{.fmt}ファイル(@pxref{Memory dumps,,, web2c, Web2c})をダンプしたいと思うかもしれません。 |
| 13186 | 13250 | (これの不利な点は、@file{texinfo.tex}が更新されると再ダンプが必要となるところです。) |
| 13187 | -次のコマンドを実行すればこれを行なうことが出来ます。 | |
| 13251 | +これは、次のコマンドを実行すれば、行なうことが出来ます。 | |
| 13188 | 13252 | @file{epsf.tex}ファイルを@TeX{}が読み込めるものとします。 |
| 13189 | 13253 | |
| 13190 | 13254 | @example |
| @@ -13194,7 +13258,7 @@ initex texinfo @@dump | ||
| 13194 | 13258 | @noindent |
| 13195 | 13259 | (@code{dump}は@TeX{} primitiveです。) |
| 13196 | 13260 | 次に、@file{texinfo.fmt}をユーザの@code{.fmt}ファイルがある場所へ移動してください。 |
| 13197 | -通常は@TeX{}がインストールされている場所の@file{web2c}というサブディレクトリの中にあります。 | |
| 13261 | +通常は、@TeX{}がインストールされている場所の@file{web2c}というサブディレクトリの中にあります。 | |
| 13198 | 13262 | |
| 13199 | 13263 | |
| 13200 | 13264 | @node Overfull hboxes |
| @@ -13203,8 +13267,8 @@ initex texinfo @@dump | ||
| 13203 | 13267 | @cindex @samp{hboxes}, overfull |
| 13204 | 13268 | @cindex Final output |
| 13205 | 13269 | |
| 13206 | -@TeX{}は、右マージンへ行がはみ出さなければ組版することが出来ないことがあります。 | |
| 13207 | -これは、例えばEメールのネットワークアドレスや極端に長いタイトルのように、ハイフンを入れることが出来ないような長い単語として解釈されるものに@TeX{}が遭遇した時に発生します。 | |
| 13270 | +@TeX{}は、右マージンへ行がはみ出さなければ組版できないことがあります。 | |
| 13271 | +これは、例えば、Eメールのネットワークアドレスや極端に長いタイトルのようにハイフンを入れることが出来ないような長い単語として解釈されるものに@TeX{}が遭遇した時に発生します。 | |
| 13208 | 13272 | こうなった場合、@TeX{}は次のようなエラーメッセージを表示します。 |
| 13209 | 13273 | |
| 13210 | 13274 | @example |
| @@ -13213,15 +13277,16 @@ Overfull @@hbox (20.76302pt too wide) | ||
| 13213 | 13277 | |
| 13214 | 13278 | @findex hbox |
| 13215 | 13279 | @noindent |
| 13216 | -(@TeX{}では、行のことを「horizontal box」と呼びますので、「hbox」という用語が使われます。 | |
| 13217 | -@samp{@@hbox}は@TeX{} primitiveで、Texinfo言語では必要ありません。) | |
| 13280 | +(@TeX{}では行のことを「horizontal box」と呼びますので、「hbox」という用語が使われます。 | |
| 13281 | +@samp{@@hbox}は@TeX{} primitiveです。 | |
| 13282 | +Texinfo言語では必要ありません。) | |
| 13218 | 13283 | |
| 13219 | -@TeX{}はまた、Texinfoソースファイルに行番号と、問題が発生している行のテキストを表示します。 | |
| 13220 | -テキストはハイフンの挿入が考慮される場所全てにマークがされています。 | |
| 13221 | -組版時のエラーについては、@xref{Debugging with TeX, , Catching Errors with @TeX{} Formatting}. | |
| 13284 | +また、@TeX{}は、Texinfoソースファイルの行番号と問題が発生している行のテキストを表示します。 | |
| 13285 | +テキストは、ハイフンの挿入が考慮される場所全てにマークがされています。 | |
| 13286 | +組版時のエラーについては別の節を参照してください(@pxref{Debugging with TeX, , Catching Errors with @TeX{} Formatting})。 | |
| 13222 | 13287 | |
| 13223 | 13288 | Texinfoファイルがoverfull hboxになる場合には、overfull hboxが発生しないようセンテンスを書き直すことも可能です。 |
| 13224 | -あるいはそのままにすることも可能です。 | |
| 13289 | +あるいは、そのままにすることも可能です。 | |
| 13225 | 13290 | 右余白へ少しくらいはみ出ても問題無く、目立たないことも多いです。 |
| 13226 | 13291 | |
| 13227 | 13292 | overfull boxが沢山発生したりして、書き換えるのを避けたいような場合は、@TeX{}に、単語間のスペースを可能な限り大きく広げさせることも可能です。 |
| @@ -13245,12 +13310,12 @@ overfull boxが沢山発生したりして、書き換えるのを避けたい | ||
| 13245 | 13310 | @cindex Rectangle, black in hardcopy |
| 13246 | 13311 | @cindex Box, ugly black in hardcopy |
| 13247 | 13312 | @cindex Ugly black rectangles in hardcopy |
| 13248 | -しかし@TeX{}は、別に指示が無ければ、overfull boxになった行に対して大きくて見苦しく黒い長方形を出力します。 | |
| 13249 | -これは、ドラフトを修正している場合に問題がある箇所を見つけやすくするためです。 | |
| 13313 | +しかし、@TeX{}は、別に指示が無ければ、overfull boxになった行に対して大きくて見苦しく黒い長方形を出力します。 | |
| 13314 | +これは、ドラフトを修正している場合に、問題がある箇所を見つけやすくするためです。 | |
| 13250 | 13315 | |
| 13251 | 13316 | @findex finalout |
| 13252 | 13317 | そういう異常物体によって最終的な出力が台無しにされないようにするためには、Texinfoファイルの冒頭に次のように書いてください。 |
| 13253 | -これは@code{@@titlepage}コマンドの前に単独で書きます。 | |
| 13318 | +これは、@code{@@titlepage}コマンドの前に単独で書きます。 | |
| 13254 | 13319 | |
| 13255 | 13320 | @example |
| 13256 | 13321 | @@finalout |
| @@ -13267,7 +13332,7 @@ overfull boxが沢山発生したりして、書き換えるのを避けたい | ||
| 13267 | 13332 | |
| 13268 | 13333 | デフォルトでは、@TeX{}は8.5x11インチの体裁で印刷するようにページを組みます。 |
| 13269 | 13334 | しかし、製本された本に適した7x9.25インチの書式でドキュメントを組版するように@TeX{}に指示することも出来ます。 |
| 13270 | -そうするには、Texinfoファイルの冒頭でタイトルページの前に以下のコマンドを単独で記述します。 | |
| 13335 | +そうするには、Texinfoファイルの冒頭で、タイトルページの前に、以下のコマンドを単独で記述します。 | |
| 13271 | 13336 | |
| 13272 | 13337 | @example |
| 13273 | 13338 | @@smallbook |
| @@ -13278,9 +13343,9 @@ overfull boxが沢山発生したりして、書き換えるのを避けたい | ||
| 13278 | 13343 | |
| 13279 | 13344 | start-of-header行とend-of-header行の間に@code{@@smallbook}コマンドを記述した場合、Texinfoモードの@TeX{}によるリージョン書式化コマンド@code{texinfo-tex-region}は、「small」な本の大きさでリージョンを書式化します(@pxref{Start of Header})。@refill |
| 13280 | 13345 | |
| 13281 | -より小さいマニュアルに対するexampleをもっと簡単に生成できるようにするコマンドについては、@xref{small}. | |
| 13346 | +より小さいマニュアルに対するexampleをもっと簡単に生成できるようにするコマンドについては別の節を参照してください(@pxref{small})。 | |
| 13282 | 13347 | |
| 13283 | -ソースファイルを変更することなく@code{@@smallbook}で書式化する他の方法については@ref{Format with texi2dvi}と@ref{Preparing for TeX,,Preparing for @TeX{}}を参照してください。 | |
| 13348 | +ソースファイルを変更することなく@code{@@smallbook}で書式化する他の方法については別の節を参照してください(@pxref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for @TeX{}})。 | |
| 13284 | 13349 | |
| 13285 | 13350 | |
| 13286 | 13351 | @node A4 Paper |
| @@ -13291,9 +13356,9 @@ start-of-header行とend-of-header行の間に@code{@@smallbook}コマンドを | ||
| 13291 | 13356 | @cindex European A4 paper |
| 13292 | 13357 | @findex afourpaper |
| 13293 | 13358 | |
| 13294 | -@code{@@afourpaper}コマンド(あるいは@code{@@afivepaper}コマンド)を使うと、欧州サイズのA4用紙(あるいはA5用紙)へ印刷するドキュメントを書式化するよう@TeX{}に指示することが出来ます。 | |
| 13295 | -このコマンドはTexinfoファイルの冒頭付近のタイトルページの前に単独で記述してください。 | |
| 13296 | -例えば、以下はこのマニュアルのヘッダを記述する方法を示しています。 | |
| 13359 | +@code{@@afourpaper}コマンド(あるいは、@code{@@afivepaper}コマンド)を使うと、欧州サイズのA4用紙(あるいはA5用紙)へ印刷するドキュメントを書式化するよう@TeX{}に指示することが出来ます。 | |
| 13360 | +このコマンドは、Texinfoファイルの冒頭付近のタイトルページの前に単独で記述してください。 | |
| 13361 | +例えば、以下は、このマニュアルのヘッダを記述する方法を示しています。 | |
| 13297 | 13362 | |
| 13298 | 13363 | @example |
| 13299 | 13364 | @group |
| @@ -13306,7 +13371,7 @@ start-of-header行とend-of-header行の間に@code{@@smallbook}コマンドを | ||
| 13306 | 13371 | @end group |
| 13307 | 13372 | @end example |
| 13308 | 13373 | |
| 13309 | -ソースファイルを変更すること無く違う用紙サイズ向けの書式化を行なう方法については、@ref{Format with texi2dvi}や@ref{Preparing for TeX,,Preparing for @TeX{}}を参照してください。 | |
| 13374 | +ソースファイルを変更すること無く違う用紙サイズ向けの書式化を行なう方法については別の節を参照してください(@pxref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for @TeX{}})。 | |
| 13310 | 13375 | |
| 13311 | 13376 | @findex afourlatex |
| 13312 | 13377 | @findex afourwide |
| @@ -13324,9 +13389,9 @@ start-of-header行とend-of-header行の間に@code{@@smallbook}コマンドを | ||
| 13324 | 13389 | @cindex Depth of text area |
| 13325 | 13390 | |
| 13326 | 13391 | @code{@@pagesizes}コマンドを使って、ページ上の主たるテキスト領域の高さと幅(幅は省略可能)を明示的に指定することも出来ます。 |
| 13327 | -このコマンドはTexinfoファイルの冒頭付近のタイトルページより前に単独で記述してください。 | |
| 13392 | +このコマンドは、Texinfoファイルの冒頭付近のタイトルページより前に、単独で記述してください。 | |
| 13328 | 13393 | 高さを先に記述します。 |
| 13329 | -必要があれば次に幅を記述してください。 | |
| 13394 | +必要があれば、次に幅を記述してください。 | |
| 13330 | 13395 | 間はカンマで区切ります。 |
| 13331 | 13396 | 例を挙げます。 |
| 13332 | 13397 |
| @@ -13340,14 +13405,13 @@ start-of-header行とend-of-header行の間に@code{@@smallbook}コマンドを | ||
| 13340 | 13405 | |
| 13341 | 13406 | @cindex B5 paper, printing on |
| 13342 | 13407 | @cindex Legal paper, printing on |
| 13343 | -これはB5サイズの用紙に印刷する場合に適当です。 | |
| 13408 | +これは、B5サイズの用紙に印刷する場合に適当です。 | |
| 13344 | 13409 | 強調しますが、このコマンドは@emph{テキスト領域}のサイズを指定するものであって、用紙サイズ(B5は250@dmn{mm}x177@dmn{mm}、legalは14@dmn{in}x8.5@dmn{in})を指定するものではありません。 |
| 13345 | 13410 | |
| 13346 | 13411 | @cindex Margins on page, not controllable |
| 13347 | -例えば、ページの余白をいずれかを変更するなどのように、もっとも細かな変更を行なうには、@file{texinfo.tex}ファイル(あるいは@file{texinfo.cnf}ファイル、@pxref{Preparing for TeX,,Preparing for @TeX{}})の中に新しいコマンドを定義しなければなりません。 | |
| 13412 | +例えば、ページの余白をいずれかを変更するなどのように、もっと細かな変更を行なうには、@file{texinfo.tex}ファイル(あるいは、@file{texinfo.cnf}ファイル(@pxref{Preparing for TeX,,Preparing for @TeX{}}))の中に新しいコマンドを定義しなければなりません。 | |
| 13348 | 13413 | |
| 13349 | -ソースファイルを変更すること無く@code{@@pagesizes}を指定する他の方法については、 | |
| 13350 | -@ref{Format with texi2dvi}や@ref{Preparing for TeX,,Preparing for @TeX{}}を参照してください。 | |
| 13414 | +ソースファイルを変更すること無く@code{@@pagesizes}を指定する他の方法については別の節を参照してください(@pxref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for @TeX{}})。 | |
| 13351 | 13415 | |
| 13352 | 13416 | @code{@@pagesizes}は@code{makeinfo}には無視されます。 |
| 13353 | 13417 |
| @@ -13358,7 +13422,7 @@ start-of-header行とend-of-header行の間に@code{@@smallbook}コマンドを | ||
| 13358 | 13422 | @cindex Cropmarks for printing |
| 13359 | 13423 | @cindex Printing cropmarks |
| 13360 | 13424 | @code{@@cropmarks}コマンドを使って各ページの隅にクロップマーク@footnote{訳注:裁断したり、多色刷りする場合に見当として使われる印。日本語ではトンボとも言うそうです。}を印刷するよう@TeX{}に指示する(指示を試みる)ことも可能です。 |
| 13361 | -@code{@@cropmarks}コマンドはTexinfoファイルの冒頭付近のタイトルページの前に記述してください。 | |
| 13425 | +@code{@@cropmarks}コマンドは、Texinfoファイルの冒頭付近のタイトルページの前に記述してください。 | |
| 13362 | 13426 | @code{@@iftex}コマンドと@code{@@end iftex}コマンドの間に単独で記述します。 |
| 13363 | 13427 | 次のようになります。@refill |
| 13364 | 13428 |
| @@ -13370,21 +13434,21 @@ start-of-header行とend-of-header行の間に@code{@@smallbook}コマンドを | ||
| 13370 | 13434 | @end group |
| 13371 | 13435 | @end example |
| 13372 | 13436 | |
| 13373 | -このコマンドは主に一枚のフィルムシートに何ページもページ組みをするプリンタのためのものですが、@code{@@smallbook}コマンドで7x9.25インチに設定された本の隅に印を付けるのに使用してみることも出来ます。 | |
| 13437 | +このコマンドは、主に、一枚のフィルムシートに何ページもページ組みをするプリンタのためのものです。 | |
| 13438 | +@code{@@smallbook}コマンドで7x9.25インチに設定された本の隅に印を付けるのに使用してみることも出来ます。 | |
| 13374 | 13439 | (プリンタは、通常サイズの用紙に印刷される通常サイズの出力にはクロップマークを生成しません。) |
| 13375 | -印刷機械は機械ごとに様々な手順で動作しますので、このコマンドの使い方については、冒険心を持って探っていくべきでしょう。 | |
| 13440 | +印刷機械は機械ごとに様々な手順で動作しますので、このコマンドの使い方については冒険心を持って探っていくべきでしょう。 | |
| 13376 | 13441 | @file{texinfo.tex}ファイルのコマンドを定義しなおさなければならなくなるかもしれません。 |
| 13377 | 13442 | |
| 13378 | 13443 | @findex \mag @r{(raw @TeX{} magnification)} |
| 13379 | 13444 | @cindex Magnified printing |
| 13380 | 13445 | @cindex Larger or smaller pages |
| 13381 | 13446 | @TeX{}の@code{\mag}コマンドを使うと、ページを拡大縮小させて組版するよう@TeX{}に指示してみることも可能です。 |
| 13382 | -組版されるもの全てがそれに応じて拡大縮小されます。 | |
| 13383 | -(@code{\mag}は「magnification」の意味です。) | |
| 13384 | -これはTexinfoの@@-コマンドでは@emph{無く}、バックスラッシュが前に付けられたplain @TeX{}のコマンドです。 | |
| 13385 | -このコマンドは@code{@@tex}コマンドと@code{@@end tex}コマンドの間に記述しなければなりません(@pxref{Raw Formatter Commands})。 | |
| 13447 | +それに応じて、組版されるものが全て拡大縮小されます(@code{\mag}は「magnification」の意味です)。 | |
| 13448 | +これは、Texinfoの@@-コマンドでは@emph{無く}バックスラッシュが前に付けられたplain @TeX{}のコマンドです。 | |
| 13449 | +このコマンドは、@code{@@tex}コマンドと@code{@@end tex}コマンドの間に記述しなければなりません(@pxref{Raw Formatter Commands})。 | |
| 13386 | 13450 | |
| 13387 | -@code{\mag}コマンドに続けて@samp{=}を記述し、さらに希望する倍率を1000倍にした数値を書きます。 | |
| 13451 | +@code{\mag}コマンドに続けて@samp{=}を記述し、さらに、希望する倍率を1000倍にした数値を書きます。 | |
| 13388 | 13452 | 例えば、通常サイズの1.2倍でページを印刷する場合には、Texinfoファイルの冒頭付近のタイトルページの前に以下のコマンドを記述してください。 |
| 13389 | 13453 | |
| 13390 | 13454 | @example |
| @@ -13398,7 +13462,7 @@ start-of-header行とend-of-header行の間に@code{@@smallbook}コマンドを | ||
| 13398 | 13462 | 印刷技術によっては、印刷店にノーマルサイズよりも大きいマスターを渡すほうが、通常より仕上りの良いノーマルサイズの版が印刷できることがあります。 |
| 13399 | 13463 | 印刷店は縮小を行なって、効果的に解像度を上げます。 |
| 13400 | 13464 | |
| 13401 | -使用しているシステムによっては、標準的でない@code{\mag}で調整されたDVIファイルが印刷できなかったり、あるいは特定の倍率でしか印刷できなかったりします。 | |
| 13465 | +使用しているシステムによっては、標準的でない@code{\mag}で調整されたDVIファイルが印刷できなかったり、特定の倍率でしか印刷できなかったりします。 | |
| 13402 | 13466 | 試行錯誤する心積もりが必要です。 |
| 13403 | 13467 | |
| 13404 | 13468 |
| @@ -13408,10 +13472,10 @@ start-of-header行とend-of-header行の間に@code{@@smallbook}コマンドを | ||
| 13408 | 13472 | |
| 13409 | 13473 | @pindex pdftex |
| 13410 | 13474 | TexinfoのソースからPDF出力を生成する最も簡単な方法は、重宝するスクリプト@command{texi2pdf}を実行することです。 |
| 13411 | -(あるいは@command{pdftexi2dvi}を使います。 | |
| 13412 | -このスクリプトは単に@option{--pdf}を付けて@command{texi2dvi}スクリプトを実行するものです(@pxref{Format with texi2dvi})。) | |
| 13413 | -何らかの理由で、手作業でドキュメントを処理したい場合には、プレインの@command{tex}コマンドの代わりに@command{pdftex}プログラムを単に実行してください。 | |
| 13414 | -つまり@samp{tex foo.texi}ではなく、@samp{pdftex foo.texi}を実行します。 | |
| 13475 | +(あるいは、@command{pdftexi2dvi}を使います。 | |
| 13476 | +このスクリプトは、単に@option{--pdf}を付けて@command{texi2dvi}スクリプトを実行するものです(@pxref{Format with texi2dvi})。) | |
| 13477 | +何らかの理由で手作業でドキュメントを処理したい場合には、プレインの@command{tex}コマンドの代わりに@command{pdftex}プログラムを単に実行してください。 | |
| 13478 | +つまり、@samp{tex foo.texi}ではなく、@samp{pdftex foo.texi}を実行します。 | |
| 13415 | 13479 | |
| 13416 | 13480 | @dfn{PDF}は「Portable Document Format」の略です。 |
| 13417 | 13481 | ドキュメント交換を目的として、Adobe Systemsが自らのPostScript言語を元に数年前に開発しました。 |
| @@ -13431,12 +13495,12 @@ PDF reader} for the X window system. | ||
| 13431 | 13495 | |
| 13432 | 13496 | @end itemize |
| 13433 | 13497 | |
| 13434 | -現時点において、Texinfoでは他の出力形式と同じような@samp{@@ifpdf}コマンドや@samp{@@odf}コマンドを提供していません。 | |
| 13498 | +現時点において、他の出力形式と同じような@samp{@@ifpdf}コマンドや@samp{@@odf}コマンドをTexinfoでは提供していません。 | |
| 13435 | 13499 | これは、PDFが持つ多数の内部リンクをTexinfoのソースレベルで正しくなるようにするのが難しかったり、不可能だったりするからです。 |
| 13436 | 13500 | |
| 13437 | 13501 | TexinfoがサポートするプレインのASCIIフォーマット(InfoやHTML)とは異なり、PDFファイルは表示に特別なソフトウェアが必要となります。 |
| 13438 | -また、デフォルトでは@TeX{}が出力するDVIファイルと比べて、かなりサイズが大きくなる傾向があります。 | |
| 13439 | -とは言え、PDFファイルは自己完結したファイルの中に実際に組版されたドキュメントを定義できることで、今の地位を保持しています。 | |
| 13502 | +また、@TeX{}が出力するDVIファイルと比べて、デフォルトではかなりサイズが大きくなる傾向があります。 | |
| 13503 | +とは言え、自己完結したファイルの中に実際に組版されたドキュメントを定義できることでPDFファイルは今の地位を保持しています。 | |
| 13440 | 13504 | |
| 13441 | 13505 | |
| 13442 | 13506 | @node Obtaining TeX |
| @@ -13457,7 +13521,7 @@ Unixシステム用の@TeX{}はanonymous ftpや物理メディアから入手可 | ||
| 13457 | 13521 | anonymous ftpによる取得手順やその他の利用可能な配布物については@uref{http://tug.org/unixtex.ftp}を参照してください。 |
| 13458 | 13522 | |
| 13459 | 13523 | Free Software Foundationはコアとなる配布物をSource Code CD-ROMで提供しています。 |
| 13460 | -これはTexinfoで書かれたマニュアルを印刷するのに適したものです。 | |
| 13524 | +これは、Texinfoで書かれたマニュアルを印刷するのに適したものです。 | |
| 13461 | 13525 | このCD-ROMを注文する場合は以下に連絡をください。 |
| 13462 | 13526 | |
| 13463 | 13527 | @display |
| @@ -13475,7 +13539,7 @@ Electronic mail: @code{gnu@@gnu.org} | ||
| 13475 | 13539 | @end group |
| 13476 | 13540 | @end display |
| 13477 | 13541 | |
| 13478 | -他にも多数の@TeX{}配布物が利用できいます。 | |
| 13542 | +他にも多数の@TeX{}配布物が利用できます。 | |
| 13479 | 13543 | @uref{http://tug.org/}を参照してください。 |
| 13480 | 13544 | |
| 13481 | 13545 |
| @@ -13483,7 +13547,7 @@ Electronic mail: @code{gnu@@gnu.org} | ||
| 13483 | 13547 | @chapter Infoファイルの作成とインストール |
| 13484 | 13548 | |
| 13485 | 13549 | この章では、Infoファイルを作成する方法とインストール方法を説明します。 |
| 13486 | -ファイルの書式自体について一般的な情報は@ref{Info Files}を参照してください。 | |
| 13550 | +ファイルの書式自体について一般的な情報は別の節を参照してください(@pxref{Info Files})。 | |
| 13487 | 13551 | |
| 13488 | 13552 | @menu |
| 13489 | 13553 | * Creating an Info File:: |
| @@ -13497,10 +13561,10 @@ Electronic mail: @code{gnu@@gnu.org} | ||
| 13497 | 13561 | @cindex Info, creating an online file |
| 13498 | 13562 | @cindex Formatting a file for Info |
| 13499 | 13563 | |
| 13500 | -@code{makeinfo}プログラムは、TexinfoファイルをInfoファイルやHTMLファイル、プレインテキストに変換するプログラムです。 | |
| 13564 | +@code{makeinfo}プログラムは、Texinfoファイルを、Infoファイル・HTMLファイル・プレインテキストに変換するプログラムです。 | |
| 13501 | 13565 | @code{texinfo-format-region}コマンドや@code{texinfo-format-buffer}コマンドは、TexinfoをInfoへ変換するGNU Emacsの機能です。 |
| 13502 | 13566 | |
| 13503 | -InfoファイルのInfoシステムへのインストールについては、@ref{Installing an Info File}を参照してください。 | |
| 13567 | +InfoファイルのInfoシステムへのインストールについては別の節を参照してください(@pxref{Installing an Info File})。 | |
| 13504 | 13568 | |
| 13505 | 13569 | @menu |
| 13506 | 13570 | * makeinfo advantages:: @code{makeinfo} provides better error checking. |
| @@ -13524,11 +13588,11 @@ InfoファイルのInfoシステムへのインストールについては、@re | ||
| 13524 | 13588 | このユーティリティはお勧めです。 |
| 13525 | 13589 | @code{makeinfo}はEmacsからは独立したCプログラムです。 |
| 13526 | 13590 | @code{makeinfo}を使うのにEmacsを起動する必要はありません。 |
| 13527 | -つまり、Emacsを実行するには非力なマシン上で@code{makeinfo}を実行することが出来るということです。 | |
| 13591 | +つまり、Emacsを実行するには、非力なマシン上で@code{makeinfo}を実行することが出来るということです。 | |
| 13528 | 13592 | @code{makeinfo}は三つある方法のいずれかで起動できます。 |
| 13529 | -まず、オペレーティングシステムのシェルから起動する方法、次に、Emacs上のシェルから起動する方法、そしてEmacsのTexinfoモードのコマンド@kbd{C-c C-m C-r}もしくは@kbd{C-c C-m C-b}を入力して起動する方法です。 | |
| 13593 | +まず、オペレーティングシステムのシェルから起動する方法、次に、Emacs上のシェルから起動する方法、そして、EmacsのTexinfoモードのコマンド@kbd{C-c C-m C-r}、もしくは、@kbd{C-c C-m C-b}を入力して起動する方法です。 | |
| 13530 | 13594 | |
| 13531 | -@code{texinfo-format-region}コマンドと@code{texinfo-format-buffer}コマンドは、@code{makeinfo}を実行できない場合に役に立ちます。 | |
| 13595 | +@code{makeinfo}を実行できない場合、@code{texinfo-format-region}コマンドと@code{texinfo-format-buffer}コマンドは役に立ちます。 | |
| 13532 | 13596 | また、状況によっては、短かいリージョンやバッファを書式化する場合、@code{makeinfo}より速く動作することもあります。 |
| 13533 | 13597 | |
| 13534 | 13598 |
| @@ -13537,7 +13601,7 @@ InfoファイルのInfoシステムへのインストールについては、@re | ||
| 13537 | 13601 | @pindex makeinfo |
| 13538 | 13602 | |
| 13539 | 13603 | TexinfoファイルからInfoファイルを作成するには、@command{makeinfo}にTexinfoファイルの名前を続けて書いて起動します。 |
| 13540 | -従って、BisonについてのInfoファイルを作成する場合、シェルで次のように入力してください。 | |
| 13604 | +したがって、BisonについてのInfoファイルを作成する場合、次のようにシェルに入力してください。 | |
| 13541 | 13605 | |
| 13542 | 13606 | @example |
| 13543 | 13607 | makeinfo bison.texinfo |
| @@ -13550,7 +13614,7 @@ makeinfo bison.texinfo | ||
| 13550 | 13614 | |
| 13551 | 13615 | @command{makeinfo}プログラムに複数の入力ファイル名を指定することも出来ます。 |
| 13552 | 13616 | その場合、各ファイルは順番に処理されます。 |
| 13553 | -入力ファイル名が@samp{-}だったり、入力ファイル名が全く指定されなかった場合には、標準入力が読み込まれます。 | |
| 13617 | +入力ファイル名が@samp{-}だったり、入力ファイル名が全く指定されなかった場合には標準入力が読み込まれます。 | |
| 13554 | 13618 | |
| 13555 | 13619 | |
| 13556 | 13620 | @node makeinfo options |
| @@ -13560,12 +13624,12 @@ makeinfo bison.texinfo | ||
| 13560 | 13624 | |
| 13561 | 13625 | @command{makeinfo}プログラムは多数のオプションを受け付けます。 |
| 13562 | 13626 | 恐らく、最もよく必要とされるのは出力書式を変更するオプションでしょう。 |
| 13563 | -デフォルトでは@command{makeinfo}はInfoファイルを出力します。 | |
| 13627 | +デフォルトでは、@command{makeinfo}はInfoファイルを出力します。 | |
| 13564 | 13628 | |
| 13565 | -各コマンドラインオプションは@samp{--}が前に付けられた単語か@samp{-}が前に付けられた文字です。 | |
| 13629 | +各コマンドラインオプションは、@samp{--}が前に付けられた単語か、@samp{-}が前に付けられた文字です。 | |
| 13566 | 13630 | 長いオプション名については、一意的である限りにおいて短かく省略可能です。 |
| 13567 | 13631 | |
| 13568 | -例えば、以下のシェルコマンドを使うと、@file{bison.texinfo}に対して、各行68カラムに追い込みが行なわれたInfoファイルを作成することが出来るでしょう。 | |
| 13632 | +例えば、以下のシェルコマンドを使うと、@file{bison.texinfo}に対して、各行68カラムに追い込みが行なわれたInfoファイルを作成できるでしょう。 | |
| 13569 | 13633 | |
| 13570 | 13634 | |
| 13571 | 13635 | @example |
| @@ -13581,7 +13645,7 @@ makeinfo --no-split --fill-column=70 @dots{} | ||
| 13581 | 13645 | |
| 13582 | 13646 | @noindent |
| 13583 | 13647 | このコマンドは、Infoファイルを分割せずに長い一つのファイルとして維持します。 |
| 13584 | -また追い込みを行なうカラムを70に設定します。 | |
| 13648 | +また、追い込みを行なうカラムを70に設定します。 | |
| 13585 | 13649 | |
| 13586 | 13650 | オプションは以下の通りです。 |
| 13587 | 13651 |
| @@ -13590,35 +13654,35 @@ makeinfo --no-split --fill-column=70 @dots{} | ||
| 13590 | 13654 | @item -D @var{var} |
| 13591 | 13655 | @opindex -D @var{var} |
| 13592 | 13656 | 変数@var{var}を定義します。 |
| 13593 | -これはTexinfoファイル内に@code{@@set @var{var}}コマンドを書いたのと同じです(@pxref{set clear value})。 | |
| 13657 | +これは、Texinfoファイル内に@code{@@set @var{var}}コマンドを書いたのと同じです(@pxref{set clear value})。 | |
| 13594 | 13658 | |
| 13595 | 13659 | @item --commands-in-node-names |
| 13596 | 13660 | @opindex --commands-in-node-names |
| 13597 | 13661 | ノード名で@code{@@}-コマンドを使えるようにします。 |
| 13598 | -恐らく@TeX{}に実装されることは決して無いでしょうから、これは推奨しません。 | |
| 13599 | -また、このオプションを使うと@code{makeinfo}の実行がかなり遅くなります。 | |
| 13662 | +恐らく、@TeX{}に実装されることは決して無いでしょうから、これは推奨しません。 | |
| 13663 | +また、このオプションを使うと、@code{makeinfo}の実行がかなり遅くなります。 | |
| 13600 | 13664 | さらに、オプション@samp{--no-validate}が使用されると、このオプションは無視されます。 |
| 13601 | -詳細は、@ref{Pointer Validation}を参照してください。 | |
| 13665 | +詳細は別の節を参照してください(@pxref{Pointer Validation})。 | |
| 13602 | 13666 | |
| 13603 | 13667 | @item --css-include=@var{file} |
| 13604 | 13668 | @opindex --css-include |
| 13605 | 13669 | @var{file}の内容をHTML出力の@samp{<style>}ブロックにインクルードします。 |
| 13606 | 13670 | このファイルにはカスケーディングスタイルシートの指定が入っています。 |
| 13607 | -@ref{HTML CSS}を参照してください。 | |
| 13671 | +別の節を参照してください(@pxref{HTML CSS})。 | |
| 13608 | 13672 | @var{file}が@samp{-}の場合、標準入力を読み込みます。 |
| 13609 | 13673 | |
| 13610 | 13674 | @item --css-ref=@var{url} |
| 13611 | 13675 | @opindex --css-ref |
| 13612 | 13676 | HTMLモードにおいて、@var{url}にあるカスケーディングスタイルシートを参照する@samp{<link>}タグをHTML出力に追加します。 |
| 13613 | -これによってスタンドアロンのスタイルシートが使えるようになります。 | |
| 13677 | +これによって、スタンドアロンのスタイルシートが使えるようになります。 | |
| 13614 | 13678 | |
| 13615 | 13679 | @item --disable-encoding |
| 13616 | 13680 | @itemx --enable-encoding |
| 13617 | 13681 | @opindex --disable-encoding |
| 13618 | 13682 | @opindex --enable-encoding |
| 13619 | -デフォルトの場合、もしくは@option{--enable-encoding}オプションを使用した場合、@samp{@@documentencoding}に基づいて、Infoやプレインテキスト出力の中にアクセント文字や特殊文字を出力します。 | |
| 13683 | +デフォルトの場合、もしくは、@option{--enable-encoding}オプションを使用した場合、@samp{@@documentencoding}に基づいて、Infoやプレインテキスト出力の中にアクセント文字や特殊文字を出力します。 | |
| 13620 | 13684 | @option{--disable-encoding}オプションを使うと、7ビットASCIIに置き換えたものが出力されます。 |
| 13621 | -@ref{documentencoding,,@code{documentencoding}}と@ref{Inserting Accents}を参照してください。 | |
| 13685 | +別の節も参照してください(@pxref{documentencoding,,@code{documentencoding}}, and @ref{Inserting Accents})。 | |
| 13622 | 13686 | |
| 13623 | 13687 | @item --docbook |
| 13624 | 13688 | @opindex --docbook |
| @@ -13627,7 +13691,7 @@ InfoではなくDocbookの出力を生成します。 | ||
| 13627 | 13691 | @item --document-language=@var{lang} |
| 13628 | 13692 | @opindex --document-language |
| 13629 | 13693 | @vindex LANG |
| 13630 | -@var{lang}を使って、出力ドキュメントに出力されることになるTexinfoのキーワードを翻訳します。 | |
| 13694 | +出力ドキュメントに出力されることになるTexinfoのキーワードを@var{lang}を使って翻訳します。 | |
| 13631 | 13695 | デフォルトは、@code{@@documentlanguage}コマンドがあれば、そのコマンドで指定されるロケールです(@pxref{documentlanguage})。 |
| 13632 | 13696 | |
| 13633 | 13697 | @item --error-limit=@var{limit} |
| @@ -13644,8 +13708,9 @@ InfoではなくDocbookの出力を生成します。 | ||
| 13644 | 13708 | @opindex -f @var{width} |
| 13645 | 13709 | 各行の最大カラム数を指定します。 |
| 13646 | 13710 | これが行の右端になります。 |
| 13647 | -追い込みが行なわれるパラグラフでは、この幅まで追い込みが行なわれます。 | |
| 13648 | -(追い込みとは、追い込みカラムとして指定された数値と同じか短かい長さになるように、行を分割したり連結したりする処理のことを言います。行が分割される場合は単語と単語の間で行なわれます。) | |
| 13711 | +追い込みが行なわれる段落では、この幅まで追い込みが行なわれます。 | |
| 13712 | +(追い込みとは、追い込みカラムとして指定された数値と同じか短かい長さになるように行を分割したり連結したりする処理のことを言います。 | |
| 13713 | +行が分割される場合は単語と単語の間で行なわれます。) | |
| 13649 | 13714 | デフォルト値は72です。 |
| 13650 | 13715 | @samp{--html}オプションが指定された場合は無視されます。 |
| 13651 | 13716 |
| @@ -13654,7 +13719,7 @@ InfoではなくDocbookの出力を生成します。 | ||
| 13654 | 13719 | @opindex --footnote-style=@var{style} |
| 13655 | 13720 | @opindex -s @var{style} |
| 13656 | 13721 | 脚注のスタイルを@var{style}に設定します。 |
| 13657 | -@var{style}は、endノードスタイルの@samp{end} (デフォルト)か、もしくはseparateノードスタイルの@samp{separate}のどちらかです。 | |
| 13722 | +@var{style}は、endノードスタイルの@samp{end} (デフォルト)か、もしくは、separateノードスタイルの@samp{separate}のどちらかです。 | |
| 13658 | 13723 | このオプションで設定された値は、Texinfoファイル中の@code{@@footnotestyle}コマンドで設定された値をオーバーライドします(@pxref{Footnotes})。 |
| 13659 | 13724 | 脚注スタイルが@samp{separate}の場合、@code{makeinfo}は現在のノードにある脚注を入れる新しいノードを作成します。 |
| 13660 | 13725 | 脚注スタイルが@samp{end}の場合、@code{makeinfo}は脚注の参照事項を現在のノードの末尾に配置します。 |
| @@ -13665,7 +13730,7 @@ InfoではなくDocbookの出力を生成します。 | ||
| 13665 | 13730 | @opindex --force |
| 13666 | 13731 | @opindex -F |
| 13667 | 13732 | 通常、入力ファイルがエラーとなった場合には出力ファイルは作成されません。 |
| 13668 | -このオプションを使うと出力ファイルが残されます。 | |
| 13733 | +このオプションを使うと、出力ファイルが残されます。 | |
| 13669 | 13734 | |
| 13670 | 13735 | @item --help |
| 13671 | 13736 | @itemx -h |
| @@ -13677,15 +13742,15 @@ InfoではなくDocbookの出力を生成します。 | ||
| 13677 | 13742 | @opindex --html |
| 13678 | 13743 | InfoではなくHTML出力を生成します。 |
| 13679 | 13744 | @xref{Generating HTML}. |
| 13680 | -デフォルトでは、HTML出力は、Texinfoソースのノードごとに一つの出力ファイルとなるように分割されます。 | |
| 13681 | -分割された出力ファイルはトップレベルのinfoファイル名を持つサブディレクトリへ書き出されます。 | |
| 13745 | +デフォルトでは、Texinfoソースのノードごとに一つの出力ファイルとなるようにHTML出力が分割されます。 | |
| 13746 | +分割された出力ファイルは、トップレベルのinfoファイル名を持つサブディレクトリへ書き出されます。 | |
| 13682 | 13747 | |
| 13683 | 13748 | @item -I @var{dir} |
| 13684 | 13749 | @opindex -I @var{dir} |
| 13685 | 13750 | @code{@@include}コマンドを使ってインクルードされるファイルを探すのに使われるディレクトリの検索リストに@var{dir}ディレクトリを追加します。 |
| 13686 | 13751 | デフォルトでは、@code{makeinfo}はカレントディレクトリだけを探索します。 |
| 13687 | 13752 | @var{dir}が指定されなかった場合、カレントディレクトリ@file{.}が追加されます。 |
| 13688 | -@var{dir}は実際には、通常のパス区切り文字(Unixでは@samp{:}、MS-DOS/MS-Windowsでは@samp{;})で区切られた複数ディレクトリのリストを記述することが出来ます。 | |
| 13753 | +@var{dir}は、実際には、通常のパス区切り文字(Unixでは@samp{:}、MS-DOS/MS-Windowsでは@samp{;})で区切られた複数ディレクトリのリストを記述することが出来ます。 | |
| 13689 | 13754 | |
| 13690 | 13755 | @item --ifdocbook |
| 13691 | 13756 | @opindex --ifdocbook |
| @@ -13700,20 +13765,20 @@ InfoではなくHTML出力を生成します。 | ||
| 13700 | 13765 | @itemx --ifxml |
| 13701 | 13766 | @opindex --ifxml |
| 13702 | 13767 | 指定された書式に対して、@samp{@@if@var{format}}コマンドと@samp{@@@var{format}}コマンドを処理します。 |
| 13703 | -これはこの指定された書式の出力生成されない場合でも処理されます。 | |
| 13768 | +指定された書式の出力が生成されない場合でも、これは処理されます。 | |
| 13704 | 13769 | 例えば、@option{--iftex}オプションが指定された場合、@samp{@@iftex}のブロックと@samp{@@tex}のブロックが読み込まれます。 |
| 13705 | 13770 | |
| 13706 | 13771 | @item --internal-links=@var{file} |
| 13707 | 13772 | @opindex --internal-links=@var{file} |
| 13708 | 13773 | HTMLモードにおいて、三つのカラムを持つタブ区切りファイルを出力します。 |
| 13709 | -三つのカラムは、索引化されている項目もしくは目次にある項目に対する内部リンク、それがある索引の名前(もしくは"toc")、索引化される、あるいは入力される用語です。 | |
| 13774 | +三つのカラムは、索引化されている項目、もしくは、目次にある項目に対する内部リンク、それがある索引の名前(もしくは"toc")、索引化される、あるいは、入力される用語の三つです。 | |
| 13710 | 13775 | |
| 13711 | 13776 | @item --macro-expand=@var{file} |
| 13712 | 13777 | @itemx -E @var{file} |
| 13713 | 13778 | @opindex --macro-expand=@var{file} |
| 13714 | 13779 | @opindex -E @var{file} |
| 13715 | 13780 | Texinfoのソースのマクロを全て展開して指定ファイルへ出力します。 |
| 13716 | -通常、マクロ展開の結果は@code{makeinfo}が内部的に使用した後破棄されます。 | |
| 13781 | +通常、@code{makeinfo}が内部的に使用した後、マクロ展開の結果は破棄されます。 | |
| 13717 | 13782 | このオプションは@command{texi2dvi}で使用します。 |
| 13718 | 13783 | |
| 13719 | 13784 | @item --no-headers |
| @@ -13727,7 +13792,7 @@ Texinfoのソースのマクロを全て展開して指定ファイルへ出力 | ||
| 13727 | 13792 | @cindex Node separators, omitting |
| 13728 | 13793 | @cindex Menus, omitting |
| 13729 | 13794 | 出力中にメニューやノードセパレータ行を含めません。 |
| 13730 | -また@option{--enable-encoding} (前述)を暗黙のうちに指定したものとします。 | |
| 13795 | +また、@option{--enable-encoding} (前述)を暗黙のうちに指定したものとします。 | |
| 13731 | 13796 | これを使うと、(例えば)複雑な操作をせずemailに入れて送れたり、(@file{INSTALL}ファイルのように)配布物に含められるような単純なプレインテキストを生成します。 |
| 13732 | 13797 | |
| 13733 | 13798 | @cindex Navigation links, omitting |
| @@ -13735,7 +13800,7 @@ HTML出力でも同様にメニューを省略します。 | ||
| 13735 | 13800 | @samp{--no-split}も指定された場合、各ノードの上部にナビゲーションリンクを含めません(ナビゲーションリンクはデフォルトの分割出力では決して含まれません)。 |
| 13736 | 13801 | @xref{Generating HTML}. |
| 13737 | 13802 | |
| 13738 | -両者の場合とも、@code{@@setfilename}が無視され、デフォルトで標準出力へ書き出されますが、@option{-o}オプションを使って出力先をオーバーライドすることが可能です。 | |
| 13803 | +両者の場合とも@code{@@setfilename}が無視され、デフォルトで標準出力へ書き出されますが、@option{-o}オプションを使って出力先をオーバーライドすることが可能です。 | |
| 13739 | 13804 | |
| 13740 | 13805 | @item --no-ifdocbook |
| 13741 | 13806 | @opindex --no-ifdocbook |
| @@ -13751,7 +13816,7 @@ HTML出力でも同様にメニューを省略します。 | ||
| 13751 | 13816 | @opindex --no-ifxml |
| 13752 | 13817 | @samp{@@if@var{format}}コマンドと@samp{@@@var{format}}コマンドを処理しません。 |
| 13753 | 13818 | @samp{@@ifnot@var{format}}コマンドは処理します。 |
| 13754 | -これらは指定された書式で出力が生成されなくても行なわれます。 | |
| 13819 | +これらは、指定された書式で出力が生成されなくても行なわれます。 | |
| 13755 | 13820 | 例えば、@option{--no-ifhtml}オプションが指定された場合、@samp{@@ifhtml}ブロックと@samp{@@html}ブロックは読み込まれず、@samp{@@ifnothtml}ブロックは読み込まれます。 |
| 13756 | 13821 | |
| 13757 | 13822 | @item --no-number-footnotes |
| @@ -13762,15 +13827,15 @@ HTML出力でも同様にメニューを省略します。 | ||
| 13762 | 13827 | |
| 13763 | 13828 | @item --no-number-sections |
| 13764 | 13829 | @opindex --no-number-sections |
| 13765 | -章やセクション、appendixの番号を出力しません。 | |
| 13766 | -マニュアルが階層構造をしていない場合にこのオプションを指定する必要があります。 | |
| 13830 | +章、セクション、appendixの番号を出力しません。 | |
| 13831 | +マニュアルが階層構造をしていない場合、このオプションを指定する必要があります。 | |
| 13767 | 13832 | |
| 13768 | 13833 | @item --no-split |
| 13769 | 13834 | @opindex --no-split |
| 13770 | 13835 | @cindex Splitting of output files |
| 13771 | 13836 | @cindex Output file splitting |
| 13772 | 13837 | @code{makeinfo}の分割処理ステージを実行しません。 |
| 13773 | -デフォルトでは、巨大な出力ファイル(70kバイトを超えるサイズ)は、小さいサブファイルに分割されます。 | |
| 13838 | +デフォルトでは、巨大な出力ファイル(70kバイトを超えるサイズ)は小さいサブファイルに分割されます。 | |
| 13774 | 13839 | Info出力では、それぞれ大体50kバイトほどになります。 |
| 13775 | 13840 | HTML出力では、各ファイルに一つのノードが入るようになります(@pxref{Generating HTML})。 |
| 13776 | 13841 |
| @@ -13782,7 +13847,7 @@ HTML出力では、各ファイルに一つのノードが入るようになり | ||
| 13782 | 13847 | @code{makeinfo}のポインタを検証するフェーズを実行しません。 |
| 13783 | 13848 | これを実行するのは危険が伴います。 |
| 13784 | 13849 | @code{@@novalidate}コマンドを使っても同じことが出来ます(@pxref{Use TeX,,Use @TeX{}})。 |
| 13785 | -通常、Texinfoファイルの処理後、整合性検査によって、クロスリファレンスが解決できるかなどの確認が行なわれます。 | |
| 13850 | +通常、Texinfoファイルの処理後、クロスリファレンスが解決できるかなどの確認が、整合性検査によって行なわれます。 | |
| 13786 | 13851 | @xref{Pointer Validation}. |
| 13787 | 13852 | |
| 13788 | 13853 | @item --no-warn |
| @@ -13791,9 +13856,9 @@ HTML出力では、各ファイルに一つのノードが入るようになり | ||
| 13791 | 13856 | |
| 13792 | 13857 | @item --number-sections |
| 13793 | 13858 | @opindex --number-sections |
| 13794 | -印刷されたマニュアルのように、章、セクション、appendixの番号が出力されます。 | |
| 13859 | +印刷マニュアルのように、章、セクション、appendixの番号が出力されます。 | |
| 13795 | 13860 | これがデフォルトです。 |
| 13796 | -これは階層構造を持つマニュアルでだけ機能します。 | |
| 13861 | +これは、階層構造を持つマニュアルでだけ機能します。 | |
| 13797 | 13862 | |
| 13798 | 13863 | @item --output=@var{file} |
| 13799 | 13864 | @itemx -o @var{file} |
| @@ -13801,32 +13866,33 @@ HTML出力では、各ファイルに一つのノードが入るようになり | ||
| 13801 | 13866 | @opindex -o @var{file} |
| 13802 | 13867 | 出力を@var{file}ファイルへ向けるよう指示します。 |
| 13803 | 13868 | Texinfoソースに書かれた@code{@@setfilename}コマンドで指定されているファイルへは出力されません。 |
| 13804 | -@var{file}が@samp{-}の場合、出力は標準出力へ書き出され、その際@samp{--no-split}が指定されたものと仮定します。 | |
| 13805 | -分割HTML出力では@var{file}はディレクトリ名で、その中にHTMLで出力される各ノードが全て出力されます(@pxref{Generating HTML})。 | |
| 13869 | +@var{file}が@samp{-}の場合、出力は標準出力へ書き出され、その際、@samp{--no-split}が指定されたものと仮定します。 | |
| 13870 | +分割HTML出力では@var{file}はディレクトリ名です。 | |
| 13871 | +その中に、HTMLで出力される各ノードが全て出力されます(@pxref{Generating HTML})。 | |
| 13806 | 13872 | |
| 13807 | 13873 | @item -P @var{dir} |
| 13808 | 13874 | @opindex -P @var{dir} |
| 13809 | 13875 | @code{@@include}コマンドで使われるディレクトリの検索リストの一番前に@var{dir}を追加します。 |
| 13810 | 13876 | @var{dir}が指定されなかった場合は、カレントディレクトリ@file{.}が一番前に追加されます。 |
| 13811 | -詳細は@samp{-I}オプションの項を参照してください。 | |
| 13877 | +詳細は、@samp{-I}オプションの項を参照してください。 | |
| 13812 | 13878 | |
| 13813 | 13879 | @item --paragraph-indent=@var{indent} |
| 13814 | 13880 | @itemx -p @var{indent} |
| 13815 | 13881 | @opindex --paragraph-indent=@var{indent} |
| 13816 | 13882 | @opindex -p @var{indent} |
| 13817 | -パラグラフの字下げスタイルを@var{indent}に設定します。 | |
| 13883 | +段落の字下げスタイルを@var{indent}に設定します。 | |
| 13818 | 13884 | このオプションで設定される値は、Texinfoファイルの中で@code{@@paragraphindent}コマンドを使って設定される値をオーバーライドします(@pxref{paragraphindent})。 |
| 13819 | 13885 | @var{indent}の値は以下のように解釈されます。 |
| 13820 | 13886 | |
| 13821 | 13887 | @table @asis |
| 13822 | 13888 | @item @samp{asis} |
| 13823 | -パラグラフの開始位置で既に存在する字下げを保持します。 | |
| 13889 | +段落の開始位置で既に存在する字下げを保持します。 | |
| 13824 | 13890 | |
| 13825 | 13891 | @item @samp{0} or @samp{none} |
| 13826 | 13892 | 既存の字下げを全て除去します。 |
| 13827 | 13893 | |
| 13828 | 13894 | @item @var{num} |
| 13829 | -@var{num}個のスペースで各パラグラフを字下げします。 | |
| 13895 | +@var{num}個のスペースで各段落を字下げします。 | |
| 13830 | 13896 | @end table |
| 13831 | 13897 | |
| 13832 | 13898 | @item --split-size=@var{num} |
| @@ -13845,7 +13911,7 @@ Texinfoファイルに記述する@code{@@clear @var{var}}コマンドと同じ | ||
| 13845 | 13911 | |
| 13846 | 13912 | @item --verbose |
| 13847 | 13913 | @opindex --verbose |
| 13848 | -@code{makeinfo}に実行中の内容を示すメッセージを表示させます。 | |
| 13914 | +実行中の内容を示すメッセージを@code{makeinfo}に表示させます。 | |
| 13849 | 13915 | 通常、@code{makeinfo}はエラーや警告が発生した場合にだけメッセージを出力します。 |
| 13850 | 13916 | |
| 13851 | 13917 | @item --version |
| @@ -13862,7 +13928,7 @@ InfoではなくXMLの出力を生成します。 | ||
| 13862 | 13928 | |
| 13863 | 13929 | @vindex TEXINFO_OUTPUT_FORMAT |
| 13864 | 13930 | @cindex Environment variable @code{TEXINFO_OUTPUT_FORMAT} |
| 13865 | -また、@command{makeinfo}は、@env{TEXINFO_OUTPUT_FORMAT}という環境変数を読み込んで、出力書式を決定します。 | |
| 13931 | +また、@command{makeinfo}は、@env{TEXINFO_OUTPUT_FORMAT}という環境変数を読み込んで出力書式を決定します。 | |
| 13866 | 13932 | 但し、コマンドラインオプションの指定が優先します。 |
| 13867 | 13933 | 取り得る値は以下の通りです。 |
| 13868 | 13934 |
| @@ -13878,29 +13944,29 @@ docbook html info plaintext xml | ||
| 13878 | 13944 | @cindex Pointer validation with @code{makeinfo} |
| 13879 | 13945 | @cindex Validation of pointers |
| 13880 | 13946 | |
| 13881 | -@samp{--no-validate}オプションや、ソースファイル中に@code{@@novalidate}コマンドを記述してポインタの検証機能を抑制していない場合(@pxref{Use TeX,,Use @TeX{}})、@code{makeinfo}は最終的なInfoファイルの妥当性を検証します。 | |
| 13882 | -主に、参照されているノードが実際に存在するかどうかを確認するということを意味します。 | |
| 13947 | +@samp{--no-validate}オプションやソースファイル中に@code{@@novalidate}コマンドを記述してポインタの検証機能を抑制していない場合(@pxref{Use TeX,,Use @TeX{}})、@code{makeinfo}は最終的なInfoファイルの妥当性を検証します。 | |
| 13948 | +参照されているノードが実際に存在するかどうかを確認するということを主に意味します。 | |
| 13883 | 13949 | 以下に検証される事柄を全て示します。 |
| 13884 | 13950 | |
| 13885 | 13951 | @enumerate |
| 13886 | 13952 | @item |
| 13887 | -「Next」ノードの参照、「Previous」ノードの参照、「Up」ノードの参照が、現在のファイルへの参照になっていて、@file{(dir)}のような外部参照ではない場合、その被参照ノードが存在していなければなりません。@refill | |
| 13953 | +Nextノードの参照、Previousノードの参照、Upノードの参照が現在のファイルへの参照になっていて、@file{(dir)}のような外部参照ではない場合、その被参照ノードが存在していなければなりません。@refill | |
| 13888 | 13954 | |
| 13889 | 13955 | @item |
| 13890 | -全てのノードにおいて、「Previous」ノードが「Up」ノードと異なっている場合、「Previous」フィールドで参照されているノードの「Next」フィールドが、元のノードを逆に参照していなければなりません。@refill | |
| 13956 | +全てのノードにおいてPreviousノードがUpノードと異なっている場合、Previousフィールドで参照されているノードのNextフィールドが元のノードを逆に参照していなければなりません。@refill | |
| 13891 | 13957 | |
| 13892 | 13958 | @item |
| 13893 | -「Top」ノード以外の全てのノードには「Up」ポインタが無ければなりません。@refill | |
| 13959 | +Topノード以外の全てのノードにはUpポインタが無ければなりません。@refill | |
| 13894 | 13960 | |
| 13895 | 13961 | @item |
| 13896 | -「Up」ポインタで参照されるノードが「(@var{file})」という書式でない場合、「Up」ノード自体はメニュー項目を通して現在ノードを参照していなければなりません。 | |
| 13962 | +Upポインタで参照されるノードが「(@var{file})」という書式でない場合、Upノード自体はメニュー項目を通して現在ノードを参照していなければなりません。 | |
| 13897 | 13963 | |
| 13898 | 13964 | @item |
| 13899 | -あるノードの「Next」参照が、「Up」参照のノードの「Next」参照と同じでない場合、「Next」ポインタで参照されるノードは現在のノードを逆に参照する「Previous」ポインタを持っていなければなりません。 | |
| 13965 | +あるノードのNext参照が、Up参照のノードのNext参照と同じでない場合、Nextポインタで参照されるノードは、現在のノードを逆に参照するPreviousポインタを持っていなければなりません。 | |
| 13900 | 13966 | このルールによって、あるセクションの最後のノードが次の章の最初のノードを指し示すことが出来るようになります。@refill |
| 13901 | 13967 | |
| 13902 | 13968 | @item |
| 13903 | -「Top」ノードを除く全てのノードは、「Previous」「Next」のリンクか、メニュー、もしくはクロスリファレンスを経由して、少なくとも一つ、別のノードから参照されていなければなりません。@refill | |
| 13969 | +Topノードを除く全てのノードは、「Previous」「Next」のリンクか、メニュー、クロスリファレンスを経由して、少なくとも一つ別のノードから参照されていなければなりません。@refill | |
| 13904 | 13970 | @end enumerate |
| 13905 | 13971 | |
| 13906 | 13972 | @cindex @@-commands in @@node, limited support |
| @@ -13923,22 +13989,22 @@ This is node 2. | ||
| 13923 | 13989 | @end example |
| 13924 | 13990 | |
| 13925 | 13991 | @noindent |
| 13926 | -ここでは「Node 1」の直接参照と@code{@@value}経由での参照が両方行なわれています。 | |
| 13992 | +ここでは、「Node 1」の直接参照と@code{@@value}経由での参照が両方行なわれています。 | |
| 13927 | 13993 | @code{@@value}. |
| 13928 | 13994 | |
| 13929 | -デフォルトでは、@code{makeinfo}プログラムはそういった場合に失敗するようになっています。 | |
| 13995 | +デフォルトでは、そういった場合、@code{makeinfo}プログラムは失敗するようになっています。 | |
| 13930 | 13996 | これは、ノード名が出力ファイルに書き出されるまで完全には展開されないからです。 |
| 13931 | -ノードを参照する場合は必ず一貫性を持たせるべきです。 | |
| 13997 | +ノードを参照する場合は一貫性を必ず持たせるべきです。 | |
| 13932 | 13998 | 例えば、上述の例であれば、2番目の@code{@@node}行でも@code{@@value}を使うべきでした。 |
| 13933 | -しかし、何らかの理由によって、一貫性なくノード名を@emph{参照しなければならず}、@code{makeinfo}がファイルの検証に失敗するような場合、@samp{--commands-in-node-names}オプションを使って、@code{makeinfo}に、手間をかけてドキュメントに現われるノード名を全て展開するよう強制することが出来ます。 | |
| 13934 | -しかし、これによってプログラムはかなり遅くなるかもしれません。 | |
| 13999 | +しかし、何らかの理由によって、一貫性なくノード名を@emph{参照しなければならず}、@code{makeinfo}がファイルの検証に失敗するような場合、手間をかけてドキュメントに現われるノード名を全て展開するよう、@samp{--commands-in-node-names}オプションを使って、@code{makeinfo}に強制することが出来ます。 | |
| 14000 | +しかし、これによって、プログラムはかなり遅くなるかもしれません。 | |
| 13935 | 14001 | Jargonファイルのような巨大なドキュメントの場合、変換時間の倍増が計測されました。 |
| 13936 | 14002 | |
| 13937 | 14003 | @cindex @@value in @@node lines |
| 13938 | 14004 | @code{@@node}ディレクティブでの@code{@@}-コマンドのサポートは、自由に利用するには十分一般的とは言えません。 |
| 13939 | 14005 | 例えば、上述の例において、ドキュメントのどこかで@code{nodename}を再定義した場合、@samp{--commands-in-node-names}オプションを使って起動しても、@code{makeinfo}はドキュメントを変換できないでしょう。 |
| 13940 | 14006 | |
| 13941 | -@samp{--commands-in-node-names}オプションは@samp{--no-validate}オプションが指定された場合、効果を持ちません。 | |
| 14007 | +@samp{--commands-in-node-names}オプションは、@samp{--no-validate}オプションが指定された場合、効果を持ちません。 | |
| 13942 | 14008 | |
| 13943 | 14009 | |
| 13944 | 14010 | @node makeinfo in Emacs |
| @@ -13947,8 +14013,8 @@ Jargonファイルのような巨大なドキュメントの場合、変換時 | ||
| 13947 | 14013 | @cindex @code{makeinfo} inside Emacs |
| 13948 | 14014 | @cindex Shell, running @code{makeinfo} in |
| 13949 | 14015 | |
| 13950 | -GNU EmacsのTexinfoモード上で@code{makeinfo-region}コマンドもしくは@code{makeinfo-buffer}コマンドのどちらかを使うと、@code{makeinfo}プログラムを実行することが出来ます。 | |
| 13951 | -Texinfoモードでは、これらのコマンドはデフォルトで、@kbd{C-c C-m C-r}と@kbd{C-c C-m C-b}にバインドされています。@refill | |
| 14016 | +GNU EmacsのTexinfoモード上で@code{makeinfo-region}コマンド、もしくは、@code{makeinfo-buffer}コマンドのどちらかを使うと、@code{makeinfo}プログラムを実行することが出来ます。 | |
| 14017 | +Texinfoモードでは、これらのコマンドは、@kbd{C-c C-m C-r}と@kbd{C-c C-m C-b}にデフォルトでバインドされています。@refill | |
| 13952 | 14018 | |
| 13953 | 14019 | @table @kbd |
| 13954 | 14020 | @item C-c C-m C-r |
| @@ -13962,18 +14028,18 @@ Texinfoモードでは、これらのコマンドはデフォルトで、@kbd{C- | ||
| 13962 | 14028 | @findex makeinfo-buffer |
| 13963 | 14029 | @end table |
| 13964 | 14030 | |
| 13965 | -@code{makeinfo-region}を実行すると、その出力は一時的なバッファへ送られます。 | |
| 13966 | -@code{makeinfo-buffer}を実行すると、その出力は@code{@@setfilename}コマンドで設定されているファイルへ出力されます(@pxref{setfilename})。 | |
| 14031 | +@code{makeinfo-region}を実行すると、その出力は、一時的なバッファへ送られます。 | |
| 14032 | +@code{makeinfo-buffer}を実行すると、その出力は、@code{@@setfilename}コマンドで設定されているファイルへ出力されます(@pxref{setfilename})。 | |
| 13967 | 14033 | |
| 13968 | 14034 | Emacsの@code{makeinfo-region}コマンドと@code{makeinfo-buffer}コマンドは、一時的なシェルバッファの中で@code{makeinfo}プログラムを実行します。 |
| 13969 | -@code{makeinfo}が何らかのエラーを検出した場合、Emacsはその一時バッファの中にそのエラーメッセージを表示します。@refill | |
| 14035 | +@code{makeinfo}が何らかのエラーを検出した場合、Emacsは、その一時バッファの中にエラーメッセージを表示します。@refill | |
| 13970 | 14036 | |
| 13971 | 14037 | @cindex Errors, parsing |
| 13972 | 14038 | @cindex Parsing errors |
| 13973 | 14039 | @findex next-error |
| 13974 | 14040 | @kbd{C-x `}を入力することでエラーメッセージを解析できます(@code{next-error})。 |
| 13975 | -これによってEmacsは、@code{makeinfo}がエラーが発生したと認識しているTexinfoのソース行へカーソルを移動させます。 | |
| 13976 | -@code{next-error}コマンドの使用に関して詳しくは、@ref{Compilation, , Running @code{make} or Compilers Generally, emacs, The GNU Emacs Manual}を参照してください。@refill | |
| 14041 | +これによって、Emacsは、@code{makeinfo}がエラーが発生したと認識しているTexinfoのソース行へカーソルを移動させます。 | |
| 14042 | +@code{next-error}コマンドの使用に関して詳しくは別マニュアルを参照してください(@pxref{Compilation, , Running @code{make} or Compilers Generally, emacs, The GNU Emacs Manual})。@refill | |
| 13977 | 14043 | |
| 13978 | 14044 | 加えて、@code{makeinfo}コマンドが実行されているシェルをキルすることが出来ます。 |
| 13979 | 14045 | また、シェルバッファを最新の出力を表示させることが出来ます。@refill |
| @@ -13991,10 +14057,10 @@ Emacsの@code{makeinfo-region}コマンドと@code{makeinfo-buffer}コマンド | ||
| 13991 | 14057 | @end table |
| 13992 | 14058 | |
| 13993 | 14059 | @noindent |
| 13994 | -(@TeX{}のジョブについてキルしたり、リセンタリングしたりすることに対応するコマンドが@kbd{C-c C-t C-k}や@kbd{C-c C-t C-l}ですので注意してください。 | |
| 14060 | +(@TeX{}のジョブについてキルしたり、リセンタリングしたりすることに対応するコマンドは@kbd{C-c C-t C-k}や@kbd{C-c C-t C-l}ですので注意してください。 | |
| 13995 | 14061 | @xref{Texinfo Mode Printing}.)@refill |
| 13996 | 14062 | |
| 13997 | -@code{makeinfo-options}という変数を、@kbd{M-x customize}や@kbd{M-x set-variable}コマンドのどちらかを使うか、もしくは、@file{.emacs}初期化ファイルを使って設定することで、@code{makeinfo}プログラムに対するオプションを指定することが出来ます。 | |
| 14063 | +@kbd{M-x customize}や@kbd{M-x set-variable}コマンドのどちらかを使うか、もしくは、@file{.emacs}初期化ファイルを使って@code{makeinfo-options}という変数を設定することで、@code{makeinfo}プログラムに対するオプションを指定することが出来ます。 | |
| 13998 | 14064 | |
| 13999 | 14065 | 例えば、@file{.emacs}ファイルに次のように記述することが可能です。@refill |
| 14000 | 14066 |
| @@ -14010,10 +14076,11 @@ Emacsの@code{makeinfo-region}コマンドと@code{makeinfo-buffer}コマンド | ||
| 14010 | 14076 | @c If you write these three cross references using xref, you see |
| 14011 | 14077 | @c three references to the same named manual, which looks strange. |
| 14012 | 14078 | @iftex |
| 14013 | -詳細は、@ref{makeinfo options, , Options for @code{makeinfo}}と、@cite{The GNU Emacs Manual}の「Easy Customization Interface」「Examining and Setting Variables」「Init File」を見てください。 | |
| 14079 | +詳細は別の節を参照してください(@pxref{makeinfo options, , Options for @code{makeinfo}})。 | |
| 14080 | +また、@cite{The GNU Emacs Manual}の「Easy Customization Interface」「Examining and Setting Variables」「Init File」も見てください。 | |
| 14014 | 14081 | @end iftex |
| 14015 | 14082 | @ifnottex |
| 14016 | -詳細は、以下を参照してください。@* | |
| 14083 | +詳細は以下を参照してください。@* | |
| 14017 | 14084 | @ref{Easy Customization, , Easy Customization Interface, emacs, The GNU Emacs Manual}@* |
| 14018 | 14085 | @ref{Examining, , Examining and Setting Variables, emacs, The GNU Emacs Manual}@* |
| 14019 | 14086 | @ref{Init File, , , emacs, The GNU Emacs Manual}@* |
| @@ -14026,8 +14093,8 @@ Emacsの@code{makeinfo-region}コマンドと@code{makeinfo-buffer}コマンド | ||
| 14026 | 14093 | GNU EmacsのTexinfoモードでは、@code{texinfo-format-region}コマンドを使ってTexinfoファイルの一部または全体を書式化することが出来ます。 |
| 14027 | 14094 | このコマンドは現在のリージョンを書式化し、整形されたテキストを@samp{*Info Region*}という一時的なバッファに表示します。@refill |
| 14028 | 14095 | |
| 14029 | -同様に、@code{texinfo-format-buffer}コマンドを使うとバッファを書式化することが出来ます。 | |
| 14030 | -このコマンドは新しいバッファを作って、その中にInfoファイルを生成します。 | |
| 14096 | +同様に、@code{texinfo-format-buffer}コマンドを使うと、バッファを書式化することが出来ます。 | |
| 14097 | +このコマンドは、新しいバッファを作って、その中にInfoファイルを生成します。 | |
| 14031 | 14098 | @kbd{C-x C-s}を入力すると、@code{@@setfilename}コマンドで指定されている名前のInfoファイルが保存されます。 |
| 14032 | 14099 | @code{@@setfilename}コマンドは、Texinfoファイルの冒頭付近になければなりません。@refill |
| 14033 | 14100 |
| @@ -14044,9 +14111,9 @@ GNU EmacsのTexinfoモードでは、@code{texinfo-format-region}コマンドを | ||
| 14044 | 14111 | @end table |
| 14045 | 14112 | |
| 14046 | 14113 | @code{texinfo-format-region}コマンドと@code{texinfo-format-buffer}コマンドは、多少のエラーチェック機能を用意しています。 |
| 14047 | -また、他の関数では、書式化時のエラーの発見をさらに支援します。 | |
| 14114 | +また、他の関数によって、書式化時のエラーの発見をさらに支援します。 | |
| 14048 | 14115 | これらの方法についてはappendixで説明します。 |
| 14049 | -@ref{Catching Mistakes}を参照してください。 | |
| 14116 | +別の節を参照してください(@pxref{Catching Mistakes})。 | |
| 14050 | 14117 | ただし、@code{makeinfo}プログラムは比較的高速な場合が多く、より良いエラーチェック機能を備えています(@pxref{makeinfo in Emacs})。@refill |
| 14051 | 14118 | |
| 14052 | 14119 | @node Batch Formatting |
| @@ -14056,9 +14123,9 @@ GNU EmacsのTexinfoモードでは、@code{texinfo-format-region}コマンドを | ||
| 14056 | 14123 | @cindex Info batch formatting |
| 14057 | 14124 | |
| 14058 | 14125 | @code{batch-texinfo-format}とEmacsのBatchモードを使ってTexinfoファイルを書式化することが出来ます。 |
| 14059 | -どのようなシェルからでもEmacsをBatchモードで実行することが出来ます。 | |
| 14126 | +どのようなシェルからでも、EmacsをBatchモードで実行することが出来ます。 | |
| 14060 | 14127 | もちろんEmacs内のシェルでも可能です。 |
| 14061 | -(@xref{Command Arguments,,, emacs, The GNU Emacs Manual}.) | |
| 14128 | +@xref{Command Arguments,,, emacs, The GNU Emacs Manual}. | |
| 14062 | 14129 | |
| 14063 | 14130 | 以下は、カレントディレクトリのファイル名が@file{.texinfo}で終わるファイルを全て書式化するシェルコマンドです。 |
| 14064 | 14131 |
| @@ -14067,16 +14134,15 @@ emacs -batch -funcall batch-texinfo-format *.texinfo | ||
| 14067 | 14134 | @end example |
| 14068 | 14135 | |
| 14069 | 14136 | @noindent |
| 14070 | -Emacsはコマンドライン上に指定されたファイルを、処理中にエラーが発生するものがあったとしても全て処理します。@refill | |
| 14137 | +Emacsは、処理中にエラーが発生するものがあったとしても、コマンドライン上に指定されたファイルを全て処理します。@refill | |
| 14071 | 14138 | |
| 14072 | 14139 | 上記の通り、@code{batch-texinfo-format}コマンドはBatchモードのEmacsでだけ実行するようにしてください。 |
| 14073 | 14140 | このコマンドは対話的コマンドではありません。 |
| 14074 | -処理が完了するとBatchモードのEmacsはキルされます。@refill | |
| 14141 | +処理が完了すると、BatchモードのEmacsはキルされます。@refill | |
| 14075 | 14142 | |
| 14076 | -@code{batch-texinfo-format}コマンドは、@code{makeinfo}プログラムが無い状態で、複数のTexinfoファイルを一度に書式化したい場合に便利です。 | |
| 14143 | +@code{makeinfo}プログラムが無い状態で複数のTexinfoファイルを一度に書式化したい場合、@code{batch-texinfo-format}コマンドは便利です。 | |
| 14077 | 14144 | Batchモードを使う際は別のEmacsプロセスが作られます。 |
| 14078 | -こうすることで現在使用しているEmacsが自由になりますので、そこで作業を継続することが可能です。 | |
| 14079 | -(@code{texinfo-format-region}コマンドや@code{texinfo-format-buffer}コマンドを実行する場合は、そのコマンドが終了するまで他のことにそのEmacsを使うことは出来ません。)@refill | |
| 14145 | +こうすることで、現在使用しているEmacsが自由になりますので、そこで作業を継続することが可能です(@code{texinfo-format-region}コマンドや@code{texinfo-format-buffer}コマンドを実行する場合は、そのコマンドが終了するまで、他のことにそのEmacsを使うことは出来ません)。@refill | |
| 14080 | 14146 | |
| 14081 | 14147 | @node Tag and Split Files |
| 14082 | 14148 | @comment node-name, next, previous, up |
| @@ -14084,17 +14150,17 @@ Batchモードを使う際は別のEmacsプロセスが作られます。 | ||
| 14084 | 14150 | @cindex Making a tag table automatically |
| 14085 | 14151 | @cindex Tag table, making automatically |
| 14086 | 14152 | |
| 14087 | -Texinfoファイルが30,000バイトを超える場合、@code{texinfo-format-buffer}コマンドは対応するInfoファイルに対するタグテーブルを自動的に作成します。 | |
| 14153 | +Texinfoファイルが30,000バイトを超える場合、@code{texinfo-format-buffer}コマンドは、対応するInfoファイルに対するタグテーブルを自動的に作成します。 | |
| 14088 | 14154 | @code{makeinfo}プログラムは必ずタグテーブルを作成します。 |
| 14089 | -@dfn{タグテーブル}を使うと、使わない場合に比べてInfoは別のノードへ素早くジャンプすることが出来るようになります。@refill | |
| 14155 | +@dfn{タグテーブル}を使うと、使わない場合に比べて、Infoは、別のノードへ素早くジャンプすることが出来るようになります。@refill | |
| 14090 | 14156 | |
| 14091 | 14157 | @cindex Indirect subfiles |
| 14092 | 14158 | さらに、Texinfoファイルが300,000バイトを超える場合、@code{texinfo-format-buffer}コマンドや@code{makeinfo}プログラムは、その大きなInfoファイルを、もう少し小さなおよそ300,000バイトごとの@dfn{二次的な}サブファイルへと分割します。 |
| 14093 | 14159 | 大きなファイルがより小さなファイルへ分割されますので、大きなInfoファイル全体を保持する大きなバッファをEmacsが作成する必要が無くなります。 |
| 14094 | -代わりにEmacsは、その時点で必要とされる分割された小さなファイルに十分なメモリだけを割り当てます。 | |
| 14095 | -こうすることで、EmacsはInfoを実行する際にメモリに無駄が出るのを避けます。 | |
| 14096 | -(分割機能が実装される前は、Infoファイルは必ず短かく維持され、そういう小さなInfoファイルから一つの大きな印刷マニュアルを作成する方法として@dfn{インクルードファイル}が設計されました。 | |
| 14097 | -詳細は@ref{Include Files}を参照してください。 | |
| 14160 | +代わりに、Emacsは、その時点で必要とされる分割された小さなファイルに十分なメモリだけを割り当てます。 | |
| 14161 | +こうすることで、Emacsは、Infoを実行する際にメモリに無駄が出るのを避けます。 | |
| 14162 | +(分割機能が実装される前はInfoファイルは必ず短かく維持され、そういう小さなInfoファイルから一つの大きな印刷マニュアルを作成する方法として@dfn{インクルードファイル}が設計されました。 | |
| 14163 | +詳細は別の節を参照してください(@ref{Include Files})。 | |
| 14098 | 14164 | インクルードファイルは巨大なドキュメントに対して今でも使われます。 |
| 14099 | 14165 | 例えば、@cite{The Emacs Lisp Reference Manual}ですが、このドキュメントでは各章が分割されたファイルになっています。)@refill |
| 14100 | 14166 |
| @@ -14104,7 +14170,7 @@ Texinfoファイルが30,000バイトを超える場合、@code{texinfo-format-b | ||
| 14104 | 14170 | 分割ファイルは、@code{@@setfilename}コマンドで指定されたファイル名に、@w{@samp{-1}}、@w{@samp{-2}}、@w{@samp{-3}}などを追加して作る名前を持ちます。 |
| 14105 | 14171 | 元のファイルの短縮バージョンは、@code{@@setfilename}コマンドで指定された名前をそのまま使います。@refill |
| 14106 | 14172 | |
| 14107 | -このドキュメントを記述しているある段階で、例えば、Infoファイルを@file{test-texinfo}というファイルとして保存しました。 | |
| 14173 | +例えば、このドキュメントを記述しているある段階で、@file{test-texinfo}というファイルとしてInfoファイルを保存しました。 | |
| 14108 | 14174 | そのファイルは次のように見えました。@refill |
| 14109 | 14175 | |
| 14110 | 14176 | @example |
| @@ -14134,19 +14200,18 @@ Node: conventions^?6855 | ||
| 14134 | 14200 | @end example |
| 14135 | 14201 | |
| 14136 | 14202 | @noindent |
| 14137 | -(しかし@file{test-texinfo}はここで示されるよりもはるかに多くのノードがありました。) | |
| 14203 | +(しかし、@file{test-texinfo}は、ここで示されるよりもはるかに多くのノードがありました。) | |
| 14138 | 14204 | 分割された二次的ファイル@file{test-texinfo-1}、@file{test-texinfo-2}、@file{test-texinfo-2}は、このファイルの@samp{Indirect:}と記述された行の後ろにリストされています。 |
| 14139 | 14205 | タグテーブルは@samp{Tag table:}という行の次にリストされています。@refill |
| 14140 | 14206 | |
| 14141 | -二次的ファイルのリストの中で、ファイル名に続く数値は、それより前の二次的ファイルのバイト数を累積値を記録したものです。 | |
| 14142 | -ファイルリスト自体や、タグテーブル、各ファイルの許諾テキストは数えません。 | |
| 14143 | -タグテーブルにおいて、ノード名に続く数値はノードの開始位置を、(分割されていない)出力の開始位置からのバイト数で記録したものです。 | |
| 14207 | +二次的ファイルのリストの中でファイル名に続く数値は、それより前の二次的ファイルのバイト数を累積値を記録したものです。 | |
| 14208 | +ファイルリスト自体やタグテーブル、各ファイルの許諾テキストは数えません。 | |
| 14209 | +タグテーブルにおいてノード名に続く数値は、ノードの開始位置を、(分割されていない)出力の開始位置からのバイト数で記録したものです。 | |
| 14144 | 14210 | |
| 14145 | -@code{texinfo-format-buffer}コマンドを使ってInfoファイルを作成しているのであれあば、@code{Info-validate}コマンドを実行しても構いません。 | |
| 14146 | -(@code{makeinfo}コマンドは放っておいてもそういう良い仕事をしてくれます。 | |
| 14147 | -@code{info-validate}は不要です。) | |
| 14211 | +@code{texinfo-format-buffer}コマンドを使ってInfoファイルを作成しているのであれば、@code{Info-validate}コマンドを実行しても構いません(@code{makeinfo}コマンドは放っておいてもそういう良い仕事をしてくれます。 | |
| 14212 | +@code{info-validate}は不要です)。 | |
| 14148 | 14213 | しかし、@kbd{M-x Info-validate}というノードチェックコマンドを二次的ファイルに対して実行することは出来ません。 |
| 14149 | -ファイルを分割しないようにする方法や、ノードの構造を検証する方法については、@ref{Using Info-validate}を参照してください。 | |
| 14214 | +ファイルを分割しないようにする方法やノードの構造を検証する方法については別の節を参照してください(@pxref{Using Info-validate})。 | |
| 14150 | 14215 | |
| 14151 | 14216 | |
| 14152 | 14217 | @node Installing an Info File |
| @@ -14155,8 +14220,8 @@ Node: conventions^?6855 | ||
| 14155 | 14220 | @cindex Info file installation |
| 14156 | 14221 | @cindex @file{dir} directory for Info installation |
| 14157 | 14222 | |
| 14158 | -Infoファイルは通常@file{info}ディレクトリの中に保持されます。 | |
| 14159 | -Infoファイルは、スタンドアロンのInfoプログラムか、Emacsに組み込まれたInfoリーダを使って読むことが出来ます。 | |
| 14223 | +通常、@file{info}ディレクトリの中にInfoファイルは保持されます。 | |
| 14224 | +スタンドアロンのInfoプログラムか、Emacsに組み込まれたInfoリーダを使ってInfoファイルを読むことが出来ます。 | |
| 14160 | 14225 | (Infoの入門テキストについては、@inforef{Top, info, info}.) |
| 14161 | 14226 | |
| 14162 | 14227 | @menu |
| @@ -14173,9 +14238,9 @@ Infoファイルは、スタンドアロンのInfoプログラムか、Emacsに | ||
| 14173 | 14238 | @node Directory File |
| 14174 | 14239 | @subsection The Directory File @file{dir} |
| 14175 | 14240 | |
| 14176 | -Infoを動作させるには、@file{info}ディレクトリに、そのInfoシステムに対するトップレベルのディレクトリとしての役目を果すファイルが入っていなければなりません。 | |
| 14241 | +Infoを動作させるには、そのInfoシステムに対するトップレベルのディレクトリとしての役目を果すファイルが@file{info}ディレクトリに入っていなければなりません。 | |
| 14177 | 14242 | 慣習では、このファイルのことを@file{dir}と呼びます。 |
| 14178 | -(@file{dir}ファイルの位置は、Emacsでは、@kbd{C-h i}を入力してInfoシステムに入り、@kbd{C-x C-f}と入力して@file{info}ディレクトリのパス名を見ると分かります。) | |
| 14243 | +(Emacsでは、@kbd{C-h i}を入力してInfoシステムに入り、@kbd{C-x C-f}と入力して、@file{info}ディレクトリのパス名を見ると、@file{dir}ファイルの位置が分かります。) | |
| 14179 | 14244 | |
| 14180 | 14245 | @file{dir}ファイルはそれ自体Infoファイルです。 |
| 14181 | 14246 | そのシステムにあるInfoファイル全てに対するトップレベルメニューが入っています。 |
| @@ -14194,14 +14259,14 @@ Infoを動作させるには、@file{info}ディレクトリに、そのInfoシ | ||
| 14194 | 14259 | @end group |
| 14195 | 14260 | @end example |
| 14196 | 14261 | |
| 14197 | -これらのメニューエントリはそれぞれ、括弧内に名前が挙げられているInfoファイルの「Top」ノードを指しています。 | |
| 14198 | -ノード名が指示されていなければ「Top」ノードへ行きますので、メニューエントリが「Top」ノードを指定している必要はありません。 | |
| 14262 | +これらのメニューエントリは、括弧内に名前が挙げられているInfoファイルのTopノードをそれぞれ指しています。 | |
| 14263 | +ノード名が指示されていなければTopノードへ行きますので、メニューエントリがTopノードを指定している必要はありません。 | |
| 14199 | 14264 | @xref{Other Info Files, , Nodes in Other Info Files}.@refill |
| 14200 | 14265 | |
| 14201 | -従って、@samp{Info}のエントリは@file{info}ファイルの「Top」ノードを指していますし、@samp{Emacs}のエントリは@file{emacs}ファイルの「Top」ノードを指しています。@refill | |
| 14266 | +したがって、@samp{Info}のエントリは@file{info}ファイルのTopノードを指していますし、@samp{Emacs}のエントリは@file{emacs}ファイルのTopノードを指しています。@refill | |
| 14202 | 14267 | |
| 14203 | -各Infoファイルでは、「Top」ノードの「Up」ポインタは@code{dir}ファイルを逆に参照します。 | |
| 14204 | -例えば、Emacsマニュアルの「Top」ノードの行はInfoでは次のようになります。@refill | |
| 14268 | +各Infoファイルでは、TopノードのUpポインタは@code{dir}ファイルを逆に参照します。 | |
| 14269 | +例えば、EmacsマニュアルのTopノードの行はInfoでは次のようになります。@refill | |
| 14205 | 14270 | |
| 14206 | 14271 | @example |
| 14207 | 14272 | File: emacs Node: Top, Up: (DIR), Next: Distrib |
| @@ -14236,10 +14301,10 @@ File: emacs Node: Top, Up: (DIR), Next: Distrib | ||
| 14236 | 14301 | 3番目の部分は説明を書いたデスクリプションです。 |
| 14237 | 14302 | |
| 14238 | 14303 | Infoファイルの名前は@file{.info}という拡張子を持つことがよくあります。 |
| 14239 | -GDBのためのInfoファイルは@file{gdb}もしくは@file{gdb.info}のどちらかで呼ぶことが出来るでしょう。 | |
| 14240 | -Infoの閲覧プログラムは自動的に、@file{.info}の付いたファイル名と付かないファイル名を両方試します@footnote{MS-DOS/MS-Windowsシステムでは、@file{.inf}という拡張子も試します。}。 | |
| 14241 | -ですので、メニューエントリでは煩雑にならないように、@samp{.info}を明示的に書かないほうが良いでしょう。 | |
| 14242 | -例えば、件のGDBのメニュエントリでは、ファイル名として@samp{gdb.info}ではなく、単に@samp{gdb}を使用すべきです。 | |
| 14304 | +GDBのためのInfoファイルは、@file{gdb}もしくは@file{gdb.info}のどちらかで呼ぶことが出来るでしょう。 | |
| 14305 | +Infoの閲覧プログラムは、@file{.info}の付いたファイル名と付かないファイル名を自動的に両方試します@footnote{MS-DOS/MS-Windowsシステムでは@file{.inf}という拡張子も試します。}。 | |
| 14306 | +ですので、メニューエントリでは、煩雑にならないように@samp{.info}を明示的に書かないほうが良いでしょう。 | |
| 14307 | +例えば、件のGDBのメニューエントリでは、ファイル名として、@samp{gdb.info}ではなく単なる@samp{gdb}を使用すべきです。 | |
| 14243 | 14308 | |
| 14244 | 14309 | |
| 14245 | 14310 | @node Other Info Directories |
| @@ -14257,15 +14322,13 @@ Infoファイルが@file{info}ディレクトリには無い場合、その場 | ||
| 14257 | 14322 | |
| 14258 | 14323 | @item |
| 14259 | 14324 | Emacsを使用している場合、そのInfoファイルがあるディレクトリにある別の@file{dir}ファイルの中にそのInfoファイルの名前を記述します。 |
| 14260 | -そして、個人の初期化ファイルもしくはサイト全体の初期化ファイルでそのディレクトリの名前を@code{Info-directory-list}変数に設定します。 | |
| 14325 | +そして、そのディレクトリの名前を、個人の初期化ファイル、もしくは、サイト全体の初期化ファイルで@code{Info-directory-list}変数に設定します。 | |
| 14261 | 14326 | |
| 14262 | 14327 | この変数は、@file{dir}ファイルを探す場所をEmacsに指示するものです(ファイルは@file{dir}という名前でなければなりません)。 |
| 14263 | -Emacsは、リストされているディレクトリそれぞれから@file{dir}という名前のファイルを取得してマージします。 | |
| 14264 | -(Emacsバージョン18では、@code{Info-directory}変数をディレクトリ一つの名前に設定することが出来ます。)@refill | |
| 14328 | +Emacsは、リストされているそれぞれのディレクトリから、@file{dir}という名前のファイルを取得して、マージします(Emacsバージョン18では、@code{Info-directory}変数をディレクトリ一つの名前に設定することが出来ます)。@refill | |
| 14265 | 14329 | |
| 14266 | 14330 | @item |
| 14267 | -初期化ファイルの@file{.profile}もしくは@file{.cshrc}で、環境変数@code{INFOPATH}にそのInfoディレクトリの名前を指定します。 | |
| 14268 | -(この環境変数を設定した人だけが、この方法で指定された場所にあるInfoファイルを見つけることが出来ます。) | |
| 14331 | +初期化ファイルの@file{.profile}、もしくは、@file{.cshrc}で、そのInfoディレクトリの名前を環境変数@code{INFOPATH}に指定します(この環境変数を設定した人だけが、この方法で指定された場所にあるInfoファイルを見つけることが出来ます)。 | |
| 14269 | 14332 | @end enumerate |
| 14270 | 14333 | |
| 14271 | 14334 | 例えば、@file{/home/bob/info}にあるテストファイルへ到達する場合には、標準の@file{dir}ファイルにあるメニューに次のようなエントリを追加することが出来るでしょう。@refill |
| @@ -14275,7 +14338,7 @@ Emacsは、リストされているディレクトリそれぞれから@file{dir | ||
| 14275 | 14338 | @end example |
| 14276 | 14339 | |
| 14277 | 14340 | @noindent |
| 14278 | -この場合では、@file{info-test}ファイルの絶対ファイル名がメニューエントリの2番目の部分として記述されています。@refill | |
| 14341 | +この場合では、@file{info-test}ファイルの絶対ファイル名が、メニューエントリの2番目の部分として記述されています。@refill | |
| 14279 | 14342 | |
| 14280 | 14343 | 他に、@file{.emacs}ファイルの中に次のように記述することも出来るでしょう。 |
| 14281 | 14344 |
| @@ -14291,26 +14354,27 @@ Emacsは、リストされているディレクトリそれぞれから@file{dir | ||
| 14291 | 14354 | |
| 14292 | 14355 | これは、システムの@file{dir}ファイルと@file{/home/bob/info}にある@file{dir}ファイルをマージするようにEmacsに指示するものです。 |
| 14293 | 14356 | こうして、Infoは、@file{/home/bob/info/dir}ファイルのメニューエントリとして@file{/home/bob/info/info-test}ファイルをリストします。 |
| 14294 | -Emacsは@kbd{M-x info}が最初に実行された時にだけこのマージを行ないますので、既に@code{info}を実行済みのEmacsセッションにおいて、@code{Info-directory-list}を設定したい場合には、@code{(setq Info-dir-contents nil)}を実行して、Emacsに強制的に@file{dir}ファイルを再構成させなければなりません。 | |
| 14357 | +@kbd{M-x info}が最初に実行された時にだけ、Emacsはこのマージを行ないます。 | |
| 14358 | +そのため、既に@code{info}を実行済みのEmacsセッションにおいて@code{Info-directory-list}を設定したい場合には、@code{(setq Info-dir-contents nil)}を実行して、@file{dir}ファイルをEmacsに強制的に再構成させなければなりません。 | |
| 14295 | 14359 | |
| 14296 | 14360 | @vindex INFOPATH |
| 14297 | 14361 | @cindex Environment variable @code{INFOPATH} |
| 14298 | -例えば@file{.cshrc}や@file{.profile}、@file{autoexec.bat}のようなシェルのスタートアップファイルの中で、環境変数@code{INFOPATH}を設定して、探索する場所をInfoに指示することが出来ます。 | |
| 14299 | -シェルコマンドのインタプリタとして@code{sh}や@code{bash}のようなBourne互換のシェルを使用している場合、初期化ファイルの@file{.profile}で環境変数@code{INFOPATH}を設定します。 | |
| 14300 | -そうではなく、@code{csh}や@code{tcsh}を使用している場合は、初期化ファイルの@file{.cshrc}の中で環境変数を設定してください。 | |
| 14301 | -また、MS-DOS/MS-Windowsシステムの場合は、@file{autoexec.bat}ファイルかレジストリの中で@code{INFOPATH}を設定しなければなりません。 | |
| 14302 | -シェルはタイプによって異なった文法を用います。 | |
| 14362 | +例えば、@file{.cshrc}、@file{.profile}、@file{autoexec.bat}のようなシェルのスタートアップファイルの中で環境変数@code{INFOPATH}を設定して、探索する場所をInfoに指示することが出来ます。 | |
| 14363 | +@code{sh}や@code{bash}のようなBourne互換のシェルをシェルコマンドのインタプリタとして使用している場合、初期化ファイルの@file{.profile}で環境変数@code{INFOPATH}を設定します。 | |
| 14364 | +そうではなく@code{csh}や@code{tcsh}を使用している場合は、初期化ファイルの@file{.cshrc}の中で環境変数を設定してください。 | |
| 14365 | +また、MS-DOS/MS-Windowsシステムの場合は、@file{autoexec.bat}ファイルの中か、レジストリの中で@code{INFOPATH}を設定しなければなりません。 | |
| 14366 | +シェルは、タイプによって異なった文法を用います。 | |
| 14303 | 14367 | |
| 14304 | 14368 | @itemize @bullet |
| 14305 | 14369 | @item |
| 14306 | -@file{.cshrc}ファイルでは、次のようにして@code{INFOPATH}変数を設定できるでしょう。@refill | |
| 14370 | +@file{.cshrc}ファイルでは次のようにして@code{INFOPATH}変数を設定できるでしょう。@refill | |
| 14307 | 14371 | |
| 14308 | 14372 | @smallexample |
| 14309 | 14373 | setenv INFOPATH .:~/info:/usr/local/emacs/info |
| 14310 | 14374 | @end smallexample |
| 14311 | 14375 | |
| 14312 | 14376 | @item |
| 14313 | -@file{.profile}ファイルでは、次のように書くと同じ効果が得られます。@refill | |
| 14377 | +@file{.profile}ファイルでは次のように書くと同じ効果が得られます。@refill | |
| 14314 | 14378 | |
| 14315 | 14379 | @smallexample |
| 14316 | 14380 | INFOPATH=.:$HOME/info:/usr/local/emacs/info |
| @@ -14319,7 +14383,7 @@ export INFOPATH | ||
| 14319 | 14383 | |
| 14320 | 14384 | @item |
| 14321 | 14385 | @pindex autoexec.bat |
| 14322 | -@file{autoexec.bat}ファイルでは、次のコマンドを書きます@footnote{ディレクトリを区切るのに@samp{;}文字を使用していることに注意してください。 | |
| 14386 | +@file{autoexec.bat}ファイルでは次のコマンドを書きます@footnote{ディレクトリを区切るのに@samp{;}文字を使用していることに注意してください。 | |
| 14323 | 14387 | また、他の環境変数の値を参照する文法が異なっていることにも注意が必要です。}。 |
| 14324 | 14388 | |
| 14325 | 14389 | @smallexample |
| @@ -14328,14 +14392,14 @@ set INFOPATH=.;%HOME%/info;c:/usr/local/emacs/info | ||
| 14328 | 14392 | @end itemize |
| 14329 | 14393 | |
| 14330 | 14394 | @noindent |
| 14331 | -@samp{.}文字は通常カレントディレクトリのことを表わします。 | |
| 14332 | -Emacsは環境変数@code{INFOPATH}を使ってEmacs自体の@code{Info-directory-list}変数の値を初期化します。 | |
| 14333 | -スタンドアロンのInfoリーダーは@env{INFOPATH}変数にリストされているディレクトリ全てにある@file{dir}という名前のファイルを全部、@samp{(dir)Top}と呼ばれるノードでユーザに提供する一つのメニューとしてマージします。 | |
| 14395 | +通常、@samp{.}文字は、カレントディレクトリのことを表わします。 | |
| 14396 | +Emacsは、環境変数@code{INFOPATH}を使って、Emacs自体の@code{Info-directory-list}変数の値を初期化します。 | |
| 14397 | +スタンドアロンのInfoリーダーは、@env{INFOPATH}変数にリストされている全ディレクトリにある@file{dir}という名前のファイルを、@samp{(dir)Top}と呼ばれるノードでユーザに提供する一つのメニューとして全てマージします。 | |
| 14334 | 14398 | |
| 14335 | 14399 | @cindex Colon, last in @env{INFOPATH} |
| 14336 | 14400 | たとえ@env{INFOPATH}を設定していたとしても、その最後の文字がコロン@footnote{MS-DOS/MS-Windowsシステムであれば代わりにセミコロンを使ってください。}であれば、このコロンはデフォルトの(コンパイルで組み込まれた)パスで置き換えられます。 |
| 14337 | -これは、標準の探索場所を全て挙げることなく、デフォルトパスに新しいディレクトリを追加する手段となります。 | |
| 14338 | -例えば以下を見てください(@code{sh}の文法を使用しています)。 | |
| 14401 | +これは、標準の探索場所を全て挙げることなくデフォルトパスに新しいディレクトリを追加する手段となります。 | |
| 14402 | +例えば、以下を見てください(@code{sh}の文法を使用しています)。 | |
| 14339 | 14403 | |
| 14340 | 14404 | @example |
| 14341 | 14405 | INFOPATH=/local/info: |
| @@ -14343,11 +14407,11 @@ export INFOPATH | ||
| 14343 | 14407 | @end example |
| 14344 | 14408 | |
| 14345 | 14409 | @noindent |
| 14346 | -この場合だと、@file{/local/info}をまず探索し、次に標準のディレクトリを探索します。 | |
| 14410 | +この場合だと、@file{/local/info}をまず探索し、次に、標準のディレクトリを探索します。 | |
| 14347 | 14411 | 前に付けられたコロンや二重コロンに対しては特別な処理は行なわれません。 |
| 14348 | 14412 | |
| 14349 | 14413 | @cindex @file{dir} file, creating your own |
| 14350 | -@code{Info-directory-list}や@env{INFOPATH}で使用するために独自の@file{dir}ファイルを作成する場合に最も簡単なのは、既存の@file{dir}ファイルをコピーすることから開始して、@samp{* Menu:}から後ろのテキストを全て必要なエントリへと書き換えてしまうことです。 | |
| 14414 | +@code{Info-directory-list}や@env{INFOPATH}で使用するために独自の@file{dir}ファイルを作成する場合、最も簡単なのは、既存の@file{dir}ファイルをコピーすることから開始して、@samp{* Menu:}から後ろのテキストを必要なエントリへと全て書き換えてしまうことです。 | |
| 14351 | 14415 | そうすることで、Infoが必要とする句読点記号や特殊なCTRL-_文字がそこに存在していることになります。 |
| 14352 | 14416 | |
| 14353 | 14417 |
| @@ -14359,7 +14423,7 @@ export INFOPATH | ||
| 14359 | 14423 | |
| 14360 | 14424 | @findex dircategory |
| 14361 | 14425 | @findex direntry |
| 14362 | -Infoファイルが@code{install-info}と連携するためには、Texinfoのソースファイルに@code{@@dircategory}コマンドと@code{@@direntry}@dots{}@code{@@end direntry}コマンドを含めます。 | |
| 14426 | +Infoファイルが@code{install-info}と連携するためには、@code{@@dircategory}コマンドと@code{@@direntry}@dots{}@code{@@end direntry}コマンドをTexinfoのソースファイルに含めます。 | |
| 14363 | 14427 | Infoディレクトリファイルへ追加するメニューエントリを指定するには@code{@@direntry}を使ってください。 |
| 14364 | 14428 | そのInfoファイルがInfoディレクトリのどの部分に配置されるのかを指定するには@code{@@dircategory}コマンドを使用します。 |
| 14365 | 14429 | 以下は、これらのコマンドがこのマニュアルでどのように使用されているかを示しています。 |
| @@ -14373,7 +14437,7 @@ Infoディレクトリファイルへ追加するメニューエントリを指 | ||
| 14373 | 14437 | @@end direntry |
| 14374 | 14438 | @end smallexample |
| 14375 | 14439 | |
| 14376 | -以下はこれによってInfoファイルの中に生成されるものを示しています。 | |
| 14440 | +以下は、これによってInfoファイルの中に生成されるものを示しています。 | |
| 14377 | 14441 | |
| 14378 | 14442 | @smallexample |
| 14379 | 14443 | INFO-DIR-SECTION Texinfo documentation system |
| @@ -14387,23 +14451,23 @@ END-INFO-DIR-ENTRY | ||
| 14387 | 14451 | @noindent |
| 14388 | 14452 | @code{install-info}プログラムはInfoファイル中にあるこれらの行を調べ、行なうべきことを知ります。 |
| 14389 | 14453 | |
| 14390 | -@code{@@direntry}コマンドと@code{@@dircategory}コマンドは、必ずTexinfo入力の冒頭付近、最初の@code{@@node}コマンドの前で使うようにしてください。 | |
| 14391 | -もし入力ソースのもっと後の方で使われた場合、@code{install-info}プログラムが検知できないでしょう。 | |
| 14454 | +@code{@@direntry}コマンドと@code{@@dircategory}コマンドは、Texinfo入力の冒頭付近、最初の@code{@@node}コマンドの前で必ず使うようにしてください。 | |
| 14455 | +もし、入力ソースのもっと後の方で使われた場合、@code{install-info}プログラムが検知できないでしょう。 | |
| 14392 | 14456 | |
| 14393 | 14457 | @code{install-info}プログラムは、追加するメニューエントリのデスクリプションを自動的に再書式化します。 |
| 14394 | -慣習の問題として、メインエントリのデスクリプションは(Emacsの@code{what-cursor-position}のように)0から数えて32カラムのところから開始します。 | |
| 14395 | -これによって他の大半のものと揃えられることになります。 | |
| 14396 | -個々のユーティリティのデスクリプションは、可能であれば48カラムで開始するのが適切です。 | |
| 14397 | -書式化に関する詳細は、@ref{Invoking install-info}の@samp{--calign}オプション、@samp{--align}オプション、@samp{--max-width}オプションを参照してください。 | |
| 14458 | +慣習の問題として、メインエントリのデスクリプションは(Emacsの@code{what-cursor-position}のように)、0から数えて32カラムのところから開始します。 | |
| 14459 | +これによって、他の大半のものと揃えられることになります。 | |
| 14460 | +可能であれば、個々のユーティリティのデスクリプションは48カラムで開始するのが適切です。 | |
| 14461 | +書式化に関する詳細は、別の節(@pxref{Invoking install-info})にある@samp{--calign}オプション、@samp{--align}オプション、@samp{--max-width}オプションを参照してください。 | |
| 14398 | 14462 | |
| 14399 | 14463 | @code{@@dircategory}コマンドを |
Part of diff was cut off due to size limit. Use your local client to view the full diff.