Stefan Friese 5f42a5d3db | ||
---|---|---|
static | ||
templates | ||
.gitignore | ||
LICENSE | ||
README.md | ||
freezer.py | ||
husk_helpers.py | ||
pyproject.toml | ||
settings.toml | ||
start.sh | ||
start_site.py |
README.md
husk
Builds a website out of a git repository file structure and markdown files
README.md
is your frontpage- The file structure of your git repository is used as a tree strucuture for the website. Build your website through markdown files in your git repository only
- Parses Markdown only, ignores your scripts and code files. Write documentation in your code repository, let husk deal with the rest
- Search your website's files live and without a database
- Builds a TOC of your markdown file as sections of the website for ease of use
Usage
To build a static website do the following steps
- Clone your git repository
- Put its path into
settings.toml
- Run
python3 freezer.py
There will be a directory called build
containing your static website after the script is finished. Copy it to your webserver and enjoy.
Debugging
-
Debug as dynamic website via running
./start.sh
and vistinglocalhost:5000
-
Debug the static website after you did the build via
cd build/
python3 -m http.server