.. _html2po:
.. _po2html:
html2po
*******
Convert translatable items in HTML to the PO format.
.. _html2po#usage:
Usage
=====
::
html2po [options]
po2html [options]
Where:
+---------+-----------------------------------------------+
| | is an HTML file or a directory of HTML files |
+---------+-----------------------------------------------+
| | is a PO file or directory of PO files |
+---------+-----------------------------------------------+
Options (html2po):
--version show program's version number and exit
-h, --help show this help message and exit
--manpage output a manpage based on the help
--progress=PROGRESS show progress as: :doc:`dots, none, bar, names, verbose `
--errorlevel=ERRORLEVEL
show errorlevel as: :doc:`none, message, exception,
traceback `
-i INPUT, --input=INPUT read from INPUT in htm, html, xhtml formats
-x EXCLUDE, --exclude=EXCLUDE exclude names matching EXCLUDE from input paths
-o OUTPUT, --output=OUTPUT write to OUTPUT in po, pot formats
-S, --timestamp skip conversion if the output file has newer timestamp
-P, --pot output PO Templates (.pot) rather than PO files (.po)
-u, --untagged include untagged sections
--keepcomments preserve html comments as translation notes in the output
--duplicates=DUPLICATESTYLE
what to do with duplicate strings (identical source
text): :doc:`merge, msgctxt `
(default: 'msgctxt')
Options (po2html):
--version show program's version number and exit
-h, --help show this help message and exit
--manpage output a manpage based on the help
--progress=PROGRESS show progress as: :doc:`dots, none, bar, names, verbose `
--errorlevel=ERRORLEVEL
show errorlevel as: :doc:`none, message, exception,
traceback `
-i INPUT, --input=INPUT read from INPUT in po, pot formats
-x EXCLUDE, --exclude=EXCLUDE exclude names matching EXCLUDE from input paths
-o OUTPUT, --output=OUTPUT write to OUTPUT in htm, html, xhtml formats
-t TEMPLATE, --template=TEMPLATE read from TEMPLATE in htm, html, xhtml formats
-S, --timestamp skip conversion if the output file has newer timestamp
--threshold=PERCENT only convert files where the translation completion is above PERCENT
--fuzzy use translations marked fuzzy
--nofuzzy don't use translations marked fuzzy (default)
.. _html2po#examples:
Examples
========
::
html2po -P site pot
This will find all HTML files (.htm, .html, .xhtml) in *site*, convert them to
POT files and place them in *pot*.
You can create and update PO files for different languages using the
:doc:`pot2po` command.
::
po2html -t site -i xh -o site-xh
All the PO translations in *xh* will be converted to HTML using HTML files in
*site* as templates and outputting new translated HTML files in *site-xh*.
.. _html2po#notes:
Notes
=====
The :doc:`HTML format description ` gives more details on the
format of the localisable HTML content and the capabilities of this converter.
.. _html2po#bugs:
Bugs
====
Some items end up in the msgid's that should not be translated