标签:Markdown

共 1 篇文章

Pelican进阶配置

上周在重新配置博客的时候涉及到了一些以前没接触过的Pelican的配置,现在考完试有空了来把它们理一理,算是个进阶的配置吧。

Markdown扩展

我的内容的编写使用的是Markdown,所以在配置的时候需要适当的设置一下所使用的Markdown扩展,通过在 pelicanconf.py 中对 MD_EXTENSIONS 进行适当的赋值即可,我的配置如下:

MD_EXTENSIONS = ['codehilite(css_class=highlight)', 'extra', 'toc(permalink=true)']

总共三项:

  • 第一个是参考我所引用主题的作者的配置,应该是代码高亮的配置。
  • 第二个包含了一系列的小扩展,我主要是为了获得表格及代码块的支持。
  • 第三个是为了生成目录,我的主题会提取文章的目录。

Pelican的Markdown支持是直接使用的其他人的模块,因此更多的扩展以及详细内容可以参见 Markdown模块官方文档

Pelican page

配置的时候涉及到page是因为我希望增加一个独立的about页面,但我的主题原先没有提供,所以得绕一点了(可能有不用绕的方法,但没搜到)。这部分只介绍一下page的概念以及相关的配置,如何绕的放在下一部分。

page按照直面的翻译也就是 页面 的意思,往后都用这个词来表示。它与你的文章拥有同级的地位,这一点可以从主题的 templates 中拥有 article.html ...

阅读全文