[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
trans-coord/manual/gnun/html_node gnun_002drepo...
|
From: |
Pavel Kharitonov |
|
Subject: |
trans-coord/manual/gnun/html_node gnun_002drepo... |
|
Date: |
Tue, 04 Dec 2012 16:26:17 +0000 |
CVSROOT: /web/trans-coord
Module name: trans-coord
Changes by: Pavel Kharitonov <ineiev> 12/12/04 16:26:17
Added files:
manual/gnun/html_node: gnun_002dreport.html
gnun_002ddiff_002dpo.html
GNUmakefile_002eteam-Targets.html
Log message:
Add new nodes.
CVSWeb URLs:
http://web.cvs.savannah.gnu.org/viewcvs/trans-coord/manual/gnun/html_node/gnun_002dreport.html?cvsroot=trans-coord&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/trans-coord/manual/gnun/html_node/gnun_002ddiff_002dpo.html?cvsroot=trans-coord&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/trans-coord/manual/gnun/html_node/GNUmakefile_002eteam-Targets.html?cvsroot=trans-coord&rev=1.1
Patches:
Index: gnun_002dreport.html
===================================================================
RCS file: gnun_002dreport.html
diff -N gnun_002dreport.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ gnun_002dreport.html 4 Dec 2012 16:26:16 -0000 1.1
@@ -0,0 +1,128 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<!--
+This manual (updated 3 December 2012) is for GNUnited Nations (version
+0.6), a suite for maintaining translations of www.gnu.org
+essays and other articles.
+
+
+Copyright (C) 2008, 2009, 2010, 2011, 2012 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.90, http://www.gnu.org/software/texinfo/ -->
+<head>
+<title>GNUnited Nations: gnun-report</title>
+
+<meta name="description" content="GNUnited Nations: gnun-report">
+<meta name="keywords" content="GNUnited Nations: gnun-report">
+<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="Scripts.html#Scripts" rel="up" title="Scripts">
+<link href="gnun_002dvalidate_002dhtml.html#gnun_002dvalidate_002dhtml"
rel="next" title="gnun-validate-html">
+<link
href="gnun_002dmerge_002dpreconverted.html#gnun_002dmerge_002dpreconverted"
rel="previous" title="gnun-merge-preconverted">
+<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="gnun_002dreport"></a>
+<div class="header">
+<p>
+Next: <a href="gnun_002dvalidate_002dhtml.html#gnun_002dvalidate_002dhtml"
accesskey="n" rel="next">gnun-validate-html</a>, Previous: <a
href="gnun_002dmerge_002dpreconverted.html#gnun_002dmerge_002dpreconverted"
accesskey="p" rel="previous">gnun-merge-preconverted</a>, Up: <a
href="Scripts.html#Scripts" accesskey="u" rel="up">Scripts</a> [<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="The-gnun_002dreport-Script"></a>
+<h4 class="subsection">3.1.6 The <code>gnun-report</code> Script</h4>
+<a name="index-reporting-1"></a>
+<a name="index-status_002c-translations-1"></a>
+
+<p>This script generates HTML reports about translations of a given team.
+The HTML contains a set of tables sorted by priority and translation
+status (existing translations that need maintenance, untranslated
+files, complete translations).
+</p>
+<a name="index-priorities_002emk-3"></a>
+<p>The script depends on the presence of the <samp>priorities.mk</samp> file
+in the <samp>server/gnun</samp> subdirectory of the working copy of
‘www’
+repository.
+</p>
+<p>The results are written to standard output. Example:
+</p>
+<div class="example">
+<pre class="example">gnun-report --root=../www -t bg > report-bg.html
+</pre></div>
+
+<dl compact="compact">
+<dt><samp>-t</samp></dt>
+<dt><samp>--team=<var>lang</var></samp></dt>
+<dd><p>Specify the language code of the team, for example, ‘ml’.
+</p>
+</dd>
+<dt><samp>--root</samp></dt>
+<dd><p>Specify the top directory of the working copy; the default
+is the current directory.
+</p>
+</dd>
+<dt><samp>-l</samp></dt>
+<dt><samp>--language=<var>language</var></samp></dt>
+<dd><p>Specify the language name, for example, ‘Malayalam’. When
this option
+is missing, <code>gnun-report</code> tries to figure out the language name
+based on the language code provided with the “-t” option.
+</p>
+</dd>
+<dt><samp>--version</samp></dt>
+<dd><p>Display copyright and version information and exit.
+</p>
+</dd>
+<dt><samp>--help</samp></dt>
+<dd><p>Display usage information and exit.
+</p></dd>
+</dl>
+
+<p>There is also a target in <samp>GNUmakefile</samp> to generate text reports
+intended for monthly messages sent to the teams. See <a
href="report.html#report">report</a>.
+</p>
+
+
+
+</body>
+</html>
Index: gnun_002ddiff_002dpo.html
===================================================================
RCS file: gnun_002ddiff_002dpo.html
diff -N gnun_002ddiff_002dpo.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ gnun_002ddiff_002dpo.html 4 Dec 2012 16:26:16 -0000 1.1
@@ -0,0 +1,122 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<!--
+This manual (updated 3 December 2012) is for GNUnited Nations (version
+0.6), a suite for maintaining translations of www.gnu.org
+essays and other articles.
+
+
+Copyright (C) 2008, 2009, 2010, 2011, 2012 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.90, http://www.gnu.org/software/texinfo/ -->
+<head>
+<title>GNUnited Nations: gnun-diff-po</title>
+
+<meta name="description" content="GNUnited Nations: gnun-diff-po">
+<meta name="keywords" content="GNUnited Nations: gnun-diff-po">
+<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="Scripts.html#Scripts" rel="up" title="Scripts">
+<link href="gnun_002dinit_002dpo.html#gnun_002dinit_002dpo" rel="next"
title="gnun-init-po">
+<link
href="gnun_002dadd_002dfuzzy_002ddiff.html#gnun_002dadd_002dfuzzy_002ddiff"
rel="previous" title="gnun-add-fuzzy-diff">
+<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="gnun_002ddiff_002dpo"></a>
+<div class="header">
+<p>
+Next: <a href="gnun_002dinit_002dpo.html#gnun_002dinit_002dpo" accesskey="n"
rel="next">gnun-init-po</a>, Previous: <a
href="gnun_002dadd_002dfuzzy_002ddiff.html#gnun_002dadd_002dfuzzy_002ddiff"
accesskey="p" rel="previous">gnun-add-fuzzy-diff</a>, Up: <a
href="Scripts.html#Scripts" accesskey="u" rel="up">Scripts</a> [<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="The-gnun_002ddiff_002dpo-Script"></a>
+<h4 class="subsection">3.1.2 The <code>gnun-diff-po</code> Script</h4>
+<a name="index-comparing_002c-translations"></a>
+
+<p>This script compares two versions of a PO file. It produces a HTML page
+with a table that contains original strings with highlighted differences
+of their translations.
+</p>
+<p>If the sets of original strings in the input PO files differ, one of
+them will be merged with the other in order to eliminate the differences
+in the original strings.
+</p>
+<p>The results are written to standard output. Example:
+</p>
+<div class="example">
+<pre class="example">gnun-diff-po [OPTION...] PO_FILE1 PO_FILE2 > diff.html
+</pre></div>
+
+<dl compact="compact">
+<dt><samp>-1</samp></dt>
+<dt><samp>--merge-against-first</samp></dt>
+<dd><p>Adjust the original strings of PO_FILE2 against PO_FILE1 when their
+sets differ. This is the default.
+</p>
+</dd>
+<dt><samp>-2</samp></dt>
+<dt><samp>--merge-against-second</samp></dt>
+<dd><p>Adjust the original strings of PO_FILE1 against PO_FILE2 when their
+sets differ.
+</p>
+</dd>
+<dt><samp>-t</samp></dt>
+<dt><samp>--title=<var>title</var></samp></dt>
+<dd><p>Specify the title of the output HTML page.
+</p>
+</dd>
+<dt><samp>--version</samp></dt>
+<dd><p>Display copyright and version information and exit.
+</p>
+</dd>
+<dt><samp>--help</samp></dt>
+<dd><p>Display usage information and exit.
+</p></dd>
+</dl>
+
+
+
+
+</body>
+</html>
Index: GNUmakefile_002eteam-Targets.html
===================================================================
RCS file: GNUmakefile_002eteam-Targets.html
diff -N GNUmakefile_002eteam-Targets.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ GNUmakefile_002eteam-Targets.html 4 Dec 2012 16:26:16 -0000 1.1
@@ -0,0 +1,179 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<!--
+This manual (updated 3 December 2012) is for GNUnited Nations (version
+0.6), a suite for maintaining translations of www.gnu.org
+essays and other articles.
+
+
+Copyright (C) 2008, 2009, 2010, 2011, 2012 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.90, http://www.gnu.org/software/texinfo/ -->
+<head>
+<title>GNUnited Nations: GNUmakefile.team Targets</title>
+
+<meta name="description" content="GNUnited Nations: GNUmakefile.team Targets">
+<meta name="keywords" content="GNUnited Nations: GNUmakefile.team Targets">
+<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-and-Team.html#PO-Files-and-Team" rel="up" title="PO Files
and Team">
+<link href="GNUmakefile_002eteam-and-Cron.html#GNUmakefile_002eteam-and-Cron"
rel="next" title="GNUmakefile.team and Cron">
+<link
href="GNUmakefile_002eteam-Variables.html#GNUmakefile_002eteam-Variables"
rel="previous" title="GNUmakefile.team Variables">
+<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="GNUmakefile_002eteam-Targets"></a>
+<div class="header">
+<p>
+Next: <a
href="GNUmakefile_002eteam-and-Cron.html#GNUmakefile_002eteam-and-Cron"
accesskey="n" rel="next">GNUmakefile.team and Cron</a>, Previous: <a
href="GNUmakefile_002eteam-Variables.html#GNUmakefile_002eteam-Variables"
accesskey="p" rel="previous">GNUmakefile.team Variables</a>, Up: <a
href="PO-Files-and-Team.html#PO-Files-and-Team" accesskey="u" rel="up">PO Files
and Team</a> [<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="Targets-in-GNUmakefile_002eteam"></a>
+<h4 class="subsubsection">2.3.7.2 Targets in <samp>GNUmakefile.team</samp></h4>
+
+<dl compact="compact">
+<dt><code>update</code></dt>
+<dd><p>Updates the repositories. Does nothing unless <code>VCS=yes</code>.
+</p>
+</dd>
+<dt><code>sync</code></dt>
+<dd><p>Merges all available PO files from the corresponding POT in
<em>www</em>.
+If a POT is missing in the master repository (usually, because it was
+deleted when the original article was either split, renamed or deleted),
+a warning is printed for the corresponding file and no merging occurs
+for it.
+</p>
+</dd>
+<dt><code>report</code></dt>
+<dd><p>Verifies which translations are complete, and prints a list (with
+statistics) of those that need to be updated.
+</p>
+</dd>
+<dt><code>format</code></dt>
+<dd><p>A convenience rule to re-wrap all files upto the standard length. Most
+PO editors leave the <code>msgstr</code> as a single long line after it has
+been edited, but GNUN will automatically re-wrap the file to the standard
+line length when it is processed. Wrapping long lines in PO files is a
+good practice as it avoids unnecessary revisions.
+</p>
+<p>This rule checks for all translations that have lines longer than 80,
+and runs <code>msgcat</code> accordingly to reformat them. For that
+reason, it is recommended that you wrap all long lines in the comment
+fields (e.g. the file header, including the copyright statement, and any
+other comments for specific messages), because <code>make format</code> will
+unnecessarily invoke <code>msgcat</code> for any file that has a longer
+line, wherever it may occur.
+</p>
+</dd>
+<dt><code>publish</code></dt>
+<dd><p>The <code>publish</code> rule’s task is to copy all modified
files to the
+official <em>www</em> repository. It depends on the <code>format</code> target
+to ensure that all files are re-wrapped to the standard line length
+limit, but deliberately does not depend on <code>sync VCS=yes</code>.
+Usually, one would run <code>make publish</code> when one or a bunch of PO
+files are in a satisfactory condition to be published, and this rule is
+just a convenience to avoid multiple manual <code>cp</code> invocations.
+As a rule of thumb, before running this rule it is sane to run
+<code>sync</code> and correct any <em>fuzzy</em> messages and other problems,
if
+necessary.
+</p>
+<p>The <code>publish</code> rule does not depend on <code>sync</code>
explicitly,
+because that would be a nuisance for offline operations and basically
+unnecessary when the committer is fairly confident that there are no
+changes to (re-)merge. A hard dependency on <code>sync</code> would slow down
+the operation considerably.
+</p>
+<p>As usual, when committing to the official repository, it is always a
+good practice to examine the output of <code>cvs diff</code>.
+</p>
+<p>Invoking <code>make publish</code> prints warnings and does not actually
copy
+the affected file if the sub-directory in “www” is non-existent or
the
+corresponding <samp>.pot</samp> is missing.
+</p>
+<p>Typically, after an editing session (whether it involves actual editing
+or just merging contributions from team members), one would do:
+</p>
+<div class="example">
+<pre class="example">$ make sync VCS=yes
+$ make publish
+$ cd <var>wwwdir</var>
+$ cvs up
+(Add all new translations, if any.)
+ $ cvs add <var>file</var> …
+$ cvs diff
+$ cvs commit -m "Some descriptive message."
+</pre></div>
+
+</dd>
+<dt><code>clean</code></dt>
+<dd><p>Deletes all backup and auto-generated files that some PO editors leave
+behind, namely—<samp><var>file</var>.po~</samp>,
<samp><var>file</var>.po.bak</samp> and
+<samp><var>file</var>.mo</samp>.
+</p></dd>
+</dl>
+
+<p><code>make VCS=yes</code> is the recommended command to be run periodically.
+To check the status of the translations, run <code>make report</code>.
+</p>
+<p>Feel free to replace all strings with equivalents in your native
+language and of course—do not hesitate to extend this file and modify
+it as much as you like. For example, useful extra functionality would
+be a target that will check which files have not yet been committed in
+the official repository, or which files have to be updated there
+(i.e. they were updated by the team members but not installed by the
+coordinator). Either way, if you come up with something interesting, it
+would be nice to send a message to <a
href="mailto:address@hidden";>address@hidden</a>, so that
+<samp>GNUmakefile.team</samp> gets updated for all teams’ benefit.
+</p>
+<hr>
+<div class="header">
+<p>
+Next: <a
href="GNUmakefile_002eteam-and-Cron.html#GNUmakefile_002eteam-and-Cron"
accesskey="n" rel="next">GNUmakefile.team and Cron</a>, Previous: <a
href="GNUmakefile_002eteam-Variables.html#GNUmakefile_002eteam-Variables"
accesskey="p" rel="previous">GNUmakefile.team Variables</a>, Up: <a
href="PO-Files-and-Team.html#PO-Files-and-Team" accesskey="u" rel="up">PO Files
and Team</a> [<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>
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- trans-coord/manual/gnun/html_node gnun_002drepo...,
Pavel Kharitonov <=