Sublime Text Markdown Preview 开源项目教程

29 0 0

Sublime Text Markdown Preview 开源项目教程

sublimetext-markdown-previewmarkdown preview and build plugin for sublime text 2/3项目地址:https://gitcode.com/gh_mirrors/su/sublimetext-markdown-preview

1. 项目目录结构及介绍

本节将概述位于https://github.com/revolunet/sublimetext-markdown-preview.git的Sublime Text Markdown Preview插件的目录结构和主要组件。

MarkdownPreview/ ├── LICENSE.txt # 许可证文件，说明软件使用的版权协议 ├── README.md # 主要的读我文件，包含安装指南和快速使用说明 ├── plugin # 核心插件代码目录 │ ├── __init__.py # 插件初始化文件，加载插件功能 │ └── ... # 其他相关Python脚本用于实现Markdown预览功能 ├── resources # 资源文件夹，可能包含图标、样式等资源 │ └── ... ├── sublime-settings # Sublime Text设置相关的文件夹 │ ├── MarkdownPreview.sublime-settings # 用户可以自定义的配置文件 └── ... # 可能还包含其他文档或辅助文件

此结构典型地反映了Sublime Text插件的布局，其中核心逻辑集中于plugin目录下，而用户配置和相关资源则分别放在指定目录中。

2. 项目的启动文件介绍

在Sublime Text Markdown Preview项目中，并没有一个传统意义上的“启动文件”。然而，其运作机制依赖于Sublime Text的插件系统。当用户通过Sublime Text界面激活插件（例如通过菜单项或快捷键），是通过__init__.py内的函数来触发Markdown预览的生成。虽然直接执行文件的操作不适用，但用户操作（如按下配置好的快捷键）成为间接的“启动”动作。

3. 项目的配置文件介绍

用户配置文件：`MarkdownPreview.sublime-settings`

位置：通常位于用户的Sublime Text“首选项”文件夹内。可以通过Sublime Text菜单 Preferences > Package Settings > Markdown Preview > Settings - User 来访问或编辑。
内容：这个文件允许用户定制Markdown预览的行为，包括但不限于：
- target: 预览的目标，可以是浏览器或者内置视图。
- browser_command: 如果选择在浏览器中预览，这里可以指定浏览器的命令路径。
- style: 控制预览样式表，用户可以选择默认样式或自定义。
- pdf_paper_size: 当导出PDF时，可以设置纸张大小。