离线下载
PDF版 ePub版

偶尔e网事 · 更新于 2018-11-28 11:00:43

发表博文

Octopress 结合 Github 搭建博客是很酷,但是别忘了初衷是写博文,可不要本末倒置了。

发表博文

新建博文

使用如下命令新建博客文章

rake new_post['Hello Github Blog']  

编辑博文

可以在 Octopress/source/_posts 中看到2013-11-13-hello-github-blog.markdown,这就是博文了,这是用 markdown 语法写的,编辑完内容后保存。

预览博文

rake generate  
rake preview  

发布博文

rake deploy 

推送 source 分支

git add .  
git commit -m "First Blog"  
git push origin source  

Markdown

概况

Octopress 写博客是用 markdown 写的,markdown 是一种轻量级的标记语言,相关介绍请参照维基百科http://zh.wikipedia.org/wiki/Markdown Windows 下推荐使用 markdownpad2 编辑器,下载地址:http://markdownpad.com/,它提供了实时预览的功能,当然收费版更强大,对于普通用户,免费版足够了。

语法

markdown 的语法可以参见:

示例

用 markdownpad2 打开刚刚创建的博文 2013-11-13-hello-github-blog.markdown,可以看到

---  
layout: post #布局  
title: "Hello Github Blog"  #标题  
date: 2013-11-13 15:38  #时间  
comments: true #评论  
categories: #分类  
---  

修改如下,因为 markdown 允许兼容 html,所以可以直接用 html 语法来写。

按照发表博客的步骤执行,打开 geekjacky.github.io 可以看到:

点击 Read on → 可以看到整篇文章:

解决中文问题

你可能在执行 rake generate 时出现这个错误。

这是因为博客有中文的关系,用文本工具打开C:\Ruby193\lib\ruby\gems\1.9.1\gems\jekyll-0.12.0\lib\jekyll\convertible.rb,修改第 28 行为。

self.content = File.read(File.join(base, name), :encoding => 'utf-8') 

如下图,重新运行 rake generate 即可。

上一篇: 配置博客 下一篇: 博客克隆