Re: New Wiki Software - Please help testing :)

[Matthias Fischer <matthias.fischer@ipfire.org>]

[-- Attachment #1: Type: text/plain, Size: 2592 bytes --]

On 27.05.2019 18:27, Michael Tremer wrote:
> Hello,
> 
> ...
> * Matthias saved the same page a couple of times. That definitely shows that we need a preview function :)

Yep. My opinion: I/we need this. Every now and then it happens that
you'll miss something or produce a typo. A preview function would help
avoiding this.

> I do not want to point any fingers here at all. But I learned things from this. If it felt natural for you to do these things, but it was meant in another way then this is a bug in the software.
> 
> But I have no idea how to find a good solution for this. Admittedly nothing is documented yet, but future editors might not read the documentation. People edit first and I do want anyone to edit this wiki. We care about the information first, but we need to make sure that people do not mess up the markup.

That's why I - personally - would like to have something like 'Markdown'.

> I think that Dokuwiki is quite bad in that sense that it allows to be messy with the markup. This is also why conversion into another language is so difficult. There is multiple ways to do something and they can be mixed. Horror.

I wrote this with DokuWiki and I think, I know what you mean:
http://www.copfilter.org/wiki

But I liked the editing tools... ;-)

> So what springs to mind here is: We could refuse saving the page when something is not right.

+1

> But I think that might feel very frustrating. An <img> tag should never show up. If we find that, then we can just throw an error.
> 
> What do you guys think could work?

We should at least throw an error, refuse to save and go back to editing
mode.

> 
> -Michael
> 
> P.S. I pushed out a couple of fixes, but I do not have a preview function yet. Not sure whether I can make that update live or if we will have a button. Or maybe a two-step save process. I need to explore that a little. Please send me your thoughts in case you have any ideas. But make them easy to implement :)

I need a documentation... ;-)

First thing that puzzled me today, e.g.:

On https://wiki.dev.ipfire.org/actions/edit/installation/step1 at page
bottom there is a link to the next step: [[./step2]].

This leads to https://wiki.dev.ipfire.org/installation/step1/step2

But this link doesn't work ("Page does not exist") and I have no chance
to test it. I can only change something, save the page and and pray that
it works. I tried and get: "oops, something went wrong".
Hm. Yes. Great. ;-)

But what is the right syntax at this point? I'll try on weekend...

Best,
Matthias