trans-coord-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

trans-coord/manual/gnun/html_node ADD_005fFUZZY...


From: Pavel Kharitonov
Subject: trans-coord/manual/gnun/html_node ADD_005fFUZZY...
Date: Fri, 08 Mar 2013 12:08:31 +0000

CVSROOT:        /web/trans-coord
Module name:    trans-coord
Changes by:     Pavel Kharitonov <ineiev>       13/03/08 12:08:31

Added files:
        manual/gnun/html_node: ADD_005fFUZZY_005fDIFF.html 
                               FUZZY_005fDIFF_005fLINGUAS.html 
                               Modifying-Templates.html PO-Header.html 
                               Team_0027s-Repository.html 
                               Wrapping-Long-Lines.html 

Log message:
        New files

CVSWeb URLs:
http://web.cvs.savannah.gnu.org/viewcvs/trans-coord/manual/gnun/html_node/ADD_005fFUZZY_005fDIFF.html?cvsroot=trans-coord&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/trans-coord/manual/gnun/html_node/FUZZY_005fDIFF_005fLINGUAS.html?cvsroot=trans-coord&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/trans-coord/manual/gnun/html_node/Modifying-Templates.html?cvsroot=trans-coord&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/trans-coord/manual/gnun/html_node/PO-Header.html?cvsroot=trans-coord&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/trans-coord/manual/gnun/html_node/Team_0027s-Repository.html?cvsroot=trans-coord&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/trans-coord/manual/gnun/html_node/Wrapping-Long-Lines.html?cvsroot=trans-coord&rev=1.1

