651 lines
36 KiB
HTML
651 lines
36 KiB
HTML
|
||
<!DOCTYPE html>
|
||
<html lang="zh-CN" class="loading">
|
||
<head>
|
||
<!-- hexo-inject:begin --><!-- hexo-inject:end --><meta charset="UTF-8" />
|
||
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
|
||
<meta name="viewport" content="width=device-width, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
|
||
<title>使用 Markdown 编写基于 Latex 的报告 - Blog</title>
|
||
<meta name="apple-mobile-web-app-capable" content="yes" />
|
||
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
|
||
<meta name="google" content="notranslate" />
|
||
<meta name="keywords" content="Developer, Python, C++, JavaScript, Java,">
|
||
<meta name="description" content="DavidZ's Blog,
|
||
原创发表于 DavidZ Blog，遵循 CC 4.0 BY-NC-SA 版权协议，转载请附上原文出处链接及本声明。
|
||
|
||
¶前言
|
||
计算机这个专业，有很多报告要做。在山威的时候，报告格式没有什么限制 ,">
|
||
<meta name="author" content="DavidZ">
|
||
<link rel="alternative" href="atom.xml" title="Blog" type="application/atom+xml">
|
||
<link rel="icon" href="/img/favicon.png">
|
||
<link href="https://fonts.loli.net/css?family=Roboto+Mono|Rubik&display=swap" rel="stylesheet">
|
||
|
||
<link rel="stylesheet" href="//at.alicdn.com/t/font_1429596_nzgqgvnmkjb.css">
|
||
|
||
|
||
<link rel="stylesheet" href="//cdn.bootcss.com/animate.css/3.7.2/animate.min.css">
|
||
|
||
|
||
<link rel="stylesheet" href="//cdn.bootcss.com/social-share.js/1.0.16/css/share.min.css">
|
||
|
||
|
||
<link rel="stylesheet" href="//cdn.bootcss.com/codemirror/5.48.4/codemirror.min.css">
|
||
|
||
|
||
<link rel="stylesheet" href="//cdn.bootcss.com/codemirror/5.48.4/theme/dracula.css">
|
||
|
||
|
||
<link rel="stylesheet" href="/css/obsidian.css">
|
||
|
||
|
||
<link rel="stylesheet" href="/css/ball-atom.min.css">
|
||
|
||
<meta name="generator" content="Hexo 4.2.0"><!-- hexo-inject:begin --><!-- hexo-inject:end --></head>
|
||
|
||
|
||
<body class="loading">
|
||
<!-- hexo-inject:begin --><!-- hexo-inject:end --><div class="loader">
|
||
<div class="la-ball-atom la-2x">
|
||
<div></div>
|
||
<div></div>
|
||
<div></div>
|
||
<div></div>
|
||
</div>
|
||
</div>
|
||
<span id="config-title" style="display:none">Blog</span>
|
||
<div id="loader"></div>
|
||
<div id="single">
|
||
<div class="scrollbar gradient-bg-rev"></div>
|
||
<div id="top" style="display: block;">
|
||
<div class="bar" style="width: 0;"></div>
|
||
<div class="navigation animated fadeIn fast delay-1s">
|
||
<img id="home-icon" class="icon-home" src="/img/favicon.png" alt="" data-url="https://blog.davidz.cn">
|
||
<div id="play-icon" title="Play/Pause" class="iconfont icon-play"></div>
|
||
<h3 class="subtitle">使用 Markdown 编写基于 Latex 的报告</h3>
|
||
<div class="social">
|
||
<!-- <div class="like-icon">-->
|
||
<!-- <a href="javascript:;" class="likeThis active"><span class="icon-like"></span><span class="count">76</span></a>-->
|
||
<!-- </div>-->
|
||
<div>
|
||
<div class="share">
|
||
|
||
<a href="javascript:;" class="iconfont icon-share1"></a>
|
||
<div class="share-component-cc" data-disabled="facebook,douban,linkedin,diandian,tencent,google"></div>
|
||
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="section">
|
||
<div class=article-header-wrapper>
|
||
<div class="article-header">
|
||
<div class="article-cover animated fadeIn" style="
|
||
animation-delay: 600ms;
|
||
animation-duration: 1.2s;
|
||
background-image:
|
||
radial-gradient(ellipse closest-side, rgba(0, 0, 0, 0.65), #100e17),
|
||
url(https://davidz-blog.oss-cn-beijing.aliyuncs.com/img/Eisvogel-1599485385.png) ">
|
||
</div>
|
||
<div class="else">
|
||
<p class="animated fadeInDown">
|
||
|
||
<a href="/categories/Productivity"><b>「
|
||
</b>PRODUCTIVITY<b> 」</b></a>
|
||
|
||
二月 12, 2020
|
||
</p>
|
||
<h3 class="post-title animated fadeInDown"><a href="/write-latex-report-with-markdown/" title="使用 Markdown 编写基于 Latex 的报告" class="">使用 Markdown 编写基于 Latex 的报告</a>
|
||
</h3>
|
||
|
||
<p class="post-count animated fadeInDown">
|
||
|
||
<span>
|
||
<b class="iconfont icon-text2"></b> <i>文章字数</i>
|
||
14k
|
||
</span>
|
||
|
||
|
||
<span>
|
||
<b class="iconfont icon-timer__s"></b> <i>阅读约需</i>
|
||
12 mins.
|
||
</span>
|
||
|
||
|
||
|
||
<span id="busuanzi_container_page_pv">
|
||
<b class="iconfont icon-read"></b> <i>阅读次数</i>
|
||
<span id="busuanzi_value_page_pv">0</span>
|
||
</span>
|
||
|
||
</p>
|
||
|
||
|
||
<ul class="animated fadeInDown post-tags-list" itemprop="keywords"><li class="animated fadeInDown post-tags-list-item"><a class="animated fadeInDown post-tags-list-link" href="/tags/Markdown/" rel="tag">Markdown</a></li><li class="animated fadeInDown post-tags-list-item"><a class="animated fadeInDown post-tags-list-link" href="/tags/Windows/" rel="tag">Windows</a></li></ul>
|
||
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="screen-gradient-after">
|
||
<div class="screen-gradient-content">
|
||
<div class="screen-gradient-content-inside">
|
||
<div class="bold-underline-links screen-gradient-sponsor">
|
||
<p>
|
||
<span class="animated fadeIn delay-1s"></span>
|
||
</p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="article">
|
||
<div class='main'>
|
||
<div class="content markdown animated fadeIn">
|
||
<blockquote>
|
||
<p>原创发表于 <a href="https://blog.davidz.cn">DavidZ Blog</a>，遵循 <a href="https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode" target="_blank" rel="noopener">CC 4.0 BY-NC-SA</a> 版权协议，转载请附上原文出处链接及本声明。</p>
|
||
</blockquote>
|
||
<h2 id="前言"><a class="header-anchor" href="#前言">¶</a>前言</h2>
|
||
<p>计算机这个专业，有很多报告要做。在山威的时候，报告格式没有什么限制 Word，PDF 都可以，那个时候我开始使用 Markdown 作为我的排版工具，因为实在是没有时间经历去研究 Word 的各种高级功能（<s>主要是懒</s>）。Markdown 十分简单，易学，在<a href="https://github.com" target="_blank" rel="noopener">Github</a>等计算机专业相关平台使用也非常广泛，还可以通过各种模板快速生成<strong>好看</strong>，<strong>美观</strong>，<strong>专业</strong>的文档。</p>
|
||
<p>后来到了澳国立，老师教授们开始极力鼓吹 Latex 和 PDF，基本上算是软性要求我们使用 Latex 编写，还规定了衬线字体，非衬线字体，字号，段落等等，图片还需要是 SVG 格式的矢量图片（最奇葩的是竟然一整节课只讲这个😂），最后生成 PDF 提交（据说这样分数高一些）。所以我开始了漫漫 Latex 学习之路。然而整个过程十分痛苦，装个 TeX Live 跑了好几个小时，换个字体换的我一脸懵逼，预览竟然都不是实时的！！！我甚至觉得还不如 Word 好用，又开始找那些 Latex 编辑器（同学的 MacOS 上有很不错的，然而我是 Windows），之后是在线编辑器<a href="https://www.overleaf.com/" target="_blank" rel="noopener">Overleaf</a>，体验还行，但是一边学习 Latex 一边做实验写报告的体验实在是太差劲了，人都要<s>有丝</s>分裂了。我就先用 Markdown 记录下来，想着之后再改成 Latex 吧。然后，我用了 2 天左右的时间，找到了 Markdown 直接转报告的方法，就没再碰 Latex（<s>还是懒</s>）。</p>
|
||
<h2 id="样例"><a class="header-anchor" href="#样例">¶</a>样例</h2>
|
||
<p><a href="https://github.com/Wandmalfarbe/pandoc-latex-template/#example-images" target="_blank" rel="noopener">eisvogel 主题样例</a></p>
|
||
<p>你也可以从<a href="https://davidz-blog.oss-cn-beijing.aliyuncs.com/asset/Report.pdf" target="_blank" rel="noopener">这里</a>看一下我的成果作为参考，我觉得完全符合我的要求。</p>
|
||
<h2 id="思路"><a class="header-anchor" href="#思路">¶</a>思路</h2>
|
||
<p>其实思路很简单，一切的一切都是因为<a href="https://pandoc.org/" target="_blank" rel="noopener">Pandoc</a>这个文档转换软件软件（类似于影音界的格式工厂？）的存在。它官网有一张巨型图片描述了它可以从那些格式转换成那些格式，基本上可以说覆盖了常见的所有文档格式。所以我们就可以用它把 Markown 语言写的文档转换成 PDF 格式的报告，过程中再用一套模板修饰一下就好啦。</p>
|
||
<blockquote>
|
||
<p>注意<br>
|
||
Pandoc 通过 Markdown -> Latex -> PDF 的方式得到 PDF，中间文件是 Latex</p>
|
||
</blockquote>
|
||
<h2 id="准备"><a class="header-anchor" href="#准备">¶</a>准备</h2>
|
||
<h3 id="Markdown-语法"><a class="header-anchor" href="#Markdown-语法">¶</a>Markdown 语法</h3>
|
||
<blockquote>
|
||
<p>注意<br>
|
||
Markdown 实际上和 HTML 是“近亲”，你甚至可以直接使用 HTML 标签。</p>
|
||
</blockquote>
|
||
<p>这个百度或者谷歌一下，很容易找到教程，学起来也很简单，10 分钟上手，1 天熟练。</p>
|
||
<h3 id="Markdown-编辑器"><a class="header-anchor" href="#Markdown-编辑器">¶</a>Markdown 编辑器</h3>
|
||
<p>下面这俩我都有，看心情切换😄。</p>
|
||
<h4 id="选项-1-VSCode"><a class="header-anchor" href="#选项-1-VSCode">¶</a>选项 1: VSCode</h4>
|
||
<p><img src="https://davidz-blog.oss-cn-beijing.aliyuncs.com/img/VSCode-1599485366.png" alt="VSCode with Markdown Preview Enhanced"></p>
|
||
<p>微软出品，宇宙最强 IDE <code>Visual Studio</code> 的“弟弟”，宇宙最强编辑器。</p>
|
||
<p><a href="https://code.visualstudio.com/" target="_blank" rel="noopener">官网</a>|<a href="https://github.com/microsoft/vscode" target="_blank" rel="noopener">Github</a>下载安装包，双击安装即可。</p>
|
||
<p>虽然 <code>VSCode</code> 原生支持 Markdown，但是下面这几个属于增强型插件：</p>
|
||
<ol>
|
||
<li><a href="https://marketplace.visualstudio.com/items?itemName=shd101wyy.markdown-preview-enhanced" target="_blank" rel="noopener"><code>Markdown Preview Enhanced</code></a>，增强 Markdown 的预览效果，比如支持公式，清单之类的。</li>
|
||
<li><a href="https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker" target="_blank" rel="noopener"><code>Code Spell Checker</code></a>，检查你报告里的拼写错误（不过好像只支持英文）。</li>
|
||
<li><a href="https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint" target="_blank" rel="noopener"><code>Markdownlint</code></a>，检查 Markdown 的语法规范（强迫症专属）。</li>
|
||
<li><a href="https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode" target="_blank" rel="noopener"><code>Prettier</code></a>，格式化 Markdown 代码（强迫症专属）。</li>
|
||
</ol>
|
||
<h4 id="选项-2-Typora"><a class="header-anchor" href="#选项-2-Typora">¶</a>选项 2: Typora</h4>
|
||
<p><img src="https://davidz-blog.oss-cn-beijing.aliyuncs.com/img/Typora-1599485376.png" alt="Typora"></p>
|
||
<p>写作体验一级棒👍。</p>
|
||
<p><a href="https://www.typora.io/" target="_blank" rel="noopener">官网</a>下载安装包，双击安装即可。</p>
|
||
<h3 id="Latex-Engine"><a class="header-anchor" href="#Latex-Engine">¶</a>Latex Engine</h3>
|
||
<blockquote>
|
||
<p>注意<br>
|
||
Latex 是个语言规范，Latex Engine 是它的实现，下面这俩都是 Latex Engine 的集合</p>
|
||
</blockquote>
|
||
<p>因为 Scoop 里面只有 MiKTeX，所以我选择 MiKTeX。反正我只是写个报告，选哪个应该都无所谓吧。</p>
|
||
<h4 id="选项-1-MiKTeX"><a class="header-anchor" href="#选项-1-MiKTeX">¶</a>选项 1: MiKTeX</h4>
|
||
<p>通过 Scoop 安装：</p>
|
||
<pre><code class="language-powershell">scoop install latex
|
||
</code></pre>
|
||
<p>或者<a href="https://miktex.org/" target="_blank" rel="noopener">官网</a>下载安装。</p>
|
||
<h4 id="选项-2-TeX-Live"><a class="header-anchor" href="#选项-2-TeX-Live">¶</a>选项 2: TeX Live</h4>
|
||
<p><a href="http://tug.org/texlive/" target="_blank" rel="noopener">官网</a>下载安装。</p>
|
||
<h3 id="Pandoc"><a class="header-anchor" href="#Pandoc">¶</a>Pandoc</h3>
|
||
<h4 id="Pandoc-主程序"><a class="header-anchor" href="#Pandoc-主程序">¶</a>Pandoc 主程序</h4>
|
||
<p>这个就是前文所说的万能文档格式转换器软件了。</p>
|
||
<p>通过 Scoop 安装：</p>
|
||
<pre><code class="language-powershell">scoop install pandoc
|
||
</code></pre>
|
||
<p>或者<a href="https://www.pandoc.org/" target="_blank" rel="noopener">官网</a>下载安装。</p>
|
||
<h4 id="Pandoc-Filter"><a class="header-anchor" href="#Pandoc-Filter">¶</a>Pandoc Filter</h4>
|
||
<p>Pandoc 支持自定义<a href="https://www.pandoc.org/filters.html" target="_blank" rel="noopener">过滤器</a>，类似于插件，支持 Lua, Haskell, Python(对于想要自己尝试开发的同学，强烈推荐<a href="https://github.com/sergiocorreia/panflute" target="_blank" rel="noopener">Panflute</a>，比官方的<a href="https://github.com/jgm/pandocfilters" target="_blank" rel="noopener">pandocfilters</a>更人性化一些)。</p>
|
||
<h5 id="原理"><a class="header-anchor" href="#原理">¶</a>原理</h5>
|
||
<pre><code>INPUT --> reader --> AST --> filter --> AST --> writer --> OUTPUT
|
||
</code></pre>
|
||
<ul>
|
||
<li>INPUT: Pandoc 的输入。</li>
|
||
<li>reader: 把输入解析成 AST。</li>
|
||
<li>AST(Abstract Syntax Tree): 抽象语法树，这个是 Pandoc 的核心组件，是对所有支持的文件类型的抽象。</li>
|
||
<li>filter: 这里就是我们的过滤器了，注意他的输入和输出都是 AST。</li>
|
||
<li>writer: 把 AST 解析成输出。</li>
|
||
<li>OUTPUT: Pandoc 的输出。</li>
|
||
</ul>
|
||
<h5 id="例子"><a class="header-anchor" href="#例子">¶</a>例子</h5>
|
||
<p>上调所有小于 6 的标题的级别，如果大于 6，则删除标题（把标题变成段落）。</p>
|
||
<pre><code class="language-python">from panflute import *
|
||
|
||
def increase_header_level(elem, doc):
|
||
if type(elem) == Header:
|
||
if elem.level < 6:
|
||
elem.level += 1
|
||
else:
|
||
return [] # Delete headers already in level 6
|
||
|
||
def main(doc=None):
|
||
return run_filter(increase_header_level, doc=doc)
|
||
|
||
if __name__ == "__main__":
|
||
main()
|
||
</code></pre>
|
||
<p>然后在 Pandoc 的命令中用<code>--filter</code>指定这个 Python 文件即可。</p>
|
||
<h5 id="推荐"><a class="header-anchor" href="#推荐">¶</a>推荐</h5>
|
||
<ul>
|
||
<li><a href="https://github.com/lierdakil/pandoc-crossref" target="_blank" rel="noopener">pandoc-crossref</a></li>
|
||
</ul>
|
||
<p>用于 Pandoc 中的交叉引用，图片，公式，章节等，这个我也是用 Scoop 安装的，没有 Scoop 的话看看<a href="https://github.com/lierdakil/pandoc-crossref#installation" target="_blank" rel="noopener">安装教程</a>吧。</p>
|
||
<table>
|
||
<thead>
|
||
<tr>
|
||
<th style="text-align:center">类型</th>
|
||
<th style="text-align:center">标识</th>
|
||
<th style="text-align:center">引用</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td style="text-align:center"><a href="http://lierdakil.github.io/pandoc-crossref/#image-labels" target="_blank" rel="noopener">图片</a></td>
|
||
<td style="text-align:center"><code>{#fig:label}</code></td>
|
||
<td style="text-align:center"><code>@fig:label</code></td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align:center"><a href="http://lierdakil.github.io/pandoc-crossref/#equation-labels" target="_blank" rel="noopener">公式</a></td>
|
||
<td style="text-align:center"><code>$$ math $$ {#eq:label}</code></td>
|
||
<td style="text-align:center"><code>@eq:label</code></td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align:center"><a href="http://lierdakil.github.io/pandoc-crossref/#table-labels" target="_blank" rel="noopener">表格</a></td>
|
||
<td style="text-align:center"><code>: Caption {#tbl:label}</code></td>
|
||
<td style="text-align:center"><code>@tbl:label</code></td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align:center"><a href="http://lierdakil.github.io/pandoc-crossref/#section-labels" target="_blank" rel="noopener">段落</a></td>
|
||
<td style="text-align:center"><code># Section {#sec:label}</code></td>
|
||
<td style="text-align:center"><code>@sec:label</code></td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align:center"><a href="http://lierdakil.github.io/pandoc-crossref/#code-block-labels" target="_blank" rel="noopener">代码块</a></td>
|
||
<td style="text-align:center"><code>: Listing caption {#lst:label}</code></td>
|
||
<td style="text-align:center"><code>@lst:label</code></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<ul>
|
||
<li><a href="https://github.com/jgm/pandoc-citeproc" target="_blank" rel="noopener">pandoc-citeproc</a></li>
|
||
</ul>
|
||
<p>用于 Pandoc 中的文献引用，这个是自带的，无需安装。</p>
|
||
<p>需要指定 BibTeX(.bib) 文件来指定你的参考源，长这个样子，</p>
|
||
<pre><code class="language-bibtex">@article{vinyals_show_2015,
|
||
title = {Show and Tell: A Neural Image Caption Generator},
|
||
url = {http://arxiv.org/abs/1411.4555},
|
||
shorttitle = {Show and Tell},
|
||
abstract = {Automatically describing the content of an image is a fundamental problem in artiďŹcial intelligence that connects computer vision and natural language processing. In this paper, we present a generative model based on a deep recurrent architecture that combines recent advances in computer vision and machine translation and that can be used to generate natural sentences describing an image. The model is trained to maximize the likelihood of the target description sentence given the training image. Experiments on several datasets show the accuracy of the model and the ďŹuency of the language it learns solely from image descriptions. Our model is often quite accurate, which we verify both qualitatively and quantitatively. For instance, while the current state-of-the-art {BLEU}-1 score (the higher the better) on the Pascal dataset is 25, our approach yields 59, to be compared to human performance around 69. We also show {BLEU}-1 score improvements on Flickr30k, from 56 to 66, and on {SBU}, from 19 to 28. Lastly, on the newly released {COCO} dataset, we achieve a {BLEU}-4 of 27.7, which is the current state-of-the-art.},
|
||
journaltitle = {{arXiv}:1411.4555 [cs]},
|
||
author = {Vinyals, Oriol and Toshev, Alexander and Bengio, Samy and Erhan, Dumitru},
|
||
urldate = {2020-06-01},
|
||
date = {2015-04-20},
|
||
langid = {english},
|
||
eprinttype = {arxiv},
|
||
eprint = {1411.4555},
|
||
keywords = {Computer Science - Computer Vision and Pattern Recognition}
|
||
}
|
||
</code></pre>
|
||
<p>以及 Citation Style Language(.csl)文件来指定你想要的引用格式，比如 APA，MLA，Chicago，Harvard 或者国内常用的 GB7714-2005，可以从<a href="https://github.com/citation-style-language/styles" target="_blank" rel="noopener">citation-style-language/styles</a>下载。</p>
|
||
<p>在文中用<code>[@vinyals_show_2015]</code>对应引用源即可实现引用自动生成，十分方便。</p>
|
||
<h4 id="Pandoc-Theme-Eisvogel-主题"><a class="header-anchor" href="#Pandoc-Theme-Eisvogel-主题">¶</a>Pandoc Theme: Eisvogel 主题</h4>
|
||
<p><img src="https://davidz-blog.oss-cn-beijing.aliyuncs.com/img/Eisvogel-1599485385.png" alt="Eisvogel"></p>
|
||
<p>这个是我找到的计算机专业风格的论文/报告/书籍/幻灯片的开源模板，对于我来说是真的很合适了，美观，简约又专业。</p>
|
||
<p><a href="https://github.com/Wandmalfarbe/pandoc-latex-template" target="_blank" rel="noopener">Github Release</a>下载，放到<a href="https://github.com/Wandmalfarbe/pandoc-latex-template#installation" target="_blank" rel="noopener">指定路径</a>，就完了，很简单。</p>
|
||
<h2 id="配置"><a class="header-anchor" href="#配置">¶</a>配置</h2>
|
||
<pre><code class="language-YAML">---
|
||
# Pandoc
|
||
title: Title of the Report
|
||
author: Jiahao Zhang
|
||
date: Jul. 3, 1998
|
||
block-headings: true
|
||
documentclass: article
|
||
papersize: a4
|
||
geometry: margin=2.5cm
|
||
mainfont: Calibri
|
||
sansfont: Calibri
|
||
monofont: JetBrains Mono
|
||
CJKmainfont: Microsoft YaHei
|
||
fontsize: 10pt
|
||
listings: true
|
||
toc: true
|
||
toc-depth: 2
|
||
secnumdepth: 4
|
||
bibliography: [resources.bib]
|
||
csl: ieee.csl
|
||
# Eisvogel
|
||
titlepage: true
|
||
header-right: Report
|
||
footer-left: Australian National University
|
||
toc-own-page: true
|
||
table-use-row-colors: false
|
||
listings-no-page-break: false
|
||
code-block-font-size: \normalsize
|
||
# Crossref
|
||
subfigGrid: true
|
||
autoSectionLabels: true
|
||
# Citeproc
|
||
link-citations: true
|
||
reference-section-title: References
|
||
---
|
||
</code></pre>
|
||
<p>在每个 Markdown 文件最上面形如上面 YAML 代码的叫做<code>YAML Front Matter</code>，可以理解为对全文的配置。这里主要是一些对<a href="https://www.pandoc.org/MANUAL.html#variables" target="_blank" rel="noopener">Pandoc</a>,<a href="https://github.com/Wandmalfarbe/pandoc-latex-template#custom-template-variables" target="_blank" rel="noopener">Eisvogel</a>, <a href="http://lierdakil.github.io/pandoc-crossref/#general-options" target="_blank" rel="noopener">Crossref</a> 和 <a href="https://www.pandoc.org/MANUAL.html#citation-rendering" target="_blank" rel="noopener">Citeproc</a>的配置。</p>
|
||
<h2 id="生成"><a class="header-anchor" href="#生成">¶</a>生成</h2>
|
||
<p>运行下面的命令就可以生成 PDF 啦😄。</p>
|
||
<pre><code class="language-powershell">pandoc Report.md `
|
||
-o Report.pdf `
|
||
--standalone `
|
||
--listings `
|
||
--number-sections `
|
||
--filter pandoc-crossref `
|
||
--filter=pandoc-citeproc `
|
||
--pdf-engine=xelatex `
|
||
--template eisvogel
|
||
</code></pre>
|
||
<p>简单解释一下，</p>
|
||
<ul>
|
||
<li><code>-o</code> 指定输出文件</li>
|
||
<li><code>--standalone</code> 独立完整文件</li>
|
||
<li><code>--listings</code> 使用<a href="https://ctan.org/pkg/listings" target="_blank" rel="noopener">listings</a>高亮代码</li>
|
||
<li><code>--number-sections</code> 启用段落编号</li>
|
||
<li><code>--filter pandoc-crossref</code> 使用过滤器 <code>pandoc-crossref</code></li>
|
||
<li><code>--filter pandoc-citeproc</code> 使用过滤器 <code>pandoc-citeproc</code></li>
|
||
<li><code>--pdf-engine=xelatex</code> 指定 PDF 的 engine 为 <code>xelatex</code></li>
|
||
<li><code>--template eisvogel</code> 指定模板为 <code>eisvogel</code></li>
|
||
</ul>
|
||
<h2 id="想法"><a class="header-anchor" href="#想法">¶</a>想法</h2>
|
||
<p>完整的捣鼓下来其实也和学习 Latex 难度差不多了，但是配置完了这一套，只要要求不变，我再写报告的速度会加快很多很多，因为我只需要专注的写 Markdown 就好了😄。</p>
|
||
<p>PS: 这个博客所有的文章就是使用 Markdown 编写的。</p>
|
||
|
||
<!--[if lt IE 9]><script>document.createElement('audio');</script><![endif]-->
|
||
<audio id="audio" loop="1" preload="auto" controls="controls"
|
||
data-autoplay="false">
|
||
<source type="audio/mpeg" src="https://davidz-blog.oss-cn-beijing.aliyuncs.com/music/萧忆情Alex - 不谓侠.mp3">
|
||
</audio>
|
||
|
||
|
||
|
||
<div id='gitalk-container' class="comment link"
|
||
data-ae='true'
|
||
data-ci='489076c5dd3f5ba13f67'
|
||
data-cs='d6e3b245787b0b74d0dbe2639ef87f452a401194'
|
||
data-r='blog.davidz.cn'
|
||
data-o='DavidZhang73'
|
||
data-a='DavidZhang73'
|
||
data-d=''
|
||
>留言</div>
|
||
|
||
|
||
|
||
|
||
</div>
|
||
<div class="sidebar">
|
||
<div class="box animated fadeInRight">
|
||
<div class="subbox">
|
||
<img src="https://davidz-blog.oss-cn-beijing.aliyuncs.com/img/2019-1599483796.jpg" height=300 width=300></img>
|
||
<p>DavidZ</p>
|
||
<span>凡事都要留几分</span>
|
||
<dl>
|
||
<dd><a href="https://github.com/DavidZhang73" target="_blank"><span
|
||
class=" iconfont icon-github"></span></a></dd>
|
||
<dd><a href="https://twitter.com/david731998" target="_blank"><span
|
||
class=" iconfont icon-twitter"></span></a></dd>
|
||
<dd><a href="https://stackoverflow.com/users/12693553/davidz" target="_blank"><span
|
||
class=" iconfont icon-stack-overflow"></span></a></dd>
|
||
</dl>
|
||
</div>
|
||
<ul>
|
||
<li><a href="/">15 <p>文章</p></a></li>
|
||
<li><a href="/categories">8 <p>分类</p></a></li>
|
||
<li><a href="/tags">15 <p>标签</p></a></li>
|
||
</ul>
|
||
</div>
|
||
|
||
|
||
|
||
<div class="box sticky animated fadeInRight faster">
|
||
<div id="toc" class="subbox">
|
||
<h4>目录</h4>
|
||
<ol class="toc"><li class="toc-item toc-level-2"><a class="toc-link" href="#前言"><span class="toc-number">1.</span> <span class="toc-text">¶前言</span></a></li><li class="toc-item toc-level-2"><a class="toc-link" href="#样例"><span class="toc-number">2.</span> <span class="toc-text">¶样例</span></a></li><li class="toc-item toc-level-2"><a class="toc-link" href="#思路"><span class="toc-number">3.</span> <span class="toc-text">¶思路</span></a></li><li class="toc-item toc-level-2"><a class="toc-link" href="#准备"><span class="toc-number">4.</span> <span class="toc-text">¶准备</span></a><ol class="toc-child"><li class="toc-item toc-level-3"><a class="toc-link" href="#Markdown-语法"><span class="toc-number">4.1.</span> <span class="toc-text">¶Markdown 语法</span></a></li><li class="toc-item toc-level-3"><a class="toc-link" href="#Markdown-编辑器"><span class="toc-number">4.2.</span> <span class="toc-text">¶Markdown 编辑器</span></a><ol class="toc-child"><li class="toc-item toc-level-4"><a class="toc-link" href="#选项-1-VSCode"><span class="toc-number">4.2.1.</span> <span class="toc-text">¶选项 1: VSCode</span></a></li><li class="toc-item toc-level-4"><a class="toc-link" href="#选项-2-Typora"><span class="toc-number">4.2.2.</span> <span class="toc-text">¶选项 2: Typora</span></a></li></ol></li><li class="toc-item toc-level-3"><a class="toc-link" href="#Latex-Engine"><span class="toc-number">4.3.</span> <span class="toc-text">¶Latex Engine</span></a><ol class="toc-child"><li class="toc-item toc-level-4"><a class="toc-link" href="#选项-1-MiKTeX"><span class="toc-number">4.3.1.</span> <span class="toc-text">¶选项 1: MiKTeX</span></a></li><li class="toc-item toc-level-4"><a class="toc-link" href="#选项-2-TeX-Live"><span class="toc-number">4.3.2.</span> <span class="toc-text">¶选项 2: TeX Live</span></a></li></ol></li><li class="toc-item toc-level-3"><a class="toc-link" href="#Pandoc"><span class="toc-number">4.4.</span> <span class="toc-text">¶Pandoc</span></a><ol class="toc-child"><li class="toc-item toc-level-4"><a class="toc-link" href="#Pandoc-主程序"><span class="toc-number">4.4.1.</span> <span class="toc-text">¶Pandoc 主程序</span></a></li><li class="toc-item toc-level-4"><a class="toc-link" href="#Pandoc-Filter"><span class="toc-number">4.4.2.</span> <span class="toc-text">¶Pandoc Filter</span></a><ol class="toc-child"><li class="toc-item toc-level-5"><a class="toc-link" href="#原理"><span class="toc-number">4.4.2.1.</span> <span class="toc-text">¶原理</span></a></li><li class="toc-item toc-level-5"><a class="toc-link" href="#例子"><span class="toc-number">4.4.2.2.</span> <span class="toc-text">¶例子</span></a></li><li class="toc-item toc-level-5"><a class="toc-link" href="#推荐"><span class="toc-number">4.4.2.3.</span> <span class="toc-text">¶推荐</span></a></li></ol></li><li class="toc-item toc-level-4"><a class="toc-link" href="#Pandoc-Theme-Eisvogel-主题"><span class="toc-number">4.4.3.</span> <span class="toc-text">¶Pandoc Theme: Eisvogel 主题</span></a></li></ol></li></ol></li><li class="toc-item toc-level-2"><a class="toc-link" href="#配置"><span class="toc-number">5.</span> <span class="toc-text">¶配置</span></a></li><li class="toc-item toc-level-2"><a class="toc-link" href="#生成"><span class="toc-number">6.</span> <span class="toc-text">¶生成</span></a></li><li class="toc-item toc-level-2"><a class="toc-link" href="#想法"><span class="toc-number">7.</span> <span class="toc-text">¶想法</span></a></li></ol>
|
||
</div>
|
||
</div>
|
||
|
||
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
</div>
|
||
</div>
|
||
<div id="back-to-top" class="animated fadeIn faster">
|
||
<div class="flow"></div>
|
||
<span class="percentage animated fadeIn faster">0%</span>
|
||
<span class="iconfont icon-top02 animated fadeIn faster"></span>
|
||
</div><!-- hexo-inject:begin --><!-- hexo-inject:end -->
|
||
</body>
|
||
<footer>
|
||
<p class="copyright" id="copyright">
|
||
© 2020
|
||
<span class="gradient-text">
|
||
DavidZ
|
||
</span>.
|
||
Powered by <a href="http://hexo.io/" title="Hexo" target="_blank" rel="noopener">Hexo</a>
|
||
Theme
|
||
<span class="gradient-text">
|
||
<a href="https://github.com/TriDiamond/hexo-theme-obsidian" title="Obsidian" target="_blank" rel="noopener">Obsidian</a>
|
||
</span>
|
||
<small><a href="https://github.com/TriDiamond/hexo-theme-obsidian/blob/master/CHANGELOG.md" title="v1.4.4" target="_blank" rel="noopener">v1.4.4</a></small>
|
||
</p>
|
||
</footer>
|
||
|
||
<script type="text/javascript" src="https://cdn.bootcss.com/mathjax/2.7.7/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
|
||
</script>
|
||
<script>
|
||
MathJax.Hub.Config({
|
||
"HTML-CSS": {
|
||
preferredFont: "TeX",
|
||
availableFonts: ["STIX", "TeX"],
|
||
linebreaks: {
|
||
automatic: true
|
||
},
|
||
EqnChunk: (MathJax.Hub.Browser.isMobile ? 10 : 50)
|
||
},
|
||
tex2jax: {
|
||
inlineMath: [
|
||
["$", "$"],
|
||
["\\(", "\\)"]
|
||
],
|
||
processEscapes: true,
|
||
ignoreClass: "tex2jax_ignore|dno",
|
||
skipTags: ['script', 'noscript', 'style', 'textarea', 'pre', 'code']
|
||
},
|
||
TeX: {
|
||
noUndefined: {
|
||
attributes: {
|
||
mathcolor: "red",
|
||
mathbackground: "#FFEEEE",
|
||
mathsize: "90%"
|
||
}
|
||
},
|
||
Macros: {
|
||
href: "{}"
|
||
}
|
||
},
|
||
messageStyle: "none"
|
||
});
|
||
</script>
|
||
<script>
|
||
function initialMathJax() {
|
||
MathJax.Hub.Queue(function () {
|
||
var all = MathJax.Hub.getAllJax(),
|
||
i;
|
||
// console.log(all);
|
||
for (i = 0; i < all.length; i += 1) {
|
||
all[i].SourceElement().parentNode.className += ' has-jax';
|
||
}
|
||
});
|
||
}
|
||
|
||
function reprocessMathJax() {
|
||
if (typeof MathJax !== 'undefined') {
|
||
MathJax.Hub.Queue(["Typeset", MathJax.Hub]);
|
||
}
|
||
}
|
||
</script>
|
||
|
||
|
||
|
||
<link rel="stylesheet" href="//cdn.bootcss.com/gitalk/1.6.2/gitalk.min.css">
|
||
|
||
<script src="//cdn.bootcss.com/gitalk/1.6.2/gitalk.min.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/jquery/3.4.1/jquery.min.js"></script>
|
||
<script src="/js/plugin.js"></script>
|
||
<script src="/js/obsidian.js"></script>
|
||
<script src="/js/jquery.truncate.js"></script>
|
||
<script src="/js/search.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/typed.js/2.0.10/typed.min.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/blueimp-md5/2.12.0/js/md5.min.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/social-share.js/1.0.16/js/social-share.min.js"></script>
|
||
|
||
|
||
<script src="https://cdn.bootcss.com/codemirror/5.54.0/codemirror.min.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/codemirror/5.54.0/mode/javascript/javascript.min.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/codemirror/5.54.0/mode/css/css.min.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/codemirror/5.54.0/mode/xml/xml.min.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/codemirror/5.54.0/mode/htmlmixed/htmlmixed.min.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/codemirror/5.54.0/mode/clike/clike.min.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/codemirror/5.54.0/mode/php/php.min.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/codemirror/5.54.0/mode/shell/shell.min.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/codemirror/5.54.0/mode/python/python.min.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/codemirror/5.54.0/mode/cmake/cmake.min.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/codemirror/5.54.0/mode/powershell/powershell.min.js"></script>
|
||
|
||
<script src="//cdn.bootcss.com/codemirror/5.54.0/mode/yaml/yaml.min.js"></script>
|
||
|
||
<script src="/js/busuanzi.min.js"></script>
|
||
|
||
<script>
|
||
$(document).ready(function () {
|
||
if ($('span[id^="busuanzi_"]').length) {
|
||
initialBusuanzi();
|
||
}
|
||
});
|
||
</script>
|
||
|
||
<link rel="stylesheet" href="//cdn.bootcss.com/photoswipe/4.1.3/photoswipe.min.css">
|
||
<link rel="stylesheet" href="//cdn.bootcss.com/photoswipe/4.1.3/default-skin/default-skin.min.css">
|
||
|
||
|
||
<script src="//cdn.bootcss.com/photoswipe/4.1.3/photoswipe.min.js"></script>
|
||
<script src="//cdn.bootcss.com/photoswipe/4.1.3/photoswipe-ui-default.min.js"></script>
|
||
|
||
|
||
<!-- Root element of PhotoSwipe. Must have class pswp. -->
|
||
<div class="pswp" tabindex="-1" role="dialog" aria-hidden="true">
|
||
<!-- Background of PhotoSwipe.
|
||
It's a separate element as animating opacity is faster than rgba(). -->
|
||
<div class="pswp__bg"></div>
|
||
<!-- Slides wrapper with overflow:hidden. -->
|
||
<div class="pswp__scroll-wrap">
|
||
<!-- Container that holds slides.
|
||
PhotoSwipe keeps only 3 of them in the DOM to save memory.
|
||
Don't modify these 3 pswp__item elements, data is added later on. -->
|
||
<div class="pswp__container">
|
||
<div class="pswp__item"></div>
|
||
<div class="pswp__item"></div>
|
||
<div class="pswp__item"></div>
|
||
</div>
|
||
<!-- Default (PhotoSwipeUI_Default) interface on top of sliding area. Can be changed. -->
|
||
<div class="pswp__ui pswp__ui--hidden">
|
||
<div class="pswp__top-bar">
|
||
<!-- Controls are self-explanatory. Order can be changed. -->
|
||
<div class="pswp__counter"></div>
|
||
<button class="pswp__button pswp__button--close" title="Close (Esc)"></button>
|
||
<button class="pswp__button pswp__button--share" title="Share"></button>
|
||
<button class="pswp__button pswp__button--fs" title="Toggle fullscreen"></button>
|
||
<button class="pswp__button pswp__button--zoom" title="Zoom in/out"></button>
|
||
<!-- Preloader demo http://codepen.io/dimsemenov/pen/yyBWoR -->
|
||
<!-- element will get class pswp__preloader--active when preloader is running -->
|
||
<div class="pswp__preloader">
|
||
<div class="pswp__preloader__icn">
|
||
<div class="pswp__preloader__cut">
|
||
<div class="pswp__preloader__donut"></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="pswp__share-modal pswp__share-modal--hidden pswp__single-tap">
|
||
<div class="pswp__share-tooltip"></div>
|
||
</div>
|
||
<button class="pswp__button pswp__button--arrow--left" title="Previous (arrow left)">
|
||
</button>
|
||
<button class="pswp__button pswp__button--arrow--right" title="Next (arrow right)">
|
||
</button>
|
||
<div class="pswp__caption">
|
||
<div class="pswp__caption__center"></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<!-- Global site tag (gtag.js) - Google Analytics -->
|
||
<script async src="//www.googletagmanager.com/gtag/js?id=UA-157733505-1"></script>
|
||
<script>
|
||
window.dataLayer = window.dataLayer || [];
|
||
function gtag() {
|
||
dataLayer.push(arguments);
|
||
}
|
||
gtag('js', new Date());
|
||
|
||
gtag('config', 'UA-157733505-1');
|
||
</script>
|
||
|
||
|
||
<script>
|
||
function initialTyped() {
|
||
var typedTextEl = $('.typed-text');
|
||
if (typedTextEl && typedTextEl.length > 0) {
|
||
var typed = new Typed('.typed-text', {
|
||
strings: ['凡事都要留几分', '颜值是第一生产力'],
|
||
typeSpeed: 90,
|
||
loop: true,
|
||
loopCount: Infinity,
|
||
backSpeed: 20,
|
||
});
|
||
}
|
||
}
|
||
|
||
if ($('.article-header') && $('.article-header').length) {
|
||
$(document).ready(function () {
|
||
initialTyped();
|
||
});
|
||
}
|
||
</script>
|
||
|
||
|
||
|
||
|
||
</html>
|