Makefile.gen: reorganize recipes and explanations; add note on img localization.
authorThérèse Godefroy <godef.th@free.fr>
Tue, 26 Sep 2017 12:18:22 +0000 (14:18 +0200)
committerThérèse Godefroy <godef.th@free.fr>
Tue, 26 Sep 2017 12:19:15 +0000 (14:19 +0200)
Makefile.gen

index 1e95614db5971970c60e20c3cf73ee306f8e154f..f5f9618f55202352c08c48c47f5d2ff5a61708f1 100644 (file)
 
 # usage: make -f Makefile.gen
 
+# IMPORTANT
+# 1. Make sure your esd-LANG.po is encoded in unix format (end
+#    of line \n, not DOS \n\r), otherwise po4a-translate complains
+#    about strange lines.
+# 2. Before generating a page for publication, make sure the PO has no
+#    untranslated or fuzzy strings, otherwise the translation will be
+#    interspersed with English strings.
+
+
+# In LANG add the code(s) of the language(s) you intend to translate
+LANG=es
+
 # flags for the po4a-getextize
 PO4A_FLAGS=-M utf-8 -f xhtml --keep 30 -o porefs=none \
            -o 'untranslated=<script>' \
@@ -25,65 +37,53 @@ SRC=confirmation.html\
        windows.html\
        workshops.html
 
-# list of languages that use the PO files (add yours if you migrate to PO)
-#    Czech - cs, Persian - fa, Japanese - ja, Spanish - es,
-#    Chinese (Han script)- zh-hans, Albanian - sq
-
-# In LANG add the code(s) of the language(s) you intend to translate
-LANG=es
-
-# NOTE:
-# The following replacement is essential in right to left languages
-# sed -i 's|<html|<html dir="rtl"|' $@
-# See Persian recipe as an example
-
-# IMPORTANT
-# 1. Make sure your esd-lang.po is encoded in unix format (end
-#    of line \n, not DOS \n\r), otherwise po4a-translate complains
-#    about strange lines.
-# 2. Before generating a page for publication, make sure the PO has no
-#    untranslated or fuzzy strings, otherwise the translation will be
-#    interspersed with English strings.
-
-
 # default target
 all: $(foreach l,$(LANG),$(foreach f,$(SRC),$l/$f))
 
 
 ## RECIPES for the individual pages in each language
 
-# Czech
+# Add yours if you migrate to PO, keeping the alphabetical order.
+
+# NOTES
+# 1. You can use another recipe as a model, but be careful with global image
+#    localization; make sure that _all_ the images are in the static/LANG/img
+#    subdirectory.
+# 2. The following modifications are essential in right to left languages:
+#      sed -i 's|<html|<html dir="rtl"|' $@
+#      sed -i '/\/css\/main.css/a\
+#      <link rel="stylesheet" href="//static.fsf.org/nosvn/enc-dev0/css/main.rtl.css" />' $@
+#    See Persian recipe as an example.
+
+# cs - Czech
 # sed -i 's|<li><a href="/en">English - v4.0</a></li>|<li><a class="current" href="/cs">Čeština - v4.0</a></li>\
 #                              <li><a href="/en">English - v4.0</a></li>|' $@
 cs/%.html: esd-cs.po $(foreach f,$(SRC),en/$f)
        -po4a-translate $(PO4A_FLAGS) -m en/$*.html -p $< -l $@
        sed -i 's|img/en/|img/cs/|g' $@
 
-# Persian
+# es - Spanish
+es/%.html: esd-es.po $(foreach f,$(SRC),en/$f)
+       -po4a-translate $(PO4A_FLAGS) -m en/$*.html -p $< -l $@
+       sed -i '/\/css\/main.css/a\
+       <link rel="stylesheet" href="//static.fsf.org/nosvn/enc-dev0/css/main.es.css" />' $@
+
+# fa - Persian
 fa/%.html: esd-fa.po $(foreach f,$(SRC),en/$f)
        -po4a-translate $(PO4A_FLAGS) -m en/$*.html -p $< -l $@
        sed -i 's|<html|<html dir="rtl"|' $@
        sed -i '/\/css\/main.css/a\
        <link rel="stylesheet" href="//static.fsf.org/nosvn/enc-dev0/css/main.rtl.css" />' $@
 
-# Japanese
+# ja - Japanese
 ja/%.html: esd-ja.po $(foreach f,$(SRC),en/$f)
        -po4a-translate $(PO4A_FLAGS) -m en/$*.html -p $< -l $@
 
-# Spanish
-es/%.html: esd-es.po $(foreach f,$(SRC),en/$f)
+# sq - Albanian
+sq/%.html: esd-sq.po $(foreach f,$(SRC),en/$f)
        -po4a-translate $(PO4A_FLAGS) -m en/$*.html -p $< -l $@
-       sed -i '/\/css\/main.css/a\
-       <link rel="stylesheet" href="//static.fsf.org/nosvn/enc-dev0/css/main.es.css" />' $@
 
-# Chinese (Han)
+# zh-han - Chinese (Han)
 zh-hans/%.html: esd-zh-hans.po $(foreach f,$(SRC),en/$f)
        -po4a-translate $(PO4A_FLAGS) --keep 0 -m en/$*.html -p $< -l $@
-       sed -i 's|<li><a class="current" href="/en">English - v4.0</a></li>|<li><a href="/en">English - v4.0</a></li>|' $@
-       sed -i 's|<li><a href="/zh-hans">简体中文 - v4.0</a></li>|<li><a class="current" href="/zh-hans">简体中文 - v4.0</a></li>|' $@
-
-#  (copy the recipe for your language if you migrate to PO)
 
-# Albanian
-sq/%.html: esd-sq.po $(foreach f,$(SRC),en/$f)
-       -po4a-translate $(PO4A_FLAGS) -m en/$*.html -p $< -l $@