linus系统下使用hexo搭建个人博客

最近在搭建自己的个人网站，准备在上面内置一个博客模块，把之前或者以后杂七杂八的总结都放里边。

大致查了一下在WordPress和Hexo间选用了Hexo，体量较小一点。

先贴上Hexo的官方文档：Hexo安装文档

首先在使用Hexo之前需要在服务器上安装

Node.js
Git

安装git

我们需要首先在系统中安装git，hexo主题基本都托管在github上，使用git版本管理工具可以很方便地下载更换主题。此外最后我们也可以将博客托管在github并使用Github Pages服务，实现远程访问。

关于git的安装我们可以直接使用命令：

sudo apt-get install git

安装后使用 git --version 查看是否成功。

接下来需要对我们的git进行配置。

git config --global user.name "Your Name"

git config --global user.email "youremail@domain.com"

关于SSH Keys的添加我们放在后面来说。

安装Node

对于node的安装我们最好使用node的版本管理工具nvm，但是通过官方文档里的连接下载时出现了错误，后来用了git clone的方法安装成功：

git clone http://github.com/creationix/nvm.git .nvm

安装完成后输入

nvm -v

可以在窗口中打印出

Node Version Manager

Note: <version> refers to any version-like string nvm understands. This includes:

  - full or partial version numbers, starting with an optional "v" (0.10, v0.1.2, v1)

  - default (built-in) aliases: node, stable, unstable, iojs, system

  - custom aliases you define with `nvm alias foo`

 Any options that produce colorized output should respect the `--no-colors` option.

Usage:

  nvm --help                                Show this message

  nvm --version                             Print out the latest released version of nvm

  nvm install [-s] <version>                Download and install a <version>, [-s] from source. Uses .nvmrc if available

    --reinstall-packages-from=<version>     When installing, reinstall packages installed in <node|iojs|node version number>

    --lts                                   When installing, only select from LTS (long-term support) versions

    --lts=<LTS name>                        When installing, only select from versions for a specific LTS line

  nvm uninstall <version>                   Uninstall a version

  nvm uninstall --lts                       Uninstall using automatic LTS (long-term support) alias `lts/*`, if available.

  nvm uninstall --lts=<LTS name>            Uninstall using automatic alias for provided LTS line, if available.

  nvm use [--silent] <version>              Modify PATH to use <version>. Uses .nvmrc if available

    --lts                                   Uses automatic LTS (long-term support) alias `lts/*`, if available.

    --lts=<LTS name>                        Uses automatic alias for provided LTS line, if available.

  nvm exec [--silent] <version> [<command>] Run <command> on <version>. Uses .nvmrc if available

    --lts                                   Uses automatic LTS (long-term support) alias `lts/*`, if available.

    --lts=<LTS name>                        Uses automatic alias for provided LTS line, if available.

  nvm run [--silent] <version> [<args>]     Run `node` on <version> with <args> as arguments. Uses .nvmrc if available

    --lts                                   Uses automatic LTS (long-term support) alias `lts/*`, if available.

    --lts=<LTS name>                        Uses automatic alias for provided LTS line, if available.

  nvm current                               Display currently activated version

  nvm ls                                    List installed versions

  nvm ls <version>                          List versions matching a given <version>

  nvm ls-remote                             List remote versions available for install

    --lts                                   When listing, only show LTS (long-term support) versions

  nvm ls-remote <version>                   List remote versions available for install, matching a given <version>

    --lts                                   When listing, only show LTS (long-term support) versions

    --lts=<LTS name>                        When listing, only show versions for a specific LTS line

  nvm version <version>                     Resolve the given description to a single local version

  nvm version-remote <version>              Resolve the given description to a single remote version

    --lts                                   When listing, only select from LTS (long-term support) versions

    --lts=<LTS name>                        When listing, only select from versions for a specific LTS line

  nvm deactivate                            Undo effects of `nvm` on current shell

  nvm alias [<pattern>]                     Show all aliases beginning with <pattern>

  nvm alias <name> <version>                Set an alias named <name> pointing to <version>

  nvm unalias <name>                        Deletes the alias named <name>

  nvm reinstall-packages <version>          Reinstall global `npm` packages contained in <version> to current version

  nvm unload                                Unload `nvm` from shell

  nvm which [<version>]                     Display path to installed node version. Uses .nvmrc if available

  nvm cache dir                             Display path to the cache directory for nvm

  nvm cache clear                           Empty cache directory for nvm

Example:

  nvm install v0.10.32                  Install a specific version number

  nvm use 0.10                          Use the latest available 0.10.x release

  nvm run 0.10.32 app.js                Run app.js using node v0.10.32

  nvm exec 0.10.32 node app.js          Run `node app.js` with the PATH pointing to node v0.10.32

  nvm alias default 0.10.32             Set default node version on a shell

