| bibliography | csl | nocite | keywords | keywords-en | test-metadata-block | test-metadata-inline | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
china-national-standard-gb-t-7714-2015-numeric.csl |
/ @* |
|
|
*这*是一个 `metadata block`。Metadata 分为
- metadata inline
- metadata block
|
*这*是一个 `metadata inline` |
对于论文排版而言，学界通常会采用LaTeX方案，LaTeX虽然有着种种优点，然而却并不是那么容易上手，很多时候我们也不得不提交Word格式的论文。Word虽然上手简单，可要排版出一篇格式工整的论文也并非那么容易。
那么有没有一种方案可以兼得二者的好处呢？或者说，在这中间同时保持对二者的支持呢？在有了pandoc这个工具之后，这个问题似乎有了方向。pandoc作为通用的文档转换器，可以将一种名为Markdown的纯文本格式转换为LaTeX，又可以把Markdown转换为Word文件；恰好LaTeX和Markdown因为都是纯文本，转换过程几乎不会受到阻碍。而Markdown本身，又有着两者无可替代的优越性——随着电子设备的不断普及，我们需要在纸张上排版的情况越来越少了，而Markdown正好符合了现代化电子记录的需求：实时渲染，设备无关，轻量化……所以乍一看似乎Markdown就是我们的救星。
然而Markdown因为其本身只是为记录而设计，并没有“格式”的概念，所以对于其而言，想要输出成一篇符合格式要求的Word文档，是很困难的。但是pandoc可以支持插件，在转换过程中进行处理！由此，我们的点子便借着这个插件功能出来了——
只需要制作一个符合格式规范的Word模版，而后编写插件处理中途Word在功能、格式上的问题，即可输出满足要求的成品Word文档
现在，你们看到的，便是由我们半年时间研究出的方案，使用 pandoc 生成出的接近成品的 word 文档。
该文档中的格式，均是来自《重庆大学博士、硕士学位论文撰写格式标准及要求（2019年修订）》、《重庆大学普通本科毕业设计（论文）撰写规范要求》，具体见后文
\newPara{}
\cKeyWords{}
按照排版规定英文标题需要加粗
Let us not wallow in the valley of despair, I say to you today, my friends.
And so even though we face the difficulties of today and tomorrow, I still have a dream. It is a dream deeply rooted in the American dream.
I have a dream that one day this nation will rise up and live out the true meaning of its creed: "We hold these truths to be self-evident, that all men are created equal."
I have a dream that one day on the red hills of Georgia, the sons of former slaves and the sons of former slave owners will be able to sit down together at the table of brotherhood.
I have a dream that one day even the state of Mississippi, a state sweltering with the heat of injustice, sweltering with the heat of oppression, will be transformed into an oasis of freedom and justice.
I have a dream that my four little children will one day live in a nation where they will not be judged by the color of their skin but by the content of their character.
I have a dream today!
I have a dream that one day, down in Alabama, with its vicious racists, with its governor having his lips dripping with the words of "interposition" and "nullification" -- one day right there in Alabama little black boys and black girls will be able to join hands with little white boys and white girls as sisters and brothers.
I have a dream today!
\newPara{}
\eKeyWords{}
\newSectionAbstract
\toc
（论文中这段请删除）↑上面通过\toc生成目录，为了符合格式请对该目录应用宏 AdjustTOC.cls。
\Style{TOC}图目录
{ TOC \h \z \c "图" \x}{=field}
（论文中这段请删除）下面这里通过\newSection命令来生成一个Word中的分节符。在Word中，只有通过分节之后，才能给不同的节设定不同的页眉页脚以及纸张大小等参数。分节符的作用域为其前方的内容，这里的参数UpperRoman表示页码采用“大写罗马数字”表示，也就是从文档最开始的摘要到目录的部分，页码采用大写罗马数字表示。↓
\newSectionTOC
这里开始介绍基本功能的使用。
这里是各级标题，根据论文排版要求，本科论文理科规定了6级标题样式的编号和格式，文科则规定了5级，且编号格式与理科不同；而根据研究生的要求，文理科都只能按照本科理科的样子编号。其中英文标题要求应用加粗效果。
更多级别的标题在模版中未调整样式，请勿使用
根据需求，“摘要”“参考文献”“附录”等样式虽为一级标题，但是并没有编号，可以通过在标题尾部加上{-}来取消编号。
按照规定，脚注是被允许的，1可以直接按照Markdown的脚注格式进行书写2，这里就有了几个脚注了3。脚注的编号可以乱写4，只要一一对应就好5，最后会自动按顺序编好。
需要注意的是，[脚注中的内联代码无法随脚注一起使用更小的字号]{#内联代码字号问题}6
:::{style="Figure"}
\Style{Figure}这个段落被应用了Figure样式，显示效果为段落居中显示
:::
使用\Style{Figure}可对当前段落应用名为Figure的样式。↓
\Style{Figure}这个段落被应用了Figure样式，显示效果为段落居中显示
不推荐使用\Style{}功能，该代码只有放在段首的时候才成立，且造成其他功能无法正常显示（仅限使用的地方）
代码：
普通文本，[自定义样式文本1]{custom-style="CommentTok"},[自定义样式文本2]{style="CommentTok"}效果：
普通文本，[自定义样式文本1]{custom-style="CommentTok"},[自定义样式文本2]{style="CommentTok"}
代码：
[下划线1]{.underline}，[下划线2]{.U}效果：
[下划线1]{.underline}，[下划线2]{.U}
制表符可以用来对齐文字，在Word中，有普通的制表符（按Tab键插入）和特殊的制表符（需要通过菜单插入）。
长江，长城，\tab{}黄山，黄河，\tab{}在我心中重千斤
无论何时，\tab{}无论何地，\tab{}心中一样亲
普通制表符默认在文档中按照“两个字符”的位置进行对齐（可在“标尺”中查看），所以这里恰好就把“在我心中重千斤”给对齐到了下一个位置，需要手动在“心中一样亲”之前再加一个制表符才能对齐。
\tabC{}这是一串居中的文字。\tabL{}现在我跑到下一行的最左边了。\tabR{}然后我又到了这一行的最右边。
\tabC{}床前明月光，疑是地上霜。
\tabC{}举头望明月，低头思故乡。
\tabR{}——李白《静夜思》
有的时候我们需要在一段话的中间换行，而不进行分段，这时候就需要用到换行符，也就是LaTeX中的\\，可以用\newLine{}实现。👉\newLine{}👈比如这里就到了一个新行当中而没有因为分段产生首行缩进。后面的双语题注也是用的换行符实现的换行不分段。
pandoc也支持在一行末尾通过3个空格来插入换行符，比如这里👉
👈然后第二行前面不空行，这两行就是同一个段落
这也是Word的中的特殊功能，等同于LaTeX中的\newpage，但是这里为了和LaTeX以示区分，采用了更贴近于程序员的“小驼峰命名法”，即应当写成\newPage{}
妈妈：不听话就滚到下一页去，眼不见心不烦
\newPage{}
我：呜呜~~妈妈不要我了😥
pandoc无法将多余的空行识别为空的段落产生一段垂直间距（比如留出数学题的解题间隔），LaTeX中可以采用生成垂直间距的命令来实现，但Word没有这样的功能，只能用空段落来生成间距。这里采用命令\newPara{n}来生成n个空段落。↓
\newPara{3}
↑这里就有了3个空段落。排版规范要求“摘要”部分的“关键词”与正文间隔一行，就是通过这个来插入的空行。
在Markdown中，连续多个空格会被视为一个，使用\Space{4}来生成4个连续空格，例如中文摘要中的摘\Space{4}要
摘\Space{4}要
Metadata block:
\metadata{test-metadata-block}
Metadata inline: \metadata{test-metadata-inline}
纯文本 Metadata: \metadataStr{test-metadata-inline}
- 图片的并排子图
- 这个功能得用表格进行嵌套，理解起来很简单，做是能做的
- 就是逻辑比较复杂，代码写起来应该会很酸爽
- 附录的公式表格编号
- 排版要求规定一级标题“附录”不编号，附录里面的二级标题以
ABCD编号 - 而附录里的图片和表格等用
图A1的形式编号 - 实现起来虽然不复杂，但是要考虑到和普通的题注编号的共存，所以判断逻辑较为复杂
- 排版要求规定一级标题“附录”不编号，附录里面的二级标题以
- 页脚的分隔线位置
- 因为页脚继承正文样式，目前pandoc无法继承页脚设置，故自动变为首行缩进两字符，等待pandoc更新
- 代码块编号之后可能出现高亮问题
- 因为pandoc不支持代码块编号，故目前将代码块手动拆散编号，导致pandoc无法完整获知代码上下文，有待解决
\newcommand\degree{°}
勾股定理：设$\triangle ABC$顶点$A$，$B$，$C$的对边分别为
通过预定义的开关开启公式编号功能之后，“行间公式”默认会被编号，实现原理是用一个三列的表格嵌套公式，中间放置公式，右边放置编号，由于该表格的对称性，公式被对齐在正中间。这里可以简单的用一用LaTeX的\newcommand命令，由pandoc提供原生支持。
$$ m_{}\left(E_{1}\right)+m_{}\left(E_{2}\right) \leqslant \sum_{j \in J_{1}}\left|Q_{j}\right|+\sum_{j \in J_{2}}\left|Q_{j}\right| \leqslant \sum_{j=1}^{\infty}\left|Q_{j}\right| \leqslant m_{*}(E)+\epsilon $$
$$ \begin{aligned} &\left(d \phi_{q} \circ d \varphi_{p}\right)\left(v_{p}\right) \=& d \phi_{q}\left(d \varphi_{p}\left(v_{p}\right)\right) \=& d \phi_{q}\left(\left.\sum_{i=1}^{n} \sum_{j=1}^{m}\left(\frac{\partial\left(g^{-1} \circ \varphi \circ f\right){j}}{\partial x{i}}\right)\right|{f^{-1}(p)} \cdot v{i}\left(\frac{\partial}{\partial y_{j}}\right){0}\right) \=&\left.\sum{i=1}^{n} \sum_{j=1}^{m}\left(\frac{\partial\left(g^{-1} \circ \varphi \circ f\right){j}}{\partial x{i}}\right)\right|{f^{-1}(p)} \cdot d \phi{q}\left(v_{i}\left(\frac{\partial}{\partial y_{j}}\right){0}\right) \=&\left.\sum{i=1}^{n} \sum_{j=1}^{m}\left(\frac{\partial\left(g^{-1} \circ \varphi \circ f\right){j}}{\partial x{i}}\right)\right|{f^{-1}(p)} \cdot\left(\left.\sum{k=1}^{l}\left(\frac{\partial\left(h^{-1} \circ \varphi \circ g\right){k}}{\partial y{j}}\right)\right|{g^{-1}(q)} \cdot v{i}\left(\frac{\partial}{\partial z_{k}}\right){0}\right) \=&\left.\left.\sum{i=1}^{n} \sum_{j=1}^{m} \sum_{k=1}^{l}\left(\frac{\partial\left(h^{-1} \circ \varphi \circ g\right){k}}{\partial y{j}}\right)\right|{g^{-1}(q)}\left(\frac{\partial\left(g^{-1} \circ \varphi \circ f\right){j}}{\partial x_{i}}\right)\right|{f^{-1}(p)} \cdot v{i}\left(\frac{\partial}{\partial z_{k}}\right)_{0} \end{aligned} $$
上述4个公式中，第二个公式后的{-}同标题一样，表示不编号；\newLine{}
第三个公式后的{#eq:1}表示对公式打上名为eq:1的标记，就可以进行交叉引用了，使用[@eq:1]见公式[@eq:1]完成对该编号的引用
公式后面跟上{-}即可去掉单个公式的编号，公式后面跟上{.raw}即可保留单个公式的TeX代码，以便复杂公式或者Word无法正常显示的公式在Word导出后使用mathtype等软件手动或自动转换为对应格式的公式。
数学专业经常需要使用定理环境和证明环境。这两个环境使用了
TODO
注意空格
定理环境的书签无需使用前缀。当然，也可以自己加。
无名称无参考文献有标签
{.thm #thm:test}
: 第一段
: 第二段{.thm #thm:test} : 第一段 : 第二段
有名字有标签无参考文献：
定理名称 {.defn #def:limit}
: 第一段
: 第二段定理名称 {.defn #def:limit} : 第一段 : 第二段
有名字有标签有参考文献：
这是一个引理[@XuRhee-162] {.lem #lem:test}
: 第一段
: 第二段这是一个引理[@XuRhee-162] {.lem #lem:test} : 第一段 : 第二段
勾股定理[@JifaLingling-132] {.theorem #thm:gougu}
: 若
👉[@thm:gougu:c]👈为👉[@thm:gougu]👈，位于👉[@thm:gougu:page]👈。
极限的$\varepsilon-\delta$定义[@Philip-159] {.definition #def:limit}
: 设$\left{x_{n}\right}$是一给定数列，$a$是一个实常数。如果对于任意给定的$\varepsilon>0$，可以找到正整数$N$，使得当$n>N$时，成立$$\left|x_{n}-a\right|<\varepsilon$$则称数列$\left{x_{n}\right}$收敘于
定义编号：[@def:limit]，定理名称：[@def:limit:c]，定理页码：[@def:limit:page]
\newpage{}
在数学中，要计算一个无法直接求得的数值，经常采用逼近的方法，即计算出一列较容易求得、同时精确程度越来越好的数作为它的近似值.例如，古人为了求圆周率$\pi$，即圆的周长与直径之比，采用单位圆(半径为1的圆)的内接正$n$边形(
{.proposition}
: 若
::: {.proof}
假设
-
若
$a<b$ ，则$b\le a$ 不成立。 -
若
$b>a$ ，则$a \le b$ 不成立。
矛盾。
于是必有$a=b$. :::
通过上面这样的语法可以插入一张图片。和公式一样，在有题注的情况下，图片默认编号。
同样也可以采用和公式一样的语法来引用图片的编号，图片甚至可以设置宽度和高度，完整语法为：{#fig1 width=3cm height=2cm}，例如：
{#fig:0 width=3cm height=2cm}
↑上面这张图有编号有标签fig:0，\newLine{}下面这张图无编号无标签↓
{- width=3cm height=1cm}
这里是一个没有题注的图片↓
{- width=3cm height=1cm}
有时候图片的题注需要同时有中文和英文，使用语法![中文题注\sc{}英文题注](){}的方式生成英文题注。其中中文题注的编号自动完成，\sc{}命令通过在中文题注后面插入换行符和英文题注的前缀及序号来实现英文题注的插入，该参数可在metadata中自定义
{#fig:DoubleCaption height=2cm}
与公式不同的是，由于图片的复杂要求，以对上图为例，对其编号的引用语法为[@fig:DoubleCaption]，对其中文题注内容的引用语法为[@fig:DoubleCaption:c]，对其英文题注的引用语法为[@fig:DoubleCaption:sc]。（sc取second content）
即图👉[@fig:DoubleCaption]👈的中文题注内容为👉[@fig:DoubleCaption:c]👈，英文题注内容为👉[@fig:DoubleCaption:sc]👈。无论图片是否具有英文题注，其中文题注的引用都需要有后缀:c
图1：单语有标签 fig:1（编号标签fig:1，中文标题标签fig:1:c）
{#fig:1 height=1.5cm}
图2：双语有标签 fig:2（同图 1，外加英文标题标签fig:2:sc）
{#fig:2 height=1.5cm}
图3：无编号双语标签
{- height=1.5cm}
上面3张图片中，图[@fig:1]，其题注为[@fig:1:c]；图[@fig:2]，其中文题注为：[@fig:2:c]，英文题注为：[@fig:2:sc]。
普通的表格可以直接用Markdown的表格语法。根据学校的要求，我们把默认的表格样式设置为了三线表。套用表格样式的功能因为pandoc不支持，故目前无法实现。
| 第一列 | 第2列 | 第$x$列 |
|---|---|---|
| 左对齐 | 居中对齐 | 右对齐 |
| 数字 | 1231 | 4654 |
| 空 | sum | - |
: 这里是表头\sc{}English Table Title {#tbl:test}
表格编号：[@tbl:test]
表格编号去掉前缀：[-@tbl:test]
中文题注：[@tbl:test:c]
英文题注：[@tbl:test:sc]
页码：[@tbl:test:page]
页码无前后缀：[-@tbl:test:page]
CQU要求表格之后空一行，可在metadata中选择自动生成这个空行。
上面对题注进行了标记，注意需要在尾部使用空格将花括号和前面的内容分开。
显而易见，这个表格不能有高级操作，不能合并表格（其实pandoc是支持的，但是无法输出到Word，Markdown也没有对应的语法）
在reference.docx中制定好表格样式，并将其复制到新的表格，而后即可“自由”制作表格（例如合并单元格，长表格，对齐等），使用以下域代码（{IncludeText}）引入即可（亦可用来引入其他任何文档），该域代码只支持绝对路径，但引入之后会把原来的文档内容保留在本文档内，也就是只要不强行更新，即使发给别人别人仍然可以正确查看。
因为绝对路径的问题，这里我们做了个\includeDoc{}功能来使用相对路径引入文件，该功能只能单独成段使用。
注意，引入的文档中的样式会使用reference.docx中的对应样式，因此无需在新的文档中修改样式内容，只需应用对应样式即可，这里推荐复制reference.docx中的Compact样式，在本文所用的reference.docx中，该样式没有首行缩进，是制作表格比较良好的选择，同时也是pandoc默认使用的表格样式。
\includeDoc{Table.docx}
这两个语法属于Markdown的语法，学校排版要求并未做出明确规定
首先是一行内部的内联代码👉这里是内联代码some code👈
接着是单独成段出现的代码块
if a == 1:
print("str")纯文本测试
这里和上面的两行python代码会在一个框里
plain text
下面是一段xml代码
<w:lvl w:ilvl="3">
<w:start w:val="1"/>
<w:numFmt w:val="decimalEnclosedCircleChinese"/>
<w:pStyle w:val="4"/>
<w:lvlText w:val="%4"/>
<w:lvlJc w:val="left"/>
<w:pPr>
<w:ind w:left="0" w:firstLine="0"/>
</w:pPr>
</w:lvl>下面是一段python代码
# 绝对素数.py
# 将自然数区间10-1000中所有绝对素数挑选出来，每行打印输出5个。绝对素数是：一个数和其反序数都是素数。
List = [] # 创建空数组
flag = 1
count = 0 # 计数器初始状态为0
for i in range(10, 1001): # 自然数i在10-1000之间
for j in range(2, i):
if i % j == 0: # 自然数i是否是素数
flag = 0
break # 只要遇到一个因数，就可以不用进行后面的循环了
if flag == 1: # 如果经过上述判断flag还是1，说明正向是素数，现在判断反向素数
s = str(i)
m = int(s[::-1])
for n in range(2, m):
if m % n == 0: # 自然数i的反序数m是否是素数
flag = 0
break # 只要遇到一个因数，就可以不用进行后面的循环了
if flag == 1: # 将绝对素数全部添加至列表
List.append(i)
flag = 1
for k in List: # 将list打印输出，五个一换行
print(k, end=' ')
count = count+1
if count % 5 == 0:
print('\n')下面是一段对《歌剧魅影》剧本唱段台词的引用块。（这里是借助文本编辑器通过正则表达式批量生成的规范化文本，仅作炫技展示之用）
\tabC{}In sleep he sang to me
\tabC{}♪ 沉睡中他为我歌唱\tabC{}In dreams he came
\tabC{}♪ 梦境中他近我身旁\tabC{}That voice which calls to me
\tabC{}♪ 他的声音召唤着我\tabC{}And speaks my name
\tabC{}♪ 喃喃轻诉我的名字\tabC{}And do I dream again
\tabC{}♪ 我是否又重回梦境\tabC{}For now I find
\tabC{}♪ 此时此刻我才发现\tabC{}The Phantom of the Opera is there
\tabC{}♪ 歌剧魅影就在这里\tabC{}Inside my mind
\tabC{}♪ 潜伏在我心灵深处\tabC{}Sing once again with me
\tabC{}♪ 再次与我一起\tabC{}Our strange duet
\tabC{}♪ 同唱这奇妙的旋律
pandoc对页眉页脚的处理极其困难。
首先，每一个Word文件的尾部都存在一个“分节符”，通过指定rId值来控制这一节的页眉页脚具体指向哪个文件。也就是说，Word文档的页眉页脚实际上受控于分节符，通过分节符分配页眉页脚所在xml文件的rId值来确定具体显示哪一个页眉页脚。
pandoc会复制模版文件的第一个分节符内容放置于输出文档的尾部作为输出文档的最后一个用户无法手动插入的分节符，且pandoc会保证这个分节符里的页眉页脚的rId指向与模版文件分节符相同的xml文件，包装页眉页脚的一致性。
如果对文档嵌入自行添加的分节符，那么需要在分节符中手动指定对应页眉页脚的rId，但问题是，我们如何知道其rId值？
Word对rId有自己的理解，也就是说经过Word保存之后的文档，rId会被Word理顺（比如模版），而pandoc照着这个模版生成输出文档时，又会对rId按照自己的顺序理顺，造成模版的rId和输出文件的rId无法保持一致。
解决方案是，先在模版中创建好所有需要使用的页眉页脚，使Word中的rId固定，进而固定pandoc输出文件的rId，然后通过拆解文件手动对比前后的rId，找到输出文件中所期望的页眉页脚对应的rId值。
这里需要注意的是：
- pandoc会从模版文件第一个分节符的内容放到输出文件的尾部，并保证这个分节符里的rId指向与原来相同的文件，故输出文档的最后一节的分节符参数与模版文档的第一节分节符参数一致，拥有相同的页眉页脚，需要注意这里的顺序问题
- 如果rId没有对上，比如第一次输出时，不知道需要的页眉页脚的rId是多少，Word会报错，需要手动解压输出文档然后查看各个页眉页脚，找到需要的xml然后寻找其rId
编辑Markdown的metadata项目singlePage，根据模版中域代码的设定（详见附录[@sec:页眉:c]），当singlePage为1时表示单面打印，遵循排版要求中的单面规则，当singlePage不为1时（建议设置为0），表示双面打印，遵循排版要求中的双面规则。
亦可在导出的Word中手动设置Word的自定义属性页面看见此设置，如图
由于此设定采用了特殊的域代码DOCPROPERTY，该域代码无法自动完成更新（因为在页眉中，甚至不能全选文档通过F9一键完成更新），因此需要手动对每一个不同的页眉更新域代码（将光标置于域代码中可采用快捷键F9完成更新）
注：单双页面的设定依赖于Word文档中页眉页脚的“奇偶页不同”设定，但由于学校排版要求中“装订线”设定的存在，这个设置开启时，Word认为这是在双面打印，奇数页会在左侧留出装订线的空间，偶数页会在右侧留出装订线的空间；而这个设置关闭时，Word认为这是在单面打印，不管奇偶页都会在页面左侧留出装订线的空间，因此，除了需要手动更新域代码以切换奇偶页的页眉页脚之外，还需要手动切换“奇偶页不同”开关
可以通过标记书签，然后对书签进行引用，实现对书签的“内容”，“页码”，“编号”（如果有）的引用
对标题标记：在标题后面加上{#sec:jcyy}这样的标记（这里对上面的一级标题进行了标注）
对普通内容的标记：通过[文本]{#bookmark_name}这样的方式，用英文中括号把需要标注的文本框起来，后面写上花括号和书签名字
在Word中，对图表，标题等任意“编号”项目的编号引用都是通过书签实现的，在可视化的“交叉引用”窗格中引用时，Word会自动对被引用的编号标记书签，这类Word自动标记的书签会以_下划线开头，即_XXXXXXX的形式，默认在书签面板中隐藏。
在Markdown中，我们无法像Word一样生成隐藏式的书签，因为在Word之外根本就没有可视化的“交叉引用”窗格嘛。但是我们在引用时会手动设定“label”嘛，于是我们就通过对label的设定来实现各种交叉引用的处理。
这里有个问题就是：通常在LaTeX中，对公式或者图片进行引用时，得到的都是编号，而在Word中，通常直接得到的书签标记的是内容，比如对题注的标记，LaTeX中得到的是编号，而Word中得到的是题注的文本。
那我们在这里也把书签默认处理成对编号的引用如何？可Word里的书签不是所有的书签都有编号啊，万一书签没有对应的编号，就会产生错误引用。
为了解决这个问题同时保持和LaTeX以及其他插件的兼容性，我们做出如下规定：
- 若某个书签的名字中含有
:冒号，我们便将该书签视为对编号项的引用，记冒号前面的内容为“标识符”，用以区分不同的编号类型- 例如，
fig:abc中存在冒号，我们认为这就是一个编号项，且冒号前面的fig为其标识符 - 这里规定默认的标识符有：
- 章节：
sec - 图片：
fig - 表格：
tbl - 若干定理环境的标识符
thm，prf等
- 章节：
- 通过
[@fig:xxx]可以得到其编号 - 通过
[@fig:xxx:c]可以得到其内容（字母c取自content） - 特殊：因为公式
eq编号仅有编号，故公式无eq:xxx:c写法
- 例如，
- 若某个书签中不含有冒号，我们认为这是一个普通的文本书签
- 例如，
jcyy中不存在冒号，我们认为这是一个文本引用 - 通过
[@jcyy]得到其内容（域代码REF jcyy \h） - 通过
[@jcyy:no]得到其编号，若没有，则会出现引用错误（域代码REF jcyy \r \h）
- 例如，
- 任意书签通过
[@xxx:page]可以得到其页码（域代码PAGEREF xxx \h）
对于上述提到的各个“标识符”，对应章节有其实现方式，对于列表项目或脚注等内容，可以通过对“整个项目”标记带有自定义标识符的书签，而后通过交叉引用实现对其编号的引用，例如：
- 123
- [456]{#lst:456}
- 789
上述列表中，[@lst:456]位于[@lst:456:page]，内容为[@lst:456:c]
这一章对各种交叉引用进行测试。
对标题的引用以及对编号段落的引用方式完全相同，“编号段落”指前方带有编号的段落，例如有序列表。
## 标题引用测试：有前缀{#sec:title-no}
标题编号：[@sec:title-no]
标题编号（无前缀）：[-@sec:title-no]
标题内容：[@sec:title-no:c]
标题编号：[@sec:title-no] 标题编号（无前缀）：[-@sec:title-no] 标题内容：[@sec:title-no:c]
强烈推荐在标题的标签中使用 sec 前缀。没有该前缀的情况下，标签会当作普通元素的标签，参见[@sec:common-ref]。
无前缀的编号段落引用需要用:no后缀实现
## 标题引用测试：无前缀{#title}
标题编号：[@title:no]
标题内容：[@title]
标题编号：[@title:no] 标题内容：[@title]
题注的引用适用于表格，图片，定理环境。
| 测试表格 |
|---|
| 测试表格 |
: 这是中文表格题注\sc{}This is English Table Caption {#tbl:table-no}
表格编号：[@tbl:table-no]
中文题注：[@tbl:table-no:c]
英文题注：[@tbl:table-no:sc]
表格编号：[@tbl:table-no] 中文题注：[@tbl:table-no:c] 英文题注：[@tbl:table-no:sc]
强烈推荐在表格的标签中 tbl 前缀。没有前缀的情况下，标签会当作普通元素的标签，参见[@sec:common-ref]。
| 测试表格 |
|---|
| 测试表格 |
: 这是中文表格题注\sc{}This is English Table Caption {#table}
表格编号：[@table]
中文题注：[@table:c]
英文题注：[@table:sc]
表格编号：[@table] 中文题注：[@table:c] 英文题注：[@table:sc]
普通内容的引用用来验证对于含有奇奇怪怪前后缀或者无前后缀的内容的引用。
[这是一串测试用的纯文本]{#text}
文本内容：[@text]
[这是一串有着奇怪前缀的纯文本]{#qwe:text}
文本内容：[@qwe:text]
[这是一串有着奇怪前缀和后缀的纯文本]{#qwe:text:xxx}
文本内容：[@qwe:text:xxx]
页码：[@text:page]
页码（无前缀）：[-@text:page]
[这是一串测试用的纯文本]{#text} 文本内容：[@text]
[这是一串有着奇怪前缀的纯文本]{#qwe:text} 文本内容：[@qwe:text]
[这是一串有着奇怪前缀和后缀的纯文本]{#qwe:text:xxx} 文本内容：[@qwe:text:xxx]
页码：[@text:page]， 页码（无前缀）：[-@text:page]，
以上我们内容我们主要讲了 [@sec:title-no:c;@sec:section:c;@sec:common-ref:c] 三部分，它们分别在[@sec:title-no:page;@sec:section:page;@sec:common-ref:page]。
还可临时设定前后缀： [第 @sec:title-no 页].以上我们内容我们主要讲了 [@sec:title-no:c;@sec:section:c;@sec:common-ref:c] 三部分，它们分别在[@sec:title-no:page;@sec:section:page;@sec:common-ref:page]。
还可临时设定前后缀： [第 @sec:title-no 页].
这里测试标题书签的引用，记标题书签名为bkn。
- 引用内容文本的语法为：
[@sec:bkn:c] - 引用编号的语法为：
[@sec:bkn] - 引用页码的语法为：
[@sec:bkn:page]
以下是具体的引用测试：
- 标题文本：[@sec:ydm:c]
- 标题编号：[@sec:ydm]
- 标题页码：[@sec:ydm:page]
使用`{域代码}`{=field}可插入自定义的域代码，尾部的{=field}可以用{=docx}代替。
可以通过域代码来实现对书签，各种标题、编号的引用。上述的标题的各种引用，就是通过插入不同的域代码实现的，对于未实现的引用功能，可以自行查阅Word的域代码文档手动实现7。至于具体的“题注”“公式编号”等的域代码，因为单独做了功能封装且较为复杂，这里不表，相信Word熟手是很得心应手的。
插入域代码时，还可以指定域代码在未更新时显示的内容，使用语法`{域代码|显示内容}`{=field}即可（默认情况下，Word需要更新域代码内容才能正确显示其具体的内容，使用该语法可在未更新的情况下手动指定，而不会显示为空白）。
例如，使用域代码`{REF sec:jcyy|域代码还未更新}`{=field}可在未更新域代码的情况下显示为“域代码还未更新”，更新后将会显示上述的一级标题内容。
效果：{REF sec:jcyy|域代码还未更新}{=field}
在Word中，书签是可以嵌套引用的，例如，名为A的书签指向文本B，而文档中恰好有名为B的书签指向文本C，则可以通过嵌套引用通过A来引用书签B指向的文本C。
书签：[被引用的文字]{#test_ref}、[test_ref]{#test_ref_ref}、[test_ref_ref]{#test_ref_ref_ref}
Ref引用：`{Ref test_ref}`{=field}、`{Ref {Ref test_ref_ref|wtf}}`{=field}、`{Ref {Ref {Ref test_ref_ref_ref}}}`{=field}
第一行内容即定义了3个“套娃”书签，在第二行内容中将通过域代码实现嵌套引用，最终3段引用都将显示为被引用的文字这一相同文本
书签：[被引用的文字]{#test_ref}、[test_ref]{#test_ref_ref}、[test_ref_ref]{#test_ref_ref_ref}
Ref引用：{Ref test_ref}{=field}、{Ref {Ref test_ref_ref|wtf}|嵌套Ref域}{=field}、{Ref {Ref {Ref test_ref_ref_ref}|嵌套Ref域}|套娃}{=field}
参考文献的插入和LaTeX类似，通过一个.bib文件来实现，该文件可通过任意文献管理软件导出，为纯文本格式，通过[@xxx]这样的语法来进行引用。
而参考文献的格式由一个.csl格式的文件来控制，该文件可从citationstyle.org组织的github仓库下载https://github.com/citation-style-language/styles。也就是我们可以简单的替换一下这个文件，实现参考文献样式的“一键”切换
这里右上角会出现参考文献的引用[@JifaLingling-132]
一条参考文献不够，再来两个一起试试[@Perner-171; @WeichselbraunGindl-160; @YangGuo-164]
注意这里的参考文献是有超链接的，即，按住Ctrl键点击上标的参考文献数字，即可跳转到参考文献列表对应的文献处。
根据排版要求，参考文献的内容采用五号字体。
pandoc默认参考文献会生成在文档的最后方，但根据论文规范，参考文献之后还有“附录”，所以这里通过命令\Reference来实现在任意位置插入参考文献↓
\Reference{}
学校要求附录的字号为五号，因此这里需要通过在标题尾部写上{.appendix}来让插件识别并处理。
这是附录A中的内容，对附录中图片和公式的编号处理目前尚未完成。
附录B中的内容
由于附录的字号比正文小，所以这里测试一下在正文中的内联代码字号是否正常👉内联代码code code👈可见内联代码的字号并未跟随改变，和前文（见[@内联代码字号问题:page]）中提到的脚注中的代码一样。
- 摘要和正文
- 单面打印：左边为
type文本，右边为一级标题 - 双面打印：奇数页居中为一级标题，偶数页居中为
type文本
- 单面打印：左边为
- 目录
- 单面打印：左边为
type文本，右边为TOC Heading样式 - 双面打印：奇数页居中为一级标题，偶数页居中为
type文本
- 单面打印：左边为
不管是单面打印还是双面打印，这里都得设置页眉页脚为“奇偶页不同”，然后用域代码判断是否为单面打印，最后用域代码分左中右3个部分用特殊的制表符分隔跳转。
这里用类python的代码格式先描述域代码，方便后续照着修改查证
# 奇数页面
if singlePage=="1":
"type
\tabR{}
一级标题域代码"
else:
"\tabC{}
一级标题域代码"
# 偶数页面
if singlePage=="1":
"type
\tabR{}
一级标题域代码"
else:
"\tabC{}
type"若在目录部分，将“一级标题域代码”换成目录的域代码即可
其中，
singlePage域代码为{DOCPROPERTY singlePage \* MERGEFORMAT}type域代码为{DOCPROPERTY type \* MERGEFORMAT}- 一级标题域代码分为标题编号域代码和标题域代码，而标题编号域代码又需要先判断标题编号是否存在（和数字0比较）
- 标题编号域代码为
{IF { STYLEREF "标题 1" \n \* MERGEFORMAT } > 0 {STYLEREF "标题 1" \n \* MERGEFORMAT} } - 标题域代码为
{STYLEREF "标题 1" \* MERGEFORMAT}
- 标题编号域代码为
- 目录的域代码为
{STYLEREF "TOC 标题" \* MERGEFORMAT}
故连起来之后，最终域代码为
-
摘要和正文奇数页面
{IF {DOCPROPERTY singlePage \* MERGEFORMAT}="1" "{DOCPROPERTY type \* MERGEFORMAT}\tabR{}{IF { STYLEREF "标题 1" \n \* MERGEFORMAT } > 0 {STYLEREF "标题 1" \n \* MERGEFORMAT} }{STYLEREF "标题 1" \* MERGEFORMAT}" "\tabC{}{IF { STYLEREF "标题 1" \n \* MERGEFORMAT } > 0 {STYLEREF "标题 1" \n \* MERGEFORMAT} }{STYLEREF "标题 1" \* MERGEFORMAT}"} -
摘要和正文偶数页面
{IF {DOCPROPERTY singlePage \* MERGEFORMAT}="1" "{DOCPROPERTY type \* MERGEFORMAT}\tabR{}{IF { STYLEREF "标题 1" \n \* MERGEFORMAT } > 0 {STYLEREF "标题 1" \n \* MERGEFORMAT} }{STYLEREF "标题 1" \* MERGEFORMAT}" "\tabC{}{DOCPROPERTY type \* MERGEFORMAT}"}
注意其中的\tabC{}和\tabR{}不是域代码而是在域代码中手动插入的特殊制表符
文档最后这里也是有一个分节符的，这个分节符是文档自带的，在pandoc转换的过程中，文档尾部的分节符会从模版中继承下来，也就不需要手动设定了。这里的分节符在模版中已经设定好，采用阿拉伯数字从1开始编号。↓