Github上写Blog
预备知识:
必须:Git,GitHub,Jekyll,Markdown,YAML
可选:html,JavaScript,css,XML
工具:
可选:VSCode+Markdown Preview Github Styling,GitHub Desktop
操作:
- 注册一个GitHub的账号,可以使用GitHub Desktop或者GitHub网站;
- 创建一个空的项目
- 在项目里面创建index.md,或者index.html,提交后,博客首页就建好了。
- 注1:index.html的优先级比index.md的高,系统会默认使用index.html显示。(系统需要编译,编译的进度请参考注1)
- 进入项目的Settings,找到Github Pages,修改Source的选项,默认是None(也就是不开启主页显示模式),改为master branch,点save。页面重新刷新,再找到Source就会出现系统提示的显示地址。(编译没有通过的项目是无法正常显示的)
- 如果还想换个漂亮的皮肤,就点theme就可以了。
- 如果不甘心使用这样简单的主页,你就需要fork一个别人的项目barryclark/jekyll-now;
- 修改_config.yml文件
- Settings设置参考前面的说明。
- 按照“_post”目录下的“2014-3-3-Hello-World.md”的模式,依据“YYYY-MM-DD-文件名称.md”的标准创建一个新文件,就是你发表的新文章了。
- 打开主页,就会看到文章的主题出现在主页,点进去就可以看到文章的内容。(系统需要编译,编译的进度请参考注1)
- 如果还想更漂亮的的页面,更完整功能可以fork这个项目minimal-mistakes
- 具体修改可以fork我的项目zhuyuanxiang.github.io,改了中文的地方就是我修改的,并且将需要的一些文件从docs目录下移到了根目录下。
注1:了解编译的进度,可以点Code的commits,进去后会看到自己本次提交的记录,如果后面有个绿色的√就是编译成功了,如果是个红色的×就是编译失败了,失败了主页就无法显示你想要展示的内容。
注2:如果不喜欢远程编译结果出来后才知道有没有问题,可以自己在本机安装Jekyll,具体方法可以参考其他文章。
本文内容仅供个人学习、研究或参考使用,不构成任何形式的决策建议、专业指导或法律依据。未经授权,禁止任何单位或个人以商业售卖、虚假宣传、侵权传播等非学习研究目的使用本文内容。如需分享或转载,请保留原文来源信息,不得篡改、删减内容或侵犯相关权益。感谢您的理解与支持!