独自快乐|如何使用Docsify和GitHub Pages创建文档网站( 二 )

这本质上只是一个普通的 HTML 文件 , 但看看这两行:
... 一些其它内容 ...这些行使用内容交付网络(CDN)的 URL 来提供 CSS 和 JavaScript 脚本 , 以将网站转化为 Docsify 网站 。 只要你包含这些行 , 你就可以把你的普通 GitHub 页面变成 Docsify 页面 。
标签后的第一行指定了要渲染的内容:
Docsify 使用 单页应用 (SPA)的方式来渲染请求的页面 , 而不是刷新一个全新的页面 。
最后 , 看看 在这个块中:

  • el 属性基本上是说:“嘿 , 这就是我要找的 id , 所以找到它并在那里呈现 。 ”
  • 改变 repo 值 , 以确定当用户点击右上角的 GitHub 图标时 , 会被重定向到哪个页面 。
  • 将 loadSideBar 设置为 true 将使 Docsify 查找包含导航链接的 _sidebar.md 文件 。
你可以在 Docsify 文档的 配置 部分找到所有选项 。
接下来 , 看看 _sidebar.md 文件 。 因为你在 index.html 中设置了 loadSidebar 属性值为 true , 所以 Docsify 会查找 _sidebar.md 文件 , 并根据其内容生成导航文件 。 示例存储库中的 _sidebar.md 内容是:
* [HOME](./)* [Tutorials](./tutorials/index)* [Tomcat](./tutorials/tomcat/index)* [Cloud](./tutorials/cloud/index)* [Java](./tutorials/java/index)* [About](./about/index)* [Contact](./contact/index)这会使用 Markdown 的链接格式来创建导航 。 请注意 “Tomcat”、“Cloud” 和 “Java” 等链接是缩进的;这意味着它们被渲染为父链接下的子链接 。
像 README.md 和 images 这样的文件与存储库的结构有关 , 但所有其它 Markdown 文件都与你的 Docsify 网页有关 。
根据你的需求 , 随意修改你下载的文件 。 下一步 , 你将把这些文件添加到你的 GitHub 存储库中 , 启用 GitHub Pages , 并完成项目 。
启用 GitHub 页面创建一个示例的 GitHub 存储库 , 然后使用以下 GitHub 命令检出、提交和推送你的代码:
$ git clone 你的 GitHub 存储库位置$ cd 你的 GitHub 存储库位置$ git add .$ git commit -m "My first Docsify!"$ git push设置你的 GitHub Pages 页面 。 在你的新 GitHub 存储库中 , 点击 “Settings”:
独自快乐|如何使用Docsify和GitHub Pages创建文档网站Settings link in GitHub
向下滚动直到看到 “GitHub Pages”:
独自快乐|如何使用Docsify和GitHub Pages创建文档网站GitHub Pages settings
查找 “Source” 部分:
独自快乐|如何使用Docsify和GitHub Pages创建文档网站GitHub Pages settings
点击 “Source” 下的下拉菜单 。 通常 , 你会将其设置为 “master branch” , 但如果你愿意 , 也可以使用其他分支:
独自快乐|如何使用Docsify和GitHub Pages创建文档网站Setting Source to master branch
就是这样!你现在应该有一个链接到你的 GitHub Pages 的页面了 。 点击该链接将带你到那里 , 然后用 Docsify 渲染: