Changes

76 bytes added ,  19:15, 23 September 2011
no edit summary
Line 15: Line 15:     
* translate AT sugarlabs DOT org
 
* translate AT sugarlabs DOT org
      
== Sysadmins ==
 
== Sysadmins ==
Line 76: Line 75:  
The last maintainer was Sayamindu Dasgupta and we asked he our doubts, i am putting here this information.
 
The last maintainer was Sayamindu Dasgupta and we asked he our doubts, i am putting here this information.
   −
=== Basic info: ===
+
== Files ==
 +
 
 +
Important files and directories in the root directory, {{Code|/var/lib/pootle}}.
 +
 
 +
{{Code|'''checkouts'''}}<br>
 +
Sources are checked out in this directory and being used to keep final {{Code|.pot}} and {{Code|.po}} files.
 +
 
 +
{{Code|'''translations'''}}<br>
 +
Pootle uses this directory as a sources of files to translate, it contains symlinks to files from the {{Code|checkouts}} directory.
 +
 
 +
{{Code|'''maintenance'''}}<br>
 +
Contains some sugar-specific scripts to help maintain our Pootle instance, they are managed in http://git.sugarlabs.org/projects/pootle-helpers.
 +
 
 +
{{Code|'''maintenance/helpers/potupdater/project_list.ini'''}}<br>
 +
This is an Ini file that contains configuration for all used sources repositories. Each section describes one sources repository, where section name is full path to the directory with sources, and contains following options:
 +
 
 +
* {{Code|project}} required, meaning-less project name;
 +
* {{Code|vcs}} required, the type of VCS for; supported values are: {{Code|git}};
 +
* {{Code|method}} required, the method how to generate {{Code|.pot}} files from sources; supported values are: {{Code|bundlebuilder}} for activities, {{Code|intltool}} for intltool based projects;
 +
* {{Code|layout}} required, ?;
 +
* {{Code|ignore-files}} optional, the semicolon separated list of file paths that are relative to the sources root; if {{Code|method}} is {{Code|bundlebuilder}} this value will be used to ignore while producing {{Code|.pot files}};
   −
The pootle directory is:
+
== Tools ==
/var/lib/pootle
     −
The translations live in:
+
* {{Code|potupdater/pogenerator.py}} pulls from git and svn so we have updated sources, then it generates a new .pot file from them. Translated strings get reflected in the .po files in each module, and when the language maintainer clicks the Commit to VCS link, get pushed back to the upstream module.
 +
* {{Code|admin/pootlepopulator.py}} checkout sources.
 +
* {{Code|misc/pootle.cron}} all daily basis routines.
 +
* ''...''
   −
/var/lib/pootle/translations
+
== Tips ==
    
=== Creating branches: ===
 
=== Creating branches: ===
Line 217: Line 238:     
* When there are '''commit to cvs/update to cvs''' links missing in activities or projects please check git url in .git/config , this URL must be writable by pootle.
 
* When there are '''commit to cvs/update to cvs''' links missing in activities or projects please check git url in .git/config , this URL must be writable by pootle.
  −
== Files ==
  −
  −
Important files and directories in {{Code|/var/lib/pootle}}.
  −
  −
{{Code|'''checkouts'''}}<br>
  −
Modules are checked out in this directory. pogenerator.py pulls from git and svn so we have updated sources, then it generates a new .pot file from them. Translated strings get reflected in the .po files in each module, and when the language maintainer clicks the Commit to VCS link, get pushed back to the upstream module.
  −
  −
{{Code|'''dbs'''}}<br>
  −
Iternal db used by Pootle, no need to mess directly with it.
  −
  −
{{Code|'''maintenance'''}}<br>
  −
Contains some sugar-specific scripts to help maintain our Pootle instance, they are managed in http://git.sugarlabs.org/projects/pootle-helpers.
  −
  −
{{Code|'''po'''}}<br>
  −
Contains xapian indexes for the search feature.
  −
  −
{{Code|'''translations'''}}<br>
  −
More Pootle internal data.
  −
  −
{{Code|'''maintenance/helpers/potupdater/project_list.ini'''}}<br>
  −
This is an Ini file that contains configuration for all used sources repositories. Each section describes one sources repository, where section name is full path to the directory with sources, and contains following options:
  −
  −
* {{Code|project}} required, meaning-less project name;
  −
* {{Code|vcs}} required, the type of VCS for; supported values are: {{Code|git}};
  −
* {{Code|method}} required, the method how to generate {{Code|.pot}} files from sources; supported values are: {{Code|bundlebuilder}} for activities, {{Code|intltool}} for intltool based projects;
  −
* {{Code|layout}} required, ?;
  −
* {{Code|ignore-files}} optional, the semicolon separated list of file paths that are relative to the sources root; if {{Code|method}} is {{Code|bundlebuilder}} this value will be used to ignore while producing {{Code|.pot files}};
      
== References ==
 
== References ==