"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "share/doc/roundup/html/_sources/developers.txt" between
roundup-1.6.1.tar.gz and roundup-2.0.0.tar.gz

About: Roundup is an highly customisable issue-tracking system with command-line, web and e-mail interfaces (written in Python).

developers.txt  (roundup-1.6.1):developers.txt  (roundup-2.0.0)
skipping to change at line 38 skipping to change at line 38
Website, wiki Website, wiki
------------- -------------
The website is in our repository, so is the configuration of the wiki. The website is in our repository, so is the configuration of the wiki.
Please check the README.txt in the "website" subdirectory Please check the README.txt in the "website" subdirectory
of a current checkout. of a current checkout.
Issue Tracker Issue Tracker
------------- -------------
The tracker resides on psf.upfronthosting.co.za. The tracker resides on bugs.ams1.psf.io (188.166.48.69). You can also
(2012-07-04) 2048 c4:ad:63:92:1b:c0:4a:35:c8:c5:3e:96:51:c0:88:67 (RSA) ssh to issues.roundup-tracker.org. They have the same fingerprint:
ED25519 key fingerprint is f1:f7:3d:bf:3b:01:8d:e1:4e:30:b3:0f:6e:98:b8:9b.
The roundup installation belongs to the user roundup. The roundup installation belongs to the user roundup.
In ~roundup, all trackers are stored and the roundup code itself. The setup uses virtualenv. Use the python version:
roundup is started through /etc/init.d/roundup;
other parts of the installation are started through /srv/roundup/env/bin/python2.7
/etc/init.d/{postgresql-8-1,spambayes,postfix}.
to get a python with roundup on the PYTHONPATH.
The machine is operated by Upfronthosting in South Africa. The meta
tracker is http://psf.upfronthosting.co.za/roundup/meta/
In this tracker, Upfronthosting people are the users izak and roche.
The Roundup tracker https://issues.roundup-tracker.org/ is in The Roundup tracker https://issues.roundup-tracker.org/ is in
~roundup/trackers/roundup /srv/roundup/trackers/roundup/ with the database set to
/srv/roundup/data/roundup/. Note that postgres is used for the
backend, so the database directory above is used for msgs and files.
Source is in: /srv/roundup/src/
Roundup is run using gunicorn and wsgi.
You have 'sudo -u roundup' access if you need to run things as the
roundup user.
The configuration is in the "website/issues" section of Roundup's The configuration is in the "website/issues" section of Roundup's
Mercurical SCM repository and copied manually to the live tracker. Mercurical SCM repository and copied manually to the live tracker.
A checkout of the roundup sources is in ~roundup/src/roundup-src. * get a working copy of roundup/website/issues from the SCM, either via
hg clone https://hg.code.sf.net/p/roundup/code
or download a snapshot:
https://sourceforge.net/p/roundup/code/ci/default/tarball
* check the differences
diff -ur /srv/roundup/trackers/roundup/ roundup/website/issues/
Copy differences using 'sudo -u roundup ...'.
Getting a user account
~~~~~~~~~~~~~~~~~~~~~~
To get access to the host, submit a pull request for:
https://github.com/python/psf-salt
by forking the repo, make a change similar to:
https://github.com/rouilj/psf-salt/commit/2aa55d0fc5a343f45f5507437d3fba077c
baf852
and submit it as a pull request. Contact ewdurbin via #roundup IRC or by
adding an issue to the master psf-salt repo.
Small Changes Small Changes
------------- -------------
Most small changes can be submitted as patches through the Most small changes can be submitted as patches through the
`issue tracker`_ or sent to `roundup-devel mailing list`_. `issue tracker`_ or sent to `roundup-devel mailing list`_.
Source Repository Access Source Repository Access
------------------------ ------------------------
skipping to change at line 148 skipping to change at line 178
Additional details may be found in `GNU gettext`_ and Python `gettext Additional details may be found in `GNU gettext`_ and Python `gettext
module`_ documentation. module`_ documentation.
`Roundup source distribution`_ includes POT and PO files for message `Roundup source distribution`_ includes POT and PO files for message
translators, and also pre-built MO files to facilitate installations translators, and also pre-built MO files to facilitate installations
from source. Roundup binary distribution includes MO files only. from source. Roundup binary distribution includes MO files only.
.. _GNU gettext: .. _GNU gettext:
GNU gettext package GNU gettext package
^^^^^^^^^^^^^^^^^^^ ~~~~~~~~~~~~~~~~~~~
This chapter is full of references to GNU `gettext package`_. This chapter is full of references to GNU `gettext package`_.
GNU gettext is a "must have" for nearly all steps of internationalizing GNU gettext is a "must have" for nearly all steps of internationalizing
any program, and it's manual is definetely a recommended reading any program, and it's manual is definetely a recommended reading
for people involved in `I18N`_. for people involved in `I18N`_.
There are GNU gettext ports to all major OS platforms. There are GNU gettext ports to all major OS platforms.
Windows binaries are available from `GNU mirror sites`_. Windows binaries are available from `GNU mirror sites`_.
Roundup does not use GNU gettext at runtime, but it's tools Roundup does not use GNU gettext at runtime, but it's tools
are used for `extracting translatable messages`_, `compiling are used for `extracting translatable messages`_, `compiling
message catalogs`_ and, optionally, for `translating messages`_. message catalogs`_ and, optionally, for `translating messages`_.
Note that ``gettext`` package in some OS distributions means just Note that ``gettext`` package in some OS distributions means just
runtime tools and libraries. In such cases gettext development tools runtime tools and libraries. In such cases gettext development tools
are usually distributed in separate package named ``gettext-devel``. are usually distributed in separate package named ``gettext-devel``.
Marking Strings for Translation Marking Strings for Translation
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Strings that need translation must be marked in the source code. Strings that need translation must be marked in the source code.
Following subsections explain how this is done in different cases. Following subsections explain how this is done in different cases.
If translatable string is used as a format string, it is recommended If translatable string is used as a format string, it is recommended
to always use *named* format specifiers:: to always use *named* format specifiers::
_('Index of %(classname)s') % locals() _('Index of %(classname)s') % locals()
This helps translators to better understand the context of the This helps translators to better understand the context of the
skipping to change at line 199 skipping to change at line 229
script) has no human readable parts at all, and needs no translations. script) has no human readable parts at all, and needs no translations.
Such strings are left untranslated in PO files, and are reported Such strings are left untranslated in PO files, and are reported
as such by PO status checkers (e.g. ``msgfmt --statistics``). as such by PO status checkers (e.g. ``msgfmt --statistics``).
Command Line Interfaces Command Line Interfaces
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
Scripts and routines run from the command line use "static" language Scripts and routines run from the command line use "static" language
defined by environment variables recognized by ``gettext`` module defined by environment variables recognized by ``gettext`` module
from Python library (``LANGUAGE``, ``LC_ALL``, ``LC_MESSAGES``, and from Python library (``LANGUAGE``, ``LC_ALL``, ``LC_MESSAGES``, and
``LANG``). Primarilly, these are ``roundup-admin`` script and ``LANG``). Primarily, these are ``roundup-admin`` script and
``admin.py`` module, but also help texts and startup error messages ``admin.py`` module, but also help texts and startup error messages
in other scripts and their supporting modules. in other scripts and their supporting modules.
For these interfaces, Python ``gettext`` engine must be initialized For these interfaces, Python ``gettext`` engine must be initialized
to use Roundup message catalogs. This is normally done by including to use Roundup message catalogs. This is normally done by including
the following line in the module imports:: the following line in the module imports::
from i18n import _, ngettext from i18n import _, ngettext
Simple translations are automatically marked by calls to builtin Simple translations are automatically marked by calls to builtin
 End of changes. 7 change blocks. 
15 lines changed or deleted 46 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)