折返的Liung

我如溪水,静静流淌在山涧~~我如白云,俯瞰此生今生~~

Pelican官方文档阅读笔记


Articles and pages

  • article:一种有时间顺序的文件,诸如博客中的推送,一般都带有明确的日期。

  • page:一般来讲不是一些暂时性的东西,经常用来充当博客中长时间不会改变的内容(比如abot、contact页面等)。通过设置DISPLAY_PAGES_ON_MENU设置是否要在主导航菜单显示page中的内容(默认为True),在标签中设置status:hidden来隐藏page中特定的文件。

File metadata(文章的元数据)

一般写的博客中包含一些metadata数据。makedown格式的书写方式:

Title: My super title
Date: 2010-12-03 10:20
Modified: 2010-12-05 19:30
Category: Python
Tags: pelican, publishing
Slug: my-super-post
Authors: Alexis Metaireau, Conan Doyle
Summary: Short version for index and feeds

This is the content of my super blog post.
  • 日期(Date):如果文章中没有指定日期或者配置文件中没有设置DEFAULT_DATE = 'fs',那么pelican将采用文件系统的 mtim时间,并根据文件所在位置的文件名进行分类(category)。
  • 分类:如果您你想用其他方式组织你的文章,可以在配置文件中设置USE_FOLDER_AS_CATEGORY = False
  • authors:采用逗号分隔的作者列表,如果单作者,可以采用author标签。
  • summary:配置文件中可以通过SUMMARY_MAX_LENGTH设置summary长度。
  • 文件名:通过FILENAME_METADATA设置,采用正则表达式。诸如'(?P<date>\d{4}-\d{2}-\d{2})_(?P<slug>.*)'

Linking to internal content(文件中的链接)

格式:

{filename}path/to/file

为向后兼容,也支持|filename|path/to/file,({ }替换为| |)但可能与reST、markdown等格式冲突,建议不用。

设置静态文件(自动生成时将copy此文件到bolog目录):

STATIC_PATHS = ['images', '...']

Syntax highlighting(语法高亮)

Markdown格式:

A block of text.

<code goes here>

以python为例:

class DemoClass:
    def __init__(self):
        pass
    def myFunction(self):
        print "Hello"

identifier指定为pythonruby等语言即可。

待补充......

参考阅读

  1. Pelican官方文档
  2. Pelican中文文档

Comments