ja.README.md

ReXeTeXeR

マジでかっこいいロゴ

これはなに

動作イメージ(スクショは開発中のもの)

日本語の.tex(UTF-8)をTeXの環境構築なしに、XeTeX(xelatex)を使って.pdfに変換するやつです。 勝手にReXeTeXeRと名前をつけましたpBibTeXによるReferenceの自動生成に対応してます。

派生

• 津山高専版: ReXeTeXeR-tsuyama

環境

DockerかPodmanが必須です。それ以外はオプショナルです。

• Docker or Podman(どちらか1つ)
• GNU Make
• テキストエディタ
• 自動リロードできるPDFビューワー

使い方

0. 準備

releaseから最新版をダウンロードしてください。 .zipを作業ディレクトリに展開してください。 すると、以下のようになるはずです。

.
├── LICENSE
├── Makefile
├── NotoSansJP-Regular.otf
├── NotoSerifJP-Regular.otf
├── README.md
├── RobotoMono.ttf
├── img
│   └── logo.png
├── ref.bib
├── report.pdf
├── report.tex
└── watch.sh

その後、以下のコマンドでReXeTeXeRをpullします。

$ make init

Podmanでの利用

この形でコマンドを実行することでDockerではなくPodmanが利用されます。

$ make podman.${TARGET}
# Example
$ make podman.init # Run `make init` with Podman

1. 起動

$ make run

2. 接続

$ make exec

これでコンテナに入れます。 以降のコマンドは特に記載がなければコンテナ内で実行するコマンドです。

3. 自動コンパイルスクリプトを起動

$ make watch

一度だけコンパイルしたいときは

$ make tex

4. TeXを書く

./report.texを編集することで、PDFが錬成されます。 XeTeX(XeLaTeX)です。 画像、引用等については、test/report.texを参照してください。

5. PDFを見る

リソースのオートリロードに対応したPDFビューワーを使ってreport.pdfを開くと、ほぼリアルタイムにプレビューされます。

6. その他

VS CodeのAuto Saveとの相性が悪いこともある

ファイルの変更を察知してコンパイルが走るので、VS CodeなどのAuto Saveで文法が完成していない.texファイルがコンパイルされることがあります。 .vscodeにこのワークスペースのみ、Auto SaveがonFocusChangeになるよう設定すると解消できます。

リソースのオートリロードに対応したPDFビューワー

• macOS: Skim
• windows10: Sumatra PDF
• Linux: Evince

止めるときは

コンテナから出て($ exit)、以下のコマンドで止められます。

$ make stop

再度起動する場合は$ make runではなく$ make startしてください。

コンテナを削除する場合は、以下のコマンドを使用してください。(イメージは削除されないので安心)

$ make rm

イメージを削除する場合は$ make rmiです。

thx

• junsrt.bst: http://mirror.las.iastate.edu/tex-archive/biblio/pbibtex/base/junsrt.bst
• BXjscls: https://github.com/zr-tex8r/BXjscls

もしよければ:bow: