From: Gunnar Wolf <gwolf@gwolf.org>
Date: Wed, 19 Jul 2017 05:00:48 +0000 (-0500)
Subject: Instructions on how to generate a first output document
X-Git-Tag: es-printed~768^2~1
X-Git-Url: https://pere.pagekite.me/gitweb/text-madewithcc.git/commitdiff_plain/0c7181323713159358415884d4a26450a3697565?hp=b2d7de75778cc23e7cd5358f706c2ce84ca58b88

Instructions on how to generate a first output document
---

diff --git a/HOWTO.md b/HOWTO.md
index 8a664db..a14ccee 100644
--- a/HOWTO.md
+++ b/HOWTO.md
@@ -87,3 +87,44 @@ been accepted as a hosted project
 [hosted project in the Weblate online translation coordination service](https://weblate.org/projects/madewithcc). Weblate
 is completely based on free software tools, we invite you to get
 familiar with their interface.
+
+## Building the translated Markdown file
+
+`po4a` provides a tool to integrate the translation back into a
+Markdown document, `po4a-translate`. I have only made first attempts
+with it, and we need to find ways to do several improvements. However,
+the following command will give you a good glimpse on how your
+finished translation looks:
+
+    po4a-translate -f text -m MadewithCreativeCommonsup-to-dateversion.md -p po/es/mwcc.po -l MadewithCreativeCommonsup-to-dateversion.es.md -l MadewithCreativeCommonsup-to-dateversion.es.md -L utf8 -M utf8 -k 20
+
+What does it all mean?
+
+    -f text
+
+The base format to/from which the translation is done is plain text.
+
+       -m MadewithCreativeCommonsup-to-dateversion.md
+
+The name of your source document.
+
+       -p po/es/mwcc.po
+
+Which translation to use. In this case, Spanish translation.
+
+       -l MadewithCreativeCommonsup-to-dateversion.es.md
+
+Filename to use for the created translation. Do note that I'm
+specifying a name that implies Spanish.
+
+       -L utf8 -M utf8
+
+Which character sets to use, both for the source and destination
+files.
+
+       -k 20
+
+Minimum translation percentage for which to produce output. The
+default is 80% — To get a glimpse of your work in the early stages of
+a translation, use `-k` with a value smaller than the percentage you
+have achieved.