docsify快速入门
docsify
根据官方说法,docsify是一个神奇的文档网站生成工具,也可以把它当做一个简易版的静态站点诸如Hexo、Hugo等。当然,它是专门针对文档的,忽然想到了程序员深恶痛绝的就是写API文档……
docsify特性很多,最吸引我的是全文搜索、主题简洁好看、无需构建的纯静态站点。这意味着可以很简单地把写完的文档直接扔到Pages服务上,比如GitHub Pages、Coding Pages等等。
根据官方说法,docsify是一个神奇的文档网站生成工具,也可以把它当做一个简易版的静态站点诸如Hexo、Hugo等。当然,它是专门针对文档的,忽然想到了程序员深恶痛绝的就是写API文档……
docsify特性很多,最吸引我的是全文搜索、主题简洁好看、无需构建的纯静态站点。这意味着可以很简单地把写完的文档直接扔到Pages服务上,比如GitHub Pages、Coding Pages等等。
有些网站需要加载谷歌字体,由于网络问题或者某些问题,fonts.googleapis.com
访问太慢会导致站点加载很慢。虽然最后能看到网站,但实际上谷歌字体依然加载失败了,这个体验就非常差劲了。
|
|
在盒子模型中border也占据了宽高,对于下面的样式:
|
|
本文基于PostgreSQL 12.6
版本,不同版本的函数可能存在差异。
||
是字符串连接操作符,在拼接字符串时要求前两个操作数至少有一个是字符串类型,不然会报错。如下:
|
|
可能是rdpclip.exe
进程出了问题,在任务管理器中找到该进程,选中后并结束进程。接着重启该进程:
win + R
组合键打开运行窗口rdpclip.exe
,按下回车或确定按钮。此时可以在任务管理器重新看到该进程,一般情况下就可以正常的在远程桌面复制粘贴了。
通常格式化日期时,都是使用的YYYY/MM/dd
来格式化日期,但是在遇到跨年日期时,就会遇到很神奇的现象,如下:
|
|
本文主要记录从Hexo迁移至Hugo所遇到的一些坑,以及Hugo的LoveIt主题的一些bug之类的应对方案。下面是涉及到的Hexo、Hugo以及LoveIt各自的版本:
|
|
本博客使用的是Hugo的LoveIt主题,本文也是基于该主题而写的,不过Hugo的美化步骤应该大同小异,版本如下:
|
|
请注意,本文的所有功能都离不开两个新增加的文件:_custom.scss
和custom.js
,部分功能还需要jquery
,在第一章中会提及如何引入。
另外本文篇幅太长,阅读体验不好,将其进行分章如下:
Hugo本身可以通过修改站点配置文件来完成页面的部分定制,如按钮、多语言等功能。本文基于LoveIt
主题【v0.2.10】,且所使用的Hugo版本如下,不同版本且不同主题可能无法适用某些属性:
|
|