2019-07-31

Markdownでデカイ文字を書けて便利な話（ただしPandoc）

TeX以外 Pandoc

聞くところによると、Markdownでとにかくデカイ文字が簡単に書けると便利なようです。

しかし残念なことに、元来のMarkdownは意味的なマークアップを指向したものであるため、今世にあるMarkdownの各種方言はどれも「見出しを書く」ことができても「デカイ文字を書く」ことができません。このことがデカイ文字の熱狂的ファンがMarkdownの採用を躊躇する一因となっていることは否めないでしょう。

というわけで、Markdownでデカイ文字を書くためのPandocフィルタを作ってみました。

biggggg.lua（Gist/zr-tex8r）

文字をデカくする

このフィルタを使う場合、デカイ文字は「bigクラスをつけたspan要素」として表されます。Pandoc Markdownの記法では次のように書きます。

[sample1.md]

Pandocは[アレ]{.big}。

早速このMarkdownをHTMLに変換してみましょう。

pandoc sample1.md --lua-filter biggggg.lua -s -o sample1.html

f:id:zrbabbler:20190731210533p:plain — HTMLでデカイ文字

デカイ！便利！

今度はLuaLaTeX経由でPDFに変換してみましょう。

pandoc sample1.md --lua-filter biggggg.lua -o sample1.pdf --pdf-engine=lualatex -V documentclass=bxjsarticle -V classoption=pandoc

f:id:zrbabbler:20190731210622p:plain — PDFでデカイ文字

デカイ！便利！

※現状では、対応する出力形式はHTMLとLaTeX（経由のPDF）に限ります。

文字をもっともっとデカくする

「これだけのデカさでは物足りない」という人はもっともっとデカイ文字も使えます。クラス名としてbigの代わりにbigg、biggg、bigggg、……とすることで、文字をどんどんデカくできます。

[sample2.md]

Pandocは[アレ]{.bigg}[アレ]{.bigggg}
[アレ]{.bigggggg}[アレ]{.bigggggggg}。

※見やすさのため、Markdown中に改行を入れました。この改行は（空白にならずに）無視されてほしいので、pandoc実行時にオプションに-f markdown+ignore_line_breaksを追加することにします。

f:id:zrbabbler:20190731210654p:plain — HTMLでもっともっとデカイ文字

f:id:zrbabbler:20190731210716p:plain — PDFでもっともっとデカイ文字

もっともっとデカイ！便利！

強調文字もデカくする

もちろん、デカイ文字を他の文字装飾と組み合わせることもできます。

[sample3.md]

Pandocは[アレ]{.bigg}、TeXは[超絶**アレ**]{.bigggggg}。

f:id:zrbabbler:20190731211010p:plain — HTMLでデカイ強調文字

f:id:zrbabbler:20190731211035p:plain — PDFでデカイ強調文字

強調付きでデカイ！ 便利！

まとめ

Pandocはネタ記事を書くのに便利！（えっ）

2019-06-16

PandocでWindowsをシャットダウンする件について

Pandoc

（メモ）
PandocでWindowsをシャットダウンする件#Pandoc #ぱんどっく #ええっ
— 某ZR（ざんねん🙃） (@zr_tex8r) 2019年6月5日

皆さんもよくご存知の通り、LuaLaTeXでは「Windwosをシャットダウンする文書」が作成できます。これはLuaコードを通じて（C言語をコンパイルして生成した）マシン語のプログラムが実行できることを利用しています。

ところで、以前のネタで紹介した通り、PandocではLuaでフィルターを実装することができます。となると、マークダウンという不思議な形式の文書でWindowsをシャットダウンしてみたくなるのは当然の帰結でしょう。

どうもPandocでWindowsをシャットダウンできそうにない件

Luaでバイナリ（マシン語）のモジュールを作製する際には、次のような感じのC言語の関数を実装します。

※以下のコードはLuaLaTeXのやつで使っているモジュール¹のソースコードからの抜粋。

/* Opens the module.
 */
__declspec(dllexport) int luaopen_shutwindown(lua_State *L) {
    luaL_newlib(L, registry);
    return 1;
}

Luaでモジュールを読み込む（require "shutwindown"）と、この関数が実行されるのですが、この中で使われているluaL_newlibというのは「Lua処理系の連携用API」の一つです。連携APIはLua処理系と外部のコードの間のやり取りを行う機構で、バイナリのモジュールの実装に不可欠なものです。

つまり、バイナリのモジュールを動作させるには、Lua処理系の連携APIの関数が「外から見えている」必要があるわけです。TeX Live配布におけるLuaTeXのLua処理系は動的リンクのライブラリ（WindowsだとDLL形式）になっているため、連携APIは外から見えています。これに対して、Pandocの公式のWindwos用バイナリではLua処理系が静的にリンクされていて連携APIが外から見えません。これではLuaTeXの時と同じようには「Windowsをシャットダウンするモジュール」を実装することはできません。

それでもPandocでWindowsをシャットダウンしたい件

絶望的な状況になっていしまいましたが、もう少し考えてみましょう。

先程述べた通り、Luaコードにおいてモジュールshutwindownの読込（require）を行うとC言語の関数luaopen_shutwindownが呼ばれます。Luaのrequire "shutwindown"に対応する動作なので、通常はこの関数では「モジュールの関数を収めたLuaテーブルを作成して返す」ことが期待されています。しかし、とにかくモジュールの実装コードに実行を移すことができているのだから、ここで早々とシャットダウン開始の処理を済ませてしまえばいいわけです。

/* Opens the module.
 */
__declspec(dllexport) int luaopen_shutwindown(void *L) {
    shutdown_system(); /* シャットダウン！ */
    return 0;
}

すなわち、このモジュールがインストールされたLua処理系では、require "shutwindown"を実行するだけでシャットダウンが開始します。

改めてPandocでWindowsをシャットダウンする件

というわけで、作ってみました。

pcshutwindown（GitHub/zr-tex8r）

このリポジトリにあるファイルpcshutwindown.dllとshutdown.luaをカレントディレクトリ²に置いた上で、何か適当なMarkdown文書’（リポジトリにあるREADME.mdでもいいでしょう）をPandocで変換しましょう。もちろんフィルタにshutdown.luaを指定することを忘れずに。

C>pandoc README.md --lua-filter shutdown.lua
System will be shutdown in 10 seconds...
System will be shutdown in 9 seconds...
System will be shutdown in 8 seconds...
System will be shutdown in 7 seconds...
System will be shutdown in 6 seconds...
System will be shutdown in 5 seconds...
System will be shutdown in 4 seconds...
System will be shutdown in 3 seconds...
System will be shutdown in 2 seconds...
System will be shutdown in 1 second...
FAREWELL!

まとめ

結局、PandocのLuaフィルタでバイナリモジュールを利用するのは難しい、のかな？

当該の記事を書いたときには、当時のLuaTeXに合わせてLua 5.1版を前提にした実装でしたが、現在（TeX Live 2019以降）のLuaTeXのLua処理系は5.3版であるため、5.3版で動作するように改修しました。↩
Pandocの公式バイナリではLuaのバイナリモジュール読込パスにはカレントディレクトリが含まれています。↩

2019-05-28

「サイゼリヤで1000円あれば最大何kcal摂れるのか」をSATySFiで解いてみた

TeX以外

「『サイゼリヤで1000円（略）』をSATySFiで一気に計算して組版する」を誰もやらないので、SATySFiはオワコン👋#satysfi #えっ
— 某ZR🤯 (@zr_tex8r) 2019年5月28日

SATySFiをオワコンにしてしまうのは忍びないので、やってみた。

作ったもの

SATySFi：「サイゼリヤで1000円あれば最大何kcal摂れるのか」を解くパッケージ（Gist/zr-tex8r）

このsaizeriyaパッケージを使うとSATySFi文書中でサイゼリヤ問題ができるようになる。

[saizeriya-test.saty]

@require: stdja
@require: saizeriya
%saizeriya.satyhをカレントに置く場合は↓を使う
%@import: saizeriya

%------------------------------------------------- メニューデータ
let the-menu = [
(|calorie=130;cost=299;name=`彩りガーデンサラダ`|);
(|calorie=115;cost=349;name=`小エビのサラダ`|);
(|calorie=134;cost=299;name=`やわらかチキンのサラダ`|);
(|calorie=92;cost=299;name=`わかめサラダ`|);
……(中略)……
(|calorie=164;cost=369;name=`トリフアイスクリーム`|);
]
%------------------------------------------------- 本文
in

