2023-01-17 01:13:12 +00:00
|
|
|
# calathea v0.1
|
|
|
|
|
|
|
|
calathea is a small C program used to generate static wikis. It takes a
|
2023-01-17 01:20:25 +00:00
|
|
|
directory of Common Markdown pages with `[[wikilinks]]` and renders them to
|
2023-01-17 01:13:12 +00:00
|
|
|
HTML. The output is a flat directory of HTML pages where the wikilinks are
|
|
|
|
converted to relative links.
|
|
|
|
|
|
|
|
This is also my first full, complete project written entirely in C, which has
|
|
|
|
proved to be a serious trial by fire in learning how to effectively work with
|
|
|
|
zero-terminated strings. There will likely be memoryleaks and comments that
|
|
|
|
over explain every line of code.
|
|
|
|
|
|
|
|
## Features
|
|
|
|
- [x] Rendering wikilinks
|
2023-01-20 17:23:19 +00:00
|
|
|
- [x] Ability to keep track of incoming links
|
2023-01-17 01:20:25 +00:00
|
|
|
- [ ] Named wikilinks (i.e. `[[link title|actual page]]`)
|
2023-01-17 01:13:12 +00:00
|
|
|
|
|
|
|
## installation
|
|
|
|
This tool requires [cmark](https://github.com/commonmark/cmark) to be
|
|
|
|
installed. Once that's set up, clone the repository and run:
|
|
|
|
|
|
|
|
```
|
|
|
|
$ make
|
|
|
|
```
|
|
|
|
|
|
|
|
If GCC complains it can't find cmark, then try running `ldconfig`. If it
|
|
|
|
still doesn't work, then run `echo $LD_LIBRARY_PATH`. If it doesn't show
|
|
|
|
anything, you've got to add the right directory to the path, i.e.,
|
|
|
|
|
|
|
|
```
|
|
|
|
$ export $LD_LIBRARY_PATH=/usr/local/lib64
|
|
|
|
```
|
|
|
|
|
|
|
|
Or wherever it got installed as per the output of running `make install` for
|
|
|
|
cmark.
|