tweaks to documentation

pull/1/head
Alessandro Mauri 4 years ago
parent 6b5c973a64
commit 3e153082c1
  1. 20
      README.md
  2. 23
      rivet.1

@ -1,6 +1,11 @@
# Rivet: static site genetator # Rivet: static site genetator
River takes a source directory containing a the file sources and produces an Rivet is a static site generator that takes a directory containing markdown
output directory that can actually be uploaded to a server. markdown files (and a couple special ones) and generates an output directory
that can be uploaded to a server.
Rivet uses `lowdown(1)` to convert the markdown files to html, as such refer to
the `lowdown(5)` manpage for the details of the dialect of markdown and the
possible metadata that it can parse.
## Dependencies ## Dependencies
- [lowdown](https://kristaps.bsd.lv/lowdown/) - [lowdown](https://kristaps.bsd.lv/lowdown/)
@ -32,7 +37,16 @@ clean:
rm -rf ${DESTDIR} rm -rf ${DESTDIR}
``` ```
## Similar tools ## The source directory
The source directory tree should at least contain:
- `index.md`: will be converted to `index.html`
- `_header.html`: contains the stuff to be placed inside all headers
- `_footer.html`: contains the stuff to be placed inside all footers
Obviously anything can go in the source direcory, keep in mind that everything
that is not markdown files will be just copied over.
## Similar tools
- [saait](https://git.codemadness.org/saait/file/README.html) - [saait](https://git.codemadness.org/saait/file/README.html)
- [ssg](https://www.romanzolotarev.com/ssg.html) - [ssg](https://www.romanzolotarev.com/ssg.html)

@ -122,6 +122,29 @@ dst/
- sitemap.xml - sitemap.xml
.EE .EE
.SH BUGS
The only bug I know of is that all links to markdown files will not be converted
to links to html files during conversion:
.PP
test.md
.EX
# This is an example
Here's the [link](cool-page.md)
.EE
.PP
test.html
.EX
...
<h1> This is an example </h1>
<p> Here's the <a href="cool-page.md">link</a></p>
.EE
.PP
As you can see the link to
.I cool-page.md
was not converted to
.I cool-page.html
as such the link is dead.
.SH AUTHOR .SH AUTHOR
Alessandro Mauri <alemauri001@gmail.com> Alessandro Mauri <alemauri001@gmail.com>

Loading…
Cancel
Save