Pootle FS can work with different VCS systems as well as with the local file system.
The following steps outline the setup of a Pootle FS based project:
Note
Pootle FS will work out of the box when synchronizing with the local file system. If this is the case you can safely skip this step.
Synchronizing against any version control system requires you add some additional packages and configuration.
Create a project as usual, setting the Project Tree Style to
Allow Pootle FS to manage filesystems
.
Once the project is created you need to configure Pootle FS. You can accomplish this with the command line or the web UI. The UI is by far the simplest way and is outlined here:
Click on the Filesystems
link below the project edit form in the project
admin UI.
Add the Backend configuration
:
localfs
as we are working against
files stored on the local filesystem./path/to/translations/MYPROJECT/
/<language_code>/<dir_path>/<filename>.<ext>
Note
If you are setting up Pootle FS for a VCS then configure as follows:
git@github.com:user/repo.git
If not all of your project’s language codes match those available in Pootle,
then add language mapping configurations for those languages. For example
match fr_FR
on your filesystem to fr
on Pootle.
Note
You can safely skip this step if you are setting up the project to synchronize with the local file system.
Create a SSH key:
$ sudo -u USER-RUNNING-POOTLE ssh-keygen -b 4096
Tell your upstream repo about the public key, allowing Pootle to be able to push to the repo.
Once the project is created and properly set up we can pull the translations into Pootle:
(env) $ pootle fs state MYPROJECT
(env) $ pootle fs add MYPROJECT
(env) $ pootle fs sync MYPROJECT
Your project is now ready to use Pootle FS. In order to keep Pootle and the filesystem or VCS synchronised you will need to learn how to use Pootle FS.