alaveteli - Unnamed repository; edit this file 'description' to name the repository.

Unnamed repository; edit this file 'description' to name the repository.

MimesBrønn

about summary refs log tree commit diff stats

path: root/docs/installing/manual_install.md

diff options

author	Louise Crow <louise.crow@gmail.com>	2014-08-07 14:22:31 +0100
committer	Louise Crow <louise.crow@gmail.com>	2014-08-07 14:22:31 +0100
commit	f39ab701b180202d719094f526d889d24bd06184 (patch)
tree	71521bfbb0241b87c02d4115e0585891e4789117 /docs/installing/manual_install.md
parent	49c97aa91c7260bd092cf58692f267ed8f25b8e3 (diff)

Use example.com as example domain

Diffstat (limited to 'docs/installing/manual_install.md')

0 files changed, 0 insertions, 0 deletions

-color: #ffffcc } .highlight .c { color: #888888 } /* Comment */ .highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */ .highlight .k { color: #008800; font-weight: bold } /* Keyword */ .highlight .ch { color: #888888 } /* Comment.Hashbang */ .highlight .cm { color: #888888 } /* Comment.Multiline */ .highlight .cp { color: #cc0000; font-weight: bold } /* Comment.Preproc */ .highlight .cpf { color: #888888 } /* Comment.PreprocFile */ .highlight .c1 { color: #888888 } /* Comment.Single */ .highlight .cs { color: #cc0000; font-weight: bold; background-color: #fff0f0 } /* Comment.Special */ .highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */ .highlight .ge { font-style: italic } /* Generic.Emph */ .highlight .ges { font-weight: bold; font-style: italic } /* Generic.EmphStrong */ .highlight .gr { color: #aa0000 } /* Generic.Error */ .highlight .gh { color: #333333 } /* Generic.Heading */ .highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */ .highlight .go { color: #888888 } /* Generic.Output */ .highlight .gp { color: #555555 } /* Generic.Prompt */ .highlight .gs { font-weight: bold } /* Generic.Strong */ .highlight .gu { color: #666666 } /* Generic.Subheading */ .highlight .gt { color: #aa0000 } /* Generic.Traceback */ .highlight .kc { color: #008800; font-weight: bold } /* Keyword.Constant */ .highlight .kd { color: #008800; font-weight: bold } /* Keyword.Declaration */ .highlight .kn { color: #008800; font-weight: bold } /* Keyword.Namespace */ .highlight .kp { color: #008800 } /* Keyword.Pseudo */ .highlight .kr { color: #008800; font-weight: bold } /* Keyword.Reserved */ .highlight .kt { color: #888888; font-weight: bold } /* Keyword.Type */ .highlight .m { color: #0000DD; font-weight: bold } /* Literal.Number */ .highlight .s { color: #dd2200; background-color: #fff0f0 } /* Literal.String */ .highlight .na { color: #336699 } /* Name.Attribute */ .highlight .nb { color: #003388 } /* Name.Builtin */ .highlight .nc { color: #bb0066; font-weight: bold } /* Name.Class */ .highlight .no { color: #003366; font-weight: bold } /* Name.Constant */ .highlight .nd { color: #555555 } /* Name.Decorator */ .highlight .ne { color: #bb0066; font-weight: bold } /* Name.Exception */ .highlight .nf { color: #0066bb; font-weight: bold } /* Name.Function */ .highlight .nl { color: #336699; font-style: italic } /* Name.Label */ .highlight .nn { color: #bb0066; font-weight: bold } /* Name.Namespace */ .highlight .py { color: #336699; font-weight: bold } /* Name.Property */ .highlight .nt { color: #bb0066; font-weight: bold } /* Name.Tag */ .highlight .nv { color: #336699 } /* Name.Variable */ .highlight .ow { color: #008800 } /* Operator.Word */ .highlight .w { color: #bbbbbb } /* Text.Whitespace */ .highlight .mb { color: #0000DD; font-weight: bold } /* Literal.Number.Bin */ .highlight .mf { color: #0000DD; font-weight: bold } /* Literal.Number.Float */ .highlight .mh { color: #0000DD; font-weight: bold } /* Literal.Number.Hex */ .highlight .mi { color: #0000DD; font-weight: bold } /* Literal.Number.Integer */ .highlight .mo { color: #0000DD; font-weight: bold } /* Literal.Number.Oct */ .highlight .sa { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Affix */ .highlight .sb { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Backtick */ .highlight .sc { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Char */ .highlight .dl { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Delimiter */ .highlight .sd { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Doc */ .highlight .s2 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Double */ .highlight .se { color: #0044dd; background-color: #fff0f0 } /* Literal.String.Escape */ .highlight .sh { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Heredoc */ .highlight .si { color: #3333bb; background-color: #fff0f0 } /* Literal.String.Interpol */ .highlight .sx { color: #22bb22; background-color: #f0fff0 } /* Literal.String.Other */ .highlight .sr { color: #008800; background-color: #fff0ff } /* Literal.String.Regex */ .highlight .s1 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Single */ .highlight .ss { color: #aa6600; background-color: #fff0f0 } /* Literal.String.Symbol */ .highlight .bp { color: #003388 } /* Name.Builtin.Pseudo */ .highlight .fm { color: #0066bb; font-weight: bold } /* Name.Function.Magic */ .highlight .vc { color: #336699 } /* Name.Variable.Class */ .highlight .vg { color: #dd7700 } /* Name.Variable.Global */ .highlight .vi { color: #3333bb } /* Name.Variable.Instance */ .highlight .vm { color: #336699 } /* Name.Variable.Magic */ .highlight .il { color: #0000DD; font-weight: bold } /* Literal.Number.Integer.Long */

