Two Column Pdf from Markdown

Markdownを2段組みPDFに変換することができるVS Codeのワークスペース．

動作環境

OSはWindows 10を対象とする．

依存ソフトウェア

これはVS Codeのワークスペースであるため，この機能を使うためにはVS Codeが必要である．また，このワークスペースは以下のソフトウェアに依存している．使用の前に，以下のソフトウェアをインストールしておく必要がある（ソフトウェアの名前をクリックすると，そのインストーラのwebページに移動する）．

クイックスタート

このワークスペースのクローン

git clone git@github.com:hajime0316/two_column_pdf_from_markdown.git

ワークスペースをVS Codeで開く

VS Codeを起動しファイル->フォルダを開くとクリックし，先ほどクローンしたフォルダを選択して開くをクリックする．

注意：ファイル->ワークスペースを開くではない．

サンプルのビルド

20190510_研究報告資料（サンプル）->20190510_研究報告資料.mdとクリックして，サンプルのMarkdownファイルを開く．サンプルのMarkdownファイルを開いた状態でショートカットキー「ctrl + shift + B」を押すと，そのMarkdownファイルがビルドされる． buildフォルダが作成され，その下に中間出力ファイルと最終的なPDFファイルが生成される．

PDFの表示

Markdownファイルを開いた状態で，ショートカットキー「ctrl + shift + P」を押しコマンドパレットを出す．コマンドパレットに「test task」と入力しエンターを押すと，Adobe Acrobat Reader DCが起動して先ほどビルドしたPDFファイルが表示される．

参考資料

使用しているPandocのコマンド

pandoc --template=latex/mytemplate.tex -s -f markdown-auto_identifiers -t latex -o "$output_dir/$input_file_name_without_extension.tex"

ただし，$output_dirはLaTeXファイルを出力するフォルダ名，$input_file_name_without_extensionはMarkdownファイルの拡張子を除いた名前である．

オプションの説明

オプション	説明
--template	変換先ファイルに使用するテンプレートファイルを指定する．--template=<テンプレートファイルのパス>として使用するる．
-s	スタンドアロンモードで変換．プリアンブル（`\documentclass`から`\begin{document}`まで）が付く．
-f	fromオプション．変換元のファイル形式指定．`-auto_identifiers`はハイパーリンクの自動付加を禁止する．`markdown-<拡張markdownのルール名>`とすることで，指定したPandocの拡張markdownのルールを無効にできる．
-t	toオプション．変換先のファイル形式指
-o	アウトプットファイルのファイル名を指定する．

画像ファイルの変換

Markdownで画像を扱う場合はPNGまたはJPGがよく，LaTeXで画像を扱う場合はEPSがよい．そこで，ビルドの段階でPNGとJPGの画像をEPSに変換するという処理を行っている．この変換処理には bmeps を用いている．

bmeps -c "$input_file" "$output_file"

windowsにおけるbashからのPDFの表示

VS CodeからPDFを表示するために，テストタスクに以下のようなコマンドを登録している． Adobe Acrobat Reader DCをコマンドラインから起動し，ビルドしたPDFを表示させる．

start AcroRd32; pdfopen.exe --file build/$fileBasenameNoExtension.pdf