www.cuiliang.com Wblog,talk about golang,java and so on. wangsongyanlove@163.com (Wangsongyan) Wed, 29 Apr 2026 15:54:45 +0000 www.cuiliang.com/post/388 在开源项目中，文档的多语言支持是提升项目影响力的重要环节。最近在为 Yii3 框架文档添加简体中文翻译时，我深入使用了 po4a 这个强大的翻译工具。本文将分享使用 po4a 进行技术文档翻译的完整流程和实践经验。 ## 什么是 po4a？ po4a（PO for Anything）是一个基于 gettext 的文档翻译工具，最初为 Debian 项目开发，但现在已经广泛应用于各种文档翻译场景。它的核心优势在于： - **格式无关**：支持 Markdown、POD、XML、HTML 等多种格式 - **版本控制友好**：翻译文件（.po）是纯文本，易于纳入 Git 管理 - **增量更新**：源文件更新时，自动合并已有翻译，避免重复工作 - **团队协作**：支持多人协作翻译，便于分工 ## 项目结构 在开始之前，先了解典型的 po4a 项目结构： ``` docs/ ├── _translations/ # 翻译配置和 PO 文件 │ ├── po4a.conf # 主配置文件 │ ├── pot/ # 模板文件（.pot） │ └── po/ # 翻译文件（.po） │ └── zh-CN/ # 简体中文翻译 ├── src/ # 源文件和翻译输出 │ ├── en/ # 英文源文件 │ └── zh-CN/ # 简体中文翻译输出 ``` 这种结构将翻译工作与源文件分离，既保持了源文件的整洁，又便于管理翻译进度。 www.cuiliang.com/post/388 Fri, 23 Jan 2026 19:23:47 +0000 www.cuiliang.com/post/387 ## 背景 在国内环境下使用 Docker 时，经常遇到拉取镜像缓慢或超时的问题。虽然可以配置镜像加速器，但随着国内镜像源的不稳定，使用代理成为了更可靠的解决方案。 ## 问题现象 执行 `docker build` 或 `docker pull` 时出现以下错误： ``` ERROR: failed to solve: DeadlineExceeded: failed to resolve source metadata for docker.io/xxx dial tcp xxx.xxx.xxx.xxx:443: i/o timeout ``` ## 核心原理 Docker 架构分为两部分： - **Docker Client:** 命令行工具，接收用户命令 - **Docker Daemon:** 后台服务，实际执行拉取镜像等操作 当我们在终端设置 `export HTTP_PROXY=...` 时，只影响 `Docker Client`，而真正需要网络访问的 `Docker Daemon` 并未使用代理。 ## 解决方案 为 Docker Daemon 配置代理（推荐） 1. 创建 systemd 配置目录 ``` sudo mkdir -p /etc/systemd/system/docker.service.d ``` 2. 创建代理配置文件 ``` sudo vim /etc/systemd/system/docker.service.d/http-proxy.conf ``` 3. 添加代理配置 ``` [Service] Environment="HTTP_PROXY=http://your-proxy-ip:port" Environment="HTTPS_PROXY=http://your-proxy-ip:port" Environment="NO_PROXY=localhost,127.0.0.1,*.local,registry.internal.com" ``` 配置说明： - HTTP_PROXY: HTTP 协议代理地址 - HTTPS_PROXY: HTTPS 协议代理地址（Docker Hub 使用 HTTPS） - NO_PROXY: 不使用代理的地址列表，通常包括： - localhost, 127.0.0.1: 本地地址 - *.local: 本地域名 - 内网私有镜像仓库域名 4. 重载配置并重启 Docker ``` # 重载 systemd 配置 sudo systemctl daemon-reload # 重启 Docker 服务 sudo systemctl restart docker ``` 5. 验证配置 ``` # 查看 Docker 服务的环境变量 sudo systemctl show --property=Environment docker ``` 预期输出： ``` Environment=HTTP_PROXY=http://your-proxy-ip:port HTTPS_PROXY=http://your-proxy-ip:port NO_PROXY=localhost,127.0.0.1 ``` 6. 测试代理连接 ``` # 测试是否能通过代理访问 Docker Hub curl -x http://your-proxy-ip:port -I https://registry-1.docker.io/v2/ # 拉取测试镜像 docker pull hello-world ``` www.cuiliang.com/post/387 Wed, 21 Jan 2026 17:18:48 +0000 www.cuiliang.com/post/386   www.cuiliang.com/post/386 Tue, 20 Jan 2026 10:19:14 +0000 www.cuiliang.com/post/385 在 macOS 上，我想在根目录（/）下创建一个目录，比如 /data1，用于放置项目数据。 ``` mkdir /data1 ``` 结果系统提示： ``` mkdir: /data1: Read-only file system ``` 一开始我以为是权限问题，于是又试了： ``` sudo mkdir /data1 ``` 但依然报错，说明即使 `sudo` 也不行。 ## 为什么会这样？ 从 macOS Big Sur（11） 开始，苹果对系统盘启用了 Signed System Volume（SSV）签名保护机制。 这意味着： 系统卷 `/` 是 只读的 APFS 快照； 即使是 root 用户，也不能直接修改； `mount -uw /` 在 Apple Silicon（M1/M2/M3）上会报错： ``` mount_apfs: volume could not be mounted: Permission denied mount: / failed with 66 ``` 简单来说：根目录是锁死的。 www.cuiliang.com/post/385 Wed, 29 Oct 2025 17:30:05 +0000 www.cuiliang.com/post/384 2025 海淀马拉松 3:39 安全完赛   www.cuiliang.com/post/384 Tue, 14 Oct 2025 17:28:41 +0000 www.cuiliang.com/post/383 西北旺第四届十公里竞速赛 PB，成绩 44:11，配速 4:25，排名 40（500 人参赛）     www.cuiliang.com/post/383 Sun, 28 Sep 2025 15:00:27 +0000 www.cuiliang.com/post/382   www.cuiliang.com/post/382 Fri, 29 Aug 2025 14:34:49 +0000 www.cuiliang.com/post/381 2025北京亦庄半程马拉松暨人形机器人马拉松安全完赛，第一次和机器人一起参加比赛，最近太忙训练太少，虽然没有 PB，但是今天的发挥也相当满意！    www.cuiliang.com/post/381 Sat, 19 Apr 2025 15:52:55 +0000 www.cuiliang.com/post/380 时光荏苒，岁月如梭，十年风雨，不负韶华。   www.cuiliang.com/post/380 Mon, 20 Jan 2025 09:49:32 +0000 www.cuiliang.com/post/379  www.cuiliang.com/post/379 Mon, 13 Jan 2025 11:54:46 +0000 www.cuiliang.com/post/378 ## 安装 `pyenv` ``` curl https://pyenv.run | bash ``` 这条命令会自动安装以下工具： - `pyenv` - `pyenv-doctor`（检查 `pyenv` 安装的健康状况） - `pyenv-virtualenv`（用于创建 Python 虚拟环境） ## 更新 Shell 配置 ``` vim ~/.bashrc ``` ``` echo -e 'export PATH="$HOME/.pyenv/bin:$PATH"\n' \ 'eval "$(pyenv init --path)"\n' \ 'eval "$(pyenv init -)"\n' \ 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc ``` ``` source ~/.bashrc ``` ## 安装 Python 版本 ``` pyenv install 3.11.9 ``` ## 设置全局或本地 Python 版本 设置一个全局的 Python 版本（用于所有项目）： ``` pyenv global 3.11.9 ``` 你还可以为特定目录设置本地版本，例如在某个项目目录下： ``` pyenv local 3.8.12 ``` 这会创建一个 `.python-version` 文件，记录该项目使用的 Python 版本。 ## 创建虚拟环境（使用 venv） ``` python -m venv venv ``` ## 激活虚拟环境 对于 Bash/Zsh（Linux/macOS）： ``` source venv/bin/activate ``` 对于 Windows（CMD）： ``` .\venv\Scripts\activate ``` www.cuiliang.com/post/378 Tue, 03 Dec 2024 17:37:48 +0000 www.cuiliang.com/post/377 在安装 Python3.8 时可能会遇到与系统自带 OpenSSL 版本不兼容的问题。Python3.8 需要的 OpenSSL 版本为 `1.0.2` 或 `1.1.x`。如果系统中默认的 OpenSSL 版本低于需求（通常是 `OpenSSL 1.0.1`），会导致如下错误： ``` Could not build the ssl module! Python requires an OpenSSL 1.0.2 or 1.1 compatible libssl with X509_VERIFY_PARAM_set1_host(). ``` www.cuiliang.com/post/377 Sat, 09 Nov 2024 16:40:57 +0000 www.cuiliang.com/post/376 离家最近的一场马拉松，从家出发到起点仅 5 公里，整体的体验非常好，明年还会继续参加！  www.cuiliang.com/post/376 Tue, 29 Oct 2024 20:15:58 +0000 www.cuiliang.com/post/375 天津马拉松成功 PB，成绩 3:31，比上次最佳成绩快了 20 分钟，期待下周海淀马拉松取得更好成绩！  www.cuiliang.com/post/375 Mon, 21 Oct 2024 10:59:56 +0000 www.cuiliang.com/post/374 2024年房贷新政，北京房贷利率直接从 LPR+55BP 降至 LPR-30BP，再加上今年的 LPR 下调，利率将下降 1 个百分点，真是实实在在的利好！  www.cuiliang.com/post/374 Sat, 12 Oct 2024 11:04:32 +0000 www.cuiliang.com/post/373   www.cuiliang.com/post/373 Tue, 10 Sep 2024 14:11:19 +0000 www.cuiliang.com/post/372 * 9月22日 怀柔长城马拉松（中签） * 10月20日 天津马拉松（中签） * 10月27日 海淀马拉松（中签） * 11月3日 北京马拉松（未出签） ### 30公里LSD  ### 间歇跑   ### 35公里LSD  ### 54321渐进跑   www.cuiliang.com/post/372 Mon, 09 Sep 2024 10:33:54 +0000 www.cuiliang.com/post/371   www.cuiliang.com/post/371 Sat, 03 Aug 2024 11:00:37 +0000 www.cuiliang.com/post/370 部门已经不存在了，但是精神依然存在。 www.cuiliang.com/post/370 Thu, 01 Aug 2024 13:40:25 +0000 www.cuiliang.com/post/369 之前写过一篇 [阿里云服务器添加 Swap 分区](/post/233) 的文章，最近发现了三种常用创建交换分区的方法，现在分享给大家，并对三种创建交换分区的优缺点做了简单对比。 创建 Swap 分区文件有三种常用方法：使用 `dd`、使用 `fallocate` 和使用 `fdisk`。 www.cuiliang.com/post/369 Wed, 24 Jul 2024 14:27:19 +0000