summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRené 'Necoro' Neumann <necoro@necoro.net>2010-04-07 15:56:37 +0200
committerRené 'Necoro' Neumann <necoro@necoro.net>2010-04-07 15:56:37 +0200
commit8c524619ebba53110637206354287c3ed2093f9f (patch)
treec3267d1ab4c7f96ada9d4db4e6eaeeec90f437ca
parent58109aaba427800d166b025f0d9a38ff60987e7f (diff)
downloadweb-8c524619ebba53110637206354287c3ed2093f9f.tar.gz
web-8c524619ebba53110637206354287c3ed2093f9f.tar.bz2
web-8c524619ebba53110637206354287c3ed2093f9f.zip
Development page
-rw-r--r--highlighting.py2
-rw-r--r--templates/pages/development.mako51
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>