題 使用Markdown或類似內容生成包含頁碼的目錄文檔?


我需要創建一個大文檔,打印時會有幾百頁。我想用Markdown之類的東西來做這件事。我的一個要求是文檔必須包含頁碼和目錄。有沒有辦法使用Markdown或類似的標記語言自動生成具有相關頁碼的目錄?到目前為止,我使用Markdown進行調查的所有內容都可以自動生成HTML輸出的目錄,但沒有關聯的頁碼。


4
2018-05-30 13:54


起源


可能是因為HTML沒有頁碼的概念。什麼是頁面? - Bob
markdown不必轉換為HTML。 - Jared
聽起來你正在尋找的東西就像PDF,而不是最終用HTML / XHTML渲染的東西。 - killermist
注意:要實際顯示html的目錄(當然沒有頁碼),你需要兩個 --toc 選項 和 該 -s (獨立)選項。我沒有發現任何記錄在任何地方...... - nealmcb


答案:


聽起來像是一份工作 pandoc

HTML沒有“頁面”的概念;它可能會 可能 與...一起解決問題 <div></div> 標籤,但我只是使用PDF:

pandoc --toc --chapters -o output.pdf input1.mkd input2.mkd

Pandoc可以接受任意數量的輸入;它在每個輸入的末尾添加一個換行符並將它們連接起來。上面的命令將創建一個設計為綁定為書籍的PDF - 每個章節(由1級標題表示)將從奇數頁面開始。如果您不想要此行為,請使用以下命令:

pandoc --toc -V documentclass=report -o output.pdf input1.mkd input2.mkd

如果你想節省紙張而不介意章節只是從前一個結束的地方開始(它們甚至會在頁面中間開始),請調用pandoc而不用 --chapters 選項:

pandoc --toc -o output.pdf input1.mkd input2.mkd

能夠 生成帶有目錄的HTML,但具有您列出的所有限制。也可以使用pandoc生成ODT和Microsoft DOC文檔,但我認為它們看起來不太好,特別是與美麗的PDF生成相比。

使用pandoc創建PDF需要安裝LaTeX引擎;這在Linux上是非常簡單的,你在存儲庫中至少有一個,但在Windows上它可能會有點困難(我不知道,我從來沒有真正嘗試過)。因此,可以使用自定義LaTeX模板自定義您喜歡的東西 - 但我還沒有理解,所以我目前堅持(相當不錯)默認值。


10
2018-06-03 14:16



看起來很好,這可能是我將採用的解決方案。 - Jared


在一些谷歌分鐘後,我注意到你需要自己的LaTeX-Template,它可以作為pandoc的一個選項傳遞:

pandoc --toc --chapter --template=yourtemplate.tex -o output.pdf input1.mkd

但是,您的模板需要在LaTeX站點上進行一些修改。作為建議您可以使用:

作為起點,您可以使用以下模板。我複制了默認模板 https://github.com/jgm/pandoc-templates/blob/master/default.latex 並添加了一些額外的東西。

我相信你可以刪除大多數if-end-combination組合。模板需要它為用戶提供更多選項。

\documentclass[chapterprefix=false,titlepage=false]{scrreprt}
\usepackage[T1]{fontenc}

\usepackage{amssymb,amsmath}
\usepackage{fixltx2e} % provides \textsubscript
% use upquote if available, for straight quotes in verbatim environments
\IfFileExists{upquote.sty}{\usepackage{upquote}}{}
\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
  \usepackage[utf8]{inputenc}
$if(euro)$
  \usepackage{eurosym}
$endif$
\else % if luatex or xelatex
  \ifxetex
    \usepackage{mathspec}
    \usepackage{xltxtra,xunicode}
  \else
    \usepackage{fontspec}
  \fi
  \defaultfontfeatures{Mapping=tex-text,Scale=MatchLowercase}
  \newcommand{\euro}{€}
$if(mainfont)$
    \setmainfont{$mainfont$}
$endif$
$if(sansfont)$
    \setsansfont{$sansfont$}
$endif$
$if(monofont)$
    \setmonofont{$monofont$}
$endif$
$if(mathfont)$
    \setmathfont(Digits,Latin,Greek){$mathfont$}
