質問のしかた †
TeX や LaTeX に関してわからないことがあれば TeX フォーラムで質問することができます.ただし、常勤の回答担当者がいるわけではなくボランティアによる回答ですから、質問内容が不明瞭だったりすると回答がつかなかったりすることもあります。うまく質問内容を伝えて的確な回答をもらうためにも、質問する前にまずはこのページを読んでみて下さい.これとは反対に、回答する人のための心得は回答のしかたにあります.
TeX フォーラムに限らず、インターネット上で技術的な質問をするときの一般的な注意点をまとめた次の文書もよく知られています:技術系メーリングリストで質問するときのパターン・ランゲージ(結城浩)
以下では,TeX に特化した,心得・参考文献・質問のノウハウをまとめます.
質問の前に(調査) †
- あまり一般的な質問をされる前に入門書(オンライン本でもかまいません)を1冊読んでみましょう.
- エラーメッセージを Google や DuckDuckGo などの検索窓にそのまま入力して検索するだけでもかなりの情報が得られます.
- よくある質問に先人たちが悩んだ問題とその解決策がまとめられています.
質問する場所 †
上記事項を試みてもエラーが解決しない場合,TeX についての質問は次のところでお願いします.個人宛のご質問はお避け下さい.
質問のしかた †
ご質問の際には,できるだけ詳しい情報をお知らせください.
エラーの場合のよくあるダメな質問の例:「○○がしたくて△△パッケージを試してみたのですが,エラーが出てうまくいきませんでした.どうすればよいでしょうか.」
これでは情報不足で答えようがありません.実行環境,問題が起きる完全な例,エラーメッセージの3点が最低限必要です.
- ソフトの種類や OS のバージョンを記載する
- TeX のシステムは多数のソフトウェアの組み合わせで成り立っています(TeX と「TeX 以外」を参照).どのソフトウェアでトラブルになるのか,わかる範囲でお書き下さい.
- 例: lualatex で file.pdf に変換できない
- 例: lualatex で file.tex を file.pdf に変換すると SumatraPDF 3.3.3 では SyncTeX が動作したが SumatraPDF 3.4.6 では SyncTeX が動作しない
- 例: lualatex の 64-bit バイナリを実行すると file.pdf が作成できるが lualatex の 32-bit バイナリで file.pdf を作成しようとすると「メモリが足りない」と言われる
- TeXシステムやOSのバージョンも重要です.(OSのバージョン確認方法 → Windows / macOS)
- 例: 『[改訂第9版]LaTeX美文書作成入門』の「A.2 Windowsへのインストールと設定」に従って TeX Live 2024 を Windows 11 Home 23H2 にインストールした
- 例: TeX Live 2024 のネットワークインストーラーを実行して Windows 11 Pro 23H2 にインストールした
- 例: MacTeX-2024 を macOS Sonoma 14.3.1 にインストールして sudo tlmgr update --self --all と sudo tlmgr paper a4 を実行した
- 例: texlive2024.iso を使用して Linux Mint 21.3 に TeX Live 2024 をインストールして sudo tlmgr update --self --all を実行後に texlive-dummy のページに従って texlive-local_2023.99999999-1_all.deb をインストールした
- 問題が再現できる完全な TeX ファイルと実行した手順.
- エラー (Error) の場合はエラーメッセージをログファイルからコピー & ペーストしてください.
- ログファイルのどこを抜き出してくるべきかがわからなければ,ログファイルの中身全部をコピー & ペーストしても構いません.或いは添付ファイルとして指定して下さい.
- エラーメッセージより前に警告 (Warning) が出ていた場合は,その警告も一緒にコピー & ペーストしてください.
- 警告に関する質問の場合も同様です.
- TeX ファイル やログファイルが大量にある場合は添付ファイルで提供して下さい.
- 当フォーラムは一投稿一添付ファイルとなっていますので,複数ある場合アーカイブして zip 等で圧縮したものを添付ファイルとして下さい.
- エラーではないが「何かおかしい」という場合には,意図していた(得たいと思っていた)結果と実際に得られた結果との相違について説明してください.
- 質問者自身の技術レベルがわかればそれに合わせ回答がしやすくなります.しかし、単に「初心者です」というだけでは、何についてどのくらいのレベルの初心者なのかわからず参考になりません。以下のように具体的に説明するとよいでしょう.
- [改訂第9版] LaTeX 美文書作成入門は通読しましたが,マクロ作成についてはまったく経験はありません
- 日常的に生徒向けのプリントを LaTeX で作成しています.
単純な省略記法マクロの定義くらいはできますが,
条件処理などを必要とすると手が出ません
- マウスによるボタンのクリックやメニューの選択といった操作に関しては,スクリーンショットを提示しながら説明すると良いでしょう.文字のみで正確に伝えるのは難しいです.(苦労している例.)
質問した後(返答・整理) †
質問を行ったのちに何らかの応答が得られた場合,その応答に対する返答では
- その応答で挙げられている対処法を文字通りに行い,
(成功・不成功にかかわらず)その結果を示す
- 実行結果は,不成功時には新たな質問を行う際の状況説明の一部となりますし,成功時には他の参加者やあとから検索などで調べる人への情報提供となります
- 情報の提供を求められている場合には,求められた情報を提示する
(その際「求められた情報が問題の解決に必要があるか否か」
の判断を質問者側で勝手に下さないでください)
- 応答の内容に理解できない点がある場合,あるいは,提示された対処法では
うまくいかないといった理由により新たな質問が生じた場合には,
新規の質問の場合に準じて状況および(新たな)疑問点を明らかにする
ように注意してください.特に,
情報の提示を求められているにもかかわらず然るべき情報を提示しないようであれば,
「回答を得る意思なし」とみなされても文句は言えません.
解決したときには,原因や解決策を報告しておけば,後に検索などでやってきた人のためになります.
Last-modified: 2024-03-09 (土) 19:33:23 (19d)