Sublime Markdown Popups 项目启动与配置教程

1. 项目目录结构及介绍

Sublime Markdown Popups 是一个为 Sublime Text 编辑器提供的插件，用于增强 Markdown 文档的预览功能。以下是项目的目录结构及各部分功能的简要介绍：

sublime-markdown-popups/
├── .gitignore             # Git 忽略文件，用于指定哪些文件不应该被版本控制
├── README.md              # 项目说明文件，包含项目的基本信息和使用说明
├── sublime-markdown-popups.py  # 插件的主 Python 脚本文件
├── popup/
│   ├── __init__.py        # 初始化文件，Python 包的标准文件
│   ├── helpers.py         # 辅助函数文件，包含一些工具方法
│   ├── markdown_popups.py # Markdown 预览弹窗的实现文件
│   └── templates/         # 模板文件夹，包含用于生成预览内容的 HTML 模板文件
│       ├── base.html      # 基础模板文件
│       ├── code_block.html # 代码块模板文件
│       └── ...            # 其他模板文件
└── ...                    # 其他可能存在的文件或文件夹

2. 项目的启动文件介绍

项目的启动文件是 sublime-markdown-popups.py。当用户在 Sublime Text 中启用该插件时，该脚本会被执行。它负责注册插件命令、监听事件以及加载其他必要的模块。以下是启动文件的一些基本功能：

• 注册命令：允许用户通过特定的快捷键或菜单项触发插件功能。
• 监听事件：如文档保存、打开等事件，以执行相应的操作。
• 加载模板：从 templates 文件夹加载 HTML 模板，用于展示 Markdown 文档的预览。

3. 项目的配置文件介绍

Sublime Markdown Popups 插件主要使用内置的配置，并没有单独的配置文件。用户可以在 Sublime Text 的设置界面中找到并修改插件的设置。以下是一些可配置的选项：

• markdown_popup_theme：用于选择不同的预览主题。
• enable_math：是否启用数学公式渲染。
• enable_codefences：是否启用代码块高亮。

用户可以通过修改这些设置来调整插件的预览效果和功能。具体设置方法请参考插件官方文档或 Sublime Text 的设置界面。