昨天群内万宏伟老师提出了一个需求：想要enumerate具有以下功能：

1. 一个chapter内的不同的enumerate环境可以连续编号
2. 在新的chapter的开始，enumerate环境会重置计数器

起因是他想一个chapter是一份试卷，每一份试卷都是从1开始编号，问题很容易理解

群里有老师说要重设计数器，我个人并不想要这种做法，理由如下：

• 重设计数器之后要怎么做？重新做一个list出来？
• enumitem宏包对enumerate环境这么好的增幅效果，这么好的轮子就不能用了

所以基本实现的想法是去修改enumerate环境的定义，具体实现如下：

实现的思路分析

功能1的实现

连续编号这个功能早在enumitem宏包的resume*键（带星号的会继承label的样式，不带星号的只继承计数器的值，考虑到一半都会修改label，所以采用了带星的）就可以实现，但是喜欢偷懒的我不想要每次都要输入resume*，如果把enumerate改成自己本身自带resume*选项不就行了？

但是直接renew的话，可是我们不知道enumerate本身咋定义的，难道还要去翻过来并且重新去弄list？那也太麻烦了，而且我们也不是改定义，只是想让

1
2
3

\begin{enumerate}

\end{enumerate}

具有

1
2
3

\begin{enumerate}[resume*]

\end{enumerate}

的效果，这咋搞？

我们重新看我们的需求，其实我们并不是要修改enumerate本身的定义，而是要在它之上加点东西而已。

这个时候，我想到了以前看乙醇哥的一篇博客《统计一节中的列表项数量》里面有一个做法我印象深刻：复制副本，简单来说就是

1. 先把命令\foo复制一个副本\fooo出来，也就是把定义放到一个新的命令里去，怎么定义的我不关心，我只知道我把它已经存起来了，随时可以被调用

2. 用\def修改原命令

   1 2 3 4

   \def\foo{ % something you want to add \fooo }

   由于\fooo和\foo是等效的，所以就是我们在原来的基础上加了东西，这个做法有迭代的味道在里面，也有数学或物理里的“看作整体”想法在。

但是这个地方我们是环境怎么办？那我们只需粗略但不严谨地知道，一般环境foo的定义其实是定义了两个宏\foo和\endfoo，那我分别储存这两个宏的副本就行。

加上一点点小细节就变成了下面的代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

