Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

GitHub PyPI - Python Version PyPI - Status GitHub release (latest SemVer) PyPI Read the Docs GitHub Build GitHub Release

recitale

recitale. Static site generator for your story.

Make beautiful customizable pictures galleries that tell a story using a static website generator written in Python. You don't need to care about css, code and presentation, manage your contents in YAML file and recitale will take care about the rest.

recitale is sections oriented, make it very flexible, many kinds of section already available:

  • Parallax
  • Group of pics (gallery)
  • Paragraph
  • Iframe (Youtube, Maps, etc..)
  • Quote
  • And more

Important note: This project is considered in alpha state. There may be significant changes in configuration files, API or user interface at any time.

Screenshots

Features

recitale currently supports:

  • Automatic generation
  • Lightweight
  • Thumbnails & multiple resolutions for fast previews (JPEG progressive)
  • Videos support
  • Mobile friendly
  • Caching for fast rendering
  • Multi level gallery
  • Support themes (default, material, light)
  • Password access (encrypt page)
  • Image lazy loading
  • Night Mode
  • Completely static output is easy to host anywhere
  • Hackable

Examples

You can find example usages here:

Code example

title: Title
date: 2015-12-18
cover: P1070043-01-01.jpeg
sections:
  - type: full-picture
    image: P1060979-01-01.jpeg
    fixed: true
    text:
      title: My Story
      sub_title: some subtitle
      date: 2015-12-18
  - type: paragraph
    title: Beautiful Title
    text: Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor
  - type: pictures-group
    images:
      -
        - P1060938-01-01.jpeg
        - P1060946-01-01.jpeg
        - P1060947-01-01.jpeg
        - P1060948-01-01.jpeg

Usage

  recitale
  recitale test
  recitale preview
  recitale deploy
  recitale autogen (-d <folder> | --all ) [--force]
  recitale (-h | --help)
  recitale --version
                                                                                
Options:                                                                        
  test          Verify all your yaml data                                       
  preview       Start preview webserver on port 8000                            
  deploy        Deploy your website                                             
  autogen       Generate gallery automaticaly                                   
  -h, --help    Show this screen.                                               
  --version     Show version.

Docker

https://hub.docker.com/r/beudbeud/prosopopee/

Licence

GPL-3.0+

Documentation

http://recitale.readthedocs.org/en/latest/

IRC

channel : irc.libera.chat#recitale

Origin

recitale started as a fork of prosopopee.

recitale is a contraction of tale and the French word récit which are both depicting the same thing: a story.

It is also a play on recital which is related to poetry reading.

recitale should be pronounced /ʁe.siˈteɪl/ that is, the French pronounciation for récit followed by the English pronounciation of tale.

Download files

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

Source Distribution

recitale-2.0.0a1.tar.gz (18.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

recitale-2.0.0a1-py3-none-any.whl (9.7 MB view details)

Uploaded Python 3

File details

Details for the file recitale-2.0.0a1.tar.gz.

File metadata

  • Download URL: recitale-2.0.0a1.tar.gz
  • Upload date:
  • Size: 18.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for recitale-2.0.0a1.tar.gz
Algorithm Hash digest
SHA256 7148196364eb09c6a9b62821c7b2845b9e2083ed1f56a631c0924a53fb653ad5
MD5 1e4b16630b3fe7a44588085f0fc338b3
BLAKE2b-256 4f0d700ab384bbbe13377166594e6812761842530b043a53a1c5b40638721252

See more details on using hashes here.

File details

Details for the file recitale-2.0.0a1-py3-none-any.whl.

File metadata

  • Download URL: recitale-2.0.0a1-py3-none-any.whl
  • Upload date:
  • Size: 9.7 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for recitale-2.0.0a1-py3-none-any.whl
Algorithm Hash digest
SHA256 98599f4a6164dd55bc1b17278568f809ca1f7c7d114212b7b23d690d80e880fa
MD5 cf6ab12c5742c48b9e989a3176182887
BLAKE2b-256 ac4379326fb055609dd970e0dabe8ddec50244c4d590f2db9499345ee162c8a0

See more details on using hashes here.

Supported by

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