|
导航:[首页]->[www]->[为Jekyll博客添加category分类]
####原文:http://www.pizn.me/2012/02/23/use-category-plugin-for-jekyll-blog.html #为文章添加分类 在编辑一篇文章的时候,我们会在文章的头部写上一些 key 值, 同样的道理,我们可以为 这篇文章添加上 category 来分类。 #添加分类功能到你希望它出现的地方 在这里,你只需要把下面的代码拷贝到你的博客中,就能看到你添加的文章出现的分类了。 #为博客添加 category 插件 添加 category 插件很简单,只要在根目录下建立一个 “_plugins” 文件夹,然后拷贝category_plugin.rb 文件到里面就好了。 category_plugin 文件的源代码可以在这里查看到。 这个插件的作用有两点:
#添加 category_index.html 模板 这个模板是为了将我们的分类主页显示出来,显示的内容是一个分类的所有文章。也就是分 类列表的链接地址。具体使用到的代码如下: 你也可以参考我的分类主页来设计自己的分类主页,具体的效果,我截个图看看。我的分类主页的源代码在这里。 #我们写的代码最终是如何完成工作的? Ok, 在完成上面的步骤之后,我们需要编译一遍。在终端 cd 到你的博客目录,输入 jekyll –server ,然后再回头看看我们的博客文件夹。 在 site 文件夹下,你会发现多了一个 categories 文件,里面就有包含的所有分类文件夹。同时,你也会发现在与 categories 同级的文件下也有这些分类文件夹,但他们存放的是我们的所有分类文章。 还有个变化,就是我们的文章链接 URL,添加了分类的文章,在日期前面会多了分类的名称。例如:pizn.me/Jekyll/2012/02/23/user-category-plugin-for-jekyll-blog.html #需要注意的,还有我疑惑的(需要大家帮忙看看的) 因为添加了插件,所以要确保你的 config.yml 文件里面的 safe 属性值为 false,因为这 个属性值为 true 的时候是使自定义插件失效。 我疑惑的是,我在本地完成上面的步骤之后,分类列表的每个分类链接可以成功到达分类的详细列表页面(即 category_index.html),然而我上传到 github,没有报错,却无法到达那个页面,显示 404 错误。求大牛帮忙解决。 #笔者注 注意,因为安全问题,GibHub在生成网站时是不会调用用户目录中的插件的。如果想使用插件,一个方案是在本地生成网站,然后把_site目录作为一个项目放在GitHub上,这个方案我没有尝试;目前针对我使用的两个插件,我把它们的生成目录指向了项目根目录下的categories和tags,这样Jekyll在生成页面时会把这两个目录作为普通目录处理,即直接放到生成网站的根目录下,稍嫌麻烦的是要在本地看结果时需要生成两次。 #参考 |