List of Tex [text.Baldanders.info]

ちょこっと MathJax 番外編： V4 へのアップグレード

2025-09-01T08:55:24+00:00

先月の話だが MathJax の v4 がリリースされていた。

MathJax v4.0.0 now available | MathJax

主な内容は以下の通り：

Extended font support (11 new fonts)

A new default font with much greater character coverage.

Line-breaking support (for in-line as well as displayed equations)

An updated expression explorer that is now on by default.

Separation of speech generation into a webworker thread for better performance.

Support for HTML embedded in TeX and MathML expressions.

Availability as ES6 modules as well as CommonJS modules.

New TeX extensions, including the begingroup extension from v2 (with more features), and several font-related extensions.

Inclusion of the textmacros extension in all combined component files.

Updated mathtools package to include the changes from 2022 and 2024.

Improvements in the baseline alignment of text in CHTML output in WebKit-based browsers.

Improved stretchy delimiters in CHTML output.

More promise-based conversion and typesetting calls at the document level.

via MathJax v4.0.0 now available

本来なら Release セクションに書くべきなんだろうけど，今回は「ちょこっと MathJax」シリーズの番外編として主にアップグレード時の注意点をいくつか記しておく。といっても v3 から v4 へのアップグレードで考慮すべき点は多くない。詳しくは以下を参照のこと：

Upgrading from v3 to v4 — MathJax 4.0 documentation

URL に注意

v4 では CDN の URL は以下の通りになっている。

<script defer src="https://cdn.jsdelivr.net/npm/mathjax@4/tex-mml-chtml.js"></script>

v4 は ES6 モジュールとして実装されているため，パスから es5 が除かれている。あと async から defer に変わっている。 id 指定もなくなってるな。

バージョンを厳密に指示したい場合は

<script defer src="https://cdn.jsdelivr.net/npm/mathjax@4.0.0/tex-mml-chtml.js"></script>

といった感じに指定する。

利用可能なコンポーネントは以下の通り。

Component	Input	Output
`tex-chtml`	TeX	CHTML
`tex-svg`	TeX	SVG
`tex-mml-chtml`	TeX, MathML	CHTML
`tex-mml-svg`	TeX, MathML	SVG
`mml-chtml`	MathML	CHTML
`mml-svg`	MathML	SVG
`tex-chtml-nofont`	TeX	CHTML
`tex-svg-nofont`	TeX	SVG
`tex-mml-chtml-nofont`	TeX, MathML	CHTML
`tex-mml-svg-nofont`	TeX, MathML	SVG
`mml-chtml-nofont`	MathML	CHTML
`mml-svg-nofont`	MathML	SVG

v3 にあった -full 付きのコンポーネントはなくなった。その代わり autoload 拡張機能で必要な機能を自動的に読み込むため，通常は気にする必要はない¹。

利用可能なフォントが増えた

v4 では11種類のフォントが利用可能になった。

Font Name Original Source

mathjax-newcm Based on New Computer Modern (now the default font)

mathjax-asana A version of the Asana-Math font

mathjax-bonum A version of the Gyre Bonum font

mathjax-dejavu A version of the Gyre DejaVu font

mathjax-fira A version of the Fira and Fira-Math fonts

mathjax-modern A version of Latin-Modern

mathjax-pagella A version of the Gyre Pagella font

mathjax-schola A version of the Gyre Schola font

mathjax-stix2 A version of the STIX2 font

mathjax-termes A version of the Gyre Termes font

mathjax-tex The original MathJax TeX font

Font Name	Original Source
`mathjax-newcm`	Based on New Computer Modern (now the default font)
`mathjax-asana`	A version of the Asana-Math font
`mathjax-bonum`	A version of the Gyre Bonum font
`mathjax-dejavu`	A version of the Gyre DejaVu font
`mathjax-fira`	A version of the Fira and Fira-Math fonts
`mathjax-modern`	A version of Latin-Modern
`mathjax-pagella`	A version of the Gyre Pagella font
`mathjax-schola`	A version of the Gyre Schola font
`mathjax-stix2`	A version of the STIX2 font
`mathjax-termes`	A version of the Gyre Termes font
`mathjax-tex`	The original MathJax TeX font

via MathJax Font Support — MathJax 4.0 documentation

このうち mathjax-newcm については前節でが付いているコンポーネントに含まれている。 mathjax-newcm 以外のフォントを利用したい場合は -nofont が付いているコンポーネントを指定した上で，以下のように設定する。

<script>
MathJax = {
  output: {
    font: 'mathjax-stix2'
  }
};
</script>
<script defer src="https://cdn.jsdelivr.net/npm/mathjax@4/tex-mml-chtml-nofont.js"></script>

ちなみに mathjax-tex は v3 の既定フォントなので， v3 の環境に合わせたい場合はこれを指定する。

残念ながら，みんな大好き Euler フォントはない²。また複数のフォントを組み合わせることもできなさそうだ。

MathJax 設定例

設定例として，このブログサイトにおける設定を挙げておく（2025-09-01 時点）。

<script>
MathJax = {
  loader: {
    load: ['[tex]/ams', '[tex]/textcomp']
  },
  tex: {
    packages: {'[+]': ['ams', 'textcomp']},
    inlineMath: {'[+]': [['$', '$']]},
    tags: 'ams',
    macros: {
      ssqrt: ['\\sqrt{\\smash[b]{\\mathstrut #1}}', 1],
      tcdegree: ['\\unicode{xb0}'],
      tccelsius: ['\\unicode{x2103}'],
      tcperthousand: ['\\unicode{x2030}'],
      tcmu: ['\\unicode{x3bc}'],
      tcohm: ['\\unicode{x3a9}']
    }
  },
  chtml: {
    displayAlign: "left",
    displayIndent: "2em"
  },
  output: {
    font: 'mathjax-stix2'
  }
};
</script>
<script defer src="//cdn.jsdelivr.net/npm/mathjax@4/tex-chtml-nofont.js"></script>

参考図書

［改訂第9版］LaTeX美文書作成入門: 奥村晴彦 (著), 黒木裕介 (著); 技術評論社 2023-12-09 (Release 2023-12-09); 単行本（ソフトカバー）; 4297138891 (ASIN), 9784297138899 (EAN), 4297138891 (ISBN); 評価

[Comment] 2023年末に出てるのに気が付かなかった orz 今回は版元で PDF 版を買った。

reviewed by Spiegel on 2024-04-07 (powered by PA-APIv5)

ams, bbm, bboldx, begingroup, cases, centernot, colortbl, dsfont, empheq, mathtools, physics, require, setoptions, textcomp, textmacros, units, upgreek 各機能は autoload の対象にならない。新しく追加される拡張機能は autoload の対象にならない場合があるそうで，将来的に autoload が廃止される可能性もあるらしい。どうなるやら。 ↩︎
“Font Extensions” に Euler フォントの指定方法が書かれていたがサンプルのままでは上手く行かなかった。拡張用のフォントは自前で用意しろってことらしい。 ↩︎

Typst のお勉強を始めた

2025-02-27T10:07:40+00:00

先週の 2025-02-19 (現地時間) に Typst 0.13 がリリースされたニュースが Bluesky の私の TL に流れてきて「そういやそんなのあったな」と思い出した。

個人的に思う Typst 最大のメリットはシングルバイナリで提供されていて，それだけで PDF ファイルを生成できること。というわけで重い腰を上げて調べてみることにした。

Typst のお勉強

Typst 勉強用に久しぶりに新しいセクションを作った。いやぁ，やり方をすっかり忘れてたよ（笑）

Typst を触ってみた感想は，良くも悪くも「Markdown 以上 $\mathrm{\LaTeX}$ 未満」。

たとえば $\mathrm{\LaTeX}$ でガチの執筆をしている人には Typst はまだ力不足だと思う。逆に Markdown で満足している人には Typst は過剰スペックに見えるかもしれない。あと Typst 0.13 から HTML 形式へのエクスポート機能がサポートされたが，これはドキュメント要素を単純に HTML の要素に置き換えているだけみたいで，今のところスタイルの制御もない。将来バージョンはどうなるか分からないが，過剰な期待しないほうがいいだろう。とはいえ既存の CMS と組み合わせれば使い道があるかもしれない。

