Update PDF rendering

.gitignore

@@ -15,3 +15,5 @@ gen
 /node_modules/
 
 tmp/
+doc.md
+output.pdf

Makefile

@@ -0,0 +1,7 @@
+default: output.pdf
+
+doc.md:
+	./scripts/merge_by_toc.py
+
+output.pdf: doc.md
+	./scripts/generate_pdf.sh

scripts/generate_pdf.sh

@@ -3,6 +3,7 @@
 set -e
 # test passed in pandoc 1.19.1
 
+# Fedora: dnf install wqy-microhei-fonts
 MAINFONT="WenQuanYi Micro Hei"
 MONOFONT="WenQuanYi Micro Hei Mono"
 
@@ -15,16 +16,23 @@ _version_tag="$(date '+%Y%m%d')"
 # default version: `pandoc --latex-engine=xelatex doc.md -s -o output2.pdf`
 # used to debug template setting error
 
-pandoc -N --toc --smart --latex-engine=xelatex \
---template=templates/template.tex \
---include-in-header=templates/deeplist.tex \
---columns=80 \
---listings \
--V title="TiDB Documentation" \
--V author="PingCAP Inc." \
--V date="${_version_tag}" \
--V CJKmainfont="${MAINFONT}" \
--V fontsize=12pt \
--V geometry:margin=1in \
--V include-after="\\input{templates/copyright.tex}" \
-"doc.md" -s -o "output.pdf"
+# Note that doc.md must first be generated by ./scripts/merge_by_toc.py
+
+pandoc \
+	-s \
+	-N \
+	--toc \
+	-f markdown+smart \
+	--pdf-engine=xelatex \
+	--template=templates/template.tex \
+	--columns=120 \
+	--listings \
+	-V title="TiDB Documentation" \
+	-V author="PingCAP Inc." \
+	-V date="${_version_tag}" \
+	-V CJKmainfont="${MAINFONT}" \
+	-V fontsize=12pt \
+	-V geometry:margin=1in \
+	-V include-after="\\input{templates/copyright.tex}" \
+	-o "output.pdf" \
+	"doc.md"

scripts/merge_by_toc.py

@@ -116,6 +116,7 @@ def replace_link(match):
             or link.endswith(".svg")
             or link.endswith(".gif")
             or link.endswith(".jpg")
+            or link.endswith(".PNG")
         ):
             # special handing for pic
             img_link = re.sub(r"[\.\/]*media\/", "./media/", link, count=0, flags=0)

templates/template.tex

@@ -1,4 +1,6 @@
 \documentclass[$if(fontsize)$$fontsize$,$endif$$if(lang)$$lang$,$endif$$if(papersize)$$papersize$,$endif$$for(classoption)$$classoption$$sep$,$endfor$]{$documentclass$}
+\usepackage{array}
+\usepackage{calc}
 $if(fontfamily)$
 \usepackage{$fontfamily$}
 $else$
@@ -67,6 +69,7 @@
 
 \usepackage{xcolor}
 \usepackage{listings}
+\newcommand{\passthrough}[1]{#1}
 \lstset{
     basicstyle=\ttfamily,
     keywordstyle=\color[rgb]{0.13,0.29,0.53}\bfseries,
@@ -115,7 +118,7 @@
 \hypersetup{breaklinks=true,
             bookmarks=true,
             pdfauthor={$author-meta$},
-            pdftitle={$title-meta$},
+            pdftitle="TiDB User Manual"
             colorlinks=true,
             citecolor=$if(citecolor)$$citecolor$$else$blue$endif$,
             urlcolor=$if(urlcolor)$$urlcolor$$else$blue$endif$,