From mboxrd@z Thu Jan 1 00:00:00 1970 From: Michael Tremer To: documentation@lists.ipfire.org Subject: New Wiki Software - Please help testing :) Date: Thu, 23 May 2019 14:35:18 +0100 Message-ID: <0E5794D4-C9A3-4D60-9217-23F88A4EDE9D@ipfire.org> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="===============0957363597637813427==" List-Id: --===============0957363597637813427== Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Hello people, I am busy with migrating the wiki to the new webapp. For those who are not aware of this happening: We are going to move away from= Dokuwiki. The story is quite a long one, but in short it is that I am unhapp= y with it. It has been a solid piece of software for us, but the user registr= ation process is broken. People cannot sign up to it. Spam bots can. It does = not look very nice and all in all it is written in PHP. The original plan was to port our design to it, but actually it is easier jus= t to write some wiki stuff into the web app where other parts already exist. = So I decided to use our web app and add two things: An editor for the pages, = a place to upload files and a big function that renders the pages. That is ab= out it. This wiki uses markdown. The syntax is very similar to the Dokuwiki syntax wi= th exception of images, tables and some other smaller things. But markdown is= widely used. Loads of people have probably used it somewhere else before. Al= so this is handy because I did not have to implement something that renders m= y own syntax. I have been working on a unified account system which is coming along nicely.= I have also been working on a converter that is porting all content from Dok= uwiki to the new wiki. Unfortunately this is not the easiest thing. The =E2=80=9Cnew=E2=80=9D wiki is currently available at https://wiki.dev.ipf= ire.org/. Please feel free to browse around and have a look what works well and what do= esn=E2=80=99t. All in all the converter converts a lot itself and I think the= pages look nice and clean. But some things cannot be converted so there migh= t be some stuff that we have to do manually. The biggest of those are tables that do not follow the normal standard. The o= ne on the index page for example is such a table. The second thing that does not work very well is paths. Loads of links are br= oken and point at arbitrary stuff. The wiki now follows the usual filesystem = approach with its URLs (: are / now) and you can go back with =E2=80=9C..=E2= =80=9D and remain in the same directory with =E2=80=9C.=E2=80=9D or by using = no prefix. I also decided not to import the whole history of the wiki. I am not sure if = there is any value in it. The data is old and there are tons of images that w= e no longer need. Also Dokuwiki has a nice API to go through all existing pag= es and going back into the archive is a bit more difficult. So, please have a look around. Log in. Edit things. I will probably run the i= mport again. Please help me find bugs and send me an email. I would like to switch over as soon as possible. Best, -Michael --===============0957363597637813427==--