josuah.net | panoramix-labs.fr
git | cv | links | quotes | ascii | tgtimes | gopher | mail
git://git.josuah.net/notmarkdown
- 1.1
Notmarkdown is a very simple site generator tool, that support a simple subset of markdown in which this document is formatted: notmarkdown.
It supports publication of the same .md files for both http+html and gopher+gph.
This documentation is maintained in the ./doc/
directory of the git repo, and on make site
, a build target regenerates the documentation using notmarkdown.
The notmarkdown(1) tool will search for *.md
files in all $srcdir
passed as arguments, and each file $path/file.$ext
found, gets copied to the matching $dstdir/$path/file.$ext
directory.
$ notmarkdown-html index.md >index.html $ notmarkdown-gph index.md >index.gph
This converts only the content, and adding a header can be done with cat:
$ notmarkdown-html index.md | cat head.html - >index.html $ notmarkdown-gph index.md | cat head.gph - >index.gph
$ git clone git://git.z0.is/notmarkdown $ cd notmarkdown $ make PREFIX=/usr/local MANPREFIX=/usr/local/man install
It does not support editing files directly through the website: it is one shell script calling one awk script on every page, generating a site in one of these formats:
To add a new converter backend, add in $PATH a script called notmarkdown-$ext that reads notmarkdown from stdin and sends the targetted format to stdout. For instance, a notmarkdown-txt backend that print the document unchanged or a notmarkdown-pdf aiming paper publication.
Strip the protocol part (http:
, https:
, gopher:
) from all your own links, and eventually remove the domain name as well.
//example.com/wiki/
and /wiki/
both get mapped to:
So instead of /wiki/page-name.md, use /wiki/page-name/index.md, and use links to /wiki/page-name/
(with a trailing /
, important for markdown-gph(1)).
No vHosts on Gopher: multiple domains with the same destination point to the same website, unlike the Web where you can redirect them as you wish.
For instance if //doc.example.com/
and //git.example.com/
point to the same server, geomyidae(1) will pick the same /index.gph
for both. A solution is to always use prefixes, like //doc.example.com/doc/
or //git.example.com/git/
.
notmarkdown is Markdown without nesting and HTML. This avoids all edge cases.
For instance, there is a good support for escaping and `backtick`
quoting. See notmarkdown(5) for full description.