Skip to content

Latest commit

 

History

History
 
 

locale

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
en/LC_MESSAGES
en/LC_MESSAGES
 
 
es/LC_MESSAGES
es/LC_MESSAGES
 
 
ja/LC_MESSAGES
ja/LC_MESSAGES
 
 
pot
pot
 
 
README.md
README.md
 
 

README.md

Locale

Currently the setup is for es

Building the LOCALE:

Use this when the English documentation changed.

cd build
#rm -rf *   #BE VERY CAREFULL
cmake -D LOCALE=ON ..
make locale
cd ..
sphinx-intl update -d locale

When there is a new resource

sphinx-intl update-txconfig-resources --locale-dir locale --pot-dir locale/pot --transifex-project-name pgrouting

review

for f in locale/pot/*; do echo $f; grep $f .tx/config; done
for f in `grep '\.pot' .tx/config | sed 's/^.*pot\/\(.*\)$/\1/' | grep '\.pot'` ; do  echo $f; ls locale/pot/* | grep $f  ; done

commit changes and push

Cleanup unused messages

Hint

for f in ${FILE}
do
    echo one ${f}
    grep '#~' ${f}
    msgattrib --output-file=${f} --no-obsolete ${f}
    echo two
    grep '#~' ${f}
done

MANAGERS: Interaction with transifex:

Push the resource to transifex

Push a New or changed resource:

  • New resource

Add the resource to the .tx/config located at the root of the repository (Use as example the other resources)

vim ../.tx/config
  • Push the new resource
tx push --source -r pgrouting.pgr_createVerticesTable

Note: Do not put the file extension

NOTE: INFORM: A documentation frezze to let translators translate

Pull the resources from transifex

Be patient takes time (I like the -d flag just to know what is being downloaded)

  • this pulls all the translations
tx -d pull -f
  • this pulls the Spanish translations
tx -d pull -f -l es

TRANSLATORS

For this example the translator is translating pgr_createVerticesTable to Spanish

  • Step 1: Build a local documentation
cd build
rm -rf *
cmake -D HTML=ON -D ES=ON ..
make html-es
  • Step 2: Navigate to the page you are translating:

On the Browser go to:

file:///path/to/build/doc/_build/html/es/pgr_createVerticesTable.html
  • Step 3: Pull the translation & build the documentation & refresh browser
tx pull -r pgrouting.pgr_createVerticesTable -l es
make html-es

Refresh browser

Building the documentation:

NOTE: in any case English is always build

  • Building all languages
cmake -D HTML=ON -D WITH_ALL_LANG=ON ..
make doc
  • Building a a particular language

This example shows Spanish:

cmake -D HTML=ON -D ES=ON ..
make html
  • Building a particular language

This example shows Spanish:

make -D HTML=ON -D SINGLEHTML=OM -D ES=ON ..
make html
make singlehtml
# OR to build both:
make doc

References