document (|
  title = {\SATySFi;でサイゼリヤ問題};
  author = {某ZR（アレ）};
  show-title = true;
  show-toc = false;
|) '<                                          
  +section{問題}<
    +p{
      予算1000円以内で，サイゼリヤで最大カロリーを摂取するような
      注文の仕方を求めよ。
      ただしサイゼリヤの料理のメニューは以下の通りとする。
    }
    %the-menuのメニューを箇条書きで出力する
    +saizeriya-listing-menu(the-menu);
  >
  +section{解答}<
    +p{
      以下の通り。
    }
    %サイゼリヤ問題を解いて解答を表組で出力する
    +saizeriya-tabular-solution(the-menu)(1000);
  >
>

この文書をコンパイルすると次の出力が得られる。

※SATySFiの0.0.3版を使用。

f:id:zrbabbler:20190528215346p:plain — 「問題」の出力の冒頭

f:id:zrbabbler:20190528215409p:plain — 「解答」の出力

まとめ

というわけで、SATySFiは非オワコンで素敵！

2019-05-25

「サイゼリヤで1000円あれば最大何kcal摂れるのか」をPandocで解いてみた

TeX以外 Pandoc

ブログにちょっとしたネタ記事を投稿しました。 https://t.co/T621Qa5LqL 「サイゼリヤで1000円あれば最大何kcal摂れるのか」をTeX言語で計算する～TeX言語で動的計画法(DP)～ #TeX
— Yusuke Terada (@doraTeX) 2019年5月20日

「サイゼリヤで1000円あれば最大何kcal摂れるのか」をTeX言語で計算する～TeX言語で動的計画法(DP)～（TeX Alchemist Online）

どうやら、TeXを使うと計算と組版を一気にやってしまえて最高、なようです。

ところで、皆さんご存知の通りTeXはアレなわけですが、どうやら聞くところによると、Pandocも相当アレなようです。

人はなぜ、苦しみながらPandocでドキュメントを書き続けるのか #pandoc_night
— 藤原惟📕 (@skyy_writing) 2019年5月20日

Pandoc Night 2019 スライド＆ツイートまとめ（togetter）

となると、「サイゼリヤで1000円あれば最大何kcal摂れるのか」をPandocで一気に計算して組版する、というネタがあって然るべきなのは、当然の帰結でしょう。

というわけで、やってみました。

方針

Pandoc 2版の機能である「Luaフィルタ（--lua-filterオプション）」を利用する。
Markdown文書中に現れる特定の形式のマークアップを、「サイゼリヤ問題の解の組版結果」に置き換える。
解の計算はフィルタ内のLuaコードで行う。（アルゴリズムは元ネタと同じく動的計画法を使う。）
メニューのデータは別途CSVファイルで用意する。

サイゼリヤ問題を解くMarkdown文書

Pandoc：「サイゼリヤで1000円あれば最大何kcal摂れるのか」を解くLuaフィルタ（Gist/zr-tex8r）
フィルタsaizeriya.luaを含むファイル一式はここに置いてあります。

[sample.md]

# 問題

予算1000円以内で，サイゼリヤで最大カロリーを摂取するような注文の仕方を求めよ。ただしサイゼリヤの料理のメニューは以下の通りとする。

[一覧](./menu.csv){.saizeriya-list}

# 解答

以下の通り。

[解答](./menu.csv){.saizeriya-solve badget=1000}

[menu.csv]

彩りガーデンサラダ,130,299
小エビのサラダ,115,349
やわらかチキンのサラダ,134,299
わかめサラダ,92,299
イタリアンサラダ,196,299
……(略)……

書式の説明

特定のクラスを付けたリンク要素を書くと、その部分がフィルタによって置き換えられます。

次のように、クラスにsaizeriya-listを指定したリンクを書くと、指定のメニューファイルを読み込んでメニューの一覧の箇条書きを生成してその場に出力します。（テキストは出力されません。）

[テキスト](メニューファイルのパス){.saizeriya-list}

クラスにsaizeriya-solveを指定したリンクを書くと、指定のメニューファイルを読み込んでサイゼリヤ問題を解き、その解答を表組にしたものを出力します。この際に予算額はbadgetという属性で指定します。

[テキスト](メニューファイルのパス){.saizeriya-solve badget=予算額}

さっそくPandocしてみる

以下のコマンドで、先のMarkdown文書（sample.md）をWord文書に変換します。

pandoc sample.md --lua-filter=saizeriya.lua -o sample.docx

※「Wordは嫌だ」という人は、出力ファイル名のsample.docxの拡張子を変えて別の形式を選びましょう。例えばsample.odtとするとOpenDocument形式になります。sample-out.mdのようにすると別ファイルにMarkdown形式で出力できます。

出力されたWord文書（sample.docx）を開いてみると、メニュー一覧が正しく挿入されていることが判ります。

※以下の出力結果はPandoc 2.7.2（最新版）によるものです。

f:id:zrbabbler:20190525154330p:plain — sample.docx 1ページ目冒頭

そして、最後のページをみると、例の栄養満点な3点セットが、無事に出力されていました。

f:id:zrbabbler:20190525154405p:plain — sample.docx 4ページ目

まとめ

たとえTeX言語ができなくても、Pandocがあれば計算と組版を一気にやれます！スゴイ！（えっ）

2019-05-13

決定版！ TeX のインストール・設定方法

TeX LaTeX

皆さん、技術書を読みましょう！

お使いのコンピュータに TeX 環境を整える

[改訂第7版]LaTeX2ε美文書作成入門

作者: 奥村晴彦,黒木裕介
出版社/メーカー: 技術評論社
発売日: 2017/01/24
メディア: 大型本
この商品を含むブログ (2件) を見る

オンラインの TeX / LaTeX サービスを利用する

インストールいらずのLATEX入門 ―Overleafで手軽に文書作成

作者: 坂東慶太,奥村晴彦,寺田侑?
出版社/メーカー: 東京図書
発売日: 2019/05/13
メディア: 単行本
この商品を含むブログを見る

以上！

完璧！！ #えっ

2019-05-06

Pandocで(u)pLaTeXしてみる話

LaTeX Pandoc

どうやら、新しいPandocではビルドにLatexmkが使えるらしい。

pandoc 2.7