Note:

  to remove, delete, or uninstall nvm - just remove the `$NVM_DIR` folder (usually `~/.nvm`)

表示安装成功

接下来我们就可以使用npm直接安装node：

nvm install stable

nvm会自动下载最新的稳定版node，完成后验证node和附带安装的npm的版本号：

$ node -v

v7.6.0$ npm -v

4.1.

证明已经安装成功。

安装Hexo

但是在接下来使用npm安装hexo时遇到了问题：

npm install -g hexo-cli

试了几次一直提示node npm未获得许可：

sh: : node: Permission denied

> hexo-util@0.6. postinstall /root/.nvm/versions/node/v7.6.0/lib/node_modules/hexo-cli/node_modules/hexo-util

> npm run build:highlight

sh: : npm: Permission denied

/root/.nvm/versions/node/v7.6.0/lib

└── (empty)

npm WARN optional SKIPPING OPTIONAL DEPENDENCY: fsevents@^1.0. (node_modules/hexo-cli/node_modules/chokidar/node_modules/fsevents):

npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for fsevents@1.1.: wanted {"os":"darwin","arch":"any"} (current: {"os":"linux","arch":"x64"})

npm WARN optional SKIPPING OPTIONAL DEPENDENCY: dtrace-provider@0.8. (node_modules/hexo-cli/node_modules/dtrace-provider):

npm WARN optional SKIPPING OPTIONAL DEPENDENCY: dtrace-provider@0.8. install: `node scripts/install.js`

npm WARN optional SKIPPING OPTIONAL DEPENDENCY: spawn ENOENT

npm ERR! Linux 3.13.--generic

npm ERR! argv "/root/.nvm/versions/node/v7.6.0/bin/node" "/root/.nvm/versions/node/v7.6.0/bin/npm" "install" "-g" "hexo-cli"

npm ERR! node v7.6.0

npm ERR! npm v4.1.2

npm ERR! file sh

npm ERR! code ELIFECYCLE

npm ERR! errno ENOENT

npm ERR! syscall spawn

npm ERR! hexo-util@0.6. postinstall: `npm run build:highlight`

npm ERR! spawn ENOENT

npm ERR!

npm ERR! Failed at the hexo-util@0.6. postinstall script 'npm run build:highlight'.

npm ERR! Make sure you have the latest version of node.js and npm installed.

npm ERR! If you do, this is most likely a problem with the hexo-util package,

npm ERR! not with npm itself.

npm ERR! Tell the author that this fails on your system:

npm ERR! npm run build:highlight

npm ERR! You can get information on how to open an issue for this project with:

npm ERR! npm bugs hexo-util

npm ERR! Or if that isn't available, you can get their info via:

npm ERR! npm owner ls hexo-util

npm ERR! There is likely additional logging output above.

npm ERR! Please include the following file with any support request:

npm ERR! /root/software/node/npm-debug.log

在网上查了解决方案说权限问题的提示用 sudo npm install 试试，但是也不行，自己本来也是用root账号操作的，最后在一篇博文里找到了解决方法，博文链接

npm config set user

npm config set unsafe-perm true

查看安装结果：

root@iZ28zkldm3zZ:~/software/node# hexo -v

hexo-cli: 1.0.

os: Linux 3.13.--generic linux x64

http_parser: 2.7.

node: 7.6.

v8: 5.5.372.40

uv: 1.11.

zlib: 1.2.

ares: 1.10.-DEV

modules:

openssl: 1.0.2k

icu: 58.2

unicode: 9.0

cldr: 30.0.

tz: 2016j

接下来可以进行一些初始化操作

安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。

（<folder>替换为需要在里面新建文件的文件夹路径）

hexo init <folder>

cd <folder>

npm install

新建完成后，指定文件夹的目录如下：

新建完成后使用命令启动本地测试

hexo s

因为是阿里云的云服务器，所以在浏览器中输入 http://服务器IP:4000/ 可进入Hello World 页面

预览完成后可按 Ctrl+C 退出，自己有遇到过预览过程中 Putty 意外退出的情况，这时候可以查看占用4000端口的进程，记下 PID 之后杀掉进程就可以。

更换主题

hexo默认的是内置的 landscape 主题，我们可以在官方主题列表中找到想引用的主题样式

我尝试过 Next:https://github.com/iissnan/hexo-theme-next 和 Yilia:https://github.com/litten/hexo-theme-yilia ,最后选择了yilia，github里有预览博客地址，可以先看一下效果。

选择好需要的主题后（接下来都用yilia为例），我们复制好主题的地址

随后转到hexo目录下执行clone命令：

