__//
cf /.__.\
\ \/ /
'__/ \
\- )
\_____/
_____|_|_____
" "
S I L K I E
Static site generator with the smoothness of silk
Silkie is a simple and smooth static site generator. It can parse text files (".txt") and Markdown files (".md") and generate HTML files from them.
Check out the demo generated from this text file (with help from new.css).
$ silkie -h
Usage: silkie [OPTIONS]
Static site generator with the smoothness of silk
Options:
-v, --version Show the version and exit.
-h, --help Show this message and exit.
-i, --input PATH Path to the input file/folder [required]
-s, --stylesheet TEXT URL path to a stylesheet
-l, --lang TEXT Language of the HTML document [en-CA by default]
-c, --config FILE Path to a JSON-formatted configuration file
- Generate HTML file(s) from a specified text file
- Detect the title of a file if it's the first line followed by two blank lines
- Add custom styling to static site
- Change HTML document language (
<html lang="{your-language}">,en-CAby default) - Generate HTML file from a Markdown file (Need Testing)
- Allow user to supply a JSON formatted configuration file
- Parse front matter and apply the corresponding metadata fields (Prototype Feature)
- Check out #21 to see which fields are supported
$ pip install silkie
Check if you already have installed Silkie:
$ silkie -v
You can also run Silkie as a package:
$ python -m silkie -v
$ silkie -i tests/data/text/The Adventure of the Speckled Band.txt
$ silkie -i tests/data/text/Silver Blaze.txt -s https://cdn.jsdelivr.net/npm/@exampledev/new.css@1.1.2/new.min.css
$ silkie -i tests/data/text/Silver Blaze.txt -l fr
$ silkie -c tests/data/config/all_markdown_files.json
Like how you specify the options verbosely for a regular input file, there are keywords can be set in your JSON file: input, lang, and stylesheet
{
"input": "tests/data/text/Lorem Ipsum.txt",
"stylesheet": "https://cdn.jsdelivr.net/npm/@exampledev/new.css@1.1.2/new.min.css",
"lang": "fr"
}Supported keywords:
| Name | Type | Default | Usage |
|---|---|---|---|
slug |
string |
File path | Customize the document URL route, e.g. /docs/example.html |
title |
string |
Markdown title or file name | The text title of the document. Automatically added at the top of your doc if it does not contain any Markdown title. |
description |
string |
The description of your document, which will added to document metadata for search engine optimization. |
Please read the Contribution Guide before developing any changes.