pip3 install pdfkit
モジュールをインストールしたら、Jupyter Notebookも再起動しておこう。
その上で、以下のようなプログラムをJupyter Notebookに書き込んで実行してみよう。
import markdown
text = '''
# ウサギについて
全身が柔らかい体毛で覆われている小型獣である。
'''
md = markdown.Markdown() # ---(*1)
html = md.convert(text) # ---(*2)
print(html)
すると、以下のようなHTMLが生成されているのが確認できる。
ウサギについて
プログラムを見てみると、(＊1)の部分で、Markdownオブジェクトを作成し、(＊2)の部分のように、convert()メソッドを呼ぶだけ。とても簡単であることが分かる。
○HTMLからPDFを生成しよう
今回、PDFを生成するためには、pdfkitパッケージを利用するのだが、pdfkitは、内部で「wkhtmltopdf」というライブラリを利用する。そのため、別途「wkhtmltopdf」のインストールが必要となる。
Windowsであれば、こちら(https://wkhtmltopdf.org/downloads.html)からインストーラーをダウンロードできるので、wkhtmltopdfをインストールしよう。その後、wkhtmltopdfを環境変数のPathに追加する必要がある。なお、環境変数を編集するには、Windows10では、コントロールパネルから、[システムとセキュリティ>システムの詳細設定>システム>環境変数]をクリックする。
macOSであれば、Homebrewを使ってインストールできる。その場合、ターミナルを起動して「brew cask install Caskroom/cask/wkhtmltopdf」とコマンドを入力する。Homebrew自体のインストールは、こちら(https://brew.sh/index_ja.html)を参考にしよう。
wkhtmltopdfのインストールが完了したら、Jupyter Notebookで以下のコードを実行してみよう。
import markdown
import pdfkit
text = '''
# 今日やること
- 切手を買う
- xxの資料を作る
'''
# HTMLに変換
md = markdown.Markdown() # ---(*1)
body = md.convert(text) # ---(*2)
# HTML出力用のヘッダを足す # ---(*3)
html = ''
html += ''
html += body + ''
# PDF出力
pdfkit.from_string(html, "test.pdf") # --- (*4)
プログラムを実行すると、以下のようなPDFが出力される。
プログラムを確認してみよう。(＊1)の部分では、Markdownオブジェクトを作成し、(＊2)でテキストをHTMLに変換する。(＊3)の部分では、HTMLに文字コードやフォントサイズの指定を追加し、(＊4)の部分で、PDFを生成する。pdfkitパッケージとwkhtmltpdfを使うと、以下のように一行でPDFを生成できる。
[書式] PDFを生成する
pdfkit.from_string(入力HTML文字列, 出力PDFファイル名)
もし、用紙のマージンを設定したい場合には、以下のようにオプションを指定することもできる。
# オプションを指定
options = {
'page-size': 'A4',
'margin-top': '0.75in',
'margin-right': '0.75in',
'margin-bottom': '0.75in',
'margin-left': '0.75in',
'encoding': "UTF-8"
}
# PDFを生成
pdfkit.from_string(html, "test.pdf", options=options)
○指定ディレクトリのファイルを全部PDFに変換しよう
続いて、指定ディレクトリにあるMarkdownで書かれたテキストファイルを全部PDFに変換するプログラムを作ってみよう。
import markdown
import pdfkit
import glob
path = "." # ここに変換対象ディレクトリを指定
files = glob.glob(path + "/*.md")
for f in files:
# Markdownのテキストを読む
with open(f, "rt", encoding="utf-8") as fp:
text = fp.read()
# HTMLに変換
md = markdown.Markdown()
body = md.convert(text)
html = ''
html += ''
html += body + ''
# PDFで出力
outfile = f + ".pdf"
pdfkit.from_string(html, outfile)
print("ok")
Pythonで『glob.glob("*.md")』のように書くと、拡張子が「.md」のファイル一覧を取得する。あとは、for文を使って繰り返しファイルを読み出し、Markdownのファイルを読み出して、PDFファイルを出力するという具合だ。
○まとめ
以上、今回は、Markdown記法からPDFを生成するプログラムを紹介した。ここでは、直接PDFを出力するのではなく、Markdown→HTML→PDFと順に変換していく手順を踏んだ。
面倒にも感じるが、HTMLはCSSを利用して自由にデザインが変更できるので、都合が良い。ここで紹介したサンプルでは、文字の大きさ程度しかCSSを適用していないが、PDFを生成する前のHTMLに独自のCSSを加えるなら、見栄えをぐっと良くすることができる。
実は、今回のプログラムは、Markdownで書き貯めたマニュアルを一気にPDFに変換する必要があり作成したものだ。業務などで特定のフォーマットに沿って、PDFを出力する場面は多いので、今回のプログラムが参考になるだろう。
モジュールをインストールしたら、Jupyter Notebookも再起動しておこう。
その上で、以下のようなプログラムをJupyter Notebookに書き込んで実行してみよう。
import markdown
text = '''
# ウサギについて
全身が柔らかい体毛で覆われている小型獣である。
'''
md = markdown.Markdown() # ---(*1)
html = md.convert(text) # ---(*2)
print(html)
すると、以下のようなHTMLが生成されているのが確認できる。
ウサギについて
全身が柔らかい体毛で覆われている小型獣である。
プログラムを見てみると、(＊1)の部分で、Markdownオブジェクトを作成し、(＊2)の部分のように、convert()メソッドを呼ぶだけ。とても簡単であることが分かる。
○HTMLからPDFを生成しよう
今回、PDFを生成するためには、pdfkitパッケージを利用するのだが、pdfkitは、内部で「wkhtmltopdf」というライブラリを利用する。そのため、別途「wkhtmltopdf」のインストールが必要となる。
Windowsであれば、こちら(https://wkhtmltopdf.org/downloads.html)からインストーラーをダウンロードできるので、wkhtmltopdfをインストールしよう。その後、wkhtmltopdfを環境変数のPathに追加する必要がある。なお、環境変数を編集するには、Windows10では、コントロールパネルから、[システムとセキュリティ>システムの詳細設定>システム>環境変数]をクリックする。
macOSであれば、Homebrewを使ってインストールできる。その場合、ターミナルを起動して「brew cask install Caskroom/cask/wkhtmltopdf」とコマンドを入力する。Homebrew自体のインストールは、こちら(https://brew.sh/index_ja.html)を参考にしよう。
wkhtmltopdfのインストールが完了したら、Jupyter Notebookで以下のコードを実行してみよう。
import markdown
import pdfkit
text = '''
# 今日やること
- 切手を買う
- xxの資料を作る
'''
# HTMLに変換
md = markdown.Markdown() # ---(*1)
body = md.convert(text) # ---(*2)
# HTML出力用のヘッダを足す # ---(*3)
html = ''
html += ''
html += body + ''
# PDF出力
pdfkit.from_string(html, "test.pdf") # --- (*4)
プログラムを実行すると、以下のようなPDFが出力される。
プログラムを確認してみよう。(＊1)の部分では、Markdownオブジェクトを作成し、(＊2)でテキストをHTMLに変換する。(＊3)の部分では、HTMLに文字コードやフォントサイズの指定を追加し、(＊4)の部分で、PDFを生成する。pdfkitパッケージとwkhtmltpdfを使うと、以下のように一行でPDFを生成できる。
[書式] PDFを生成する
pdfkit.from_string(入力HTML文字列, 出力PDFファイル名)
もし、用紙のマージンを設定したい場合には、以下のようにオプションを指定することもできる。
# オプションを指定
options = {
'page-size': 'A4',
'margin-top': '0.75in',
'margin-right': '0.75in',
'margin-bottom': '0.75in',
'margin-left': '0.75in',
'encoding': "UTF-8"
}
# PDFを生成
pdfkit.from_string(html, "test.pdf", options=options)
○指定ディレクトリのファイルを全部PDFに変換しよう
続いて、指定ディレクトリにあるMarkdownで書かれたテキストファイルを全部PDFに変換するプログラムを作ってみよう。
import markdown
import pdfkit
import glob
path = "." # ここに変換対象ディレクトリを指定
files = glob.glob(path + "/*.md")
for f in files:
# Markdownのテキストを読む
with open(f, "rt", encoding="utf-8") as fp:
text = fp.read()
# HTMLに変換
md = markdown.Markdown()
body = md.convert(text)
html = ''
html += ''
html += body + ''
# PDFで出力
outfile = f + ".pdf"
pdfkit.from_string(html, outfile)
print("ok")
Pythonで『glob.glob("*.md")』のように書くと、拡張子が「.md」のファイル一覧を取得する。あとは、for文を使って繰り返しファイルを読み出し、Markdownのファイルを読み出して、PDFファイルを出力するという具合だ。
○まとめ
以上、今回は、Markdown記法からPDFを生成するプログラムを紹介した。ここでは、直接PDFを出力するのではなく、Markdown→HTML→PDFと順に変換していく手順を踏んだ。
面倒にも感じるが、HTMLはCSSを利用して自由にデザインが変更できるので、都合が良い。ここで紹介したサンプルでは、文字の大きさ程度しかCSSを適用していないが、PDFを生成する前のHTMLに独自のCSSを加えるなら、見栄えをぐっと良くすることができる。
実は、今回のプログラムは、Markdownで書き貯めたマニュアルを一気にPDFに変換する必要があり作成したものだ。業務などで特定のフォーマットに沿って、PDFを出力する場面は多いので、今回のプログラムが参考になるだろう。
- 前へ
- 2/2