Documentation May 2019

documentation@lists.ipfire.org

4 participants
6 discussions

New Wiki Software - Please help testing :)
by Michael Tremer 18 Jul '19

18 Jul '19

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 unhappy with it. It has been a solid piece of software for us, but the user registration 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 just 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 about it. This wiki uses markdown. The syntax is very similar to the Dokuwiki syntax with exception of images, tables and some other smaller things. But markdown is widely used. Loads of people have probably used it somewhere else before. Also this is handy because I did not have to implement something that renders my 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 Dokuwiki to the new wiki. Unfortunately this is not the easiest thing. The “new” wiki is currently available at https://wiki.dev.ipfire.org/. Please feel free to browse around and have a look what works well and what doesn’t. 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 might be some stuff that we have to do manually. The biggest of those are tables that do not follow the normal standard. The one 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 broken and point at arbitrary stuff. The wiki now follows the usual filesystem approach with its URLs (: are / now) and you can go back with “..” and remain in the same directory with “.” 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 we no longer need. Also Dokuwiki has a nice API to go through all existing pages 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 import again. Please help me find bugs and send me an email. I would like to switch over as soon as possible. Best, -Michael

5 14

Re: New Wiki Software - Please help testing :)
by Michael Tremer 06 Jun '19

06 Jun '19

Hi, It looks like this was only broken for the index page. I pushed out some changes. Please try again. -Michael > On 30 May 2019, at 18:04, Jon Murphy <jcmurphy26(a)gmail.com> wrote: > > Michael - The preview does not work for me. I see the word "Preview" and then to the far right I see a spinning circle. Below that I see "Loading...". > > Jon > > <Screen Shot 2019-05-30 at 11.45.40 AM.png> > > >> From: Michael Tremer >> Sent: Thursday, May 30, 2019, 9:50 AM >> To: Matthias Fischer >> Cc: Jon Murphy; documentation(a)lists.ipfire.org >> Subject: Re: New Wiki Software - Please help testing :) >> >> >> >> Okay, I just pushed some changes. >> >> There is now a preview function which automatically updates. I quite like it. Tell me what you think. >> >

2 11

Browser based editor for markdown
by Jon Murphy 06 Jun '19

06 Jun '19

Maybe this will help. It is updated! Jon https://stackedit.io/app# https://stackedit.io https://github.com/benweet/stackedit

3 4

Re: New Wiki Software - Please help testing :)
by Michael Tremer 30 May '19

30 May '19

Hi, Do you have javascript enabled? Can you open the error console of your browser and let me know what it says? I tested with Safari and Firefox. What browser are you using? -Michael > On 30 May 2019, at 18:04, Jon Murphy <jcmurphy26(a)gmail.com> wrote: > > Michael - The preview does not work for me. I see the word "Preview" and then to the far right I see a spinning circle. Below that I see "Loading...". > > Jon > > <Screen Shot 2019-05-30 at 11.45.40 AM.png> > > >> From: Michael Tremer >> Sent: Thursday, May 30, 2019, 9:50 AM >> To: Matthias Fischer >> Cc: Jon Murphy; documentation(a)lists.ipfire.org >> Subject: Re: New Wiki Software - Please help testing :) >> >> >> >> Okay, I just pushed some changes. >> >> There is now a preview function which automatically updates. I quite like it. Tell me what you think. >> >

2 1

Re: New Wiki Software - Please help testing :)
by Jon Murphy 30 May '19

30 May '19

Michael - It seems like there are some differences between Markdown and the new wiki app. One is the double brackets, e.g., [[relativeLink]] With the old wiki I could search thru the Dokuwiki website for hints. What is the name of the new app? That will give us a better idea of how to use it. Jon

3 8

Re: New Wiki Software - Please help testing :)
by Jon Murphy 24 May '19

24 May '19

Michael - I’d be happy to help also! I tried to EDIT but I only get: Error 401 - oops, something went wrong And I tried to login (bottom right corner of web page) but the web page just sits and waits. Eventually I get: Proxy Error The proxy server received an invalid response from an upstream server. The proxy server could not handle the request GET /login. Reason: Error reading from remote server Jon

1 0

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

Documentation May 2019