search

bjornbytes / lovr-docs

Documentation for LÖVR
45 stars 34 forks source link

instructions to generate docs in html like the website #76

Open jtoy opened 2 years ago

jtoy commented 2 years ago

So people can read docs like the website, but locally.

bjornbytes commented 2 years ago

The conversion to HTML is done in lovr.org. I want to switch to static generation so HTML/JSON/etc. can be generated with a simple script, but haven't prioritized it yet.

bjornbytes commented 2 years ago

I have implemented static generation in a single Lua file: .lua/generate.lua on the redbean branch. I'm working on switching over to this but there are some problems with the markdown library and webhooks blocking that.

The output files can be viewed on their own, but a further step could be to concatenate them all together to get an "all the docs on one page" thing.