我的开发环境架设在 Mac OS X 上，所以以下操作均在此系统中完成。Windows 系统请酌情参考。

安装组件

WordPress 的 i18n 和 l10n 是通过 GNU gettext 实现的，因此在进行实际工作之前，首先需要安装相关的组件。

XCode

XCode 是 Mac OS 中的常用 IDE 之一，其中也包含了编译相关的库，比如 gcc，在后面会用到 gcc 库，所以首先要安装 XCode。XCode 在购买苹果电脑产品的附带安装盘中有。安装过程中一定要选择安装编译组件。

homebrew

homebrew – The missing package manager for OS X，用来安装 *nix 系统中常用的库包。homebrew 的安装方法请参照 homebrew wiki Installation。

gettext

如果以上所需组件已经安装完毕，那么可以继续以下步骤。打开 Terminal，运行以下命令：

1

brew install gettext

等待片刻，自动编译完成后即可。gettext 被安装在 /usr/local/Cellar 中。

为了能够使用 gettext 中相关的命令，还需要修改 $PATH，打开 ~/.profile 将 /usr/local/Cellar/gettext/0.18.1.1/bin 加入其中：

1

export PATH="/usr/local/bin:/usr/local/sbin:/usr/local/Cellar/gettext/0.18.1.1/bin:/Developer/usr/bin:$PATH"

关闭该文件，在 Terminal 中执行以下命令加载新的 $PATH：

1

source ~/.profile

WordPress i18n 工具

WordPress 的 i18n 和 l10n 相关工具放在 svn 中。这些工具可以方便的为我们添加 textdomain，生成 POT 文件。

在 Terminal 中执行以下命令安装：

1

svn co http://svn.automattic.com/wordpress-i18n/tools/trunk/ ./

以上命令将这些工具安装到当前目录中。

工作流程

WordPress 的 i18n 和 l10n 的工作流程大概是这样的：

1. 在主题或插件中为 l10n 留下接口，也就是合理的使用 __()、_e()、_x()、_n() 等函数；

2. 在上述的接口函数中指定 textdomain；

3. 生成 POT 文件；

4. 生成 PO 文件；

5. 本地化，即翻译相应的词条；

6. 生成 MO 文件。

l10n 接口

WordPress 定义了很多 l10n 接口函数，详细用法可以参照 wp-includes/l10n.php。在主题制作或插件开发的过程中，最好同时加入相应的 textdomain。如果没加入，后期可以通过 WordPress 的 i18n 工具来加入，在 Terminal 执行以下命令：

1

php add-textdomain.php -i domain phpfile phpfile ...

生成 POT 文件

主题制作完成或插件开发完成后，便可以通过前期预留的接口将需要本地化的词条摘出来，放到一个特殊的文件中，这个文件就是 POT 模板文件。执行以下命令来生成主题的 POT 文件：

1

php makepot.php wp-theme /path/to/theme /path/to/potfile.pot

如果需要生成插件的 POT 文件，将上述命令中的 wp-theme 换成 wp-plugin 即可。更多用法可以执行 php makepot.php 命令查看。

一个好的习惯是，将生产的 POT 及下面生成的 PO、MO 文件放在主题文件夹或插件文件夹下的 languages 目录中。

生成 PO 文件

上一步中生成的 POT 只是一个模板，是为各语言本地化提供的一个样板，也就是指明哪些词条需要翻译。真正的翻译过程是在 PO 文件中进行的。

复制上一步生成的 POT 文件，修改文件后缀为 po，并重命名为相应语言代码。比如简体中文，其文件名为 zh_CN.po。注意，插件的 PO 文件命名规则是：plugin-slug-zh_CN.po。

使用文本编辑器打开 PO 文件，然后进行词条的翻译。

生成 MO 文件

PO 文件是给人类用的，机器则需要 MO 文件。执行以下代码生产 MO 文件：

1

msgfmt -o zh_CN.mo zh_CN.mo

作为一个开发者，只需提供 POT 文件即可。而在生产环境中，只需上传相应的 MO 文件即可。

参考文章

• I18n for WordPress Developers
• Translating WordPress
• Translating WordPress Plugins & Themes

默认的，WordPress 的分类 URL 格式是 host/category/xxx/，其中 category 就是 rewrite base，这是可定制的部分，例如本站分类 URL 的 rewrite base 就设置为“go”了。同理，可以设置标签 URL 的 rewrite base。

在设置 WordPress 链接格式的时候我遇到一个问题。我设置的 URL 格式是 /t/%postname%，rewrite base 是固定的，不再是占位符，这时文章页面的 URL 是没问题的，页面的 URL 是没问题的，分类、标签的页面 URL 也是没问题的，但是，基于时间的页面就出现问题了，其 URL 结构变成 /t/2012/01 的格式，这个“t”是我不需要的。

查看 wp-includes/rewrite.pnp 第 862 行 get_date_permastruct() 函数的定义可以发现，最终返回的结果加入了 $front，这就是“t”为什么会出现的原因。

861
862
863

....
$this->date_structure = $front . $date_endian;
....

那么只需要覆盖类 WP_Rewrite 的 $date_structure 变量即可。将以下代码片段写入主题的 functions.php：

1
2
3
4
5
6
7
8
9

function ac_re_rewrite() {
  global $wp_rewrite;

  // Not need the $wp_rewrite->front
  $wp_rewrite->date_structure = '%year%/%monthnum%/%day%';

  $wp_rewrite->flush_rules();
}
add_action( 'init', 'ac_re_rewrite' );

如此一来，基于日期的存档 URL 格式就定制好了，利用同样的方法还可以定制作者归档等页面的 URL 格式。

其实，有个更简单、更有效的方法可以完全去除 Toolbar：使用 show_admin_bar() 函数。将以下代码片段加入主题的 functions.php 文件：

1
2
3
4
5
6

// 全局禁用 Toolbar
show_admin_bar( false );

// 只在前台禁用 Toolbar
if ( !is_admin() )
  show_admin_bar( false );

可以根据需要选择禁用全局还是只在前台禁用。

这个方法的好处是，1）代码量少；2）禁用的更彻底，Toolbar 所需的样式表文件和 Javascript 脚本文件均不会加载。