title: 自定义Mkdocs显示字体(霞鹜文楷) tags:

Mkdocs ---

我目前在用的字体：霞鹜文楷{target=_blank}
想必你可以直观从我的网站感受到，这款字体的美观程度。

以下是摘录的部分字体官方介绍文档

注意事项

添字请在 Issue #33 反馈，字形调整请在 Issue #14 反馈，不要另开议题，以便于整理。

若需要在网站上使用这款字体，请参阅 Issue #24。

有关 Magisk 字体模块等手机字体替换有关的问题，请移步模块模板的 Issues 里反馈，不要在本项目开议题。

更多版本 （可能会随时变动） ：

霞鹜文楷屏幕阅读版 / LXGW WenKai Screen：适用于 PC 和 Android 手机屏幕显示且无需特别切换到粗体。

霞鹜文楷轻便版 / LXGW WenKai Lite：与完整版相比剔除一些较不常用的字符，便于开发者将字体嵌入软件中。

霞鹜文楷 GB / LXGW WenKai GB：进一步调整字形和笔形，符合 G 源字形规范。包含《通用规范汉字表》8105 个汉字。

霞鹜文楷 TC / LXGW WenKai TC：旧字形版参考「一点字坊」的「传承字形标准化文件」对部件进行修改，适用于繁体中文用户及旧字形爱好者。

LXGW Bright：与 Ysabeau 系列字体搭配的中英文合并字体。

LXGW WenKai / 霞鹜文楷

An open-source Chinese font derived from Fontworks' Klee One. 一款开源中文字体，基于 FONTWORKS 出品字体 Klee One 衍生。

项目简介

2020 年 12 月，日本著名字体厂商 FONTWORKS 在 GitHub 上发布了 7 款日文字体，分别为 Train、Klee、Stick、Rock-n-Roll、Reggae、Rampart 和 DotGothic16，根据 SIL Open Font License 1.1 授权许可开源。7 款开源日文字体各有各的特点，而这 7 款字体中，字符数量最多的是 Klee。

这是一款有着日本教科书体风格的字体，兼有仿宋和楷体的特点，可读性高。一些 DIY 字体爱好者曾先后用仿宋等字体补全这款字体，作为手机系统的美化字体移植在 iOS、Android 等手机系统中，受到很多玩机发烧友的欢迎。不过这样补全的字体有一些不足之处。第一，原有字体和后补字体之间有着一定的差异，致使一些不同的文字（如 Klee 原有汉字与后补简体字）混排之后会有一定的违和感。第二，由于补字所用的字体为商业版权字体，补全之后不可用于商业用途，还会有侵权的风险。此外，目前现有的开源中文字库里，楷体类寥寥无几，仿宋类则几乎没有。

鉴于此，也为了丰富开源中文字体中的楷体门类，2021 年 1 月 20 日起，本人开始了为 Klee One 这一高质量的日文开源字体补全简繁常用字的尝试。因该字体具有一定的「文艺气息」，命名 「霞鹜文楷」*（其实当初是感觉这款字体适合正文阅读定名「文楷」，后来发现这款字体可能并不太适合大段正文排版，相比之下更加适合诗词之类的中等长度文本排版，或者注释排版）*。由于 Klee One 字体的 Regular 字重太细不太适合阅读，选取原字体 SemiBold 字重作为 Regular 字重。经过长时间的积累，目前已发展成简繁日韩均支持的 3 字重字体家族 ~~（虽然拙劣粗糙了点）~~ 。

有关补字过程的更多信息，请参阅本人 GitHub.io 博客里的文章：《为 Klee 试制简化字》。

字体预览

历史版本的 Release，请在 Release 页面查看。文字版本的更新记录 HISTORY.MD 不再维护，敬请谅解。

补字计划

主要汉字部分

请参阅「霞鹜文楷轻便版」加字计划。

其他部分

补完 CJK 统一汉字基本区 20992 个汉字（简繁） （目前完整版有 6857 个字形由 zi2zi 深度学习生成，字形较粗糙。） ；
补全常用谚文（韩语/朝鲜语）音节 2367 个。 （做得比较拙劣。Lite 版不包含。）

点击此处查看后续加字及调整计划。

获取字体

ⅰ. 直接下载

进入 Release 界面下载对应版本的 TTF 格式文件，或在本仓库 fonts/TTF 文件夹中下载。
在 Gitee 官方镜像仓库 fonts/TTF 文件夹中下载。
进入猫啃网、Zfont.cn、自由字体进行下载。GitHub 项目更新后，会联系站长进行更新，更新会稍晚些。 注意： 其它收录免费商用字体的网站上可能也收录了本字体，但可能不是最新版。
永硕Ｅ盘、蓝奏云（密码：8ppk）会在 GitHub 项目更新后 72 小时之内更新。
如果您使用 macOS，已经安装过 Homebrew，可以在终端输入命令：brew tap homebrew/cask-fonts && brew install font-lxgw-wenkai 来安装本字体。
如果您使用 Windows，已经安装过 Scoop，可以在终端输入命令：scoop bucket add nerd-fonts && scoop install LXGWWenKai 或者 scoop bucket add nerd-fonts && scoop install LXGWWenKaiMono 来安装本字体。亦可查看微软官方教程：如何在 Windows 中安装或删除字体。

ⅱ. 从源代码生成

请运行 ./sources/build.bat 或 ./sources/build.sh。需要安装 fontmake：pip3 install fontmake 和 fontTools：pip3 install fonttools。

注意事项

