pyjan26 0.2

PyJan26 is a static site generator written in Python. It allows you to generate static websites from templates and content files, with support for pagination, custom pages, custom filters, and custom collections.

PyJan26

PyJan26 is a static site generator written in Python. It allows you to generate static websites from templates and content files, with support for pagination, custom pages, custom filters, and custom collections.

Installation

You can install PyJan26 using pip:

pip install pyjan26

Directory Structure

PyJan26 follows a specific directory structure:

project_directory/
│
├── _templates/ # Base and extendable templates
│ ├── base.html
│ └── custom_template.html
│
├── _content/ # Content files (Markdown)
│ ├── post1.md
│ ├── post2.md
│ └── about.md
│
└── public/ # Generated HTML files
├── index.html
├── post1/index.html
├── post2/index.html
└── about/index.html

Usage

• Templates: Design your base and extendable templates in _templates.
• Content: Define content files in _content. Each file specifies the layout and content of a page.
• Generated Files: PyJan26 generates static HTML files in the public folder based on templates and content files.

Pagination

To configure pagination, add the following YAML front matter to your content files:

layout: custom_template.html   # Specify the layout template
title: Post 1                  # Set the title of the page
paginated:                     # Configure pagination
  items: tags                  # Specify the grouping criteria (e.g., tags)
  size: 1                      # Set the number of items per page
  alias: myitem                # Set a custom alias for the paginated items

Pagination Variables

When pagination is enabled, PyJan26 provides built-in template variables that you can use to generate pagination links:

{% if myitem %}
  {% for page in myitem %}
    <span><a href="/post/{{ page.tag }}">{{ page.tag }}</a></span>
  {% endfor %}
{% endif %}

{% if pagination.prev_page %}
  <a href="{{ pagination.prev_page }}">Previous</a>
{% endif %}

{% for page_num in pagination.page_numbers %}
  <a href="{{ page_num.url }}">{{ page_num.page_number }}</a>
{% endfor %}

{% if pagination.next_page %}
  <a href="{{ pagination.next_page }}">Next</a>
{% endif %}

In this example:

• myitem represents the paginated items.
• pagination.prev_page provides a link to the previous page.
• pagination.page_numbers generates links to each page.
• pagination.next_page provides a link to the next page.

Copy Static Files

To specify static files to be copied to the public directory, add them to the STATIC_PATHS variable in your configuration (settings.py):

# Copy Static files
STATIC_PATHS = [
    "images",     # whole directory
    "assets/robots.txt"   # specific file
]

Adjust the paths as needed to include directories or specific files you want to copy.

Custom Collections

Define custom collections in custom_collections.py:

# custom_collections.py

from pyjan26.registry import register_custom_collections

def tag_list(collections):
    """
    Define a list of tags for the 'tags' collection.
    """
    return {'tags': [{'tag': 'javascript'}, {'tag': 'python'}]}

# Register custom collections
register_custom_collections([tag_list])

Custom Filters

Define custom filters in custom_filters.py:

# custom_filters.py

from pyjan26.registry import register_custom_filters

def capitalize_words(value):
    return ' '.join(word.capitalize() for word in value.split())


# Register custom filters
register_custom_filters([capitalize_words])

To use the custom filter in your templates, follow this syntax:

{{ content | capitalize_words }}

Custom Page Rendering

Define custom page rendering in custom_page.py:

# custom_page.py

from pyjan26.registry import register_custom_page
from pyjan26.core import render_page, render_string

def custom_page1(*args, **kwargs):
    """
    Custom page rendering function.
    """
    item, collection_name, collections, settings = args
    out_dir = kwargs.get('out_dir')

    # render jinja variable
    if out_dir:
        out_dir = render_string(out_dir, item)

    page_data = {
        'collection_name': collection_name,
        'collections': collections,
        'items': item,
        'out_dir': out_dir
    }

    render_page(page_data)


register_custom_page('custom1', custom_page1)

To apply custom page rendering to a content markdown file, add custom1: True to the YAML front matter:

layout: custom_template.html   # Specify the layout template
title: Post 1  
custom1: True                  # Apply custom page rendering

This instructs PyJan26 to use the custom_page1 function for rendering this specific content. Adjust metadata as needed.

Global Variable

To create a global variable PAGE_SIZE in settings.py, simply define it at the top of the file like so:

# settings.py

#example only
PAGE_SIZE = 10

This renders the template value of PAGE_SIZE defined in the settings.py module.

{{ settings.PAGE_SIZE }}