|
|
||
|---|---|---|
| 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.mdis 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.shand vistinglocalhost:5000 -
Debug the static website after you did the build via
cd build/
python3 -m http.server