截至目前，完整版本字体含有全部 CJK 基本区汉字，以及零星扩展 A~G 区汉字。 如有补字需求，请在 Issue #33 提出，不要另开 Issue，以便于整理。
本人并不是专业的设计师，并未考虑设计美感，所以看起来可能略丑，补进去的字与原版可能略有违和感，且在 Bold 字重中部分字的轮廓曲线会有毛刺，Light 字重中部分字的轮廓会存在飞点；此外由于时间仓促，并没有多余的时间细修，部分字的部件拼接会很生硬。如有字形优化建议，请在 Issue #14 提出，不要另开 Issue，以便于整理。 （以上两个 issue 均已加上 long term 标签，且均已在 Issues 页面置顶。）
若需要在网站上使用这款字体，请参阅 Issue #24。
对于搭配的西文字体，个人推荐 Ysabeau 系列字体。另有 Ysabeau Office 与霞鹜文楷轻便版的合并字体 LXGW Bright，采用字体合并补全工具将两款字体合并而成，提供 TTF、OTF、WOFF、WOFF2 四种格式。
该字体的更多版本 （可能会随时变动）
1. 霞鹜文楷屏幕阅读版 / LXGW WenKai Screen 由于原版「霞鹜文楷」Regular 字重在 PC 和 Android 屏幕上显示较细，而 Bold 字重需要在粗体模式下才能调用，特制作以 Bold 字重为基础的，加粗后的「霞鹜文楷」与 Windows 默认英文字体 Segoe UI Regular 粗细相当，PC 和 Android 手机屏幕阅读更加舒适，无需特别切换到粗体模式。
2. 霞鹜文楷轻便版 / LXGW WenKai Lite：剔除 v1.100 版本增补的一些较不常用的汉字，便于开发者将字体嵌入软件中。若完整版有字形优化或特性更新，精简版也将会跟进。精简版不包含谚文。
3. 霞鹜文楷 GB / LXGW WenKai GB：在文楷基础上进一步调整字形和笔形，符合 G 源字形规范。包含《通用规范汉字表》8105 个汉字。另有与「芫荽」等同源字体合并的「缝合楷」，及使用本项目字体补全的 GB 融合版。
4. 霞鹜文楷 TC / LXGW WenKai TC：供繁体中文用户和旧字形爱好者使用，基于轻便版制作，采用旧字形写法，主要采用 Klee One 的隐藏字形，部分部件手动修改（大部分部件参考一点字坊「传承字形标准化文件」，借助「汉文博士」「国学迷」「字统网」等工具按部件查字，对字形进行修改）。此外已有基于 Klee One 改造的繁体中文字体芫荽 / Iansui，采用台湾地区的教育标准字形；另有采用香港地区字形标准的芫茜雅楷 / JyunsaiKaai。
本项目为字体项目，有关 Magisk 字体模块等手机字体替换有关的问题，请移步模块模板的 Issues 里反馈，不要在本项目开议题。

授权信息

本字体是基于 SIL Open Font License 1.1 改造的 FONTWORKS 开发并发布的 Klee 开源项目。Klee 是 FONTWORKS 的商标。

猫啃网提供 SIL Open Font License 1.1 非官方简体中文译本便于理解，仅供参考。

许可

这款字体无论是个人还是企业都可以自由商用，无需付费，也无需知会或者标明原作者。 （但如果告知，我会很感激。）
这款字体可以自由传播、分享，或者将字体安装于系统、软件或APP中也是允许的，可以与任何软件捆绑再分发以及／或一并销售。
这款字体可以自由修改、改造，制作衍生字体。修改或改造后的字体也必须同样以 SIL OFL 公开。

限制

在制作衍生字体时，字体名称不可使用原有字体的「保留名称」。本字体保留名称「霞鹜」「LXGW」，基于本字体二次衍生的字体，名称不可出现「霞鹜」或「LXGW」字样；而在没有对字体源代码进行修改的情况下，重新编译出来的字体，可以继续使用本字体的保留名称「霞鹜」「LXGW」。
根据 SIL Open Font License 1.1 许可与条件中第一条的规定， 禁止单独出售字体文件(OTF/TTF文件)的行为。
该字体不可在 SIL Open Font License 1.1 以外的授权许可下发行。

以上是摘录的部分字体官方介绍文档

基于Mkdocs的网站字体美化用法

在mkdocs.yml中添加以下内容

extra_css:
- https://cdn.jsdelivr.net/npm/lxgw-wenkai-webfont@1.1.0/style.css
# - https://cdn.jsdelivr.net/npm/lxgw-wenkai-lite-webfont@1.1.0/style.css
# - https://cdn.jsdelivr.net/npm/lxgw-wenkai-tc-webfont@1.0.0/style.css
# - https://cdn.jsdelivr.net/npm/lxgw-wenkai-screen-webfont@1.1.0/style.css

然后在extra.css中添加以下内容

body {
      font-family: "LXGW WenKai", sans-serif;
      /* Lite version */
      /* font-family: "LXGW WenKai Lite", sans-serif; */
      /* TC version */
      /* font-family: "LXGW WenKai TC", sans-serif; */
      /* Screen version */
      /* font-family: "LXGW WenKai Screen", sans-serif; */
    }

四选一，mkdocs.yml和extra.css相互对应

不懂extra_css的用法的可以看一下我写的extra_css部分{target=_blank}教程

!!!tip

切换字体后可能返回顶部按钮会在个别浏览器显示异常
建议在extra.css里加入
```css
button.md-top {
  font-family: LXGW WenKai; /* 修改字体 */
  font-size: 16px; /* 修改字体大小 */
  font-weight: bold; /* 修改字体粗细 */
  color: #518FC1; /* 修改字体颜色 */
}
```

mkdocsfont.md 16 KB 永久链接 文件历史 原始文件