"Fossies" - the Fresh Open Source Software Archive

Member "developer/translation.html" (22 Nov 2019, 13660 Bytes) of package /linux/www/geoserver-2.16.1-htmldoc.zip:


The requested HTML page contains a <FORM> tag that is unusable on "Fossies" in "automatic" (rendered) mode so that page is shown as HTML source code syntax highlighting (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    2   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-US">
    4 <head>
    5   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    6   
    7   <title>Translating GeoServer &mdash; GeoServer 2.16.1 Developer Manual</title>
    8   <link rel="stylesheet" href="_static/blueprint/screen.css" type="text/css" media="screen, projection" />
    9   <link rel="stylesheet" href="_static/blueprint/print.css" type="text/css" media="print" /> 
   10   <!--[if IE]>
   11   <link rel="stylesheet" href="_static/blueprint/ie.css" type="text/css" media="screen, projection" />
   12   <![endif]-->
   13   <link rel="stylesheet" href="_static/default.css" type="text/css" />
   14   <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
   15   <script type="text/javascript">
   16     var DOCUMENTATION_OPTIONS = {
   17         URL_ROOT:    './',
   18         VERSION:     '2.16.1',
   19         COLLAPSE_MODINDEX: false,
   20         FILE_SUFFIX: '.html'
   21     };
   22   </script>
   23   <script type="text/javascript" src="_static/jquery.js"></script>
   24   <script type="text/javascript" src="_static/doctools.js"></script>
   25   <script type="text/javascript" src="_static/searchtools.js"></script>
   26   <script type="text/javascript" src="searchindex.js"></script>
   27   <link rel="shortcut icon" href="_static/geoserver.ico"/>
   28       <link rel="search" title="Search" href="search.html" />
   29       <link rel="top" title="GeoServer 2.16.1 Developer Manual" href="index.html" />
   30       <link rel="next" title="Policies and Procedures" href="policies/index.html" />
   31       <link rel="prev" title="Cite Test Guide" href="cite-test-guide/index.html" />
   32 </head>
   33 <body class="translation">
   34   <div id="header" class="selfclear">
   35     <div class="wrap selfclear">
   36       <div id="logo"><a href="index.html">GeoServer 2.16.1 Developer Manual</a></div>
   37       <ul id="top-nav">
   38         <li class="first"><a href="http://geoserver.org/about">About</a></li>
   39         <li><a href="http://blog.geoserver.org/">Blog</a></li>
   40         <li><a href="http://geoserver.org/download">Download</a></li>
   41         <!--<li><a href="index.html">Documentation</a></li>-->
   42       </ul>
   43         <form id="quick-search" action="search.html" method="get">
   44           <fieldset>
   45             <input type="hidden" name="check_keywords" value="yes" />
   46             <input type="hidden" name="area" value="default" />
   47             <input id="quick-search-query" type="text" name="q" accessKey="q" name="searchQuery.queryString" size="25" value="Search Documentation&hellip;" size="20" tabindex="3" onblur="if(this.value=='') this.value='Search Documentation&hellip;';" onfocus="if(this.value=='Search Documentation&hellip;') this.value='';" />
   48             <input id="quick-search-submit" type="image" value="Search" src="_static/chrome/search_icon_green.png" />
   49           </fieldset>
   50         </form>
   51     </div><!-- /.wrap -->
   52   </div><!-- /#header -->
   53   <div id="main">
   54     <div class="wrap selfclear">
   55       <div id="content-left" class="content-border"></div>
   56       <div id="content">
   57 <ul id="breadcrumbs">
   58   
   59   <li><a href="index.html">GeoServer 2.16.1 Developer Manual</a> &raquo;</li>
   60   <li>Translating GeoServer</li>
   61 </ul>
   62 <ul id="relatedlinks" class="selfclear">
   63   <li class="first">
   64     <a href="policies/index.html" title="Policies and Procedures"
   65        accesskey="N">next</a></li>
   66   <li>
   67     <a href="cite-test-guide/index.html" title="Cite Test Guide"
   68        accesskey="P">previous</a>|</li>
   69 </ul>
   70         
   71   <div class="section" id="translating-geoserver">
   72 <span id="translation"></span><h1>Translating GeoServer<a class="headerlink" href="#translating-geoserver" title="Permalink to this headline"></a></h1>
   73 <p>We would like GeoServer available in as many languages as possible, so we want your help to add localizations / translations, specifically the GeoServer UI and documentation.</p>
   74 <div class="section" id="translating-the-ui">
   75 <h2>Translating the UI<a class="headerlink" href="#translating-the-ui" title="Permalink to this headline"></a></h2>
   76 <p>The GeoServer UI stores text strings inside properties files.  The default (English) files are named <code class="file docutils literal notranslate"><span class="pre">GeoServerApplication.properties</span></code> and are located in the following directories:</p>
   77 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">/</span><span class="n">src</span><span class="o">/</span><span class="n">web</span><span class="o">/</span><span class="n">core</span><span class="o">/</span><span class="n">src</span><span class="o">/</span><span class="n">main</span><span class="o">/</span><span class="n">resources</span><span class="o">/</span>
   78 <span class="o">/</span><span class="n">src</span><span class="o">/</span><span class="n">web</span><span class="o">/</span><span class="n">demo</span><span class="o">/</span><span class="n">src</span><span class="o">/</span><span class="n">main</span><span class="o">/</span><span class="n">resources</span><span class="o">/</span>
   79 <span class="o">/</span><span class="n">src</span><span class="o">/</span><span class="n">web</span><span class="o">/</span><span class="n">gwc</span><span class="o">/</span><span class="n">src</span><span class="o">/</span><span class="n">main</span><span class="o">/</span><span class="n">resources</span><span class="o">/</span>
   80 <span class="o">/</span><span class="n">src</span><span class="o">/</span><span class="n">web</span><span class="o">/</span><span class="n">security</span><span class="o">/</span><span class="n">src</span><span class="o">/</span><span class="n">main</span><span class="o">/</span><span class="n">resources</span><span class="o">/</span>
   81 <span class="o">/</span><span class="n">src</span><span class="o">/</span><span class="n">web</span><span class="o">/</span><span class="n">wcs</span><span class="o">/</span><span class="n">src</span><span class="o">/</span><span class="n">main</span><span class="o">/</span><span class="n">resources</span><span class="o">/</span>
   82 <span class="o">/</span><span class="n">src</span><span class="o">/</span><span class="n">web</span><span class="o">/</span><span class="n">wfs</span><span class="o">/</span><span class="n">src</span><span class="o">/</span><span class="n">main</span><span class="o">/</span><span class="n">resources</span><span class="o">/</span>
   83 <span class="o">/</span><span class="n">src</span><span class="o">/</span><span class="n">web</span><span class="o">/</span><span class="n">wms</span><span class="o">/</span><span class="n">src</span><span class="o">/</span><span class="n">main</span><span class="o">/</span><span class="n">resources</span><span class="o">/</span>
   84 </pre></div>
   85 </div>
   86 <p>To translate the GeoServer UI to another language, copy and rename each of these files to be <code class="file docutils literal notranslate"><span class="pre">GeoServerApplication_[LANG].properties</span></code> where [LANG] is the language code as defined in <a class="reference external" href="http://www.ietf.org/rfc/rfc3066.txt">RFC 3066</a>  For example, the language code for German is <code class="docutils literal notranslate"><span class="pre">de</span></code> and for Brazilian Portuguese is <code class="docutils literal notranslate"><span class="pre">pt-BR</span></code>.</p>
   87 <p>Once created, each line in the files represents a string that will need to be translated.  When finished, you will need to commit these files or submit a JIRA issue with attached patch.  See the section on <a class="reference internal" href="source.html#source"><span class="std std-ref">Source Code</span></a> for more information on how to commit.</p>
   88 <div class="section" id="editing-in-eclipse">
   89 <h3>Editing in Eclipse<a class="headerlink" href="#editing-in-eclipse" title="Permalink to this headline"></a></h3>
   90 <p>If you are using <a class="reference external" href="http://www.eclipse.org/">Eclipse</a>, you can install the <a class="reference external" href="http://sourceforge.net/projects/eclipse-rbe/">Eclipse ResourceBundle Editor</a>.  Once installed, you can edit the <code class="file docutils literal notranslate"><span class="pre">src/main/resources/GeoServerApplication.properties</span></code> files in all <code class="docutils literal notranslate"><span class="pre">web-*</span></code> projects (<code class="docutils literal notranslate"><span class="pre">web-core</span></code>, <code class="docutils literal notranslate"><span class="pre">web-demo</span></code>, etc.) with the ResourceBundle editor.</p>
   91 </div>
   92 </div>
   93 <div class="section" id="translating-documentation">
   94 <h2>Translating documentation<a class="headerlink" href="#translating-documentation" title="Permalink to this headline"></a></h2>
   95 <p>The GeoServer User Manual contains a wealth of information from the novice to the experienced GeoServer user.  It is written using the <a class="reference external" href="http://sphinx.pocoo.org/">Sphinx Documentation Generator</a>.  The stable branch version of the User Manual exists as the following URL:</p>
   96 <blockquote>
   97 <div><a class="reference external" href="http://docs.geoserver.org/stable/en/user/">http://docs.geoserver.org/stable/en/user/</a></div></blockquote>
   98 <p>Built from the following source files:</p>
   99 <blockquote>
  100 <div>/doc/en/user/</div></blockquote>
  101 <p>To create a User Manual in a different language, first create a directory called <code class="file docutils literal notranslate"><span class="pre">/doc/[LANG]/</span></code>, where [LANG] is the language code as defined in <a class="reference external" href="http://www.ietf.org/rfc/rfc3066.txt">RFC 3066</a>.  The you can copy the contents of <code class="file docutils literal notranslate"><span class="pre">/doc/en/user/</span></code> to <code class="file docutils literal notranslate"><span class="pre">/doc/[LANG]/user</span></code> and edit accordingly, or generate a new Sphinx project in <code class="file docutils literal notranslate"><span class="pre">/doc/[LANG]/user</span></code>.   (See the <cite>Sphinx Quickstart &lt;http://sphinx.pocoo.org/tutorial.html&gt;</cite> for more information about creating a new project.)</p>
  102 <p>The GeoServer Sphinx theme exists at <code class="file docutils literal notranslate"><span class="pre">/doc/en/user/themes</span></code>, so that can be copied (and modified if desired) to <code class="file docutils literal notranslate"><span class="pre">/doc/[LANG]/user/themes</span></code>.</p>
  103 <p>When finished, you will need to commit the content (if you have commit rights) or submit a JIRA issue with attached patch.  See the section on <a class="reference internal" href="source.html#source"><span class="std std-ref">Source Code</span></a> for more information on how to commit.  Setting up the documentation to be hosted on docs.geoserver.org will require a project administrator; please send an email to the mailing list for more details.</p>
  104 <div class="section" id="tips">
  105 <h3>Tips<a class="headerlink" href="#tips" title="Permalink to this headline"></a></h3>
  106 <ul class="simple">
  107 <li>See the <a class="reference external" href="http://docs.geoserver.org/latest/en/docguide/">GeoServer Documentation Manual</a> for more information about writing documentation.</li>
  108 <li>The Developer Manual exists at <code class="file docutils literal notranslate"><span class="pre">/doc/en/developer</span></code>.  The same procedures for editing the User Manual apply to the Developer Manual.</li>
  109 </ul>
  110 </div>
  111 </div>
  112 </div>
  113 
  114 
  115       <div class="selfclear pagination-nav">
  116           <div class="leftwise"><strong>Previous</strong>: <a href="cite-test-guide/index.html" title="previous chapter">Cite Test Guide</a></div>
  117           <div class="rightwise"><strong>Next</strong>: <a href="policies/index.html" title="next chapter">Policies and Procedures</a></div>
  118       </div>
  119       </div><!-- /#content> -->
  120       <div id="content-right" class="content-border"></div>
  121   <div id="sidebar" class="contrast">
  122       <div id="toc" class="section">
  123         <h3 class="pngfix">Table Of Contents</h3>
  124         <ul>
  125 <li><a class="reference internal" href="#">Translating GeoServer</a><ul>
  126 <li><a class="reference internal" href="#translating-the-ui">Translating the UI</a><ul>
  127 <li><a class="reference internal" href="#editing-in-eclipse">Editing in Eclipse</a></li>
  128 </ul>
  129 </li>
  130 <li><a class="reference internal" href="#translating-documentation">Translating documentation</a><ul>
  131 <li><a class="reference internal" href="#tips">Tips</a></li>
  132 </ul>
  133 </li>
  134 </ul>
  135 </li>
  136 </ul>
  137 
  138         <div class="section-footer"></div>
  139       </div>
  140         <div class="section">
  141           <h3>Continue Reading</h3>
  142           <ul>
  143             <li>Previous: <a href="cite-test-guide/index.html" title="previous chapter">Cite Test Guide</a></li>
  144             <li>Next: <a href="policies/index.html" title="next chapter">Policies and Procedures</a></li>
  145           </ul>
  146         </div>
  147         <div class="section">
  148         <h3>This Page</h3>
  149         <ul class="this-page-menu">
  150                 
  151         <li><a href="https://github.com/geoserver/geoserver/tree/master/doc/en/developer/source/translation.rst">Edit</a></li>
  152         </ul>
  153         </div>
  154   </div><!-- /#sidebar -->
  155   </div><!-- /.wrap> -->
  156 </div><!-- /#main -->
  157 <div id="footer">
  158   <div class="wrap">
  159     &copy; Copyright 2019, Open Source Geospatial Foundation. License <a href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution</a>.
  160     Last updated on Nov 22, 2019.
  161     Created using <a href="http://sphinx.pocoo.org/">Sphinx</a>.
  162   </div><!-- /.wrap> -->
  163 </div><!-- /#footer -->
  164   </body>
  165 </html>