https://github.com/neurophant/lazycms
Minimalistic CMS in Python with Markdown content
https://github.com/neurophant/lazycms
cms cms-framework fastapi markdown
Last synced: 4 months ago
JSON representation
Minimalistic CMS in Python with Markdown content
- Host: GitHub
- URL: https://github.com/neurophant/lazycms
- Owner: neurophant
- License: mit
- Created: 2024-07-11T18:15:45.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-07-11T18:22:22.000Z (almost 2 years ago)
- Last Synced: 2025-11-29T04:58:22.709Z (7 months ago)
- Topics: cms, cms-framework, fastapi, markdown
- Language: Python
- Homepage:
- Size: 5.86 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
Lazy CMS
========
Minimalistic CMS in Python with Markdown content
Features
--------
* No storages, simple file structure
* Markdown content with images
* Static auto-collection
* Simple pagination
Requirements
------------
* Python 3.12
* FastAPI 0.111.0
* Jinja2 3.1.4
* Markdown 3.6
* PyYAML 6.0.1
* python-slugify 8.0.4
* pydantic 2.8.2
Install
-------
.. code-block:: bash
python3.12 -m venv venv
source venv/bin/activate
pip install lazycms
Usage
-----
Example project structure:
* project/
* static/
* content/ - empty directory, static content will be collected here
* theme/ - your theme css/js
* storage/ - your file storage directory
* article-1/ - entity (article) directory
* content.md - your article
* meta.yml - entity metadata
* picture.jpeg - picture for your article
* preview.md - entity article miniature for index page
* article-2/
* content.md
* meta.yml
* picture.jpeg
* preview.md
* templates/ - Jinja2 templates directory
* index.html - entity index template with **entity** and **paginator** context objects
* entity.html - entity template with **entity** context object
* app.py - CMS code
* app.yml - CMS config
project/storage/article-1/content.md:
.. code-block:: markdown
# Article 1
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna
aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
project/storage/article-1/preview.md:
.. code-block:: markdown
# Article 1
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna
aliqua. Ut enim ad minim veniam...
project/storage/article-1/meta.yml:
.. code-block:: yaml
timestamp: !!timestamp 2024-01-01T17:00:00Z
title: Article 1
content: content.md
preview: preview.md
images:
- picture.jpeg
tags:
- article
- test
project/templates/index.html:
.. code-block:: html
{% for entity in entities %}
{{ entity.preview|safe }}
{% endfor %}
{% if paginator.page > 1 %}
Prev
{% else %}
Prev
{% endif %}
{% if paginator.page < paginator.page_count %}
Next
{% else %}
Next
{% endif %}
project/templates/entity.html:
.. code-block:: html
{{ entity.content|safe }}
project/app.yml:
.. code-block:: yaml
# Storage config
storage_type: FILE
storage_path: ./storage
storage_meta: meta.yml
# Static config
static_path: ./static
static_url: /static
# Static collected content config
collect_path: ./static/content
collect_url: /static/content
# Templates
templates_path: ./templates
# Pagination
paginate: 10
project/app.py:
.. code-block:: python
from lazycms import LazyCMS
cms = LazyCMS(config_path='app.yml')
Run:
.. code-block:: bash
uvicorn app:cms.app --reload
http://localhost:8000 - index page
http://localhost:8000/2024-01-01-article-1 - Article 1 page
http://localhost:8000/2024-01-02-article-2 - Article 2 page
Tests
-----
TBD