Documentation June 2019

documentation@lists.ipfire.org

4 participants
4 discussions

IPS Rule selection page
by dnl 27 Jul '19

27 Jul '19

Hi all, I recently spent some time totally rewriting and fleshing-out the IPS rule selection wiki page: https://wiki.ipfire.org/configuration/firewall/ips/rule-selection. The iterative approach to choosing IPS rules is a difficult subject to put in to words succinctly and I feel the page has become very long and wordy. I'm aware that some people reading the English documentation won't have English as their first language, so I'd appreciate any feedback you have. Contrary to that, I feel that the page would be easier to understand if we had more good examples for readers. I've briefly communicated with TimF and he mentioned the flowbits bug/limitations at the moment (bugs like 12086 and 12078). If these bugs cannot be fixed soon or easily could someone with a better understanding come up with a set of work-around steps we could write in a notice somewhere in the IPS documentation? Thank you, dnl

2 2

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

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

Documentation June 2019