入坑 docsify,一款神奇的文档生成利器!(3)

06、代码高亮


docsify 内置的代码高亮工具是 Prism。Prism 默认支持的语言如下:


Markup - markup, html, xml, svg, mathml, ssml, atom, rss

CSS - css

C-like - clike

JavaScript - javascript, js

Java 需要在 index.html 文件中添加额外的语法文件,如下所示:


<script src="https://cdn.jsdelivr.net/npm/prismjs@1.22.0/components/prism-java.min.js"></script>


保存后,就可以在浏览器上查看到效果。


入坑 docsify,一款神奇的文档生成利器!(3)


07、部署到码云


我们可以把文档网站部署到 GitHub Pages 上,但对于国内用户来说,码云的访问速度显然会更快一些。


如果你是第一次使用 GitHub 的话,我这里已经为你准备好了教程:


文科妹子都会用 GitHub,你这个工科生还等什么

在 GitHub 上新建一个仓库,把你的文档全部放到 docs 目录下,我的已经创建好了,就叫 TechSisterLearnJava。


入坑 docsify,一款神奇的文档生成利器!(3)


接下来,登录码云,选择从 GitHub 导入仓库。


入坑 docsify,一款神奇的文档生成利器!(3)


选择对应仓库后点击导入。


入坑 docsify,一款神奇的文档生成利器!(3)


导入成功后,点击「查看仓库」,就可以看到从 GitHub 导入到码云的仓库。点击「服务」,选择「Gitee Pages」。


入坑 docsify,一款神奇的文档生成利器!(3)


勾选强制启用 HTTPS,然后点击「启动」按钮。不一会儿,码云 Pages 服务就开启了。



点击网站地址:


https://itwanger.gitee.io/javazero

就可以看到 docsify 已经成功部署到码云上了。



08、最后


强烈推荐一下《教妹学 Java》专栏,目前已更新 15 节内容(近 5 万字),后面每周至少会更新 2 节,预计更新 130 节,从 Java 的基础知识到对象和类,再到集合框架、网络编程、并发编程和 Java 虚拟机,基本上全方位覆盖。


专栏中涉及到的图片都花了我很多精力和心思,力争给你一种耳目一新的感觉,随便截几张图给你看看。



入坑 docsify,一款神奇的文档生成利器!(3)





这么好的专栏上哪去找呢?免费给你(反正我也不知道自己是怎么想的)!


GitHub 阅读地址(star 它):


https://github.com/itwanger/javaZero

码云阅读地址(star 它):


https://gitee.com/itwanger/javaZero

docsify 在线阅读地址:


https://itwanger.gitee.io/javazero

我知道,我知道,不用你开口,离线版的 PDF 我也准备好了,看这暗黑风格的 PDF,阅读起来绝壁赏心悦目啊。




百度网盘下载(暗黑和亮白,两种)地址:


https://pan.baidu.com/s/1qwomiFHW6vZdVo26heMctg 密码:1thn


上一篇:java自定义注解实现前后台参数校验


下一篇:《Adobe Illustrator CS6中文版经典教程(彩色版)》—第1课1.17节排列多个文档