手把手教你建github技术博客

适合人群

• 喜欢写Blog的人
• 有必定的编程基础
• 爱折腾的人
• 熟练使用版本控制Git
• 了解使用Github
• 熟悉基本的MarkDown语法

环境准备

安装Git

下载 msysgit 并执行便可完成安装。

安装Node.js

在 Windows 环境下安装 Node.js 很是简单，仅须下载安装文件并执行便可完成安装。

安装hexo

利用 npm 命令便可安装。（在任意位置点击鼠标右键，选择Git bash）

npm install -g hexo

问题

• npm ERR! registry error parsing json 错误

可能须要设置npm代理,执行命令

npm config set registry http://registry.cnpmjs.org

• hexo:command not found
  删除刚刚安装的npm目录，从新执行命令npm install -g hexo安装hexo，

建立hexo文件夹

安装完成后，在你喜好的文件夹下（如H:\hexo），执行如下指令(在H:\hexo内点击鼠标右键，选择Git bash)，Hexo 即会自动在目标文件夹创建网站所须要的全部文件。

hexo init

安装依赖包

npm install

本地查看

如今咱们已经搭建起本地的hexo博客了，执行如下命令(在H:\hexo)，而后到浏览器输入localhost:4000看看。

hexo generate hexo server

好了，至此，本地博客已经搭建起来了，只是本地哦，别人看不到的。下面，咱们要部署到Github。

问题

• 执行hexo server提示找不到该指令
  解决办法：
  在Hexo 3.0 后server被单独出来了，须要安装server，安装的命令以下：

  npm install hexo -server --save

  安装此server后再试，问题解决

github 建立博客

• 注册帐号

  地址：https://github.com/
  输入帐号、邮箱、密码,而后点击注册按钮.
  
  
  

  1

建立页面仓库

这个仓库的名字须要和你的帐号对应，格式: yourname.github.io
输入基本信息，而后点击建立仓库.

2

3

注意
命名规则：你的github帐号.github.io，我这里被坑了，以前是jekell写的，如今换成hexo，因此我是另建创库了。

生成SSH密钥

ssh-keygen -t rsa -C "你的邮箱地址"，按3个回车，密码为空。

在C:\Users\Administrator.ssh下，获得两个文件id_rsa和id_rsa.pub。

在GitHub上添加SSH密钥

打开id_rsa.pub，复制全文。https://github.com/settings/ssh ，Add SSH key，粘贴进去。

hexo使用

目录结构

.
├── .deploy #须要部署的文件
├── node_modules #Hexo插件
├── public #生成的静态网页文件
├── scaffolds #模板
├── source #博客正文和其余源文件，40四、favicon、CNAME 都应该放在这里
| ├── _drafts #草稿
| └── _posts #文章
├── themes #主题
├── _config.yml #全局配置文件
└── package.json

全局配置 _config.yml

# Hexo Configuration ## Docs: http://hexo.io/docs/configuration.html ## Source: https://github.com/hexojs/hexo/ # Site #站点信息 title: #标题 subtitle: #副标题 description: #站点描述，给搜索引擎看的 author: #做者 email: #电子邮箱 language: zh-CN #语言 # URL #连接格式 url: #网址 root: / #根目录 permalink: :year/:month/:day/:title/ #文章的连接格式 tag_dir: tags #标签目录 archive_dir: archives #存档目录 category_dir: categories #分类目录 code_dir: downloads/code permalink_defaults: # Directory #目录 source_dir: source #源文件目录 public_dir: public #生成的网页文件目录 # Writing #写做 new_post_name: :title.md #新文章标题 default_layout: post #默认的模板，包括 post、page、photo、draft（文章、页面、照片、草稿） titlecase: false #标题转换成大写 external_link: true #在新选项卡中打开链接 filename_case: 0 render_drafts: false post_asset_folder: false relative_link: false highlight: #语法高亮  enable: true #是否启用  line_number: true #显示行号  tab_replace: # Category & Tag #分类和标签 default_category: uncategorized #默认分类 category_map: tag_map: # Archives 2: 开启分页 1: 禁用分页 0: 所有禁用 archive: 2 category: 2 tag: 2 # Server #本地服务器 port: 4000 #端口号 server_ip: localhost #IP 地址 logger: false logger_format: dev # Date / Time format #日期时间格式 date_format: YYYY-MM-DD #参考http://momentjs.com/docs/#/displaying/format/ time_format: H:mm:ss # Pagination #分页 per_page: 10 #每页文章数，设置成 0 禁用分页 pagination_dir: page # Disqus #Disqus评论，替换为多说 disqus_shortname: # Extensions #拓展插件 theme: landscape-plus #主题 exclude_generator: plugins: #插件，例如生成 RSS 和站点地图的 - hexo-generator-feed - hexo-generator-sitemap # Deployment #部署，将 lmintlcx 改为用户名 deploy:  type: git  repo: 刚刚github创库地址.git  branch: master

