Jump to: navigation, search

Difference between revisions of "I18nTeam"

(Edit OpenStack Document 'pom.xml')
m (People)
(111 intermediate revisions by 25 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
= The I18N Team =
+
= The I18n Team =
 
[[File:Translation.svg|right|150px]]
 
[[File:Translation.svg|right|150px]]
The mission of the OpenStack I18N team is to make OpenStack ubiquitously accessible to people of all language backgrounds, by providing a framework to create high quality translations, recruiting contributors and actively managing and planning the translation process.
+
Internationalization (I18n) is essential to make OpenStack ubiquitous. The mission of OpenStack I18n team is to make OpenStack ubiquitously accessible to people of all language backgrounds, by enhancing OpenStack software internationalization, providing translation, maintaining a translation platform and managing translation process for better quality of outcomes.
 +
 
  
 
''"Internationalization is the process of designing a software application so that it can be adapted to various languages and regions without engineering changes. Localization is the process of adapting internationalized software for a specific region or language by adding locale-specific components and translating text."'' - from wikipedia.
 
''"Internationalization is the process of designing a software application so that it can be adapted to various languages and regions without engineering changes. Localization is the process of adapting internationalized software for a specific region or language by adding locale-specific components and translating text."'' - from wikipedia.
  
The OpenStack I18N team will take responsible for the I18n and L10n of OpenStack. Our work will include:
 
* translation of documentations, messages, websites, and etc.
 
* I18n tests
 
* tools maintenance and enhancements
 
  
= Roles in I18n Team =
+
The OpenStack I18n team will take responsible for the I18n and L10n of OpenStack. Our work will include:
 +
* Translation of documentations, messages, websites, and etc.
 +
* Translation platform maintenance and enhancements
 +
* I18n test
  
We uses Transifex to manage the translation. There are four different roles in a translation project.
 
* [[I18nTeam/Management|Maintainer]]: a person responsible for the whole Project in Transifex, who has full control over all its aspects.
 
* [[I18nTeam/Management|Coordinator]]: a privileged member in a translation team who can help in team management tasks, such as approving new members and reviewing contributions to that language. We also have task coordinators for specific tasks.
 
* [[Documentation/Translation#Contribute_as_a_translator|Member (Translator)]] : a person who can submit translations.
 
* [[Documentation/Translation#Contribute_as_a_reviewer|Reviewer]]: a person who can proofread translations and mark them as reviewed.
 
  
 +
I18n team is using [http://zanata.org/ Zanata] as an open source translation platform. To see I18n team translation plan and priority, please visit:
 +
* OpenStack I18n team Dashboard: https://translate.openstack.org
  
Besides translation, we also have below roles.
+
= Local Translation Teams =
* tool developers: people who develop the scripts and related tools for I18n.
+
* [[I18nTeam/team|List of Local Translation Teams]]
* I18n testers: people who will run the I18n test under different kinds of language settings.
 
  
 
= Contributing =
 
= Contributing =
 +
* I18n team welcomes any kinds of contribution. Please visit and read http://docs.openstack.org/i18n/latest/ for more details on I18n contribution.
  
I18n team welcome any kinds of contribution.
+
= Getting in touch =
You can help to [https://www.transifex.com/projects/p/openstack/ translate] and you can also help to maintain and improve [[I18n/Tools|tools]].
+
See https://docs.openstack.org/i18n/latest/index.html#getting-in-touch
To find out more about works, look at [[I18n/Works |this wiki page]]
 
 
 
== Getting in touch ==
 
 
 
We use [http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n openstack-i18n@lists.openstack.org] as the mailing list. We all hang out on #openstack-translation.
 
 
 
 
 
The I18n team meets on Thursdays at alternating times, please see [[Meetings/I18nTeamMeeting]]
 
 
 
== Team Members ==
 
Lead: Ying Chun "Daisy" Guo (Daisy on IRC)
 
 
 
{| class="wikitable"
 
|-
 
! scope="col"| Language
 
! scope="col"| Coordinators ID
 
! scope="col"| Translators ID
 
|-
 
! scope="row" | Brazilian Portuguese
 
| [https://www.transifex.com/accounts/profile/gabrielcw gabrielcw]
 
|
 
|-
 
! scope="row" | Catalan
 
|
 
|
 
|-
 
! scope="row" | Chinese (China)
 
| [https://www.transifex.com/accounts/profile/daisy.ycguo daisy.ycguo]
 
| [https://www.transifex.com/accounts/profile/yuanpu yuanpu], [https://www.transifex.com/accounts/profile/fifieldt fifieldt]
 
|-
 
! scope="row" | English (Australia)
 
| [https://www.transifex.com/accounts/profile/fifieldt fifieldt]
 
|
 
|-
 
! scope="row" | French
 
| [https://www.transifex.com/accounts/profile/steff00 Steff00], [https://www.transifex.com/accounts/profile/fbureau/ Fdot]
 
|
 
|-
 
! scope="row" | German
 
| [https://www.transifex.com/accounts/profile/alecsoft/ alexsoft]
 
| [https://www.transifex.com/accounts/profile/jaegerandi/ jaegerandi], [https://www.transifex.com/accounts/profile/llaera/ llaera], [https://www.transifex.com/accounts/profile/RedRider/ RedRider]
 
|-
 
! scope="row" | Hindi
 
|
 
|
 
|-
 
! scope="row" | Japanese
 
| [https://www.transifex.com/accounts/profile/ritchey98/ ritchey98] (amotoki on IRC) [https://www.transifex.com/accounts/profile/katomo katomo],
 
| [https://www.transifex.com/accounts/profile/fifieldt fifieldt]
 
|-
 
! scope="row" | Korean
 
| [https://www.transifex.com/accounts/profile/ujuckr/ ujuckr] (ujuc on IRC)
 
| [https://www.transifex.com/accounts/profile/Yeonki/ Yeonki], [https://www.transifex.com/accounts/profile/naleejang/ Nalee Jang], [https://www.transifex.com/accounts/profile/rumfox/ SangHyoung], [https://www.transifex.com/accounts/profile/JayLee/ Jay Lee], [https://www.transifex.com/accounts/profile/funfunyoo/ FunFun Yoo], [https://www.transifex.com/accounts/profile/MKJung/ Man-Ki Jung], [https://www.transifex.com/accounts/profile/bluejay.kr/ James Ahn], [https://www.transifex.com/accounts/profile/cdecide/ Shin Seung Ho], [https://www.transifex.com/accounts/profile/hyunsun/ Hyunsun Moon], [https://www.transifex.com/accounts/profile/ikhwan/ Ikhwan Koo], [https://www.transifex.com/accounts/profile/jaeyeun97/ Jaeyeun Charlie Yoon], [https://www.transifex.com/accounts/profile/yisukwon/ Yi Su Kwon], [https://www.transifex.com/accounts/profile/%EC%A0%95%EC%9D%B4%EC%8A%AC/ Leeseul Jung]
 
|-
 
! scope="row" | Polish
 
|
 
| [https://www.transifex.com/accounts/profile/deejay1/ DeeJay1]
 
|-
 
! scope="row" | Russian
 
| [https://www.transifex.com/accounts/profile/adiantum/ adiantum]
 
| [https://www.transifex.com/accounts/profile/eshumakher eshumakher]
 
|-
 
! scope="row" | Spanish
 
| [https://www.transifex.com/accounts/profile/mariantb/ mariantb]
 
| [https://www.transifex.com/accounts/profile/ladquin/ ladquin], [https://www.transifex.com/accounts/profile/vkmc/ vkmc], [https://www.transifex.com/accounts/profile/alberto.molina/ alberto.molina], [https://www.transifex.com/accounts/profile/aloga/ aloga], [https://www.transifex.com/accounts/profile/rodrigoauditore/ rodrigoauditore], [https://www.transifex.com/accounts/profile/rvegagom/ rvegagom], [https://www.transifex.com/accounts/profile/smarturo/ smarturo], [https://www.transifex.com/accounts/profile/vicdiaz/ vicdiaz], [https://www.transifex.com/accounts/profile/Makika/ Makika], [https://www.transifex.com/accounts/profile/toote/ toote], [https://www.transifex.com/accounts/profile/electrocucaracha/ electrocucaracha], [https://www.transifex.com/accounts/profile/heleno.jimenez/ heleno.jimenez]
 
|-
 
! scope="row" | Vietnamese
 
| [https://www.transifex.com/accounts/profile/DTT/ Hang Tran],[https://www.transifex.com/accounts/profile/ppanhh/ Anh Phan], [https://www.transifex.com/accounts/profile/NguyenTien/ Tien Nguyen], [https://www.transifex.com/accounts/profile/giangdt/ Giang Duong]
 
| [https://www.transifex.com/accounts/profile/HoangNguyen/ Hoang Nguyen], [https://www.transifex.com/accounts/profile/HaMai/ Mai Thuy Ha], [https://www.transifex.com/accounts/profile/bvqbao/ Bui Vo Quoc Bao], [https://www.transifex.com/accounts/profile/chienbinhIT/ Nguyen Ba Cat], [https://www.transifex.com/accounts/profile/dontung/ Don Tung], [https://www.transifex.com/accounts/profile/ducito/ Nguyen Ngoc Duc], [https://www.transifex.com/accounts/profile/hoangvudtu/ Hoang Vu], [https://www.transifex.com/accounts/profile/huteduvn/ Tong Manh Cuong], [https://www.transifex.com/accounts/profile/lehoainam/ Le Hoai Nam], [https://www.transifex.com/accounts/profile/ninhhv/ Ha Van Ninh], [https://www.transifex.com/accounts/profile/quang.tran/ Tran Viet Quang], [https://www.transifex.com/accounts/profile/oss/ Pham Tuan Anh], [https://www.transifex.com/accounts/profile/quangnn/ Quang Nguyen], [https://www.transifex.com/accounts/profile/sujarot/ Nguyen Thanh Vinh], [https://www.transifex.com/accounts/profile/trandung11/ Tran Dung], [https://www.transifex.com/accounts/profile/trungdungdtu/ Trung Dung], [https://www.transifex.com/accounts/profile/vina007/ Tam]
 
 
 
|-
 
|}
 
 
 
= How to =
 
 
 
* The characters of my language cannot be displayed correctly when generating PDF and HTML documents. How to support font of my language?
 
 
 
 
 
The PDF and HTML are generated by maven plugin from DocBook. The problem is caused that the font is not supported by this maven plugin. You can resolve this problem by following actions:
 
=== Way 1: Add font for clouddocs-maven-plugin. ===
 
==== Edit [https://github.com/rackerlabs/clouddocs-maven-plugin clouddocs-maven-plugin] ====
 
Clone clouddocs-maven-plugin
 
<pre><nowiki>
 
git clone https://github.com/rackerlabs/clouddocs-maven-plugin
 
</nowiki></pre>
 
 
 
 
 
'''Add font file at'''
 
<pre><nowiki>
 
clouddocs-maven-plugin/src/main/resources/fonts/
 
</nowiki></pre>
 
My add
 
<pre><nowiki>
 
clouddocs-maven-plugin/src/main/resources/fonts/nanum-font/
 
</nowiki></pre>
 
 
 
 
 
'''Edit'''
 
<pre><nowiki>
 
clouddocs-maven-plugin/src/main/resources/cloud/fo/docbook.xsl
 
</nowiki></pre>
 
my edit 'ko', 'ko_KR'
 
<pre><nowiki>
 
  <xsl:param name="rackspace.font">
 
    <xsl:choose>
 
      <xsl:when test="starts-with(/*/@xml:lang, 'zh')">AR-PL-New-Sung</xsl:when>
 
      <xsl:when test="starts-with(/*/@xml:lang, 'ja')">TakaoGothic</xsl:when>
 
      <xsl:when test="starts-with(/*/@xml:lang, 'ko')">NanumGothic</xsl:when>
 
      <xsl:when test="starts-with(/*/@xml:lang, 'ko_KR')">NanumGothic</xsl:when>
 
      <xsl:otherwise>CartoGothic Std</xsl:otherwise>
 
    </xsl:choose>
 
  </xsl:param>
 
 
 
  <xsl:param name="monospace.font.family">
 
    <xsl:choose>
 
      <xsl:when test="starts-with(/*/@xml:lang, 'zh')">AR-PL-New-Sung</xsl:when>
 
      <xsl:when test="starts-with(/*/@xml:lang, 'ja')">TakaoGothic</xsl:when>
 
      <xsl:when test="starts-with(/*/@xml:lang, 'ko')">NanumGothicCoding</xsl:when>
 
      <xsl:when test="starts-with(/*/@xml:lang, 'ko_KR')">NanumGothicCoding</xsl:when>
 
      <xsl:otherwise>monospace</xsl:otherwise>
 
    </xsl:choose>
 
  </xsl:param>
 
</nowiki></pre>
 
 
 
'''Edit version name'''
 
<pre><nowiki>
 
clouddocs-maven-plugin/pom.xml
 
</nowiki></pre>
 
<pre><nowiki>
 
<version>1.9.4-SNAPSHOT-ko</version>
 
</nowiki></pre>
 
 
 
 
 
'''OutPut'''
 
<pre><nowiki>
 
mvn clean install
 
</nowiki></pre>
 
 
 
 
 
'''Add 'clouddocs-maven-plugn/target/clouddocs-maven-plugin-1.9.4-SNAPSHOT-ko.pom''''
 
* Copy [http://maven.research.rackspacecloud.com/content/groups/public/com/rackspace/cloud/api/clouddocs-maven-plugin/1.9.4-SNAPSHOT/clouddocs-maven-plugin-1.9.4-20130914.192904-9.pom clouddocs-maven-plugin-1.9.4-SNAPSHTO.pom]
 
* edit '<version>1.9.4-SNAPSHOT</version>' -> '<version>1.9.4-SNAPSHOT-ko</version>
 
 
 
==== Edit OpenStack Document 'pom.xml' ====
 
 
 
'os.ujuc.kr' is my test server address.
 
 
 
'''Original'''
 
<pre><nowiki>
 
    <id>Rackspace Research Repositories</id>
 
      <activation>
 
        <activeByDefault>true</activeByDefault>
 
      </activation>
 
      <repositories>
 
        <repository>
 
          <id>rackspace-research</id>
 
          <name>Rackspace Research Repository</name>
 
          <url>http://maven.research.rackspacecloud.com/content/groups/public/</url>
 
        </repository>
 
      </repositories>
 
      <pluginRepositories>
 
        <pluginRepository>
 
          <id>rackspace-research</id>
 
          <name>Rackspace Research Repository</name>
 
          <url>http://maven.research.rackspacecloud.com/content/groups/public/</url>
 
      </pluginRepository>
 
      </pluginRepositories>
 
    </profile>
 
  </profiles>
 
 
 
  <build>
 
    <resources>
 
      <resource>
 
        <directory>target/docbkx/pdf</directory>
 
        <excludes>
 
          <exclude>**/*.fo</exclude>
 
        </excludes>
 
      </resource>
 
    </resources>
 
    <plugins>
 
 
 
      <plugin>
 
        <groupId>com.rackspace.cloud.api</groupId>
 
        <artifactId>clouddocs-maven-plugin</artifactId>
 
        <version>1.8.1-SNAPSHOT</version>
 
        <executions>
 
          <execution>
 
            <id>goal1</id>
 
            <goals>
 
</nowiki></pre>
 
  
 +
= People =
  
'''Edit'''
+
* PTL: [https://www.openstack.org/community/members/profile/45058/frank-kloeker Frank Kloeker] (Queens, eumel8 on IRC), [https://www.openstack.org/community/members/profile/28546/iany-choi Ian Y. Choi] (Ocata, Pike, ianychoi on IRC), [https://www.openstack.org/community/members/profile/16748/tomoyuki-kato KATO Tomoyuki] (Newton, katomo on IRC), [https://www.openstack.org/community/members/profile/2736/yingchun-guo Ying Chun "Daisy" Guo] (Mitaka, Daisy on IRC), 
<pre><nowiki>
+
* I18n team core reviewers: https://review.openstack.org/#/admin/groups/1132,members  (login is needed)
    <id>Korea team</id>
+
* All language coordinators, translators, and reviewers: https://translate.openstack.org/language/list
      <activation>
+
* Zanata development team: [https://www.openstack.org/community/members/profile/35554/carlos-munoz Carlos Munoz], [https://www.openstack.org/community/members/profile/35306/alex-eng Alex Eng], [https://www.openstack.org/community/members/profile/39981/patrick-huang Patrick Huang]
        <activeByDefault>true</activeByDefault>
+
* All ATCs: http://governance.openstack.org/reference/projects/i18n.html#extra-atcs
      </activation>
+
* And many other members from Infrastructure, Documentation, and other OpenStack projects with kind help
      <repositories>
+
** I18n team liaisons: https://wiki.openstack.org/wiki/CrossProjectLiaisons#I18n
        <repository>
 
          <id>korea-team</id>
 
          <name>Korea team</name>
 
          <url>http://os.ujuc.kr/clouddocs-maven-plugin/target/</url>
 
        </repository>
 
      </repositories>
 
      <pluginRepositories>
 
        <pluginRepository>
 
          <id>korea-team</id>
 
          <name>Korea team</name>
 
          <url>http://os.ujuc.kr/clouddocs-maven-plugin/target/</url>
 
      </pluginRepository>
 
      </pluginRepositories>
 
    </profile>
 
  </profiles>
 
  
  <build>
+
= Related pages =
    <resources>
 
      <resource>
 
        <directory>target/docbkx/pdf</directory>
 
        <excludes>
 
          <exclude>**/*.fo</exclude>
 
        </excludes>
 
      </resource>
 
    </resources>
 
    <plugins>
 
  
      <plugin>
+
* [[Translations/Infrastructure]]
        <groupId>com.rackspace.cloud.api</groupId>
+
* [[Translations]]
        <artifactId>clouddocs-maven-plugin</artifactId>
+
----
        <!-- <version>1.8.1-SNAPSHOT</version> -->
 
        <version>1.9.4-SNAPSHOT-ko</version>
 
        <executions>
 
          <execution>
 
            <id>goal1</id>
 
            <goals>
 
</nowiki></pre>
 
  
'''End'''
+
{{Special:PrefixIndex/I18nTeam}}
[http://os.ujuc.kr/openstack-manuals/generated/ko_KR/basic-install/target/docbkx/webhelp/grizzly/basic-install/apt/openstack-basic-install-apt-grizzly.pdf View Korean font PDF]
 
  
=== Way 2: Use local font. ===
+
----
 +
[[category: Horizontal_Team]]
 +
[[Category:I18n]]

Revision as of 05:41, 18 August 2017

The I18n Team

Translation.svg

Internationalization (I18n) is essential to make OpenStack ubiquitous. The mission of OpenStack I18n team is to make OpenStack ubiquitously accessible to people of all language backgrounds, by enhancing OpenStack software internationalization, providing translation, maintaining a translation platform and managing translation process for better quality of outcomes.


"Internationalization is the process of designing a software application so that it can be adapted to various languages and regions without engineering changes. Localization is the process of adapting internationalized software for a specific region or language by adding locale-specific components and translating text." - from wikipedia.


The OpenStack I18n team will take responsible for the I18n and L10n of OpenStack. Our work will include:

  • Translation of documentations, messages, websites, and etc.
  • Translation platform maintenance and enhancements
  • I18n test


I18n team is using Zanata as an open source translation platform. To see I18n team translation plan and priority, please visit:

Local Translation Teams

Contributing

Getting in touch

See https://docs.openstack.org/i18n/latest/index.html#getting-in-touch

People

Related pages