让技术记录带上可以复制的示例
https://home.without202.com/journal/writing-with-code

记录日期：2026-11-04
分类：建站记录
标签：home · TOML · 写作

日志与项目章节现在可以加入代码块。命令、配置和代码保留格式，也能单独复制。

1. 让说明和示例各有位置

写技术记录时，一段配置和几行命令往往比长篇说明更直观。现在正文继续承担解释，代码块负责保留缩进、空行和末尾换行。每块代码可以单独复制；复制受限时，也能选中文字手动复制。
展示只使用文本，不会执行其中的代码。手机上长行可以横向滚动，打印时则自动换行。

代码示例 · rust
fn main() {
    println!("给想法留一个位置。");
}


2. 继续用 TOML 编写

在日志或项目章节后添加 [[sections.code]]，填写 language 和 content 即可。同一章节可放多块代码，语言标签可以省略。三单引号字符串能保留反斜杠，适合命令和配置。
每章最多十块，每块最多 30 KB，整份内容仍以 50 KB 为限。保存草稿后可以先预览，确认格式再发布。

代码示例 · toml
[[sections]]
title = "一段配置"
body = "先解释这段配置的用途。"

[[sections.code]]
language = "toml"
content = '''
[site]
name = "home"
'''


3. 把日常的小处理也放进来

文本工具也补上了整理能力：逐行去空白、去空行、行去重，以及大小写转换。去重保留首次出现的顺序，区分大小写和空格，输入原文不会被覆盖。
把这些基础能力做好，之后整理项目说明和技术记录就更顺手了。

- 打开文本统计与整理：https://home.without202.com/tools/text

4. 给同一章节多个相关入口

同一段说明涉及几个工具时，可以在对应 [[sections]] 下添加多个 [[sections.links]]，每项填写 label 和 url。原有 link_label / link_url 可以继续使用，合计每章最多六个链接；新链接名称需为 1–100 个字符，不能包含换行或控制字符。地址需使用 HTTPS 或本站路径，不能重复。
下面是完整的日志示例。可先复制到 TOML 工具检查语法，再在管理台新建日志并载入；按实际内容修改标识、日期、标题与正文，先保存草稿和预览。TOML 语法正确不代表已满足内容字段与链接规则，管理台仍会检查；载入与预览不自动保存或公开。
示例中的原链接和两个新链接合计三项。工具页的「使用说明与记录」也会识别额外链接；同一章节多次指向同一工具时只显示一个章节入口，按公开内容更新。

代码示例 · toml
slug = "chapter-links-example"
title = "一个章节，多个相关入口"
date = "2026-11-05"
category = "使用指南"
summary = "先读说明，再直接打开相关工具。"
tags = ["TOML", "链接"]
projects = ["home"]

[[sections]]
title = "选择接下来的操作"
body = "这是一个完整日志示例；请按实际内容修改后再保存草稿。"
link_label = "浏览全部工具"
link_url = "/tools"

[[sections.links]]
label = "Base64 转换"
url = "/tools/base64"

[[sections.links]]
label = "UUID 生成与检查"
url = "/tools/uuid"

- 打开 TOML 配置工具：https://home.without202.com/tools/toml
- 查看真实的多入口章节：https://home.without202.com/journal/everyday-tools-reference#section-6
- 返回上手指南：https://home.without202.com/journal/start-with-your-everyday

5. 用完整 TOML 预览个人首页

个人资料支持用一份 TOML 调整公开名称、主页标题、首页分区、精选项目、精选服务、精选工具、介绍、兴趣和公开链接。修改前，先在管理台个人资料页下载当前已保存的 TOML 留一份副本，优先从自己的导出继续编辑；不要直接用示例覆盖已有资料。
下面是字段齐全的语法示例，不是站点所有者的真实资料。请替换公开名称与介绍，并替换或删除 example.org 的示例链接；空的 bio、interests、home_projects、home_tools 等列表或字段也会影响原有设置。home_sections 的四项必须各出现一次，示例将工具放在前面；留空数组或省略时，使用常用入口、项目、工具、最近记录的默认顺序。
home_title 留空使用默认标题，若设置则需恰好两行，每行最多 30 个字符。home_projects 留空展示完整公开项目目录；home_tools 留空使用目录前四项，两者均可分别选择最多四个不重复标识。管理台可展开公开名称与标识清单，确认可用项；不要把工具标识填进 home_sections，四个分区标识与具体项目、工具标识是不同配置。
公开链接按 [[links]] 的顺序填写 label 与 HTTPS 地址 url，最多十二项；首页展示前三项，更多链接进入关于页完整列表。预览中的「更多链接」会跳到当前预览的完整列表。没有公开链接时，可删除整个 [[links]] 段，并在所有表数组之前填写 links = []；不要同时保留空数组和 [[links]]。
可先在 TOML 工具检查语法，再登录个人资料编辑页载入当前编辑文本并点击「预览资料」。预览会显示首屏、分区顺序、精选项目、精选服务、精选工具和关于页，不保存或公开；请核对每项设置，再明确保存并公开。资料历史可先预览、载入编辑器再修改；未包含新配置的旧资料会恢复对应默认行为，保存旧资料前尤其需要核对首页标题、分区与精选。
home_services 选择并排列最多四个首页服务标识，留空数组或省略时展示完整服务目录。暂未公开、撤回或不可用的条目隐藏且不补位，全部不可用时提供服务目录入口；完整目录、公开数量和本机收藏独立。管理台的标识清单包含带标识的公开服务，预览会显示精选服务且不操作收藏；导出与历史保留选择，旧资料未包含此项时恢复全部服务。

代码示例 · toml
# 仅为配置示例：请从自己的资料导出副本继续修改，先预览，再决定是否保存。
display_name = "你的公开昵称"
tagline = "填写你的一句话介绍"
intro = "这里填写愿意公开的主页介绍。"
home_title = []
home_sections = ["tools", "projects", "services", "journal"]
home_projects = []
home_services = []
home_tools = []
bio = ""
interests = []

[[links]]
label = "示例站点（请替换或删除）"
url = "https://example.org/"

- 进入个人资料编辑器（需登录）：https://home.without202.com/manage/profile
- 检查示例 TOML 语法：https://home.without202.com/tools/toml
- 查看首页配置规则：https://home.without202.com/journal/home-entry-points-reference#section-0