あくまで個人の意見だが，ドキュメントの作成・管理でもっとも重要なのは再利用しやすいか否かだと思う。その点，テンプレートを作りやすくレイアウトとデータの分離がしやすい（多分） Typst は向いていると思う。何より入力がテキストファイルなのは強い。さらに Typst フォント周りに気をつければマルチプラットフォームでいける（バイナリ自体はOSおよびアーキテクチャごとに提供されている）。

ところでこれは愚痴なのだが，そろそろ OS ごとに勝手なフォントが入ってる状況はどうにかならないのだろうか。たとえば Sans Serif なフォントとして Helvetica を使いたいとするじゃん。 macOS には昔からこれが標準で入ってるけど他の OS にはない。その代わりの代替フォントとして Windows なら Arial， Linux だと Liberation Sans があったりするが，名前が全然違う（デザインも微妙に違うけど）のでフォント指定が煩雑になる。日本語フォントだともっと酷いよね。

そりゃあ NOTO フォントを入れるとかすればプラットフォーム間で合わせられるよ。でも，そういう「インストール」自体がハードルが高いんだってば（自分が，じゃなくて，相手にそういうことをしてもらうのが）。 LibreOffce でもアプリケーション自体はマルチプラットフォーム対応なのに，フォント周りで地味に苦労してるんだよな。

少なくとも標準フォントに関してはプラットフォーム間で差異がないようにして欲しい。 NOTO フォントでもいいから。

愚痴はこのくらいにして…

既に個人的な書類送付状など定形書式で簡単なものなら Typst → PDF → 紙に印刷という流れができ始めた。次は議事録，その次はいよいよ設計書かなぁ。いずれ勤務先にそういう提案ができるところまで持っていきたいものである。音声の文字起こしとか生成 AI のおかげでだいぶ楽になってきたし Typst みたいな組版ツールと組み合わせれば面白そうなんだけど。

まだちゃんと調べてないが Typst には if/else とか for/while とか break/return とかの制御構造があり，更に JSON や YAML や CSV などのデータ・ファイルを読み込む機能もある（プレーンテキストも読める）。これらの機能を上手く使えばドキュメントのレイアウトやロジックとデータを分離することができそうである。今後はこの辺の制御を中心に調べる予定。もう少しゆっくりなペースでね。

参考文献

Typst完全入門: LaTeXより簡単、Markdownより強力、美しいドキュメント作成術: doitsu (著); 2024-12-08 (Release 2024-12-08); Kindle版; B0DPXBNTRS (ASIN); 評価

[Comment] マークアップ言語および組版ツールである Typst についての解説。 Kindle 版のみの提供。固定レイアウトではないためレイアウトが崩れまくって読みにくい。この手の技術解説書は固定レイアウトの Kindle 版か，いっそ PDF で出してほしい。でも Typst についてまとまった解説のある日本語の本は他に見当たらなかったのでありがたい。

reviewed by Spiegel on 2025-02-20 (powered by PA-APIv5)

［改訂第9版］LaTeX美文書作成入門: 奥村晴彦 (著), 黒木裕介 (著); 技術評論社 2023-12-09 (Release 2023-12-09); 単行本（ソフトカバー）; 4297138891 (ASIN), 9784297138899 (EAN), 4297138891 (ISBN); 評価

[Comment] 2023年末に出てるのに気が付かなかった orz 今回は版元で PDF 版を買った。

reviewed by Spiegel on 2024-04-07 (powered by PA-APIv5)

Typst の数式モード

2025-02-26T13:34:05+00:00

今回は今まで敢えて後回しにしていた数式モード（math mode）¹ の話。パッと見は $\mathrm{\LaTeX}$ 記法に似ているのだが色々と違っている。

LaTeX 記法とは似て非なる…

たとえば $\mathrm{\LaTeX}$ 記法では

エネルギーと質量には $E=mc^2$ の関係がある。

と書けば

エネルギーと質量には $E=mc^2$ の関係がある。

という感じに組版される。これをそのまま Typst で組版しようとすると

$ typst compile math.typ
error: unknown variable: mc
  ┌─ math.typ:1:14
  │
1 │ エネルギーと質量には $E=mc^2$ の関係がある。
  │                         ^^
  │
  = hint: if you meant to display multiple letters as is, try adding spaces between each letter: `m c`
  = hint: or if you meant to display this as text, try placing it in quotes: `"mc"`

てな感じで怒られる。どうも2つ以上の文字の綴りは何らかのシンボルと解釈されるらしい。たとえば $\mathrm{\LaTeX}$ 記法の以下の数式は

\[
  \left( \int_0^\infty \frac{\sin x}{\sqrt x} dx \right)^2 =
  \sum_{k=0}^\infty \frac{(2k)!}{2^{2k}(k!)^2} \frac{1}{2k+1} =
  \prod_{k=1}^\infty \frac{4k^2}{4k^2-1} =
  \frac{\pi}{2}
\]

『［改訂第9版］LaTeX美文書作成入門』p.221より

equation (STIX2 Math)

Typst 記法だと以下のようになる。

$
  (integral_0^infinity (sin x) / sqrt(x) dif x)^2 =
  sum_(k=0)^infinity (2k)! / (2^(2k) (k!)^2) 1 / (2k+1) =
  product_(k=1)^(infinity) (4k^2) / (4k^2-1) =
  pi / 2
$

equation by Typst (STIX2 Math)

$\mathrm{\LaTeX}$ 記法の { ... } に相当するものが Typst 記法だと ( ... ) になってるのが紛らわしい。おそらく文脈で判別してるんだろうけど。あとインライン数式も別行立て数式もいずれも $ ... $ なのも紛らわしい。こちらは $E=m c^2$ と $ E=m c^2 $ の違い。数式の前後に空白文字や改行が入ってると別行立て数式と認識するらしい。

これは $\mathrm{\LaTeX}$ 記法に慣れている人はちょっと大変かもしれない。 Pandoc には $\mathrm{\LaTeX}$ 記法 → Typst 記法への変換機能があるそうだが，そもそも Typst を使うような人はわざわざ Pandoc を導入しないと思う。

フォントの設定

数式モードのフォントを指定する場合は以下のように記述する。

#show math.equation: set text(font: "New Computer Modern Math")

既定は New Computer Modern Math。数式モード用のフォントには通常のフォントファイルは使えないので注意。

Note that only special OpenType math fonts are suitable for typesetting maths.

via Math fonts

試しに Euler フォントで試そうと思ったが，そういやこれってグリフが全部揃ってなかったわ。 STIX2 フォントのほうはこんな感じで上手くいった²。

#set text(font: (
  (
    name: "STIX Two Text",
    covers: "latin-in-cjk",
  ),
  "Noto Serif CJK JP"
), lang: "ja")
#show math.equation: set text(font: ("STIX Two Math"))

アルベルト・アインシュタインは1905年に発表した特殊相対性理論を通して以下の関係を導き出した。

$
  E = m c^2 "（エネルギーと質量の等価性）"
$

数式表現（STIX2 フォント）

ただし，上の例では数式モードに日本語が入った場合に問題が出る。どうも最初の #set text( ... ) のルール設定が数式モードでは適用されないみたいで

数式表現（STIX2 フォント）プロパティ

という感じで予期しないフォントが埋め込まれてしまった。

これを回避するには

#show math.equation: set text(font: ("New Computer Modern Math", "NOTO Serif CJK JP"))

などと指定する。これで New Computer Modern Math ＞ NOTO Serif CJK JP という優先順位でフォントを選択する。

数式表現（STIX2 フォント）プロパティ

ありゃ。 Medium フォントが選択されてる。なんで？うーん。とりあえずこれは置いておこう。

立体か斜体か

数式の場合は基本的にイタリック体または斜体で記述するのが原則だが，以下の例外がある。

数字はローマン体にする（$\mathit{3.14}$ ではなく $3.14$）

複数文字からなる名前はローマン体にする（$sin\,x$ ではなく $\sin x$）

単位記号はローマン体にする（$3\,m$ ではなく $3\,\mathrm{m}$）

『［改訂第9版］LaTeX美文書作成入門』p.94より

ただ立体（upright）か斜体（slant）³ かの規準は学会等によっても違うようで，たとえば積分等に出てくる dx とかでも斜体の $dx$ とするか立体の $\mathrm{d}x$ とするか流儀があるらしい。ちなみに Typst では積分の dx を立体で表現するために dif x と記述する。

$\mathrm{\LaTeX}$ には unicode-math パッケージというのがあって，数式の書体についてはこのパッケージである程度コントロールできる。詳しくは拙文「数式用フォントで遊ぶ」を参考にどうぞ。 Typst には unicode-math パッケージに相当するものはないっぽい？

Typst では $\sin$ などの一般的な演算子（関数）はあらかじめ定義されていて，これらは立体で表示される。

Typst predefines the operators arccos, arcsin, arctan, arg, cos, cosh, cot, coth, csc, csch, ctg, deg, det, dim, exp, gcd, lcm, hom, id, im, inf, ker, lg, lim, liminf, limsup, ln, log, max, min, mod, Pr, sec, sech, sin, sinc, sinh, sup, tan, tanh, tg and tr.

via Text Operator Function – Typst Documentation

この一覧にない演算子（関数）は自分で定義できる。

#set text(font: "Noto Serif CJK JP", lang: "ja")
#show math.equation: set text(font: "STIX Two Math")

#let GF = math.op("GF")

位数が $q$ である有限体を $GF(q)$ などと表記します。

カスタム演算子（関数）

他に $\int$ などのシンボルは “Symbols” のページまたは sym の項を参照のこと。ちなみに emoji も使える。

#show math.equation: set text(font: "STIX Two Math")

$
  sum_(k=0)^infinity #text(red)[#emoji.suit.heart]^k
$

数学ガールの秘密ノート

シンボルについては $\mathrm{\LaTeX}$ の physica パッケージに近い physica パッケージがあるらしい。

メートル（$\mathrm{m}$）などの単位も立体で表記する。単位等の表現については $\mathrm{\LaTeX}$ の siunitx パッケージに近い metro または unify パッケージを使う手がある。 unify のほうが活況？

\[
  1\,\mathrm{atm} = 1.01325\,\mathrm{bar} = 101,325\,\mathrm{Pa}
\]

\[ 1\,\mathrm{atm} = 1.01325\,\mathrm{bar} = 101,325\,\mathrm{Pa} \]

MathJax だと泥臭い記述になるのはご容赦（MathJax 用の動く siunitx パッケージはないっぽい）。

#import "@preview/unify:0.7.1": qty
#show math.equation: set text(font: "STIX Two Math")

$
  qty("1", "atm") = qty("1.01325", "bar") = qty("101,325", "Pa")
$

気圧単位の換算

同じような感じになったかな。単位表記は値と単位の間のアキを調整する必要があるが unify パッケージなら上手いことやってくれているようだ。

最終手段として，強制的に立体または斜体にする場合は upright または italic 関数を使う。

#show math.equation: set text(font: "STIX Two Math")

$
  upright("Upright, not Italic") \
  "normal string" \
  italic("Italic, not Upright") \
  bold("Bold") \
  italic(bold("Bold Italic")) \
$

立体と斜体

おー。ちゃんと（単なる斜体でない）イタリック体になるんだな。

番号付けと参照

数式の番号付けは equation の設定で行う。

#set text(font: "Noto Serif CJK JP", lang: "ja")
#set math.equation(numbering: "(1)")
#show math.equation: set text(font: "STIX Two Math")

エネルギーと質量には以下の関係がある。

$
  E = m c^2
$

番号付け

また数式には以下のように <label_name> でラベルを付けることができ @label_name で参照できる。

#set text(font: "Noto Serif CJK JP", lang: "ja")
#set math.equation(numbering: "(1)")
#show math.equation: set text(font: "STIX Two Math")

エネルギーと質量には@eq.1 の関係がある。

$
  E = m c^2
$ <eq.1>

ラベルと参照

ラベルはあくまでもマークアップモードでのみ付けることができるみたい。数式モードの中では付けられなかった。参照については後日に改めて扱うことにする。

ブックマーク

ブックマークは「Typst に関するブックマーク」にてまとめています。

参考文献

Typst完全入門: LaTeXより簡単、Markdownより強力、美しいドキュメント作成術: doitsu (著); 2024-12-08 (Release 2024-12-08); Kindle版; B0DPXBNTRS (ASIN); 評価

reviewed by Spiegel on 2025-02-20 (powered by PA-APIv5)

［改訂第9版］LaTeX美文書作成入門: 奥村晴彦 (著), 黒木裕介 (著); 技術評論社 2023-12-09 (Release 2023-12-09); 単行本（ソフトカバー）; 4297138891 (ASIN), 9784297138899 (EAN), 4297138891 (ISBN); 評価

[Comment] 2023年末に出てるのに気が付かなかった orz 今回は版元で PDF 版を買った。

reviewed by Spiegel on 2024-04-07 (powered by PA-APIv5)

“Math mode” をどう訳すのか悩んだが（英語不得手なもので），「非公式日本語ドキュメント」を見ると「数学」ではなく「数式」となっていたので「数式モード」とした。 ↩︎
Typst のクラウドサービスではフォントアップロードなしに STIX2 フォントが使える。というか TeX Live に収録されている TTF/OTF ファイルは全部使えるっぽい。 ↩︎
厳密にはイタリック体と斜体は異なるのだが（イタリック体にも立体と斜体がある），この記事ではまとめて「斜体」と呼ぶことにする。 ↩︎

Typst について

2025-02-20T13:09:42+00:00

そろそろ Typst の勉強を始めようか

Bluesky の TL を眺めてて気がついたのだが Typst の Bluesky アカウントがあるらしい。 Mastodon のアカウントもあるな。ブログもある。

最新のブログ記事を見ると，バージョン 0.13 のハイライトとして

Paragraphs and first line indent

Better-looking outlines

New curves

Files and bytes

Generating images

Faster plugins

Single-letter strings in math

Font coverage control

PDF file embedding

A first look at HTML export

Migrating to Typst 0.13

Community Call

via Typst 0.13 is out now – Typst Blog

と書かれていた。どうやらこのバージョンから HTML 形式へのエクスポート機能を搭載していくらしい（まだ完全ではないようだが）。またフォント制御もよくなっているみたいで（たとえば日本語だと仮名・漢字と英数字では別のフォントを割り当てたくなったりするだろうし）ちょっと期待できる。

というわけで新たに typst セクションを設け，お勉強を通して Typst で出来ること出来ないことを探ってみることにする。

【2025-10-25 追記】

バージョン 0.14 がリリースされた。

Typst: Typst 0.14: Now accessible – Typst Blog

以下に簡単に紹介している。

Typst 0.14 がリリースされた

Typst とは

“Typst” は「タイプスト」と読むらしい。

IPA: /taɪpst/. “Ty” like in Typesetting and “pst” like in Hipster. When writing about Typst, capitalize its name as a proper noun, with a capital “T”.

via typst/typst: A new markup-based typesetting system that is powerful and easy to learn.

イケてる組版ソフトってこと？

簡単に言うと Typst は独自のマークアップ言語とそれを解釈して組版を行うツールおよびサービスを指す。組版ソフトとしては定番の $\mathrm{\LaTeX}$ や Markdown テキストと比較して以下のような特徴があるらしい。

マークアップについては $\mathrm{\LaTeX}$ より簡易で Markdown より高度な表現が出来る
- マクロを使った制御が可能
組版結果を PDF形式のファイルに直接出力できる
組版結果を HTML 形式へエクスポートができる（0.13 より）
コマンドライン・ツールは Rust 言語で組まれている

コマンドライン・ツールは GitHub リポジトリでコードとバイナリが公開されている。ライセンスは Apache-2。

しかし Typst ではドキュメント環境を Web サービスとして提供していて，どうやらこちらがメインっぽい。