git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

后面的字段是主题的存放地址。等待克隆完成，再打开 hexo/_config.yml 找到如下字段：

# Extensions

## Plugins: https://hexo.io/plugins/

## Themes: https://hexo.io/themes/

theme: yilia

exclude_generator:

将theme修改为我们刚刚下载的主题名称，保存退出，使用 hexo s 命令预览效果。

主题个性化配置

修改为我们需要的主题之后，可以对主题的默认配置进行修改。

cd themes/yilia

转到主题资源文件目录，这个就是我们下载的主题资源包。打开_config.yml，在里面可以对主题进行个性化配置

# Header

menu:

  主页: /

  随笔: /tags/随笔/

# SubNav

subnav:

  github: "#"

  weibo: "#"

  rss: "#"

  zhihu: "#"

  #qq: "#"

  #weixin: "#"

  #jianshu: "#"

  #douban: "#"

  #mail: "mailto:litten225@qq.com"

  #facebook: "#"

  #google: "#"

  #twitter: "#"

  #linkedin: "#"

rss: /atom.xml

# 是否需要修改 root 路径

# 如果您的网站存放在子目录中，例如 http://yoursite.com/blog，

# 请将您的 url 设为 http://yoursite.com/blog 并把 root 设为 /blog/。

root: 

# Content

# 文章太长，截断按钮文字

excerpt_link: more

# 文章卡片右下角常驻链接，不需要请设置为false

show_all_link: '展开全文'

# 数学公式

mathjax: false

# 是否在新窗口打开链接

open_in_new: false

# 打赏

# 请在需要打赏的文章的md文件头部，设置属性reward: true

# 打赏基础设定：-关闭打赏； -文章对应的md文件里有reward:true属性，才有打赏； -所有文章均有打赏

reward_type:

# 打赏wording

reward_wording: '谢谢你请我吃糖果'

# 支付宝二维码图片地址，跟你设置头像的方式一样。比如：/assets/img/alipay.jpg

alipay:

# 微信二维码图片地址

weixin: 

# Miscellaneous

baidu_analytics: ''

google_analytics: ''

favicon: /favicon.png

#你的头像url

avatar:

#是否开启分享

share_jia: true

#是否开启多说评论，填写你在多说申请的项目名称 duoshuo: duoshuo-key

#若使用disqus，请在博客config文件中填写disqus_shortname，并关闭多说评论

duoshuo: false

# 样式定制 - 一般不需要修改，除非有很强的定制欲望…

style:

  # 头像上面的背景颜色

  header: '#4d4d4d'

  # 右滑板块背景

  slider: 'linear-gradient(200deg,#a0cfe4,#e8c37e)'

# slider的设置

slider:

  # 是否默认展开tags板块

  showTags: false

# 智能菜单

# 如不需要，将该对应项置为false

# 比如

#smart_menu:

#  friends: false

smart_menu:

  innerArchive: '所有文章'

  friends: '友链'

  aboutme: '关于我'

friends:

  友情链接1: http://localhost:4000/

  友情链接2: http://localhost:4000/

  友情链接3: http://localhost:4000/

  友情链接4: http://localhost:4000/

  友情链接5: http://localhost:4000/

  友情链接6: http://localhost:4000/

aboutme: 很惭愧<br><br>只做了一点微小的工作<br>谢谢大家

作者对配置项基本都做了注释，也很好理解，我们修改对应的条目就可以。随后保存看看预览效果。

Github Pages托管

Github Pages服务可以给我们提供一个静态网页的托管，以便远程浏览我们的博客内容。

首先我们需要在本机生成一个公钥以便跟github建立安全连接，使用命令：

$ ssh-keygen -t rsa -C "youremail@domain.com"

这里的邮箱就是我们安装git时配置的邮箱，随后复制公钥内容：

vim ~/.ssh/id_rsa.pub

全选后按 P 键复制，登陆github，进入Settings->SSH and GPG keys->New SSH key->粘贴

随后进入系统测试连接是否成功：

ssh -T git@github.com

根据提示输入yes，如果成功建立连接就可以进行接下来的操作了。

接下来我们使用我们需要在github上创建一个仓库repository，注意仓库名称必须为【page名称】.github.io ，后面的.github.io必须保留

新建好我们的仓库之后就可以从本地用git将资源推送到github上。

因为博客是作为我个站的一部分，所以区分了主页和博客主页，不需要可以删除即可。

之后进入阿里云申请一个域名，设置域名解析将映射IP填写为我们创建的Github Pages的IP即可（这个IP我们可以通过 ping 命令获得），之后我们就可以通过我们的域名访问博客啦~

欢迎大家光临我的博客哦^_^

http://blog.jiangzilong.com

巴特西