Skip to content

Commit 8d9dda1

Browse files
committed
update ja/help.md
1 parent 603ce19 commit 8d9dda1

1 file changed

Lines changed: 17 additions & 65 deletions

File tree

ja/help.md

Lines changed: 17 additions & 65 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ Overleafは世界的に最も人気のあるオンラインLaTeXサービスの1
5151

5252
既にOverleafアカウントの情報がブラウザにキャッシュされている場合は、Overleafで新しいタブが開かれて新しいプロジェクト内に送信したコードが保存された状態になります。よってOverleaf上でコードを編集し、同時にそのコードを実際にLaTeXで処理した出力やエラーログを閲覧することができるようになります。
5353

54-
なお、Overleafはデフォルト設定は和文文書の処理(pLaTeX)に対応していないため、和文のサンプルを試すには**少し設定が必要**です[^overleaf_platex]。まず、左上の「Menu」をクリックして「Compiler」をデフォルトの「pdfLaTeX」から「LaTeX」に変更します。次に、「Menu」直下の書類アイコン(New file)をクリックして`latexmkrc`という名前のファイルを作成し、次の内容を書き込みます。
54+
なお、Overleafはデフォルト設定は和文文書の処理(pLaTeX)に対応していないため、**和文のコード例を試すには少し設定が必要**です[^overleaf_platex]。まず、左上の「Menu」をクリックして「Compiler」をデフォルトの「pdfLaTeX」から「LaTeX」に変更します。次に、「Menu」直下の書類アイコン(New file)をクリックして`latexmkrc`という名前のファイルを作成し、次の内容を書き込みます。
5555

