如果你也渴望拥有一个属于自己的博客, 那么你应该花费一些时间好好阅读本教程.
学习最好的方法论 -- 就是去做.
什么是 GitHub Pages?
GitHub Pages 是 GitHub 提供的静态站点托管服务, 它可以通过 GitHub 库托管你的个人, 组织或项目的站点.
你可以使用 Jekyll Theme Chooser 在线创建和部署 GitHub Pages 站点. 如果你更喜欢通过本地创建和部署站点, 你也可以使用 GitHub Desktop 或者命令行.
GitHub Pages 是一种静态网页托管服务, 因此不支持 PHP, Ruby, or Python 等服务端代码.
本教程使用 Hexo 搭建个人 GitHub Pages, 因此如果你想创建和部署组织或项目的网页, 部分内容可能会不太适用, 需要自行作出调整.
注意: GitHub Pages 站点在互联网上是公开可见的, 即便你的托管库是私密的. 因此如果在你的网页库中有敏感数据, 你可能会想在网页发布前移除它们.
什么是 Hexo?
Hexo 是一个快捷, 简洁且高效的博客框架. 你可以使用 Markdown 书写博文, 弹指一挥间 Hexo 就可以利用其精致的主题生成精美的静态博客网页.
Markdown 是一种标记语言, 其语法简洁明了, 学习容易, 而且功能比纯文本更强大.
准备
下载, 安装与配置 Git
下载与安装 Node.JS
什么是 Git ? Git 是目前世界上最先进的分布式版本控制系统 (没有之一).
下载, 安装与配置 Git 的具体方式取决于你当前所使用的操作系统.
基于 Windows 操作系统安装 Git
下载 Git for Windows https://git-scm.com/download/win 安装程序. 由于众所周知的原因, 从左侧的链接下载 Git for Windows 十分缓慢. 可以参考页面 https://github.com/waylau/git-for-win , 收录了存储于百度云的下载地址.
安装完成后, 还需要最后一步设置, 在命令行输入:
- $ Git config --global user.name "Your Name"
- $ Git config --global user.email "email@example.com"
例如, 你的名字为 Yunhao Zhu, 邮箱为 mailto:1234@qq.com :
- $ Git config --global user.name "Yunhao Zhu"
- $ Git config --global user.email "1234@qq.com"
基于 Mac OS X 操作系统安装 Git
有三种方法:
使用 Homebrew https://mxcl.github.io/homebrew/ , MacPorts https://www.macports.org/ :
brew install Git
直接从 AppStore 安装 Xcode,Xcode 集成了 Git, 不过默认没有安装, 你需要运行 Xcode, 选择菜单 "Xcode"->"Preferences", 在弹出窗口中找到 "Downloads", 选择 "Command Line Tools", 点 "Install" 就可以完成安装了.
或者下载 Git for Mac OS X 安装程序.
基于 Linux 操作系统安装 Git
- Linux (Ubuntu, Debian):
- sudo apt-get install Git-core.
- Linux (Fedora, Red Hat, CentOS):
- sudo yum install Git-core.
安装 Node.JS
下载 安装程序 https://nodejs.org/ 安装 Node.JS
在 Windows 上安装时务必选择全部组件, 包括勾选 Add to Path
安装完成后, 请打开命令提示符 cmd 输入
node -v
出现 vxx.xx.xx 代表安装成功!
安装 Node.JS 的最佳方式是使用 https://github.com/creationix/nvm
- cURL:
- $ curl https://raw.github.com/creationix/nvm/v0.33.11/install.sh | sh
- Wget:
- $ wget -qO- https://raw.github.com/creationix/nvm/v0.33.11/install.sh | sh
安装完成后, 重启终端并执行下列命令即可安装 Node.JS
$ nvm install stable
第三部: 安装 Hexo
呼, 准备工作终于完成了! 让我们马上使用 NPM 来安装 Hexo, 执行如下命令:
$ NPM install -g hexo-cli
安装 Hexo 完成后, 接着执行以下命令:
- $ hexo init <folder>
- $ cd <folder>
- $ NPM install
例如, 你安装在 c 盘 hexo 文件夹下, 则执行:
- $ hexo init /c/hexo
- $ cd /c/hexo
- $ NPM install
- $ hexo generetor
- $ hexo server
什么是 NPM?
NPM 是 Node.JS 的包管理工具 (package manager), 帮助我们管理开发中会用到的各种 Node.JS 包, 极大的方便了我们的开发.
新建完成后, 指定文件夹的目录如下:
.
├── _config.YAML
├── package.JSON
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes
打开浏览器输入 http://localhost:4000/
创建 GitHub Pages
注册 GitHub https://github.com/ 账号
新建一个 repository 库, Repository name 输入 "Your username.github.io"
点击 Settings 下拉至 -> GitHub Pages -> Page name 必须与刚才的库名保持一致 -> 选择一个喜欢的主题 Publish page -> 在地址栏输入你的博客地址即可看到效果
将本地 Hexo 代码部署至 GitHub
修改本地 Hexo 站点的配置文件 _config.YAML, 在末尾添加 (xxx 为你注册的 GitHub 用户名)
- deploy:
- type: Git
- repository: https://github.com/xxx/xxx.github.io
- branch: master
利用 NPM, 上传本地代码, 第一次 GitHub 可能会要求你输入用户名和密码
- NPM install hexo-deployer-Git --save
- hexo g
- hexo d
输入刚才设置的 https://github.com/xxx/xxx.github.io 即可查看效果
发布你的第一篇博客, 在根目录下输入
- $ hexo new "postname"
- $ hexo g
- $ hexo d
结语
恭喜你! 看到这里, 你已经成功掌握了个人博客的搭建技术, 教程到这里也就结束了, 都是最最基础的内容, 关于 GitHub Pages 和 Hexo 还有很多进阶内容等着你去学习. 本教程后续也会有更多进阶内容, 如果你感兴趣的话, 欢迎持续关注.
最后, 作者水平有限, 如有错误, 遗漏, 欢迎批评指正.
来源: http://www.jianshu.com/p/6a69297d1b88