ivanceras.github.io 上的内容是如何制作的?
ivanceras.github.io 是 Jovansonlee Cesar 的个人主页,站内所有内容——包括页面上的 SVG 图像——都是用 Markdown 制作的,页面本身提供了指向这些源文件的链接。如果你想了解这个站点如何组织内容、或想复用它的结构,直接去看源文件是最快的方式。
内容制作方式
根据页面上的说明,该站点的制作方式可以概括为:
- 统一使用 Markdown:正文和图像(包括 SVG)都通过 Markdown 生成,而不是手写 HTML 或使用图形软件单独导出。
- 源文件公开:页面明确给出源文件链接,说明作者有意让内容结构可被查看和复用。
- 站点即作品展示:主页同时充当简历(Resume)和开源项目清单,内容组织围绕作者本人及其项目展开。
主页上列出的项目
主页把项目分为活跃、参与贡献、小型项目和非活跃几类,便于快速了解作者的技术方向。
活跃开源项目
| 项目 | 说明 |
|---|---|
| Spongedown | 主页列出的活跃项目之一 |
| Svgbob | 将文本图形转换为 SVG;主页还包含其规范文档、设计架构与设计实现说明 |
| Sauron | 活跃项目 |
| Sauron-native | 活跃项目 |
| Rustorm | 活跃项目 |
参与贡献的项目
- sqlparser-rs:解析受支持方言的 SQL
- comrak:解析 Markdown 文件并渲染为 HTML
- term-table-rs:在终端中显示表格
小型项目
- url_path:在不依赖文件系统约束的情况下处理 URL 规范化
- r2d2-sqlite:为 SQLite 提供 r2d2 连接池
- blob-uuid:把 UUID 转换为 URL 友好的 22 字符字符串,适合生成 URL slug
非活跃项目
- Balisong:一次用 Rust 实现体素(voxel)光线追踪的尝试
关于 Svgbob 的规范文档
如果你关心的是 Svgbob 本身,主页上除了项目条目,还列出了 Svgbob specification(规范文档)以及 Design architecture 和 Design implementation(设计架构与设计实现)的入口。也就是说,规范与设计说明都能从该主页进入,而不是只存在于代码仓库里。
想复用这套做法时要注意什么
- 先确认你要复用的是内容组织方式还是具体工具链:主页说明的是“内容用 Markdown 制作”,并未展开构建流程。
- 页面上的 SVG 也由 Markdown 生成,这意味着图形与文本共享同一套源文件,修改时不必分别维护两处。
- 源文件链接是查看真实结构的入口;仅凭渲染后的页面无法看出 Markdown 的组织方式。
如果你的目标是了解作者有哪些项目,直接按上面的分类浏览即可;如果目标是学习“用 Markdown 同时产出文本和 SVG”的做法,从源文件链接和 Svgbob 的规范、设计文档入手更直接。