#author("2023-01-19T11:25:53+00:00","default:hotate","hotate")
#author("2023-01-19T11:26:06+00:00","default:hotate","hotate")
#contents
&tag(ドキュメント);

* バージョン [#o3004b16]
- [[「Pandoc 3.0」が公開 ～さまざまな形式の文書と相互変換できるフリーツール - 窓の杜>https://forest.watch.impress.co.jp/docs/news/1471684.html]] (2023/01/19)
- [[「Pandoc 3.0」が公開 ～さまざまな形式の文書と相互変換できるフリーツール - 窓の杜>https://forest.watch.impress.co.jp/docs/news/1471684.html]] ([[2023]]/01/19)
 メジャーバージョンアップとなる「Pandoc 3.0」では、パッケージが以下の3つに分割された。

* 機能 [#oa1d9f9a]
** [[リファレンス]] [#v61a3177]
- [[Pandoc ユーザーズガイド 日本語版 - Japanese Pandoc User's Association>http://sky-y.github.io/site-pandoc-jp/users-guide/]]
 Pandocは Haskell で書かれたライブラリおよびコマンドラインツールであり、 あるマークアップ形式で書かれた文書を別の形式へ変換するものです。
- [[PandocとMarkdownによるアカデミックライティング - Qiita>https://qiita.com/TomosurebaOrange/items/1ee83f56cd853a9ba5cd]] (2019/12/22)
 本記事では，Pandocユーザーを増やすことを目的に，MarkdownやPandocなどに親しみのない研究者層に対して，MarkdownとPandocで論文を執筆する利点について紹介します．

** 見出し [#s7a9c204]
- [[実務に使うプレーンテキスト→Microsoft Word変換、あるいはPandocを使い始めた話 - 技術memo>https://nenono.hatenablog.com/entry/2015/02/10/173516]] (2015/02/10)
 見出しに番号を付けます。
 参考: Word2010：1、1-1、1-1-1のアウトライン番号を設定するには？ - 教えて！HELPDESK
 アウトライン -> 新しいアウトラインの定義 -> レベルと対応付ける見出しスタイル なんて気づかないですよね普通……
-- コメント：[[Word]]のバージョンが古いとアウトラインを好みのスタイルに設定できなかった。(2021/11/30 [[Windows10]])
- [[Pandocで出力形式に依存せず見出し番号をつけたり、第1章とか第1.1節とか装飾したい | Atusy's blog>https://blog.atusy.net/2020/12/24/decorate-section-numbers-on-any-format-with-pandoc/]]
 今日は任意の出力に対応するLuaフィルタを用意しました。
-- [[atusy/lua-filters>https://github.com/atusy/lua-filters]]
-- コメント：[[Word]]出力にて見出し番号がズレる（セクション番号が1にリセットされず、前セクションの続きになってしまう）場合、上記のフィルタを使って[[Markdown]]側で加工することで解消された。(2021/12/01 BigSur)

** 目次 [#ze08e7fd]
- [[VSCode x Markdown で MS Word 文書の作成 | TELLNNN>https://tellnnn.netlify.app/post/vscode/word/#word-%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%81%AE%E6%8C%87%E5%AE%9A]] (2020/08/30)
 「目次の見出し」は「見出し 1」を参照しているので、目次の見出しに章番号を振りたくないときは、「見出し 1」などにアウトラインを定義したあと、「目次の見出し」でアウトラインを「なし」に設定するとうまくいきます。
-- コメント：上記の方法にて成功した。(2021/11/29 BigSur)

** 改頁 [#vc9c4f13]
- [[VSCode x Markdown で MS Word 文書の作成 | TELLNNN>https://tellnnn.netlify.app/post/vscode/word/#%E6%94%B9%E3%83%9A%E3%83%BC%E3%82%B8]] (2020/08/30)
 改ページを行うために、上で後述するとした、lua-filter を使う方法をご紹介します。
-- コメント：期待通りに改ページされた[[Word]], [[PDF]]ファイルが生成された。(2021/11/29 BigSur)

** 画像 [#k3b3c4e5]
- [[まだ Word で消耗してるの？ 大学のレポートを Markdown で書こう - Qiita>https://qiita.com/Kumassy/items/5b6ae6b99df08fb434d9#-%E7%94%BB%E5%83%8F%E3%81%AE%E5%A4%A7%E3%81%8D%E3%81%95%E3%82%92%E5%A4%89%E3%81%88%E3%82%8B]]
 次のようにすると、画像の大きさを指定することができます。使える単位は % か mm です2。適当に画像の大きさを調整すると、少しはマシなレイアウトになるでしょう。
 ![とても重要な図](the_great_graph.png){#fig:graph height=70%}

** プロパティ [#r4bafa06]
- [[Wordより楽に、本格的な文書作成 Pandoc Markdown - Mimir Yokohama>https://www.mimir.yokohama/useful/0017-pandocmarkdown.html#yaml-front-matter]]
 YAML front matterは文書の先頭に---だけの行で囲まれた形で配置されます。 記述方法はYAMLというデータ表現形式に従います。
-- コメント：別ファイルに記載して実行時に指定する場合でも、末尾の"---"が必要。通常のYAML出力ではされない為、意図的に追記する必要がある。(2021/12/07)

** 箇条書き [#f87ef066]
- [[MS-Wordの箇条書きについて>http://cup.sakura.ne.jp/wrdap/list_wrd.htm#pandoc]]
 (1) 記号付きの箇条書き
 箇条書きを入れ子にすることもできます。その場合、行頭に半角スペース４個、または１つのタブを置きます。
-- コメント：上記の指定が有効だった。なお「半角スペース４個」以外の時、インデントが上手く合わなかった。(2022/01/06)
 数字の他に、大文字または小文字のアルファベット、あるいは、大文字または小文字のローマ数字をリストマーカとして使うことができます。
-- コメント：上記の指定が有効だった。(2022/01/06)


* 出力 [#bc7746ae]

** [[Word]] [#cf221ea7]
- [[pandocでmarkdown形式ファイルからwordドキュメント(*.docx)を作成する | DevelopersIO>https://dev.classmethod.jp/articles/pandoc_markdown_to_docx/]] (2019/01/10)
 markdownからひな形のスタイルに合わせつつドキュメントが作成できたら便利だなーと探したところ、ちょうどよいpandocというツールを見つけましたので、ここでご紹介したいと思います。
-- コメント：上記のサンプルが動作することを確認した。(2021/11/24 BigSur, [[Windows10]])
-- コメント：[[Word]]ファイルの体裁はほぼOK。[[Word]]テンプレートにて個別の体裁ではなく、スタイル設定を変更すること。(2021/11/28)
- [[プログラマの文書作成術：Markdown, LaTeXなどの文書からWord文書を生成する - Qiita>https://qiita.com/sky_y/items/aab3f93a32a711a54e74]] (2014/02/12)
 ドキュメント変換ツールPandocを用いてMarkdownやLaTeX文書などからWord文書を作成する方法を紹介します。
- [[VSCode x Markdown で MS Word 文書の作成 | TELLNNN>https://tellnnn.netlify.app/post/vscode/word/]] (2020/08/30)
 この記事では VSCode とその拡張機能を使って作成した .md ファイルを .docx ファイルに書き出すことを目指します。
-- 関連：VisualStudioCode
- [[ドキュメント作業で楽をしたい - NaCl非公式ブログ>https://nacl-ltd.github.io/2016/03/10/easy-documentation.html]] (2016/03/10)
 docxはXMLで構成されているため、構造がわかればWordを直接触らなくても加工することが可能です。先に挙げた「痒いところ」をなんとかできないかと以下のようなツールを作ってみました。

** [[PDF]] [#l11f9af9]
*** [[wkhtmltopdf]] [#j807c813]
- [[pandocでmarkdown形式ファイルからwordドキュメント(*.docx)を作成する | DevelopersIO>https://dev.classmethod.jp/articles/pandoc_markdown_to_docx/]] (2019/01/10)
-- コメント：[[wkhtmltopdf]]を使った[[PDF]]ファイルの体裁は崩れる（HTML出力時、章見出しレベル5, 6が斜体になってしまう、見出し数字のベースラインがずれる等）。[[WeasyPrint]]を使う場合も同様の結果だが、更に見出しに数字が入らない。(2021/11/28)
- [[Pandocで.mdを.pdfに変換する環境構築（TeX無し） - Qiita>https://qiita.com/Kent_recuca/items/8ef1cbaac58565609536]]
 LateXと組み合わせるのがセオリーのようですが、今回はwkhtmltopdfというMarkdownやHTMLをPDFに直すツールを使います。
- [[pandocのpdf出力にwkhtmltopdfを使ってみる - みつきんのメモ>https://mickey-happygolucky.hatenablog.com/entry/2020/12/17/011452]]
 この記事ではWindows環境での話だったので、Ubuntu20.04で同様のことができないか確認した。
-- コメント：[[wkhtmltopdf]]をインストール後、[[PDF]]が生成されることを確認した。(2021/11/24 BigSur, [[Windows10]])

*** [[WeasyPrint]] [#c045d19e]
- [[Pandoc, Weasyprint, and PDF generation – esq.io>https://esq.io/2020/01/pandoc-weasyprint-and-pdf-generation/]]
 So now, for the final touch, if I really really want a beautiful PDF, I can use Weasyprint, which is another tool that specializes in converting HTML to PDF. 

** PowerPoint [#kf0cc0bd]
- [[【Pandoc】MarkDown記法でPowerPointを作成する | bitware(ビットウェア)>https://bitware-blog.com/2019/01/31/%E3%80%90pandoc%E3%80%91markdown%E8%A8%98%E6%B3%95%E3%81%A7powerpoint%E3%82%92%E4%BD%9C%E6%88%90%E3%81%99%E3%82%8B/]]
 このように「#」ごとにきれいにスライドが別れており、MarkDownでPowerPointを無事に作成できることができます。

** テンプレート [#x09ed7e8]
- [[Pandocのテンプレート機能でYAMLから本の奥付を自動生成する - Qiita>https://qiita.com/sky_y/items/47da01623f50380c2023]] (2019/12/01)
 この記事ではPandocのテンプレート機能を紹介します。（中級者向け）
 そしてテンプレートの応用として、冊子本（特に技術同人誌）をつくる上で欠かせない奥付をYAMLファイルから生成する方法も説明します。

** フィルタ [#wffc0486]
- [[Luaフィルタがアツイ2020 | Atusy's blog>https://blog.atusy.net/2020/12/07/lua-filter-is-hot/]]
 多様なドキュメントフォーマット間を変換できるPandocでは、 「フィルター」という機能を使って、変換処理に割り込みをかけることができます。
- [[Markdownで相互参照を使うならpandoc-crossref - DiaryException>https://laclefyoshi.hatenablog.com/entry/20150616/crossref]] (2015/06/16)
 プラグインの1つにMarkdownドキュメント内での相互参照を実現するpandoc-crossrefがある。

* 関連 [#v21bf426]
#related
トップ   編集 差分 履歴 添付 複製 名前変更 リロード   新規 一覧 検索 最終更新   ヘルプ   最終更新のRSS