ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

如何为 leaf 打造专属配色:TOML 自定义主题与 4 套内置主题完全指南

如何为 leaf 打造专属配色:TOML 自定义主题与 4 套内置主题完全指南 如何为 leaf 打造专属配色TOML 自定义主题与 4 套内置主题完全指南【免费下载链接】leafTerminal Markdown previewer — GUI-like experience.项目地址: https://gitcode.com/gh_mirrors/leaf37/leafleaf 是一款终端 Markdown 预览器提供接近 GUI 的阅读体验。本文带你用 3 步上手它的 4 套内置配色arctic、forest、ocean、solarized-dark并通过一个 TOML 主题文件打造属于自己的专属配色方案。1 分钟看懂 leaf 的配色结构leaf 的界面颜色分为两大块[ui]面板类颜色——目录侧边栏、状态栏、滚动条、标题栏徽章等[markdown]文档类颜色——正文、各级标题、链接、表格、代码块、任务列表、脚注等。另外还有一个syntax字段决定代码高亮配色基于 syntect 的主题如base16-ocean.dark。这套结构在 src/theme/mod.rs 中定义4 套内置预设则在 src/theme/presets.rs 中实现。快速切换 4 套内置主题leaf 内置了 4 套完整配色覆盖浅色与深色场景主题风格代码高亮一句话点评arctic浅色base16-ocean.light唯一浅色主题白天不刺眼forest深绿InspiredGitHub森林绿调长时间阅读舒适ocean深色默认base16-ocean.dark默认主题蓝紫点缀solarized-dark深青Solarized (dark)经典 Solarized对比柔和三种切换方式任选其一# 方式 1命令行参数单次生效优先级最高 leaf --theme forest TESTING.md # 方式 2环境变量 LEAF_THEMEarctic leaf notes.md # 方式 3写入配置文件长期生效见下文最直观的方式在 leaf 界面里按ShiftT打开主题选择器用↑/↓实时预览、Enter确认、Esc还原所见即所得。第一步创建你的 TOML 主题文件新建一个my-theme.toml文件名即主题名核心思路是继承一套内置主题只覆盖你改的颜色# my-theme.toml base ocean # 继承 ocean未写的颜色全部沿用 syntax base16-ocean.dark # 代码高亮配色可选 [ui] content_bg #282828 toc_accent #fe8019 [markdown] text #ebdbb2 heading_1 #fabd2fbase可填arctic/forest/ocean/solarized-dark不写则默认继承ocean颜色支持 4 种写法解析逻辑见 src/theme/resolution.rs十六进制#rrggbb或简写#rgbrgb 函数rgb(235, 219, 178)数组[235, 219, 178]颜色名如red、blue懒人捷径仓库里有一个覆盖全部颜色键的完整示例 gruvbox.toml把它复制一份改色号就是现成的起点config.toml 中也有配置说明。第二步理解 [ui] 与 [markdown] 两大色板[ui]调面板氛围影响侧边栏目录、状态栏、滚动条等 34 个颜色键。例如想让目录侧边栏变暖[ui] toc_bg #1d2021 # 侧边栏背景 toc_border #504945 # 侧边栏边框 toc_accent #fe8019 # 当前章节高亮色 status_brand_bg #fabd2f # 底部 leaf 徽章背景[markdown]调文档阅读体验影响正文渲染的 48 个颜色键最常用的几个[markdown] text #ebdbb2 # 正文文字 heading_1 #fabd2f # 一级标题heading_2/3/4 同理 link_text #83a598 # 链接文字 inline_code_fg #fe8019 # 行内代码 inline_code_bg #3c3836 mark_bg #79740e # 高亮文字 的背景 task_checked #b8bb26 # 已完成任务项其中代码块的彩色高亮由顶部的syntax字段统一控制效果如下第三步启用自定义主题并验证在配置文件~/.config/leaf/config.tomlWindows 为%APPDATA%\leaf\config.toml中指向你的主题文件theme my-theme.toml # 相对路径基于配置文件所在目录解析Windows 上建议用单引号避免反斜杠转义theme C:\themes\my-theme.toml。然后运行leaf any.md查看效果。几个排错要点主题名来自文件名my-theme.toml的主题名就是my-theme可配合--theme使用未知颜色写法会报错解析失败时 leaf 会提示invalid theme color: xxx检查拼写即可syntax填错主题名不会崩会回退为默认代码配色并给出Unknown syntax theme提示优先级--theme参数 LEAF_THEME环境变量 配置文件 默认ocean调试时可临时用参数覆盖。想查看或修改配置文件直接运行leaf --config它会自动在编辑器中打开文件不存在时会创建带注释的默认版本。实用小技巧一套配置多个主题主题文件可以放在任意目录按需在config.toml中切换theme值即可深浅两套复制一份 gruvbox 结构把base分别设为ocean和arctic得到暗/亮两个变体实时调试改完 TOML 后配合 watch 模式leaf -w notes.md按r强制重新加载无需手动反复重启。小结需求做法快速换配色--theme参数或界面内ShiftT长期固定主题config.toml中设置theme forest专属配色建 TOML 文件base继承 [ui]/[markdown]覆盖参考完整色键gruvbox.tomlleaf 的主题系统设计得很克制继承 覆盖的模式让你只需写几行 TOML就能在保留内置主题精心搭配的基础上换上自己钟爱的颜色。【免费下载链接】leafTerminal Markdown previewer — GUI-like experience.项目地址: https://gitcode.com/gh_mirrors/leaf37/leaf创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表