$endif$
\fi
% use microtype if available
\IfFileExists{microtype.sty}{\usepackage{microtype}}{}
$if(geometry)$
\usepackage[$for(geometry)$$geometry$$sep$,$endfor$]{geometry}
$endif$
$if(natbib)$
\usepackage{natbib}
\bibliographystyle{plainnat}
$endif$
$if(biblatex)$
\usepackage{biblatex}
$if(biblio-files)$
\bibliography{$biblio-files$}
$endif$
$endif$
$if(listings)$
\usepackage{listings}
$endif$
$if(lhs)$
\lstnewenvironment{code}{\lstset{language=Haskell,basicstyle=\small\ttfamily}}{}
$endif$
$if(highlighting-macros)$
$highlighting-macros$
$endif$
$if(verbatim-in-note)$
\usepackage{fancyvrb}
$endif$
$if(tables)$
\usepackage{longtable}
$endif$
$if(graphics)$
\usepackage{graphicx}
% Redefine \includegraphics so that, unless explicit options are
% given, the image width will not exceed the width of the page.
% Images get their normal width if they fit onto the page, but
% are scaled down if they would overflow the margins.
\makeatletter
\def\ScaleIfNeeded{%
  \ifdim\Gin@nat@width>\linewidth
    \linewidth
  \else
    \Gin@nat@width
  \fi
}
\makeatother
\let\Oldincludegraphics\includegraphics
{%
 \catcode`\@=11\relax%
 \gdef\includegraphics{\@ifnextchar[{\Oldincludegraphics}{\Oldincludegraphics[width=\ScaleIfNeeded]}}%
}%
$endif$
\ifxetex
  \usepackage[setpagesize=false, % page size defined by xetex
              unicode=false, % unicode breaks when used with xetex
              xetex]{hyperref}
\else
  \usepackage[unicode=true]{hyperref}
\fi
\hypersetup{breaklinks=true,
            bookmarks=true,
            pdfauthor={$author-meta$},
            pdftitle={$title-meta$},
            colorlinks=true,
            urlcolor=$if(urlcolor)$$urlcolor$$else$blue$endif$,
            linkcolor=$if(linkcolor)$$linkcolor$$else$magenta$endif$,
            pdfborder={0 0 0}}
\urlstyle{same}  % don't use monospace font for urls
$if(links-as-notes)$
% Make links footnotes instead of hotlinks:
\renewcommand{\href}[2]{#2\footnote{\url{#1}}}
$endif$
$if(strikeout)$
\usepackage[normalem]{ulem}
% avoid problems with \sout in headers with hyperref:
\pdfstringdefDisableCommands{\renewcommand{\sout}{}}
$endif$
\setlength{\parindent}{0pt}
\setlength{\parskip}{6pt plus 2pt minus 1pt}
\setlength{\emergencystretch}{3em}  % prevent overfull lines
$if(numbersections)$
\setcounter{secnumdepth}{5}
$else$
\setcounter{secnumdepth}{0}
$endif$
$if(verbatim-in-note)$
\VerbatimFootnotes % allows verbatim text in footnotes
$endif$
$if(lang)$
\ifxetex
  \usepackage{polyglossia}
  \setmainlanguage{$mainlang$}
\else
  \usepackage[$lang$]{babel}
\fi
$endif$
$for(header-includes)$
$header-includes$
$endfor$

$if(title)$
\title{$title$}
$endif$
\author{$for(author)$$author$$sep$ \and $endfor$}
\date{$date$}

\begin{document}
$if(title)$
\maketitle
$endif$

$for(include-before)$
$include-before$

$endfor$
$if(toc)$
{
\hypersetup{linkcolor=black}
\setcounter{tocdepth}{$toc-depth$}
\begingroup
\let\clearpage\relax
\tableofcontents
\endgroup
}
$endif$
$body$

$if(natbib)$
$if(biblio-files)$
$if(biblio-title)$
$if(book-class)$
\renewcommand\bibname{$biblio-title$}
$else$
\renewcommand\refname{$biblio-title$}
$endif$
$endif$
\bibliography{$biblio-files$}

$endif$
$endif$
$if(biblatex)$
\printbibliography$if(biblio-title)$[title=$biblio-title$]$endif$

$endif$
$for(include-after)$
$include-after$

$endfor$
\end{document}

1
2018-06-03 16:48





你考慮過使用LaTeX嗎?

其他答案建議使用Pandoc,看起來它可以將Markdown轉換為LaTeX,但在LaTeX中可能更容易入手。

LaTeX專為創建打印文檔而設計,內置頁碼和TOC生成功能。看看這個基礎教程: http://www.andy-roberts.net/writing/latex


1
2018-06-05 13:53