博客的建立
欢迎来到本博客,这是我建立的第一个博客!
博客的环境搭建
安装Git(Git-2.6.2-64-bit)
安装Node.js(node-v4.2.1-x64)
安装MarkdownPad2
使用hexo管理博客
创建一个文件夹NPVSP,然后在此文件夹上使用右键菜单选项Git Bash Here开始安装和初始化hexo,命令如下:1
2
3$ npm install hexo -g
$ hexo init
$ npm install
如果出现卡住而导致无法正常安装,可以先使用下面的命令指定下载1
$ npm --registry http://registry.cnpmjs.org info underscore
安装成功后可以使用hexo的命令:1
2
3
4
5
6$ hexo n "文章" #创建文章
$ hexo n draft "草稿" #创建草稿
$ hexo g #生成文章
$ hexo c #清除缓存
$ hexo s #启动本地服务
$ hexo d #部署
使用新的hexo主题
将hexo自带的模板更换为Maupassant,它最初是由Cho大神为Typecho平台设计开发的一套响应式模板,后来屠夫9441大神将其移植到hexo平台上。
安装模板1
2
3$ git clone https://github.com/tufu9441/maupassant-hexo.git themes/maupassant
$ npm install hexo-renderer-jade --save
$ npm install hexo-renderer-sass --save
编辑Hexo根目录下的 _config.yml,将theme的值改为maupassant。
并根据屠夫9441说明,制作favicon.ico和apple-touch-icon.png放在根目录的source文件夹下。
修改配置文件
在配置hexo的_config.yml时,其实是有两个的,一个是hexo的基础配置,一个是对主题的配置。在配置的时候,属性和值之间必须有个空格的。
在根目录的基础配置_config.yml文件中设置:1
2
3
4title: 夏葡的笔记本
subtitle: 计算机、数学
author: 夏葡
language: zh-CN
由于在博客中有中文,会出现乱码,把配置文件保存成UTF-8文件格式就可以了。
创建about页面
命令行键入:1
$ hexo new page about
生成about页面,页面不在文章列表显示,可以通过http://localhost/about浏览,页面支持文章的大部分属性,除了分类和标签。
rss订阅
使用命令生成/atom.xml文件:1
$ npm install hexo-generator-feed --save
sitemap站点地图
安装插件:1
2npm install hexo-generator-sitemap --save
npm install hexo-generator-baidu-sitemap --save
hexo编译的时候会自动在根目录生成站点地图。
本地化
在根目录的public文件夹下面创建MyProject文件夹,添加要使用的插件到此文件夹中:
1、FontAwesome图标字体
maupassant导航菜单中集成了FontAwesome4.5图标字体,可以在这里选择新的图标,并按照相关说明使用。
本地化:
下载图标软件包并解压,保存以下目录:
Font-Awesome
– css
– fonts
修改maupassant模板的layout文件夹下面的base.jade文件,将1
link(rel='stylesheet', href="//cdn.bootcss.com/font-awesome/4.5.0/css/font-awesome.min.css")
改为1
link(rel='stylesheet', href="../../../../MyProject/Font-Awesome/css/font-awesome.min.css")
2、MathJax
MathJax允许你在你的网页中包含公式,无论是使用LaTeX、MathML或者AsciiMath符号,这些公式都会被javascript处理为HTML、SVG或者MathML符号。
安装插件 Hexo-math实现MathJax编辑数学公式, 安装方法如下, 依次为1
2$ npm install hexo-math --save
$ hexo math install
具体用法见Hexo MathJax插件。
本地化:
下载MathJax软件包并解压,保存以下目录:
MathJax
– config
– extensions
– fonts
– jax
– localization
– MathJax.js
在配置hexo根目录的_config.yml添加:1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16# MathJax config
## default: src: //cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML
mathjax:
src: ../../../../MyProject/MathJax/MathJax.js?config=TeX-AMS-MML_HTMLorMML
config: {
tex2jax: {
inlineMath: [ ['$','$'], ["\\(","\\)"] ],
skipTags: ['script', 'noscript', 'style', 'textarea', 'pre', 'code'],
processEscapes: true
},
TeX: {
equationNumbers: {
autoNumber: "AMS"
}
}
}
部署到github
注册Github账号
创建Repository
名称格式:在Github注册的用户名.github.com
设置主页
在这个项目下点击Setting,在GitHub Pages下面单机 Launch automatic page generator,然后依照提示完成主页设置。
设置SSH keys
检查是否已经存在了SSH keys:1
ls -al ~/.ssh
如果不存在就没有关系,如果存在的话,直接删除.ssh文件夹里面所有文件,然后输入以下指令(邮箱就是你注册Github时候的邮箱):1
ssh-keygen -t rsa -C "panxiafu@gmail.com"
然后它会提示要输入passphrase(没有输入直接回车,如果输入的话,要记得,到时候会用到)。键入以下指令:1
ssh-agent -s
继续输入指令:1
ssh-add ~/.ssh/id_rsa
如果有出错了的话,就输入以下指令:1
2eval `ssh-agent -s`
ssh-add
到了这一步,就可以添加SSH key到Github账户了。键入以下指令,拷贝Key(先拷贝了,等一下可以直接粘贴):1
clip < ~/.ssh/id_rsa.pub
然后到Github里面,点击右上角的设置图标,在Settings sidebar那里,点击SSH keys。点击New SSH key,输入Title,作为这个key的描述,Key的内容就是刚刚拷贝的,直接粘贴就好(也可以文本打开以下文件:C:\User\...\.ssh\id_rsa.pub复制粘贴)。最后点击Add SSH keys按钮完成添加。
键入以下命令测试是否设置成功:1
ssh -T git@github.com
如果成功,会有successfully authenticated提示,输入yes就可以了。
完成部署
找到配置文件中# Deployment一节,修改:1
2
3type: github
repository: https://github.com/你的账号名/你的账号名.github.io.git
branch: master
最后一步,键入指令进行发布:1
2hexo g
hexo d
如果出现hexo ERROR Deployer not found: github的错误,则将type由github改为git
安装:1
npm install hexo-deployer-git --save