.. This README is meant for consumption by humans and pypi. Pypi can render rst files so please do not use Sphinx features.
If you want to learn more about writing documentation, please check out: http://docs.plone.org/about/documentation_styleguide.html
This text does not appear on pypi or github. It is a comment.
=================
collective.ttwpo
=================
Translations for Plone UI through-the-web (TTW) with option to connect to translation web-services.
Features
========
- Create an i18n-domain and languages variants TTW (also delete them).
- Add GNU Gettext (``*.po``) files TTW to a language.
- Manage different versions of a GNU Gettext file and set one as current.
- Fetch GNU Gettext files from configured translations services. So far only `Zanata <http://zanata.org/>`_ is supported.
Current Limitations
===================
- it is not yet possible to override global, file-system configured (zcml) i18n-domains (see todo).
Installation
============
Install collective.ttwpo by adding it to your buildout::
[buildout]
...
eggs =
collective.ttwpo
and then running ``bin/buildout``.
Example using the ``Zanata`` webservice connector::
eggs =
collective.ttwpo[zanata]
After installation activate it in the addons control-panel.
Visit the new ``TTW PO Support`` control-panel.
Configuring a webservice
========================
For each i18n-domain provide a JSON configuration like so:
::
{
"servicename":"zanata",
"url":"https://zanata.mydomain.com/rest/",
"user":"johndoe",
"token":"abcdef1234567890abcdef1234567890",
"project": "mydemo.project",
"version": "1.x",
"document": "zanata-document-name"
}
The key ``servicename`` is mandatory and used to look a up a named adapter.
All other settings are adapter specific and are passed as-is to the adapter.
Todo/ Nice-to-Have
==================
- Allow single users or groups to manage a language: create/delete/make current/sync.
- Download uploaded PO files.
- If an i18n-domain was already registered global, use their catalogs.
Order: First local catalog, then global catalogs.
- Make upload capability configurable.
- Add Transifex connector.
- Allow environment variables in webservice configuration, which then are replaced.
- If a webservice was configured, sync all languages at once.
Create missing languages.
- GenericSetup import/ export of the whole configuration.
Contributions and Source Code
=============================
.. image:: https://travis-ci.org/collective/collective.ttwpo.svg?branch=master
:target: https://travis-ci.org/collective/collective.ttwpo
.. image:: https://coveralls.io/repos/github/collective/collective.ttwpo/badge.svg?branch=master
:target: https://coveralls.io/github/collective/collective.ttwpo?branch=master
If you want to help with the development (improvement, update, bug-fixing, ...) of ``collective.ttwpo`` this is a great idea!
The code is located in the `GitHub Collective <https://github.com/collective/collective.ttwpo>`_.
You can clone it or `get access to the GitHub Collective <https://collective.github.com/>`_ and work directly on the project.
Please always use pull-requests.
Maintainers are Jens Klein and the `BlueDynamics Alliance <https://bluedynamics.com/>`_ developer team.
We appreciate any contribution and if a release is needed to be done on pypi, please just contact one of us:
`dev@bluedynamics dot com <mailto:dev@bluedynamics.com>`_
If you are having issues, please let me know:
- File an issue at the `TTWPO Issue Tracker <https://github.com/collective/collective.ttwpo/issues>`_.
- or just write me an email to jens@bluedynamics.com.
This code was initially written for and paid by `Porsche Informatik Gesellschaft m.b.H. <https://www.porscheinformatik.at/>`_, Salzburg.
The project is licensed under the GPLv2.
Changelog
=========
2.0b1 (2023-03-22)
------------------
- Migrate to Python 3
[daggelpop]
1.0b4 (2017-11-15)
------------------
- Initial release.
[jensens]
License
=======
collective.ttwpo Copyright 2017, BlueDynamics Alliance, Austria, Germany, Switzerland
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program;
if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
Raw data
{
"_id": null,
"home_page": "https://pypi.python.org/pypi/collective.ttwpo",
"name": "collective.ttwpo",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "Python Plone Translation PO gettext ttwpo",
"author": "Jens W. Klein",
"author_email": "jk@kleinundpartner.at",
"download_url": "https://files.pythonhosted.org/packages/e3/19/ba6e73399b339ed6c57cf4aca7398ed99a04a4fe42853626d9c8d31c50d1/collective.ttwpo-2.0b1.tar.gz",
"platform": null,
"description": ".. This README is meant for consumption by humans and pypi. Pypi can render rst files so please do not use Sphinx features.\n If you want to learn more about writing documentation, please check out: http://docs.plone.org/about/documentation_styleguide.html\n This text does not appear on pypi or github. It is a comment.\n\n=================\ncollective.ttwpo\n=================\n\nTranslations for Plone UI through-the-web (TTW) with option to connect to translation web-services.\n\nFeatures\n========\n\n- Create an i18n-domain and languages variants TTW (also delete them).\n- Add GNU Gettext (``*.po``) files TTW to a language.\n- Manage different versions of a GNU Gettext file and set one as current.\n- Fetch GNU Gettext files from configured translations services. So far only `Zanata <http://zanata.org/>`_ is supported.\n\nCurrent Limitations\n===================\n\n- it is not yet possible to override global, file-system configured (zcml) i18n-domains (see todo).\n\n\nInstallation\n============\n\nInstall collective.ttwpo by adding it to your buildout::\n\n [buildout]\n\n ...\n\n eggs =\n collective.ttwpo\n\n\nand then running ``bin/buildout``.\n\nExample using the ``Zanata`` webservice connector::\n\n eggs =\n collective.ttwpo[zanata]\n\nAfter installation activate it in the addons control-panel.\nVisit the new ``TTW PO Support`` control-panel.\n\nConfiguring a webservice\n========================\n\nFor each i18n-domain provide a JSON configuration like so:\n\n::\n\n {\n \"servicename\":\"zanata\",\n \"url\":\"https://zanata.mydomain.com/rest/\",\n \"user\":\"johndoe\",\n \"token\":\"abcdef1234567890abcdef1234567890\",\n \"project\": \"mydemo.project\",\n \"version\": \"1.x\",\n \"document\": \"zanata-document-name\"\n }\n\nThe key ``servicename`` is mandatory and used to look a up a named adapter.\nAll other settings are adapter specific and are passed as-is to the adapter.\n\n\nTodo/ Nice-to-Have\n==================\n\n- Allow single users or groups to manage a language: create/delete/make current/sync.\n\n- Download uploaded PO files.\n\n- If an i18n-domain was already registered global, use their catalogs.\n Order: First local catalog, then global catalogs.\n\n- Make upload capability configurable.\n\n- Add Transifex connector.\n\n- Allow environment variables in webservice configuration, which then are replaced.\n\n- If a webservice was configured, sync all languages at once.\n Create missing languages.\n\n- GenericSetup import/ export of the whole configuration.\n\n\nContributions and Source Code\n=============================\n\n.. image:: https://travis-ci.org/collective/collective.ttwpo.svg?branch=master\n :target: https://travis-ci.org/collective/collective.ttwpo\n\n.. image:: https://coveralls.io/repos/github/collective/collective.ttwpo/badge.svg?branch=master\n :target: https://coveralls.io/github/collective/collective.ttwpo?branch=master\n\nIf you want to help with the development (improvement, update, bug-fixing, ...) of ``collective.ttwpo`` this is a great idea!\n\nThe code is located in the `GitHub Collective <https://github.com/collective/collective.ttwpo>`_.\n\nYou can clone it or `get access to the GitHub Collective <https://collective.github.com/>`_ and work directly on the project.\nPlease always use pull-requests.\n\nMaintainers are Jens Klein and the `BlueDynamics Alliance <https://bluedynamics.com/>`_ developer team.\n\nWe appreciate any contribution and if a release is needed to be done on pypi, please just contact one of us:\n`dev@bluedynamics dot com <mailto:dev@bluedynamics.com>`_\n\nIf you are having issues, please let me know:\n\n- File an issue at the `TTWPO Issue Tracker <https://github.com/collective/collective.ttwpo/issues>`_.\n\n- or just write me an email to jens@bluedynamics.com.\n\nThis code was initially written for and paid by `Porsche Informatik Gesellschaft m.b.H. <https://www.porscheinformatik.at/>`_, Salzburg.\n\nThe project is licensed under the GPLv2.\n\nChangelog\n=========\n\n2.0b1 (2023-03-22)\n------------------\n\n- Migrate to Python 3\n [daggelpop]\n\n\n1.0b4 (2017-11-15)\n------------------\n\n- Initial release.\n [jensens]\n\nLicense\n=======\n\ncollective.ttwpo Copyright 2017, BlueDynamics Alliance, Austria, Germany, Switzerland\n\nThis program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\nSee the GNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License along with this program;\nif not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.",
"bugtrack_url": null,
"license": "GNU General Public License v2 (GPLv2)",
"summary": "Manage your PO Translation Files TTW and Sync with Translationservices",
"version": "2.0b1",
"split_keywords": [
"python",
"plone",
"translation",
"po",
"gettext",
"ttwpo"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e319ba6e73399b339ed6c57cf4aca7398ed99a04a4fe42853626d9c8d31c50d1",
"md5": "fec3a6448aa85063cee4bb6739dc721e",
"sha256": "45f3b2201f42fe6263da1f4f35ede87411310d09f92250eb5e65edc05b64ec41"
},
"downloads": -1,
"filename": "collective.ttwpo-2.0b1.tar.gz",
"has_sig": false,
"md5_digest": "fec3a6448aa85063cee4bb6739dc721e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 28159,
"upload_time": "2023-03-22T10:04:27",
"upload_time_iso_8601": "2023-03-22T10:04:27.988190Z",
"url": "https://files.pythonhosted.org/packages/e3/19/ba6e73399b339ed6c57cf4aca7398ed99a04a4fe42853626d9c8d31c50d1/collective.ttwpo-2.0b1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-22 10:04:27",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "collective.ttwpo"
}
JSON