\ExplSyntaxOn
\makeatletter
% 储存副本代码
\let\@enumerate\enumerate
\let\@endenumerate\endenumerate
% 重定义enumerate环境
\RenewDocumentEnvironment{enumerate}{ O{} !b }
  {
  % 因为chapter最开始的enumerate环境不需要resume
  % 所以加一个LaTeX3的简单整数判断bool从句
    \int_compare:nNnTF { \theenumi } = {0}
      { \@enumerate[#1] }
      { \@enumerate[resume*, #1] }
      #2
  }
  {
    \@endenumerate
  }
\makeatother
\ExplSyntaxOff

PS：xparse宏包的使用我在我的LaTeX3个人学习经验文章里也有呼吁大家去读文档学习，是我在见到hlist环境、TikZ、LaTeX3 后震惊的第四种代码（不经想到作者都是什么神仙怪物，怎么会发明出这么牛的命令）非常推荐大家学习

功能1其实就已解决了，可以直接使用enumerate环境也获得resume*的效果而不用手动添加

功能2的实现

代码其实很简单

1

\setcounter{enumi}{0}

然后我们的目的就转化为：如何在每个\chapter命令的时候自动加载这个代码？

也就是能不能把这个代码嵌入\chapter命令里面？

我们仿照功能1的思路就可以得到下面的代码：

1
2
3
4
5

\let\ch@pter\chapter
\def\chapter{
  \setcounter{enumi}{0}    % 注意这个要放在\ch@pter的前面，放在后面会报错，我也不懂TeX，也不知道为啥
  \ch@pter
}

还有一种方法就是用etoolbox宏包的hook命令\pretocmd，和上面一样只能用pre放在前面，而不能用\apptocmd放在后面，希望知道原因的大佬能留言告知下原因

1
2

% \usepackage{etoolbox}
\pretocmd{\chapter}{\setcounter{enumi}{0}}{}{}

功能2的代码完善

上面说到设置计数器的代码只能放在\ch@pter的前面，经过乙醇哥的提醒，发现问题出在：\chapter命令是需要接收参数的，如果像上面那样的方式不做处理直接把设置计数器的代码移到\ch@pter后面的话，\chapter就会自动识别后面的代码为参数，但是本身也不是纯文本的，所以会报错。

还有一个需要注意的是，我们上面的做法没有考虑到\chapter*，所以现在需要把这个加上。

知道原因了就好解决了，既然会影响参数设定，那我就提前“把参数喂给\ch@pter”，这样他就不会往后面“找吃的”了。

用上一点点LaTeX3的cs函数和xparse的s指定（用来处理带*命令），我们便得到了下面的代码：

（有一个重要的知识：\chapter[]{}与\chapter*{}，也就是带*命令没有可选参数，虽然源代码是定义了两个命令分别控制，但是为了帮助记忆和理解，就相当于这里的*作为了\chapter的可选参数已经被“吃掉了”，就只剩下必选参数）

1
2
3
4
5
6
7
8
9
10
11
12
13

\cs_set_eq:NN \chapter:nn \chapter    % 相当于我们之前的把\chapter复制给\ch@pter一样
\cs_new:Npn \chapter_star:n #1
  {
    \chapter:nn * {#1}
  }

\RenewDocumentCommand{ \chapter }{ s O{#3} m }   % 注意#2的默认值是#3，如果为空的话目录和页眉就没有标题了
  {
    \IfBooleanTF {#1}
      { \chapter_star:n {#3} }
      { \chapter:nn [#2] {#3} }
    \setcounter{enumi}{0}
  }

查一下\chapter定义的源码知道，不能直接通过\apptocmd来直接处理\chapter，因为它不是显式定义的，而是对\@chapter和\@schapter命令的包装，所以如果\apptpcmd到\chapter的尾部的话，代码就会挡住“参数的入口”，反而被误当参数而吃掉了。但是\@chapter和\@schapter是显式定义的（也就是我们通常的\newcommand或\def定义的，对于参数怎么处理我都约定好了，apptocmd到这两个命令的话，就是我们所期待的效果，而且不会挡住“入口”，这样的话\chapter接收到的参数就会根据定义来分配给\@chapter或\@schapter命令。

之所以放在前面是可行的，是因为设置计数器部分的代码并没有“挡住进食口”，所以原来咋样就咋样。

一个完整的MWE

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

\documentclass{book}
\usepackage{enumitem}
\usepackage{etoolbox}
\ExplSyntaxOn
\makeatletter
\let\@enumerate\enumerate
\let\@endenumerate\endenumerate

\RenewDocumentEnvironment{enumerate}{ O{} !b }
  {
    \int_compare:nNnTF { \theenumi } = {0}
      { \@enumerate[#1] }
      { \@enumerate[resume*, #1] }
      #2
  }
  {
    \@endenumerate
  }

% 下面两种方法都行
% 第一种是用etoolbox的pretocmd
% \pretocmd{\chapter}{\setcounter{enumi}{0}}{}{}

% 第二种是copy一个副本出来重定义chapter
\let\ch@pter\chapter
\cs_set_eq:NN \chapter:nn \chapter
\cs_new:Npn \chapter_star:n #1
  {
    \chapter:nn * {#1}
  }
% \def\chapter{
%   \setcounter{enumi}{0}
%   \ch@pter
% }

\RenewDocumentCommand{ \chapter }{ s O{#3} m }   % 注意#2的默认值是#3，如果为空的话目录和页眉就没有标题了
  {
    \IfBooleanTF {#1}
      { \chapter_star:n {#3} }
      { \chapter:nn [#2] {#3} }
    \setcounter{enumi}{0}
  }
\makeatother
\ExplSyntaxOff


\begin{document}

\tableofcontents

\chapter{1}

\begin{enumerate}[label = \roman*.]
  \item 1
  \item 2
\end{enumerate}

\begin{enumerate}
  \item 3
  \item 4
\end{enumerate}


\chapter{2}

\begin{enumerate}
  \item 1
  \item 2
\end{enumerate}

\begin{enumerate}
  \item 3
  \item 4
\end{enumerate}

\end{document}

相关链接

本文多处是在乙醇哥的帮助下完善的，特此感谢！

欢迎读者关注他的博客：无锤乙醇和Github：syvshc

宏包基本情况

Package: LaTeX package for flexibly LaTeXing choice items based on hlist and LaTeX3.

Repository: Github仓库

Repository: Gitee仓库

Author: Kangwei Xia E-mail

宏包说明

choices宏包是一个用于排版选项的宏包, 包含但不限于以下特点： - 可以排版任意数量的选项 - 可以方便切换标签风格label-style - 可以更改标签label与内容的相对位置 - 可以调整标签label的偏移 - 自动识别是否使用 includegraphics 命令并自行调整 anchor 的位置（仅 choices* 有此功能, 之所以会有 choices* 命令, 就是因为基于 hlist 环境的 choices 只有一个方位, 无法更改, 所以需要用另外的方法处理（ choices* 是用 coffin 进行处理））. 此功能的实现需要将 expl3 宏包更新至最新（至少是2021-11-12后）, 否则可能无法使用且会报错.

在需要排版选项的情况中（比如试卷、问卷排版等）choices宏包可以发挥重要作用, 旨在让用户更多关注在内容本身, 契合LaTeX的内容与样式分离的思想.

choices宏包是基于hlist环境与LaTeX3开发的LaTeX宏包, 它提供了choices(*) 两个主命令与coffinchoice、hlistchoice和quan三个副命令. choices和choices*是利用了xparse宏包对hlistchoice与coffinchoice命令进行封装. 其中choices等效于hlistchoice, choices*等效于coffinchoice.

通常情况下使用 choices 命令就够了, 但是用户如果有排版图片的需求, 可能需要将 label 置于内容的上方或下方, 而 choices 命令基于 hlist 环境编写, 所以label 只能置于内容的左侧, 这个时候只需要使用choices*, 会自动更改anchor为south, 如果需要修改自动的anchor为其它的方位可以使用\choicesetup{autopic = north} .

更多宏包细节与命令欢迎阅读宏包手册choices_usrmanual.pdf（用xelatex编译choices_usrmanual.tex即可）

如果使用过程中发现了issue或者有什么建议, 欢迎提出

• Github issues
• Gitee issues

宏包设计和构想思路

宏包的产生背景我其实在choices_usrmanual.pdf中解释过，在这里简要地再提一下：

• 对于选择题的选项排版
  • 已有的选项排版命令受限于参数的个数，比如四个参数的命令必须要有四个选项
  • 对于多选题，问卷的选项排版，选项个数不确定，如果要从1-9个参数都自定义命令那非常麻烦，而且如果按照传统的自定义命令方式最多有9个必选参数，如果有更多的排版需求，那么这些方法已经失效
  • 已有的命令无法切换label的样式

基于上述的背景，我一开始基于hlist环境整合了一些功能，用LaTeX3的seq模块来切割选项，解决了参数个数问题，产生了\choices命令（本质是\hlistchoice命令）。

但是\choices命令有一个小问题：label的位置非常局限，即使是上下偏移都无法通过hlist宏包本身来实现，而且还遇到一个问题：图片类型的选项排版。

图片排版也是中学老师经常碰到的一种问题，我目前了解的情况来看，大部分都是通过表格来完成的，但是“使用表格”本身有一丢丢违背LaTeX的“内容与样式分离”的想法，因为我的目的还是为了排版选项，而不是表格。

对于图片的排版，label通常情况下更多放置在图片的正上方或正下方。基于上述原因，我就需要开发另一种选项排版的命令\choices*（本质是\coffinchoice）可以方便地切换不同的anchor（借用了TikZ中的术语），满足不同需求。受耿楠教授的hanzibox宏包启发，我决定使用LaTeX3的coffin来完成此命令的研发，最后在几天的调试下基本实现了想要的功能。

宏包代码优化

李泽平老师当时看了我的代码和我说，一个命令的代码不应该超过一个屏幕，所以我需要对代码进行优化。

其实我最开始设计的时候就是想有优化的：也就是一些算法可以单独抽离出来成为单独的函数，其实很多成熟的宏包都是这么做的，但是我没这么弄过，没有任何经验，最开始弄的时候直接出bug，然后想着“先实现再完美”（因为我一直以来都有点完美主义，导致了不少的拖延hhh），现在功能基本实现，就尝试优化一下代码。

键值优化

键值的有一定规范，比如使用-来分隔使得更容易阅读，比如random-items就是控制items的乱序。

用于记录我想编写解决的代码问题

• 选择题或解答题和图在一起的时候的排版
  • coffin
• 选择题的末行括号自动出现
• choices命令结合答案

自己的LaTeX经历杂谈

最开始是大二第一次接触，具体怎么知道的LaTeX我已经忘记，但是当时主要是被LaTeX的数学公式排版所吸引，我还记得当时在图书馆看刘海洋的书，一边看一边在TeXShop里看例题的编译效果，这种反馈虽然比word的所见即所得要略慢一丢丢，但也没差到哪里，而且精致的数学排版让我一下就喜欢上了LaTeX。

应该就是在大二大三那个时候，自己也偶尔瞎研究，当时什么LaTeX工作室，论坛，tex.se都不知道，自己搞beamer、笔记模版啥的，遇到问题直接百度，CSDN，东拼西凑，我还深刻记得当时去弄水印背景，还是查到用box的方式结合fancyhdr宏包来处理（其实就是把图片放在了页眉或者页脚的方式）那个水平垂直距离都是一点点手动去调整尝试，现在想想都有点莫名的辛酸hhh。

然后就因为平常没什么需求用到，就搁置了LaTeX很久都没动，一直到了大三的那个暑假夏令营要弄简历，我就想着要不用LaTeX弄一个简历出来，然后很自然地就去网上找模版（其实都不太满意，这也是为什么我现在都不太用别人的模版的原因之一），好不容易找到一个整体还算满意的，但是编译起来就是出bug（这是我不用别人模版的原因之二，别人的较为成熟的模版一般都有较强的一致性，比如一些自定义的命令之类的，自己如果功力不够在那瞎改那就很容易报错），时间又很紧，于是去网上找人代排，好像是花了50元改了一小个地方。

正好那个时候我想到了我本科的毕业论文模版是CTEX套装写的（现在基本已经被淘汰了），就想着要不也让人重写一个，结果我一问价格，800起步，我直接一个震惊给到！

莫名的我就很气，气我自己的LaTeX怎么这么菜，就是那一次我就下定决心一定要学好LaTeX。

然后大四搞毕业论文，上课什么的也没搞，就想着毕业的暑假搞。在学校的时候机缘巧合下知道了万述波老师的书，然后买了一本发现还不错，然后在万老师的群里又看到陈晓老师也要出一本书，而且是更多应用之类的，我个人对LaTeX的应用和实现效果是很感兴趣的，所以也在刚发行的时候果断也买了一本。

在暑假主要的时间就是在跟着陈晓老师的书一点点码，有的时候还出了很多的bug，书上也会有点小错误，就这里问，那里查，不过在群里我也认识了很多LaTeX水平很高的老师，比如耿楠教授、李泽平老师，乙醇哥等等，也有和我一样也是在学习LaTeX的同学，比如郭李军学弟（现在也变得水平很高了），他们在我的LaTeX学习过程中提供了莫大的帮助，在这里要表示衷心的感谢！

我现在重新看自己的暑假的学习，我印象最深的应该就是三个：tabularray宏包、TikZ和LaTeX3：

• tabularray宏包
  • 其实我在码书上的表格部分的时候群里的老师就推荐我用这个宏包了，我当时的想法是基础的还是要掌握的，所以一直拖到一本书搞完才接触了这个宏包，然后...真香，这个宏包简直太厉害，对表格的处理非常的人性化，和原来的普通表格处理简直是天差地别
• TikZ
  • TikZ的node当时真是让我觉得很震惊，因为我发现我以前辛苦研究的那个水印的问题，用node可以轻松完成，而且相对距离这个是我非常喜欢的，因为在原来的某个参数变了之后，其它的可以“牵一发而动全身”，不需要自己再去手动调整，这才是符合我预期的计算机的功能，
  • TikZ学完之后其实很少有绘图的需求，但是偶尔会用来画个小玩意，比如用node搞了个命令实现overlay的效果，主要在逻辑推导过程中，实现箭头（也可以变成其它的）上面可以有问号或是其它任何字符，灵活度更高
• LaTeX3
  • 这应该是我现阶段用的最多的代码
  • 我本身是对TeX的底层实现挺感兴趣的，但是一些相关的书却有点让我不太容易读懂，因为我本身没有计算机的基础，读起来有些头疼（orz）。但是刚好那个时候LaTeX工作室发了项子越老师录制的LaTeX3讲解视频，然后一下子打开了新世界
  • 统一格式、优化宏展开等等有点让我入了LaTeX3的坑，而且用它也某种程度上弥补了我本来想学习TeX的想法（虽然LaTeX3的一些命令没有TeX的基础还是读不了，但是对于大部分的内容是可以且容易理解接受和应用的），因为我最根本还是想能够自己实现一些功能，设计一些小东西。
  • 但是目前（即使是现在）关于LaTeX3的教程其实还是没有很多。为什么我要强调“教程”呢？因为LaTeX3的官方文档interface3.pdf或source3.pdf是API性质的文档，个人理解是可以看作是一本字典，它会把变量函数的功能很客观地告诉你，虽然对于大部分来说，看了之后基本是知道怎么用的，但是也有相当一部分读完后还是一脸懵逼，如果类比一下高中学习的话，就会感觉例题太少了，如果学生的能力还不到位的话，只讲概念定理，学生对于其的把握还不到位，遇到问题也不知道如何去解决。而从我个人的LaTeX3学习经验来看，我觉得读别人写好的作品是一个很好的学习方式，其实这些就相当于是一个个例题，如果能够读懂，并明白其中的使用方式的话对于学好LaTeX3也是有非常大的帮助的。所以我的博客的有一个模块就是LaTeX3实例分析，只能以我浅薄的知识尝试去理解去读懂这些代码的逻辑等等，希望能够帮到有需要的人。

目前基本是主要用LaTeX3写一些小玩意，LaTeX3甚至超过了TikZ对我的吸引力hhh，但是TikZ用好也很厉害，还是都要好好学一下。

我在很久之前自己写过一个LaTeX3学习个人经验，整理了自己学习过程中的学习资料，并写了一些学习心得，只分享给了两位老师，一个原因是这两个老师当时就想学习LaTeX3，第二个原因是时间有点匆忙，我的文字叙述并不流畅和简洁（虽然口语化容易读懂，但是感觉写成书面文章还是需要适当的言简意赅）

后来郭李军学弟在LaTeX工作室发了一个LaTeX3学习资料 ，我发现整理的和我差不多，但是多了两三个（然后我马上就码住了hhh）。其实现在市面上能找到的LaTeX3资料其实还是有不少的，对于LaTeX3入门应该是足够的，但是如果想要LaTeX3能更深入地学习下去（比如学习interface3.pdf介绍的一些LaTeX2e中不常见（对于一般用户来说比较少用）的模块，如regex、prg、msg、file等等）现在已有的资料某种意义上是不够的。

但是其实已经有很多优秀的宏包文类是用LaTeX3编写的，比如ctex宏集,tabularray.sty,fduthesis.cls等，但是这些都是一些大佬编写，本身并不是为了告诉你怎么使用LaTeX3而编写的，所以读起来会有一定难度，但是如果细品的话能够发现里面有很多细节和变量函数的使用是值得我们学习的，所以需要一个“引路人”能够带我们读懂这些代码，或是分析一些其中的细节。

而我的博客想做的主要就是这个事，我的代码水平其实非常的一般，但是我想把我能读懂的，我的一些体会分享出来，大家一起讨论学习，这样对我来说也是有很大的提高。

目前关于LaTeX3想做的主要但不限于下面几个：

• 分析一些LaTeX3实例，LaTeX3应用的代码
• 讲述、记录或分析我自己用LaTeX3写命令的想法和思路（也能够帮助我进一步优化）
• 一些LaTeX3的常用方法和技巧

个人推荐的LaTeX3学习顺序

了解背景和LaTeX3基础

背景

• 曾祥东老师的知乎文章：LaTeX3 教程（一）——背景知识
• LaTeX工作室发布，项子越老师录制的b站视频：LaTeX3 教程一：简介

基本语法和知识

• 曾祥东老师的知乎文章：LaTeX3 教程（二）——语法概要
• LaTeX工作室发布，项子越老师录制的b站视频：LaTeX3 教程二：变量，函数及基本程序结构

宏展开

• LaTeX工作室发布，项子越老师录制的b站视频：LaTeX3 教程三：宏展开

一些示例的应用

• 曾祥东老师的知乎文章：LaTeX3 教程（三）——从一个例子说起

• LaTeX工作室发布，项子越老师录制的b站视频：LaTeX3 编程 终章 - 教程四：常用库

• 项子越老师的个人博客中有一个latex3-tutorial中有视频中没提到的一些内容，绝大部分函数模块都给了个例子，大致告诉你LaTeX3能够实现一些什么样的效果

细节补充

• 知乎一位大佬写了一篇文章：一份勉强简短的LaTeX3编程介绍，如果完成上面部分学习的读者阅读这篇文章，就会发现这篇文章是对上面内容的一个“总结体”，并且补充了一些小细节，即使学完了上面的内容也推荐学习一下
• LaTeX3团队成员Joseph Wright写的一些文章（不止LaTeX3），很多内容比如xparse宏包的声明命令和其它宏包的区别，关于LaTeX3的宏展开的f,o,x 有什么区别等文章都非常值得一看

自己动手写小玩意

• 在学习了上面的内容后，读者已经完全能够自己动手写一点小玩意了

分析他人的作品、应用

• LaTeX工作室里也有一些用户上传的作品 ，可以自己尝试阅读一下代码看看
• 慢慢地可以开始读一些LaTeX3编写的宏包或文类了，看看大佬们是怎么用这些变量函数的，比如用clist 模块的函数来批量处理（比如批量声明新变量）等等

希望掌握的“技能”

养成良好的代码规范

• LaTeX3有自己的一套代码规范 ，和LaTeX2e的代码规范有一定的区别，不管是为了自己写、修改方便还是为了代码分享的时候他人阅读方便，都希望读者养成良好的代码规范习惯

学习xparse宏包

• xparse宏包提供的命令不仅能够封装LaTeX3的代码，在LaTeX2e的使用过程中体验会更好
• lshort-zh-cn.pdf中有部分介绍，但是还是希望直接读xparse的官方文档

学会到论坛提问

• tex.se 国外的网站，大佬很多，只要你的问题描述清楚，基本都会有大佬反馈
• LaTeX工作室提问 国内的网站，也有很多大佬，听说雾月大佬回答非常详细，而且LaTeX3功力也极强

目前想到的分类和标签有以下这几个，会不断补充与完善：

分类

• 杂谈
• LaTeX杂谈
• 数学杂谈
• LaTeX3实例分析
• LaTeX问题解决
• LaTeX3应用
• 个人作品

标签

• LaTeX
• LaTeX3
• 问题解决
• 实例分析
• 杂谈
• 应用
• 宏包

在 Hexo 的 Fluid 主题中使用 LaTeX 公式

\(x^2\)

\[\lim_{n \to \infty} x^n = 0\]

图床

PicGo

组图

如果想把多张图片按一定布局组合显示，你可以在 markdown 中按如下格式：

1
2
3
4
5
6
7

{% gi total n1-n2-... %}
  ![](url)
  ![](url)
  ![](url)
  ![](url)
  ![](url)
{% endgi %}

total：图片总数量，对应中间包含的图片 url 数量 n1-n2-...：每行的图片数量，可以省略，默认单行最多 3 张图，求和必须相等于 total，否则按默认样式

Tag 插件

#便签

在 markdown 中加入如下的代码来使用便签：

1
2
3
4
5

{% note success %}
文字 或者 `markdown` 均可
{% endnote %}

# 注意：上面第一行和第三行要单独成行

或者使用 HTML 形式：

1

<p class="note note-primary">标签</p>

可选便签：

#行内标签

在 markdown 中加入如下的代码来使用 Label：

1

{% label primary @text %}

或者使用 HTML 形式：

1

<span class="label label-primary">Label</span>

可选 Label：

1

{% label primary @text %}

#勾选框

在 markdown 中加入如下的代码来使用 Checkbox：

1

{% cb text, checked?, incline? %}

text：显示的文字 checked：默认是否已勾选，默认 false incline: 是否内联（可以理解为后面的文字是否换行），默认 false

示例：

后面文字不换行

也可以只传入一个参数，文字写在后边（这样不支持外联）

#按钮

你可以在 markdown 中加入如下的代码来使用 Button：

1

{% btn url, text, title %}

或者使用 HTML 形式：

1

<a class="btn" href="url" title="title">text</a>

url：跳转链接 text：显示的文字 title：鼠标悬停时显示的文字（可选）

text

社交页图标

在主题配置中设置：

1
2
3
4
5

about:
  icons:
    - { class: 'iconfont icon-github-fill', link: 'https://github.com', tip: 'GitHub' }
    - { class: 'iconfont icon-douban-fill', link: 'https://douban.com', tip: '豆瓣' }
    - { class: 'iconfont icon-wechat-fill', qrcode: '/img/favicon.png' }

• class: 图标的 css class，主题内置图标详见这里
• link: 跳转链接
• tip: 鼠标悬浮在图标上显示的提示文字
• qrcode: 二维码图片，当使用此字段后，点击不再跳转，而是悬浮二维码

其它一些小细节

关于苹果的Mac搭建博客中需要注意的

• npm install -g hexo-cli安装如果不成功，要使用管理员权限，输入sudo -s回车输密码，然后再安装

如何链接邮箱

1
2

# 注意要加一个mailto:
[E-mail](mailto: kangweixia_xdyy@163.com)

参考

• Fluid配置指南

• Front-matter

• 博客的搭建步骤主要参考乙醇写的文章

• 语法基础篇：https://kiyanyang.github.io/posts/78e09c9c/

Quick Start

Create a new post

1

$ hexo new "My New Post"

More info: Writing

Run server

1

$ hexo server

More info: Server

Generate static files

1

$ hexo generate

More info: Generating

Deploy to remote sites

1

$ hexo deploy

More info: Deployment