Typst: dashboard

Typst: Pricing

とりあえず言語仕様や組版機能を確認するだけなら Free でも問題なさそうなので，しばらくはこれを使うことにする（Free 版を使うだけなら決済情報の入力は不要）。まぁ $\mathrm{\LaTeX}$ にもクラウドサービスがあったりするし，こういうところで収益を確保するのはアリかもしれない（実際に収益があるかどうかは知らないが）。

なお，コマンドライン・ツールについては Windows 環境なら Winget または Scoop でインストールできる。

$ winget search typst
名前     ID                    バージョン 一致       ソース
-----------------------------------------------------------
Typst    Typst.Typst           0.12.0                winget
typstyle Enter-tainer.typstyle 0.12.15    Tag: typst winget

$ scoop search typst
Results from local buckets...

Name  Version Source Binaries
----  ------- ------ --------
typst 0.13.0  main

Winget のほうがタイムラグがあるのかな？手元の Ubuntu 機では Snap でインストール可能だった。

$ snap search typst
Name   Version  Publisher  Notes  Summary
typst  0.13.0   reknih     -      A new markup-based typesetting system that is powerful and easy to learn.

macOS は Homebrew からインストール可能かな。知らんけど。

VS Code 用の拡張機能や vim 用のプラグインもあるらしい。

ちょっと触ってみる

先程のダッシュボードを開いて Empty document を押してみる。

Create project

適当に “sample” とかで始めてみるか。以下の文言を入力する。

= アルベルト・アインシュタインについて

アルベルト・アインシュタインは1879年3月14日，ドイツ生まれの理論物理学者です。
彼による革命的な3つの論文「光電効果の理論」「ブラウン運動の理論」「特殊相対性理論」が発表された1905年は「奇跡の年」と呼ばれています。

構文について今は後回しにして，組版結果はこんな感じ。

Project: sample

うわぁ。これは酷い（笑）

まずエディタのフォントが "Cascadia Mono", monospace になってるな。

Settings

画面左上に ↓ ボタンがあるので，これを押下して PDF ファイルをダウンロードし，プロパティを見てみる。

property

なんか中華フォントっぽい。句読点も明らかにおかしいし。やっぱ，まともに日本語のドキュメント環境が欲しいならローカルで作らないとダメかな。ちょっと考えてみよう。

【追記 2025-02-21】

Mastodon で教えていただきました。

Post by @adbird@vivaldi.net

View on Mastodon

有難うございます 🙇

エディタ画面の左上に Ag ボタンがあってフォントを選択できるのだが Noto Sans/Serif CJK JP フォントが見当たらなくて（リージョン未指定の Noto Sans/Serif はある）対応してないのかと思って諦めていた。フォントのアップロードはしたくなかったし。

さっそくフォントを指定してみる。

Project: sample

生成した PDF をダウンロードしてプロパティを見てみると

property

おー。ちゃんと Noto Sans/Serif CJK JP フォントが埋め込まれている。フォントの指定の仕方については次回の記事を参照のこと。

ブックマーク

ブックマークは「Typst に関するブックマーク」へ移動しました。

参考文献

Typst完全入門: LaTeXより簡単、Markdownより強力、美しいドキュメント作成術: doitsu (著); 2024-12-08 (Release 2024-12-08); Kindle版; B0DPXBNTRS (ASIN); 評価

reviewed by Spiegel on 2025-02-20 (powered by PA-APIv5)

［改訂第9版］LaTeX美文書作成入門: 奥村晴彦 (著), 黒木裕介 (著); 技術評論社 2023-12-09 (Release 2023-12-09); 単行本（ソフトカバー）; 4297138891 (ASIN), 9784297138899 (EAN), 4297138891 (ISBN); 評価

[Comment] 2023年末に出てるのに気が付かなかった orz 今回は版元で PDF 版を買った。

reviewed by Spiegel on 2024-04-07 (powered by PA-APIv5)

Hugo 0.122 で TeX/LaTeX 数式表現ができるようになった（いまさら？）

2024-01-26T23:52:26+00:00

Hugo 0.122.0 がリリースされた。

Release v0.122.0 · gohugoio/hugo · GitHub

今回の目玉機能は $\mathrm{\TeX}$/$\mathrm{\LaTeX}$ 記法による数式表現に対応したことらしい。えっ，いまさら？あー，いや，そういえば別行立ての数式は shortcode とか使って細工する必要があったな，そういえば。

Hugo で $\mathrm{\TeX}$/$\mathrm{\LaTeX}$ 記法による数式表現に対応するには

サイト設定ファイル hugo.toml (または config.toml) で数式表現用のデリミタ文字列を指定する
数式変換用のパッケージ（MathJax または KaTeX）を導入する

といった手順が必要。

サイト設定ファイルの内容はこんな感じ。

[markup]
  defaultMarkdownHandler = "goldmark"
  [markup.goldmark]
    [markup.goldmark.extensions]
      [markup.goldmark.extensions.passthrough]
        enable = true
        [markup.goldmark.extensions.passthrough.delimiters]
          block = [['\[', '\]'], ['$$', '$$']]

YAML や JSON で書く場合は Hugo のドキュメントを参照のこと。

KaTeX は使ったことがないが MathJax については以前に記事にしたことがあるので参考にどうぞ。

これでたとえば

\[
\begin{aligned}
KL(\hat{y} || y) &= \sum_{c=1}^{M}\hat{y}_c \log{\frac{\hat{y}_c}{y_c}} \\
JS(\hat{y} || y) &= \frac{1}{2}(KL(y||\frac{y+\hat{y}}{2}) + KL(\hat{y}||\frac{y+\hat{y}}{2}))
\end{aligned}
\]

と書けば

\[ \begin{aligned} KL(\hat{y} || y) &= \sum_{c=1}^{M}\hat{y}_c \log{\frac{\hat{y}_c}{y_c}} \\ JS(\hat{y} || y) &= \frac{1}{2}(KL(y||\frac{y+\hat{y}}{2}) + KL(\hat{y}||\frac{y+\hat{y}}{2})) \end{aligned} \]

と展開される（筈）

いや，待て。 \[ ... \] って \begin{equation*} ... \end{equation*} と等価だろ。問題なく処理はされるだろうけど，意味としておかしくないか。

試しに \[ ... \] を外して

\begin{aligned}
KL(\hat{y} || y) &= \sum_{c=1}^{M}\hat{y}_c \log{\frac{\hat{y}_c}{y_c}} \\
JS(\hat{y} || y) &= \frac{1}{2}(KL(y||\frac{y+\hat{y}}{2}) + KL(\hat{y}||\frac{y+\hat{y}}{2}))
\end{aligned}

とすると期待通りには変換しない。 Markdown のパーサが上の記述を丸ごと <p> 要素で囲ってしまうからのようだ。サイト設定で指定したデリミタ文字列を使った

エネルギーと質量には $$E=mc^2$$ の関係がある。

みたいな記述なら

<p>エネルギーと質量には </p>
$$E=mc^2$$
<p> の関係がある。</p>

などとパーサ側でうまく分離してくれるのだが。

\begin{aligned} ... \end{aligned} のような $\mathrm{\LaTeX}$ 環境を無駄に \[ ... \] で囲むのがどうしても嫌な方は，強制的に <div> 要素で囲って

<div>
\begin{aligned}
KL(\hat{y} || y) &= \sum_{c=1}^{M}\hat{y}_c \log{\frac{\hat{y}_c}{y_c}} \\
JS(\hat{y} || y) &= \frac{1}{2}(KL(y||\frac{y+\hat{y}}{2}) + KL(\hat{y}||\frac{y+\hat{y}}{2}))
\end{aligned}
</div>

とすれば markdown のパーサが生の HTML 記述と解釈しスルーしてくれる¹。私は数式専用の shortcode を作って利用している。

