====== pagebreak ======
===== 概要 =====
  * 改ページを挿入する Pandoc フィルタ
  * github:
    * [[https://github.com/pandoc-ext/pagebreak | GitHub - pandoc-ext/pagebreak: Manual page breaks]]
    * [[https://github.com/pandoc/lua-filters | GitHub - pandoc/lua-filters: A collection of lua filters for pandoc]]


===== インストール =====
  * github (lua-filters) から git でクローンする。\\ <code bash>
$ git clone https://github.com/pandoc/lua-filters.git
</code>


===== 使用方法 =====
  - markdown テキストの改ページを挿入したい箇所に ''\newpage'' か ''\pagebreak'' を入力した行を追加する。
  - 変換する。\\ <code bash>
$ pandoc --lua-filter lua-filters/pagebreak/pagebreak.lua INPUT.md -o OUTPUT.docx
</code>
    * ''INPUT.md'': 入力ファイルの markdown テキスト
    * ''OUTPUT.docx'': 出力ファイル
    * ''--lua-filter'': クローンした ''pagebreak.lua'' のパス
      * 出力サポートフォーマット:
        * AsciiDoc / Asciidoctor
        * ConTeXt
        * Docx
        * EPUB
        * groff ms
        * Typst
        * LaTeX
        * ODT (.odt ファイルの場合は追加の設定が必要)


==== ODT の追加設定 ====
  - LibreOffice Writer で .odt の新規ファイルを作成する (開く)。
  - "スタイル" → "スタイルの管理" を選択するか、F11 キーを押す。
  - 右サイドバーに現れたスタイルバーから "標準段落スタイル" を右クリックする。
  - 右クリックメニューから "新規" を選択する。\\ {{:ツール:pandoc:1.svg.png?direct&400|}}(クリックで拡大)
  - 段落スタイルダイアログで段落を設定する。
    * "管理" タブの "名前" を "Pagebreak" にする。\\ {{:ツール:pandoc:2.svg.png?direct&400|}}(クリックで拡大)
    * "体裁" タブを設定する。\\ {{:ツール:pandoc:3.svg.png?direct&400|}}(クリックで拡大)
      * "挿入" にチェックを入れる。
      * "種類" を "ページ" にする。
      * "位置" を "前" か "後" にする。
  - "OK" ボタンをクリックする。
  - 保存する (今回は ''style.odt'' とする)。
  - 保存した .odt ファイルをテンプレートに、markdown テキストファイルを変換する。\\ <code bash>
$ pandoc --lua-filter lua-filters/pagebreak/pagebreak.lua --reference-doc style.odt INPUT.md -o OUTPUT.odt
</code>



===== 参考サイト =====
  - [[https://niszet.hatenablog.com/entry/2020/09/04/083000 | （Pandoc）ODT形式は改ページ挿入のためのスタイルの指定が必要。 - niszetの日記]]



{{tag>アプリケーション テキスト}}