Patches:
Index: ADD_005fFUZZY_005fDIFF.html
===================================================================
RCS file: ADD_005fFUZZY_005fDIFF.html
diff -N ADD_005fFUZZY_005fDIFF.html
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ ADD_005fFUZZY_005fDIFF.html 8 Mar 2013 12:08:30 -0000       1.1
@@ -0,0 +1,65 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<!-- 
+This manual (updated 4 March 2013) is for GNUnited Nations (version
+0.7), a suite for maintaining translations of www.gnu.org
+essays and other articles.
+
+
+Copyright (C) 2008, 2009, 2010, 2011, 2012, 2013 Free
+Software Foundation, Inc.
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.  A
+copy of the license is included in the section entitled "GNU Free
+Documentation License." -->
+<!-- Created by GNU Texinfo 4.13.92, http://www.gnu.org/software/texinfo/ -->
+<!-- This file redirects to the location of a node or anchor -->
+<head>
+<title>GNUnited Nations: ADD_FUZZY_DIFF</title>
+
+<meta name="description" content="GNUnited Nations: ADD_FUZZY_DIFF">
+<meta name="keywords" content="GNUnited Nations: ADD_FUZZY_DIFF">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.indentedblock {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style:oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nocodebreak {white-space:nowrap}
+span.nolinebreak {white-space:nowrap}
+span.roman {font-family:serif; font-weight:normal}
+span.sansserif {font-family:sans-serif; font-weight:normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+<meta http-equiv="Refresh" content="0; 
url=GNUmakefile_002eteam-Variables.html#ADD_005fFUZZY_005fDIFF">
+
+</head>
+
+<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" 
vlink="#800080" alink="#FF0000">
+
+<p>The node you are looking for is at <a 
href="GNUmakefile_002eteam-Variables.html#ADD_005fFUZZY_005fDIFF">ADD_FUZZY_DIFF</a>.</p>
+</body>

Index: FUZZY_005fDIFF_005fLINGUAS.html
===================================================================
RCS file: FUZZY_005fDIFF_005fLINGUAS.html
diff -N FUZZY_005fDIFF_005fLINGUAS.html
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ FUZZY_005fDIFF_005fLINGUAS.html     8 Mar 2013 12:08:30 -0000       1.1
@@ -0,0 +1,65 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<!-- 
+This manual (updated 4 March 2013) is for GNUnited Nations (version
+0.7), a suite for maintaining translations of www.gnu.org
+essays and other articles.
+
+
+Copyright (C) 2008, 2009, 2010, 2011, 2012, 2013 Free
+Software Foundation, Inc.
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.  A
+copy of the license is included in the section entitled "GNU Free
+Documentation License." -->
+<!-- Created by GNU Texinfo 4.13.92, http://www.gnu.org/software/texinfo/ -->
+<!-- This file redirects to the location of a node or anchor -->
+<head>
+<title>GNUnited Nations: FUZZY_DIFF_LINGUAS</title>
+
+<meta name="description" content="GNUnited Nations: FUZZY_DIFF_LINGUAS">
+<meta name="keywords" content="GNUnited Nations: FUZZY_DIFF_LINGUAS">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.indentedblock {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style:oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nocodebreak {white-space:nowrap}
+span.nolinebreak {white-space:nowrap}
+span.roman {font-family:serif; font-weight:normal}
+span.sansserif {font-family:sans-serif; font-weight:normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+<meta http-equiv="Refresh" content="0; 
url=Main-Variables.html#FUZZY_005fDIFF_005fLINGUAS">
+
+</head>
+
+<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" 
vlink="#800080" alink="#FF0000">
+
+<p>The node you are looking for is at <a 
href="Main-Variables.html#FUZZY_005fDIFF_005fLINGUAS">FUZZY_DIFF_LINGUAS</a>.</p>
+</body>

Index: Modifying-Templates.html
===================================================================
RCS file: Modifying-Templates.html
diff -N Modifying-Templates.html
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ Modifying-Templates.html    8 Mar 2013 12:08:31 -0000       1.1
@@ -0,0 +1,102 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<!-- 
+This manual (updated 4 March 2013) is for GNUnited Nations (version
+0.7), a suite for maintaining translations of www.gnu.org
+essays and other articles.
+
+
+Copyright (C) 2008, 2009, 2010, 2011, 2012, 2013 Free
+Software Foundation, Inc.
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.  A
+copy of the license is included in the section entitled "GNU Free
+Documentation License." -->
+<!-- Created by GNU Texinfo 4.13.92, http://www.gnu.org/software/texinfo/ -->
+<head>
+<title>GNUnited Nations: Modifying Templates</title>
+
+<meta name="description" content="GNUnited Nations: Modifying Templates">
+<meta name="keywords" content="GNUnited Nations: Modifying Templates">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<link href="index.html#Top" rel="start" title="Top">
+<link href="Index.html#Index" rel="index" title="Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Webmaster-Tips.html#Webmaster-Tips" rel="up" title="Webmaster 
Tips">
+<link href="Comments-for-Translators.html#Comments-for-Translators" rel="next" 
title="Comments for Translators">
+<link href="Webmaster-Tips.html#Webmaster-Tips" rel="previous" 
title="Webmaster Tips">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.indentedblock {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style:oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nocodebreak {white-space:nowrap}
+span.nolinebreak {white-space:nowrap}
+span.roman {font-family:serif; font-weight:normal}
+span.sansserif {font-family:sans-serif; font-weight:normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+
+</head>
+
+<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" 
vlink="#800080" alink="#FF0000">
+<a name="Modifying-Templates"></a>
+<div class="header">
+<p>
+Next: <a href="Comments-for-Translators.html#Comments-for-Translators" 
accesskey="n" rel="next">Comments for Translators</a>, Up: <a 
href="Webmaster-Tips.html#Webmaster-Tips" accesskey="u" rel="up">Webmaster 
Tips</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" 
rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" 
rel="index">Index</a>]</p>
+</div>
+<hr>
+<a name="Modifying-Templates-1"></a>
+<h3 class="section">5.1 Modifying Templates</h3>
+<a name="index-boilerplates"></a>
+<a name="index-templates"></a>
+
+<p>Any significant structural diversion from
+<samp>boilerplate.html</samp> in a specific article may result in errors from
+GNUN.  Any untested intrusive updates to the server templates (such as
+changing the entire look &amp; feel of the site) will probably break
+GNUN build process.  Of course, this does not
+mean that no changes should happen&mdash;only that they must be applied in
+a sandbox first, to ensure a smooth transition.
+</p>
+<a name="index-validation-3"></a>
+<p>The script <code>gnun-validate-html</code> is useful for webmasters who
+want to verify if their (potentially intrusive) changes result in a
+valid markup.  Before committing your changes, you can check whether
+the file is valid by running
+</p>
+<div class="example">
+<pre class="example">gnun-validate-html --root . philosophy/not-ipr.html
+</pre></div>
+
+<p>See <a 
href="gnun_002dvalidate_002dhtml.html#gnun_002dvalidate_002dhtml">gnun-validate-html</a>,
 for more information.
+</p>
+
+
+
+</body>
+</html>

Index: PO-Header.html
===================================================================
RCS file: PO-Header.html
diff -N PO-Header.html
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ PO-Header.html      8 Mar 2013 12:08:31 -0000       1.1
@@ -0,0 +1,194 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<!-- 
+This manual (updated 4 March 2013) is for GNUnited Nations (version
+0.7), a suite for maintaining translations of www.gnu.org
+essays and other articles.
+
+
+Copyright (C) 2008, 2009, 2010, 2011, 2012, 2013 Free
+Software Foundation, Inc.
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.  A
+copy of the license is included in the section entitled "GNU Free
+Documentation License." -->
+<!-- Created by GNU Texinfo 4.13.92, http://www.gnu.org/software/texinfo/ -->
+<head>
+<title>GNUnited Nations: PO Header</title>
+
+<meta name="description" content="GNUnited Nations: PO Header">
+<meta name="keywords" content="GNUnited Nations: PO Header">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<link href="index.html#Top" rel="start" title="Top">
+<link href="Index.html#Index" rel="index" title="Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="PO-Files.html#PO-Files" rel="up" title="PO Files">
+<link href="GNUN-Slots.html#GNUN-Slots" rel="next" title="GNUN Slots">
+<link href="New-Translation.html#New-Translation" rel="previous" title="New 
Translation">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.indentedblock {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style:oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nocodebreak {white-space:nowrap}
+span.nolinebreak {white-space:nowrap}
+span.roman {font-family:serif; font-weight:normal}
+span.sansserif {font-family:sans-serif; font-weight:normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+
+</head>
+
+<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" 
vlink="#800080" alink="#FF0000">
+<a name="PO-Header"></a>
+<div class="header">
+<p>
+Next: <a href="GNUN-Slots.html#GNUN-Slots" accesskey="n" rel="next">GNUN 
Slots</a>, Previous: <a href="New-Translation.html#New-Translation" 
accesskey="p" rel="previous">New Translation</a>, Up: <a 
href="PO-Files.html#PO-Files" accesskey="u" rel="up">PO Files</a> &nbsp; [<a 
href="index.html#SEC_Contents" title="Table of contents" 
rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" 
rel="index">Index</a>]</p>
+</div>
+<hr>
+<a name="Filling-the-PO-File-Header"></a>
+<h3 class="section">4.2 Filling the PO File Header</h3>
+<a name="index-PO-files_002c-header"></a>
+
+<p>The PO file header as generated usually looks like this:
+</p>
+<div class="example">
+<pre class="example"># SOME DESCRIPTIVE TITLE
+# Copyright (C) YEAR Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR &lt;address@hidden&gt;, YEAR.
+#
+#, fuzzy
+msgid &quot;&quot;
+msgstr &quot;&quot;
+&quot;Project-Id-Version: PACKAGE VERSION\n&quot;
+&quot;POT-Creation-Date: 2008-02-06 16:25-0500\n&quot;
+&quot;PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n&quot;
+&quot;Last-Translator: FULL NAME &lt;address@hidden&gt;\n&quot;
+&quot;Language-Team: LANGUAGE &lt;address@hidden&gt;\n&quot;
+&quot;MIME-Version: 1.0\n&quot;
+&quot;Content-Type: text/plain; charset=CHARSET\n&quot;
+&quot;Content-Transfer-Encoding: ENCODING\n&quot;
+</pre></div>
+
+<p>You have to edit the header to match the already established
+conventions, and the rules for gnu.org translations.  For reference,
+here is a list with all fields explained:
+</p>
+<a name="index-PO-headers"></a>
+<dl compact="compact">
+<dt>&lsquo;<samp>Project-Id-Version</samp>&rsquo;</dt>
+<dd><p>Add here the filename of the original article, without the
+sub-directory, like &ldquo;body-include-1.html&rdquo; or 
&ldquo;free-sw.html&rdquo;.
+</p>
+</dd>
+<dt>&lsquo;<samp>POT-Creation-Date</samp>&rsquo;</dt>
+<dd><p>Do not edit this field, it is already set when the POT is created.
+</p>
+</dd>
+<dt>&lsquo;<samp>PO-Revision-Date</samp>&rsquo;</dt>
+<dd><p>Likewise, do not edit.  This field is automatically filled in when you
+save the file with any decent PO editor.
+</p>
+</dd>
+<dt>&lsquo;<samp>Last-Translator</samp>&rsquo;</dt>
+<dd><p>The name and email address of the last translator who has edited the
+translation.  Pay attention that normally this is the name of a member
+of your team, it can be the translation team leader if he/she was the
+person who updated the translation.  For example:
+</p>
+<div class="example">
+<pre class="example">Elvis Parsley &lt;address@hidden&gt;
+</pre></div>
+
+</dd>
+<dt>&lsquo;<samp>Language-Team</samp>&rsquo;</dt>
+<dd><p>This field should contain the mailing list on which the translation
+team can be reached&mdash;usually <a 
href="mailto:www-LANG-&hellip;@gnu.org";>www-LANG-&hellip;@gnu.org</a>.
+Example:
+</p>
+<div class="example">
+<pre class="example">Czech &lt;address@hidden&gt;
+</pre></div>
+
+</dd>
+<dt>&lsquo;<samp>MIME-Version</samp>&rsquo;</dt>
+<dd><p>Leave it like it is.
+</p>
+</dd>
+<dt>&lsquo;<samp>Content-Type</samp>&rsquo;</dt>
+<dd><p>Usually this is <code>text/plain; charset=UTF-8</code>; change the 
charset
+accordingly.
+</p>
+</dd>
+<dt>&lsquo;<samp>Content-Transfer-Encoding</samp>&rsquo;</dt>
+<dd><p>Set this to <code>8bit</code>.  Note that the PO file header ends with 
this
+field, and it should contain a newline (&lsquo;<samp>\n</samp>&rsquo;).  
Unfortunately, some
+PO editors remove the newline, which causes an unnecessary revision when
+the file is automatically modified by GNUN&rsquo;s rules.
+</p></dd>
+</dl>
+
+<p>Here is an example of a properly edited header:
+</p>
+<div class="example">
+<pre class="example"># Bulgarian translation of 
http://www.gnu.org/philosophy/free-sw.html
+# Copyright (C) 2008 Free Software Foundation, Inc.
+# This file is distributed under the same license as the gnu.org article.
+# Yavor Doganov &lt;address@hidden&gt;, 2008.
+#
+msgid &quot;&quot;
+msgstr &quot;&quot;
+&quot;Project-Id-Version: free-sw.html\n&quot;
+&quot;POT-Creation-Date: 2008-02-06 16:25-0500\n&quot;
+&quot;PO-Revision-Date: 2008-02-09 15:23+0200\n&quot;
+&quot;Last-Translator: Yavor Doganov &lt;address@hidden&gt;\n&quot;
+&quot;Language-Team: Bulgarian &lt;address@hidden&gt;\n&quot;
+&quot;MIME-Version: 1.0\n&quot;
+&quot;Content-Type: text/plain; charset=UTF-8\n&quot;
+&quot;Content-Transfer-Encoding: 8bit\n&quot;
+</pre></div>
+
+<p>Notice the absence of the &ldquo;fuzzy&rdquo; marker; you should 
&ldquo;unfuzzy&rdquo; the
+header after entering the necessary information (this is done by
+simply pressing <tt class="key">TAB</tt> in PO mode).
+</p>
+<p>It is recommended that you wrap all lines in the comments to be less
+than 80 characters; that looks better from a purely aesthetic point of view
+and improves the performance of <samp>GNUmakefile.team</samp>&rsquo;s 
<code>publish</code>
+rule (see <a href="GNUmakefile_002eteam-Targets.html#publish">publish</a>).
+</p>
+<hr>
+<div class="header">
+<p>
+Next: <a href="GNUN-Slots.html#GNUN-Slots" accesskey="n" rel="next">GNUN 
Slots</a>, Previous: <a href="New-Translation.html#New-Translation" 
accesskey="p" rel="previous">New Translation</a>, Up: <a 
href="PO-Files.html#PO-Files" accesskey="u" rel="up">PO Files</a> &nbsp; [<a 
href="index.html#SEC_Contents" title="Table of contents" 
rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" 
rel="index">Index</a>]</p>
+</div>
+
+
+
+</body>
+</html>

Index: Team_0027s-Repository.html
===================================================================
RCS file: Team_0027s-Repository.html
diff -N Team_0027s-Repository.html
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ Team_0027s-Repository.html  8 Mar 2013 12:08:31 -0000       1.1
@@ -0,0 +1,188 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<!-- 
+This manual (updated 4 March 2013) is for GNUnited Nations (version
+0.7), a suite for maintaining translations of www.gnu.org
+essays and other articles.
+
+
+Copyright (C) 2008, 2009, 2010, 2011, 2012, 2013 Free
+Software Foundation, Inc.
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.  A
+copy of the license is included in the section entitled "GNU Free
+Documentation License." -->
+<!-- Created by GNU Texinfo 4.13.92, http://www.gnu.org/software/texinfo/ -->
+<head>
+<title>GNUnited Nations: Team's Repository</title>
+
+<meta name="description" content="GNUnited Nations: Team's Repository">
+<meta name="keywords" content="GNUnited Nations: Team's Repository">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<link href="index.html#Top" rel="start" title="Top">
+<link href="Index.html#Index" rel="index" title="Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html#Top" rel="up" title="Top">
+<link 
href="GNUmakefile_002eteam-Variables.html#GNUmakefile_002eteam-Variables" 
rel="next" title="GNUmakefile.team Variables">
+<link href="GNU-News.html#GNU-News" rel="previous" title="GNU News">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.indentedblock {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style:oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nocodebreak {white-space:nowrap}
+span.nolinebreak {white-space:nowrap}
+span.roman {font-family:serif; font-weight:normal}
+span.sansserif {font-family:sans-serif; font-weight:normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+
+</head>
+
+<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" 
vlink="#800080" alink="#FF0000">
+<a name="Team_0027s-Repository"></a>
+<div class="header">
+<p>
+Next: <a href="PO-Files.html#PO-Files" accesskey="n" rel="next">PO Files</a>, 
Previous: <a href="Usage.html#Usage" accesskey="p" rel="previous">Usage</a>, 
Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a 
href="index.html#SEC_Contents" title="Table of contents" 
rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" 
rel="index">Index</a>]</p>
+</div>
+<hr>
+<a name="Maintaining-Translations-in-Your-Team_0027s-Repository"></a>
+<h2 class="chapter">3 Maintaining Translations in Your Team&rsquo;s 
Repository</h2>
+<a name="index-project-repository"></a>
+<a name="index-repository_002c-translation-project"></a>
+<a name="index-team-maintenance"></a>
+<a name="index-GNUmakefile_002eteam"></a>
+
+<p>GNUN operates on the &ldquo;official&rdquo; Web repository of the Savannah 
project
+&lsquo;www&rsquo;, where normally only the coordinators of translation teams 
have
+write access.  However, all translation teams have their own projects,
+so it is possible to take advantage of Savannah as a hosting facility to
+make the team work more comfortable.
+</p>
+<p>The PO files provide an excellent and natural way to review each 
other&rsquo;s
+translations, because the translation appears right below the original
+message.  Mutual reviews and proof-reading of translations is a crucial
+part of the process.  Furthermore, team work is great for the community
+spirit; automating some of the operations also result in more time for
+all members to concentrate on the important tasks.
+</p>
+<p>The file <samp>GNUmakefile.team</samp> in the 
&lsquo;<samp>gnun</samp>&rsquo; package is a
+template, aimed for all translation teams who wish to use their own
+project&rsquo;s repository as a place to keep their draft translations, until
+they ripe and are ready to be installed officially.
+</p>
+<a name="index-team-workflow"></a>
+<p>The following diagram illustrates a typical workflow&mdash;it is applicable
+for small, medium and large teams:
+</p>
+<div class="example">
+<pre class="example">+----------+                   +-------------------+
+| ``www''  |                   |   ``www-LANG''    |
+|   Web    |------&gt;----&gt;-------|Sources repository |
+|repository|  automatic merge  +-------------------+
++----------+                         |    |     |
+     |                               |    |     `-- Member A
+     +------------&lt;----&lt;-------------'    |
+                  Leader                  `---Member B
+</pre></div>
+
+<p>All members and the team leader commit in their project&rsquo;s
+repository&mdash;when a translation is ready, the leader checks it in the
+official &lsquo;www&rsquo; repository.  If an original article changes, a build
+could be invoked to synchronize (i.e. merge) the changes and
+optionally automatically commit them so that the draft PO files are
+updated; at the same time, automatic notifications are sent to the
+persons interested in particular translations<a name="DOCF6" 
href="#FOOT6"><sup>6</sup></a>.  A translator would then normally update the PO 
file, and
+commit it again in the project&rsquo;s Sources repository, from where the
+coordinator will pick it up and install it in &lsquo;www&rsquo;.
+</p>
+<p>To take advantage of this semi-automation, rename this template
+<samp>GNUmakefile.team</samp> as <samp>GNUmakefile</samp> and install it in 
the root
+of your project&rsquo;s Sources repository.  Then create directories and
+sub-directories exactly as they are in &lsquo;www&rsquo;.  Do not create the
+<samp>/po</samp> sub-directories; they are redundant here.  Instead, install
+the PO files in the normal locations where the corresponding
+<samp>.<var>lang</var>.html</samp> resides in &lsquo;www&rsquo;, for example:
+</p>
+<div class="example">
+<pre class="example">Root
+  |
+  |--GNUmakefile
+  |--home.<var>lang</var>.po
+  |--&hellip;
+  |--gnu
+  |   |
+  |   |
+  |   +--linux-and-gnu.<var>lang</var>.po
+  |   +--manifesto.<var>lang</var>.po
+  |   +--&hellip;
+  |
+  |
+  +--philosophy
+  |     |
+  |     |
+  |     +--free-sw.<var>lang</var>.po
+  |     +--not-ipr.<var>lang</var>.po
+  |     +--open-source-misses-the-point.<var>lang</var>.po
+  |     +--&hellip;
+  |
+  +--&hellip;
+</pre></div>
+
+<p>The next sections explain how to adopt the makefile for your team and
+how to invoke a &ldquo;build&rdquo;.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">&bull; <a 
href="GNUmakefile_002eteam-Variables.html#GNUmakefile_002eteam-Variables" 
accesskey="1">GNUmakefile.team Variables</a>:</td><td>&nbsp;&nbsp;</td><td 
align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a 
href="GNUmakefile_002eteam-Targets.html#GNUmakefile_002eteam-Targets" 
accesskey="2">GNUmakefile.team Targets</a>:</td><td>&nbsp;&nbsp;</td><td 
align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a 
href="GNUmakefile_002eteam-and-Cron.html#GNUmakefile_002eteam-and-Cron" 
accesskey="3">GNUmakefile.team and Cron</a>:</td><td>&nbsp;&nbsp;</td><td 
align="left" valign="top">
+</td></tr>
+</table>
+
+<div class="footnote">
+<hr>
+<h4 class="footnotes-heading">Footnotes</h4>
+
+<h3><a name="FOOT6" href="#DOCF6">(6)</a></h3>
+<p>The following
+sections describe in more details how to setup these automatic
+actions; however, if you have any difficulties with that, please ask
+the GNU Web Translation Managers to setup them for your team on our
+server.</p>
+</div>
+<hr>
+<div class="header">
+<p>
+Next: <a href="PO-Files.html#PO-Files" accesskey="n" rel="next">PO Files</a>, 
Previous: <a href="Usage.html#Usage" accesskey="p" rel="previous">Usage</a>, 
Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a 
href="index.html#SEC_Contents" title="Table of contents" 
rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" 
rel="index">Index</a>]</p>
+</div>
+
+
+
+</body>
+</html>

Index: Wrapping-Long-Lines.html
===================================================================
RCS file: Wrapping-Long-Lines.html
diff -N Wrapping-Long-Lines.html
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ Wrapping-Long-Lines.html    8 Mar 2013 12:08:31 -0000       1.1
@@ -0,0 +1,132 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<!-- 
+This manual (updated 4 March 2013) is for GNUnited Nations (version
+0.7), a suite for maintaining translations of www.gnu.org
+essays and other articles.
+
+
+Copyright (C) 2008, 2009, 2010, 2011, 2012, 2013 Free
+Software Foundation, Inc.
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.  A
+copy of the license is included in the section entitled "GNU Free
+Documentation License." -->
+<!-- Created by GNU Texinfo 4.13.92, http://www.gnu.org/software/texinfo/ -->
+<head>
+<title>GNUnited Nations: Wrapping Long Lines</title>
+
+<meta name="description" content="GNUnited Nations: Wrapping Long Lines">
+<meta name="keywords" content="GNUnited Nations: Wrapping Long Lines">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<link href="index.html#Top" rel="start" title="Top">
+<link href="Index.html#Index" rel="index" title="Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="PO-Files.html#PO-Files" rel="up" title="PO Files">
+<link href="PO-Tips.html#PO-Tips" rel="next" title="PO Tips">
+<link href="Credits-Slot.html#Credits-Slot" rel="previous" title="Credits 
Slot">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.indentedblock {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style:oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nocodebreak {white-space:nowrap}
+span.nolinebreak {white-space:nowrap}
+span.roman {font-family:serif; font-weight:normal}
+span.sansserif {font-family:sans-serif; font-weight:normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+
+</head>
+
+<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" 
vlink="#800080" alink="#FF0000">
+<a name="Wrapping-Long-Lines"></a>
+<div class="header">
+<p>
+Next: <a href="PO-Tips.html#PO-Tips" accesskey="n" rel="next">PO Tips</a>, 
Previous: <a href="GNUN-Slots.html#GNUN-Slots" accesskey="p" 
rel="previous">GNUN Slots</a>, Up: <a href="PO-Files.html#PO-Files" 
accesskey="u" rel="up">PO Files</a> &nbsp; [<a href="index.html#SEC_Contents" 
title="Table of contents" rel="contents">Contents</a>][<a 
href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<hr>
+<a name="Wrapping-Long-Lines-1"></a>
+<h3 class="section">4.4 Wrapping Long Lines</h3>
+<a name="index-wrapping-long-lines"></a>
+<a name="index-long-lines_002c-wrap"></a>
+
+<p>Most of the PO editors do not wrap long lines that inevitably appear in
+<code>msgstr</code>s.  If that happens, long lines make reading subsequent
+diffs harder, and are generally annoying for most people.  If this issue
+bothers you, you can &ldquo;normalize&rdquo; the already finished PO 
translation
+by executing on the command line <code>msgcat -o <var>file</var>.po
+<var>file</var>.po</code>, before installing it in the repository.  Either 
way, the
+build system will treat it is a valid PO file.
+</p>
+<p>For those lucky Emacs users, here is a code snippet that you can put
+in your <samp>.emacs</samp>; doing <kbd>M-x po-wrap</kbd> while in PO mode will
+wrap all long lines:
+</p>
+<div class="lisp">
+<pre class="lisp">(defun po-wrap ()
+  &quot;Filter current po-mode buffer through `msgcat' tool to wrap all 
lines.&quot;
+  (interactive)
+  (if (eq major-mode 'po-mode)
+      (let ((tmp-file (make-temp-file &quot;po-wrap.&quot;))
+           (tmp-buf (generate-new-buffer &quot;*temp*&quot;)))
+       (unwind-protect
+           (progn
+             (write-region (point-min) (point-max) tmp-file nil 1)
+             (if (zerop
+                  (call-process
+                   &quot;msgcat&quot; nil tmp-buf t (shell-quote-argument 
tmp-file)))
+                 (let ((saved (point))
+                       (inhibit-read-only t))
+                   (delete-region (point-min) (point-max))
+                   (insert-buffer tmp-buf)
+                   (goto-char (min saved (point-max))))
+               (with-current-buffer tmp-buf
+                 (error (buffer-string)))))
+         (kill-buffer tmp-buf)
+         (delete-file tmp-file)))))
+</pre></div>
+
+<p>It is highly desirable that you check if the PO file you finished
+translating (or editing) is valid, before committing it.  This is done
+by running <code>msgfmt -cv -o /dev/null <var>file</var></code> or by simply
+pressing <kbd>V</kbd> in PO mode.  The build system automatically verifies
+each PO file when invoked with <code>VALIDATE=yes</code>, but you won&rsquo;t 
get a
+warm and fuzzy feeling if a stupid typo you made halts the whole update
+of all translations.  Such things happen to everyone, so it is a good
+practice to check before you actually commit.
+</p>
+<hr>
+<div class="header">
+<p>
+Next: <a href="PO-Tips.html#PO-Tips" accesskey="n" rel="next">PO Tips</a>, 
Previous: <a href="GNUN-Slots.html#GNUN-Slots" accesskey="p" 
rel="previous">GNUN Slots</a>, Up: <a href="PO-Files.html#PO-Files" 
accesskey="u" rel="up">PO Files</a> &nbsp; [<a href="index.html#SEC_Contents" 
title="Table of contents" rel="contents">Contents</a>][<a 
href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+
+
+
+</body>
+</html>



reply via email to

[Prev in Thread] Current Thread [Next in Thread]