flat_slug.py

The articles slug is what determines the url to your page. It should be sanitized of special characters that do not work in the browser.

Explicit Slug in Frontmatter

If you explicitly set the slug in the frontmatter of a post, markata will not overwrite it.

---
title: My First Post
slug: /my-post

---

This is my first post it will be at `<markata.config['url']>/my-post/`
reguardless of filename.

Automatic Slug Based on Filename

By default the flat_slug plugin will use the stem of your filename, which is the filename without the extension, unless you explicitly set your slug in frontmatter.


pre_render function

Sets the article slug if one is not already set in the frontmatter.

pre_render source
def pre_render(markata: "Markata") -> None:
    """
    Sets the article slug if one is not already set in the frontmatter.
    """
    should_slugify = markata.config.get("slugify", True)
    for article in markata.iter_articles(description="creating slugs"):
        stem = article.get(
            "slug", Path(article.get("path", article.get("title", ""))).stem
        )
        if should_slugify:
            article["slug"] = "/".join([slugify(s) for s in stem.split("/")])
        else:
            article["slug"] = stem