Add latexmk as an option for --pdf-engine (#3195). Note that you can use --pdf-engine-opt=-outdir=bar to specify a persistent temp directory.

Pandocの「PDF出力エンジン」(--pdf-engine)として指定できるLaTeXエンジンはpdfLaTeX、XeLaTeX、LuaLaTeXに限られている。しかし、Latexmkが使えるようになったということは、これを利用して「(u)pLaTeX＋dvipdfmxでPDFを生成する」ことができるはずである。

PandocでLatexmkしてみる

とりあえず、簡単な英語のMarkdown文書を用意して試してみる。

[test1.md]

# Welcome!

Hello, Pandoc *chaos*!

これを--pdf-engine=latexmk付のpandocで変換する。

※プロンプトを>で表す。

> pandoc --pdf-engine=latexmk test1.md -o test1.pdf
Latexmk: Run number 1 of rule 'pdflatex'
Latexmk: Run number 2 of rule 'pdflatex'

f:id:zrbabbler:20190506233335p:plain — test1.pdfの内容

フツーにPDFが出力できた。端末表示をみると、どうやらpdfLaTeXを使うワークフローが選択されているようである。実際、出力PDFの文書情報のProducerの値もpdfTeX-1.40.20となっている。

さらに細かく挙動を調べてみると、以下のようになっているようだ。

latexmk起動時に-pdfオプションが指定されている¹。
latexmk実行時にカレントディレクトリは変更されていない。
- Latexmkの-outdirオプションでLaTeXの出力先を変えている。
- 従って、カレントにlatexmkrcがある場合は読み込まれる。
- ただし、latexmkrc内に$pdf_modeの設定を書いても、起動オプションの-pdfにより上書きされて、常に$pdf_mode=1となる。

Pandocで(u)pLaTeXする方法

以上のことから考えると、「Pandocで(u)pLaTeX＋dvipdfmxを使う」ためには以下のようにすればよいことがわかる。

pandocコマンドのオプションに-pdf-engine=latexmkを指定する。
latexmkのオプションに-pdfdvi（TeX→DVI→PDFのワークフローを指定）を追加するために、pandocのオプションに--pdf-engine-opt="-pdfdvi"も指定する。
カレントにlatexmkrcを置いて、そこに(u)pLaTeX＋dvipdfmxを使うための設定を書く。

つまり、Pandocのコマンド行は以下の形になる。

> pandoc --pdf-engine=latexmk --pdf-engine-opt="-pdfdvi" ......

latexmkrcの内容は（最低限として）以下のようにする。
※先述の通り、$pdf_modeの設定は効かないので不要。

upLaTeX＋dvipdfmxの場合：

$latex = 'uplatex';
$bibtex = 'upbibtex';
$dvipdf = 'dvipdfmx %O -o %D %S';
$makeindex = 'mendex -U %O -o %D %S';

pLaTeX＋dvipdfmxの場合：

$latex = 'platex -kanji=utf8';
$bibtex = 'pbibtex -kanji=utf8';
$dvipdf = 'dvipdfmx %O -o %D %S';
$makeindex = 'mendex -U %O -o %D %S';

もちろん、この設定はPDF生成に用いるコマンドを変更するだけのもので、PandocのLaTeXコード生成には何も影響を与えない。従って、ここで示したもの以外のPandocの設定は「途中で生成されるLaTeXファイルが(u)pLaTeXで通るようにする」必要がある。

実際にupLaTeXしてみた

例として、日本語のMarkdown文書をPandocのデフォルトのLaTeXテンプレートを通してupLaTeX＋dvipdfmxのワークフローでPDFに変換してみる。デフォルトのLaTeXテンプレートは本来は(u)pLaTeXには対応していないが、BXjsclsのクラスのPandocモードであれば利用できる。

※もちろん、カスタムのテンプレートを指定してもよい。

[test2.md]

---
title: PandocでupLaTeXしたい話
author: 某ZR
documentclass: bxjsarticle
classoption:
  - pandoc
papersize: a5
---

# upLaTeXできると何がうれしいか

よくわからない。

※先頭にYAML メタデータブロックを記述している。

これを次のコマンドで変換する。

> pandoc --pdf-engine=latexmk --pdf-engine-opt="-pdfdvi" test2.md -o test2.pdf
Latexmk: Run number 1 of rule 'latex'
Latexmk: Run number 2 of rule 'latex'
Latexmk: Run number 1 of rule 'dvipdf'

f:id:zrbabbler:20190506233146p:plain — test2.pdfの内容

別解

いちいちカレントにlatexmkrcを置くのは面倒である。代わりに、固定のディレクトリ（仮に/path/to/dirとする）にLatexmkの設定ファイルを置いた上でそれを-rオプションで読み込むという方法もある。

この場合、Pandocが生成するコマンド行において-rオプションが-pdfより後ろに置かれるため、設定ファイル内の$pdf_modeの記述で-pdfを上書きすることができる。従って、次のように$pdf_,modeを含めた設定ファイルを用意しておくとよい。

[/path/to/dir/uplatex-dpx.latexmk]

$latex = 'uplatex';
$bibtex = 'upbibtex';
$dvipdf = 'dvipdfmx %O -o %D %S';
$makeindex = 'mendex -U %O -o %D %S';
$pdf_mode = 3;

その上で、以下のコマンドを実行する²。（実際には改行なしの1行で入力する。）

pandoc --pdf-engine=latexmk
    --pdf-engine-opt="-r" --pdf-engine-opt="/path/to/dir/uplatex-dpx.latexmk"
    test2.md -o test2.pdf

まとめ

新しいPandocを使うと「Pandocで(u)pLaTeXする」のがチョットだけ楽になる、かもしれない。

実際のコマンド行は次の通り： latexmk -interaction=batchmode -halt-on-error -pdf -quiet -outdir=TEMPDIR TEMPDIR/input.tex；ここでTEMPDIRはPandocが生成した一時ディレクトリの名前。↩
一つの--pdf-engine-optでは一つのコマンド引数しか指定できないので、-r /path/to/dir/uplatex-dpx.latexmkというオプションを指定するには煩雑であるが--pdf-engine-optを2回書くしかないようである。↩

2019-05-03

TeX Liveで令和してみる話

LaTeX

新しいTeX Live 2019が、日本のCTANミラーサイトにも届き始めているようである。

yamagata-u のCTANミラーが TeX Live 2019になった😊#TeX #テフライブ
— ZR-TeXnobabbler🤔 (@zr_tex8r) 2019年5月2日

というわけで、早速、TeX Live 2019で令和してみる。和暦機能の説明については平成の記事で済ませてあるので、ここでは単純に結果だけを示す。

令和してみた結果

% pLaTeX文書
\documentclass[a4paper]{jarticle}
\和暦
\title{しあわせ{\TeX}言語入門}
\author{非ZR氏}
\begin{document}
\maketitle
% 中身はまだ無い。
\end{document}

f:id:zrbabbler:20190503072821p:plain — jarticleな出力結果

令和！

% upLaTeX文書; UTF-8
\documentclass[a4paper]{ujarticle}
\和暦
\title{しあわせ{\TeX}言語入門}
\author{非ZR氏}
\begin{document}
\maketitle
% 中身はまだ無い。
\end{document}

f:id:zrbabbler:20190503072842p:plain — ujarticleな出力結果

令和！

% upLaTeX文書; UTF-8
\documentclass[uplatex,a4paper]{jsarticle}
\和暦
\title{しあわせ{\TeX}言語入門}
\author{非ZR氏}
\begin{document}
\maketitle
% 中身はまだ無い。
\end{document}

f:id:zrbabbler:20190503072857p:plain — jsarticleな出力結果

令和！

% LuaLaTeX文書; UTF-8
\documentclass[a4paper]{ltjsarticle}
\和暦
\title{しあわせ{\TeX}言語入門}
\author{非ZR氏}
\begin{document}
\maketitle
% 中身はまだ無い。
\end{document}

f:id:zrbabbler:20190503072913p:plain — ltjsarticleな出力結果

令和！

% LuaLaTeX文書; UTF-8
\documentclass[lualatex,ja=standard,a4paper]{bxjsarticle}
\和暦
\title{しあわせ{\TeX}言語入門}
\author{非ZR氏}
\begin{document}
\maketitle
% 中身はまだ無い。
\end{document}

f:id:zrbabbler:20190503072940p:plain — bxjsarticleな出力結果

令和！

% LuaLaTeX文書; UTF-8
\documentclass[paper=a4]{jlreq}
\和暦
\title{しあわせ{\TeX}言語入門}
\author{非ZR氏}
\begin{document}
\maketitle
% 中身はまだ無い。
\end{document}

f:id:zrbabbler:20190503072959p:plain — jlreqな出力結果

令和！

% LuaLaTeX文書; UTF-8
\documentclass[tate,book,paper=b6,jafontsize=9pt]{jlreq}
\和暦
\title{しあわせ{\TeX}言語入門}
\author{非ZR氏}
\begin{document}
\maketitle
% 中身はまだ無い。
\end{document}

f:id:zrbabbler:20190503074100p:plain — 縦組のjlreqな出力結果

令和！

% LuaLaTeX文書; UTF-8
\documentclass[a4paper]{ltjsarticle}
% 例によってエスペラント
\usepackage[main=japanese,esperanto]{babel}
\newcommand{\Eo}[1]{%
  \begin{otherlanguage}{esperanto}#1\end{otherlanguage}}
\和暦
\title{しあわせ{\TeX}言語入門\\
  \Eo{Feliĉa Kurso pri la Lingvo {\TeX}}}
\author{mal-ZR}
\date{\today\quad(\Eo{\today})}
\begin{document}
\maketitle
% Neniu enhavo.
\end{document}

f:id:zrbabbler:20190503074141p:plain — Babelな出力結果

令和！

% upLaTeX文書; UTF-8
\documentclass[dvipdfmx,14pt]{beamer}
\usepackage{pxjahyper}
\renewcommand{\kanjifamilydefault}{\gtdefault}
\usepackage{bxwareki}% 和暦したい
\usetheme{EastLansing}
\title{しあわせ{\TeX}言語入門}
\author{非ZR氏}
\date{\warekitoday}% 和暦日付を明示指定する
\begin{document}
\begin{frame}
\titlepage
\end{frame}
\end{document}

f:id:zrbabbler:20190503074406p:plain — Beamerな出力結果

令和！

まとめ

令和したい人は、新しいTeX Liveをインストールしよう！

マクロツイーター

はてダから移行した記事の表示が崩れてますが、そのうちに直せればいいのに（えっ）