{{< fig-math >}}
\begin{aligned}
KL(\hat{y} || y) &= \sum_{c=1}^{M}\hat{y}_c \log{\frac{\hat{y}_c}{y_c}} \\
JS(\hat{y} || y) &= \frac{1}{2}(KL(y||\frac{y+\hat{y}}{2}) + KL(\hat{y}||\frac{y+\hat{y}}{2}))
\end{aligned}
{{< /fig-math >}}

ブックマーク

Mathematics in markdown | Hugo

参考図書

[改訂第8版]LaTeX2ε美文書作成入門: 奥村晴彦 (著), 黒木裕介 (著); 技術評論社 2020-11-14; 大型本; 4297117126 (ASIN), 9784297117122 (EAN), 4297117126 (ISBN); 評価

[Comment] 2020年末に第8版が出てたのに気付かなかったよ。可能なら紙の本も買って常に側に置いておくのが吉。版元には PDF 版もある。

reviewed by Spiegel on 2021-09-05 (powered by PA-APIv5)

たとえば \begin{aligned} ... \end{aligned} のような環境をよく使うというのであれば，デリミタとしてサイト設定ファイル（hugo.toml）に指定するのも手である。 ↩︎

2022年は寅年らしいので

2022-01-04T06:16:30+00:00

2022年は寅年らしい。トラといえば昔の $\mathrm{\LaTeX}$ 本で EPS ファイルを貼り込むときによく使われる虎の絵（tiger.eps）って今もあるんだろうか。

と思って『LaTeX2ε美文書作成入門』の第8版を見てみたら今も御健在らしい。実際に TeX Live のインストール先ディレクトリを検索してみたらあちこちにあった（笑）

というわけで $\mathrm{Lua\LaTeX}$ で虎の絵を表示してみる。こんな感じでどうかな。

\documentclass[report]{jlreq}
\usepackage[haranoaji,jis2004,deluxe,match,jfm_yoko=jlreq,jfm_tate=jlreqv]{luatexja-preset} % Japanese fonts
\usepackage{graphicx}

\begin{document}

\begin{figure}
  \centering
  \includegraphics[width=\columnwidth,clip]{./tiger.eps}
  \caption{2022年は寅年らしい}
  \label{fig:tiger}
\end{figure}

\end{document}

jlreq は最近流行りの汎用ドキュメントクラスで W3C の「日本語組版処理の要件」にほぼ準拠しているそうな。しかも $\mathrm{p\LaTeX}$, $\mathrm{up\LaTeX}$, $\mathrm{Lua\LaTeX}$ で透過的に使えるのがありがたい（まぁ，フォントやドライバの指定の仕方が違うので全く同じにはならないけど）。

これを処理した結果は以下の通り。

tiger.pdf

おめでとうございます〜

ブックマーク

改めて TeX Live を Ubuntu に（APT を使わずに）導入する

参考図書

[改訂第8版]LaTeX2ε美文書作成入門: 奥村晴彦 (著), 黒木裕介 (著); 技術評論社 2020-11-14; 大型本; 4297117126 (ASIN), 9784297117122 (EAN), 4297117126 (ISBN); 評価

[Comment] 2020年末に第8版が出てたのに気付かなかったよ。可能なら紙の本も買って常に側に置いておくのが吉。版元には PDF 版もある。

reviewed by Spiegel on 2021-09-05 (powered by PA-APIv5)

Firge フォントを使って LuaLaTeX でコードを書く

2021-09-30T13:29:34+00:00

テキスト・エディタやターミナル・エミュレータ用の日本語が使えるフォントとして有名な白源（HackGen）だが，個人的にどうしても思い入れがあって今まで使わなかった¹。で，たまたま作者の方の Qiita 記事を目にしたのだが

HackGen の姉妹フォント “Firge (ファージ)” を試験的にリリースしました！
https://github.com/yuru7/Firge/releases

英数字部分に Mozilla 製 Fira Mono、日本語文字部分に HackGen と同じ源柔ゴシック（濁点等の修正も含む）、を適用しています。
HackGen の批判的な意見として多かった以下の点を満たすことを意識しました。

0 はドットゼロではなくスラッシュゼロに。

| は破断線ではなく直線に。

Ricty を神フォントだと崇める僕が、フリーライセンスのプログラミングフォント「白源」を作った話 - Qiitaより

とアナウンスされていた。ありがとう！これが欲しかったんだよ。

というわけで早速 Windows Terminal (+ NYAGOS) と Ubuntu 機のターミナル・エミュレータに導入した。あっ，あとブラウザの monospace の既定フォントね²。

ちなみに Ununtu 機にフォントを入れる場合は

ディレクトリ	用途
`/usr/share/fonts`	システムフォント
`/usr/local/share/fonts`	追加フォントをマシンで共有する場合
`~/.fonts`	個人で導入する場合

のいずれかにフォントファイルをコピーして（ディレクトリを掘ってもOK）

$ fc-cache -fv

でキャッシュを更新すれば OK。確認は

$ fc-list | grep Firge
/usr/local/share/fonts/FirgeNerd/Firge35Nerd-Regular.ttf: Firge35Nerd:style=Regular
/usr/local/share/fonts/FirgeNerd/FirgeNerd-Bold.ttf: FirgeNerd:style=Bold
/usr/local/share/fonts/FirgeNerd/FirgeNerd-Regular.ttf: FirgeNerd:style=Regular
/usr/local/share/fonts/FirgeNerd/Firge35NerdConsole-Regular.ttf: Firge35Nerd Console:style=Regular
/usr/local/share/fonts/FirgeNerd/Firge35NerdConsole-Bold.ttf: Firge35Nerd Console:style=Bold
/usr/local/share/fonts/FirgeNerd/FirgeNerdConsole-Bold.ttf: FirgeNerd Console:style=Bold
/usr/local/share/fonts/FirgeNerd/FirgeNerdConsole-Regular.ttf: FirgeNerd Console:style=Regular
/usr/local/share/fonts/FirgeNerd/Firge35Nerd-Bold.ttf: Firge35Nerd:style=Bold

とすればよい。

で，この Firge フォントを使って $\mathrm{Lua\LaTeX}$ でコードを表示したいと思うよね。ね。

というわけで試してみよう。なお TeX Live のインストールは先日書いた「改めて TeX Live を Ubuntu に（APT を使わずに）導入する」を参照のこと。

$\mathrm{Lua\LaTeX}$ でフォントを認識させるために luaotfload-tool --update でアップデートしておく。

$ luaotfload-tool --update

念の為の確認。

$ luaotfload-tool --fuzzy --find="FirgeNerd"
luaotfload | resolve : Font "FirgeNerd" found!
luaotfload | resolve : Resolved file name "/usr/local/share/fonts/FirgeNerd/FirgeNerd-Regular.ttf"

よしよし。

システムに Firge フォントをインストールしないのであれば $TEXMFLOCAL/fonts/ ディレクトリに適当に放り込んでおけばよい。今回は $\mathrm{Lua\LaTeX}$ のみが対象なので CMAP ファイルとか面倒くさそうなのは華麗にスルーする（笑）

なお $TEXMFLOCAL ディレクトリは kpsewhich コマンドで調べられる。

$ kpsewhich -var-value=TEXMFLOCAL
/usr/local/texlive/texmf-local

ファイルを入れたら ls-R を更新するのを忘れないように。

$ mktexlsr
mktexlsr: Updating /usr/local/texlive/2021/texmf-config/ls-R... 
mktexlsr: Updating /usr/local/texlive/2021/texmf-dist/ls-R... 
mktexlsr: Updating /usr/local/texlive/2021/texmf-var/ls-R... 
mktexlsr: Updating /usr/local/texlive/texmf-local/ls-R... 
mktexlsr: Done.

念の為 kpsewhich コマンドで確認しておく。

$ kpsewhich FirgeNerd-Regular.ttf
/usr/local/texlive/texmf-local/fonts/truetype/FirgeNerd/FirgeNerd-Regular.ttf

確認したら luaotfload-tool --update も忘れないでね。

先日 TeX Live をインストールしたときに使ったサンプルコードは以下の通り。

\documentclass{jlreq}
\usepackage[jis2004,deluxe]{luatexja-preset} % Japanese fonts
\setmonofont[AutoFakeSlant,BoldItalicFeatures={FakeSlant},Scale=MatchLowercase]{Inconsolatazi4} % use Inconsolata

\usepackage{graphicx,xcolor}
% \usepackage{listings}
\usepackage{listings-golang} % import this package after listings
\lstset{
    frame=single,
    basicstyle=\small\ttfamily,
    tabsize=4,
    commentstyle=\color{darkgray},
    keywordstyle=\color{brown}\bfseries,
    stringstyle=\color{blue},
    showstringspaces=false
}

\begin{document}

\section{Go 言語による Hello World}

\begin{lstlisting}[language=Golang]
package main

import "fmt"

func main() {
    for i := 0; i < 10; i++ {
        fmt.Println("Hello, world") //Hello, 世界
    }
}
\end{lstlisting}

\section{シェルスクリプト}

\begin{lstlisting}[language=sh]
#!/bin/sh
for i in `seq 100`; do
  j="$i"
  if [ `expr $i % 3` == 0 ]; then echo -n 'Fizz'; j=''; fi
  if [ `expr $i % 5` == 0 ]; then echo -n 'Buzz'; j=''; fi
  echo "$j"
done
\end{lstlisting}

\end{document}

これの組版結果はこちら。

sample.pdf

ここで setmonofont 指定を以下のように変更する。

\setmonojfont[AutoFakeSlant,BoldItalicFeatures={FakeSlant},Scale=MatchLowercase]{FirgeNerd} % use FirgeNerd
\setmonofont[AutoFakeSlant,BoldItalicFeatures={FakeSlant},Scale=MatchLowercase]{FirgeNerd} % use FirgeNerd

この場合の組版結果は以下の通り。

sample2.pdf

小文字のエルとかで比べると分かりやすいだろうか。ただ日本語は Firge フォントじゃないっぽい。

プロパティ

これの HaranoAjiGothic-Regular は多分コードの「世界」の部分だよねぇ。理由は不明。

ついでなので HackGen フォントでも試してみようか。

\setmonojfont[AutoFakeSlant,BoldItalicFeatures={FakeSlant},Scale=MatchLowercase]{HackGenNerd} % use HackGenNerd
\setmonofont[AutoFakeSlant,BoldItalicFeatures={FakeSlant},Scale=MatchLowercase]{HackGenNerd} % use HackGenNerd

組版結果は以下の通り。

sample3.pdf

これなら違いが分かりやすいかな。

ふむむー。個人の好みの問題なんだろうけど，これなら Inconsolata でも別にいいかなぁ。やはりターミナル・エミュレータ用と割り切って使うほうがいいか。

ブックマーク

LuaLaTeX でコードを書いてみる

参考図書

[改訂第8版]LaTeX2ε美文書作成入門: 奥村晴彦 (著), 黒木裕介 (著); 技術評論社 2020-11-14; 大型本; 4297117126 (ASIN), 9784297117122 (EAN), 4297117126 (ISBN); 評価

[Comment] 2020年末に第8版が出てたのに気付かなかったよ。可能なら紙の本も買って常に側に置いておくのが吉。版元には PDF 版もある。

reviewed by Spiegel on 2021-09-05 (powered by PA-APIv5)

いや，大した思い入れでもないんだけど，新人（大昔）の頃は紙のコーディング・シートで書かされたこともあって，手書きのゼロは $\emptyset$ (empty set) なイメージなんだよねぇ。 ↩︎
私はテキスト・エディタは明朝体じゃないと目がしんどいので，英数字は Inconsolata だけど日本語部分は Noto Serif CJK JP にしている。どなたか明朝体の monospace を作ってください。 ↩︎

改めて TeX Live を Ubuntu に（APT を使わずに）導入する

2021-09-09T13:20:36+00:00

6月にパソコンを買い換えてから新しいマシンには $\mathrm{\TeX}$ 環境を入れてなかったのだが，先日『LaTeX2ε美文書作成入門』第8版の読書感想文を書いたばかりなので，調子に乗って TeX Live 2021 を入れてしまおうと思い立った。

『LaTeX2ε美文書作成入門』の付録Aには

あらかじめ /usr/local/texlive というディレクトリを作成し，インストールする人の権限で書き込めるようにしておくのが簡単です

［改訂第8版］LaTeX2ε美文書作成入門より

とか書かれてあって「やっぱそーなのか」と納得してしまった。激しくダサい気がするがしょうがないか。まぁ，今回は個人パソコンなので素直に

$ cd /usr/local/
$ sudo mkdir texlive
$ sudo chown -R username:username texlive

としてしおう。

サーバ機などでは，インストール完了後にオーナーを root に書き戻し

$ cd /usr/local
$ sudo chown -R root:root texlive
$ cd texlive/2021/bin/x86_64-linux/
$ sudo ./tlmgr path add

と /usr/local/bin/ 等パスの通ったディレクトリへシンボリック・リンクを張っておけば複数ユーザで共有できるようになる。アップグレード等で元に戻す場合は

$ sudo tlmgr path remove
$ cd /usr/local/
$ sudo chown -R username:username texlive
...

という感じに，いったんシンボリック・リンクを削除してから諸々の作業を行うといいだろう。

OpenPGP 公開鍵を取ってくる

TeX Live のサイトでは検証用に OpenPGP 公開鍵を公開している。これを取ってきて自分の鍵束にインポートしてしまおう。

$ gpg --fetch-key http://www.tug.org/texlive/files/texlive.asc
gpg: 鍵を'http://www.tug.org/texlive/files/texlive.asc'から要求
gpg: 鍵0D5E5D9106BAB6BC: 公開鍵"TeX Live Distribution <tex-live@tug.org>"をインポートしました
gpg: 処理数の合計: 1
gpg:               インポート: 1

$ gpg --list-keys 0D5E5D9106BAB6BC
pub   rsa2048 2016-03-19 [SC]
      C78B82D8C79512F79CC0D7C80D5E5D9106BAB6BC
uid           [  不明  ] TeX Live Distribution <tex-live@tug.org>
sub   rsa2048 2016-03-19 [E]
sub   rsa2048 2016-03-19 [S] [有効期限: 2022-07-27]

これはアレだな。 TeX Live がアップグレードされるたびに更新しろってことだな。

インストーラのダウンロードと検証

では続きを。

$ curl -L "https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz" -O
$ curl -L "https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz.sha512" -O
$ curl -L "https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz.sha512.asc" -O
$ gpg -d install-tl-unx.tar.gz.sha512.asc
gpg: 署名されたデータが'install-tl-unx.tar.gz.sha512'にあると想定します
gpg: 2021年09月08日 08時53分40秒 JSTに施された署名
gpg:                RSA鍵4CE1877E19438C70を使用
gpg: "TeX Live Distribution <tex-live@tug.org>"からの正しい署名 [不明の]
gpg: *警告*: この鍵は信用できる署名で証明されていません!
gpg:          この署名が所有者のものかどうかの検証手段がありません。
主鍵フィンガープリント: C78B 82D8 C795 12F7 9CC0  D7C8 0D5E 5D91 06BA B6BC
     副鍵フィンガープリント: D8F2 F860 57A8 57E4 2A88  106A 4CE1 877E 1943 8C70

$ sha512sum -c install-tl-unx.tar.gz.sha512
install-tl-unx.tar.gz: OK

なんちう回りくどい¹。普通にダウンロードファイルに署名すりゃいいぢゃん orz

ちなみに拙作の gnkf を使っても

$ gnkf hash -a SHA-512 -c install-tl-unx.tar.gz.sha512
install-tl-unx.tar.gz: OK

てな感じで検証できる。 sha512sum コマンドがない環境でどうぞ。宣伝でした（笑）

よーやくインストール開始

$ tar xvf install-tl-unx.tar.gz
$ cd install-tl-20210908/
$ ./install-tl

リポジトリを指定する必要はないみたい。適当に近場を探してくれてるようだ。

======================> TeX Live installation procedure <=====================

