GNU MediaGoblin Wiki - User contributions [en]

CommunityGovernance

2015-08-24T20:31:44Z

Berkerpeksag: /* MediaGoblin codebase */

MediaGoblin is a community project and we everybody try to help each other. Chris Webber is our lead developer, but the project should be able to self govern so he can take a break if he needs it or when he or other contributors take deserved holidays :)

In general, you can ask anything in the mailing list or the IRC channel and hopefully somebody will answer soon. Topics are discussed in the mailing list, IRC channel or monthly meetings (in the IRC channel).

In this page we list several tasks or areas along with the names or nicks of MediaGoblin community members that may help on them (for example, because they have permissions to perform certain operations). Please be kind when asking for help, most of us are volunteering for MediaGoblin in our free time, so answers or problems resolution can take a while.

Feel free to edit this page to list more tasks or sign the ones you self-assign.

More information about this in this mailing list thread: http://lists.mediagoblin.org/pipermail/devel/XXXXX

== MediaGoblin codebase ==

* People with permissions to commit/merge and handle the main codebase

* Current committers: https://savannah.gnu.org/project/memberlist.php?group=mediagoblin
* General stuff: breton, Elrond (via PM on IRC)
* Python 3 support: berkerpeksag (berker on IRC), breton
* Audio/Video: breton
* Documentation: jcampbell / j1mc

== MediaGoblin website ==

* People with permissions to handle website outages

* Publish pages (for example new releases)

== MediaGoblin wiki ==

* Some Wiki administration: Elrond (via PM on IRC)

== MediaGoblin issue tracker ==

* Issue tracker server administration: simonft, paroneayea
* Help triaging bugs: R13ose
* People with permissions to create accounts in trac: Elrond
* People with permissions to delete users/issues/comments in trac: Elrond
* Volunteers for spam cleaning: LArjona, ayleph
* Talk to trac people about spam: R13ose
* Would like more access to be able to help/fix things:

== MediaGoblin translation platform ==

* If there is need of manual import/export files between Pootle and the MediaGoblin codebase, who can help on that
* LArjona (Spanish translator) can guide new translators, reproduce problems in the translation platform, test changes, and help with Pootle quality checks. Available in the mailing list and IRC channel.
* breton knows how and why translations are downloaded/compiled

== MediaGoblin IRC channel and mailing list ==

* Change IRC topic, channel operators
* Running the monthly meetings: breton
* Administrate the mailing list: larjona

Translations

2015-07-22T08:22:54Z

Berkerpeksag: Update template location

= For translators =

<pre style="color: red;">This section has changed recently, since now Mediagoblin lives on Pootle.
Here you can find the basic information for translating.
For further details about using Pootle, please have a look at Pootle's Documentation:
http://docs.translatehouse.org/projects/pootle/en/stable-2.5.1/
or you can ask about more details using one of methods listed on http://mediagoblin.org/pages/join.html</pre>

