你的位置:首页 > 网页设计

[网页设计]基于Hexo和Github搭建博客


搭建自己的个人博客。

准备工作

确保电脑需要已下载安装node和npm。查看安装是否成功,windows只需在命令行输入以下两条命令即可。

1
2
$ node -v
$ npm -v

 

安装hexo

安装hexo

1
$ npm install -g hexo

检测hexo版本来确保hexo是否成功安装

1
$ hexo v

查看hexo版本

注:可能报错,可以试试执行

1
npm install hexo --no-optional

进入本地工程目录,初始化hexo

1
2
$ cd blog
$ hexo init

npm安装package.json中的依赖包

1
$ npm install

生成博客文件

1
$ hexo g

启动本地博客

1
$ hexo s

启动本地博客
此时在浏览器输入http://localhost:4000即可访问默认主题的hexo博客
博客主页

查看hexo帮助

1
$ hexo help

修改全局配置文件

对本地blog目录下的_congig.yml进行修改配置即可。

网站

参数描述
title网站标题
subtitle网站副标题
description网站描述
author您的名字
language网站使用的语言
timezone网站时区。Hexo 默认使用您电脑的时区。时区列表。比如说:America/New_York,Japan, 和 UTC 。

网址

参数描述默认值
url网址 
root网站根目录 
permalink文章的 永久链接 格式:year/:month/:day/:title/
permalink_default永久链接中各部分的默认值

目录

参数描述默认值
source_dir资源文件夹,这个文件夹用来存放内容。source
public_dir公共文件夹,这个文件夹用于存放生成的站点文件。public
tag_dir标签文件夹tags
archive_dir归档文件夹archives
category_dir分类文件夹categories
code_dirInclude code 文件夹`downloads/code
i18n_dir国际化(i18n)文件夹:lang
skip_render跳过指定文件的渲染,您可使用 glob 表达式来匹配路径。

文章

参数描述默认值
new_post_name新文章的文件名称:title.md
default_layout预设布局post
auto_spacing在中文和英文之间加入空格false
titlecase把标题转换为 title casefalse
external_link在新标签中打开链接true
filename_case把文件名称转换为 (1) 小写或 (2) 大写0
render_drafts显示草稿false
post_asset_folder启动 Asset 文件夹false
relative_link把链接改为与根目录的相对位址false
future显示未来的文章true
highlight代码块的设置

分类 & 标签

参数描述默认值
default_category默认分类uncategorized
category_map分类别名 
tag_map标签别名

日期 / 时间格式

Hexo 使用 Moment.js 来解析和显示时间。

参数描述默认值
date_format日期格式MMM D YYYY
time_format时间格式H:mm:ss

分页

参数描述默认值
per_page每页显示的文章量 (0 = 关闭分页功能)10
pagination_dir分页目录page

扩展

参数描述
theme当前主题名称。值为false时禁用主题
deploy部署部分的设置

配置github

新建仓库

  1. 登录github,点击右上角加号,点击new respository

新建仓库

  1. 在跳转界面填写信息

填写信息

生成测试页面

进入新建的仓库,点击右上角的settings,在跳转页面点击 launch automatic page generator,在跳转页面点击continue to layouts,接着选择主题,生成页面,约15min后,访问https://syd1992.github.io,即可显示生成测试页面

launch automatic page generator

创建ssh keys

  1. 检测ssh keys是否已存在,即id_rsa,id_resa.pub是否存在
1
$ ls -al ~/.ssh

  1. 生成ssh keys(若ssh keys不存在)
1
$ ssh-keygen -t rsa -C "847909475@qq.com"

输入命令后,会提示输入ssh keys保存位置,一般无需改,直接回车即可;接着提示输入密码,并确认再次输入密码,这个密码后面会有使用,一定要记住!

  1. 查看生成的ssh keys中的公钥
1
$ cat ~/.ssh/id_rsa.pub

给github仓库添加ssh keys

  1. 点击创建的仓库右上侧的settings,在跳转页面左下侧点击deploy keys

  1. 在跳转页面点击add deploy keys,title随意填,在key部分将创建ssh keys步骤中的id_rsa.pub内容粘贴在该部分

测试连接

执行命令,输入命令后,问yes/no,输入yes即可,提示输入密码,则输入生成ssh keys时设置的密码

1
$ ssh -T git@github.com

最后提示如下内容,表示成功

1
Hi, 用户名/用户名.github.io! You've successfully authenticated, but GitHub does notprovide shell access.

配置根目录下的_config.yml文件并发布

  1. 安装hexo-deployer-git
1
$ npm install hexo-deployer-git --save
  1. 修改_config.yml的deploy内容,如下图

  1. 生成博客文件,每次修改本地文件后,都要执行该命令
1
$ hexo g
  1. 发布
1
$ hexo d

此时,访问https://syd192.github.io.git即可看到自己的辛勤劳动成果咯!!

切换主题

默认主题是landscape,如果不太喜欢,可以访问这里获取更多的主题。本人选择主题是TKL,具体切换方法如下:

  1. 下载TKL主题
1
$ git clone https://github.com/SuperKieran/TKL.git theme/TKL
  1. 配置根目录下的_config.yml文件

然后,hexo g,再hexo d,即可正常访问。

注:图片url填写,图片文件夹img应放在source文件目录下,url直接写为/img/图片.png即可。

写一篇博客

  1. 新建博客
1
$ hexo new "newBlog"
  1. 在根目录下source文件夹下找到对应的newBlog.md文件,按照markdown规则,编写博客。

    在该newBlog.md文件的头部,可以对该博客进行配置,如博客标题title,博客创建时间date,所属分类categories,标签tags

然后,hexo g,再hexo d,即可正常访问。

最后来张成果图,继续加油咯~~~~

参考链接

    1. 史上最详细的Hexo博客搭建图文教程
    2. 使用hexo搭建github.io博客(一)
    3. 基于 Hexo 和 GitHub Pages 搭建博客