这里首先假设读者你已经掌握了Markdown与GitHub的基本用法
如果不会, 请先自行百度或Google, 我目前还没写Markdown与GitHub的教程
看云只是一个推荐, 可以认为协助生成格式化Markdowns, 不用当然也可以手写, 这里只是本人推荐而已想先看结果的请直接拉到底
你需要这么几个材料:
在线文章生成网站, 首推“看云”
链接地址:
终端命令行
Windows使用powershell, Mac与Linux自带即可
编辑器(可选)
如: VS Code, Atom, Sublime等等
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\
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文件, 写入如下内容并保存
git操作提交
git add .
git commit -m '添加README.md'
git push origin master
刷新GitHub仓库, 源码出现README.md文件
博客页面正常显示点击有交互
到这里,一个标准的GitHub Pages完成, 但是缺乏美感的程序员或者吃瓜群众是很难再样式上优化出什么花, 尤其是在使用Markdown的时候, 下面就是真正优(zhuang)化(bi)的时候了
优化时候
打开GitHub仓库设置并前往pages所在位置
选择一个你觉得好看的主题并确认
刷新你的博客页, 如有必要, 请清理缓存一下, 再刷新
打完收工
最后有个坑注意一下, 就是你这边对主题修改后, 改动的是GitHub的源代码, 而你之前的主仓库是看云的, 所以这里你需要再项目的
.git/config
文件内修改一下两个仓库的位置, 如下:各种编辑器打开
.git/config
, 我用的是vim替换前
替换后
拉取代码并提交
git pull origin master
git push origin master
然后再替换回来即可
除非你下次再更换主题, 否则基本不用再这一步了
最后大家看看我的GitHub Pages
绑定域名后的
文章相关项目源码:
感谢Star, Fork与Follow