生成本地化 javadoc

发布于 2024-10-29 21:41:15 字数 93 浏览 4 评论 0原文

我想知道是否有一种生成本地化 javadoc 的简单方法:我想翻译(例如法语)标题和关键字,而不是 html 中的“return”、“parameter”、“class”。

I would like to know if there was a simple way of generating localized javadoc : I would like to have translated (for example in french) title and keywords instead of "return", "parameter", "class" in the html.

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(2

守不住的情 2024-11-05 21:41:16

正如 Matt Ball 所说,您可以向 javadoc 提供 -locale 选项来影响某些事情。问题在于,tools.jar 仅包含默认的英语以及另外一种日语 (ja) 和一种中文 (cn_ZH) 翻译。

我刚刚尝试了中文版,它有效:它写的是发送:JSchException,而不是Throws:JSchException

因此,您必须将这些内容翻译成您的语言(如果您不想要其中之一)。

几年前,我为当时的版本(1.2 或此类)创建了这些资源的世界语翻译,如果您有兴趣,我可以将它们挖掘出来。 (但现在他们似乎正在使用另一种格式。)

As said by Matt Ball, you can provide the -locale option to javadoc to influence some things. The problem is that tools.jar only contains the default English and additionally one Japanese (ja) and one Chinese (cn_ZH) translation.

I just tried the Chinese one, and it works: it writes 抛出: JSchException instead of Throws: JSchException.

So you would have to translate these to your language (if you don't want one of these).

Some years ago I created an Esperanto translation of those resources for the then-current version (1.2 or such), if you are interested I could dig them out. (But it seems now they are using another format.)

憧憬巴黎街头的黎明 2024-11-05 21:41:16

有javadoc -locale< /code>选项,尽管我不确定它是否会更改 returnclass 等关键字。 Java 中只有一组非本地化的关键字,因此我认为无论如何更改 JavaDoc 中的这些关键字是没有意义的。

指定 javadoc 在生成文档时使用的区域设置。参数是区域设置的名称,如 java.util.Locale 文档中所述,例如 en_US(英语,美国)或 en_US_WIN(Windows 变体)。< /p>

指定区域设置会导致 javadoc 为消息选择该区域设置的资源文件(导航栏中的字符串、列表和表格的标题、帮助文件内容、stylesheet.css 中的注释等)。它还指定按字母顺序排序的列表的排序顺序,以及确定第一个句子结尾的句子分隔符。它无法确定文档类的源文件中指定的文档注释文本的区域设置。

There is the javadoc -locale option, though I'm not sure that it changes keywords like return and class. There is only one, non-localized set of keywords in Java, so I don't think it makes sense to alter those in the JavaDocs anyway.

Specifies the locale that javadoc uses when generating documentation. The argument is the name of the locale, as described in java.util.Locale documentation, such as en_US (English, United States) or en_US_WIN (Windows variant).

Specifying a locale causes javadoc to choose the resource files of that locale for messages (strings in the navigation bar, headings for lists and tables, help file contents, comments in stylesheet.css, and so forth). It also specifies the sorting order for lists sorted alphabetically, and the sentence separator to determine the end of the first sentence. It does not determine the locale of the doc comment text specified in the source files of the documented classes.

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文