MacOS on 小景

macOS 美式键盘增强：输入重音字母、拼音声调、希腊字母和马耳他语字符

Mon, 25 May 2026 12:00:00 +0200

本文介绍 ABC Custom Keyboard：日常输入仍然是美式键盘，但按住 Option 就能输入重音字母、拼音声调、希腊字母、马耳他语字符和常用符号。

我开源了 ABC Custom Keyboard，这是一个面向 macOS 的自定义键盘布局。

项目地址在这里：Jingyuan-Zheng/ABC-Custom-Keyboard。

它的目标很直接：保留标准 US ABC / 美式键盘的日常输入体验，同时在 Option 层加入一套有规律、容易联想的扩展输入，用来输入欧洲拉丁字母、希腊字母、汉语拼音声调、马耳他语相关扩展字母、数学符号、编号符号和技术符号。

为什么要做这个键盘

美式键盘很适合英文、编程和快捷键，但一旦进入多语言写作，问题就来了。

你可能要写德语、法语、意大利语、西班牙语、葡萄牙语、马耳他语，也可能要输入拼音声调、希腊字母或论文里常见的数学符号。系统自带的特殊字符输入不够统一，切换到语言专用键盘又会改变物理键位记忆。比如德语键盘里的 Y 位置就和美式键盘不同。

ABC Custom Keyboard 的思路是：基础层完全保持标准 US ABC，只把多语言和学术符号放到有规律的 Option / dead key 层里。这样一把美式键盘就能覆盖更多写作场景。

基础层保持 US ABC

ABC Custom 假设你使用的是标准 US ABC 物理键盘。基础层不做重新排列，所以日常英文输入、常见 Command / Control 快捷键都尽量保持原样。

图 1：基础层保持标准 US ABC 布局。

直接 Option 层

按住 Option 再按键，就可以输入键帽上显示的符号。蓝色键是 dead key 前缀：先按前缀组合，松开，再按目标键。

图 2：Option 层提供常用符号和容易记忆的 dead key 前缀。

Shift + Option 是另一组直接符号层，也包含上标和圈号字符的 dead key 前缀。

图 3：Shift + Option 在不改变基础键位的前提下扩展更多符号。

这些直接层覆盖了 ℕ、ℤ、ℚ、ℝ、π、Σ、√、∂、≠、≤、≥、箭头、破折号、货币符号、勾选符号、方框和星号标记等常用字符。

更容易记的 Dead Key

dead key 的使用方式是：先按前缀组合，松开，再按目标键。

例如：

Option + 1 后再按 a，输出 ā
Option + 2 后再按 e，输出 é
Option + 5 后再按 u，输出 ü
Option + G 后再按 p，输出 π

拼音声调层直接对应声调编号：Option + 1 到 4 分别对应一到四声。

图 4：一声使用 Option + 1，再按目标元音。

两点 / umlaut 层使用 Option + 5，因为 % 这个键上有两个圈，容易联想到字母上的两点。上点字母层使用 Option + 8，因为 * 可以联想到点或星号。

图 5：umlaut 层覆盖 ä、ë、ï、ö、ü 等字符。

图 6：上点字母对马耳他语和学术转写很有用。

希腊字母、上下标和技术符号

学术写作里常见的希腊字母也被放到了联想位置。Option + G 表示 Greek，例如 p 对应 π，m 对应 μ，l 对应 λ，w 对应 ω，d 对应 δ。

图 7：希腊字母层尽量使用拉丁字母的联想位置。

此外，它还提供成对的下标和上标层，以及度数、直径、空集、版权、注册、商标、圈号字符和圆形运算符等技术符号。

图 8：上标可以通过 Shift + Option + 9 进入。

安装方式

最简单的方式是使用 DMG：

从最新 GitHub Release 下载 ABC-Custom-Keyboard.dmg。
打开 DMG，把 ABC Custom.bundle 拖到窗口里的 Keyboard Layouts 文件夹。
退出登录后重新登录，或重启 macOS。
打开系统设置，在键盘输入源里添加 ABC Custom。

也可以手动安装，把 bundle/ABC Custom.bundle 复制到：

`1`	`~/Library/Keyboard Layouts/`

然后退出登录后重新登录，或重启 macOS。

如果你想自己修改