5656
```
5757
$latex = 'platex';
@@ -96,8 +96,6 @@ PDF出力(あるいはエラーログの抜粋)がコード例の直下に
9696

9797
このしくみにより`% !TEX program=pdflatex`といういくつかのTeXエディタでサポートされている記法が許容されるようになっています。ただし`program=`の部分は、現状ではオンラインシステムで利用可能なエンジンのうちの1つを選択するのにしか利用されないため省略可能になっています。
9898

99-
<!-- TODO: 日本語版独自の説明 -->
100-
10199
なお`platex``uplatex`が選択された場合には`devipdfmx`コマンドが自動的に呼び出され、これらのエンジンが出力するDVIファイルはPDFに変換されるようになっています。同様に`latex`が選択されている場合には`dvips``ps2pdf`が使用されます。
102100

103101
---
@@ -112,48 +110,39 @@ TeXLive.netを使用した場合、コード例を実行したことによるPDF
112110

113111
デフォルトの挙動は、末尾の値を`pdfjs`とすることで明示的に指定することもできます。デバッグ目的ではエラーなしにPDFが得られる場合でもログファイルの内容を見たいという場合があるかもしれません。そのような場合は末尾の値を`log`としてください。
114112

115-
As an alternative to using a `% !TeX` comment, you may specify the
116-
site default return parameter on the [Site Settings](settings)
117-
page. The Settings are specific to each browser, so for example you
118-
may choose to use the default `pdfjs` setting on your mobile device,
119-
but use `pdf` on your desktop browser to use its default PDF rendering.
113+
`% !TeX`形式のコメントを使わずに、[サイト設定](settings)ページを利用してデフォルトの挙動を変更することもできます。サイト設定はブラウザごとに指定できます。そのためモバイル端末ではデフォルトの`pdfjs`を設定しながら、PCでは`pdf`を指定してデスクトップブラウザのデフォルトPDFレンダラを利用するというようなことも可能です。
120114

121115
---
122116

123-
## HTML output (make4ht, LaTeXML, lwarp)
117+
## HTML出力(make4ht、LaTeXML、lwarp)
118+
119+
<p class="hint">本セクションで説明されるHTML出力は、原則として和文をサポートしていません。HTML出力を試みる場合は英文のコード例で試すことをおすすめします。本チュートリアルの翻訳チームは、和文のHTML出力について動作確認を実施していません。</p>
124120

125-
If using the TeXLive.net system, then additional return options,
126-
`make4ht`, `LaTeXML` or `lwarp` may be specified. These return one or more HTML pages
127-
in the frame within the page. It may be specified at the same time
128-
as `xelatex` or `lualatex` as well as the default `pdflatex` processing.
121+
TeXLive.netを利用する場合は、追加の表示方法オプションとして`make4ht``LaTeXML``lwarp`がサポートされています。これらを利用すると1つ以上のHTMLページをサイトのフレーム内に表示します。これらのHTML出力の指定は`xelatex``lualatex``pdflatex`などのエンジン指定と両立します。
129122

130-
To enable this output, add a comment of the form:
123+
HTML出力を指定するには、例えば次のようなコメントを記入します:
131124

132125
```
133126
% !TeX make4ht
134127
```
135128
{: .noedit :}
136129

137-
Replacing `make4ht` by `LaTeXML` or `lwarp` to specify those systems.
130+
別のシステムを利用する場合は`make4ht``LaTeXML``lwarp`に置き換えてください。
138131

139-
Alternatively you may specify `make4ht`, `LaTeXML` or `lwarp` as the default return option
140-
on the [Site Settings](settings) page.
132+
これらのHTML出力を[サイト設定](settings)からデフォルトの挙動にすることも可能です。
141133

142-
If using a locally installed TeX system, the same output as the `make4ht` option may be obtained
143-
by executing
134+
ローカルのTeXシステムを利用している場合は、次のコマンドを実行すると`make4ht`オプションで表示されるものと同じ出力を得ることができます。
144135

145136
```
146-
make4ht document.tex "learnlatex4ht,2,mathml,mathjax,svg"
137+
make4ht document.tex "learnlatex4ht,2,mathml,mathjax,svg"
147138
```
148139
{: .noedit :}
149140

150-
with the addional option `-x` or `-l` if XeLaTeX or LuaLaTeX are specified.
141+
XeLaTeXやLuaLaTeXを使用している場合はそれぞれ`-x`または`-l`オプションを追加してください。
151142

152-
When running locally, other configurations would be possible. See the [make4ht
153-
manual](https://texdoc.org/pkg/make4ht).
143+
ローカルで実行する場合は、ほかにもさまざまな設定が利用可能です。詳細は[make4htのマニュアル](https://texdoc.org/pkg/make4ht)を参照してください。
154144

155-
For `LaTeXML` to run locally, you would need to install LaTeXML (it is not part of TeX Live or MiKTeX)
156-
and use
145+
LaTeXMLをローカルで実行するためには、別途LaTeXMLをインストールする必要があります(TeX LiveやMiKTeXには含まれていません)。その上で、次のコマンドを実行します。
157146

158147
```
159148
latexml document.tex > document.xml
@@ -163,47 +152,10 @@ latexmlpost --format=html5 \
163152
```
164153
{: .noedit :}
165154

166-
Many other LaTeXML configurations are possible,
167-
[as described in the manual](https://dlmf.nist.gov/LaTeXML/manual/).
168-
169-
The `lwarp` configuration is not documented here, it is somewhat experimental and subject to change.
170-
The current version can be seen at the
171-
[source repository](https://github.com/davidcarlisle/latexcgi/blob/main/lwarp/latexcgilwarp).
172-
173-
---
174-
175-
<!-- TODO: 以下はそのうち消す -->
176-
177-
Each example consists of a complete small LaTeX document shown within
178-
the page like this:
179-
180-
## Japanese
181-
182-
Japanese examples look like:
183-
184-
```latex
185-
% !TEX platex
186-
\documentclass{jsarticle}
187-
\begin{document}
188-
テキストの例。
189-
\end{document}
190-
```
191-
192-
See also the examples in [The Japanese specific section of the site](language-01)
193-
194-
## English
195-
196-
English example:
197-
198-
```latex
199-
\documentclass{article}
200-
\usepackage[T1]{fontenc}
201-
\begin{document}
202-
Example text.
203-
\end{document}
204-
```
155+
LaTeXMLについてもさまざまな設定が利用可能です。詳細は[LaTeXMLのマニュアル](https://dlmf.nist.gov/LaTeXML/manual/)を参照してください。
205156

206-
<!-- TODO: ここまで -->
157+
lwarpの設定方法は、今のところ実験的なもので将来的に変更される可能性が高いため、ここでは説明しません。最新バージョンの情報は
158+
[ソースリポジトリ](https://github.com/davidcarlisle/latexcgi/blob/main/lwarp/latexcgilwarp)で確認できます。
207159

208160
---
209161

0 commit comments

Comments
 (0)