The software translations are implemented using GNU gettext, and the
resource files are managed in Transifex.

The Transifex project is at
https://www.transifex.net/projects/p/alaveteli/; you'll probably want
an account there (ask on the mailing list).  It has a fairly easy to
use interface for contributing translations.

# Translation process: translator's view

When a developer adds a new feature to the user interface in
Alaveteli, they use some code to mark sentences or words ("strings")
that they think will need to be translated.

When the Alaveteli release manager is planning a release, they upload
a template containing all the strings to be translated (called a POT)
to Transifex.  This causes your own translations in Transifex to be
updated with the latest strings.

When you visit Transifex, it will prompt you to fill out values for
all new strings, and all strings that have been modified.  In the case
where a string has only been slightly modified, such as with
punctuation ("Hello" has become "Hello!"), Transifex will suggest a
suitable translation for you (look for the "suggestions" tab under the
source string).

In order for this feature to work properly, the release manager has to
download your translations, run a program that inserts the
suggestions, and then upload them again.  Therefore, when a release
candidate is announced, make sure you have uploaded any outstanding
translations, or you will lose them.

When a release candidate has been annouced, there is a **translation
freeze**: during this period, developers must not add any new strings
to the software, so you can be confident that you're translating
everything that will be in the final release.

The release manager will also give you a **translation deadline**.  After
this date, you can continue to contribute new translations, but they
won't make it into the release.

# Translation process: release manager's view

Before the Alaveteli release manager cuts a new release branch, they
must:

* pick a date for the release branch to be cut ("release candidate date")
* make an announcement to the translators (using the "announcements"
  feature in Transifex) that they should ensure they have any pending
  translations saved in Transifex before the release candidate date
* make an announcement to the developers that all new strings should
  be committed before the release candidate date
* on the release candidate date:
    * download (`tx pull -a -f`) and commit all the current translations (important:
      there's no revision history in Transifex!)
    * you should also commit these translations to a hotfix for the
      previous version, so they are preserved against the last known
      good msgids
    * regenerate the POT file and individual PO files for each
      language, using `bundle exec rake
      gettext:store_model_attributes`, followed by `bundle exec rake
      gettext:find`
        * careful of including msgids from themes in `vendor/plugin`;
          you might want to move them out of the way before running
          the above commands
        * this updates the PO template, but also merges it with the
          individual PO files, marking strings that have only changed
          slightly as "fuzzy"
    * reupload (`tx push -s -t`) the POT and PO files to Transifex from the
      current release branch
        * The point of uploading the PO files is that Transifex
          converts the "fuzzy" suggestions from Transifex into
          "suggestions" under each source string
        * Note that Transifex *does not* preserve fuzzy strings in the
          PO files it makes available for download, on the grounds
          that Transifex supports multiple suggestions, whereas
          gettext only allows one fuzzy suggestion per msgid.
    * remove the fuzzy strings from the local PO files (because they
      make Rails very noisy), and then commit the result. You can do
      this by re-pulling from Transifex.
* on the release date:
    * download and commit all the current translations to the current
      release branch

# Translations: developers' view

See the [I18n guide](https://github.com/mysociety/alaveteli/wiki/I18n-guide) on the wiki.


context:
space:
mode: