マニュアルの何処にも書いてないと思いますが、docxに出力するときにSpanに特定のclassを与えることでWordのコメント機能を使えるということに気づきました。
入力にこんな感じの文を与えてdocxに変換します。
aaa[bbb]{.comment-start}ccc[ddd]{.comment-end}
結果のスクリーンショットはこんな感じ。
bbbのところがコメントになり、dddは無視されていますね。逆にdocxを入力にした場合は上記のように逆変換されるはずです。試してないけどコードはそれっぽいので（ダメそうならissue建てて）
ソースを1行ずつ精読してooxmlの資料等と突き合わせていたら見つけたけど、これは誰得なんだ…
私はただodt形式の出力にシンタックスハイライトをつけたいだけなのに…どうしてこんなことを…
なんと、この書きづらいSpanを簡便な記法で処理してくれるlua filterをK4zuki氏が書いてくれました。pandockerを使えば簡単に使えますね！
Pandocの、ODT形式での出力をdocx形式での出力と同程度のコトが出来るようにしたく、調査等をしています。
とりあえず手が付けられそうなtoc-depthの修正を試みました。
修正自体は2行だけなのですが、PR出すのは初めてなので色々手間取りました…。そもそもgitの使い方を忘れているというアレ…。
ODTはtemplateを見に行くので、そちらに値を出せるようにWriterを修正、template自体もその値を埋め込めるように修正です。修正箇所はPRの方でdiff表示してもらえれば良いのでそちらで。
これで次のリリースからは使用可能と思いますが、もし変な挙動してたら教えてください…（仕組み的に変な動きはしないと思うんですが…）
Pandoc 2.10.1 から docx の出力で --number-sections オプションがサポートされました。
これをodtにも入れたいなぁと思ってコードを見ていましたが、Writerにべったり依存なのでコードをかなり追わないといけないなということが分かっています。
ひとまず挙動から確認しているので、その途中のメモ。
対応するコードはこのあたり。
このコードを見ればわかると思うのですが、Headerに対して処理を加えています。
また、実際のセクション番号はこのあたりで処理していて、
attributesにnumberがあればそれを利用することがわかります。
で、このnumberについてはPandoc's ASTで確認すると入っていません。なので、Writerの処理の中で附番されていることと考えられます。
一方で、Headerにnumber attributesをつけておけば、その値が入ることが予想できますね。
実際、
## R Markdown {number=100.1.1}
のようにすれば、
となり、値が反映されることがわかります。ただし、次の節などにはこの値は引き継がれないので注意。
一方で、unnumberedクラスは有効で、コレをつければ附番されません。
#### aaa {.unnumbered}
なお、{.unnumbered number=100}のようにすればnumberの方が勝ち、番号付きになります。
docxはMS Word上で結合できます。リンク形式にする場合は下記のページの説明が分かりやすいです。
これをunzipして見てみると、_relsに実際のファイル名を入れているため、word/document.xml単体では処理できないので、Pandocの処理内でここもあわせて作成ということは難しそう。その代わり、事前に章ごとにファイルを決めておいて、このドキュメントのひな型の枠に入れるのは良さそう。ただし章番号がどうなるのかは不明。あと、TOCは生成できるのか？みたいなのもある。
odtの場合、LOW上で結合する方法はこちらのWikiに書いてある。LibreOfficeはWikiに結構書いてあるので良いですね。ただし、日本語化したときの文字列はバージョンごとに揺らぎがあるかもしれないので、なんとなく雰囲気で理解する必要があるかもしれない。
こちらはcontent.xmlで閉じていそうなのだが、デフォルトの表示文字列も一緒に含まれているようなので、Pandocでこれを自動生成した場合には一度odtファイルをLOWで開いて更新という処理が必要になりそうだなと考えています。それ以外の章番号などの話はdocxと同様に問題になるかも。
どちらももう少し実例でやってみないとわからないので、「とりあえずやってみるぞ」という気持ちをここに書いておきます。いつまでもやってないようならだれかつついてみてください…。
Pandocは日々進化しています。自分が使うファイル形式の更新はなくてもそれ以外の形式に対しては後進が入っていたりするので、マニュアルは日々更新されて行きます。
これを、releaseのたびに見ていくと大変なんですが、よくよく考えるとファイル単位でチェックすればいいじゃないか、と。具体的にはココ。
これで、各commitで何が更新されているのかがわかりますね。簡単なことデス（それをトラックしていくのが簡単とは言っていない…
Github File Watcherなるものがあるので、コレが使えないか検討中…
初心者に向けては翻訳された情報の有無が結構大事だと思っているのですが、どうしても翻訳した情報が古くなってしまうので、これをなんとか維持できる方法はないかなって考えているこの頃です。
先日、色々見ていたら気づいたのですが、captionerパッケージがArchivedになっていました。
ので、さっそくFork...
このパッケージはRMarkdownでWord文書を作ろうのときに使っていたのですが、今後CRANから落ちてしまったら復活の芽がなくなってしまったのでなんとかしたいな…と思って少しずつコード読み中です。
Feel free to fork, copy, use as desired. No attribution necessary.
とあるので、自由に使わせていただくです…。 一応、MITライセンスっぽいですしね…
