Markdown+Jekyll+Github Pages

Jekyll帮助页面示例:

• GitHub Official Teaching Materials , 源代码
• beegit帮助文档 , 源代码
• circleci帮助文档 , 源代码

行业实践：

• `开源项目openstack的文档 https://docs.openstack.org/doc-contrib-guide/index.html`_

课程演示任务：

Github Pages 托管静态页面

1. 下载CATTP平台中的个人单页面压缩包
2. 在Github中新建一个repo
3. 将html页面托管在repo中

漂亮的单页面帮助文档

1. https://pages.github.com/#user-site

其他参考教程：Creating and Hosting a Personal Site on GitHub

具体步骤：

1. 在Github上创建新的repo，例如命名为 demo-single-page
2. 通过Github Desktop同步到本地文件夹 demo-single-page
3. 将从CATTP平台上下载的单页面网站，复制到本地文件夹 demo-single-page 中，并push到远程repo

使用Jekyll Now迅速部署自己的博客

1. Fork Jekyll-now主题，并将repo改为 yourusername.github.io
2. 在_config.yml中配置自己的个人信息
3. 修改jekyll的 主题

• 更多帮助信息：https://www.smashingmagazine.com/2016/02/content-modeling-with-jekyll/
• Jekyll Documentation Theme: http://idratherbewriting.com/documentation-theme-jekyll//#

完整版jekyll安装

1. 安装jekyll环境：sudo gem install jekyll bundler
2. 创建新博客：jekyll new my-awesome-site
3. 启动网站。进入网站文件夹后，运行：bundle exec jekyll serve
4. 浏览网站。localhost:4000

更多帮助信息：https://jekyllrb.com

添加内容并发布新网站

1. 使用Markdown语法创建任意内容，按照 YYYY-MM-DD-Title 的格式命名
2. 将上方创建的Markdown文件，保存在 my-awesome-site/_posts中
3. 在Terminal中运行 jekyll build，jekyll将发布网站，并将静态内容存储在 _site 文件夹中