参考 [references][edit]

    Kodama 程序 [app][edit]

      Kodama 是一款用于构建双链风格笔记的命令行程序. 是笔者为自己打造的博客工具、笔记软件、维基系统. Kodama 程序 所生成网站的默认风格受到软件 Forester 的深刻影响.

      受限于 Markdown 本身表达能力的缺陷, Kodama 无法像 Forester 那样完全控制文档数据的处理模式. 在其他方面提供了更多便捷的特性, 包括但不限于:

      1. 色彩特性 [feature-color][edit]
        • 内置一套精心设计的暗主题, 明暗主题切换默认遵循浏览器主题偏好.
        • 可以安装其他色彩风格的主题, 主题文件仓库位于 Github - themes.
        • 使用 Typst 所生成的公式或图像中的文本或线条颜色, 会自动的跟随颜色主题方案而变化, 无论在何种主题之下都有正确清晰的显示效果.
        • 用户可以同时为网站部署多种主题, 并灵活地在他们之间切换. 即使页面刷新或者浏览器关闭, 之前所选的主题方案也不会受到影响.

        2. 零成本使用 Typst 写作 [feature-typst][edit]

          • 用户可以自由的组合 Markdown 和 Typst 所构建出的 节. 例如, 本节 就来自 Typst 文档. 而节 Kodama 则完全是 Markdown 文档.

          • 针对 Typst 公式渲染的布局优化. 能自动正确对齐与文本不等高的内联公式.

            • 权 级 的模形式具有对称性 , 其中 , 并且 要求在 的所有尖点处全纯.

            • 射影平面

          • Tinymist 等工具的完全可用性. 即使目标为 HTML 文件, 原始 Typst 文档也能正常使用 Tinymist 的预览功能.

          本节 源文件可于 Github - feature-typst.typst 处查看.

          3. 多语言文本优化 [feature-text][edit]

            印欧语系开发者因文化差异, 其设计的工具如 Forester 往往未能考虑汉藏语系用户的需要和使用习惯. 例如块级引用内的汉字默认被显示为斜体, 但汉字本身并不存在 “斜体” 这一概念, 合适的对应物为楷体. 举例如下.

            All of the answers you seek lie hidden in the sun 答えの潜む琥珀の太阳 If I hadn’t met you, 出会わなければ my life would’ve been in the darkness forever 不死なる瞬き持つ魂伤つかないで In my wings are the powers of immortality 仆の羽根 But by meeting you my whole life has changed この持ち知るため生まれてきた You give light to me hope to me strength into my life

            Rise 空には太陽が Force あなたには強さが 似合う Days 涙は夢をみて Stage 未来を描いては 掴む 世界中 風さえ在るのなら どこまでも ぼくらは飛ベると誓い合う 絆が見えた ダイアモンドから 夢を放つ ペルセウス まだ見ぬチカラを その瞳めに秘めて 光の翼が 虹をかけてゆく Field of dreams 輝く あなたを信じてる

            这个礼拜我们聚集了全国数学精英做 2025 annual math review. 讲他们的重要工作。我本人会參加每一埸演讲。但是我很失望：求真書院的学生參加的学生很少，都躲在甚么地方了？做世界一流的研究，就如攀登高峰，需要長期準備工作，準備好工具。当年衛青 霍去病出塞征伐匈奴，入千里無人之地，义無反顧，弱则死于绝域，霍去病年不过二十，八百骑直走匈奴王庭，第一次成功的擊败匈奴，抵定河西走廊，立中国千載之功！何其壮哉！今我求真子弟，不思科研之極至，立不朽之功。躲在家中玩耍游戏，置一流学問於不顾！本人六十年来，日出而作，每天工作至少八个小时，猶恐不及，未達天人之交，有负家国之望！竊为诸君今日所志所为，羞之羞之！

            配置文件 [config][edit]

              配置文件 Kodama.toml 可通过 kodama new config 创建, 或在 kodama new site / kodama init 时自动生成. 下面是版本 1.0.0 release - forest 的完整配置结构.

              [kodama]
trees = "trees"
assets = "assets"
base-url = "/"
themes = []

[toc]
placement = "right"
sticky = true
mobile-sticky = true
max-width = "45ex"

[text]
edit = "[edit]"
toc = "Table of Contents"
references = "References"
backlinks = "Backlinks"

[build]
typst-root = "trees"
short-slug = false
pretty-urls = false
footer-mode = "link"
inline-css = true
asref = false
output = "./publish"
# edit = "https://example.com/repo/edit/main/trees/"

[serve]
edit = "vscode://file/"
output = "./.cache/publish"
command = ["miniserve", "<output>", "--index", "index.html", "--pretty-urls"]

              • [kodama]

                • trees: 文档源目录 (存放 index.md 和其他节文件).
                • assets: 静态资源目录, 每次构建会同步到输出目录下对应子目录.
                • base-url: 部署根 URL, 仅 build 模式生效; serve 模式固定使用 /.
                • themes: 主题文件路径数组 (相对工作区根目录).

              • [toc]

                • placement: 目录位置, left 或 right.
                • sticky: 桌面端目录是否粘性定位.
                • mobile-sticky: 移动端目录是否粘性定位.
                • max-width: 目录区域最大宽度.

              • [text]

                • edit: 页面编辑按钮文本.
                • toc: 目录标题文本.
                • references: 引用区标题文本.
                • backlinks: 反链区标题文本.

              • [build]

                • typst-root: Typst project root (默认 trees).
                • short-slug: 页面内部展示的 slug 是否只保留末段.
                • pretty-urls: 是否启用无 .html 后缀链接.
                • footer-mode: 页脚模式, link 或 embed.
                • inline-css: 是否内联 CSS.
                • asref: 全局默认是否按参考页 (asref) 渲染.
                • output: build 输出目录.
                • edit: 可选, 部署环境下编辑链接前缀.

              • [serve]

                • edit: 本地编辑器 URL 前缀.
                • output: serve 输出目录.
                • command: 本地服务启动命令, <output> 会在运行时替换为输出目录.

              节 [section][edit]

                节 是 Kodama 写作 中的基本概念. 每个 节 都将被处理为一个 HTML 文件. 节 可以来自 Markdown 文档或 Typst 文档. 节 之间的 链接 和 组合 构成了 Kodama 写作 的基本模式.