Uses python to generate static html files from a single txt or folder of txt files.
Simply run pip install ssg-a-rokay
then import into your project like so:
from ssg import ssg
ssg.main(["-i", "Sherlock Holmes Selected Stories"])
- Python3
- Python-Markdown
pip install markdown
- Pygments
pip install pygments
- 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
Custom title
This is a short paragraph.
This is a longer example
of a paragraph.
Becomes:
<!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>
- Passing a single text file:
ssg.py -i text.txt
- Passing a folder. Only txt files will be parsed:
ssg.py -i folder
- Passing a folder and providing a stylesheet:
ssg.py -i folder -s https://example.com/with/css.css
- Passing a language:
ssg.py -i folder -l pt-BR
- Passing a Config file:
ssg.py -c example.json
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
Displays a list of arguments and what they do (above).
Displays the program name and version.
Required argument. Used to provide an input folder or file. Only txt files will be parsed in folders. See usage #1 and #2.
Optional argument. Pass a url to a stylesheet. See usage #3.
Optional argument. Pass a language to root html tag. See usage #4.
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.
Before contributing, please review CONTRIBUTING.md