You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openoffice.apache.org by bu...@apache.org on 2014/07/26 20:58:39 UTC
svn commit: r917522 - in /websites/staging/openoffice/trunk/content: ./
website-native.html
Author: buildbot
Date: Sat Jul 26 18:58:39 2014
New Revision: 917522
Log:
Staging update by buildbot for openoffice
Modified:
websites/staging/openoffice/trunk/content/ (props changed)
websites/staging/openoffice/trunk/content/website-native.html
Propchange: websites/staging/openoffice/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Sat Jul 26 18:58:39 2014
@@ -1 +1 @@
-1613586
+1613705
Modified: websites/staging/openoffice/trunk/content/website-native.html
==============================================================================
--- websites/staging/openoffice/trunk/content/website-native.html (original)
+++ websites/staging/openoffice/trunk/content/website-native.html Sat Jul 26 18:58:39 2014
@@ -21,7 +21,7 @@
<meta name="google-site-verification" content="wIHUbgA-JO5PaJHpR5jeI8N9E2y2iF94o4oUwpaAdk8" />
<link href="/css/ooo.css" rel="stylesheet" type="text/css">
-<title></title>
+<title>How to edit the Native Language (NL) Websites?</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<script type="text/javascript">
@@ -97,18 +97,18 @@
</div>
<div id="contenta">
-
+ <h1 class="title">How to edit the Native Language (NL) Websites?</h1>
<h2 id="native-language-nl-websites">Native Language (NL) Websites</h2>
<p>Apache OpenOffice supports users around the world via our many OpenOffice localizations, via
-native language mailing lists and support forums, and by translations of our website. This
-page describes the steps to create and maintain an NL website. Following these steps you
-can create a website translation like our <a href="http://www.openoffice.org/es">Spanish</a>,
-<a href="http://www.openoffice.org/tr">Turkish</a> or <a href="http://www.openoffice.org/nl">Dutch</a> websites. </p>
-<p>Making updates to the Apache OpenOffice project's websites is simple. It's even easy
+native language mailing lists and support forums, and by translations of our website. This
+page describes the steps to create and maintain an NL website. Following these steps you
+can create a website translation like our <a href="http://www.openoffice.org/es/">Spanish</a>,
+<a href="http://www.openoffice.org/tr/">Turkish</a> or <a href="http://www.openoffice.org/nl/">Dutch</a> websites. </p>
+<p>Making updates to the Apache OpenOffice project's websites is simple. It's even easy
for non-committers (new contributors - like you) to create a patch to request that
pages are updated by the project community.</p>
<h2 id="the-xx-website">The XX Website</h2>
-<p>The easiest way to get started is with the <a href="http://www.openoffice.org/xx">XX website</a>.This
+<p>The easiest way to get started is with the <a href="http://www.openoffice.org/xx/">XX website</a>.This
website is a extract of the most-commonly visited pages from the English website, including:</p>
<ul>
<li>The home page</li>
@@ -121,36 +121,45 @@ website is a extract of the most-commonl
want to translate.</p>
<h2 id="creating-the-test-directory">Creating the Test Directory</h2>
<p>In many cases there will already be an NL website for your language, but perhaps one that is
-badly out-of-date or is non-standard. However, until your new translation is ready to go it
-is probably best not to wipe out the existing NL page. So initially you will probably want
+badly out-of-date or is non-standard. However, until your new translation is ready to go it
+is probably best not to wipe out the existing NL page. So initially you will probably want
to do your work in a test directory.</p>
-<p>Let's take an example. Suppose your target language is Italian (it). You will want to do
-the following. If you are not a Committer and are not familiar with Subversion then you will
-want to get help with these steps by asking on the mailing list.</p>
+<p><strong>Let's take an concreate example:</strong>
+<br />
+Suppose your target language is Italian (it). You will want to do
+the following. If you are not a Committer and are not familiar with Subversion then you
+will want to get help with these steps by asking on the mailing list.</p>
<ol>
-<li>Make a copy (svn copy) of the <a href="https://svn.apache.org/repos/asf/openoffice/ooo-site/trunk/content/xx/">ooo-site/trunk/content/xx directory</a>
- as ooo-site/trunk/content/test-it. In the copy replace all instances of "/xx"
-in paths with "/test-it".</li>
-<li>Also make a copy of <a href="https://svn.apache.org/repos/asf/openoffice/ooo-site/trunk/templates/xx/">ooo-site/trunk/templates/xx</a>
+<li>Make a copy (svn copy) of the
+<a href="https://svn.apache.org/repos/asf/openoffice/ooo-site/trunk/content/xx/">ooo-site/trunk/content/xx directory</a>
+as ooo-site/trunk/content/test-it. In the copy replace all instances of "/xx" in paths,
+files and also within files with "/test-it".</li>
+<li>Also make a copy of
+<a href="https://svn.apache.org/repos/asf/openoffice/ooo-site/trunk/templates/xx/">ooo-site/trunk/templates/xx</a>
and call the copy ooo-site/trunk/templates/test-it.</li>
<li>Commit these changes and publish via the CMS</li>
-<li>If you are a committer then you can translate the contents of the files in /test-it locally
-or via the CMS, whatever you prefer. If you are not a committer than ask someone to do an
-"svn export" of the new /test-it and send a ZIP file of the contents.</li>
+<li>If you are a committer then you can translate the contents of the files in /test-it
+locally or via the CMS, whatever you prefer. If you are not a committer than ask someone
+to do an "svn export" of the new /test-it and send a ZIP file of the contents.</li>
</ol>
+<p><strong>Important:</strong>
+<br />
+In any case, the complete "/xx" directory and its files are used as a template.
+Please always copy it to a different location first before you start any editing!</p>
<h2 id="translating-the-website">Translating the Website</h2>
<p>The files will be in two main formats: </p>
<ol>
<li>HTML files.</li>
-<li>Markdown text files. You can read more about Markdown Text <a href="http://daringfireball.net/projects/markdown/basics">here</a>.</li>
+<li>Markdown text files.
+<a href="http://daringfireball.net/projects/markdown/basics">Need to know more about Markdown Text?</a></li>
</ol>
-<p>In your translation, do not change the file or directory names. Be careful to preserve the
-markup of the HTML and the indentation levels of the MDText files.</p>
+<p>In your translation, do not change the file or directory names. Be careful to preserve
+the markup of the HTML and the indentation levels of the MDText files.</p>
<h2 id="the-template">The Template</h2>
-<p>You will notice that there is more on the openoffice.org website than what you see in the
-/test-it content files. The content files give the central part of each page, but the header,
-footer as well as navigation menus are generated by the template. There are special MDText
-files that you will need to translate for the template. They are:</p>
+<p>You will notice that there is more on the openoffice.org website than what you see in the
+/test-it content files. The content files give the central part of each page, but the
+header, footer as well as navigation menus are generated by the template. There are special
+MDText files that you will need to translate for the template. They are:</p>
<ul>
<li>/xx/topnav.mdtext</li>
<li>/xx/why/leftnav.mdtext</li>
@@ -164,53 +173,107 @@ files that you will need to translate fo
</pre></div>
-<p>Here you should translate the words "Product", "Download" and "Support". Also, at the
+<p>Here you should translate the words "Product", "Download" and "Support". Also, at the
bottom of the file you will see hyperlinks, which should not be changed, and text hints for
the hyperlinks which should be translated.</p>
-<p>A special word about brand.mdtext. This contains several values that control the overall
-branding on the website. The name and logo must not be changed, since these are our
-trademarks, but the "tagline" can be translated. Note also the announcement and
-announcementurl fields. These control the blue announcement that is the top of every website
-page. That should be translated and the URL changed if needed. For example, in a new release
-you would want to point to a translated version of the release notes, if they exist.</p>
+<p>A special word about brand.mdtext. This contains several values that control the overall
+branding on the website. The name and logo must not be changed, since these are our
+trademarks, but the "tagline" can be translated. Note also the announcement and
+announcement url fields. These control the blue announcement that is the top of every
+website page. That should be translated and the URL changed if needed. For example, in a
+new release you would want to point to a translated version of the release notes, if they
+exist.</p>
<h2 id="other-hints">Other Hints</h2>
<p>A few other things to watch out for.</p>
<ol>
-<li>Some files contain an Apache License header at the top of the page. You should not translate that.</li>
-<li>Some files contain comments. These don't need to be translated, but no harm is done if they are.</li>
-<li>The /download/index.html requires special care since some of the language strings are within
-Javascript blocks. Ask for help if you need it here.</li>
-<li>It is easy to miss the social networking messages in /download/index.html. These are in the HTML
-header block and in function shareTwitter(). The string is something like "Join the OpenOffice revolution, the free office productivity suite with over 60 million trusted downloads."<br />
-You should translate these, but adapt if needed to keep the Twitter string within the 140 limit for Twitter.</li>
+<li>Some files contain an Apache License header at the top of the page. You should not
+translate that.</li>
+<li>Some files contain comments. These don't need to be translated, but no harm is done if
+they are.</li>
+<li>The /download/index.html requires special care since the language strings are stored in
+a the separate Javascript file "msg_prop_l10n_xx.js". The file "index.html" contains only
+the variables. Look for the further section if you need more help on this.</li>
+<li>It is easy to miss the social networking messages in /download/index.html.
+These are in the HTML header block and in function shareTwitter(). The string is something
+like "Join the OpenOffice revolution, the free office productivity suite with over 100
+million trusted downloads."
+You should translate these, but adapt if needed to keep the Twitter string within the 140
+limit for Twitter.</li>
</ol>
+<h2 id="how-to-find-the-right-text-for-the-file-at-the-right-place">How to find the right text for the file at the right place?</h2>
+<p>All texts, mouse over titles and link URLs that can be localized are collected in the
+"msg_prop_l10n_xx.js" files. The variables are named and sorted via the sections they are
+displayed in and have also comments to keep the overview.</p>
+<p><strong>Example:</strong>
+<br />
+// Extensions: Strings in the blue box (top) (used in "index.html").
+<br />
+Here the text for the headline in the blue box for the extensions is stored:
+<br />
+l10n.dl_ext_blue_box_headline_text = "Get Apache OpenOffice Extensions and Dictionaries";</p>
+<p>Please note that not all text is always displayed. Some are only shown in case of errors to
+handle a special behavior.</p>
+<p><strong>Example:</strong>
+<br />
+// Download: Strings for error text in the sub-red box (used in "download.js").
+<br />
+Here the text for the left download button is shown when the selected options do not lead to
+a correct download:
+<br />
+l10n.dl_full_link_error_text = "No full installation available";</p>
+<h2 id="you-can-see-the-variables-and-text-but-cannot-find-the-respective-files">You can see the variables and text but cannot find the respective file(s)?</h2>
+<p>The "msg_prop_l10n_xx.js" files contains already a lot of strings. But it is maybe not
+wished to localize everything that is existing. So, we can keep the "/xx" example section
+small.</p>
+<p>For example, the following variables point to files that are not existing yet. You have to
+create them first:</p>
+<p>l10n.dl_analyze_headline_text = "How to report a broken download link?";
+<br />
+--> "analyze.html"</p>
+<p>l10n.dl_help_link = "http://www.openoffice.org/download/full_vs_lp.html";
+<br />
+--> "full_vs_lp.html"</p>
+<p>Also many links in the navigation bar referes to global webpages.</p>
<h2 id="nl-specific-content">NL-Specific Content</h2>
-<p>It may be desired to add language-specific custom content to the website. For example:</p>
+<p>It may be desired to add language-specific custom content to the website. For example:</p>
<ul>
<li>A localized Arabic website might want a special page dedicated to a description of how
-to use the bidirectional text features in OpenOffice. The Tamil website might want a page
+to use the bidirectional text features in OpenOffice. The Tamil website might want a page
that links to a particular open source font download that is recommended.</li>
<li>There may be a local OpenOffice-related event that you want to publicize.</li>
</ul>
-<p>New content pages can be added to your NL directory and links page from a navigator or from
-a news article on the home page as appropriate.</p>
+<p>New content pages can be added to your NL directory and links page from a navigator or
+from a news article on the home page as appropriate.</p>
<h2 id="after-translation">After Translation</h2>
-<p>Once your translation is done, you can check it in (if you are a committer) or ask someone to help
-you check it in and publish it to the website. Review the published pages to verify that the
-translation is as you want it, and that all links work. Once it is ready you can rename your
-"test" directory and make it the new NL website for your language!</p>
-<p>Please Note: If there is an existing NL website it is recommended that you do the switch over like this:</p>
+<p>Once your translation is done, you can check it in (if you are a committer) or ask someone
+to help you check it in and publish it to the website. Review the published pages to verify
+that the translation is as you want it, and that all links work. Once it is ready you can
+rename your "test" directory and make it the new NL website for your language!</p>
+<p><strong>Please Note:</strong>
+<br />
+If there is an existing NL website it is recommended that you do the switch
+over like this:</p>
<ol>
-<li>First delete the existing NL page, e.g., svn del /it. Commit and publish that change.</li>
-<li>Then rename the content/test-it directory, e.g., svn move content/test-it content/it. </li>
+<li>First delete the existing NL page, e.g., svn del /it. Commit and publish that change.</li>
+<li>Then rename the content/test-it directory, e.g., svn move content/test-it content/it.</li>
<li>Also rename the templates/test-it to /templates/it</li>
<li>Commit these changes and commit them via the CMS</li>
</ol>
-<p>This order is recommended, with the commit and publish after the deletion of the old directory,
-due to a CMS build issue we've run into if all these steps are done together in a single commit.</p>
+<p>This order is recommended, with the commit and publish after the deletion of the old
+directorym due to a CMS build issue we've run into if all these steps are done together in
+a single commit.</p>
<h2 id="maintaining-nl-websites">Maintaining NL Websites</h2>
-<p>Do try to check your NL website every few weeks to see if any changes are needed. Try to keep it in sync
-with the English website. Is there a new announcement header? A new release? A new blog post?</p>
+<p>Do try to check your NL website every few weeks to see if any changes are needed. Try to
+keep it in sync with the English website. Is there a new announcement header? A new
+release? A new blog post?</p>
+<h2 id="you-got-stuck-and-need-help">You got stuck and need help?</h2>
+<p>You can always refer to the global webpages at "http://www.openoffice.org/". The directory
+and file structure is the same.</p>
+<h2 id="you-need-a-helping-hand">You need a helping hand?</h2>
+<p>You can get in contact with us via the
+<a href="http://openoffice.apache.org/mailing-lists.html#localization-mailing-list-public">L10N mailing list</a>.
+See the general explaination for
+<a href="http://openoffice.apache.org/mailing-lists.html#using-mailing-lists">what a mailing list is</a>.</p>
</div>
<div id="footera">