Metadata-Version: 2.1
Name: pyjan26
Version: 0.2
Summary: 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.
Home-page: UNKNOWN
Author: Josnin
License: MIT
Project-URL: Source, https://github.com/josnin/pyjan26
Platform: UNKNOWN
Description-Content-Type: text/markdown
License-File: LICENSE

# 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:

```bash
pip install pyjan26
```

## Directory Structure

PyJan26 follows a specific directory structure:

```bash
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:

```yaml
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:

```html
{% 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):

```python
# 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`:

```python
# 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:

```python
# 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:

```html
{{ content | capitalize_words }}
```


## Custom Page Rendering
Define custom page rendering in custom_page.py:

```python
# 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:

```yaml
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:

```python
# settings.py

#example only
PAGE_SIZE = 10
```

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

```html
{{ settings.PAGE_SIZE }}
```



