teesloane / firn

Org Mode Static Site Generator
Eclipse Public License 1.0
324 stars 24 forks source link
emacs org-mode rust static-site-generator

+html:

Firn

+html:

A Static Site Generator for Org Mode

+html:

GitHub release (latest by date including pre-releases)  Discord 

Currently, running the firn binary on a directory of org files performs the following:

+begin_src

navigate to a directory that has some org-files in it, then

scaffold out a site:

firn new

go explore what was generated:

ls -la _firn

start a server and go looking for your files:

if you have an org file called 'foo.org' it will become 'foo.html' etc.

firn serve

ready to build the output?

firn build

+end_src

Read the full usage documentation [[https://theiceshelf.com/firn.html][here]].

A small roadmap can be found [[https://theiceshelf.com/firn.html#Roadmap][here.]]

The development server is quite naive. There is no caching or diffing in the replacement of changed assets in the /static or /data folder. ** Footnotes Due to how the parser parses footnotes, they must look like so:

+begin_src

[fn:1]

#+end_src *Not* like this: #+begin_src [fn:1] #+end_src