5

使用HEXO与Github.io搭建个人博客

 2 years ago
source link: https://sunct.github.io/posts/4081f3d5.html
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.

使用HEXO与Github.io搭建个人博客

HEXO是基于Node.JS的一款简单快速的博客框架，能够支持多线程，支持markdown，可以将生成的静态网页发布到github.io以及coding上。

一、安装Node.js

关于Node.js的安装，在此就不再多费笔墨，没有安装的可以从官网和网上查找。下面只列举mac上安装。

Mac OS 上安装

你可以通过以下两种方式在 Mac OS 上来安装 node：

  • 1、在官方下载网站下载 pkg 安装包，直接点击安装即可。
  • 2、使用 brew 命令来安装：
brew install node

二、安装hexo

运行以下命令

npm install -g hexo-cli
npm install hexo-deployer-git –save

安装完之后检测一下：

hexo version

我的运行结果如下，可能和你的有些偏差：

hexo: 4.2.0
hexo-cli: 3.1.0
os: Darwin 18.7.0 darwin x64
http_parser: 2.8.0
node: 10.15.3
v8: 6.8.275.32-node.51
uv: 1.23.2
zlib: 1.2.11
ares: 1.15.0
modules: 64
nghttp2: 1.34.0
napi: 3
openssl: 1.1.0j
icu: 62.1
unicode: 11.0
cldr: 33.1
tz: 2018e

hexo本地文件在安装插件的时候，最好都是用root身份执行，不然经常遇到一些问题

初始化本地路径

在本地创建一个文件夹hexo（名字自己定义），并初始化

cd /hexo && hexo init

生成node_modules

npm install

生成本地博客

hexo g
hexo server

项目目录如下：

终端显示如下：

INFO  Start processing
INFO  Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.

在浏览器下输入http://localhost:4000，成功的话就生成hexo的标准界面。

四、更换主题

只需在项目 themes 文件下，加入自己想要的主题即可。

现在我从网上找了一个，地址：https://github.com/litten/hexo-theme-yilia，可根据博主的说明进行设置。

主题的里配置在 /themes/yilia/_config.yml里设置。

在根目录下找到 _config.yml 文件，大约在96行，更换主题即可。

theme: yilia   ##主题，主要修改这个地方

更改完主题，再重新构建一下，运行以下命令即可：

hexo g
hexo server

五、部署到github

首先，在github中建立一个仓库（没有账户的先创建一个吧！ O(∩_∩)O哈哈~），仓库名字为 XXX.github.io,其中 XXX 是自定义的名字，后缀必须是.github.io。

创建完仓库，点击 Setting

然后进行一些设置。往下滚动，在GitHub Pages条目下，会显示可访问的地址。

根据以上配置完，只有把public文件下的代码就可以传到 刚才创建的 github仓库就可以了。

cd /public

git init
git add .
git commit -m “填写注释信息”
git remote add origin [email protected]:sunct/sunct.github.io.git #写自己的仓库地址
git push -u origin master

如果出现这个错误：

To github.com:sunct/sunct.github.io.git
 ! [rejected]        master -> master (non-fast-forward)
error: failed to push some refs to '[email protected]:sunct/sunct.github.io.git'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. Integrate the remote changes (e.g.
hint: 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

是本地和github上有历史冲突，运行：

git pull origin master --allow-unrelated-histories

六、写博客

在 /source/_posts/目录下写自己的博客就可以了。
写完后再构建即可，可现在本地预览一下 http://localhost:4000。把构建完的public文件夹上传到github就可以了。

也可以使用命令把 pubic 文件夹下的文件 同步到 远端gh-pages分支，以便维护使用。

git subtree push --prefix public origin  gh-pages



report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK