[[TeXworks]] > 使い方
----
#contents
----
*使い方 [#b6337083]
**タイプセット [#h5dac63f]
エディタのウィンドウ左上にある緑の &color(#8AE234){▶};
ボタンで表示されているタイプセットのアイコンをクリック，または Ctrl+T (Mac では ⌘T (command+T)) を入力すると
TeX ファイルがコンパイルされ，エラーがなければ PDF ファイルが表示されます．
エラーが発生した場合は，間違っている箇所を修正してもう一度タイプセットをしてください．
&color(#8AE234){▶}; ボタンの右にあるドロップダウンリストからタイプセットに使う
エンジンの指定ができます．例えば “upLaTeX (ptex2pdf)” を選択すれば uplatex + dvipdfmx で
タイプセットされます．
よくある質問として
[[“! LaTeX Error: This file needs format `pLaTeX2e' but this is `LaTeX2e'.” というエラーが出る>よくある質問#cb7a8a28]]というものがありますが，
原因はこのエンジンの指定が正しくないためです．
pdflatex などしか見つからない場合は，[[TeXworks/設定]]を参照のうえ，
自分で日本語を扱えるエンジンの設定を追加する必要があります．
**エラー箇所にジャンプ [#cfcb69f9]
エラーが発生した場合に e を入力して Enter キーを入力するとエラー箇所にジャンプします．
''注意: macOS の TeXworks は現時点 (TeXworks 0.6.8) では，エラー箇所にジャンプする機能はサポートされていません．''
''注意: macOS の TeXworks は現時点 (TeXworks 0.6.9) では，エラー箇所にジャンプする機能はサポートされていません．''
-https://github.com/TeXworks/texworks/blob/release-0.6.8/src/Engine.cpp#L125-L131
-https://github.com/TeXworks/texworks/blob/release-0.6.9/src/Engine.cpp#L125-L131
-[[Support the TEXEDIT environment variable · Issue #195 · TeXworks/texworks · GitHub:https://github.com/TeXworks/texworks/issues/195]]
**補完 [#a494cf9a]
TeXworks にはコマンドの補完機能があります．一部を入力して Tab キーを押すと候補が表示されます．Tab キーを押しても候補が表示されない場合は[[TeXworksの補完が起動しない>forum:2864]]を参照して設定を行ってください．
-\ (バックスラッシュ) から始まるキーワードの一部を入力した後 Tab キーを入力するとキーワードの補完を行います．
-\alpha などは xa と入力した後 Tab キーを入力する方法で補完を行います．
bite と入力した後 Tab キーを入力すると
\begin{itemize}
\item
\end{itemize}•
と補完されます．
\end{itemize}• のように "•" (placeholder) が表示され，Ctrl+Tab (Mac では ⌥Tab (option+Tab)) を入力すると "•" にジャンプします．
このデフォルトの補完の仕方が気に入らない場合は TeXworks の completion フォルダーの tw-latex.txt の
bite:=\begin{itemize}#RET#\item#RET##INS##RET#\end{itemize}•
を例えば
bite:=\begin{itemize}#RET# \item #INS##RET#\end{itemize}•
に修正します．
-[[[texworks] Completion changes...:http://tug.org/pipermail/texworks/2008q4/000417.html]]
W32TeX では補完対象となるコマンドのリストは
$INSTALLDIR\share\texworks\twdata\completion
の中にテキストファイルで保存されています．
このファイルを編集してカスタマイズすることが可能です．
-[[CodeCompletion:https://github.com/TeXworks/texworks/wiki/CodeCompletion]]
-[[TeXworksでautocomplete:http://qiita.com/matyapiro31/items/338b1293fddb6b922479]]
も参照してください．
**forward and inverse search [#ded2619d]
TeXworks は [[SyncTeX]] をサポートしています．
-forward search は エディタ上で Ctrl+左クリック または 右クリック → PDFの該当箇所へジャンプ
-inverse search は PDF ビューア上で Ctrl+左クリック または 右クリック → ソースの該当箇所へジャンプ
[ウィンドウ] > [マウスフォーカスを追従する] を ON にすると，エディタ上をクリックしたときに PDF ビューアを自動的に forward search します．
**構文の色付け [#p53d7e6e]
[フォーマット] > [構文の色付け] > [LaTeX] を選択します．
**自動インデント [#f7198d43]
[フォーマット] > [自動インデント] から
-なし
-Whitespace only
-TeX Comments
-dtx prefixes
のうちのどれかを選択します．
**スペルチェック [#cb9bbbb2]
スペルが間違っていると思われる単語の下に赤い点線が表示されます．
日本語の文章を作成するときなど，この機能を無効にしたい場合は [編集] > [スペルチェック] > [なし] を選択します．
スペルチェックが働かない場合は，辞書が設定されていない可能性があります．
[[TeXworks/設定#スペルチェックの辞書の設定>TeXworks/設定#vd0f0d24]]を参照してください．
**ルートドキュメント [#x9e02ec7]
例えばファイルの先頭に
% !TEX root = main.tex
を記述すると main.tex をルートドキュメントに設定してタイプセットの対象ファイルにしてくれます．
[[Defining a root file:https://github.com/TeXworks/texworks/wiki/TipsAndTricks]] も参照してください．
**TeX エンジンの自動選択 [#ca3d17a8]
例えばファイルの先頭に TeX のコメント文字列として
% !TEX program = LuaLaTeX
と記述しておくと、タイプセットのときに使用するエンジンとして LuaLaTeX を選んでくれます．
**指定したエンコーディングで再読み込み [#of3f4176]
TeXworks のエディタの画面の一番下にあるステータスバーのエンコーディングが表示されている部分をクリックすると，エンコーディングのリストが表示されます．
一番上の 『選択した文字コードで再読み込みする』 をクリックすると，指定したエンコーディングで再読み込みを行います．
**目次・PDFの情報・フォントの表示 [#ldabe964]
TeXworks の PDF ビューアの [ウィンドウ] > [表示] から目次・PDFの情報・フォントを表示することができます．
**TeXworks を PDF ファイルプレビューアとして使用する [#s646d4ef]
TeXworks はコマンドラインで PDF ファイルを指定すると PDF ビューアが起動します．
texworks "file.pdf"
この機能を使うと PDF ファイルプレビューアとしても利用できます．
自動更新もしてくれます．
SyncTeX を使用して forward search をすることも可能です．
例えば，TeX ファイルの 30 行目に対応する PDF ファイルの該当するページにジャンプしたい場合は
synctex view -i "30:0:file.tex" -o "file.pdf" -x "texworks --position=%{page+1} '%{output}'"
のように実行します．
--position= オプションで指定された値は，コマンドラインオプションで TeX ファイルが指定された場合は行番号，PDF ファイルが指定された場合はページ番号になるようです．
