本站

macos 安装 sphinx

# 这里没有用 brew 安装,如果配置了 conda 还使用 brew 安装之后可能会出现问题
# 这里直接在虚拟环境用 pip 进行安装
pip install sphinx

配置实时更新

# 首先安装 sphinx-autobuild
pip install sphinx-autobuild

# 配置实时更新,需要在文档根目录中执行命令
make clean; make html ;sphinx-autobuild source build/html

使用浏览器开发者工具生成密码

  1. 打开 Safari 或 Chrome 浏览器

  2. 按 Command+Option+C (Chrome) 或 Command+Option+I (Safari) 打开开发者工具

  3. 切换到 Console (控制台) 标签页

  4. 直接输入以下命令:

    // 生成密码
    btoa("password")
    // 反向解码
    atob("cGFzc3dvcmQ=")
    

md 文档常用语法

  • 换行:在行尾添加两个空格然后回车

  • 标题:使用 # 号表示标题级别,# 代表一级标题,## 代表二级标题,依此类推

  • 粗体:使用 ** 包裹文本,例如 粗体文本

  • 斜体:使用 * 包裹文本,例如 斜体文本

  • 列表:

    • 无序列表:使用 - 或 * 开头,例如:

      • 项目一

      • 项目二

    • 有序列表:使用数字加点开头,例如:

      1. 第一项

      2. 第二项

  • 链接:使用 [链接文本](链接地址) 例如 百度

  • 图片:使用 ![替代文本](图片地址) 例如 示例图片

  • 代码块:使用三个反引号 ``` 包裹代码块,例如:

    def hello_world():
        print("Hello, World!")
    
  • 行内代码:

    使用单个反引号 ` 包裹代码,例如`print("Hello")`
    
  • 引用:使用 > 开头,例如:

    这是一个引用文本

联系作者

参考

其他