Metadata-Version: 2.1
Name: ssg-a-rokay
Version: 1.0.3
Summary: Uses python to generate static html files from a single txt or folder of txt files
Home-page: https://github.com/a-rokay/static-site-generator
Author: Ahmad Rokay
Author-email: arokay@myseneca.ca
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/a-rokay/static-site-generator/issues
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# Python Static Site Generator (SSG)
Uses python to generate static **html** files from a single **txt** or folder of **txt** files. 

# Prerequisites
* Python3
* Python-Markdown `pip install markdown`
* Pygments `pip install pygments`

# Features
* Supports stylesheets. Pass the url of the stylesheet to ```-s``` or ```--stylesheet``` (See usage).
* Supports titles. If the first line is followed by two blank lines, it will be encased in an ```<h1>``` tag and set in ```<head>```.
* A blank line in the input file constitutes the end of a paragraph.
* Full Markdown support

# Example

###### example.txt
```
Custom title


This is a short paragraph.

This is a longer example
of a paragraph.
```

Becomes:

###### ./dist/example.html
```html
<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>Custom title</title>
    <meta name="viewport" content="width=device-width, initial-scale=1">
</head>
<body>
<h1>Custom title</h1>


<p>This is a short paragraph.</p>

<p>This is a longer example
of a paragraph.</p>
</body>
</html>
```

# Usage
1. Passing a single text file:
```
ssg.py -i text.txt
```
2. Passing a folder. Only **txt** files will be parsed:
```
ssg.py -i folder
```
3. Passing a folder *and* providing a stylesheet:
```
ssg.py -i folder -s https://example.com/with/css.css
```
4. Passing a language:
```
ssg.py -i folder -l pt-BR
```
5. Passing a Config file:
```
ssg.py -c example.json
```

# Help
```
usage: ssg.py [-h] [-v] -i INPUT [-s STYLESHEET]

Static site generator

optional arguments:
  -h, --help                                Show this help message and exit
  -v, --version                             Show program's version number and exit
  -i INPUT, --input INPUT                   Pass a file or folder of files
  -s STYLESHEET, --stylesheet STYLESHEET    URL to a stylesheet
  -l LANG, --lang LANG                      Language to be set in root html tag
```

##### --help/-h
Displays a list of arguments and what they do (above).

##### --version/-v
Displays the program name and version.

##### --input/-i
Required argument. Used to provide an input folder or file. Only **txt** files will be parsed in folders. See usage #1 and #2.

##### --stylesheet/-s
Optional argument. Pass a url to a stylesheet. See usage #3.

##### --lang/-l
Optional argument. Pass a language to root html tag. See usage #4.

#### --config/-c
Optional argument. Pass a configuration JSON file that contains commands. This would allow for users to simplify the command line to a simple -c command.

# Contributing
Before contributing, please review [CONTRIBUTING.md](CONTRIBUTING.md)


