TexLive+Atom
をテンプレートにして作成
[
トップ
|
新規
|
一覧
|
検索
|
最終更新
|
ヘルプ
]
開始行:
-----
#contents
-----
*TexLive + AtomでTeX [#s4956a3d]
Windows環境でTexLiveを用いてTeXをインストールして，Atomで...
**Tex Liveのインストール [#b37dee81]
TeXは様々なファイルの集合体で構成されます．これを全部自分...
Windowsでのインストールではネットワークインストーラを使う...
***ネットワークインストーラによるTeX Liveのインストール [...
[[こちらのWebページ:https://www.tug.org/texlive/acquire-n...
-全ユーザにインストールする場合は「管理者として実行」する...
-特にカスタマイズが必要なければ最初の選択肢は「Simple ins...
-インストール先などを変更したい場合は，install-tl-advance...
-インストールには1〜2時間ぐらいかかるので注意
デフォルトでは
C:\texlive
にインストールされて，環境変数PATHに以下のパスが追加され...
C:\texlive\2016\win32
2016の部分はインストールしたバージョンによって変わります．
環境変数に追加されていない場合は手動で追加する(コントロー...
PATHに追加されていることを確認したら一度再起動orログイン...
***ISOイメージによるインストール [#tc96f258]
[[こちらのWebページ:http://www.tug.org/texlive/acquire-is...
**Atomのインストールと設定 [#h2ec3989]
Atomはオープンソースのエディタで，FirefoxやChomeの拡張機...
***Atomのインストール [#x27345de]
[[公式サイト:https://atom.io/]]からインストーラ(AtomSetup...
[[Chocolatey:https://chocolatey.org/]]を導入してあるなら...
cinst -y atom
***Atomの設定 [#if39cf93]
TeX関連のパッケージをインストールしておきます．
パッケージはAtomを開いて，メニューのFile->Settingから設定...
"Search packages"のところにパッケージ名を入力して検索し，...
以下はTeX関連のパッケージです．TeXを使うならばなるべく入...
-latex : LaTeXビルドをAtomからできるように
-language-latex : LaTeXの構文強調表示(syntax highlighting)
-latexer : LaTeX用のオートコンプリート機能を追加
-pdf-view : Atom上にLaTeXの結果のPDFを表示する．外部PDFビ...
#ref(atom_package_install.jpg,,80%)
**Latexmkの設定 [#q7c1d32a]
日本語のTeXファイルからPDFを作成・表示するまでには一般的...
+platexで.texから参照情報ファイル(.aux)作成(1回目)
+pbibtexで.bibと.auxから文献情報をまとめた.bblファイルを...
+platexで.texと.bblから文献リストを生成(2回目)
+platexで参照情報を反映した.dviファイル作成(3回目)
+dvipdfmxで.dviから.pdfを作成
+PDFファイルをビューワで開く
と長い手順を踏む必要があります．
Makefileを作ったり，エディタ側でマクロを作成してもよいの...
ここではこの手順を自動化してくれる[[latexmk:http://person...
を使ってみましょう．
***Perl環境のインストール [#dd34d77e]
Latexmkを使うにはPerlインタプリタが必要です．
Perl環境はWindowsなら[[StrawberryPerl:http://strawberrype...
Chocolateyが導入してあるならば，
cinst -y strawberryperl
を実行すればOK．
***Latexmkのインストールと設定ファイル [#ob7a93f9]
LatexmkはTeX Liveはもちろん，ほとんどのTeXディストリビュ...
latexmk -help
TeX Liveをインストールしたのに上記コマンドでそんなコマン...
"Script interpreter is not found in PATH"というメッセージ...
Latexmkの設定はホームフォルダに置いた.latexmkrcファイルに...
Windowsだとホームフォルダは%USERPROFILE%(C:\User\{ユーザ...
#!/usr/bin/perl
# commands for latex,bibtex,dvipdf. %S : source file, %B...
$latex = 'platex %O -interaction=nonstopmode -sy...
$bibtex = 'pbibtex %O %B -kanji=utf8';
$dvipdf = 'dvipdfmx %O -o %D %S';
# method to make pdf - 0:not making, 1:pdflatex, 2:ps2pd...
$pdf_mode = 3;
# simply open by SumatraPDF
$pdf_previewer = '"C:\Program Files\SumatraPDF\SumatraPD...
platexのオプションには，
-エラーが発生しても途中で止めない(-interaction=nonstopmode)
-外部ビューワとTeXファイルの相互ジャンプを可能にするため...
-日本語文字コードはUTF8(-kanji=utf8)
を指定しています．
そのほかの各命令の指定方法はコメントを参照してください．
上記ではPDFビューワに[[SumatraPDF:http://www.sumatrapdfre...
設定をTeXドキュメント毎に分けたい場合は，ホームフォルダに...
***Latexmkの使い方 [#s8f02e48]
基本的にはコマンドプロンプトでtexファイルのあるフォルダに...
latexmk
と打てば，フォルダ内のtexファイルに対して実行されます．
texファイルを指定する場合は，
latexmk test.tex
とします．
ビルド後にビューワでpdfファイルを開く場合は，
latexmk -pv test.tex
とします(この場合，対象となるtexファイルは1つのみになるよ...
texファイルを常に監視して，更新されたら自動的に再コンパイ...
latexmk -pvc test.tex
とします(注:もし設定ファイルで"-interaction=nonstopmode"...
***Atomとの連携設定 [#m3bfa36d]
AtomのlatexパッケージからLatexmkを読んで，PDFファイルを外...
まず，latexパッケージを設定のInstallから検索してインスト...
次に，latexmkの設定を変えるために，
%USERPROFILE%\.atom\packages\latex\lib\builders\latexmk.js
をエディタで開き，29行目あたりの constructArgs のところを...
constructArgs (filePath, jobname) {
const outputFormat = atom.config.get('latex.outputFo...
const args = [
'-e',
'"$latex=\'platex %O -interaction=nonstopmode -syn...
'-e',
'"$bibtex=\'pbibtex %O %B -kanji=utf8\'"',
'-e',
'"$dvipdf=\'dvipdfmx %O -o %D %S\'"',
'-e',
'"$pdf_mode=3"',
'-interaction=nonstopmode',
'-f',
'-cd',
'-norc',
'-gg',
'-pdfdvi',
]
次にSumatraPDFでのforward/inverse-searchを有効にするため...
%USERPROFILE%\.atom\packages\latex\lib\openers\sumatra-o...
を開き，7行目あたりの open 関数のオプション設定(const arg...
const args = [
'-reuse-instance',
'-inverse-search',
`"\\"${process.env.userprofile}\\AppData\\Local\\a...
'-forward-search',
`"${texPath}"`,
`"${lineNumber}"`,
`"${filePath.replace(/\.dvi$/, '.pdf')}"`
]
これによりPDFビューワ上で変更したいところをクリックすると...
SumatraPDFをビューワとして使う場合はAtomのFileメニューか...
%USERPROFILE%\.atom\config.cson
を開いて(Fileメニュー->Configで開ける)，以下の記述を追加...
latex:
alwaysOpenResultInAtom: false
sumatraPath: "C:\\Program Files\\SumatraPDF\\Sumatra...
外部ビューワを使う方法以外に内部ビューワを使う方法もあり...
内部ビューワでPDFを表示したい場合は，まず，pdf-viewパッケ...
上記のconfig.csonでalwaysOpenResultInAtomをtrueにしておき...
latex:
alwaysOpenResultInAtom: true
この設定はFileメニュー -> Settings -> Packages -> latex ...
"Always Open Result in Atom"項目でもON/OFFできます．
latexパッケージのデフォルトでは内部ビューワで開くファイル...
これをPDFに変える必要があります．下記のファイルを開きます．
%USERPROFILE%\.atom\packages\latex\lib\openers\atompdf-o...
25行目あたりの atom.workspace.open(... の部分を以下のよう...
// TODO: Make this configurable?
atom.workspace.open(filePath.replace(/\.dvi$/, '.pdf'...
(バージョンによって違うかもしれませんが，要はfilePath変数...
filePath.replace(/\.dvi$/, '.pdf')とすることで開くファイ...
変更したら念のためAtomを再起動しておきましょう．
**Atom上でのTeXコンパイル [#ofcfa38e]
これまでの設定をしてあるならば，TeXファイルをAtomで開いて...
Packageメニュー -> LaTeX -> BuildでビルドからPDF表示まで...
前節でforward searchを設定していたならば，PDFを表示した後...
ビルド中はステータスバーに"Compiling TeX file..."と表示さ...
もしエラーが出たら，"LaTeX compilation error"と赤字で表示...
このメッセージをクリックするとlogファイルを開いてくれるの...
("Error"や"LaTeX Error"で検索するとよい)．
***キーバインドの変更 [#ef1043e8]
個人的にデフォルトのCtrl+Alt+Bは打ちづらいのでキーバイン...
変更するためには，Fileメニュー -> Keymap(日本語だとキーマ...
'atom-text-editor[data-grammar~="latex"]':
'ctrl-space': 'latex:build'
キーバインドは Fileメニュー -> Setting -> Keybindings で...
対応するキーの左側のアイコン(下図参照)をクリックすると上...
それをkeymap.csonに貼り付けて，キー設定を変えることができ...
#ref(atom_keybinding.jpg,,80%)
ただし，latexパッケージのものについては標準では1行目が
'atom-text-editor[data-grammar~='latex']':
となっており，シングルクォーテーションが入れ子になってい...
そのため，'latex'部分をダブルクォーテーションに変えていま...
ちなみにkeybinding-resolverパッケージが入っているならば，...
下図のように何に割り当てられているのかを確認することもで...
#ref(atom_keybinding_resolver.jpg,,80%)
*Atom TIPS [#q0a2659a]
**TeX関連以外で便利そうなパッケージ [#xd264ba2]
-auto-encoding : Atomの文字コードの自動選択機能はファイル...
-autocomplete-paths : ファイルパスのオートコンプリート
-japanese-menu : メニューと設定画面を日本語化
-minimap : ウィンドウ右側にテキスト全体のプレビュー(ミニ...
-minimap-autohide : ↑のミニマップを使わないときは自動的に...
-sublime-style-column-selection : Altキーを押しながらドラ...
-multi-cursor : AtomではCtrlを押しながらクリックで入力カ...
'atom-workspace atom-text-editor:not([mini])':
'alt-shift-right': 'core:select-right'
'alt-shift-left': 'core:select-left'
'.platform-win32 atom-text-editor:not(mini)':
'alt-shift-up': 'multi-cursor:expandUp'
'alt-shift-down': 'multi-cursor:expandDown'
-sync-settings : Atomの設定を複数PCで同期orバックアップ．...
++sync-settingパッケージをapmかSetting->Installからインス...
++https://github.com/settings/tokens/new からgithubアクセ...
++https://gist.github.com/ にアクセスして新しいgistを生成...
++作成したgistのURLのid部分をコピーしておく (https://gist...
++sync-settingの設定でtokenとgistを入力
-convert-to-utf8 : テキストファイルの文字コードを変換．パ...
-editorconfig : 文章のスタイルを統一するための[[EditorCon...
ちなみに私が使っている.editorconfigファイルの設定は以下．
root = true
[*]
end_of_line = crlf
charset = utf-8
indent_style = tab
indent_size = 4
trim_trailing_whitespace = false
insert_final_newline = false
[*.{c,cpp,tex}]
trim_trailing_whitespace = true
insert_final_newline = true
[*.tex]
indent_style = space
indent_size = 2
-sort-lines : 選択した複数行のテキストをアルファベット順...
-color-picker : RGBやweb用の16進,HSVなどの色を取得するカ...
-tabs-to-spaces : タブをスペースに変換(Untabify)およびそ...
-term3 : ターミナルを呼び出してくれる．同様のパッケージに...
**Windowsでの関連づけ [#n5f4669b]
Atomのexeへのパスは，
%USERPROFILE%\AppData\Local\atom\app-1.10.1\atom.exe
です(%USERPROFILE%の部分はC:\Users\{ユーザ名}など環境によ...
このパスのapp-1.10.1の部分がバージョンによって変わってし...
これに対応するために，
%USERPROFILE%\AppData\Local\atom\bin\atom.cmd
というバッチファイルが用意されているのでこちらにファイル...
ファイルアイコンが気に入らない場合は，フリーソフトの「[[D...
Atomのアイコンは，
%USERPROFILE%\AppData\Local\atom\app.ico
にあります．
終了行:
-----
#contents
-----
*TexLive + AtomでTeX [#s4956a3d]
Windows環境でTexLiveを用いてTeXをインストールして，Atomで...
**Tex Liveのインストール [#b37dee81]
TeXは様々なファイルの集合体で構成されます．これを全部自分...
Windowsでのインストールではネットワークインストーラを使う...
***ネットワークインストーラによるTeX Liveのインストール [...
[[こちらのWebページ:https://www.tug.org/texlive/acquire-n...
-全ユーザにインストールする場合は「管理者として実行」する...
-特にカスタマイズが必要なければ最初の選択肢は「Simple ins...
-インストール先などを変更したい場合は，install-tl-advance...
-インストールには1〜2時間ぐらいかかるので注意
デフォルトでは
C:\texlive
にインストールされて，環境変数PATHに以下のパスが追加され...
C:\texlive\2016\win32
2016の部分はインストールしたバージョンによって変わります．
環境変数に追加されていない場合は手動で追加する(コントロー...
PATHに追加されていることを確認したら一度再起動orログイン...
***ISOイメージによるインストール [#tc96f258]
[[こちらのWebページ:http://www.tug.org/texlive/acquire-is...
**Atomのインストールと設定 [#h2ec3989]
Atomはオープンソースのエディタで，FirefoxやChomeの拡張機...
***Atomのインストール [#x27345de]
[[公式サイト:https://atom.io/]]からインストーラ(AtomSetup...
[[Chocolatey:https://chocolatey.org/]]を導入してあるなら...
cinst -y atom
***Atomの設定 [#if39cf93]
TeX関連のパッケージをインストールしておきます．
パッケージはAtomを開いて，メニューのFile->Settingから設定...
"Search packages"のところにパッケージ名を入力して検索し，...
以下はTeX関連のパッケージです．TeXを使うならばなるべく入...
-latex : LaTeXビルドをAtomからできるように
-language-latex : LaTeXの構文強調表示(syntax highlighting)
-latexer : LaTeX用のオートコンプリート機能を追加
-pdf-view : Atom上にLaTeXの結果のPDFを表示する．外部PDFビ...
#ref(atom_package_install.jpg,,80%)
**Latexmkの設定 [#q7c1d32a]
日本語のTeXファイルからPDFを作成・表示するまでには一般的...
+platexで.texから参照情報ファイル(.aux)作成(1回目)
+pbibtexで.bibと.auxから文献情報をまとめた.bblファイルを...
+platexで.texと.bblから文献リストを生成(2回目)
+platexで参照情報を反映した.dviファイル作成(3回目)
+dvipdfmxで.dviから.pdfを作成
+PDFファイルをビューワで開く
と長い手順を踏む必要があります．
Makefileを作ったり，エディタ側でマクロを作成してもよいの...
ここではこの手順を自動化してくれる[[latexmk:http://person...
を使ってみましょう．
***Perl環境のインストール [#dd34d77e]
Latexmkを使うにはPerlインタプリタが必要です．
Perl環境はWindowsなら[[StrawberryPerl:http://strawberrype...
Chocolateyが導入してあるならば，
cinst -y strawberryperl
を実行すればOK．
***Latexmkのインストールと設定ファイル [#ob7a93f9]
LatexmkはTeX Liveはもちろん，ほとんどのTeXディストリビュ...
latexmk -help
TeX Liveをインストールしたのに上記コマンドでそんなコマン...
"Script interpreter is not found in PATH"というメッセージ...
Latexmkの設定はホームフォルダに置いた.latexmkrcファイルに...
Windowsだとホームフォルダは%USERPROFILE%(C:\User\{ユーザ...
#!/usr/bin/perl
# commands for latex,bibtex,dvipdf. %S : source file, %B...
$latex = 'platex %O -interaction=nonstopmode -sy...
$bibtex = 'pbibtex %O %B -kanji=utf8';
$dvipdf = 'dvipdfmx %O -o %D %S';
# method to make pdf - 0:not making, 1:pdflatex, 2:ps2pd...
$pdf_mode = 3;
# simply open by SumatraPDF
$pdf_previewer = '"C:\Program Files\SumatraPDF\SumatraPD...
platexのオプションには，
-エラーが発生しても途中で止めない(-interaction=nonstopmode)
-外部ビューワとTeXファイルの相互ジャンプを可能にするため...
-日本語文字コードはUTF8(-kanji=utf8)
を指定しています．
そのほかの各命令の指定方法はコメントを参照してください．
上記ではPDFビューワに[[SumatraPDF:http://www.sumatrapdfre...
設定をTeXドキュメント毎に分けたい場合は，ホームフォルダに...
***Latexmkの使い方 [#s8f02e48]
基本的にはコマンドプロンプトでtexファイルのあるフォルダに...
latexmk
と打てば，フォルダ内のtexファイルに対して実行されます．
texファイルを指定する場合は，
latexmk test.tex
とします．
ビルド後にビューワでpdfファイルを開く場合は，
latexmk -pv test.tex
とします(この場合，対象となるtexファイルは1つのみになるよ...
texファイルを常に監視して，更新されたら自動的に再コンパイ...
latexmk -pvc test.tex
とします(注:もし設定ファイルで"-interaction=nonstopmode"...
***Atomとの連携設定 [#m3bfa36d]
AtomのlatexパッケージからLatexmkを読んで，PDFファイルを外...
まず，latexパッケージを設定のInstallから検索してインスト...
次に，latexmkの設定を変えるために，
%USERPROFILE%\.atom\packages\latex\lib\builders\latexmk.js
をエディタで開き，29行目あたりの constructArgs のところを...
constructArgs (filePath, jobname) {
const outputFormat = atom.config.get('latex.outputFo...
const args = [
'-e',
'"$latex=\'platex %O -interaction=nonstopmode -syn...
'-e',
'"$bibtex=\'pbibtex %O %B -kanji=utf8\'"',
'-e',
'"$dvipdf=\'dvipdfmx %O -o %D %S\'"',
'-e',
'"$pdf_mode=3"',
'-interaction=nonstopmode',
'-f',
'-cd',
'-norc',
'-gg',
'-pdfdvi',
]
次にSumatraPDFでのforward/inverse-searchを有効にするため...
%USERPROFILE%\.atom\packages\latex\lib\openers\sumatra-o...
を開き，7行目あたりの open 関数のオプション設定(const arg...
const args = [
'-reuse-instance',
'-inverse-search',
`"\\"${process.env.userprofile}\\AppData\\Local\\a...
'-forward-search',
`"${texPath}"`,
`"${lineNumber}"`,
`"${filePath.replace(/\.dvi$/, '.pdf')}"`
]
これによりPDFビューワ上で変更したいところをクリックすると...
SumatraPDFをビューワとして使う場合はAtomのFileメニューか...
%USERPROFILE%\.atom\config.cson
を開いて(Fileメニュー->Configで開ける)，以下の記述を追加...
latex:
alwaysOpenResultInAtom: false
sumatraPath: "C:\\Program Files\\SumatraPDF\\Sumatra...
外部ビューワを使う方法以外に内部ビューワを使う方法もあり...
内部ビューワでPDFを表示したい場合は，まず，pdf-viewパッケ...
上記のconfig.csonでalwaysOpenResultInAtomをtrueにしておき...
latex:
alwaysOpenResultInAtom: true
この設定はFileメニュー -> Settings -> Packages -> latex ...
"Always Open Result in Atom"項目でもON/OFFできます．
latexパッケージのデフォルトでは内部ビューワで開くファイル...
これをPDFに変える必要があります．下記のファイルを開きます．
%USERPROFILE%\.atom\packages\latex\lib\openers\atompdf-o...
25行目あたりの atom.workspace.open(... の部分を以下のよう...
// TODO: Make this configurable?
atom.workspace.open(filePath.replace(/\.dvi$/, '.pdf'...
(バージョンによって違うかもしれませんが，要はfilePath変数...
filePath.replace(/\.dvi$/, '.pdf')とすることで開くファイ...
変更したら念のためAtomを再起動しておきましょう．
**Atom上でのTeXコンパイル [#ofcfa38e]
これまでの設定をしてあるならば，TeXファイルをAtomで開いて...
Packageメニュー -> LaTeX -> BuildでビルドからPDF表示まで...
前節でforward searchを設定していたならば，PDFを表示した後...
ビルド中はステータスバーに"Compiling TeX file..."と表示さ...
もしエラーが出たら，"LaTeX compilation error"と赤字で表示...
このメッセージをクリックするとlogファイルを開いてくれるの...
("Error"や"LaTeX Error"で検索するとよい)．
***キーバインドの変更 [#ef1043e8]
個人的にデフォルトのCtrl+Alt+Bは打ちづらいのでキーバイン...
変更するためには，Fileメニュー -> Keymap(日本語だとキーマ...
'atom-text-editor[data-grammar~="latex"]':
'ctrl-space': 'latex:build'
キーバインドは Fileメニュー -> Setting -> Keybindings で...
対応するキーの左側のアイコン(下図参照)をクリックすると上...
それをkeymap.csonに貼り付けて，キー設定を変えることができ...
#ref(atom_keybinding.jpg,,80%)
ただし，latexパッケージのものについては標準では1行目が
'atom-text-editor[data-grammar~='latex']':
となっており，シングルクォーテーションが入れ子になってい...
そのため，'latex'部分をダブルクォーテーションに変えていま...
ちなみにkeybinding-resolverパッケージが入っているならば，...
下図のように何に割り当てられているのかを確認することもで...
#ref(atom_keybinding_resolver.jpg,,80%)
*Atom TIPS [#q0a2659a]
**TeX関連以外で便利そうなパッケージ [#xd264ba2]
-auto-encoding : Atomの文字コードの自動選択機能はファイル...
-autocomplete-paths : ファイルパスのオートコンプリート
-japanese-menu : メニューと設定画面を日本語化
-minimap : ウィンドウ右側にテキスト全体のプレビュー(ミニ...
-minimap-autohide : ↑のミニマップを使わないときは自動的に...
-sublime-style-column-selection : Altキーを押しながらドラ...
-multi-cursor : AtomではCtrlを押しながらクリックで入力カ...
'atom-workspace atom-text-editor:not([mini])':
'alt-shift-right': 'core:select-right'
'alt-shift-left': 'core:select-left'
'.platform-win32 atom-text-editor:not(mini)':
'alt-shift-up': 'multi-cursor:expandUp'
'alt-shift-down': 'multi-cursor:expandDown'
-sync-settings : Atomの設定を複数PCで同期orバックアップ．...
++sync-settingパッケージをapmかSetting->Installからインス...
++https://github.com/settings/tokens/new からgithubアクセ...
++https://gist.github.com/ にアクセスして新しいgistを生成...
++作成したgistのURLのid部分をコピーしておく (https://gist...
++sync-settingの設定でtokenとgistを入力
-convert-to-utf8 : テキストファイルの文字コードを変換．パ...
-editorconfig : 文章のスタイルを統一するための[[EditorCon...
ちなみに私が使っている.editorconfigファイルの設定は以下．
root = true
[*]
end_of_line = crlf
charset = utf-8
indent_style = tab
indent_size = 4
trim_trailing_whitespace = false
insert_final_newline = false
[*.{c,cpp,tex}]
trim_trailing_whitespace = true
insert_final_newline = true
[*.tex]
indent_style = space
indent_size = 2
-sort-lines : 選択した複数行のテキストをアルファベット順...
-color-picker : RGBやweb用の16進,HSVなどの色を取得するカ...
-tabs-to-spaces : タブをスペースに変換(Untabify)およびそ...
-term3 : ターミナルを呼び出してくれる．同様のパッケージに...
**Windowsでの関連づけ [#n5f4669b]
Atomのexeへのパスは，
%USERPROFILE%\AppData\Local\atom\app-1.10.1\atom.exe
です(%USERPROFILE%の部分はC:\Users\{ユーザ名}など環境によ...
このパスのapp-1.10.1の部分がバージョンによって変わってし...
これに対応するために，
%USERPROFILE%\AppData\Local\atom\bin\atom.cmd
というバッチファイルが用意されているのでこちらにファイル...
ファイルアイコンが気に入らない場合は，フリーソフトの「[[D...
Atomのアイコンは，
%USERPROFILE%\AppData\Local\atom\app.ico
にあります．
ページ名:
![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
