class RDoc::Generator::POT

生成一个 POT 文件。

以下是使用此生成器的翻译工作流程。

创建 .pot

您可以通过 pot 格式化程序创建 .pot 文件

% rdoc --format pot

它会生成 doc/rdoc.pot。

创建 .po

您可以从 doc/rdoc.pot 创建 .po 文件。此操作仅在第一次需要。此工作流程假设您是日语的翻译人员。

您从 doc/rdoc.pot 创建 locale/ja/rdoc.po。您可以使用 GNU gettext 提供的 msginit 或 gettext gem 提供的 rmsginit。此工作流程使用 gettext gem,因为它比 Rubyists 的 GNU gettext 更便携。 Gettext gem 由纯 Ruby 实现。

% gem install gettext
% mkdir -p locale/ja
% rmsginit --input doc/rdoc.pot --output locale/ja/rdoc.po --locale ja

翻译 .po 中的消息

您可以使用 PO 文件编辑器翻译 .po 中的消息。 Emacs 用户可以使用 po-mode.el。还有一些 GUI 工具,例如 GTranslator。还有一些 Web 服务,例如 POEditor 和 Tansifex。您可以使用您最喜欢的文本编辑器进行编辑,因为 .po 是一个文本文件。生成本地化文档

您可以使用 locale/ja/rdoc.po 生成本地化文档

% rdoc --locale ja

您可以在 doc/ 中找到日语文档。耶!

更新翻译

当您的应用程序添加或修改了消息时,您需要更新翻译。

您可以通过以下命令行更新 .po

% rdoc --format pot
% rmsgmerge --update locale/ja/rdoc.po doc/rdoc.pot

您编辑 locale/ja/rdoc.po 以翻译新消息。

常量

DESCRIPTION

此生成器的描述

公共实例方法

generate() 单击以切换源代码

将 .pot 写入磁盘。

# File rdoc/generator/pot.rb, line 76
def generate
  po = extract_messages
  pot_path = 'rdoc.pot'
  File.open(pot_path, "w") do |pot|
    pot.print(po.to_s)
  end
end

受保护的实例方法

initialize(store, options) 单击以切换源代码

设置一个新的 .pot 生成器

# File rdoc/generator/pot.rb, line 68
def initialize store, options #:not-new:
  @options    = options
  @store      = store
end