Commits

Jannis Leidel  committed d04fd95

Added initial idea

  • Participants
  • Parent commits 01a3aef

Comments (0)

Files changed (1)

-== Welcome ==
-
-Welcome to your wiki! This is the default page we've installed for your convenience. Go ahead and edit it.
-
-=== Wiki features ===
-
-This wiki uses the [[http://www.wikicreole.org/|Creole]] syntax, and is fully compatible with the 1.0 specification.
-
-The wiki itself is actually a hg repository, which means you can clone it, edit it locally/offline, add images or any other file type, and push it back to us. It will be live immediately.
-
-Go ahead and try:
-
-{{{
-$ hg clone http://bitbucket.org/jezdez/djangolocales/wiki/
-}}}
-
-Wiki pages are normal files, with the .wiki extension. You can edit them locally, as well as creating new ones.
-
-=== Syntax highlighting ===
-
-You can also highlight snippets of text, we use the excellent [[http://www.pygments.org/|Pygments]] library.
-
-Here's an example of some Python code:
-
-{{{
-#!python
-
-def wiki_rocks(text):
-	formatter = lambda t: "funky"+t
-	return formatter(text)
-}}}
-
-You can check out the source of this page to see how that's done, and make sure to bookmark [[http://pygments.org/docs/lexers/|the vast library of Pygment lexers]], we accept the 'short name' or the 'mimetype' of anything in there.
-
-Have fun!
+== djangolocales.org ==
+
+djangolocales.org should solve multiple problems within the increasing Django apps community and the Pinax project that uses those apps:
+
+=== Education ===
+
+Illustrates the steps involved to make reusable Django apps i18n ready additionally to the official Django documentation. This is mostly based on personal experience while developing apps and working with them (and others) in the Pinax project. This includes:
+
+* HOWTOs (marking strings, creating and updating po files, handle external apps, creating message catalogues)
+* screencasts (Poedit usage, ..)
+* examples for special cases that are not solved in Django (yet), e.g. number formatting, date inputs, ..
+
+That section is mostly based on articles that I want to add gradually over time. I hope to get some guest writers to participate. I also wondered if it should be wiki based for easier contribution but that's not decided yet.
+
+=== App translation ===
+
+The key feature of the site is based on Transifex with smaller parts from Pinax.
+
+App authors should be able to create their apps as Transifex projects and add app repositories. If possible they should also be able to claim their apps, if we decide to import app data from http://djangoplugables.com before or let other users create the Transifex projects, though both needs evaluation and probably agreement from the app authors.
+
+==== Translators should be able to: ====
+
+* browse the translation files
+* edit already given translations
+* create a new translation (locale) by using Django's own makemessages command
+* send a patch to the app owner (or a group of users) for review
+* download the created/updated Po file for local use
+
+==== App owners should //additionally// be able to: ====
+
+* review translation changes
+* give translators review permissions
+* commit changes back to the app's repository (if possible, later)
+
+As mentioned by <<user glezos>> on IRC Mozilla is going to release an abstract Python wrapper around different translation format which could be used: http://wiki.braniecki.net/Silme