这里首先假设读者你已经掌握了Markdown与GitHub的基本用法
如果不会, 请先自行百度或Google, 我目前还没写Markdown与GitHub的教程
看云只是一个推荐, 可以认为协助生成格式化Markdowns, 不用当然也可以手写, 这里只是本人推荐而已
想先看结果的请直接拉到底
你需要这么几个材料:
-
在线文章生成网站, 首推“看云”
链接地址: 看云
-
终端命令行
Windows使用powershell, Mac与Linux自带即可
-
编辑器(可选)
如: VS Code, Atom, Sublime等等
-
GitHub账号
链接地址: GitHub
详细步骤(图文)
-
看云篇(书写)
- 创建文档()
- 文档信息填写
- 前往编辑文档
- 新建章节
- 新建章节的基本信息
- 编辑或修改章节
- Markdown编辑与内容提交
- 新建子级章节
- 新建子级章节的基本信息
- 新建真正的子级章节的注意点
- 子级章节在看云看起来一样, 但是注意新建方式不同导致的不同
- 完成并同步
- 创建文档()
-
看云篇(获取git地址)
- 返回文章概要(或手动前往)
- 前往文章设置
- 获取git地址
- 返回文章概要(或手动前往)
-
拉取看云文章源代码
如果你真没git, Windows请搜一下
git bash
, Mac命令行输入git然后点击安装即可,- 使用powershell或其他命令行工具(Mac与Linux一样)
cd .\Desktop\
git clone https://git.kancloud.cn/zweizhao/kancloudtest.git
(地址请使用你自己的)cd .\kancloudtest\
- 使用powershell或其他命令行工具(Mac与Linux一样)
-
GitHub创建你的博客仓库
- 创建仓库
- 仓库信息
- 仓库地址
- 创建仓库
- 源代码添加GitHub的仓库
git remote set-url --add origin https://github.com/ZweiZhao/blogs.git
(地址请使用你自己的)或手动添加
- 将代码推到GitHub
git push origin master
-
GitHub内容更新及查看
- 注意上文说的子级区别
- 这里缺少README.md文件, 后续会补上
- 注意上文说的子级区别
-
设置GitHub Pages(就是博客)
- 前往GitHub仓库的设置
-
设置pages
向下滚动
选好点击save保存
保存成功后滚回来
就是这个地址, 你的博客生成好了
-
打开会报错, 404
原因就是刚刚说的没有README.md文件
-
添加README.md文件
- 回到源代码, 并使用你的编辑工具在根目录创建一个README.md文件, 写入如下内容并保存
- 回到源代码, 并使用你的编辑工具在根目录创建一个README.md文件, 写入如下内容并保存
-
git操作提交
git add .
git commit -m '添加README.md'
git push origin master
刷新GitHub仓库, 源码出现README.md文件
- 博客页面正常显示点击有交互
- 前往GitHub仓库的设置
> 到这里,一个标准的GitHub Pages完成, 但是缺乏美感的程序员或者吃瓜群众是很难再样式上优化出什么花, 尤其是在使用Markdown的时候, 下面就是真正优(zhuang)化(bi)的时候了
-
优化时候
- 打开GitHub仓库设置并前往pages所在位置
- 选择一个你觉得好看的主题并确认
- 刷新你的博客页, 如有必要, 请清理缓存一下, 再刷新
- 打开GitHub仓库设置并前往pages所在位置
-
打完收工
最后有个坑注意一下, 就是你这边对主题修改后, 改动的是GitHub的源代码, 而你之前的主仓库是看云的, 所以这里你需要再项目的
.git/config
文件内修改一下两个仓库的位置, 如下:- 各种编辑器打开
.git/config
, 我用的是vim - 替换前
- 替换后
- 拉取代码并提交
git pull origin master
git push origin master
-
然后再替换回来即可
除非你下次再更换主题, 否则基本不用再这一步了
- 各种编辑器打开
-
最后大家看看我的GitHub Pages
绑定域名后的
文章相关项目源码:
GitHub
http://www.zweizhao.com/blogs/
感谢Star, Fork与Follow
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。