[Geany] Wiki?

Colomban Wendling lists.ban at xxxxx
Sun Apr 3 13:50:16 UTC 2011


Le 03/04/2011 15:29, Enrico Tröger a écrit :
> On Sun, 03 Apr 2011 15:02:07 +0200, Colomban wrote:
>
>> Le 03/04/2011 14:56, Enrico Tröger a écrit :
>>> On Sun, 3 Apr 2011 00:20:06 +0200, Frank wrote:
>>> [...]
>>>
>>> To enforce the decision a bit, are there any objections in using
>>> DokuWiki for wiki.geany.org with the MarkDown and/or reStructuredText
>>> plugins?
>>
>> I don't know MarkDown (well, never used it, I saw some files using
>> it), but I'd be fine with ReST.
>> Would this format(s) be the only one(s) available or would it be
>> optional? I don't think having pages in 2 different formats is a good
>> idea, but if it's transparent (e.g. we can edit any page using the one
>> we prefer) I second this :)
>
> Nah, one page has one format. If a page is written in ReST you can't
> edit in MarkDown syntax or DokuWiki's syntax and vice versa.
>
> I agree that if pages are written in different markup languages this is
> quite confusing. We could maybe say: everything has to be written in
> reStructuredText.
>
> Though in some cases it might better to use DokuWiki's syntax instead
> of reStructuredText. One example might be to show some code examples
> which can DokuWiki highlight out of the box, e.g.
>
> [...]
>
> In reStructuredText this isn't possible, without manually patching,
> AFAIK. There you have only a block with the code.
>
> So, in the end, I personally, would say we allow both syntax variants,
> accepting that it is a bit confusing.
> The good thing is, you quickly see what syntax a page is in when you
> are editing it because all reStructuredText pages are enclosed by<rst>
> tags.

I'm afraid having more than one formatting may be really problematic for 
contributions (e.g. the goal of a Wiki).
Moreover, what if somebody wants to add something unsupported by reST in 
a reST page?
Hum, that's problematic :D

Maybe we could just give all this a try and see what happens. If we see 
there is a real problem, it'd be tedious to convert back to something 
else but it's totally doable (and helped by a script should be quite 
fast... programmers or not :D).

Not sure, but I have no better idea (apart sticking with DokuWiki 
syntax, but I also understand the point of using the same thing that we 
generally use with Geany)...

My 1,5¢
Colomban



More information about the Users mailing list