Static website generator
A very simple static website generator tool powered by Python. It primarily converts Markdown files and combines it with an HTML template, but can be extended to other markup.
- Python 3 (
ReStructuredText (RST) support requires
docutils to be installed.
If you want to build the documentation, you will have to install Sphinx as well.
What sets it apart from other tools?
It's terrible and it doesn't have a profitable and pragmatic usecase in mind, but it works okay. For my needs, anyway. It's alright for simple blogs with no tagging and very simple static websites.
How do I make a site with this?
mdiocreby using the command:
python3 -m pip install mdiocre.
Create a work folder. Let's call it
Make a file called
template.htmlinside that folder with these contents:
<html> <head>Welcome to my website!</head> <body><!--:content--></body> </html>
Create a folder called
src, and make a file inside of it called
index.md, and write anything on it.
After your content (or before, it doesn't matter), add:
Go back a level to your
workfolder. Assuming Python is present in your PATH (environment variable), create a new text document containing:
python3 -m mdiocre.interface.cli src build
Save it inside the folder as a .bat if you're on Windows, or as a .sh if you're on Mac, Linux, or other Unix-like systems. Double click or execute it.
MDiocre allows setting variables. These variables are per-page, and can be read by the template. Both the template and the markdown page share the same format for templates - which are HTML comments with the first character after the markup being the colon (:)
Setting a variable to a string
<!--: hello = "test message" -->
test message. When using a comma, make sure to escape it with \!
Setting a variable to another variable
<!--: hello = lemons -->
hello will also be
lemons is not set,
hello will contain the string
Concatenating two or more variables
<!--: lemons = hello, hello -->
lemons will contain
abcabc. However, if you also include a space string in between, like this...
<!-- lemons = hello, " ", hello -->
lemons will contain
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.