Re: General wiki rules

2011-07-15 Thread Arran Cudbard-Bell
On Jul 14, 2011, at 9:57 PM, Phil Mayers wrote: On 07/14/2011 06:09 PM, Arran Cudbard-Bell wrote: 1. HTML tags like 'pre' will not be parsed by all renderers, just because it works in Gollum, doesn't mean it will work with a proper renderer for that markup format. For markdown its 3

Re: General wiki rules

2011-07-15 Thread Alexander Clouter
Arran Cudbard-Bell a.cudba...@freeradius.org wrote: There is no better alternative. You need to indent code blocks for them to be easily legible, as it breaks them out of the normal flow of the document. I think that's Phil's point. The code he is cutting and pasting in is no doubt

Re: General wiki rules

2011-07-15 Thread Arran Cudbard-Bell
On Jul 15, 2011, at 10:30 AM, Alexander Clouter wrote: Arran Cudbard-Bell a.cudba...@freeradius.org wrote: There is no better alternative. You need to indent code blocks for them to be easily legible, as it breaks them out of the normal flow of the document. I think that's Phil's

Re: General wiki rules

2011-07-15 Thread Phil Mayers
Arran Cudbard-Bell a.cudba...@freeradius.org wrote: Ok. I'm not saying these things to be an asshole. The point of moving to Gollum was that users would be able to contribute to the bundled documentation. The wiki now serves as a repository for server docs (or will do once we figure out

General wiki rules

2011-07-14 Thread Arran Cudbard-Bell
Ok heres the deal. There are three formats we use on the wiki: 1. markdown 2. restructuredtext 3. mediawiki Mediawiki pages contain content from our old mediawiki instance. Feel free to convert these to RST or Markdown, the wiki cloth renderer sucks so they probably won't render quite right

Re: General wiki rules

2011-07-14 Thread Johan Meiring
On 2011/07/14 07:09 PM, Arran Cudbard-Bell wrote: Ok heres the deal. There are three formats we use on the wiki: 1. markdown 2. restructuredtext 3. mediawiki I spent about 1/2 hour a while ago trying to get a basic guide to either markdown or restructuredtext. Google was unhelpful, are

Re: General wiki rules

2011-07-14 Thread Alan DeKok
Johan Meiring wrote: I spent about 1/2 hour a while ago trying to get a basic guide to either markdown or restructuredtext. Google was unhelpful, are there any good tutorials? restructuredtext cheat sheet http://docutils.sourceforge.net/docs/user/rst/quickref.html Alan DeKok. - List

Re: General wiki rules

2011-07-14 Thread Arran Cudbard-Bell
On Jul 14, 2011, at 7:37 PM, Johan Meiring wrote: On 2011/07/14 07:09 PM, Arran Cudbard-Bell wrote: Ok heres the deal. There are three formats we use on the wiki: 1. markdown 2. restructuredtext 3. mediawiki I spent about 1/2 hour a while ago trying to get a basic guide to either

Re: General wiki rules

2011-07-14 Thread Phil Mayers
On 07/14/2011 06:09 PM, Arran Cudbard-Bell wrote: 1. HTML tags like 'pre' will not be parsed by all renderers, just because it works in Gollum, doesn't mean it will work with a proper renderer for that markup format. For markdown its 3 spaces or a tab in front of every line, for RST it's