Skip to content

一些教程和报错

1.在Mkcos中显示公式

cnblogs教程 :向mkdocs.yml中添加： 

markdown_extensions:
  - pymdownx.arithmatex

extra_javascript:
  - https://cdn.jsdelivr.net/npm/mathjax@2/MathJax.js?config=TeX-AMS-MML_HTMLorMML

2.在Mkdocs中显示删除线

在Mkdocs中使用~~哈哈哈~~格式没有效果： ~~哈哈哈~~

但是可以使用<del>哈哈哈</del>可以显示删除线：哈哈哈

3.在Mkdocs中显示图片

![image](https://images.unsplash.com/photo-1554310603-d39d43033735?q=80&w=2670&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D)
image

本地图源：

不要在assets前加/ 

![](assets/nn456.png)

Tip 使用本地图源时的文件路径是以\docs文件夹为源头的，所以文件需要放到这个文件夹下面才能找到。文件目录如下： 

-physics  
--docs  
---assets  
----nn456.png  
--mkdocs.yml

Unsplash图源：

image

知乎图源：

bilibili图源： (无法显示)

![]https://i0.hdslb.com/bfs/new_dyn/3f19aa1b7649f33711acb3af89a93d311036847356.png@560w_560h_1e_1c.avif

Warning

为什么在typora中可以显示？？？

解决方案：

使用图床（目前使用chrome上的bilibili图床插件），将图片下载到本地再上传到图床就有图片的url可用。

但是bilibili的图片很大部分使用的是.webp或.avif格式，还需要多一步将这些格式转换为.jpg或.png文件

4.报错“found character '\t' that cannot start any token”

原因是在.yaml文件中不能使用tab键进行缩进。

5.latex公式无法显示

原因可能是在mkdocs中，<>中的反括号前需要加\，且每一个都要加。

6.如何显示Tips、Note、Warning等块

参考链接：https://squidfunk.github.io/mkdocs-material/reference/admonitions/?h=tip#admonition-icons

这个官方叫做"Admonitions"

具体的规则是：!!!+space+Tip或Note或Warning。内容文字需要在下一行与Tip等缩进相同的位置开始书写。

例如： 

!!! Tip

    这是一个Tip。

Tip

这是一个Tip。

需要在mkdocs.yml中添加以下代码： 

markdown_extensions:
  - admonition
  - pymdownx.details
  - pymdownx.superfences

在上方贴出的链接中包含了更多的options，甚至可以自定义新的图标和颜色

7.Latex图片并列显示

\begin{figure}[htbp]
\begin{minipage}[t]{0.5\linewidth}
\centering
\includegraphics[width=0.95\textwidth]{haldane-no-t2.jpg}
\caption{没有t2项的能带}
\end{minipage}%
\begin{minipage}[t]{0.5\linewidth}
\centering
\includegraphics[width=0.95\textwidth]{haldane-with-t2.jpg}
\caption{有t2项的能带}
\end{minipage}

8.自定义mkdocs的material主题：

https://juejin.cn/post/7066641709198737416
官方参考文档：https://squidfunk.github.io/mkdocs-material/reference/annotations/

9.解决Latex图片移动到下一页的问题

参考：Latex控制图片位置

使用float包并在图片语句后使用H选项

\usepackage{float} 
% ... 
\begin{figure}[H] 
foo 
\end{figure}

10.Latex分页符

使用\clearpage而不是\newpage

11.md中\\换行符失效

解决方法：一对不行再来一对，使用\\\\成功进行换行。

12.emoji在mkdocs上的使用

不知道为什么index中的emoji不能显示了。在mkdocs.yml文件中添加以下代码

markdown_extensions:
  - attr_list
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg

homebrew的安装

在安装homebrew的过程中，使用命令行安装失败，遂使用pkg安装包安装。成功之后在cmd也无法调用，需要向path中添加brew的路径。 

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

13.博客中的摘要停止符号不起作用

问题： 在博客的主页中显示全文，没有仅显示摘要，导致找其他文章很费劲，但是我明明在文章中使用了停止符号<!--more-->。

解决方案：

  • 在mkdocs.yml文件中声明你要用的停止符号（如<!-- more -->）。 
    plugins:
  - blog:
      post_excerpt_separator: <!-- more -->
  • 在博客中的摘要之后，正文之前使用上一步中定义的停止符号<!-- more -->

14.在终端里无法链接到github.com

ping github.com
# failed to connect(react time out)

sudo vim /private/etc/hosts

# 按a输入，`:wq`保存

在DNS查询工具中输入github.com，查到ip为140.82.113.4，则在hosts文件中添加行：140.82.113.4 github.com,输入:wq保存。

再次ping github.com 正常访问

15.美化mac终端为Fallout样式

参考教程：https://blog.csdn.net/weixin_42326144/article/details/121957795

a.下载zsh

sh -c "$(curl -fsSL https://gitee.com/mirrors/oh-my-zsh/raw/master/tools/isntall.sh)"

b.修改主题

vim ~/.zshrc
在打开的文件中修改ZSH_THEME的值即可，对应预览在ZSH_THEME_WIKI，Google即可得到结果。(P.S.本条是在终端修改部署的。)