| Converters (*Experimental*) | |
| =========================== | |
| Convert HWPv5 documents into other document formats. | |
| Requirements | |
| ------------ | |
| The conversions are performed with `XSLT <http://www.w3.org/TR/xslt>`_ | |
| internally and verified with `Relax NG <http://relaxng.org/>`_ if possible. | |
| For these processing, the converters requires | |
| `lxml <http://pypi.python.org/pypi/lxml>`_ (`homepage <http://lxml.de>`_) or | |
| `libxml2 <http://www.xmlsoft.org/>`_'s | |
| `xsltproc <http://xmlsoft.org/XSLT/xsltproc2.html>`_ / | |
| `xmllint <http://infohost.nmt.edu/tcc/help/xml/lint.html>`_ programs. | |
| For lxml installation:: | |
| pip install --user lxml # install to user directory | |
| pip install lxml # install with virtualenv | |
| or see `Installing lxml <http://lxml.de/installation.html>`_. | |
| (Currently conversions with lxml 2.3.5 is tested and verified to be working. | |
| lxml versions below that may work too, but those are not tested.) | |
| For ``xsltproc`` / ``xmllint`` installation:: | |
| sudo apt-get install xsltproc libxml2-utils # Debian/Ubuntu | |
| Optional environment variables ``PYHWP_XSLTPROC`` and ``PYHWP_XMLLINT`` | |
| specifies the paths of the each programs. (If not set, ``xsltproc`` and/or | |
| ``xmllint`` should be in the one of the directories specified in ``PATH``.) | |
| ``hwp5odt``: ODT conversion | |
| --------------------------- | |
| .. argparse:: | |
| :module: hwp5.hwp5odt | |
| :func: main_argparser | |
| :prog: hwp5odt | |
| ``hwp5html``: HTML conversion | |
| ----------------------------- | |
| .. argparse:: | |
| :module: hwp5.hwp5html | |
| :func: main_argparser | |
| :prog: hwp5html | |
| ``hwp5txt``: text conversion | |
| ---------------------------- | |
| .. argparse:: | |
| :module: hwp5.hwp5txt | |
| :func: main_argparser | |
| :prog: hwp5txt | |