文章目录
介绍
随着自己编写的笔记越来越多,同时,为了更好的梳理自己的思路,总结自己的经验,在最近,开始定下三个平台来记录自己的博客,分别是CSDN,github pages, 和个人博客, 印象笔记等。
这里将使用的是github pages 的配置,和一些技巧介绍。
优缺点
优点
- 使用是静态文件,访文速度较快
- 免费方便,不要钱,不要服务器,就能拥有个站,这上哪找
- 灵活:可以绑定自己域名
- 数据安全:利用github的仓库管理,保证数据的安全性
缺点
- 国内网访问github会比较卡
- 静态网站的缺点,不能统计数据,添加自己的功能
准备
环境搭建
node: Node.js下载
git
hexo
创建Github Pages
在github中创建你的账户名对应 ****.github.io 的repository
注意点:
- 必须与你自己的用户名对应
- 每个github账户最多只能创建一个可以直接使用域名访问的仓库
- 邮箱要验证
- 需要等待一段时间 (10~30分钟)
配置SSH Key
生成本地ssh
使用gitbash(安装git后会附带), 执行如下命令:
cd ~/.ssh
ssh-keygen -t rsa -C "邮件地址"
cat id_rsa.pub
配置github的SSH key
将命令行输出(id_ras.pub的内容)复制到 github主页-》个人设置-》SSH and GPG keys -> New SSH key
测试是否成功
ssh -T git@github.com
设置git账号和密码
git config --global user.name “test”
git config --global user.email “test@test.com”
ssh在win下保存位置
window下:C:\Users\Administrator.ssh\
Hexo
Hexo是一个简单、快速、强大的基于 Github Pages 的博客发布工具,支持Markdown格式,有众多优秀插件和主题。
官网:http://hexo.io
github: https://github.com/hexojs/hexo
作用
省掉对博客文章和界面的管理,通过几行代码,便可以将本地的写好的文件上传github上,生成相关的页面
注意
- 尽量使用git bash 来进行操作,在cmd下有些命令会不好使
- ‘:’后面要留有空格
操作
安装
npm install -g hexo
初始化
cd /f/workspaces/hexo/
hexo init
或
hexo init blog
安装必要的组件
npm install
生成 generate
hexo g
## 或者 hexo generate
启动 server
hexo s
## 或者 hexo server
默认启动4000端口, 打开浏览器访问: http://localhost:4000
设置端口
hexo s -p 5000
修改主题
主题都保存在 根目录/themes
下
git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia
修改根目录下_config.yml
将theme: landscape
改为 theme: yilia
, 重新执行 hexo g
来生成
清理环境
hexo clean
上传github
上传之前,安装:
npm install hexo-deployer-git --save
修改根目录下/_config.yml文件
deploy:
type: git
repository: git@github.com:ashe1994/ashe1994.github.io.git
branch: master
执行下面命令开始上传
hexo d
保留文件
需要保留的文件保存至source下
常用命令
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本
命令缩写
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy
组合命令
实际上使用的命令
hexo s -g #生成并本地预览
hexo d -g #生成并上传
_config.yml参数配置
写博客
自动生成md文件,包含时间
hexo new 'my-first-blog'
可以作为索引,比如在menu
下的about: /about
, 注意你new page生成的about是个html界面,而后面路径则是你md文章保存的位置
hexo new page 'about'
格式介绍
---
title: postName #文章页面上的显示名称,一般是中文
date: 2013-12-02 15:30:16 #文章生成时间,一般不改,当然也可以任意修改
categories: 默认分类 #分类
tags: [tag1,tag2,tag3] #文章标签,可空,多标签请用格式,注意:后面有个空格
description: 附加一段文章摘要,字数最好在140字以内,会出现在meta的description里面
---
以下是正文,使用markdown记法
# 名称
balabala
<!--more--> 文章折叠
balabala
语言设定
修改_config.yml
的language
为 zh-Hans
language: zh-Hans
修改菜单项
修改配置文件./theme/_config.yml
的 menu
注意:每个子项后面的值都是查找文件的地方, 如home的’/'即为当前主目录
menu:
home: /
archives: /archives
categories: /categories
tags: /tags
about: /about
search: /search
commonweal: /404.html
something: /something
在yilia主题下添加所有文章索引
安装
npm i hexo-generator-json-content --save
设置主题
jsonContent:
meta: false
pages: false
posts:
title: true
date: true
path: true
text: false
raw: false
content: false
slug: false
updated: false
comments: false
link: false
permalink: false
excerpt: false
categories: false
tags: true