个人博客制作

个人博客制作

一、写在前面

    很久之前自己就做了个人博客了，但是种种原因，没有把自己的制作过程整理记录下来，时间长了重装系统，这些步骤都比较生疏了，导致再想重新捡起有点困难，不过还是尽量回忆整理一下，以便之后参考。

二、准备工作

2.1 安装git

    首先下载安装git，然后配置相关信息，和自己的github连接到一起。这是因为我们的个人博客为了节省成本，其实是嵌套到github上面运行的，言外之意，github才是我们的服务器，博客的模式是B/S模式访问。

git config --global user.name "name"
git config --global user.email "email"

    创建ssh连接：

ssh-keygen -t rsa -C "email"

    设置生成公钥私钥之后，将公钥复制出来，放到github的秘钥库内，完成连接。

ssh -T [email protected] #测试是否能正常连接

2.2 安装nodejs

    其次，安装nodejs，安装完成之后用于下载相关插件。

2.3 安装hexo

    然后使用npm安装hexo。注意此时使用npm安装插件可能出现问题，比如“rollbackFailedOptional: verb npm-session”，这样的原因是国外的源不稳定或者其他原因，此时可以换用淘宝的源。

1、更改npm源
npm config set registry https://registry.npm.taobao.org
#恢复：npm config set registry http://registry.npmjs.org 
– 配置后可通过下面方式来验证是否成功
npm config get registry或npm info express
2、使用cnpm
先删除原有的所有代理
npm config rm proxy
npm config rm https-proxy
然后安装淘宝的cnpm
npm install -g cnpm --registry=https://registry.npm.taobao.org

      然后安装hexo：

npm install -g hexo-cli

  测试是否安装成功：

hexo -v

 

三、创建博客

    首先明确hexo常用的命令，这是具体文档：

1、hexo init
    hexo init 命令用于初始化本地文件夹为网站的根目录
    $ hexo init [folder]
    folder 可选参数，用以指定初始化目录的路径，若无指定则默认为当前目录
2、hexo new
    hexo new 命令用于新建文章，一般可以简写为 hexo n
    $ hexo new [layout] <title>
    layout 可选参数，用以指定文章类型，若无指定则默认由配置文件中的default_layout 选项决定
    title 必填参数，用以指定文章标题，如果参数值中含有空格，则需要使用双引号包围
3、hexo generate
    hexo generate 命令用于生成静态文件，一般可以简写为 hexo g
    $ hexo generate
    -d 选项，指定生成后部署，与 hexo d -g 等价
4、hexo server
    hexo server 命令用于启动本地服务器，一般可以简写为 hexo s
    $ hexo server
    -p 选项，指定服务器端口，默认为 4000
    -i 选项，指定服务器 IP 地址，默认为 0.0.0.0
    -s 选项，静态模式 ，仅提供 public 文件夹中的文件并禁用文件监视
    说明：运行服务器前需要安装 hexo-server 插件
    $ npm install hexo-server --save
5、hexo deploy
    hexo deploy 命令用于部署网站，一般可以简写为 hexo d
    -g 选项，指定生成后部署，与 hexo g -d 等价
6、hexo clean
    hexo clean 命令用于清理缓存文件，是一个比较常用的命令
    网站显示异常时可尝试此操作
7、Option
  （1）hexo --safe
      hexo --safe 表示安全模式，用于禁用加载插件和脚本
  （2）hexo --debug
      hexo --debug 表示调试模式，用于将消息详细记录到终端和 debug.log 文件
  （3）hexo --silent
      hexo --silent 表示静默模式，用于静默输出到终端

    其次，在磁盘中新建文件夹用来存放博客文件，然后使用命令初始化：

hexo init 博客名（最好英文）

    此时会在该文件夹下创建这样名称的博客，并且生成一些附属文件。

 

     创建完之后需要进入该文件夹，使用npm install初始化博客。

cd  博客名
npm install

     然后运行如下命令运行本地系统：

hexo g
hexo server

 

 

     至此在本地搭建网站成功，但是真正的网站需要在远程进行访问，因此，需要借助github进行部署。

四、部署到github

    这里需要借助github中一项便利的功能github page。在GitHub.com中New repository，新建仓库，创建和自身用户名相同的仓库，后面加.github.io，这种格式会被github识别，定位到具体的网址，即xxxx.github.io，xxx为GitHub用户名。

      接下来就可以将自己本地的网站部署到github上了，只需要修改网站中的_config.yml文件，将deploy属性绑定到github上面。

 

      设置完之后安装deploy-git，进行部署。

npm install hexo-deployer-git --save

 

      最后将网站上传部署到github。

hexo clean       #清除了之前生成的东西，也可以不加。
hexo generate  #生成静态文章，可以用 hexo g缩写
hexo deploy     #部署文章，可以用hexo d缩写

    这样就可以访问了，但是如果更换了电脑，那么重新配置也很简单。只需要使用git clone命令，将github page中的网站文件下载过来。

    然后进入克隆文件夹设置环境即可。

cd xxx.github.io
npm install
npm install hexo-deployer-git --save

    但是这样有一个很重要的问题，那就是在上传的过程中，使用hexo d命令，git仅仅上传的是根据源文件生成的网页文件，对于之前设置的一些md文件等都没有上传，我们下载下来也不能进行修改，并且不能编辑新的内容，因此这里有两种解决办法，第一种是所有的源文件打包，在新电脑上解压部署环境执行，但是比较麻烦，并且导致文件可能不同步，第二种是将源文件上传到github中保存，这里也有两种方式，（1）创建一个仓库进行存储，（2）在github page仓库中新建分支hexo，专门用来存储源文件，显然第二种方式更方便快捷，因此，我们需要在创建github page中作如下操作，首先新建一个分支hexo，此时有两个分支：master和hexo，然后将hexo设为主分支，在git中切换到hexo分支提交所有文件，并且在hexo分支下使用hexo d完成部署，因为hexo d会查找部署的分支，这里分支设置为master即可。

git check  hexo
git add .
git commit -m "..."
git push origin hexo

    然后在hexo分支下提交：

hexo clean
hexo g -d

    以后每次编辑文件上传都需要执行上面的操作，这样即可完美解决问题，此后更换电脑，只需要git clone下来，部署相应的环境，然后切换到hexo分支下编辑，执行上面的命令上传即可。

git clone [email protected]:xxx.github.io.git
npm install hexo
npm install
npm install hexo-deployer-git --save

五、总结

     上面只是简单地笔记，中间可能有一些问题，需要多查资料总结。