Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/comzeradd/monopati
a minimalistic static content generator
https://github.com/comzeradd/monopati
blog python python3 static static-site-generator
Last synced: 5 days ago
JSON representation
a minimalistic static content generator
- Host: GitHub
- URL: https://github.com/comzeradd/monopati
- Owner: comzeradd
- License: gpl-3.0
- Created: 2015-04-14T20:02:34.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2024-01-10T11:06:25.000Z (10 months ago)
- Last Synced: 2024-10-07T14:37:11.225Z (about 1 month ago)
- Topics: blog, python, python3, static, static-site-generator
- Language: Python
- Size: 2.98 MB
- Stars: 22
- Watchers: 4
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - comzeradd/monopati - a minimalistic static content generator (python3)
README
# monopati
A minimalistic static content generator.
You can read the [relevant post](https://www.roussos.cc/2016/01/11/monopati/) on why I started building this. Monopati is inspired by other great minimalistic content generators, like [bucket3](https://github.com/vrypan/bucket3/) and [habu](https://github.com/botherder/habu).
[](LICENSE)
## Usage
Install from pypi:
```
sudo pip install monopati
```
On first run create the website folder:
```
monopati --path=mywebsite init
```
This will create a folder named `mywebsite`. Inside that folder there is a
configuration example file that you should copy and edit to meet your needs.
```
cd mywebsite
cp config.yml.dist config.yml
```
Finally, build your website:
```
monopati render
```
This will generate all necessary files for serving the website, under the
folder you picked as output in your configuration file.
### Structure
Use `posts`, `pages` folders for blog and static content respectively.
Use templates for adjusting UI to fit your needs.
[Jinja2](http://jinja.pocoo.org/) template engine is being used for
both templates and pages. [Markdown](https://en.wikipedia.org/wiki/Markdown)
for blog posts.
### Example
The code comes with one example post (under the `posts`) folder. You can check
how the metadata header is being user and some basic syntax and how images can be
added to a post. Under the `pages` folder there is a static template example
which serves as the landing and about page of your site.
## Support
[](https://liberapay.com/comzeradd/donate)