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 的规范、设计文档入手更直接。

ivanceras.github.io