关于手册
手册地址 https://www.565455.xyz/docs/
由于之前写的项目都太分散了,我把所有的项目都整理到一起了,方便以后查看。
这就是565455手册,里面包含了所有项目的链接,它们的的介绍。
一些技术细节
文档使用了Sphinx来构建,通过一些Markdown或者reStructuredText来编写内容,渲染成html文档,本来想托管在ReadTheDocs
网站上,但是这样可以自己拓展的东西就太少了。
比如侧边栏的平滑动画和引用框样式就是自己做的,具体代码如下
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
/* 移动端 侧边栏动画 */
.wy-grid-for-nav{
overflow-x: hidden;
}
.wy-nav-side{
transition: left 0.5s;
}
@media screen and (max-width: 768px) {
.wy-nav-content-wrap {
margin-left: 0;
left: 0;
position: relative;
}
}
.wy-nav-content-wrap{
transition: left 0.5s;
}
/* 引用内容样式 */
.rst-content blockquote {
position: relative;
color: gray;
}
.rst-content blockquote:before{
content: "";
position: absolute;
width: 10px;
height: 100%;
background-color: gainsboro;
left: -24px;
}
以前我不喜欢在本地部署项目,都直接在平台上修改。后来我发现这样效率太低而且很费时,所以现在都在本地构建,Sphinx是这样,Jekyll也是这样,提供给读者参考。