README.markdown @ d9ae1a68cda2
default tip
Downcase titles in lookup table
I know this isn't i18n friendly, but this thing is only for
me and it will make my life significantly easier, so too bad.
author |
Steve Losh <steve@stevelosh.com> |
date |
Thu, 09 May 2024 16:06:08 -0400 |
parents |
90717aee8905 |
children |
(none) |
# mw
`mw` stands for any/all of the following:
* My Wiki
* Mini Wiki
* Make Wiki
* Markdown Wiki
License: GPLv3.
## Design
Wiki pages are vanilla Markdown files, because writing in any other format is
awful and version control is good. Metadata will be a single Lisp list at the
beginning of the file, read with `safe-read`.
No directories. Just one big list of Markdown files that get transformed into
`.html` files one-by-one. Links should be relative so you can serve them from
a subdirectory and it'll still work.
The home page is special-cased, its metadata includes metadata for the entire
wiki (title, link color, etc).
Linking is special-cased because it's so common. In addition to vanilla
Markdown links, there's an extra layer of postprocessing:
* `[Some Page]()`: looks up the destination by page title.
* `[Some Page](some-slug)`: looks up the destination by page slug.
Pages can have `extra-titles` and `extra-slugs`, so you can alias really common
pages to avoid typing.
Anything in `static` will be copied over verbatim, e.g. for images and such.
The output will be static, vanilla HTML files that can be served with anything.
No Javascript required.
## TODO
* Check for deleted files and delete them from build directory?
* Maybe an actual CLI?