注意

• 配置文件的冒号“:”后面有一个空格
• repo: 刚刚github创库地址.git

hexo命令行使用

经常使用命令：

hexo help #查看帮助 hexo init #初始化一个目录 hexo new "postName" #新建文章 hexo new page "pageName" #新建页面 hexo generate #生成网页，能够在 public 目录查看整个网站的文件 hexo server #本地预览，'Ctrl+C'关闭 hexo deploy #部署.deploy目录 hexo clean #清除缓存，**强烈建议每次执行命令前先清理缓存，每次部署前先删除 .deploy 文件夹**

简写：

hexo n == hexo new hexo g == hexo generate hexo s == hexo server hexo d == hexo deploy

编辑文章

新建文章

hexo new "标题"

在 _posts 目录下会生成文件标题.md

title: Hello World date: 2015-07-30 07:56:29 #发表日期，通常不改动 categories: hexo #文章文类 tags: [hexo,github] #文章标签，多于一项时用这种格式 --- 正文，使用Markdown语法书写

编辑完后保存，hexo server 预览

hexo部署

执行下列指令便可完成部署。

hexo generate hexo deploy

如下提示说明部署成功

[info] Deploy done: git

点击 Github 上项目的 Settings，GitHub Pages，提示Your site is published athttp://wuxiaolong.me (这是我买的域名)

图床

1.墙裂推荐七牛云储存,注册地址。

2.七牛云储存提供10G的免费空间,以及每个月10G的流量.存放我的博客图片最好不过了

3.七牛云储存还有各类图形处理功能、缩略图、视频存放速度也给力（非打广告）。

具体使用见使用七牛做为github博客的图床

域名

将独立域名与GitHub Pages的空间绑定

方法一：在站点source目录下面，新建一个名为CNAME的文本文件，里面写入你要绑定的域名，好比wuxiaolong.me
方法二：在Repository的根目录下面，新建一个名为CNAME的文本文件，里面写入你要绑定的域名，好比wuxiaolong.me

DNS设置

用DNSpod，快，免费，稳定。
注册DNSpod，添加域名，以下图设置。

其中A的两条记录指向的ip地址是github Pages的提供的ip
如何知道你的github上项目的IP，以下：

去Godaddy修改DNS地址

更改godaddy的Nameservers为DNSpod的NameServers。

总结

以前用的jekell写的，手把手教你建github技术博客by jekyll，也是折腾了几天才作成本身满意的，昨天决定换成hexo，也是花了一天半时间，为了追求更好，必须折腾！

秒拍福利视频 开心旅游网

http://www.lvmama.me

http://www.zuiuren.comhttp://www.foodtvl.comhttp://www.0539g.comhttp://www.linyiwuliu.cnhttp://www.jusho.comhttp://www.shanghaidishinigonglue.comhttp://www.linyixiaoshangpincheng.cnhttp://www.linyizhuangshi.cnhttp://www.pipixiaa.comhttp://www.linyiwangluogongsi.cnhttp://www.jusho.cnhttp://www.linyidaikuan.cnhttp://www.linyibanjiagongsi.cnhttp://www.linyiwangzhantuiguang.cnhttp://www.linyitesexiaochi.cn