跳到主要内容

建站日志 04:让文章读起来更舒服

博客最终还是要用来读文章。首页可以有一些个性,但进入正文后,更重要的是能看清内容、找到章节,也能按自己的习惯调整。

文章目录​

阅读较长文章时,我希望页面侧边有一份目录,列出文章的章节,方便跳转和了解当前读到哪里。项目使用 Docusaurus 提供的文章目录能力。

在实际文章中遇到一个细节:有些本地笔记习惯用 # 写正文的主要章节,而页面本身已经有文章标题。为了让这类正文也能生成合适的目录,构建时会调整正文标题层级;原始 Markdown 文件不会因此被改写。

已经以 ## 开始的正文保留原本的层级。实际阅读效果仍应在不同屏幕尺寸下继续检查。

阅读设置​

小站提供了阅读设置面板,可以调整正文字体、字号、代码字体、代码字号,以及文章页左右栏宽度。代码块支持深色、浅色,或跟随白天与夜晚模式。

设置保存在浏览器本地;如果浏览器不允许保存,本次浏览仍可以使用,但下次打开可能不会保留。面板也提供恢复默认设置。

主题与代码块​

配色从一开始就希望支持纯白与暖色两种选择。后来又增加了白天与夜晚切换,让不同时间阅读时有更多选择。

技术文章中的代码比较多,所以代码块增加了类似窗口的外观,并允许单独选择浅色或深色配色。页面效果和可读性还需要结合真实文章持续调整。

继续验证​

桌面构建通过,不代表手机浏览器、所有字体和交互都已经验证完成。后续还需要在实际设备上检查目录、栏宽和阅读设置,遇到问题再逐项修正。