Mac下搭建github+jekyll写作环境

之前有在公共博客或是专业的技术博客上写写文章、笔记。后来由于从事安全相关行业,转而把一些工作中的总结、笔记记录在了OneNote上,纯离线不对外开放。但这种转换导致文章产出率很低,常常半年写不了一篇文章。为了能够督促自己将技术或是生活点滴记录下来,寻找一种使用Markdown语法,干净整洁的写作环境:github+jekyll,这正是我想要的。

升级Command Line Tools

由于刚升级了"优圣美地",需要安装一下Command Line Tools,安装jekyll需要。

$ xcode-select --install

更新RubyGems到最新版本

安装jekyll需要RubyGems。https://rubygems.org/pages/download

$ gem update --system          # may need to be administrator or root
$ gem install rubygems-update  # again, might need to be admin/root
$ update_rubygems              # ... here too

安装jekyll

jekyll是纯静态blog,无需数据库支持,将markdown转为页面。 $ gem install jekyll # may need to be administrator or root

Clone jekyll-bootstrap

这是一个快捷搭建jekyll+github pages的工具。 $ git clone https://github.com/plusjade/jekyll-bootstrap.git $ cd jekyll-bootstrap $ jekyll serve

在Github上创建帐号,并创建一个USERNAME.github.io的仓库,这个就是你的个人主页的空间了。 然后将jekyll-bootstrap的目录结构导入到此仓库,jekyll的环境准备就绪。

替换jquery链接

由于默认theme里jquery使用了googleapis的连接,导致访问会很慢或挂掉,所以这里替换为本地的jquery。

下载一个jquery压缩版放入/assets/javascript/jquery-1.11.1.min.js 然后将_includes/themes/bootstrap-3/default.html中的

https://ajax.googleapis.com/ajax/libs/jquery/1.10.2/jquery.min.js

替换为:

/assets/javascript/jquery-1.11.1.min.js

中文支持

将jekyll默认的markdown解析引擎maruku 更换为RDiscount

sudo gem install rdiscount

然后在_config.yml中highlighter: pygments之后加一行markdown: rdiscount,这样再次生成网站的时候就使用RDiscount来解析md文件了。

个性化域名

USERNAME.github.io文件夹下新建一个CNAME文件,里面的内容就是你的域名,比如USERNAME.me

然后按照GitHub所说将你的域名指向204.232.175.78这个ip(最新地址:192.30.252.153、192.30.252.154),这样当再次访问你的域名的时候,就会指向GitHub Pages了(可能DNS更新会需要一段时间)。

安装&更换theme

安装一个jekyll模板,然后使用它来变更blog界面。

rake theme:install git="https://github.com/jekyllbootstrap/theme-the-program.git"
rake theme:switch name="the-program"

调整首页

页面可以适当做一些调整,比如菜单名称等等。

开始写作...

rake post title="Hello World"

使用jekyll命令行创建文章,然后去_post目录下用markdown编辑器或vim编辑文章。

时间: 2024-09-15 08:56:16

Mac下搭建github+jekyll写作环境的相关文章

wxWidgets(1) :mac下搭建wxWidgets 3.0 环境

本文原文连接: http://blog.csdn.net/freewebsys/article/details/45643897 转载请注明出处! 1,关于wxWidgets 参考:http://zh.wikipedia.org/wiki/WxWidgets wxWidgets(Windows and X widgets,最早命名为wxWindows[1])是一个开放源代码且跨平台的对象工具集(widget toolkit),其库可用来创建基本的图形用户接口(GUI).wxWidgets由Jul

《C语言编程魔法书:基于C11标准》——3.2 macOS系统下搭建C语言编程环境

3.2 macOS系统下搭建C语言编程环境 macOS系统也不默认自带C语言编译器.然而,用户可以自己去Mac App Store免费下载macOS下的强大开发工具--Xcode.该集成开发工具采用Apple定制版本的Clang编译器,称为Apple LLVM编译器.它自带C.C++.Objective-C以及Apple自己新推出的Swift编程语言编译器,还有一系列功能强大的代码静态分析以及性能剖析工具. 下载完Xcode之后,把它打开.如果是第一次启动,Xcode会自动更新一些资源,完了之后

如何在mac下搭建云服务器?

问题描述 如何在mac下搭建云服务器? 最近学习了android,想自己搭建个云服务器,在mac用什么程序搭建比较好?mac怎么连接云服务器也不是很清楚.或者是推荐看看什么书? 解决方案 http://www.cnblogs.com/wx1993/p/5022670.html

《C语言编程魔法书:基于C11标准》——第3章 C语言编程的环境搭建3.1 Windows操作系统下搭建C语言编程环境

第3章 C语言编程的环境搭建 我们在第2章讲述了学习C语言所必需的一些预备知识.本章将给大家介绍常用桌面操作系统下的C语言环境搭建.这里所讲述的C语言编译器以及集成开发环境(IDE)都是可合法免费下载的,本书不鼓励各位使用盗版或破解软件,所以下面会列出下载这些合法免费软件的官方链接,大家把编程环境搭建完之后即可上机实践编程. 3.1 Windows操作系统下搭建C语言编程环境 Windows操作系统下默认不自带任何C语言编译器,大家必须从网上下载自己所需要的C语言编译器.如果各位想通过C语言开发

Linux服务器下搭建hadoop集群环境 redhat5/Ubuntu 12.04

Ubuntu 12.04 下搭建 hadoop 集群环境步骤 一. 搭建环境前的准备: 我的本机Ubuntu 12.04 32bit作为maser,就是上篇hadoop单机版环境搭建时用的那台机子,http://www.linuxidc.com/Linux/2013-01/78112.htm 还在KVM中虚拟了4台机子,分别起名为: son-1        (ubuntu 12.04 32bit),son-2        (ubuntu 12.04 32bit),son-3        (

windows7下搭建hadoop集群环境

问题描述 有人会在win7下搭建hadoop集群环境吗?我急需要搭建,有会的帮帮忙吧,我整了两天了没弄出来,着急死了!cygwin安装完运行sshlocalhost出现这种错误,是怎么回事啊? 解决方案 解决方案二:我是真心不会,帮顶吧,有份资料可以参考下,去搜"王家林hadoop".解决方案三:楼上的问题解决了吗?我跟你遇到了完全相同的问题~跪求答案

cygwin在win7下搭建hadoop集群环境

问题描述 江湖救急!!有人会在win7下搭建hadoop集群环境吗?我急需要搭建!cygwin安装完运行sshlocalhost出错!

Mac 下搭建Android开发环境

1.Java运行时: 在bash终端中输入java,如果没有安装java运行时会自动弹出一个Dialog提示是否安装,点击安装即可. 2.Eclipse + ADT + SDK: 在Mac下好像不需要下载Eclipse,又或者是现在Google专门打包定制了开发环境,反正只需要到:http://developer.android.com/sdk/index.html#download下载集成包即可.顺便白一句,在Mac下打开android.com明显快很多,没理由啊-- 无需单独下载Eclips

MAC下Android的Eclipse开发环境的搭建

一.Eclipse的下载       到网站:http://www.eclipse.org/downloads/ 上,由于我们是用Java开发的所以步骤如下: 1.  找到"Eclipse IDE for java Developers"此处右上角会根据你当前使用的系统自动选择,Mac下就会自动选择位"Mac OS X(Cocoa)" 2.  然后点击右边的"Mac OS X 64bit"(这里我的Pro是i5处理器可以用64位的),根据你的机器