News (20210723a)


Package System
Package Manager




wiki / help / about-this-wiki                                     Edit this page

Edited (3bd2820) at 2020-11-16 by Timothy Robert Bednarzyk


This Wiki is generated from plain .txt files and supports some basic formatting
options. Any formatting is simply substituted using a call to 'sed' during site

The custom syntax is designed to be unobtrusive as white-space controls layout.
Full HTML is also supported in pages though it should only be used if 100%

[0.0] Index

- Repository layout                                                        [1.0]
- Relative links                                                           [2.0]
- Reference links                                                          [3.0]
- Links to Github                                                          [4.0]
- HTML                                                                     [4.0]

[1.0] Repository layout

The Wiki lives in a separate repository ($/kisslinux/wiki). It is then imported
as a submodule inside of the website's repository ($/kisslinux/website). This
keeps things neat and tidy. It also makes contribution easier as it's less
daunting compared to nesting it inside the website's tree.

[2.0] Relative links

Links to other wiki pages can be written in the following way:


Which is turned into:

    @/<a href="/wiki/help/wiki-syntax">wiki-syntax</a>

[3.0] Reference links

Adding [0] to some text will create an anchor link to a corresponding reference.
This corresponding reference must also be created by the writer of the document.
The build system will simply link them together for you. [1]

The above table of contents [0.0] is simply the same concept but in reverse.
This simple find/replace ends up being a very powerful tool.

[0] Clicking the above reference will scroll the page to these anchor links.
[1] Links such as this one must start at column zero.

[4.0] Links to Github

Links to GitHub repositories can be written in the following way:


Which is turned into:

    $/<a href="https://github.com/username">username</a>

[5.0] HTML

Writing HTML directly is also supported as these .txt files will be inserted
into a HTML template during the build process. Usage of HTML should be avoided
as it makes the plain text files themselves less readable.

When writing the greater-than or less-than characters, use the HTML entities in
place of the characters to prevent them being interpreted as HTML.


Dylan Araps (C) 2019-2021

The registered trademark Linux(R) is used pursuant to a sublicense from the
Linux Foundation, the exclusive licensee of Linus Torvalds, owner of the mark
on a world­wide basis.