Skip to content

Commit 412915a

Browse files
wtsnjpwtsnjp
committed
update ja/{lesson,more}-16.md
1 parent 72f9397 commit 412915a

2 files changed

Lines changed: 34 additions & 31 deletions

File tree

‎ja/lesson-16.md‎

Lines changed: 28 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -2,27 +2,27 @@
22
layout: "lesson"
33
lang: "ja"
44
title: "ドキュメントへのアクセス方法とヘルプの求め方"
5-
description: "このレッスンでは LaTeX 関連のソフトウェアやパッケージのドキュメントにアクセスする主要な方法を紹介します。さらに問題が発生した場合に、どのようにヘルプを求めればいいかも見ていきます。"
5+
description: "このレッスンではLaTeX関連のソフトウェアやパッケージのドキュメントにアクセスする主要な方法を紹介します。さらに問題が発生した場合に、どのようにヘルプを求めればいいかも見ていきます。"
66
toc-anchor-text: "ドキュメントとヘルプ"
77
toc-description: "ドキュメントへのアクセス方法とヘルプの求め方"
88
---
99

1010
# ドキュメントへのアクセス方法とヘルプの求め方
1111

12-
<span class="summary">このレッスンでは LaTeX 関連のソフトウェアやパッケージのドキュメントにアクセスする主要な方法を紹介します。さらに問題が発生した場合に、どのようにヘルプを求めればいいかも見ていきます。</span>
12+
<span class="summary">このレッスンではLaTeX関連のソフトウェアやパッケージのドキュメントにアクセスする主要な方法を紹介します。さらに問題が発生した場合に、どのようにヘルプを求めればいいかも見ていきます。</span>
1313

1414
パッケージや文書クラスのドキュメントにアクセスする方法はいくつかあります。
1515

1616
## `texdoc`
1717

18-
TeX ディストリビューション（TeX Live や MiKTeX）をドキュメント込みでインストールしている場合、`texdoc` というコマンドラインツールを使用してローカルに保存されたドキュメントにアクセスすることができます。
18+
TeXディストリビューション（TeX LiveやMiKTeX）をドキュメント込みでインストールしている場合、`texdoc`というコマンドラインツールを使用してローカルに保存されたドキュメントにアクセスすることができます。
1919

2020
```
2121
texdoc 〈パッケージ名〉
2222
```
2323
{: .noedit :}
2424

25-
を実行すると `〈パッケージ名〉` に対応するドキュメントが開きます。このツールは利用可能なドキュメントを検索し、検索ワードに最も関連性が高いと判断したものを開きます。また次のようにすることで、見つかった利用可能なドキュメントを一覧表示させることもできます：
25+
を実行すると`〈パッケージ名〉`に対応するドキュメントが開きます。このツールは利用可能なドキュメントを検索し、検索ワードに最も関連性が高いと判断したものを開きます。また次のようにすることで、見つかった利用可能なドキュメントを一覧表示させることもできます：
2626