It is very easy to add or complete the translation of MediaGoblin! We use the web interface provided by the GNU instance of Pootle to do the translations. You can see the current status of the translations per language [https://chapters.gnu.org/projects/mediagoblin/ here].

To start translating, just:

# If it's the first time you are translating in the GNU instance of Pootle, then [https://chapters.gnu.org/accounts/register/ register an account]. You will receive an email for activating your account.
# Then you can [https://chapters.gnu.org/accounts/login log in]
# Go to Projects > mediagoblin ([https://chapters.gnu.org/projects/mediagoblin/ direct URL] and click in your language
# Click on "Continue translation".

By default, Pootle only shows you strings that currently have no translation. You can click in the "Translate" tab to show the already translated strings, in case you want to improve any of them.
There are no translation teams, so you can just edit the strings (but try to be nice and consistent with the current translation). If you are a regular contributor to the translations, you might want to add some notes to the [[#Notes for some language teams|per-language section on this page]] to coordinate consistent translations.

Note: please don't translate the words "MediaGoblin" or "GNU" into your native language. Those words should be retained as-is for branding reasons. :)

==Fixing or improving translations ==

If you click in the "Overview" tab, you will see the status of the translation of MediaGoblin to your language. If you click on "Expand details" you will find some statistics and the results of several quality checks (about capitalization, punctuation matching or not the original and the translation) which may help you to fix or improve the translation.

== Notes for some language teams ==
=== German ===

Interessante Hinweise zur Übersetzung finden sich bei Gnome:
* http://live.gnome.org/de/UebersetzungsRichtlinien

In Abweichung von diesen Richtlinien wird momentan "Du" für die Anrede benutzt. "Du" und "Deine" werden groß geschrieben. Benutze die folgenden Begriffe um konsistent zu bleiben:

Benutzerkonto/Nutzerkonto, E-Mail, E-Mail-Adresse, Aktivierungsmail, Konto "aktivieren" (verify email), Album (collection), Kurztitel (slug)

=== Spanish ===

Se está adoptando la siguiente convención para la traducción al español. Si crees que alguna traducción se puede mejorar, sugiérela en la página de discusión de este artículo.

{|
!Inglés
!Español
!Comentarios
|-
|you
|tú
|(segunda persona del singular, expresión informal)
|-
|media
|contenido
|-
|slug
|ficha
|}

=== '''العربية''' ===

.سنتخذ الاصطلاحات التالية للترجمة العربية. إذا كنت تريد تحسين الترجمة يرجى اقتراح التغبرات في صفحة النقاش في هذا المقال
{|
!الانجليزية
!العربية
|-
|MediaGoblin .
|ميدياغوبلن
|-
|media .
|الميديا
|-
|slug .
|المسار
|}

= For developers =
== Marking strings for translation ==
=== In Jinja2 ===

See: http://jinja.pocoo.org/docs/templates/#i18n

Mostly like Django template i18n support, if you have any experience with that.

=== In python code ===

Usually, like this:

<pre>
from mediagoblin.util import pass_to_ugettext as _

def some_func(something):
return _(u'This string would tooootally be translatable now.')
</pre>

Except, in form modules we don't actually want to translate things because for various reasons that doesn't work, so we do the translation call template-side. So write the module to use the fake ugettext passthrough (which doesn't do any translation but still wraps things in _() so that Babel will know to extract these strings):

<pre>
from mediagoblin.util import fake_ugettext_passthrough as _

class FunkyMonkeyForm(wtforms.Form):
funky = wtforms.TextAreaField(
_('Funkiness description'))
</pre>

== Extracting translations ==

If you run buildout it should create a script called 'pybabel'. Use it to extract translations like so:

<pre>
./bin/pybabel extract -F babel.ini -o mediagoblin/i18n/templates/en/mediagoblin.po .
</pre>

== Compiling translations ==

<pre>
./bin/pybabel compile -D mediagoblin -d mediagoblin/i18n/
</pre>

== Pulling translations from Transifex (Warning! Obsolete) ==

<pre style="color: red;">This section contains obsolete information. Now Mediagoblin lives on Pootle.
Before the section is updated, you can ask about the process using one of methods listed on
http://mediagoblin.org/pages/join.html</pre>

Unfortunately until the next release of transifex-client which has been patched to have proper entry points, you have to run transifex-client from a virtualenv or from site-packages. But assuming that's done, pulling translations is easy:

<pre>
tx pull -a
</pre>

== Pushing new translations to Transifex (Warning! Obsolete) ==

<pre style="color: red;">This section contains obsolete information. Now Mediagoblin lives on Pootle.
Before the section is updated, you can ask about the process using one of methods listed on
http://mediagoblin.org/pages/join.html</pre>

<pre>
tx push -s
</pre>

= Troubleshooting (Warning! Obsolete) =

<pre style="color: red;">This section contains obsolete information. Now Mediagoblin lives on Pootle.
Before the section is updated, you can ask about the process using one of methods listed on
http://mediagoblin.org/pages/join.html</pre>

Got an error on Transifex like:

"Translation must start with a newline (\n)"?

The problem here is when we have something like:

{% trans register_url=request.urlgen('mediagoblin.auth.register') %}
<a class="header_submit_highlight" href="{{ register_url }}">Create a free account</a>
or
<a class="header_submit" href="http://wiki.mediagoblin.org/HackingHowto">Set up MediaGoblin on your own server</a>
{% endtrans %}

instead of:

{% trans register_url=request.urlgen('mediagoblin.auth.register') -%}
<a class="header_submit_highlight" href="{{ register_url }}">Create a free account</a>
or
<a class="header_submit" href="http://wiki.mediagoblin.org/HackingHowto">Set up MediaGoblin on your own server</a>
{%- endtrans %}

The distinction might not be obvious... look for the %} versus -%} and {% versus {%- on the first and last lines. The thing about this is this tells Jinja2 to strip the whitespace. Without that, Transifex sees that there's a "\n" on the first line of the original but not on the future translation, and gets upset.

If this happens the template should be updated to strip whitespace and translations should be pushed to transifex.

CommunityGovernance

2015-06-06T18:22:07Z

Berkerpeksag: Add myself for Python 3 support

MediaGoblin is a community project and we everybody try to help each other. Chris Webber is our lead developer, but the project should be able to self govern so he can take a break if he needs it or when he or other contributors take deserved holidays :)

In general, you can ask anything in the mailing list or the IRC channel and hopefully somebody will answer soon. Topics are discussed in the mailing list, IRC channel or monthly meetings (in the IRC channel).

In this page we list several tasks or areas along with the names or nicks of MediaGoblin community members that may help on them (for example, because they have permissions to perform certain operations). Please be kind when asking for help, most of us are volunteering for MediaGoblin in our free time, so answers or problems resolution can take a while.

Feel free to edit this page to list more tasks or sign the ones you self-assign.

More information about this in this mailing list thread: http://lists.mediagoblin.org/pipermail/devel/XXXXX

== MediaGoblin codebase ==

* People with permissions to commit/merge and handle the main codebase

* Python 3 support: berkerpeksag (berker on IRC)

== MediaGoblin website ==

* People with permissions to handle website outages

* Publish pages (for example new releases)

== MediaGoblin wiki ==

* Wiki administration

== MediaGoblin issue tracker ==

* Help triaging bugs:

* People with permissions to create accounts in trac

* People with permissions to delete users/issues/comments in trac

* Volunteers for spam cleaning: LArjona

== MediaGoblin translation platform ==

* If there is need of manual import/export files between Pootle and the MediaGoblin codebase, who can help on that
* LArjona (Spanish translator) can guide new translators, reproduce problems in the translation platform, test changes, and help with Pootle quality checks. Available in the mailing list and IRC channel.

== MediaGoblin IRC channel and mailing list ==

* Change IRC topic, channel operators