MarkDeck 使用指南

一、项目目录结构及介绍

MarkDeck 是一个以代码形式创建炫酷幻灯片的开源工具，其目录结构清晰地组织了各个功能组件：

• attic: 通常存储已废弃但仍保留的旧文件。
• doc-src: 文档源码所在，包括一些文档相关的资源。
• docker: Docker 相关配置，用于容器化部署 MarkDeck。
• docs: 用户手册和其他非源码文档。
• example: 示例幻灯片目录，帮助用户快速上手。
• src: 主要源代码存放处，包含核心逻辑实现。
• tools: 辅助工具集合，用于支持项目的特定操作或预处理工作。
• .dockerignore, .gitignore: 版本控制忽略文件，定义哪些文件不应被 Git 跟踪。
• Cargo.lock, Cargo.toml: Rust 项目配置文件，记录依赖关系和版本。
• DOCUMENTATION-OLD.md, DOCUMENTATION.md: 项目文档，后者是当前有效的文档。
• LICENSE: 许可证文件，表明软件遵循 MIT 协议。
• Makefile: 构建系统脚本，简化编译和执行流程。
• README.md: 主要的项目介绍和快速入门指南。

二、项目的启动文件介绍

MarkDeck 的运行并不直接基于一个典型的“启动文件”。它通过命令行界面（CLI）来驱动。用户下载相应的二进制文件后，通过运行 markdeck 命令并配合不同的子命令和参数来进行操作。例如，初始化一个新的幻灯片项目可以使用 markdeck init <项目名>，接着通过 markdeck open 启动服务，在本地预览幻灯片。

然而，对于容器化的环境，docker-compose.yaml 文件扮演着关键角色，它配置了如何运行 MarkDeck 在 Docker 中，简化了环境设置和依赖管理。

三、项目的配置文件介绍

MarkDeck 的配置更多依赖于 Markdown 格式的幻灯片文件和潜在的环境变量或命令行参数，而不是一个集中式的配置文件。幻灯片的内容和过渡效果等信息直接嵌入在 .md 文件中。虽然没有明确的单一配置文件，但用户可以通过以下方式定制行为：

• Markdown幻灯片文件 (*.md): 这些文件定义了幻灯片的结构和内容，通过特定语法实现样式和动态效果。
• 命令行参数：在启动 MarkDeck 时，可通过命令行参数调整行为，如指定监听端口、开启不同的渲染器等。
• 环境变量：对于更复杂的配置需求，如外部服务地址，可能会用到环境变量来设置。

总之，MarkDeck 的灵活性体现在它的命令行接口和Markdown文件的直接编辑上，用户无需直接管理传统意义上的配置文件来定制体验。