2727
```
2828
texdoc -l 〈パッケージ名〉
@@ -31,63 +31,66 @@ texdoc -l 〈パッケージ名〉
3131

3232
## texdoc.org
3333

34-
`texdoc` コマンドと同様の機能を提供する[ウェブサイト](https://texdoc.org/)もあります。このサイトでは、ちょうど `texdoc -l` のようにドキュメントを検索して選択肢の中から好みのものを選んで閲覧することができます。
34+
`texdoc`コマンドと同様の機能を提供する[ウェブサイト](https://texdoc.org/)もあります。このサイトでは、ちょうど`texdoc -l`のようにドキュメントを検索して選択肢の中から好みのものを選んで閲覧することができます。
3535

3636
## CTAN
3737

38-
[CTAN](https://www.ctan.org) (Comprehensive TeX Archive Network) は TeX 関連の成果物を集積するネットワークです。ほとんどの LaTeX パッケージはここに登録されています。このサイトでパッケージを検索してドキュメントを閲覧することも可能です。一般にパッケージは `ctan.org/pkg/〈パッケージ名〉` という位置に保存されているので、そこにアクセスすると README をはじめ CTAN にアップロードされているドキュメントを見ることができます。
38+
[CTAN](https://www.ctan.org)（Comprehensive TeX Archive Network）はTeX関連の成果物を集積するネットワークです。ほとんどのLaTeXパッケージはここに登録されています。このサイトでパッケージを検索してドキュメントを閲覧することも可能です。一般にパッケージは`ctan.org/pkg/〈パッケージ名〉`という位置に保存されているので、そこにアクセスするとREADMEをはじめCTANにアップロードされているドキュメントを見ることができます。
3939

40-
## LaTeX に関する書籍（英語）
40+
## LaTeXに関する書籍（英語）
4141

42-
LaTeX についてもっと詳しく学ぶのに役立つ本は数多く出版されています。LaTeX 初心者の場合は、初心者向けに構成された入門書を読むのがよいでしょう。そうした本には、このチュートリアルよりもさらに詳しい解説が載っているはずです。以下では、具体的に文献を紹介していきます。
42+
LaTeXについてもっと詳しく学ぶのに役立つ本は数多く出版されています。LaTeX初心者の場合は、初心者向けに構成された入門書を読むのがよいでしょう。そうした本には、このチュートリアルよりもさらに詳しい解説が載っているはずです。以下では、具体的に文献を紹介していきます。
4343

44-
LaTeX 開発チームは[書籍のリスト](https://www.latex-project.org/help/books/)を公開しています。このリストに載っている本の多くは、LaTeX チームのメンバーによって執筆されたものです。最も重要なものは
45-
[Lamport の公式ガイド](https://www.informit.com/store/latex-a-document-preparation-system-9780201529838)と網羅的な解説書である[『LaTeX コンパニオン』]((https://www.informit.com/store/latex-companion-9780201362992))です。
44+
LaTeX 開発チームは[書籍のリスト](https://www.latex-project.org/help/books/)を公開しています。このリストに載っている本の多くはLaTeXチームのメンバーによって執筆されたものです。最も重要なものは
45+
[Lamportの公式ガイド](https://www.informit.com/store/latex-a-document-preparation-system-9780201529838)と網羅的な解説書である[『LaTeXコンパニオン』]((https://www.informit.com/store/latex-companion-9780201362992))です。
4646

47-
その他の LaTeX 学習本には次のようなものがあります：
47+
その他のLaTeX学習本には次のようなものがあります：
4848

49-
* Helmut Kopka, Patrick Daly 著 [_Guide to LaTeX_](https://www.informit.com/store/guide-to-latex-9780132651714): 電子書籍
50-
* Nicola Talbot 著 [_LaTeX for Complete Novices_](https://www.dickimaw-books.com/latex/novices/): 無償の電子書籍、廉価の紙書籍
51-
* Nicola Talbot 著 [_Using LaTeX to write a PhD thesis_](https://www.dickimaw-books.com/latex/thesis/): 無償の電子書籍、廉価の紙書籍
52-
* Stefan Kottwitz 著 [_LaTeX Beginner's Guide_](https://www.packtpub.com/gb/hardware-and-creative/latex-beginners-guide): 電子書籍、紙書籍
53-
* Marc van Dongen 著 [_LaTeX and Friends_](https://www.springer.com/gp/book/9783642238154): 電子書籍、紙書籍
49+
* Helmut Kopka, Patrick Daly著 [_Guide to LaTeX_](https://www.informit.com/store/guide-to-latex-9780132651714): 電子書籍
50+
* Nicola Talbot著 [_LaTeX for Complete Novices_](https://www.dickimaw-books.com/latex/novices/): 無償の電子書籍、廉価の紙書籍
51+
* Nicola Talbot著 [_Using LaTeX to write a PhD thesis_](https://www.dickimaw-books.com/latex/thesis/): 無償の電子書籍、廉価の紙書籍
52+
* Stefan Kottwitz著 [_LaTeX Beginner's Guide_](https://www.packtpub.com/gb/hardware-and-creative/latex-beginners-guide): 電子書籍、紙書籍
53+
* Marc van Dongen著 [_LaTeX and Friends_](https://www.springer.com/gp/book/9783642238154): 電子書籍、紙書籍
5454

5555
## ヘルプを求める
5656

57-
LaTeX に関する質問をすることができるオンラインフォーラムはたくさんあります。現在最も人気の高い QA サイトはおそらく以下の通りです。
57+
LaTeXに関する質問をすることができるオンラインフォーラムはたくさんあります。現在最も人気の高いQAサイトはおそらく以下の通りです。
5858

5959
* 英語圏：[TeX - LaTeX StackExchange](https://tex.stackexchange.com)
60-
* 日本語圏：[TeX フォーラム](https://oku.edu.mie-u.ac.jp/tex/)
60+
* 日本語圏：[TeXフォーラム](https://oku.edu.mie-u.ac.jp/tex/)
6161

62-
こうした場所で質問をする場合は常に、再現手順を明確にすることが最重要です。つまり、いわゆる最小再現コード例 (Minimal Working Example; MWE) を作ることが大事です。これは問題を自己解決する必要はありませんが（それができるなら質問しないですよね）、できる限り明確で、自己完結していて、最小のコード例を作りましょう。言い換えると、問題を再現するのに最低限必要なもののみに絞り込むということです。
62+
こうした場所で質問をする場合は常に、再現手順を明確にすることが最重要です。つまり、いわゆる最小再現コード例（Minimal Working Example；MWE）を作ることが大事です。これは問題を自己解決する必要はありませんが（それができるなら質問しないですよね）、できる限り明確で、自己完結していて、最小のコード例を作りましょう。言い換えると、問題を再現するのに最低限必要なもののみに絞り込むということです。
6363

64-
### MWE の作り方
64+
### MWEの作り方
6565

66-
ではどうすれば MWE を作ることができるのでしょうか？ 基本的には、まず次のような文書を作成します。
66+
ではどうすればMWEを作ることができるのでしょうか？ 基本的には、まず次のような文書を作成します。
6767

6868
```latex
6969
\documentclass{article}
7070
\begin{document}
7171
Text
7272
\end{document}
7373
```
74+
{: .noedit :}
7475

7576
そして、困っている問題が発生するまで一行ずつコードを追加していきます。もちろん実際に作成しているファイルから「切り落とす」ことで MWE を作成することもできますが、手順が長くなるかもしれません。
7677

77-
<p class="hint">改ページやその他の影響を与えるために、より長いテキストが必要になる場合もあります。そのような場合は <code>lipsum</code> パッケージ（日本語のテキストが必要な場合は <code>bxjalipsum</code> パッケージ）を使用すると、無意味な段落を生成することができるのでテストファイルを簡潔に保つのに役立つでしょう。</p>
78+
<p class="hint">改ページやその他の影響を与えるために、より長いテキストが必要になる場合もあります。そのような場合は<code>lipsum</code>パッケージ（日本語のテキストが必要な場合は<code>bxjalipsum</code>パッケージ）を使用すると、ダミーの段落を生成することができるのでテストファイルを簡潔に保つのに役立つでしょう。</p>
7879

7980
### ログファイル
8081

81-
またログファイルを見ることも重要です。これは LaTeX を実行する度に作成されるもので、作成している文書ソースのファイル名と同一の名前で拡張子 `.log` を持っています。
82+
またログファイルを見ることも重要です。これはLaTeXを実行する度に作成されるもので、作成している文書ソースのファイル名と同一の名前で拡張子`.log`を持っています。
8283

8384
<p class="hint">デスクトップ環境によっては「拡張子を表示する」のようなオプションを使用しないとどのファイルかわからないかもしれません。</p>
8485

85-
ログファイルの中には、常にフルのエラーメッセージが書かれています。LaTeX のエラーメッセージはなるべくわかりやすくなるようにと努力がなされていますが、一般のワープロのようにはいきません。
86+
ログファイルの中には、常にフルのエラーメッセージが書かれています。LaTeXのエラーメッセージはなるべくわかりやすくなるようにと努力がなされていますが、一般のワープロのようにはいきません。
8687

8788
<p class="hint">エディタによってはエラーの「フル」テキストの閲覧を難しくするものもあります。そのような場合、重要な情報が隠されてしまっている可能性があります。</p>
8889

89-
何か問題が発生した場合、経験豊富な LaTeX ユーザはしばしばログファイルを添付して欲しいとお願いをします。
90+
何か問題が発生した場合、経験豊富なLaTeXユーザはしばしばログファイルを添付して欲しいとお願いをします。
9091

9192
## さらに学ぶ
9293

94+
<!-- TODO: 日本語版に合わせて更新 -->
95+
9396
これで本チュートリアルのメインレッスンは終わりです。[付録レッスン](./extra-01)ではメインレッスンでは扱わなかったテーマやパッケージに関する小さなコード例をいくつか紹介しているので、興味のある方は確認してみてください。

‎ja/more-16.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,14 @@
22
layout: "lesson"
33
lang: "ja"
44
title: "追加レッスン：ドキュメントへのアクセス方法とヘルプの求め方"
5-
description: "This lesson show you where you can find the sources of LaTeX itself."
6-
toc-anchor-text: "More on: Accessing documentation and getting help"
5+
description: "この追加レッスンではLaTeX本体のソースコードの見つけ方を学びます。"
6+
toc-anchor-text: "追加レッスン：ドキュメントへのアクセス方法とヘルプの求め方"
77
---
88

9-
## LaTeX のソースコード解説文書
9+
## LaTeXのソースコード解説文書
1010

11-
メインレッスンで解説した `texdoc` コマンドはパッケージ文書の検索に特化しているわけではありません。必要があれば、LaTeX の実装の詳細など、それらを超える情報にアクセスすることができます。そうした情報が必要な場合には、以下のリンクが役に立つことでしょう。
11+
メインレッスンで解説した`texdoc`コマンドはパッケージ文書の検索に特化しているわけではありません。必要があれば、LaTeXの実装の詳細など、それらを超える情報にアクセスすることができます。そうした情報が必要な場合には、以下のリンクが役に立つことでしょう。
1212

13-
LaTeX のソースコードは LaTeX 自身で組版された文書 `source2e.pdf` として読むことができます。この文書を開くには `texdoc source2e` を実行するか [texdoc.org](https://texdoc.org/pkg/source2e) にアクセスします。
13+
LaTeXのソースコードはLaTeX自身で組版された文書`source2e.pdf`として読むことができます。この文書を開くには`texdoc source2e`を実行するか[texdoc.org](https://texdoc.org/pkg/source2e)にアクセスします。
1414

15-
最近の LaTeX では LaTeX3 Programming Language (expl3) がデフォルトで利用可能になっています（この機能は、かつては `expl3` パッケージとして提供されていました）。[expl3 インターフェースの解説文書](https://texdoc.org/pkg/interface3) (`texdoc interface3`) や[expl3 のソースコード解説文書](https://texdoc.org/pkg/source3) (`texdoc source3`) も `texdoc` で開くことができます。
15+
最近のLaTeXではLaTeX3 Programming Language（expl3）がデフォルトで利用可能になっています（この機能は、かつては`expl3`パッケージとして提供されていました）。[expl3インターフェースの解説文書](https://texdoc.org/pkg/interface3)（`texdoc interface3`）や[expl3のソースコード解説文書](https://texdoc.org/pkg/source3)（`texdoc source3`）も`texdoc`で開くことができます。

0 commit comments

Comments
 (0)