首页手记 Markdown打造高逼格博客

Markdown打造高逼格博客

标签：

Html/CSS Html5 前端工具

这里首先假设读者你已经掌握了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\
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

zweizhao.github.io

> 绑定域名后的

www.zweizhao.com