html2po¶
Convert translatable items in HTML to the PO format.
Usage¶
html2po [options] <html> <po>
po2html [options] <po> <html>
Where:
<html> |
is an HTML file or a directory of HTML files |
<po> |
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: dots, none, bar, names, verbose
- --errorlevel=ERRORLEVEL
show errorlevel as: 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): 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: dots, none, bar, names, verbose
- --errorlevel=ERRORLEVEL
show errorlevel as: 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)
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 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.
Notes¶
The HTML format description gives more details on the format of the localisable HTML content and the capabilities of this converter.
Bugs¶
Some items end up in the msgid’s that should not be translated