Skip to main content

Use Jinja2 template system to build static pages with Flask integration

Project description

Almoststatic

Almoststatic is a static sites and web pages generator engine written in Python which utilizes the Jinja2 template system to render pages. It can be integrated with Flask apps to serve static contents on dynamic sites or used standalone for static sites development.

Pages are declared in YAML files and rendered with Jinja2 template files. The HTML contents can be written in Markdown markup language or in plain HTML. The “content” folder contains all data needed to do the job, and the “config.yaml” is used to share global parameters and to set up configuration.

It is loosely inspired by Hugo static site generator, but it differs in many ways.

Why Almoststatic?

There are many static site generators such as Next.js, Hugo or Jekyll, but you can prefer Almostatic because:

  • It's perfect for pythonist. It uses Jinja2 and Flask which are widely used by python community, so you don't need to learn other programming languages or template engines.
  • It's easy! In fact the rules are very few and this mean few things to learn and great flexibility.
  • It's versatile. It's engine has a powerful recursive system for embedding and including contents. This helps you to build rich contents and also to split them in small pieces called "widgets" easier to maintain.
  • It has blog capabilities. Contain functions used to query metadata info useful to organize blog pages by categories and tags.
  • You can deliver static and dynamic contents at same time. With Flask you can build your dynamic content and let Almoststatic to render the rest of page or the whole page, if it is full static.
  • Write static sites. Static sites are composed only by text files and media contents. They are easy to deliver on the web, are secure by design, require less maintenance and resources and are faster. If you have no need for dynamic contents, with Almoststatic you can write all pages as static.
  • Not only for pythonists. Basic knowledge of python is needed, but once your developer environment is ready, Almoststatic lets you to focus on writing yaml and karkdown's contents and to create your own widgets in html and Jinja2.

Quick start

The simplest way to see if Almoststatic is what you're looking for, is to try the sample provided with source code package and explore the source code.

The following tutorial is tested on Linux Ubuntu, but it's easy to port on other platforms such other Linux distros, Windows or Mac.

You need git and python3, install them with:

$ sudo apt install git python3

Last linux's releases comes with python3 already installed and you have only to check if your version is 3.6 or higher:

$ python3 --version

Now clone Almoststatic with git and enter into the directory:

$ git clone https://gitlab.com/claudio.driussi/almoststatic.git
$ cd almoststatic

It's common in python using virtualenv for development, to do so and to install Almoststatic, write:

$ python3 -m venv myvenv
$ source myvenv/bin/activate
$ pip install almoststatic
$ pip install pyftpsync

Done! Now you can try the sample, cd into sample directory and run flaskapp.py:

$ cd sample/
$ python flaskapp.py

A local host Flask App instance server is executed and you can test Almoststatic features.

Open your browser and copy and paste the following URL: http://127.0.0.1:5000/ or localhost:5000

You will be redirected to the static site showing some widgets and feature of Almostatic, you can navigate to see some examples.

You can always exit from server pressing CTRL-C on your terminal.

To build static site run:

$ python write_static.py
$ ls -l ../_static_site/

As you can see, your pages are written as *.html files, but this is not enough to get a really static site, to do this you have to tune writing parameters and copy media files on appropriate location. When you are done the site can be published as static site.

If you wish, you can run tests:

$ cd ../test
$ python as_test.py

This do some tests and write a simpler static site.

Now if you decide that Almoststatic is right for you, you can dig into source code of sample and tests and read the documentation at: https://almoststatic.readthedocs.io

Status of project

Almoststatic is young but stable! It has all planned features and always gave me the right results so it can be considered "production ready"

At the moment there are only a few themes, we are developing a "rolling theme" with some beautiful widgets ready to use. See Flatstep theme and follow the tutorial.

I'm not a designer so the result is of average quality. But I'm sure that good designers can write great themes.

Donate

If you appreciate Almoststatic, you can make a donation via PayPal

paypal

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

almoststatic-1.0.5.tar.gz (17.2 kB view details)

Uploaded Source

Built Distribution

almoststatic-1.0.5-py3-none-any.whl (14.9 kB view details)

Uploaded Python 3

File details

Details for the file almoststatic-1.0.5.tar.gz.

File metadata

  • Download URL: almoststatic-1.0.5.tar.gz
  • Upload date:
  • Size: 17.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.12

File hashes

Hashes for almoststatic-1.0.5.tar.gz
Algorithm Hash digest
SHA256 2c52502f5e5601ec6825dd12f5ca0cc584d1c6e0b1f65affdce5d954e335bf27
MD5 ed86358fb6695adacda97d0c96e0e893
BLAKE2b-256 7b0c277db72ee72eb5e2a91bcd6983aae78903a55b24eeb79f0d8afd311123bc

See more details on using hashes here.

File details

Details for the file almoststatic-1.0.5-py3-none-any.whl.

File metadata

  • Download URL: almoststatic-1.0.5-py3-none-any.whl
  • Upload date:
  • Size: 14.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.12

File hashes

Hashes for almoststatic-1.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 a1bb1e5082bcc60bbc3f5908b13678ca673ea0a7e5961da732b8aebcd0578172
MD5 6868994da532a1a63db1d4401ce503cf
BLAKE2b-256 7c422193d93947a4cb6c809f863afd533956cfdeb20a2902615c478c456e477a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page