The Grenzland Wiki

This is the diff between the backup and the current copy.

# The Grenzland Wiki

You need to have a Grenzland account and password in order to edit this wiki.

There is a dedicated `wiki` man page on the `grenzland.club` server.
Start there.

```
man wiki
```

The Oddmu pages are also available [on the web](https://alexschroeder.ch/view/oddmu/index).

## Markdown

The wiki supports Markdown with the following extensions:

- `[[word]]` is the equivalent of `[word](word)`.
- `#hashtag` is a hashtag and is used to speed up searches.
- `@username@instance` is a fedi account link.

## Access

Access control is delegated to the web server.
Here's how to change the access permissions for a subdirectory.

Let's create a subdirectory called "alex" by editing a page such as [alex/index](alex/index).
In order toA Grenzland user account allows you to edit the wiki.

On the server, the directory where all the files are belongs to the group `users`, with GUID set.
At the savme the filime, the subdirectory is created automatically.

Now return to the command line and edit the site configuration:

```
sudo vi /etc/apache2/sites-enabled/100-wiki.conf
```

Add a section like the following:

```
	<LocationMatch "^/(edit|save|add|append|upload|drop)/alex/">
          Require user alex
        </LocationMatch>
```

This limits the actions for URLs matching the given pattern to the user `alex`.

Reload the web server config to set it live:

```
sudo apachectl graceful
```Oddmu service unit uses the UMask 0002.
The result of this is that every file and directory created also belongs to the `users` group, with write permission.
Therefore, you can also SSH into the Grenzland server and edit the wiki files directly.

## Templates

The HTML files at the top level are used as templates.
This is where you change the links at the top and the bottom, the email address for contacts, the colour theme.

If you create pages in a subdirectory, you can make copies of the templates you are interested in and change them in your subdirectory. Each subdirectory also has its own [Home](index) and [Changes](changes) page.

## Files and directories

`certbot` was used to add the `wiki.grenzland.club` subdomain.

You can add and edit files directly without using a browser:
Use `oddmu notify your-page.md` to update `changes.md` in the same directory.
If your page name starts with an ISO date, it's considered to be a blog entry and added to `index.md`.
If it contains a hashtag and page with the same name exists, it is added there, too.