Pandocは日々進化しています。自分が使うファイル形式の更新はなくてもそれ以外の形式に対しては後進が入っていたりするので、マニュアルは日々更新されて行きます。
これを、releaseのたびに見ていくと大変なんですが、よくよく考えるとファイル単位でチェックすればいいじゃないか、と。具体的にはココ。
これで、各commitで何が更新されているのかがわかりますね。簡単なことデス（それをトラックしていくのが簡単とは言っていない…
Github File Watcherなるものがあるので、コレが使えないか検討中…
初心者に向けては翻訳された情報の有無が結構大事だと思っているのですが、どうしても翻訳した情報が古くなってしまうので、これをなんとか維持できる方法はないかなって考えているこの頃です。
先日、色々見ていたら気づいたのですが、captionerパッケージがArchivedになっていました。
ので、さっそくFork...
このパッケージはRMarkdownでWord文書を作ろうのときに使っていたのですが、今後CRANから落ちてしまったら復活の芽がなくなってしまったのでなんとかしたいな…と思って少しずつコード読み中です。
Feel free to fork, copy, use as desired. No attribution necessary.
とあるので、自由に使わせていただくです…。 一応、MITライセンスっぽいですしね…
下書きのまま放置していたので、忘れてしまわないうちに書く。
stylexパッケージ、docxのstyleをR上で加工しやすくしようと思って作っていたのですが、docxファイルを記述しているOOXMLは、w:nameのようにw:のnamespaceが与えられています。
xml2パッケージでこのnamespaceつきのタグ、w:nameなどを入れる場合、あらかじめそのnamespaceを定義しているrootを作るなりしないといけないようです（仕様に書いてあるかもしれないけど見つからなかった
例えばこんな感じに。
xml2::xml_new_root( "styles", "Ignorable"="w14 w15 w16se w16cid w16 w16cex", "xmlns:mc"="http://schemas.openxmlformats.org/markup-compatibility/2006", "xmlns:r"="http://schemas.openxmlformats.org/officeDocument/2006/relationships", "xmlns:w"="http://schemas.openxmlformats.org/wordprocessingml/2006/main", "xmlns:w14"="http://schemas.microsoft.com/office/word/2010/wordml", "xmlns:w15"="http://schemas.microsoft.com/office/word/2012/wordml", "xmlns:w16cex"="http://schemas.microsoft.com/office/word/2018/wordml/cex", "xmlns:w16cid"="http://schemas.microsoft.com/office/word/2016/wordml/cid", "xmlns:w16"="http://schemas.microsoft.com/office/word/2018/wordml", "xmlns:w16se"="http://schemas.microsoft.com/office/word/2015/wordml/symex" )
これは実際にPandocで生成したdocxをxml2パッケージで読み込んだ際に含まれていたものを列挙しているだけです。これを、stylexパッケージ中でも使うようにしました。
コード内に定数を書いている状態なので、新しいPandocが出てきたときなどに更新が入った場合、それに追従しないといけないというデメリットはありますが、現時点でどうなるかわからんものはとりあえず動くことを重視…（毎回Pandocを起動して、docxからnamespaceを抽出して…とやってもいいものの、そこまでする…？という…）
いないと思いますが、R上で同様のことをしようとして詰まった人のために書き残しておきます。
こちらの記事とまったく同じモチベーションで、エラーメッセージを英語にして報告したいな、と。
で、これを設定すると以降は英語でエラーメッセージが出てきて便利。
Sys.setlocale("LC_CTYPE","English")
しかし、ここで日本語ファイル名で保存するコードとかを書くとRがabortします。何度かやらかしてつらい気持ちになったのでメモとして。
localeについてはこちらにもまとまっていたのでこちらも見ると良いカモ…。ややこしいわね…。
が、よくよく考えるとエラーレポートの時はreprexパッケージ使うよねってのと、そのとき英語設定になるのでこの設定をユーザがわざわざやる必要はないかな、という結論になりました（結論を先に書け）
Pandocのシンタックスハイライトはskylightingが担っています。これはPandoc内に埋め込まれているので、フィルタ等で制御できる奴ではないです。
で、Pandocは特定の出力形式にのみハイライト対応しています。
Currently highlighting is supported only for HTML, EPUB, Docx, Ms, and LaTeX/PDF output.
とのこと。
ODTについて対応していないことは日記にも書きました。
これは結局どういうことか？というと、掲題のとおりPandocのWriter内で対応する処理が書かれているかどうか？に依存します。対応する文字トークンに対してスタイルを生成してドキュメント内に納める、といったことをする必要があります。
Docx.hsではここ（styleToOpenXml）で処理しています。
これをODTにも移植すればいいはずなので、検討中です。
でもまぁコードを読んでいると、
where alltoktypes = enumFromTo KeywordTok NormalTok
とかあるわけです。このTok系はSkylighting内で定義されていて、Styles.hsの中にいます。
コレら、依存しているモジュールを読み解かないといけないので大変…。と言っても最低限で良いし、HackageとかVSCode上のHaskell拡張によってどのモジュールなのか、定義はどうなのかがわかるのでそれほどではないんですけどね。順を追ってやれば理解できるのではないかなと思っていますが…。
ドキュメントを書き出す場合、書き出す順序が重要なので普通のプログラムとあまり見た目で変わりなく（そうか？）、処理がそれぞれ関数化されているなぁ…で見ていけば良いので、対応関係を取ることが比較的やりやすいのではと思います。
みんなもPandocのWriterのコード読んでcontributeしようよ（私はまだしていないけど。
ODT形式について調べていると、Wordのそれに比べるとすべてがスタイルで作られている、という設計思想が垣間見えるのでLibreOffice関係でスタイル関係の資料がないか検索したところ、いくつか良い資料が見つかったのでここにまとめておきます。困ったらこれ読んだらいいんじゃないかな？と、今後はとりあえず伝えればよいかな…。
www.slideshare.net
www.slideshare.net
www.slideshare.net
www.slideshare.net
これの、Pandocで活用するためには…版を作りたいですねぇ（作りたいという気持ちを表明するだけ…
他のファイル形式の出力と同様に、PandocでODT形式で出力する場合にも、generic-raw-attributeを使用して出力ファイルに直接文字列を埋め込むようなことが可能です。これは対象のファイルに直接埋め込まれるため、出力ファイル形式の文法的に正しいものでなくてはいけません。
例えば以下のコードを（行頭のバックスラッシュは、はてな上でbacktick x3を入れるための苦肉の策。コピペするときは取り除いてください）埋め込むことで、任意の位置にAuthorスタイルが適用された"Author"という文字列を埋め込むことが出来ます。
\```{=opendocument}
<text:p text:style-name="Author">Author</text:p>
\```
例として上記のコードを書きましたが、実際に使用する場合は所望の箇所に必ず同じ書式で書かれて欲しいということが多いと思いますので、テンプレートかreference.odtのどちらかを使用する方が良いでしょう。
raw記法は何でも出力できてしまうので、ゴミデータを入れると出力ファイルが破損して開けないということもあるので注意しましょう。出力先のファイル形式の文法的に正しいもの以外が入っている場合の挙動はアプリケーション依存となります。使用の際は出力するファイル形式の文法仕様をしっかり確認しましょう。
MS WordやLibreOfficeWriterは破損したドキュメントもある程度読んでくれますが（特にMS Wordはそうです）、意図したように復元されるとは限らないですし、エラーのないデータが生成できるようにしましょう。
ODT形式の場合、文法の詳細は最新のODF1.3の仕様を確認してください。
しかし、Pandocは現時点ではODFのバージョン1.2として出力しているので、1.3と1.2の更新部分に相当する記述を埋め込むと意図しない結果になるかもしれませんので注意が必要かもしれません（未調査です…）
ODF1.3についてはこの記事などを見ると良いかもです（ドキュメントへのリンクもあって便利…）
ja.blog.documentfoundation.org
ということで、ODT形式でもraw記法が使用可能なので、body部分に埋め込めるタグであればカスタマイズが容易に出来そうですね。
