独自快乐|如何使用Docsify和GitHub Pages创建文档网站( 二 )
这本质上只是一个普通的 HTML 文件 , 但看看这两行:
... 一些其它内容 ...
这些行使用内容交付网络(CDN)的 URL 来提供 CSS 和 JavaScript 脚本 , 以将网站转化为 Docsify 网站 。 只要你包含这些行 , 你就可以把你的普通 GitHub 页面变成 Docsify 页面 。
标签后的第一行指定了要渲染的内容:
Docsify 使用 单页应用 (SPA)的方式来渲染请求的页面 , 而不是刷新一个全新的页面 。
最后 , 看看 在这个块中:
- el 属性基本上是说:“嘿 , 这就是我要找的 id , 所以找到它并在那里呈现 。 ”
- 改变 repo 值 , 以确定当用户点击右上角的 GitHub 图标时 , 会被重定向到哪个页面 。
- 将 loadSideBar 设置为 true 将使 Docsify 查找包含导航链接的 _sidebar.md 文件 。
接下来 , 看看 _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”:Settings link in GitHub
向下滚动直到看到 “GitHub Pages”:
GitHub Pages settings
查找 “Source” 部分:
GitHub Pages settings
点击 “Source” 下的下拉菜单 。 通常 , 你会将其设置为 “master branch” , 但如果你愿意 , 也可以使用其他分支:
Setting Source to master branch
就是这样!你现在应该有一个链接到你的 GitHub Pages 的页面了 。 点击该链接将带你到那里 , 然后用 Docsify 渲染:
- 搜狐新闻|准大学生数码三件套如何选?这些元气好物值得种草
- 想好好做医生的胖子|五十岁女性经常有周身无力和疼痛的困扰!该如何应对?医生告诉您
- 儿童饮食|秋冬季如何让宝宝爱上吃水果?稍微蒸一下美味翻倍,营养价值更高
- 队员|北极科考中“遭遇”北极熊,看科考队员如何与它们和谐相处
- 中国历史发展过程|中国历史发展过程!中国游戏外挂发展史:“辅助工具”是如何成长为“苍
- 金色年华录|都是男扮女装谈恋爱,《少女大人》比《女世子》如何?
- 上海市嘉定区人民政府网站|每年消耗3350吨蔬菜150吨肉,嘉定这家中央厨房如何践行“光盘行动”?
- 上海嘉定|如何让《民法典》走进群众心里?嘉定这些街镇和单位这样做
- 没蜡笔的小新|“整容脸”应该被鄙视吗?医生告诉你千篇一律的好看皮囊如何而来
- 上海黄浦|“午夜快乐汇”亮相人民大舞台“星空间1号”!