How to Translate OpenSolaris Manual Pages

compared with
Current by Reiko
on Nov 12, 2009 21:32.

Key
This line was removed.
This word was removed. This word was added.
This line was added.

Changes (22)

View page history
[#Let''s [#Let us Translate OpenSolaris manual pages]
[#Which manual pages to translate]
[#Working Table]
[#How to Review]
[#After Review]
[#What\'s PO file]
[#What is PO file]
[#Translation Guideline]
h2. {anchor:Let''s {anchor:Let us Translate OpenSolaris manual pages}Let's Translate OpenSolaris manual pages!

For Japanese, please go to [OpenSolaris マニュアルページを翻訳しよう!]
This is the first attempt to translate OpenSolaris manual pages. The source of the manual pages are originally in .roff format. However, *.roff* includes many tags and not translator-friendly :-) So, we converted *.roff* to *.po* and use *.po* for the translation base. Once you complete the translation, we convert them back to *.roff*. You can either replace manual page files with translated *.roff* files on your OpenSolaris system, or wait for OpenSolaris binary is updated with translated files.
This is the attempt to translate OpenSolaris manual pages. Once you complete the translation, we convert them back to manpages and include them in a new build of OpenSolaris.

h2. {anchor:Which manual pages to translate}Which manual pages to translate ?

* 1st candidate for translation: [1st List]
* 2nd candidate for translation: [2nd List]
* Complete list of un-translated manual pages: [Full List|http://wikis.sun.com/download/attachments/48123559/untrans.all] (4378 files)
h2. {anchor:How to Translate}How to Translate
# Submit SCA from [Sun Contributor Agreement page|http://jp.opensolaris.org/os/about/sun_contributor_agreement/].
# Send SCA number to Reiko at reiko-dot-saito-at-sun.com.
We will use [CTI|https://translate.sun.com] for translation. No need to download an application and use it on your desktop. CTI is a browser-based translation editor.

# Register for [CTI|https://translate.sun.com] and get an account.
# Select a manpage you want to translate from [Working Table] and let your contact know.

If you want to edit [Working Table] yourself, follow the steps below:
# Create your wiki account from *Log In* link at the top right of this page, or from [https://reg.sun.com/register?goto=http%3A%2F%2Fwikis.sun.com%2Fdisplay%2FHelp%2FRegistering].
# Enter your name to Translator column in [Working Table].
# Change Status in [Working Table] to "Trans started (mm/dd)".
# Translate "xx.po" on wiki or off-line --- Click Edit, save the contents as a file, replace English on "msgstr" line to your language, and copy&paste the contents to Edit window of wiki.
# Change Status in Working Table to "Trans done".

h3. {anchor:How to Review}How to Review
# Submit SCA from [Sun Contributor Agreement page|http://jp.opensolaris.org/os/about/sun_contributor_agreement/].
# Send SCA number to Reiko at reiko-dot-saito-at-sun.com.
# Create your wiki account from *Log In* link at the top right of this page, or from [https://reg.sun.com/register?goto=http%3A%2F%2Fwikis.sun.com%2Fdisplay%2FHelp%2FRegistering].
# Enter your name to Reviewer column in Working Table below.
# Change Status in Working Table to "Review started (mm/dd)".
# Review "xx.po" on wiki or off-line - Edit .po file to change the translation and add Comments (See Example).
# Change Status in Working Table to "Review done (mm/dd)".
 
Example:
# Register for [CTI|https://translate.sun.com] and get an account.
# Select a manpage you want to review from [Working Table] and let your contact know.
 
{noformat}
# type: Plain text
#: man1/elfwrap.1:24
#, fuzzy
# Comment: <ELF> の前の B が抜けていたので追加しました。
msgid "elfwrap - wrap data in an B<ELF> file"
msgstr "elfwrap - B<ELF> ファイルにデータをラップする"
{noformat}
h2. How to Translate on CTI
 
h2. {anchor:After Review}After Review
* Source and target language segments appear side by side on CTI editor. Same translation leveraged from the past translation is already inserted to the target segments, if available.
 
# Translator can compare the versions from "*Tools*" -> *History* -> *Compare Selected versions*.
# If you agree, update TM (if any), and send it to reiko-dot-saito-at-sun-dot-com. Otherwise, let's discuss on mailing list (g11n-ja-discuss).
* Translate only the blank cells. To show only the new translation, use the pull down menu called "Show me" on the top right of CTI editor.
 
h2. {anchor:What's PO file}What\'s PO file ?
* Please make sure to click Save before you go to another page. Otherwise, all of your edits will be lost.
 
PO file looks like this:

{noformat}
# type: Plain text
#: man1/elfwrap.1:24
#, fuzzy
msgid "elfwrap - wrap data in an B<ELF> file"
msgstr "elfwrap - wrap data in an B<ELF> file"
{noformat}

msgid is the source string, and msgstr is the target string which needs translation. After the translation, they look like this:

{noformat}
# type: Plain text
#: man1/elfwrap.1:24
#, fuzzy
msgid "elfwrap - wrap data in an B<ELF> file"
msgstr "elfwrap - B<ELF> ファイルにデータをラップする"
{noformat}

*NOTE:* B<xxx> or I<xxx> is the formatting tag to specify the type-face of the text (B for Bold and I for Italics). For example, "B<ELF> file" will be represented as "*ELF* file", and "I<variable>" will be _variable_.

*NOTE 2:* DO NOT TRANSLATE "noformat" within curly-brackets, which are located at the top and the end of each .po file contents. They are the markup to display the po file contents as they are (instead of interpreting the symbols as wiki markup).
h2. {anchor:Translation Guideline}Translation Guideline

The individuals who post here are part of the extended Sun Microsystems community and they might not be employed or in any way formally affiliated with Sun Microsystems. The opinions expressed here are their own, are not necessarily reviewed in advance by anyone but the individual authors, and neither Sun nor any other party necessarily agrees with them.

Copyright 1994-2009 Sun Microsystems, Inc.
Powered by Atlassian Confluence
Sun Guidelines on Public Discourse Privacy Policy Terms of Use Trademarks Site Map Employment Investor Relations Contact