计算机‎ > ‎网络‎ > ‎

Octopress 日常二

发布者:guo rue,发布时间:2016年3月19日 07:40   [ 更新时间:2016年3月22日 02:19 ]
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 移除它就是了。