Uses python to generate static html files from a single txt or folder of txt files
Project description
Python Static Site Generator (SSG)
Uses python to generate static html files from a single txt or folder of txt files.
Download as a package
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"])
Prerequisites
- Python3
- Python-Markdown
pip install markdown - Pygments
pip install pygments
Features
- Supports stylesheets. Pass the url of the stylesheet to
-sor--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
<!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
- 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
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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ssg-a-rokay-1.0.4.tar.gz.
File metadata
- Download URL: ssg-a-rokay-1.0.4.tar.gz
- Upload date:
- Size: 5.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.8.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e3e8804f69670ea2c28a8ce5619279d57a63a1265b23c4ceca4bd68954eebf5c
|
|
| MD5 |
1d04f65094ea714ebed20625d8b78481
|
|
| BLAKE2b-256 |
4a9a4249ca321d005ca4a5836635546fe686949b365e2fd69fb68d56e20766fc
|
File details
Details for the file ssg_a_rokay-1.0.4-py3-none-any.whl.
File metadata
- Download URL: ssg_a_rokay-1.0.4-py3-none-any.whl
- Upload date:
- Size: 6.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.8.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d19d84edee2a55197ab1e3c6ee7eea865602166344b0e4404ee5c121a64475e6
|
|
| MD5 |
562392510a2b4a20df482e144230354d
|
|
| BLAKE2b-256 |
908f074f9dfe64d9d9a22b38096f07906e0a08407c69ccfe50f80e837ee34796
|
