Skip to content

本站搭建记录

本页面使用Material for MkDocs搭建。

参考资料

Material for MkDocs基础教程。另外，这一页也很重要。

MkDocs官方教程

进阶：咸鱼暄前辈的搭建记录

ZJU CS All In One 不会做总可以抄吧。

常用技巧

搭建中的问题

Windows PowerShell 无法识别 mkdocs 相关命令

解决办法：在每个mkdocs相关命令前面加一个python -m。参见 链接

GitHub Actions

用这个每次就不用手动操作搭建了，保存直接传到GitHub就行了。参考 链接

此时mkdocs.yml中仅有如下内容： 

site_name: ZLDF的个人主页

theme: 
  name: material

nav:
  - 主页: 'index.md'
  - 杂项: 
    - 搭建记录: 'building.md'

如何参考其他网站调整CSS

参考 其他人的博客

更换字体

主要根据这个链接。

一个问题是字体依赖谷歌源，有时会被墙。网上给出的换源方法并不成功，原因是在对应html文件中找不到字体部分。

导航栏

主要根据这个链接

更改icon

主要根据这个链接

添加信息栏

主要根据这个链接

添加方法

三个叹号，空格，关键字如note，空格，双引号内写标题，换行，两个tab，填写内容。

!!! note "添加方法"
    三个叹号，空格，关键字如note，空格，双引号内写标题，换行，两个`tab`，填写内容。
注意编辑时不能使用Typora，它在换行时会连续换行两次。

icon的使用方法

参考 这里

添加脚注

参考 这里

添加代码块（尚未实践）

参考 这里

在VSCode中编辑MarkDown时预览信息栏：

安装了一个名称为「Markdown Extended」的插件。

添加公式

参考 这里