Static website generator
Project description
MDiocre
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.
Requirements
- Python 3 (
python-markdown
+py-gfm
)
Other Requirements
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?
-
Install
mdiocre
by using the command:python3 -m pip install mdiocre
. -
Create a work folder. Let's call it
work
. -
Make a file called
template.html
inside 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 calledindex.md
, and write anything on it. -
After your content (or before, it doesn't matter), add:
<!--:mdiocre-template="../template.html"-->
-
Go back a level to your
work
folder. 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.
-
Check the
build
folder.
Variables
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" -->
Simply sets hello
to test message
. When using a comma, make sure to escape it with \!
Setting a variable to another variable
<!--: hello = lemons -->
If lemons
is 1
then hello
will also be 1
. If lemons
is not set, hello
will contain the string lemons
.
Concatenating two or more variables
<!--: lemons = hello, hello -->
If hello
contains abc
then lemons
will contain abcabc
. However, if you also include a space string in between, like this...
<!-- lemons = hello, " ", hello -->
lemons
will contain abc abc
!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file mdiocre-3.5.3.tar.gz
.
File metadata
- Download URL: mdiocre-3.5.3.tar.gz
- Upload date:
- Size: 22.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 295b1d1a322afa2703a709b590531005ba069f039f4df367ee5f4bbc7aa3cdba |
|
MD5 | db79affcf3916d5a1f742194ced0dea8 |
|
BLAKE2b-256 | 4c0b7b8fced8c37d1da633554ea438b0cbd764987c30882501ba87a59490ccec |
File details
Details for the file mdiocre-3.5.3-py3-none-any.whl
.
File metadata
- Download URL: mdiocre-3.5.3-py3-none-any.whl
- Upload date:
- Size: 23.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 61e8493d542269cd657563ae478be4d3a206b96bba9521a21352b8c95221f044 |
|
MD5 | 055daf35d24a4755078b08fe4863ae5b |
|
BLAKE2b-256 | f61a01f5e9ee87764a307006eb639d00eb82ccf6744dd01529e44aec8b7402fa |