Overview

The lamya package provides both an out of the box markdown static site generator and a framework for building your own custom ones.

lamya requires: Python 3.8+.

Quickstart

CLI

You can run lamya’s static site generator as a module to turn a directory of markdown files into a static site:

python -m lamya -url "http://my_url.com" --content_directory "path_to_content/" [OPTIONS]

This will take all the markdown descendants of the path_to_content directory and turn them into a static site, built into a folder called build in the current directory.

Note

If no --content_directory flag is provided, ./content will be used. Additionally the --build_directory flag can be used to specify where to build the site. For more info about flags have a look at the full CLI Reference.

Build script

Or you could write a simple build script which uses the lamya.site_generator.SiteGenerator like so:

from lamya.site_generator import SiteGenerator
from pathlib import Path

site_gen = SiteGenerator(name="dontpanic", url="https://dont.panic",
    subtitle="we demand rigidly defined areas of doubt and uncertainty",
    theme_options={"sidebar":True, "sidebar_image":"/img/sidebar.png"},
    content_directory=Path("content"))

# Make sure all content has been read and any front matter information has been
# extracted, so it can be used in the templates
site_gen.process_content_tree()

# optionally modify your existing content, generate new one, categorize
# posts, etc.

# optionally build a navigation
site_gen.build_navigation()
# or you could manually provide one
# site_gen.navigation = {}

# generate the site
site_gen.render()

Alternatively, if you like the idea of mostly maintaining one Config object, which specifies most of your build process, you can utilize the same function that generates the site via the CLI method above - lamya.site_generator.SiteGenerator.run_from_config().

from lamya.config import Config as DefaultConfig
from lamya.site_generator import SiteGenerator

class Config(DefaultConfig):
    name = "dontpanic"
    url = "https://dont.panic"
    subtitle="we demand rigidly defined areas of doubt and uncertainty",
    content_directory="content",
    theme_options = {
        "sidebar": True,
        "sidebar_image": "/img/sidebar.png"
    }

site_gen = SiteGenerator.run_from_config(Config(), render=False)

# We've set `render` to False above, so we can make any changes we'd like
# here before actually rendering the site

# NOTE: That this method is more similar to the CLI method above, since
# all of the functions like `process_content_tree`, `build_navigation`, etc.
# are called inside the `run_from_config`.

site_gen.render()

Features

designed to be interacted with - import it and build your site the way you want it
provides an out-of-the-box site generator
content is described by a simple and easily modified tree structure
even though, there’s no specific extensions support, lamya is easily extensible, since it’s just a small collection of simple python objects

Documentation

Get started - install lamya and learn the basics to hit the ground running
Themes - information about developing, customizing, interacting with themes and also the documentation of the default theme
CLI Reference - command line interface reference
API Reference - complete lamya API reference