From 8c524619ebba53110637206354287c3ed2093f9f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ren=C3=A9=20=27Necoro=27=20Neumann?= <necoro@necoro.net>
Date: Wed, 7 Apr 2010 15:56:37 +0200
Subject: Development page

---
 highlighting.py                  |  2 +-
 templates/pages/development.mako | 51 +++++++++++++++++++++++++++++++++++++++-
 2 files changed, 51 insertions(+), 2 deletions(-)

diff --git a/highlighting.py b/highlighting.py
index 7b4fce4..f859920 100644
--- a/highlighting.py
+++ b/highlighting.py
@@ -5,7 +5,7 @@ from pygments.formatters import HtmlFormatter
 
 formatter = HtmlFormatter(encoding = "utf-8", classprefix="pygm", nowrap=True)
 
-BashLexer.tokens["basic"].append((r'\b(emerge|layman)\s*\b(?!\.)', Name.Builtin))
+BashLexer.tokens["basic"].append((r'\b(emerge|layman|git(?!:))\s*\b(?!\.)', Name.Builtin))
 
 def highlight(context, code, lang):
     l = get_lexer_by_name(lang, encoding = "utf-8")
diff --git a/templates/pages/development.mako b/templates/pages/development.mako
index 20fc521..20d8054 100644
--- a/templates/pages/development.mako
+++ b/templates/pages/development.mako
@@ -1,7 +1,56 @@
 <%!
     title = "Development"
+    uses_toc = True
 %>
 <%inherit file="/page.mako" />
 <p>
-Developers, Developers, Developers
+    If you want to have a look at the sourcecode, or even support the development with patches or similar, you are now on the correct page :).
+</p>
+
+${self.toc()}
+
+<%self:h2>Getting the source</%self:h2>
+<p>
+    Portato's sourcecode is managed with <a href="http://www.git-scm.com/">Git</a> (<strong>dev-vcs/git</strong>) and is hosted on <a href="http://github.com/Necoro/portato">GitHub</a> and <a href="http://git.necoro.eu/portato.git/">on this very server</a>. So you can chose the one you want to clone from:
+</p>
+<%self:hl lang="bash">
+# either this
+git clone git://github.com/Necoro/portato.git
+
+# or that
+git clone git://necoro.eu/portato.git
+</%self:hl>
+<p>
+    You now should have a subdirectory <em>portato/</em>, which contains the sources. If you want to update it to reflect upstream changes, do:
+</p>
+<%self:hl lang="bash">
+git pull
+</%self:hl>
+<p>
+    Sometimes you need to work on a specific version (for instance if you are <a href="/translating">translating</a>). Then you need to check out the specific version branch:
+</p>
+<%self:hl lang="bash">
+# replace '0.13' by the version you need
+git checkout -b 0.13 origin/0.13
+</%self:hl>
+<p>
+    For further information have a look at the <a href="http://www.git-scm.com/documentation">Git documentation</a> or search the webs. There are plenty of sources and guides out there.
+</p>
+
+<%self:h2>Filing a bug</%self:h2>
+<p>
+    You can do this in the <a href="/r/bugs">bugtracker</a>.
+</p>
+
+<%self:h2>Documentation</%self:h2>
+<p>
+    The code itself is documented (sometimes ^^). If you have questions, you can ask them via portato@necoro.net.
+</p>
+<p>
+    The software itself is not documented in any way. If you like to change this, drop me a mail :). I'd be glad.
+</p>
+
+<%self:h2>Wiki/Mailing-list/...</%self:h2>
+<p>
+    Not there (yet?). Are they really necessary?
 </p>
-- 
cgit v1.2.3