Translate Toolkit
-----------------
.. image:: https://img.shields.io/gitter/room/translate/pootle.svg?style=flat-square
:alt: Join the chat at https://gitter.im/translate/pootle
:target: https://gitter.im/translate/pootle
.. image:: https://github.com/translate/translate/workflows/Test/badge.svg
:alt: Build Status
:target: https://github.com/translate/translate/actions
.. image:: https://img.shields.io/codecov/c/github/translate/translate/master.svg?style=flat-square
:alt: Test Coverage
:target: https://codecov.io/gh/translate/translate/branch/master
.. image:: https://api.dependabot.com/badges/status?host=github&repo=translate/translate
:target: https://app.dependabot.com/accounts/translate/repos/3769696
:alt: Requirements
.. image:: https://img.shields.io/pypi/v/translate-toolkit.svg?style=flat-square
:alt: Released version
:target: https://pypi.python.org/pypi/translate-toolkit/
.. image:: https://img.shields.io/pypi/pyversions/translate-toolkit.svg?style=flat-square
:alt: Supported Python versions
:target: https://pypi.python.org/pypi/translate-toolkit/
.. image:: https://img.shields.io/pypi/l/translate-toolkit.svg?style=flat-square
:target: https://pypi.python.org/pypi/translate-toolkit/
:alt: License
The Translate Toolkit is a set of software and documentation designed to help
make the lives of localizers both more productive and less frustrating. The
Toolkit is part of the Translate project, hosted at
<https://github.com/translate>.
The software includes programs to convert localization formats to the common
PO, and emerging XLIFF format. There are also programs to check and manage PO
and XLIFF files. Online documentation includes guides on using the tools,
running a localization project and how to localize various projects from
OpenOffice.org to Mozilla.
At its core the software contains a set of classes for handling various
localization storage formats: DTD, properties, OpenOffice.org GSI/SDF,
CSV, MO, Qt .ts, TMX, TBX, WordFast txt, Gettext .mo, Windows RC, and
of course PO and XLIFF. It also provides scripts to convert between
these formats.
Also part of the Toolkit are Python programs to create word counts, merge
translations and perform various checks on translation files.
Important Links
---------------
* `Latest release downloads <https://github.com/translate/translate/releases>`_
* `Documentation
<http://docs.translatehouse.org/projects/translate-toolkit/en/latest/>`_,
also use ``--help`` with any of the commands.
* The Translate Toolkit is released under the `GPL
<https://github.com/translate/translate/blob/master/COPYING>`_ with
`contributions from many people
<https://github.com/translate/translate/blob/master/CREDITS>`_.
* `Reporting issues <https://github.com/translate/translate/issues>`_
* `Installation <http://docs.translatehouse.org/projects/translate-toolkit/en/stable/installation.html>`_
Joining the Translate Project
-----------------------------
If you would like to join the translate project mailing list then visit:
<http://lists.sourceforge.net/lists/listinfo/translate-devel>.
The vision of the Translate Project is to be a meta project for localizers
built on the premise that your language deserves to be a project on its own
right not a poor cousin of the main project.
Most projects are inattentive to the needs and difficulties experienced by
localizers. To that end the aim is to work towards creating tools and
documentation that allows localizers to focus on what they do best: translating
software.
Requirements
------------
There are several extra requirements which you might to install to get full
feature set. This cal be easily specified during pip installation::
# Install with XML support
pip install translate-toolkit[XML]
# Install all optional dependencies
pip install translate-toolkit[all]
.. note:: Please check ``requirements/*.txt``::
pip install -r requirements/optional.txt
Will install all optional dependencies convering support for many other
formats.
The Toolkit requires Python 3.8 or newer.
The package lxml is required. You should install version 4.6.3 or later.
<http://lxml.de/> Depending on your platform, the easiest way to install might
be through your system's package management. Alternatively you can try ::
pip install lxml
which should install the newest version from the web.
For Mac OSX, the following pages might be of help:
<http://lxml.de/build.html#building-lxml-on-macos-x>
<http://lxml.de/installation.html#macos-x>
The package lxml has dependencies on libxml2 and libxslt. Please check the lxml
site for the recommended versions of these libraries if you need to install
them separately at all. Most packaged versions of lxml will already contain
these dependencies.
When the environment variable USECPO is set to 1, the toolkit will attempt to
use libgettextpo from the gettext-tools package (it might have a slightly
different name on your distribution). This can greatly speed up access to PO
files, but has not yet been tested as extensively. Feedback is most welcome.
The package iniparse is necessary for ini2po and po2ini:
<https://pypi.org/project/iniparse/>
The python-Levenshtein package will improve performance for fuzzy matching if
it is available. This can improve the performance of pot2po, for example. It
is optional and no functionality is lost if it is not installed, only speed.
<http://sourceforge.net/projects/translate/files/python-Levenshtein/>
Functions in the `lang.data` module can supply functions to translate language
names using the `pycountry` package. It can even translate names in the format
``Language (Country)`` such as ``English (South Africa)`` This is used by
Pootle and Virtaal. If the package is not installed, the language names will
simply appear in English. It is therefore recommended you install the
`pycountry` package.
The package vobject is needed for ical2po and po2ical.
The aeidon package is needed for sub2po
and po2sub. Some Unicode encoded files (including most files from
<http://dotsub.com/>) require version 0.14 or later.
Trados TXT TM support requires the BeautifulSoup parser
<http://www.crummy.com/software/BeautifulSoup/>
Markdown support requires the mistletoe parser
<https://github.com/miyuchina/mistletoe>
Program overview
----------------
Use ``--help`` to find the syntax and options for all programs.
* Converters::
oo2po - convert between OpenOffice.org GSI files and PO
oo2xliff - convert between OpenOffice.org GSI files and XLIFF
moz2po - convert between Mozilla files and PO
csv2po - convert PO format to CSV for editing in a spreadsheet program
php2po - PHP localisable string arrays converter.
ts2po - convert Qt Linguist (.ts) files to PO
txt2po - convert simple text files to PO
html2po - convert HTML to PO (beta)
md2po - convert Markdown to PO
xliff2po - XLIFF (XML Localisation Interchange File Format) converter
prop2po - convert Java .properties files to PO
po2wordfast - Wordfast Translation Memory converter
po2tmx - TMX (Translation Memory Exchange) converter
pot2po - PO file initialiser
csv2tbx - Create TBX (TermBase eXchange) files from Comma Separated
Value (CSV) files
ini2po - convert .ini files to to PO
ical2po - Convert iCalendar files (*.ics) to PO
sub2po - Convert many subtitle files to PO
resx2po - convert .Net Resource (.resx) files to PO
* Tools (Quality Assurance)::
pofilter - run any of the 40+ checks on your PO files
pomerge - merge corrected translations from pofilter back into
your existing PO files.
poconflicts - identify conflicting use of terms
porestructure - restructures po files according to poconflict directives
pogrep - find words in PO files
* Tools (Other)::
pocompile - create a Gettext MO files from PO or XLIFF files
pocount - count translatable file formats (PO, XLIFF)
podebug - Create comment in your PO files' msgstr which can
then be used to quickly track down mistranslations
as the comments appear in the application.
posegment - Break a PO or XLIFF files into sentence segments,
useful for creating a segmented translation memory.
poswap - uses a translation of another language that you
would rather use than English as source language
poterminology - analyse PO or POT files to build a list of
frequently occurring words and phrases
Raw data
{
"_id": null,
"home_page": "https://toolkit.translatehouse.org/",
"name": "translate-toolkit",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "i18n l10n gettext translate",
"author": "Translate",
"author_email": "translate-devel@lists.sourceforge.net",
"download_url": "https://files.pythonhosted.org/packages/54/f1/9019d19f844d0206ed671dcbfd6a8c9020af25bb021fcc861ce66d3d4e0a/translate_toolkit-3.13.0.tar.gz",
"platform": "any",
"description": "Translate Toolkit\n-----------------\n\n.. image:: https://img.shields.io/gitter/room/translate/pootle.svg?style=flat-square\n :alt: Join the chat at https://gitter.im/translate/pootle\n :target: https://gitter.im/translate/pootle\n\n.. image:: https://github.com/translate/translate/workflows/Test/badge.svg\n :alt: Build Status\n :target: https://github.com/translate/translate/actions\n\n.. image:: https://img.shields.io/codecov/c/github/translate/translate/master.svg?style=flat-square\n :alt: Test Coverage\n :target: https://codecov.io/gh/translate/translate/branch/master\n\n.. image:: https://api.dependabot.com/badges/status?host=github&repo=translate/translate\n :target: https://app.dependabot.com/accounts/translate/repos/3769696\n :alt: Requirements\n\n.. image:: https://img.shields.io/pypi/v/translate-toolkit.svg?style=flat-square\n :alt: Released version\n :target: https://pypi.python.org/pypi/translate-toolkit/\n\n.. image:: https://img.shields.io/pypi/pyversions/translate-toolkit.svg?style=flat-square\n :alt: Supported Python versions\n :target: https://pypi.python.org/pypi/translate-toolkit/\n\n.. image:: https://img.shields.io/pypi/l/translate-toolkit.svg?style=flat-square\n :target: https://pypi.python.org/pypi/translate-toolkit/\n :alt: License\n\nThe Translate Toolkit is a set of software and documentation designed to help\nmake the lives of localizers both more productive and less frustrating. The\nToolkit is part of the Translate project, hosted at\n<https://github.com/translate>.\n\nThe software includes programs to convert localization formats to the common\nPO, and emerging XLIFF format. There are also programs to check and manage PO\nand XLIFF files. Online documentation includes guides on using the tools,\nrunning a localization project and how to localize various projects from\nOpenOffice.org to Mozilla.\n\nAt its core the software contains a set of classes for handling various\nlocalization storage formats: DTD, properties, OpenOffice.org GSI/SDF,\nCSV, MO, Qt .ts, TMX, TBX, WordFast txt, Gettext .mo, Windows RC, and\nof course PO and XLIFF. It also provides scripts to convert between\nthese formats.\n\nAlso part of the Toolkit are Python programs to create word counts, merge\ntranslations and perform various checks on translation files.\n\n\nImportant Links\n---------------\n\n* `Latest release downloads <https://github.com/translate/translate/releases>`_\n* `Documentation\n <http://docs.translatehouse.org/projects/translate-toolkit/en/latest/>`_,\n also use ``--help`` with any of the commands.\n* The Translate Toolkit is released under the `GPL\n <https://github.com/translate/translate/blob/master/COPYING>`_ with\n `contributions from many people\n <https://github.com/translate/translate/blob/master/CREDITS>`_.\n* `Reporting issues <https://github.com/translate/translate/issues>`_\n* `Installation <http://docs.translatehouse.org/projects/translate-toolkit/en/stable/installation.html>`_\n\n\nJoining the Translate Project\n-----------------------------\nIf you would like to join the translate project mailing list then visit:\n<http://lists.sourceforge.net/lists/listinfo/translate-devel>.\n\nThe vision of the Translate Project is to be a meta project for localizers\nbuilt on the premise that your language deserves to be a project on its own\nright not a poor cousin of the main project.\n\nMost projects are inattentive to the needs and difficulties experienced by\nlocalizers. To that end the aim is to work towards creating tools and\ndocumentation that allows localizers to focus on what they do best: translating\nsoftware.\n\nRequirements\n------------\n\nThere are several extra requirements which you might to install to get full\nfeature set. This cal be easily specified during pip installation::\n\n # Install with XML support\n pip install translate-toolkit[XML]\n\n # Install all optional dependencies\n pip install translate-toolkit[all]\n\n.. note:: Please check ``requirements/*.txt``::\n\n pip install -r requirements/optional.txt\n\n Will install all optional dependencies convering support for many other\n formats.\n\nThe Toolkit requires Python 3.8 or newer.\n\nThe package lxml is required. You should install version 4.6.3 or later.\n<http://lxml.de/> Depending on your platform, the easiest way to install might\nbe through your system's package management. Alternatively you can try ::\n\n pip install lxml\n\nwhich should install the newest version from the web.\n\nFor Mac OSX, the following pages might be of help:\n<http://lxml.de/build.html#building-lxml-on-macos-x>\n<http://lxml.de/installation.html#macos-x>\n\nThe package lxml has dependencies on libxml2 and libxslt. Please check the lxml\nsite for the recommended versions of these libraries if you need to install\nthem separately at all. Most packaged versions of lxml will already contain\nthese dependencies.\n\nWhen the environment variable USECPO is set to 1, the toolkit will attempt to\nuse libgettextpo from the gettext-tools package (it might have a slightly\ndifferent name on your distribution). This can greatly speed up access to PO\nfiles, but has not yet been tested as extensively. Feedback is most welcome.\n\nThe package iniparse is necessary for ini2po and po2ini:\n<https://pypi.org/project/iniparse/>\n\nThe python-Levenshtein package will improve performance for fuzzy matching if\nit is available. This can improve the performance of pot2po, for example. It\nis optional and no functionality is lost if it is not installed, only speed.\n<http://sourceforge.net/projects/translate/files/python-Levenshtein/>\n\nFunctions in the `lang.data` module can supply functions to translate language\nnames using the `pycountry` package. It can even translate names in the format\n``Language (Country)`` such as ``English (South Africa)`` This is used by\nPootle and Virtaal. If the package is not installed, the language names will\nsimply appear in English. It is therefore recommended you install the\n`pycountry` package.\n\nThe package vobject is needed for ical2po and po2ical.\n\nThe aeidon package is needed for sub2po\nand po2sub. Some Unicode encoded files (including most files from\n<http://dotsub.com/>) require version 0.14 or later.\n\nTrados TXT TM support requires the BeautifulSoup parser\n<http://www.crummy.com/software/BeautifulSoup/>\n\nMarkdown support requires the mistletoe parser\n<https://github.com/miyuchina/mistletoe>\n\nProgram overview\n----------------\n\nUse ``--help`` to find the syntax and options for all programs.\n\n* Converters::\n\n oo2po - convert between OpenOffice.org GSI files and PO\n oo2xliff - convert between OpenOffice.org GSI files and XLIFF\n moz2po - convert between Mozilla files and PO\n csv2po - convert PO format to CSV for editing in a spreadsheet program\n php2po - PHP localisable string arrays converter.\n ts2po - convert Qt Linguist (.ts) files to PO\n txt2po - convert simple text files to PO\n html2po - convert HTML to PO (beta)\n md2po - convert Markdown to PO\n xliff2po - XLIFF (XML Localisation Interchange File Format) converter\n prop2po - convert Java .properties files to PO\n po2wordfast - Wordfast Translation Memory converter\n po2tmx - TMX (Translation Memory Exchange) converter\n pot2po - PO file initialiser\n csv2tbx - Create TBX (TermBase eXchange) files from Comma Separated\n Value (CSV) files\n ini2po - convert .ini files to to PO\n ical2po - Convert iCalendar files (*.ics) to PO\n sub2po - Convert many subtitle files to PO\n resx2po - convert .Net Resource (.resx) files to PO\n\n* Tools (Quality Assurance)::\n\n pofilter - run any of the 40+ checks on your PO files\n pomerge - merge corrected translations from pofilter back into\n your existing PO files.\n poconflicts - identify conflicting use of terms\n porestructure - restructures po files according to poconflict directives\n pogrep - find words in PO files\n\n* Tools (Other)::\n\n pocompile - create a Gettext MO files from PO or XLIFF files\n pocount - count translatable file formats (PO, XLIFF)\n podebug - Create comment in your PO files' msgstr which can\n then be used to quickly track down mistranslations\n as the comments appear in the application.\n posegment - Break a PO or XLIFF files into sentence segments,\n useful for creating a segmented translation memory.\n poswap - uses a translation of another language that you\n would rather use than English as source language\n poterminology - analyse PO or POT files to build a list of\n frequently occurring words and phrases\n",
"bugtrack_url": null,
"license": "GPL-2.0-or-later",
"summary": "Tools and API for translation and localization engineering.",
"version": "3.13.0",
"project_urls": {
"Documentation": "https://docs.translatehouse.org/projects/translate-toolkit/",
"Download": "https://github.com/translate/translate/releases/",
"Homepage": "https://toolkit.translatehouse.org/",
"Issue Tracker": "https://github.com/translate/translate/issues",
"Source Code": "https://github.com/translate/translate"
},
"split_keywords": [
"i18n",
"l10n",
"gettext",
"translate"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5126d9a258df76e458d58b4bb39ba3a931ce3e4f04c853f3ff18be7812cfe4bf",
"md5": "560f38f84de1b116af1da5e1e6e0d76f",
"sha256": "375e96e5af8a4942ed1f21ef70ae55c0435602e223eede2f0f4a14f2779e75c7"
},
"downloads": -1,
"filename": "translate_toolkit-3.13.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "560f38f84de1b116af1da5e1e6e0d76f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 744630,
"upload_time": "2024-04-22T09:13:50",
"upload_time_iso_8601": "2024-04-22T09:13:50.662001Z",
"url": "https://files.pythonhosted.org/packages/51/26/d9a258df76e458d58b4bb39ba3a931ce3e4f04c853f3ff18be7812cfe4bf/translate_toolkit-3.13.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "54f19019d19f844d0206ed671dcbfd6a8c9020af25bb021fcc861ce66d3d4e0a",
"md5": "9bf9ca10a286f5c5093a8cfdf3c439f1",
"sha256": "d31a1191894d0ad4ed99697663f1462e9a1820af3bbcf6848235add20cc00e62"
},
"downloads": -1,
"filename": "translate_toolkit-3.13.0.tar.gz",
"has_sig": false,
"md5_digest": "9bf9ca10a286f5c5093a8cfdf3c439f1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 1436430,
"upload_time": "2024-04-22T09:13:53",
"upload_time_iso_8601": "2024-04-22T09:13:53.198468Z",
"url": "https://files.pythonhosted.org/packages/54/f1/9019d19f844d0206ed671dcbfd6a8c9020af25bb021fcc861ce66d3d4e0a/translate_toolkit-3.13.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-22 09:13:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "translate",
"github_project": "translate",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "translate-toolkit"
}
JSON
