【译】为何我还在使用 Vim 编辑器?
哦不,并不是因为我不知道怎么退出它。 [1]
/images/vim_skin.jpeg

Read more…

再谈 Markdown 及其扩展

尽管笔者专门写了一个文章系列 《从 Markdown 到 reStructuredText》,推荐在日常文档写作中更多地使用 reStructuredText。不过平心而论,Markdown 标记语言其实还是不错的,再加上一堆漂亮好用的客户端,使其作为博客写作语言相当合适。静态博客 Nikola 本身也对 Markdown 开箱提供了完整支持,Markdown 与 reStructuredText 一样都是“一等公民”。

Nikola 中使用的语法与主流 Markdown 语法,可以说是一模一样的。同时,还以扩展的形式 1 额外提供了一些:

Read more…

给 Nikola 博客添加 mermaid 支持

还是给博客集成了 mermaid [1] 图表功能,尽管目前用的很少……与 mathjax 一样,使用的时候给文章添加 mermaid 标签,然后在文章中给描述文本指定 mermaid class 即可。就像这样:

.. container:: mermaid

   graph TD
   A[Christmas] -->|Get money| B(Go shopping)
   B --> C{Let me think}
   C -->|One| D[Laptop]
   C -->|Two| E[iPhone]
   C -->|Three| F[Car]
[1] mermaid 使用 javascript 从纯文本描述产生流程图、序列图、甘特图等图表类型。

Read more…

Nikola 博客资源链接问题

写博客的时候,经常会插入各种超链接。外部链接不必理会,正常插入即可。但是博客内部链接(譬如,请参阅上一篇文章: 30 分钟搭建一个 Nikola 博客 )却是需要额外关注,规范做法应该是这样: /posts/30-fen-zhong-jian-li-yi-ge-nikola-bo-ke/ ,而不是这样: https://macplay.github.com/posts/30-fen-zhong-jian-li-yi-ge-nikola-bo-ke/ 。从最终效果来看貌似没有区别,但是如果发布到其它站点或者将来更换域名,第二种做法的缺陷就暴露出来了:届时需要将成百上千篇文章中的链接进行相应替换。因此,及早规范博客内部链接还是比较重要的。

Read more…

XeTeX 的中文化设置

看过一些文章得出结论:即使用 XeTeX 编译中文,也需要额外添加 xeCJK 包设置下字体。笔者也一直是这么做的。

刚尝试了下,这一步其实是不必要的。直接用 fontspec 设置中文字体,不必引入额外的包:

%! TEX program = xelatex

\usepackage{fontspec}
\setmainfont{PingFang SC}
\setsansfont{Hiragino Sans GB}
\setmonofont[Scale=0.9]{PingFang SC}

\usepackage{indentfirst}
\setlength{\parindent}{2em}

\XeTeXlinebreaklocale "zh"
\XeTeXlinebreakskip = 0pt plus 1pt minus 0.1pt

第 1 行指定编译引擎 xelatex 。不成文的规范,LaTeX 客户端或编辑器插件不一定会遵守。

第 3-6 行使用苹方和冬青黑体,macOS 上的默认字体。

第 8-9 行分别设置首行缩进和缩进间隔。

第 11 行使用中文断行方式,否则段落会合并成一行。

第 12 行还不清楚啥意思,不过好多文章都有,暂时不删除。

这几行精简的配置,足以应付 macOS 上绝大部分编译场景。如果是其它操作系统,注意替换中文字体。通过 rst2xetex.py 命令转换过来的 tex 文件,添加以上几行,就能顺利编译。

Contents © 2018 ashfinal - Powered by Nikola