Octopress是一个基于jekyll的静态的静态博客站点生成系统,很大程度的简化了jekyll搭建博客过程。
wordpress有太多的缺点:需要买主机,域名。它还是动态的,并且过度的依赖数据库,迁移成本高。
Git安装:
版本管理工具,可以将我们生成的静态网页托管到GitHub上。
设置全局
git config --global user.name "name" 配置username
git config --global user.email "邮箱" 配置邮箱
设置ssh
ssh -keygen -t rsa -C "邮箱" 设置rsa的数字指纹,一个是公钥,一个是私钥
公钥要提交到github上,私钥需要自己保存
验证ssh key
ssh -T git@github.com 会用本地的私钥和github的公钥进行匹配
Ruby安装:
DevKit安装
http://rubyinstaller.org/add-ons/devkit/
DevKit与Ruby两者的关联
ruby dk.rb init
执行关联操作 会生成config.yml 配置文件;ruby dk.rb install
跳出下面提示,表示安装成功 [INFO] Updating convenience notice gem override for ‘d:/Ruby21
[INFO] Installing ‘d:/Ruby21-x64/lib/ruby/site_ruby/devkit.rb‘
可能遇到问题
没有发现我们安装的ruby目录的话,需要手动的到刚才生成的config.yml文件中进行添加:
vim config.yml
MarkdownPad安装
windows下的markdown语法编辑器
awesomium安装
实现markdown编辑与预览的效果
Pygments安装
安装 Python
python –V
Python 2.7.6
安装 ‘Easy Install’
python “C:\ez_setup.py”
安装 Pygments
easy_install --version
setuptools 3.1
easy_install Pygments
克隆Octopress到本地
安装依赖库
先配置一下安装源
gem sources -a http://ruby.taobao.org
在安装源地址中append一个淘宝的ruby地址gem sources -r http://rubygems.org
将ruby自带的http的安装源remove掉 source "http://ruby.taobao.org"
安装依赖库
gem install bundler
安装bundler bundle install
安装并使用默认主题
rake intall
生成一个source目录rake generate
生成public文件rake preview
打开一个服务,进行预览preview安装好的主题
静态网站加载很慢
新建博客
rake new_post["title"]
新建单页面
单页面和博客是不一样的,单页面在博客首页是看不到的,单页面可以用来做一些例如 About Me的页面之类的
方式一:rake new_page[page1]
在creates/source/page1/index.markdown会自动生成一个page1的文件目录,并在里面生成一个index.markdown文件`
方式二:rake new_page[page1/pagename.html]
creates/source/page1/pagename.html 会自动生成一个page1的文件目录,并且在里面生成pagename.html的网页文件
代码高亮markdown书写之后,解析失败
这是由于缺少了 Pygments这个解析代码片段高亮的插件
解决方法:返回之前步骤安装Pygments
新建一个名为username.github.io格式的仓库
必须要验证邮件才能使用github.io
与本地的Octopress目录绑定
rake setup_github_pages
为了保证部署的网站是最新的,先执行下面的命令生成最新的网站rake generate
rake deploy
会将最新的public目录中的静态网站生成到deploy文件夹中,并push到github
将source目录更新到远程仓库
git add .
git commit -m “message”
git push origin source
创建一个源码的分支,这样就可以在任何电脑使用了
git clone -b source xxxxxxxxx
;rake intall
生成一个source目录rake generate
生成publicrake setup_github_pages
绑定起来git pull origin master
更新github上的之前绑定的网站到此目录【不然会导致deploy失败】可以设置url,title,author等信息
评论功能
duoshuo_comment: true
html
{% if site.duoshuo_comment == true %}
<section>
<h1>Comments</h1>
<div id="disqus_thread" aria-live="polite">{% include post/duoshuo_comment.html %}</div>
</section>
{% endif %}
在source_includes\post目录下新建一个多说的评论模板
代码来之多说网站,进行一些全局变量的修改之后,代码如下:
<!-- 多说评论框 start -->
<div class="ds-thread" data-thread-key="{{ page.id }}" data-title="{{ page.title }}" data-url="{{ site.url }}{{ page.url }}"></div>
<!-- 多说评论框 end -->
<!-- 多说公共JS代码 start (一个网页只需插入一次) -->
<script type="text/javascript">
var duoshuoQuery = {short_name:"your duoshuo name"};
(function() {
var ds = document.createElement(‘script‘);
ds.type = ‘text/javascript‘;ds.async = true;
ds.src = (document.location.protocol == ‘https:‘ ? ‘https:‘ : ‘http:‘) + ‘//static.duoshuo.com/embed.js‘;
ds.charset = ‘UTF-8‘;
(document.getElementsByTagName(‘head‘)[0]
|| document.getElementsByTagName(‘body‘)[0]).appendChild(ds);
})();
</script>
<!-- 多说公共JS代码 end -->
打开 JiaThis网站获取分享代码
在_config.yml中新建一个jiashare的分享开关
jia_share: true
修改source_includes\post目录下的sharing.html
添加下面代码 :
{% if site.jia_share %}
{% include post/jia_share.html %}
{% endif %}
在source_includes\post目录 下添加jia_share.html
代码就是从jiathis网站拷贝的代码
创建一个404.markdown文件 设置一下其基本属性如下:
---
layout: page
title: "404 Not Found"
date: 2015-08-23 08:38:49 +0800
comments: false
---
<script type="text/javascript" src="http://www.qq.com/404/search_children.js" charset="utf-8"></script>
添加一个aboutme的导航
先执行rake new_page[aboutme]
再在\source_includes\custom目录下的navigation.html中添加一个导航:
<li><a href="{{ root_url }}/aboutme">AboutMe</a></li>
rake install[‘themename’]
rake generate
安装主题会导致之前修改的模板之类的全部被覆盖消失
所以必须做好备份操作
创建source/CNAME文件并指定域名:
echo ‘xxxx.com‘ >> source/CNAME
OR
echo ‘www.xxxx.com‘ >> source/CNAME
使用的是子域名
创建一个CNAME 指向 username.github.io
使用的是顶级域名
使用A记录,指向192.30.252.153(154)【github.io的ip地址】
版权声明:本文为博主原创文章,未经博主允许不得转载。
原文:http://blog.csdn.net/u011771755/article/details/48026253