From owner-freebsd-doc@FreeBSD.ORG  Sat Sep 18 12:24:56 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 6982E16A4CE
	for <freebsd-doc@freebsd.org>; Sat, 18 Sep 2004 12:24:56 +0000 (GMT)
Received: from redqueen.elvandar.org (cust.94.120.adsl.cistron.nl
	[195.64.94.120])
	by mx1.FreeBSD.org (Postfix) with ESMTP id CABEB43D1F
	for <freebsd-doc@freebsd.org>; Sat, 18 Sep 2004 12:24:55 +0000 (GMT)
	(envelope-from remko@elvandar.org)
Received: from [10.0.2.122] (nimrod.elvandar.intranet [10.0.2.122])
	by redqueen.elvandar.org (Postfix) with ESMTP id 2C5C910685E
	for <freebsd-doc@freebsd.org>; Sat, 18 Sep 2004 14:24:53 +0200 (CEST)
Message-ID: <414C2915.8000309@elvandar.org>
Date: Sat, 18 Sep 2004 14:24:53 +0200
From: Remko Lodder <remko@elvandar.org>
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: freebsd-doc@freebsd.org
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Virus-Scanned: by amavisd-new at elvandar.org
Subject: Question regarding 'placeholders' (Translations)
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 18 Sep 2004 12:24:56 -0000

Hi there,

I asked in a reply to Xin Li and Denis Peplin, i want to define
a correct and global agreement on how we as translation teams
should use placeholders.

The Dutch Project follows the style of the German Project,
while the Russian Project does that in another way.

How do the German/Dutch projects handle the placeholders?

Like this:

<sect1>
   <title>* Translated title</title>

   <para></para>
</sect1>

How does the Russian Project handle this?

<sect1>
   <title>Translated title *</title>

   <para></para>
</sect1>

Can we please decide what works best, and use that globally?

I added a little thing to my personal fdp-primer regarding this,
since i think it should also be documented.

Since this is my first try in writing such a thing, i would like you 
(doc team) to give comments on it ;)

The diff is below:
(Ofcourse the correct syntax should reflect whatever we agree upon).

Thanks,
Remko (Dutch Project)

--- chapter_orig.sgml   Sat Aug 14 14:35:33 2004
+++ chapter.sgml        Sat Sep 18 14:20:02 2004
@@ -442,6 +442,32 @@
  --&gt;</programlisting>
        </answer>
      </qandaentry>
+
+    <qandaentry>
+      <question>
+       <para>How should i handle untranslated documents when i want to
+         import them into the &os; cvs tree?</para>
+      </question>
+
+      <answer>
+       <para>If you have untranslated documents, or documents which are
+         not yet reviewed, you should use so called
+         <quote>placeholders</quote>. The correct syntax for using
+         those placeholders is:</para>
+
+       <programlisting>  &lt;sect1&gt;
+    &lt;title&gt;* Translated title&lt;/title&gt;
+
+    &lt;para&gt;&lt;/para&gt;
+  &lt;/sect1&gt;</programlisting>
+
+        <para>The para statements are used to fill the sections.  If
+         they do not exist it will result in a failing build.  If
+         you have a sect2 or deeper statement in your chapter, please
+         put the para statements in the deepest section.</para>
+
+      </answer>
+    </qandaentry>
    </qandaset>
  </chapter>

-- 
Kind regards,

Remko Lodder                   |remko@elvandar.org
Reporter DSINet                |remko@dsinet.org
Projectleader Mostly-Harmless  |remko@mostly-harmless.nl