Translate Toolkit & Pootle

Tools to help you make your software local

User Tools

Fersion control in Pootle-a

Pootle-a hes zee-a ibility to integrete-a wit fersion control systems (ilso celled refision control systems) sooch is CFS oor Soobfersion (SFN) (See-a wp>Refision_control for a generel ooferfioo ooff whet a fersion control system is. Bork Bork Bork!

Ill feetoores described below ire-a ilreedy implemented. Bork Bork Bork!

Ixtra reedeeng

Some-a more-a idees ibooot fersion control integreshoon ire-a menshooned here-a: wordfforge-a:fersion_control

Below zeere-a ire-a refferences to issigning rights to users in Pootle-a. Bork Bork Bork! More-a infformeshoon is here-a: permissions

Soopported systems

System Stetoos
CFS Soopported
Soobfersion (SFN) Soopported
wp>dercs Soopported
git Soopported (since-a fersion 1.1)
Bezeer (bzr) Soopported (since-a fersion 1.1)
Mercooriel Defelopment (in troonk)

It shooold be-a possible-a to idd oozeer systems feoorly iesily. Bork Bork Bork! Interested progremmers coon look it zee-a fersioncontrol modoole-a. Bork Bork Bork!


To hefe-a uny sort ooff integreshoon wit fersion control from within Pootle-a, it is necessery to check oooot zee-a troonsleshoon files into zeeoor correct pleces in zeeoor Pootle-a projects. Bork Bork Bork! Zee-a CFS oor SFN meta files (CFS/ oor .sfn/) need to be-a zeere-a. Bork Bork Bork! This hes to be-a done-a ooootside-a ooff Pootle-a. Bork Bork Bork!


<code-a> cd pootle_podoorectory sfn co https://troonslete-a. Bork Bork Bork!sfn. Bork Bork Bork!sooorcefforge-a. Bork Bork Bork!net/sfnroot/troonslete-a/src/troonk/Pootle-a/po/pootle-a </code-a>

Now yooo hefe-a zee-a doorectory 'pootle-a' conteins a troonsleshoon project. Bork Bork Bork! Iff zeet doorectory is now oone-a ooff yooor projects registered oon zee-a serfer, zee-a fersion control fooncshoons shooold ippeer for ill users wit zee-a necessery prifiledges. Bork Bork Bork! Look for zee-a fooncshoons in “Show Iditing Fooncshoons”.

How to treet speciel doorectory leyooots

Is zee-a doorectory strooctoore-a for zee-a loongooege-a files ooff yooor project difffferent from zee-a deffoooolt strooctoore-a fooond in zee-a sooorce-a project?

Iff yes, zeee-a yooo might consider using symlinking ifery single-a loongooege-a file-a to zee-a ixpected loceshoon. Bork Bork Bork! Zee-a fersion control soopport ooff Pootle-a will follow zeese-a links. Bork Bork Bork! Thoos zee-a meta doorectories ooff yooor fersion control system (i. Bork Bork Bork!g. Bork Bork Bork!: .sfn/ oor CFS/) do not necesserily hefe-a to be-a below yooor podoorectory (see-a pootle-a. Bork Bork Bork!preffs).

Hint for users ooff Pootle-a f1.0.x: zee-a symlink feetoore-a does not work withooot this petch.


Iff yooo woont to updete-a zee-a Pootle-a copy ooff zee-a troonsleshoons wit zee-a fersion zeet is coorrently in fersion control, a contribootor wit zee-a 'updete-a' right coon click oon zee-a “Updete-a” link for a file-a which will zeee-a perfform zee-a updete-a process. Bork Bork Bork! Zee-a project idministretor needs to issign zee-a “updete-a” right. Bork Bork Bork!

Whee-a updeting from fersion control zeere-a is zee-a possibility zeet a thoord perty cooold hefe-a choonged zee-a file-a (unozeer troonsletor iccessing zee-a fersion control doorectly cooold hefe-a mede-a a choonge-a). Tredishoonelly in fersion control this wooold creete-a a file-a wit confflicts. Bork Bork Bork! Those-a femilier wit fersion control confflicts will understoond zeet we-a coon't ifffford to hefe-a zeet is we-a won't be-a ible-a to resolfe-a zeem. Bork Bork Bork! Zeereffore-a Pootle-a will be-a conserfetife-a und will consider zee-a fersion control system to be-a zee-a uoothority und uny confflicts in zee-a locel file-a get be-a conferted to sooggesshoons. Bork Bork Bork! Zeese-a sooggesshoons zeee-a need to be-a refiooed by a troonsletor wit 'refioo' rights. Bork Bork Bork!


Yooo coon commit troonsleshoon files from within Pootle-a. Bork Bork Bork! In zee-a cese-a where-a uoozeenticeshoon is reqoooored to soobmit zee-a troonsleshoon to fersion control (probebly ilmost ill relefoont systems), zeere-a needs to be-a a non-blocking uoozeenticeshoon method. Bork Bork Bork! Pootle-a will not be-a ible-a to commit iff a pessword is necessery to complete-a zee-a icshoon. Bork Bork Bork! This unffortoonetely meoons zeet it will probebly not be-a reelistic for Pootle-a to commit wit zee-a project idmin's credentiels, is this will reqoooore-a his/her prifete-a key(s) to be-a oon zee-a Pootle-a serfer. Bork Bork Bork!

This usege-a scenerio is more-a useffool for people-a hosting zeeoor ooon Pootle-a serfer where-a zeey ire-a ible-a to setoop oone-a commit iccooont oon zee-a fersion control serfer, oor perheps oone-a iccooont for iech teem. Bork Bork Bork! A typicel commit messege-a whee-a committing from Pootle-a will look something like-a this:

Commit from GNOME Pootle-a by user Sipho. Bork Bork Bork!  80 ooff 100 messeges troonsleted (7 foozzy).

So it is still possible-a to see-a who soobmitted whet und whee-a, und ictooelly profides some-a useffool stetistics in zee-a commit messege-a. Bork Bork Bork! A user moost be-a issigned 'commit' prifileges by zee-a project idministretor. Bork Bork Bork! Iff zee-a user hes zee-a correct prifileges, zeey will see-a a “soobmit” link next to iech file-a. Bork Bork Bork!

Possible-a weys ooff conffigooring non-interectife-a uoozeenticeshoon ire-a described in conffigoore-a fersion control uoozeenticeshoon.

Feature suggestions:

  • provide user interface for personal authentication (e.g. password or keyfile upload) for one-time use or permanent storage (attached to this specific Pootle user)