======>   Letters/digits in <angle brackets> indicate   <=======
======>   menu items for actions or customizations      <=======
= help>   https://tug.org/texlive/doc/install-tl.html   <=======

 Detected platform: GNU/Linux on x86_64
 
 <B> set binary platforms: 1 out of 16

 <S> set installation scheme: scheme-full

 <C> set installation collections:
     40 collections out of 41, disk space required: 7135 MB

 <D> set directories:
   TEXDIR (the main TeX directory):
     /usr/local/texlive/2021
   TEXMFLOCAL (directory for site-wide local files):
     /usr/local/texlive/texmf-local
   TEXMFSYSVAR (directory for variable and automatically generated data):
     /usr/local/texlive/2021/texmf-var
   TEXMFSYSCONFIG (directory for local config):
     /usr/local/texlive/2021/texmf-config
   TEXMFVAR (personal directory for variable and automatically generated data):
     ~/.texlive2021/texmf-var
   TEXMFCONFIG (personal directory for local config):
     ~/.texlive2021/texmf-config
   TEXMFHOME (directory for user-specific files):
     ~/texmf

 <O> options:
   [ ] use letter size instead of A4 by default
   [X] allow execution of restricted list of programs via \write18
   [X] create all format files
   [X] install macro/font doc tree
   [X] install macro/font source tree
   [ ] create symlinks to standard directories

 <V> set up for portable installation

Actions:
 <I> start installation to hard disk
 <P> save installation profile to 'texlive.profile' and exit
 <Q> quit

Enter command:

必要に応じて設定を変えて（既定のままでも無問題）問題なければ I を入力してインストールを開始する。私の環境では1時間近くかかった。お茶菓子を用意しておくか（笑）

環境変数については ~/.profile ファイルに

# Expand $PATH to include the directory where TeX Live applications go.
texlive_path="/usr/local/texlive/2021"
texlive_bin_path="${texlive_path}/bin/x86_64-linux"
if [ -d "$texlive_path" -a -n "${PATH##*${texlive_bin_path}}" -a -n "${PATH##*${texlive_bin_path}:*}" ]; then
  export PATH="$PATH:$texlive_bin_path"
fi
unset texlive_path texlive_bin_path

と追記しておけばいいかな。一応，動作確認しておく。

$ lualatex -v
This is LuaHBTeX, Version 1.13.2 (TeX Live 2021)

Execute  'luahbtex --credits'  for credits and version details.

There is NO warranty. Redistribution of this software is covered by
the terms of the GNU General Public License, version 2 or (at your option)
any later version. For more information about these matters, see the file
named COPYING and the LuaTeX source.

LuaTeX is Copyright 2021 Taco Hoekwater and the LuaTeX Team.

マニュアルに関しては texdoc コマンドを使って

$ texdoc luatex

などとすれば対応する PDF ファイルが開く。便利！

自動実行可能な外部コマンドの指定

とりあえず shell_escape_commands の値を変更しておく。インストール直後は

$ kpsewhich -var-value=shell_escape_commands
bibtex,bibtex8,extractbb,gregorio,kpsewhich,makeindex,repstopdf,texosquery-jre8,

となっているので /usr/ocal/texlive/texmf-local/web2c/texmf.cnf ファイルを作成し以下を記述する。

shell_escape_commands = \
bibtex,bibtex8,pbibtex,jbibtex,\
extractbb,\
gregorio,\
kpsewhich,\
makeindex,mendex,\
repstopdf,epspdf,\
texosquery-jre8,\

これで shell_escape_commands の値が上書きされて

$ kpsewhich -var-value=shell_escape_commands
bibtex,bibtex8,pbibtex,jbibtex,extractbb,gregorio,kpsewhich,makeindex,mendex,repstopdf,epspdf,texosquery-jre8,

となる。

設定を変更したら mktexlsr で状態を更新しておくこと。

$ mktexlsr
mktexlsr: Updating /usr/local/texlive/2021/texmf-config/ls-R... 
mktexlsr: Updating /usr/local/texlive/2021/texmf-dist/ls-R... 
mktexlsr: Updating /usr/local/texlive/2021/texmf-var/ls-R... 
mktexlsr: Updating /usr/local/texlive/texmf-local/ls-R... 
mktexlsr: Done.

LuaLaTeX でなんか出力してみる

そうだ。プログラムコードを出してみよう。

LuaLaTeX でコードを書いてみる

その前に listings パッケージで Go コードの syntax highlight が効くよう listings-golang を取ってくる。

$ cd /usr/local/texlive/texmf-local/tex/latex/
$ git clone git@github.com:julienc91/listings-golang.git
$ mktexlsr

そうそう。 $\mathrm{Lua\LaTeX}$ を使うならフォントキャッシュも念の為にアップデートしておくか。

$ luaotfload-tool -fu

用意したテキストはこんな感じ。

\documentclass{jlreq}
\usepackage[jis2004,deluxe]{luatexja-preset} % Japanese fonts
\setmonofont[AutoFakeSlant,BoldItalicFeatures={FakeSlant},Scale=MatchLowercase]{Inconsolatazi4} % use Inconsolata

\usepackage{graphicx,xcolor}
% \usepackage{listings}
\usepackage{listings-golang} % import this package after listings
\lstset{
    frame=single,
    basicstyle=\small\ttfamily,
    tabsize=4,
    commentstyle=\color{darkgray},
    keywordstyle=\color{brown}\bfseries,
    stringstyle=\color{blue},
    showstringspaces=false
}

\begin{document}

\section{Go 言語による Hello World}

\begin{lstlisting}[language=Golang]
package main

import "fmt"

func main() {
    for i := 0; i < 10; i++ {
        fmt.Println("Hello, world") //Hello, 世界
    }
}
\end{lstlisting}

\section{シェルスクリプト}

\begin{lstlisting}[language=sh]
#!/bin/sh
for i in `seq 100`; do
  j="$i"
  if [ `expr $i % 3` == 0 ]; then echo -n 'Fizz'; j=''; fi
  if [ `expr $i % 5` == 0 ]; then echo -n 'Buzz'; j=''; fi
  echo "$j"
done
\end{lstlisting}

\end{document}

へっへっへ。 jlreq ドキュメントクラスを使ってみたぜ。

これを処理した結果は以下の通り。

sample.pdf

うんうん。こんなもんだろう。

VS Code に LaTeX Workshop を導入する

『LaTeX2ε美文書作成入門』でも紹介されていた VS Code 用の LaTeX Workshop を導入してみた。

$ code --install-extension James-Yu.latex-workshop

たとえば，以下の内容で .latexmkrc ファイルを用意しておく。

#!/usr/bin/env perl

# LaTeX commands
$pdflatex            = 'lualatex %O -synctex=1 %S';
$latex               = 'uplatex %O -synctex=1 %S';
$latex_silent_switch = '-interaction=batchmode -c-style-errors';

# bibTeX commands
$bibtex    = 'upbibtex %O %B';
$biber     = 'biber %O --bblencoding=utf8 -u -U --output_safechars %B';
$makeindex = 'mendex %O -o %D %S';

# Device Driver
$dvipdf = 'dvipdfmx %O -z9 -V 7 -o %D %S';
$dvips = 'dvips %O -z -f %S | convbkmk -u > %D';
$ps2pdf = 'ps2pdf14 -dPDFA -dPDFACompatibilityPolicy=1 -sProcessColorModel=DeviceCMYK %O %S %D';

# Typeset mode (generate a PDF)
$pdf_mode = 1; # 0: do not generate a pdf , 1: using $pdflatex , 2: using $ps2pdf , 3: using $dvipdf

# Other configuration
$pvc_view_file_via_temporary = 0;
$max_repeat                  = 5;

したら $\mathrm{\LaTeX}$ テキストを保存するたびに上の設定でタイプセットが自動実行されて PDF まで作ってしまうわけですよ。めっさ便利。

ブックマーク

参考図書

[改訂第8版]LaTeX2ε美文書作成入門: 奥村晴彦 (著), 黒木裕介 (著); 技術評論社 2020-11-14; 大型本; 4297117126 (ASIN), 9784297117122 (EAN), 4297117126 (ISBN); 評価

[Comment] 2020年末に第8版が出てたのに気付かなかったよ。可能なら紙の本も買って常に側に置いておくのが吉。版元には PDF 版もある。

reviewed by Spiegel on 2021-09-05 (powered by PA-APIv5)

電子署名の検証で「*警告*: この鍵は信用できる署名で証明されていません!」と表示されているが，気にしなくてよい。その前の「"TeX Live Distribution <tex-live@tug.org>"からの正しい署名」が表示されていればOK。警告が出るのはインポートした公開鍵に自鍵で署名したり有効度を設定したりしてないからだが，直接手渡しされた鍵でもないのに安易に信用するのは危険であると言っておこう。もちろん何らかの手段で鍵と所有者が確定できるのであれば署名するなり有効度を設定するなりすればよい。 ↩︎

改訂第8版『LaTeX2ε美文書作成入門』を眺める

2021-09-05T08:42:03+00:00

Twitter の TL を見て気が付いた。あれ？『LaTeX2ε美文書作成入門』の第8版って出てるの？完全に見落としてたよ orz

『LaTeX2ε美文書作成入門』は Kindle 版もあるし版元で買えば PDF 版もあるんだけど，今回は紙の本を買った。この手のリファレンス本は，一覧性という観点では，まだ紙のほうが有利。デジタル版が好みなら PDF 版を買うのがいいだろう。悪いが，この手の本で Kindle 版はない。

第7版からの3年間で大きく変わったことといえば $\mathrm{Lua\LaTeX}$ 日本語環境の台頭だろう。序文でも

本書も $\mathrm{Lua\LaTeX}$ と新しい jleq ドキュメントクラスと原ノ味で組版しました

［改訂第8版］LaTeX2ε美文書作成入門より

と書かれている。えっ，これ原ノ味フォントなの？そういや巻末に原ノ味フォントの全グリフが載ってるな（笑）

入力環境（第2章）についても真っ先に Cloud LaTeX が紹介されているし¹（これは第7版でもそうか），コラム内とはいえ VS Code 用の LaTeX Workshop が紹介されていたりする。また jleq ドキュメントクラスについても14章で詳しく解説している。時代が変わったんだねぇ。

グラフィック周りについては第7版に引き続き付録Dで $\mathrm{Ti}k\mathrm{Z}$/PGF を詳しく解説している。

$\mathrm{Ti}k\mathrm{Z}$ に慣れると picture 環境は使いたくなくなります

［改訂第8版］LaTeX2ε美文書作成入門より

とか書かれてあって，ちょっと笑ってしまう。

第8版では R, gnuplot 以外に Python を使った例を挙げている。ちなみに Go 言語でも gonum.org/v1/plot パッケージで $\mathrm{Ti}k\mathrm{Z}$ 出力をサポートしている。また，みんな大好き DOT 言語でも dot2tex というツール（Python 製）を使うと $\mathrm{Ti}k\mathrm{Z}$ 形式に変換してくれるらしい。もっとも dot2tex には dot2texi $\mathrm{\LaTeX}$ パッケージもあるようなので，こっちのほうが便利かもしれないが。あと PlantUML でもベータ版ながら $\mathrm{Ti}k\mathrm{Z}$ 形式に対応しているようだ。

ぶっちゃけ PDF を最終出力とするのなら $\mathrm{Lua\LaTeX}$ で必要十分だよな。まぁ，論文を書くとなると各学会用のドキュメントクラスを使わないといけないので簡単ではないだろうが。

最近は $\mathrm{Lua\LaTeX}$ を直にゴリゴリ書く機会は無くなったが『LaTeX2ε美文書作成入門』を眺めていると色々遊びたくなってくる。今の仕事が落ち着いたら試してみたいところである。

ブックマーク

参考図書

[改訂第8版]LaTeX2ε美文書作成入門: 奥村晴彦 (著), 黒木裕介 (著); 技術評論社 2020-11-14; 大型本; 4297117126 (ASIN), 9784297117122 (EAN), 4297117126 (ISBN); 評価

[Comment] 2020年末に第8版が出てたのに気付かなかったよ。可能なら紙の本も買って常に側に置いておくのが吉。版元には PDF 版もある。

reviewed by Spiegel on 2021-09-05 (powered by PA-APIv5)

Cloud LaTeX 連携用の VS Code 拡張機能があるんだな。 ↩︎

LuaLaTeX でも履歴書を書きたい！

2020-06-11T07:52:45+00:00

【2020-07-02 追記】 shigio/rireki-style 側で $\mathrm{Lua\LaTeX}$ でも組版できるよう対応していただきました。サンプル rireki.tex ファイルの最初にある

%\lualatextrue

のコメントを解除すると $\mathrm{Lua\LaTeX}$ 対応になる。

感謝！

2018年の記事で

を紹介した。

その後いろいろ試してみて，サンプルの rireki.tex の最初の

\documentclass{jarticle}
\usepackage{rireki}
...

の部分を

\documentclass[b5j]{ltjsarticle}
\usepackage[deluxe,nfssonly]{luatexja-preset}
\usepackage{rireki}
...

と書き換えれば一応 $\mathrm{Lua\LaTeX}$ でも通ることが分かったのだが，この状態では顔写真を

\顔写真{photo.jpg}

と指定しても上手く貼り付けられない。

しょうがないので rireki.sty を眺めていたら冒頭部分に

\usepackage[dvipdfmx]{graphicx}

とか書かれていた。

ドライバが dvipdfmx 決め打ちか。そりゃあ $\mathrm{Lua\LaTeX}$ で上手くいかんわな。

そこで rireki.sty の graphicx パッケージの記述をコメントアウトして rireki.tex を

\documentclass[b5j]{ltjsarticle}
\usepackage[deluxe,nfssonly]{luatexja-preset}
\usepackage[luatex]{graphicx}
\usepackage{rireki}
...

としたら¹ 問題なく顔写真を貼り付けられた。これでますます $\mathrm{p\LaTeX}$/$\mathrm{up\LaTeX}$ は「要らない子」になるね（笑）

なお，今回改変した rireki.sty を使って $\mathrm{p\LaTeX}$/$\mathrm{up\LaTeX}$ で処理する場合は

\documentclass[uplatex,b5j]{jsarticle}
\usepackage[dvipdfmx]{graphicx}
\usepackage{rireki}
...

などとすればOK²。

ちなみに

#!/usr/bin/env perl

# LaTeX commands
$pdflualatex = 'lualatex %O -synctex=1 %S';
$latex       = 'uplatex %O -synctex=1 %S';

# Device Driver
$dvipdf = 'dvipdfmx %O -z9 -p jisb5 -V 7 -o %D %S';

# Typeset mode (generate a PDF)
$pdf_mode = 4; # 0: do not generate a pdf , 1: using $pdflatex , 2: using $ps2pdf , 3: using $dvipdf , 4: using $pdflualatex

という内容で .latexmkrc ファイルを作成すれば

$pdf_mode = 3

で $\mathrm{p\LaTeX}$/$\mathrm{up\LaTeX}$ 用，

$pdf_mode = 4

で $\mathrm{Lua\LaTeX}$ 用の設定になる。あとは

$ latexmk

で *.tex ファイルを探して勝手に全部処理してくれる。

ところで，私が PDF 文書の紙出力に利用しているネットプリントが 2020-06-15 から値上げするらしいのだが。今は求職活動で履歴書乱発中なんだよ。とほほ orz

ブックマーク

参考図書

[改訂第8版]LaTeX2ε美文書作成入門: 奥村晴彦 (著), 黒木裕介 (著); 技術評論社 2020-11-14; 大型本; 4297117126 (ASIN), 9784297117122 (EAN), 4297117126 (ISBN); 評価

[Comment] 2020年末に第8版が出てたのに気付かなかったよ。可能なら紙の本も買って常に側に置いておくのが吉。版元には PDF 版もある。

reviewed by Spiegel on 2021-09-05 (powered by PA-APIv5)

ドライバ指定を省略して \usepackage{graphicx} でも可。 ↩︎
Issue で提案したところ，対応していただけました。感謝！ ↩︎