晴耕雨プログラミング

wkhtmltopdfのインストール

wkhtmltopdf is a prerequisite when generating PDF. 
Please install it from https://wkhtmltopdf.org/downloads.html 
and save the executable folder to %PATH% first. 
Alternatively you can install it from https://chocolatey.org 
with `choco install wkhtmltopdf`.

pdfフォルダを作成し、中にtoc.ymlを置く

toc.yml

- name: Articles
  href: ../articles/toc.yml
- name: Api Documentation
  href: ../api/toc.yml

docfx.jsonにPDF関連のセクション追加

wkhtmltopdfのオプション

ページ番号を表示させる場合の例

...
"pdf": {
  "wkhtmltopdf": {
    "additionalArguments": "--footer-center [page]"
  },
  "content": [
...

PDF用CSSの調整

デフォルトのPDF用テンプレートをエクスポート

docfx template export pdf.default

カスタムテンプレートの作成

• fontsフォルダがエクスポートしたpdf.defaultにはなかったので、defaultからコピー。
• main.cssは元々空なので、エクスポートしたものをコピーしなくても同じ名前で作成した方が文字コードUTF-8になるかも。
• token.json：唯一pdf.defaultからコピー。

docfx.jsonの編集

"pdf": {
  "template": [
    "pdf.default",
    "templates/pdf"
  ],

main.cssに追記

@font-face {
    font-family: 'Glyphicons Halflings';
    src: url(../fonts/glyphicons-halflings-regular.eot);
    src: url(../fonts/glyphicons-halflings-regular.eot?#iefix) format('embedded-opentype'),url(../fonts/glyphicons-halflings-regular.woff2) format('woff2'),url(../fonts/glyphicons-halflings-regular.woff) format('woff'),url(../fonts/glyphicons-halflings-regular.ttf) format('truetype'),url(../fonts/glyphicons-halflings-regular.svg#glyphicons_halflingsregular) format('svg')
}


.NOTE, .TIP, .WARNING, .IMPORTANT, .WARNING, .CAUTION {
    border-style:solid;
    border-width:1px;
    border-radius: 5px;
    padding: 15px;
    margin-bottom: 20px;
}

.NOTE, .TIP {
    border-color: #bce8f1;
    color: #31708f;
    background-color: #d9edf7;
}

.IMPORTANT, .CAUTION {
    border-color: #ebccd1;
    color: #a94442;
    background-color: #f2dede;
}

.WARNING {
    border-color: #faebcc;
    color: #8a6d3b;
    background-color: #fcf8e3;
}

.IMPORTANT h5, .CAUTION h5 {
    color: #a94442;
}

.WARNING h5 {
    color: #8a6d3b;
}

.NOTE h5, .TIP h5, .WARNING h5, .IMPORTANT h5, .CAUTION h5 {
    font-size:14px;
    text-transform: uppercase;
    font-weight: bold;
    margin-top: 0;
}

.NOTE h5, .TIP h5 {
    color: #31708f;
}

.NOTE h5:before, .TIP h5:before, .WARNING h5:before, .IMPORTANT h5:before, .CAUTION h5:before {
    position: relative;
    top: 1px;
    display: inline-block;
    font-family: 'Glyphicons Halflings';
    line-height: 1;
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
    margin-right: .2em;
    font-weight: normal;
}

.NOTE h5:before {
    content: "\e086";
}

.IMPORTANT h5:before, .CAUTION h5:before {
    content: "\e127";
}

.WARNING h5:before {
    content: "\e107";
}

.TIP h5:before {
    content: "\e086";
}


.NOTE > p, .WARNING > p, .IMPORTANT > p, .CAUTION > p, .TIP > p {
    margin-top: 5px;
    margin-bottom: 0;
}


*, :after, :before {
    -webkit-box-sizing: border-box;
    -moz-box-sizing: border-box;
    box-sizing: border-box
}

表紙をつける

pdfフォルダ内にcover.mdを追加

cover.mdに表紙用のスタイル適用

---
documentType: cover
---
# The real cover page title

表紙用スタイルをカスタマイズ

TOC（目次・Table of Contents）

outline（しおり・ブックマーク）

DocFXのオプション

WkDefaultOutline

"pdf": {
  "outline": "WkDefaultOutline",

"pdf": {
  "outline": "WkDefaultOutline",
  "wkhtmltopdf": {
    "additionalArguments": "--footer-center [page] --outline-depth 3"
  },