Last Update 2017: Successor of this project is Moopato Website Builder
Some time ago i started thinking of building a better tools page for Imago. One of my requirements was that it had to be a plain static xhtml site, no dynamic generation on request. It’s the most frequented page here, so i’d prefer a simple static site. But i didn’t like to hardcode layout and content in one file. That would be a maintenance nightmare for me. I needed a better solution and came up with the following must have requiremtents:
After some time googling i gave up. I didn’t find an existing app, neither one i could easily adjust. So the Codeboje Website Builder (bloody working name) was born.
Our Website Builder is a simple tool that lets you build your website from simple templates and keep the contents in markdown text.
How it differes from other solutions:
Website Builder depends on the following python modules:
It’s simple and has some minor prerequisite one should know. Best is we take a look at the folder structure.
As you can see in the screenshot we need a folder for the content and one for the templates. The content files must have the endind .md.
The content folder:
Each page to generate has to have its own subfolder here. The name of the folder is also the name of the resulting page. All .md files inside a subfolder will be markdowned and accesible in the django template context. A simple named scheme applies:
In addition there are 2 special folders:
Each page can have its own template (pagename = templatename). Theres a fallback to the default.html template if none for the site is found. You should have full django template support.
After merging you’ll find the generated site in ./generated_html/ .
download the sitebuilder here Feedback is welcome :-)
Want content like this in your inbox
each workday irregularly? No BS, spam or tricks... just useful content: