和开开心心类似的成语:技术博客利器——Octopress

来源:百度文库 编辑:偶看新闻 时间:2024/04/28 07:24:07

技术博客利器——Octopress

Octopress简介

Octopress is a framework designed by Brandon Mathis for Jekyll, the blog aware static site generator powering Github Pages.

优点

用文件方式储存数据,无需数据库
以静态方式发布,可直接挂在github等地方
用markdown格式写博客
可以轻松的配置和发布

常用命令

注意

有些机子上运行可能会报错,需要在命令前加上bundle exec

添加文章

1
$ rake new_post["title"]

运行后会通过title生成相关文件、链接,可在文件里修改显示出来的标题。
title可以使用中文,会自动转化为拼音(个人不建议,因为链接会比较无意义)。

123
$ rake generate       #发布文件到public目录$ rake watch          #监控source和sass目录的变动$ rake preview        #启动服务器并监控变动,通过http://localhost:4000预览

发布

12
$ rake generate$ rake deploy

保存源代码

因为发布的只是生成的静态页面,
需要在项目里建立source分支用于保存整个项目源代码(配置、markdown文件等)。

123
$ git add .$ git commit -m 'blog'$ git push origin source

更多设置

添加”关于我”

source下新建about目录,并在里面添加index.markdown文件。
编辑导航条source/_includes/custom/navigation.html
注意:index.markdown文件需要加上头,否则会找不到。

首页只显示摘要

  • 在文中加入来控制摘要截取位置
  • 修改_config.yml里的excerpt_link控制链接文字

部署到Github

操作步骤参考:Deploying to Github Pages
如果你有自己的域名,可参考:Github Page绑定自己域名

Bug Fix

不能进行deploy(Github)

问题:有次发现$ rake deploy不能发布,但是预览正常。检查github上source分支代码已更新,但master仍为老代码。
原因:发现是因为代码是新从github下clone下来的,未进行初始化deploy。
解决:需要执行$ rake setup_github_pages进行初始化。
注意:rake操作应该在source分支下进行,若是刚从github里clone下来的,请先执行$ git checkout source

修改的样式preview时不生效

问题:预览时发现之前设置成功的自定义样式不生效,变回默认样式。
解决:$ rake generate即可,会重新生成css。

参考

Octopress官方文档
markdown语法

Posted by 思扬 Ruby