nerdfonts/patcher

Nerd Fonts Docker镜像文档

镜像概述和主要用途

Nerd Fonts是一个为开发者字体打补丁的项目，旨在添加大量来自流行"图标字体"的图标符号（glyphs），如Font Awesome、Devicons、Octicons等。本Docker镜像提供字体补丁工具，可用于补丁自定义字体或生成超过140万种独特组合/变体。

访问官方网站、https://github.com/ryanoasis/nerd-fonts%E6%88%96https://github.com/ryanoasis/nerd-fonts/wiki%E8%8E%B7%E5%8F%96%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E3%80%82

核心功能和特性

• 多图标集合支持：集成Font Awesome、Devicons、Octicons、Material Design Icons等多种流行图标字体
• 自定义符号字体：通过--custom选项指定自定义图标字体，所有新图标将被复制且不应用缩放
• 灵活的输出配置：支持调整字体宽度、行高，指定输出格式（ttf、otf等）
• 高级补丁选项：可选择性添加图标集、移除连字、应用后处理脚本
• 大规模变体生成：支持生成超过140万种独特字体组合/变体
• 跨平台兼容：提供Windows兼容模式，限制字体名称长度

使用场景和适用范围

• 开发者自定义终端字体，添加图标支持以增强命令行工具视觉体验
• 美化IDE或代码编辑器字体，集成图标符号提升文件类型和状态的视觉区分度
• 为特定开发环境创建定制字体，集成项目所需的专属图标符号
• 字体设计者扩展现有字体，快速集成多种流行图标集合

使用方法和配置说明

基本使用步骤

1. 将待补丁的字体文件放入本地文件夹（如~/fonts/to-patch）
2. 创建本地输出文件夹用于存放处理后的字体（如~/fonts/patched）
3. 运行Docker容器执行补丁命令：

   bash
   docker run -v /path/to/fonts:/in -v /path/for/output:/out nerdfonts/patcher [OPTIONS]
   

   其中/path/to/fonts是本地字体源文件夹路径，/path/for/output是本地输出文件夹路径。

配置选项说明

使用示例

基本补丁示例

bash
docker run --rm -v ~/myfont/patchme:/in -v ~/myfont/patched:/out nerdfonts/patcher

将~/myfont/patchme中的字体文件进行默认配置补丁处理，结果输出到~/myfont/patched。

添加Font Awesome图标示例

bash
docker run --rm -v ~/Desktop/myfont/patchme:/in -v ~/Desktop/myfont/patched:/out nerdfonts/patcher --fontawesome

为指定字体添加Font Awesome图标符号，并将结果输出到桌面的patched文件夹。

生成单宽度Material Design图标字体示例

bash
docker run --rm -v ~/fonts/source:/in -v ~/fonts/output:/out nerdfonts/patcher -s --material -ext ttf

生成单宽度字体，添加Material Design图标，并指定输出格式为TTF。