From mboxrd@z Thu Jan 1 00:00:00 1970 From: Michael Tremer To: documentation@lists.ipfire.org Subject: Re: New Wiki Software - Please help testing :) Date: Thu, 30 May 2019 15:50:01 +0100 Message-ID: <9D612114-964E-4D2C-823E-D90DDBCBE97F@ipfire.org> In-Reply-To: MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="===============6092160491875622191==" List-Id: --===============6092160491875622191== Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Hi, > On 27 May 2019, at 18:10, Matthias Fischer = wrote: >=20 > On 27.05.2019 18:27, Michael Tremer wrote: >> Hello, >>=20 >> ... >> * Matthias saved the same page a couple of times. That definitely shows th= at we need a preview function :) >=20 > 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. Okay, I just pushed some changes. There is now a preview function which automatically updates. I quite like it.= Tell me what you think. >=20 >> 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 anot= her way then this is a bug in the software. >>=20 >> But I have no idea how to find a good solution for this. Admittedly nothin= g is documented yet, but future editors might not read the documentation. Peo= ple edit first and I do want anyone to edit this wiki. We care about the info= rmation first, but we need to make sure that people do not mess up the markup. >=20 > That's why I - personally - would like to have something like 'Markdown=E2= =80=99. We sort of have markdown, but actually we almost use it to highlight words in= bold. I have added an image tag that works like the ones on Dokuwiki using {{=E2=80= =A6}}. >=20 >> I think that Dokuwiki is quite bad in that sense that it allows to be mess= y with the markup. This is also why conversion into another language is so di= fficult. There is multiple ways to do something and they can be mixed. Horror. >=20 > I wrote this with DokuWiki and I think, I know what you mean: > http://www.copfilter.org/wiki >=20 > But I liked the editing tools... ;-) We will get something done there. >=20 >> So what springs to mind here is: We could refuse saving the page when some= thing is not right. >=20 > +1 I was rather pointing out that that is a bad idea lol >=20 >> But I think that might feel very frustrating. An tag should never sh= ow up. If we find that, then we can just throw an error. >>=20 >> What do you guys think could work? >=20 > We should at least throw an error, refuse to save and go back to editing > mode. This is a horrible UI. >=20 >>=20 >> -Michael >>=20 >> 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 s= end me your thoughts in case you have any ideas. But make them easy to implem= ent :) >=20 > I need a documentation... ;-) You will get it. But since I am dropping the content of the whole wiki again = and again to test the import, I cannot write anything yet. > First thing that puzzled me today, e.g.: >=20 > On https://wiki.dev.ipfire.org/actions/edit/installation/step1 at page > bottom there is a link to the next step: [[./step2]]. >=20 > This leads to https://wiki.dev.ipfire.org/installation/step1/step2 So links work like this: When you are in /installation/step1, then using a link like [[step2]] will tr= anslate to /installation/step2. If you are using [[./something]], then that will result in /installation/step= 1/something. And [[../blah]] of course will go back one step and result in /blah. >=20 > 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. ;-) >=20 > But what is the right syntax at this point? I'll try on weekend... >=20 > Best, > Matthias -Michael --===============6092160491875622191==--