分类：技术

  • 使用 po4a 进行技术文档翻译：从入门到实践

    26-01-23 19:23 197 0 技术

    在开源项目中，文档的多语言支持是提升项目影响力的重要环节。最近在为 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/            # 简体中文翻译输出

    这种结构将翻译工作与源文件分离，既保持了源文件的整洁，又便于管理翻译进度。

  • Docker 配置代理完整指南

    26-01-21 17:18 182 0 技术

    背景

    在国内环境下使用 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

    1. 创建代理配置文件

      sudo vim /etc/systemd/system/docker.service.d/http-proxy.conf

    2. 添加代理配置

      [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: 本地域名
      • 内网私有镜像仓库域名

    1. 重载配置并重启 Docker

      # 重载 systemd 配置
sudo systemctl daemon-reload
# 重启 Docker 服务
sudo systemctl restart docker

    2. 验证配置

      # 查看 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

    3. 测试代理连接

      # 测试是否能通过代理访问 Docker Hub
curl -x http://your-proxy-ip:port -I https://registry-1.docker.io/v2/
# 拉取测试镜像
docker pull hello-world

  • 在 macOS（Apple Silicon）根目录下创建目录的正确方式

    25-10-29 17:30 722 0 技术

    在 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

    简单来说：根目录是锁死的。

  • 通过 pyenv 配合 venv 来创建项目专属的虚拟环境

    24-12-03 17:37 4619 0 技术

    安装 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

  • 解决 Python 3.8+ 遇到的 OpenSSL 版本不兼容的问题

    24-11-09 16:40 7420 0 技术

    在安装 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().

  • MySQL 容器异常 - mbind: Operation not permitted

    24-06-03 10:39 5526 0 技术 
    2024-06-03 09:23:25+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 8.0.27-1debian10 started.
2024-06-03 09:23:25+00:00 [Note] [Entrypoint]: Switching to dedicated user 'mysql'
2024-06-03 09:23:25+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 8.0.27-1debian10 started.
2024-06-03T09:23:25.944402Z 0 [Warning] [MY-011070] [Server] 'Disabling symbolic links using --skip-symbolic-links (or equivalent) is the default. Consider not using this option as it' is deprecated and will be removed in a future release.
2024-06-03T09:23:25.944530Z 0 [Warning] [MY-010918] [Server] 'default_authentication_plugin' is deprecated and will be removed in a future release. Please use authentication_policy instead.
2024-06-03T09:23:25.944549Z 0 [System] [MY-010116] [Server] /usr/sbin/mysqld (mysqld 8.0.27) starting as process 1
2024-06-03T09:23:25.970311Z 1 [System] [MY-013576] [InnoDB] InnoDB initialization has started.
2024-06-03T09:23:26.546899Z 1 [System] [MY-013577] [InnoDB] InnoDB initialization has ended.
2024-06-03T09:23:26.881580Z 0 [Warning] [MY-013746] [Server] A deprecated TLS version TLSv1 is enabled for channel mysql_main
2024-06-03T09:23:26.881612Z 0 [Warning] [MY-013746] [Server] A deprecated TLS version TLSv1.1 is enabled for channel mysql_main
2024-06-03T09:23:26.899326Z 0 [Warning] [MY-010068] [Server] CA certificate ca.pem is self signed.
2024-06-03T09:23:26.899366Z 0 [System] [MY-013602] [Server] Channel mysql_main configured to support TLS. Encrypted connections are now supported for this channel.
2024-06-03T09:23:26.989154Z 0 [Warning] [MY-011810] [Server] Insecure configuration for --pid-file: Location '/var/run/mysqld' in the path is accessible to all OS users. Consider choosing a different directory.
2024-06-03T09:23:27.078117Z 0 [System] [MY-010931] [Server] /usr/sbin/mysqld: ready for connections. Version: '8.0.27'  socket: '/var/run/mysqld/mysqld.sock'  port: 3306  MySQL Community Server - GPL.
2024-06-03T09:23:27.078165Z 0 [System] [MY-011323] [Server] X Plugin ready for connections. Bind-address: '::' port: 33060, socket: /var/run/mysqld/mysqlx.sock
mbind: Operation not permitted
mbind: Operation not permitted
mbind: Operation not permitted

  • macOS 终端使用 Solarized Dark xterm-256color 主题

    23-11-25 12:38 632 0 技术

    1. 下载主题文件

    Solarized 是一款经典的终端配色方案，护眼又高对比度。可以在官方仓库下载 macOS 终端主题：

    git clone https://github.com/altercation/solarized.git

    主题路径位于：

    solarized/osx-terminal.app-colors-solarized/

    其中包括两个文件：

    • Solarized Dark xterm-256color.terminal
    • Solarized Light xterm-256color.terminal

    2. 导入主题

    1. 打开 Terminal.app
    2. 依次点击：偏好设置 (Preferences) → Profiles
    3. 点击左下角的 齿轮图标 → 导入...
    4. 选择 Solarized Dark xterm-256color.terminal
    5. 设置为默认主题：在主题上右键 → 选择「设为默认」

    完成后重新打开终端，就能看到舒适的 Solarized Dark 效果。

    3. 优化选中文本配色

    1. 打开 终端 → 设置 → 配置文件 → 文本 → 选中颜色
    2. 点击右侧的小色块（打开颜色选取器）
    3. 在弹出的窗口上方点 “滑块图标”（像三根小杠的那个），切换模式
    4. 在上方的下拉菜单中选择：RGB 滑块
    5. 在十六进制颜色编号框输入 284B5A

    4. 设置字体

    在 macOS 终端中，个人比较喜欢 SF Mono Terminal 11，苹果官方风格，简洁干净。 JetBrains Mono 字体也相当不错，专为开发设计，字符区分度高（比如 0/O, 1/l/I），自带连字（可以关闭），粗细分布合理，长时间看不累。

  • VS Code 设置编辑器及终端的字体和字号

    23-09-16 12:38 503 1 技术

    作为一名开发者，我们都希望拥有一个舒适的编码环境。最近在配置 VS Code 的字体时遇到了一些问题，经过一番调试，终于找到了完美的解决方案。今天分享这个过程，希望能帮到有相似困扰的朋友。

    第一次尝试：基础配置

    {
  "editor.fontFamily": "SF Mono, monospace",
  "editor.fontSize": 13,
  "terminal.integrated.fontFamily": "SF Mono, monospace"
  "terminal.integrated.fontSize": 13
}

    结果：字体和字号都不生效。

    第二次尝试：带空格的字体加单引号

    {
  "editor.fontFamily": "'SF Mono', monospace",
  "editor.fontSize": 13,
  "terminal.integrated.fontFamily": "'SF Mono', monospace"
  "terminal.integrated.fontSize": 13
}

    结果：字号生效，字体不生效。

    然而，在配置过程中还遇到了一个令人困扰的错误：

    终端仅支持等宽字体。如果这是新安装的字体，请确保重新启动 VS Code。

    最终打开目录 /System/Applications/Utilities/Terminal.app/Contents/Resources/Fonts/

    双击 SFMono-Regular.otf → “安装字体”

    问题解决！

    以下是完整的 ~/Library/Application\ Support/Code/User/settings.json

    {
    "workbench.colorTheme": "Solarized Dark",
    "roo-cline.allowedCommands": [
        "git log",
        "git diff",
        "git show"
    ],
    "roo-cline.deniedCommands": [],
    "security.workspace.trust.untrustedFiles": "open",
    "editor.fontFamily": "'SF Mono', Menlo, monospace",
    "editor.fontSize": 13,
    "terminal.integrated.fontFamily": "'SF Mono Terminal', Menlo, monospace",
    "terminal.integrated.fontSize": 13
}

  • Undefined index: constraint_name 报错解决方法

    22-12-09 16:32 3816 0 技术

    错误日志

    [error][yii\base\ErrorException:8] yii\base\ErrorException: Undefined index: constraint_name in /path/to/vendor/yiisoft/yii2/db/mysql/Schema.php:394

    原因

    MySQL 8.0.21 中返回的列名大小写不一致，导致 Yii2 在获取数据库模式时出错。

    解决方法

    1. 编辑 common/config/main-local.php，设置 PDO 属性 PDO::ATTR_CASE => PDO::CASE_LOWER

      'db' => [
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=db_name',
'username' => 'username',
'password' => '******',
'attributes' => [PDO::ATTR_CASE => PDO::CASE_LOWER],
],

    2. 修改 /path/to/vendor/yiisoft/yii2/db/mysql/Schema.php:394

      foreach ($rows as $row) {
$row = array_change_key_case($row, CASE_LOWER);

    推荐第一种方法，使列名明确指定为一致的大小写。

    参考文章：https://github.com/yiisoft/yii2/issues/18171

  • 入职满 7 周年纪念日

    22-01-20 12:38 3838 0 技术

    IMG_0354.PNG

文章归档

2026 年 01 月 3 2025 年 10 月 2 2025 年 09 月 1 2025 年 04 月 1 2025 年 01 月 1 2024 年 12 月 1 2024 年 11 月 1 2024 年 10 月 2 2024 年 09 月 2 2024 年 07 月 1

文章日历

2026 年 02 月
日 一 二 三 四 五 六
01 02 03 04 05 06 07
08 09 10 11 12 13 14
15 16 17 18 19 20 21
22 23 24 25 26 27 28

文章标签

最新评论

友情链接