Blog Posts 博客文章的 markdown源文件 存储在 source/_posts 文件夹下面,文件名是根据 Jekyll's naming 规则命名的。默认名字是这样的: YYYY-MM-DD-post-title.markdown 该文件的名称将被用作链接地址,日期有助于区分相同的文件名字,然后还可以确定(按日期的)显示排序。 新帖子 rake new_post["title"] 例子 rake new_post["Zombie Ninjas Attack: A survivor's retrospective"] # Creates source/_posts/2011-07-03-zombie-ninjas-attack-a-survivors-retrospective.markdown 文件名会决定你的网址。根据上面的命令,链接的网址会是这样的 http://site.com/blog/2011/07/03/zombie-ninjas-attack-a-survivors-retrospective/index.html 在文本编辑器中打开一个帖子 markdown源文件,你会看见帖子的元数据,这些数据会告诉 Jekyll 程序如何处理帖子和页面。 例如 nano source/_posts/2011-07-03-zombie-ninjas-attack-a-survivors-retrospective.markdown --- layout: post title: "Zombie Ninjas Attack: A survivor's retrospective" date: 2011-07-03 5:59 comments: true external-url: categories: --- 其中 layout 有两种,一是 post(帖子),二是 page(页面)。他们的区别是决定网页的样式。title 是标题 "Zombie Ninjas Attack: A survivor's retrospective" 是带有引号的。comments 是评论,true 是允许评论,false 是禁止评论。但是仅仅设置为 true 是允许评论还是不能评论的,需要添加 Disqus Comments 插件才会出现评论框。external-url 假如你想发布一个 linklog 形式的帖子(博客条目指向外部链接),只需简单的在 external-url 添加 URL 就可以了。 categories 是分类的意思。类似 wordpress 上的标签。可以给一篇帖子贴标签。使用方式是这样 categories: - CSS3 - Sass - Media Queries 每行用 - 开头加上 单词或者句子 表示一个分类,三行表示这个帖子同时属于三个分类。 还可以在 comments: 上面插入一行author: Your Name 手动指定帖子的署名(这样将显示和之前设置的默认作者不同的名字),以便达成在一个博客上多人写作各自署名,比如你是个计算机爱好着,你收到了一个计算机科学家的回信,你把信写作一个帖子发布,此时帖子的署名不应该是你,而是计算机科学家的名字。 在这个 Your Name 替换成需要显示的名字。 另外 author: Your Name 下面接一行published: false 这样帖子就不会被编译,可以理解成设置帖子为草稿。当你需要暂缓发布某个帖子的时候会有用。 删除本行或者 设置 false 变成 true 帖子就会被编译发布。 New Pages 你能在你博客源目录的任何地方加一个新页面,它们都会被 jekyll 解析。 URL将正确的指向文件路径,所以 about.markdown 将变成 site.com/about.html。 假如你喜欢你的 url 是 site.com/about/,那么你要创建的页面为 about/index.markdown。 也有一个很简单的 rake 任务来生成页面。 rake new_page[super-awesome] # creates /source/super-awesome/index.markdown rake new_page[super-awesome/page.html] # creates /source/super-awesome/page.html 跟创建新文章的任务一样,默认的扩展名也是 markdown,但是你能在 Rakefile 文件里配置它。一个刚生成的页面可能是这样子的: --- layout: page title: "Super Awesome" date: 2011-07-03 5:59 comments: true sharing: true footer: true --- 标题是从文件名衍生出来的,所以你可能想改变它。这根生成一个新文章是一样的,除了不包含分类,你可以切换分享以及评论或者干脆移除底部。假如你不想在页面显示时间,你从 yaml 移除它就是了。 |