Metadata-Version: 2.4
Name: jssg
Version: 2026.3.4
Summary: Minimalist and pragmatic static site generator, with an emphasis on blogging.
Project-URL: Homepage, https://codeberg.org/jtorres/jssg
Project-URL: Issues, https://codeberg.org/jtorres/jssg/issues
Author-email: Joel Torres <joel@joeltorres.net>
License-Expression: 0BSD
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: Zero-Clause BSD (0BSD)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.13
Requires-Dist: jinja2==3.1.6
Requires-Dist: markdown==3.10.1
Requires-Dist: markupsafe==3.0.3
Description-Content-Type: text/markdown

# jssg

Minimalist and pragmatic static site generator, with an emphasis on blogging.

## Requirements

Python 3.13+

## Dependencies

* [Jinja2](https://pypi.org/project/Jinja2/)
* [MarkupSafe](https://pypi.org/project/MarkupSafe/)
* [Markdown](https://pypi.org/project/Markdown/)

## Features
* Site pages
* Blog posts with optional tags
* RSS feeds

## Install

```shell
pip install jssg
```

## Usage

### Initialize the site

```shell
mkdir wwwsite
cd wwwsite
jssg init
```

### Add site configurations

```shell
jssg config -t <Site title> -u <Site url> -a <Site author> -e <Site email>
```
The same configs can be passed when doing `jssg init`

See more config options with `jssg config -h`

### Add a page

```shell
jssg page <Page title>
```

After this you can start writing your page content in the generated Markdown file.

### Add a post

```shell
jssg post <Post title> -t <category tag>
```

After this you can start writing your post content in the generated Markdown file.

### Build the site

```shell
jssg build
```

### Preview the site locally

```shell
jssg serve
```

## License

Copyright (C) 2026 by Joel Torres \<joel@joeltorres.net\>

Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