可编辑的布局文件在 layouts/ABC Custom.keylayout。发布用的 macOS 键盘布局 bundle 在 bundle/ABC Custom.bundle，README 里的键位图来自 assets/*.svg，可以通过 tools/generate_keymap_svg.py 重新生成。

如果你经常在欧洲语言、拼音声调、马耳他语字符、希腊字母和数学符号之间切换，ABC Custom Keyboard 可以把这些字符放到一套更稳定、更容易记忆的位置上，同时不牺牲标准美式键盘的输入习惯。

Hugo + Stack 搭建个人博客：GitHub Pages 部署和 Token 踩坑记录

Sun, 14 Sep 2025 00:00:00 +0000

本文记录第一次用 Hugo + Stack 搭建个人博客的过程，重点是 macOS 环境、GitHub Pages 自动部署和 GitHub Token 认证问题。

你好，世界！欢迎来到我的小站。

正如标题所说，这是我的第一篇博客。作为一个喜欢记录和分享的人，我一直梦想着拥有一个属于自己的、可以自由书写的空间。在探索了各种方案后，我最终选择了 Hugo + GitHub Pages 这套组合，因为它足够快速、免费、强大，而且折腾起来非常有成就感。

这篇文章，就是为了记录我从一个想法到网站上线的全过程，并特别点出一些教程里可能没详细说明、但我亲身遇到的“坑”。

搭建过程我主要参考了以下优秀教程，强烈推荐大家先看一遍：

文字教程： Hugo + Stack 主题打造自定义博客
视频教程：【雷】Hugo + Github免费搭建博客，并实现自动化部署

整体思路

在本地电脑上安装 Hugo。
创建网站、配置主题、撰写文章。
将网站源码推送到 GitHub，触发自动化部署。
最终，通过 username.github.io 访问你的博客。

第一步：环境准备 (macOS)

首先，我们需要一些基础工具。在 macOS 上，推荐使用 Homebrew 这个包管理器来安装，非常方便。

安装 Homebrew (如果已经安装，请跳过)

`1`	`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`

安装 Hugo 和 Git
1 2

brew install hugo brew install git
安装完成后，可以通过 hugo version 和 git --version 来检查。

核心搭建步骤：跟随教程 & 注意差异

从创建 Hugo 网站、安装 Stack 主题，到配置 hugo.toml 文件、设置 GitHub Actions 自动化部署，上面链接的教程已经讲得非常详细清晰了，我就不再赘述。

在这里，我只想补充一点 macOS 用户 需要注意的小差异：

macOS 用户请注意： 在视频教程中，你可能会看到讲师使用的是 hugo.exe 命令。这是因为他可能是在 Windows 上直接下载的二进制文件。在 macOS 上，通过 Homebrew 安装后，直接使用 hugo 命令即可，例如 hugo server -D。不需要 .exe 后缀。

关键一步：首次 `git push` 与 GitHub 令牌（Token）

当你本地的所有工作都完成后，最后一步是 git push，将你的网站源码推送到 GitHub 仓库。这是新手最容易卡住的地方。

现在 GitHub 不再支持使用账户密码直接进行 git 操作，我们必须使用 个人访问令牌（Personal Access Token, PAT）。

1. 为什么需要令牌？

简单来说，令牌是比密码更安全的一种认证方式。

2. 第一次 Push 的正确姿势

当你第一次执行 git push 时，系统会弹出一个窗口或在命令行提示你输入用户名和密码：

Username: 输入你的 GitHub 用户名。
Password: 千万不要输入你的 GitHub 登录密码！ 在这里应该粘贴你提前生成好的个人访问令牌。

如何生成令牌？ 前往 GitHub -> 点击右上角头像 -> Settings -> Developer settings -> Personal access tokens -> Tokens (classic) -> Generate new token。 权限 (Scopes) 至少要勾选 repo。生成后，立刻复制并保存好这个令牌，因为这个页面关掉后你将再也看不到它了。

3. 救命！我的令牌过期了/错了，该如何更新？

这是一个非常常见的问题。如果你之前设置过错误的令牌，或者令牌过期了，git push 会一直失败，提示认证错误。这是因为 macOS 的“钥匙串”已经帮你记住了那个旧的、无效的令牌。

我们需要手动删除它，让 Git 重新问你要新的。

在最新版的 macOS 中，操作非常简单：

打开“系统设置” (System Settings)。
在左侧菜单找到并进入 “密码” (Passwords) 区域 (需要 Touch ID 或密码解锁)。
在密码列表上方的搜索框中，输入 github.com。
找到相关的条目，点击右侧的“信息”图标 (i)，然后选择 “删除密码”。

删除后，回到你的终端，再次执行 git push。此时，系统就会重新提示你输入用户名和密码了，这时再粘贴你的新令牌，问题就解决了！

总结

搭建博客的过程，就是跟随教程、解决问题的过程。希望我补充的这两点关于 macOS 的命令差异和 GitHub 令牌的经验，能帮你绕过新手常见的“坑”。

现在，轮到你来书写自己的故事了。

MacOS on 小景

macOS 美式键盘增强：输入重音字母、拼音声调、希腊字母和马耳他语字符

为什么要做这个键盘

基础层保持 US ABC

直接 Option 层

更容易记的 Dead Key

希腊字母、上下标和技术符号

安装方式

如果你想自己修改

相关阅读

Hugo + Stack 搭建个人博客：GitHub Pages 部署和 Token 踩坑记录

整体思路

第一步：环境准备 (macOS)

核心搭建步骤：跟随教程 & 注意差异

关键一步：首次 `git push` 与 GitHub 令牌（Token）

1. 为什么需要令牌？

2. 第一次 Push 的正确姿势

3. 救命！我的令牌过期了/错了，该如何更新？

总结

相关阅读

MacOS on 小景

macOS 美式键盘增强：输入重音字母、拼音声调、希腊字母和马耳他语字符

为什么要做这个键盘

基础层保持 US ABC

直接 Option 层

更容易记的 Dead Key

希腊字母、上下标和技术符号

安装方式

如果你想自己修改

相关阅读

Hugo + Stack 搭建个人博客：GitHub Pages 部署和 Token 踩坑记录

整体思路

第一步：环境准备 (macOS)

核心搭建步骤：跟随教程 & 注意差异

关键一步：首次 git push 与 GitHub 令牌（Token）

1. 为什么需要令牌？

2. 第一次 Push 的正确姿势

3. 救命！我的令牌过期了/错了，该如何更新？

总结

相关阅读

关键一步：首次 `git push` 与 GitHub 令牌（Token）