---
name: "html2po"
section: "1"
platform: "linux"
package: "translate-toolkit"
version: "3.15.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/html2po"
---

# html2po(1)

Convert HTML files to Gettext PO localization files.

## NAME

html2po -  Convert HTML files to Gettext PO localization files.

## SYNOPSIS

**html2po** \[**--version**\] \[**-h**\|**--help**\] \[**--manpage**\] \[**--progress** *PROGRESS*\] \[**--errorlevel** *ERRORLEVEL*\] \[**-i**\|**--input**\] *INPUT* \[**-x**\|**--exclude** *EXCLUDE*\] \[**-o**\|**--output**\] *OUTPUT* \[**-S**\|**--timestamp**\] \[**-P**\|**--pot**\] \[**--keepcomments**\] \[**--duplicates** *DUPLICATESTYLE*\] \[**--multifile** *MULTIFILESTYLE*\]

## DESCRIPTION

See: http://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/html2po.html for examples and usage instructions.

## OPTIONS

- \--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

  show progress as: dots, none, bar, names, verbose

- \--errorlevel

  show errorlevel as: none, message, exception, traceback

- \-i/--input

  read from INPUT in htm, html, xhtml formats

- \-x/--exclude

  exclude names matching EXCLUDE from input paths

- \-o/--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)

- \--keepcomments

  preserve html comments as translation notes in the output

- \--duplicates

  what to do with duplicate strings (identical source text): merge, msgctxt (default: 'msgctxt')

- \--multifile

  how to split po/pot files (single, toplevel or onefile)