Phase 0-2: Schema cleanup, typed relations, event-driven automation
- Phase 0: AGENTS.md cleanup (dedup quotes, renumber sections, merge qmd) - Phase 1: typed relations (manage-relations.py, graph-search.py, check-staleness.py, detect-conflicts.py) - Phase 2: frontmatter validator, weekly lint, knowledge promotion, git hooks - Fix .gitignore to track tools/ and .githooks/ - Fix git remote URL (remove plaintext token) - New wiki pages: 504 pages, 34 raw sources
This commit is contained in:
hehaiguang1123
@@ -0,0 +1,313 @@
|
||||
---
|
||||
categories:
|
||||
- "[[LLM Wiki]]"
|
||||
tags:
|
||||
- wiki
|
||||
- reference
|
||||
- marp
|
||||
created: 2026-04-10
|
||||
source: "[[Marp 优化-快速上手指南]]"
|
||||
type: reference
|
||||
---
|
||||
|
||||
# Marp 优化 - 使用指南
|
||||
|
||||
> 你的 Marp 工作流已优化完成！5 分钟快速上手。
|
||||
|
||||
## 🎉 优化内容概览
|
||||
|
||||
### 新增资源
|
||||
|
||||
1. **Marp 模板库** (`wiki/Marp 模板库.md`)
|
||||
- 完整的模板使用指南
|
||||
- 文件组织结构说明
|
||||
- 主题选择建议
|
||||
|
||||
2. **三个实用模板** (`Presentations/Templates/`)
|
||||
- 学术答辩模板.md
|
||||
- 技术分享模板.md
|
||||
- 商务汇报模板.md
|
||||
|
||||
3. **两个自定义主题** (`Templates/MarpTheme/`)
|
||||
- university-blue.css（学术蓝）
|
||||
- minimal-dark.css（极简深色）
|
||||
|
||||
4. **批量导出脚本** (`export-slides.bat`)
|
||||
- 一键导出 PDF/PPTX/HTML
|
||||
- 自动统计文件数量
|
||||
|
||||
---
|
||||
|
||||
## ⚡ 5 分钟快速开始
|
||||
|
||||
### 步骤 1：创建新演示（1 分钟）
|
||||
|
||||
从模板库复制模板：
|
||||
|
||||
```
|
||||
1. 打开 Presentations/Templates/
|
||||
2. 选择合适的模板（学术/技术/商务）
|
||||
3. 复制模板内容
|
||||
4. 粘贴到 Presentations/Active/新文件.md
|
||||
```
|
||||
|
||||
### 步骤 2：编辑内容（2 分钟）
|
||||
|
||||
在 Obsidian 中编辑：
|
||||
|
||||
```
|
||||
1. 打开 Presentations/Active/新文件.md
|
||||
2. 替换 {占位符} 为实际内容
|
||||
3. 按 Ctrl+P 打开命令面板
|
||||
4. 输入 "Marp: Open Preview"
|
||||
```
|
||||
|
||||
### 步骤 3：预览效果（1 分钟）
|
||||
|
||||
拆分预览窗口：
|
||||
|
||||
```
|
||||
1. 预览窗口在右侧打开
|
||||
2. 左侧编辑，右侧实时预览
|
||||
3. 使用 `---` 分页
|
||||
```
|
||||
|
||||
### 步骤 4：导出（1 分钟）
|
||||
|
||||
批量导出演示：
|
||||
|
||||
```
|
||||
方法 1：Obsidian 插件导出
|
||||
- 点击预览窗口的导出按钮
|
||||
- 选择 PDF/PPTX/HTML
|
||||
- 保存到 Downloads
|
||||
|
||||
方法 2：批量导出脚本（推荐）
|
||||
1. 双击 export-slides.bat
|
||||
2. 自动导出所有演示
|
||||
3. 导出结果在 Presentations/Export/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎨 主题快速切换
|
||||
|
||||
### 学术场景
|
||||
|
||||
```markdown
|
||||
---
|
||||
marp: "true"
|
||||
theme: university-blue
|
||||
footer: XX大学 · 计算机科学学院
|
||||
---
|
||||
```
|
||||
|
||||
### 技术场景
|
||||
|
||||
```markdown
|
||||
---
|
||||
marp: "true"
|
||||
theme: minimal-dark
|
||||
---
|
||||
```
|
||||
|
||||
### 两栏布局示例
|
||||
|
||||
```markdown
|
||||
<!-- _class: cols-2 -->
|
||||
|
||||
<div class="ldiv">
|
||||
|
||||
### 左栏内容
|
||||
|
||||
- 要点 1
|
||||
- 要点 2
|
||||
|
||||
</div>
|
||||
|
||||
<div class="rdiv">
|
||||
|
||||
### 右栏内容
|
||||
|
||||
```javascript
|
||||
const example = "code here"
|
||||
```
|
||||
|
||||
</div>
|
||||
```
|
||||
|
||||
### 特殊页面类型
|
||||
|
||||
| 指令 | 用途 | 示例 |
|
||||
|------|------|------|
|
||||
| `<!-- _class: cover -->` | 封面页 | 论文答辩首页 |
|
||||
| `<!-- _class: trans -->` | 过渡页 | 章节分隔 |
|
||||
| `<!-- _class: dark -->` | 深色页 | 强调内容 |
|
||||
| `<!-- _class: cols-2 -->` | 两栏布局 | 左右对比 |
|
||||
| `<!-- _class: lead -->` | 居中大标题 | 核心要点 |
|
||||
| `<!-- _class: ending -->` | 结束页 | 致谢 |
|
||||
|
||||
---
|
||||
|
||||
## 📁 目录结构说明
|
||||
|
||||
```
|
||||
kepano-obsidian-main/
|
||||
├── wiki/
|
||||
│ ├── Marp 模板库.md # 模板使用指南
|
||||
│ ├── Marp.md # Marp 概念页
|
||||
│ ├── 示例-学校定制Marp演示.md # 完整示例
|
||||
│ └── ...
|
||||
├── Presentations/
|
||||
│ ├── Templates/ # 演示模板（3个）
|
||||
│ ├── Themes/ # 自定义主题（2个）
|
||||
│ ├── Active/ # 当前进行中的演示
|
||||
│ └── Export/ # 导出结果（自动生成）
|
||||
│ ├── PDF/ # PDF 文件
|
||||
│ ├── PPTX/ # PPTX 文件
|
||||
│ └── HTML/ # HTML 文件
|
||||
├── Templates/
|
||||
│ └── MarpTheme/ # 主题文件
|
||||
│ ├── university-blue.css # 学术蓝主题
|
||||
│ └── minimal-dark.css # 极简深色主题
|
||||
└── export-slides.bat # 批量导出脚本
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 高级技巧
|
||||
|
||||
### 1. 快速替换内容
|
||||
|
||||
使用 Obsidian 的搜索替换：
|
||||
|
||||
```
|
||||
1. Ctrl+H 打开查找替换
|
||||
2. 查找：{占位符}
|
||||
3. 替换为：实际内容
|
||||
4. 全部替换
|
||||
```
|
||||
|
||||
### 2. 实时查看主题效果
|
||||
|
||||
在同一个文件中快速测试不同主题：
|
||||
|
||||
```markdown
|
||||
# 测试 university-blue
|
||||
---
|
||||
theme: university-blue
|
||||
|
||||
# 测试 minimal-dark
|
||||
---
|
||||
theme: minimal-dark
|
||||
```
|
||||
|
||||
### 3. 使用 Obsidian 内置功能
|
||||
|
||||
- **Wikilink 图片**：`![[image.png]]`
|
||||
- **代码块语法高亮**：\`\`\`javascript
|
||||
- **表格**：直接用 Markdown 表格语法
|
||||
- **引用**：`> 引用内容` 或 `> [!note] 内容`
|
||||
|
||||
### 4. 导出配置自定义
|
||||
|
||||
编辑 `export-slides.bat` 可以自定义：
|
||||
|
||||
```batch
|
||||
REM 修改导出目录
|
||||
set "EXPORT_DIR=%~dp0Export"
|
||||
|
||||
REM 修改主题目录
|
||||
set "THEME_DIR=%~dp0Themes"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ❓ 常见问题
|
||||
|
||||
### Q: 添加新主题后主题列表没有显示？
|
||||
|
||||
A: 需要**重启 Obsidian**。这是插件的限制。
|
||||
|
||||
### Q: 如何调整主题颜色？
|
||||
|
||||
A: 编辑 CSS 文件中的颜色变量：
|
||||
|
||||
```css
|
||||
:root {
|
||||
--color-primary: #003366; /* 修改这里 */
|
||||
--color-secondary: #1a6fb5; /* 修改这里 */
|
||||
--color-accent: #c8102e; /* 修改这里 */
|
||||
}
|
||||
```
|
||||
|
||||
### Q: PPTX 导出后在 PowerPoint 中无法编辑？
|
||||
|
||||
A: 这是正常的。Marp 的 PPTX 导出是将每页转换为图片后嵌入 PPTX，满足格式要求即可。
|
||||
|
||||
### Q: 如何导出特定页面？
|
||||
|
||||
A: 使用 Marp CLI 的 `--page-number` 参数：
|
||||
|
||||
```bash
|
||||
marp presentation.md --pdf -o output.pdf --page-number 1,3,5
|
||||
```
|
||||
|
||||
### Q: 演示文件太大怎么办？
|
||||
|
||||
A: 使用图片优化：
|
||||
|
||||
```markdown
|
||||
<!-- 使用 wikilink 引用图片（更高效） -->
|
||||
![[image.png]]
|
||||
|
||||
<!-- 而不是 Base64 嵌入（文件更大） -->
|
||||
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 下一步优化
|
||||
|
||||
### 可选增强
|
||||
|
||||
1. **添加更多主题**
|
||||
- 从 GitHub 下载社区主题：[marp-themes](https://github.com/marp-team/awesome-marp)
|
||||
- 放入 `Templates/MarpTheme/` 目录
|
||||
- 重启 Obsidian
|
||||
|
||||
2. **创建自定义模板**
|
||||
- 基于现有模板修改
|
||||
- 保存为新模板
|
||||
- 更新 `Marp 模板库.md`
|
||||
|
||||
3. **集成到 CI/CD**
|
||||
- 在 GitHub Actions 中自动导出
|
||||
- 每次提交生成 PDF/PPTX
|
||||
|
||||
4. **使用 Git 管理演示**
|
||||
- 版本控制所有演示文件
|
||||
- 方便团队协作
|
||||
- 追溯历史版本
|
||||
|
||||
---
|
||||
|
||||
## 📚 相关文档
|
||||
|
||||
---
|
||||
## 相关页面
|
||||
|
||||
详见 [[Marp 优化-快速上手指南]]
|
||||
|
||||
- [[Marp 模板库]] — 完整模板库
|
||||
- [[Marp]] — Marp 概念总览
|
||||
- [[Marp 指令语法]] — 指令参考
|
||||
- [[Marp 主题与样式]] — 主题和 CSS
|
||||
- [[Obsidian Marp 插件]] — 插件使用指南
|
||||
- [[示例-学校定制Marp演示]] — 完整示例
|
||||
|
||||
---
|
||||
|
||||
**开始创建你的第一个演示吧！** 🎉
|
||||
|
||||
从 `Presentations/Templates/` 复制模板，5 分钟内完成你的演示。
|
||||
Reference in New Issue
Block a user