Metadata-Version: 2.1
Name: wagtail-localize-git
Version: 0.9.2
Summary: Wagtail Localize integration for Git-based translation services
Home-page: UNKNOWN
Author: Karl Hobley
Author-email: karl@torchbox.com
License: BSD
Description: # wagtail-localize-git
        
        This plugin enables translating Wagtail content using a PO files in a git repository.
        
        It works by committing source content into the repository then polling it for updates. When the PO files are translated, this will automatically create translated pages in Wagtail.
        
        This is useful for when you are using external translation tools for translating your Wagtail content. Currently, this plugin supports Mozilla's [Pontoon](https://pontoon.mozilla.org/), but PRs are welcome for other translation tools!
        
        ## Installation
        
        This plugin requires Wagtail 2.11 with [internationalisation enabled](https://docs.wagtail.io/en/v2.11/advanced_topics/i18n.html#configuration) and [Wagtail Localize](https://github.com/wagtail/wagtail-localize).
        
        
        Install both ``wagtail-localize`` and ``wagtail-localize-git``, then add the following to your `INSTALLED_APPS`:
        
        ```python
        INSTALLED_APPS = [
            ...
            'wagtail_localize',
            'wagtail_localize.locales',  # Replaces 'wagtail.locales'
            'wagtail_localize_git',
            ...
        ]
        ```
        
        Then set the following settings:
        
        `WAGTAILLOCALIZE_GIT_URL` - This is a URL to an empty git repository that `wagtail-localize-git` will push source strings to and fetch translations from.
        `WAGTAILLOCALIZE_GIT_CLONE_DIR` - The local directory where the git repository will be checked out.
        
        ## Synchronisation
        
        Once this is configured, you can use the ``sync_git`` management command to push/pull changes. This management command should be set up in your server's crontab to run often (preferably, every 10 minutes).
        
        ## How it works
        
        This plugin uses ``wagtail-localize`` to convert pages into segments and build new pages from translated segments. ``wagtail-localize`` provides a web interface for translating these segments in Wagtail itself and this plugin plays nicely with that (translations can be made from the Wagtail side too).
        
        Pages/snippets are submitted to the git repo when they are submitted for translation from the default locale. Pages authored in other locales are not supported yet.
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.0
Classifier: Framework :: Django :: 3.1
Classifier: Framework :: Wagtail
Classifier: Framework :: Wagtail :: 2
Description-Content-Type: text/markdown
Provides-Extra: testing
