From 16278b09217bead8ad62cfa115885e0f0bc7b3fc Mon Sep 17 00:00:00 2001 From: ClariSys Date: Mon, 7 Apr 2025 23:32:28 -0700 Subject: [PATCH] Update README.md --- README.md | 44 ++++++++++++++++++++++++++++---------------- 1 file changed, 28 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 4f49b39..e93bd01 100644 --- a/README.md +++ b/README.md @@ -1,26 +1,38 @@ # python-webgen -a set of python scripts and html templates to generate blog-style websites +A set of python scripts and html templates to generate blog-style websites. +# Usage ---- -## Getting Started +For built in help, use the `--help` option. -Welcome to your new KitsuDev Repo, ChloeCat! Feel free to make this place your own! +## General Usage: -## Make your first push! -Once you're ready to push your files, use these commands to get to your spot! -```bash -git remote add origin https://kitsunes.dev/ChloeCat/python-webgen.git -git branch -M main -git push -uf origin main -``` +### Basic usage: +`python webgen.py ` +This will use the default location for the template files (`./templates/`) and the css file (`./templates/stylesheet.css`). +This will also set the title to simply "Blog", use `--site_title` to change that. -Once you're all set, please [Make a README](https://www.makeareadme.com/)! +### Example use: +`python webgen.py --site_title "Chloe's Blog" --title_all --css_file ~/css/custom_v2.css ~/Blog/posts/ ~/Blog/output/` ---- -Have fun, and happy coding! +This will generate a site with a title of "Chloe's Blog," which will be applied to the HTML title of all the articles, in addition to the article title. +It will also use a custom CSS file from `~/css/custom_v2.css` which is different from the default. +The posts will come from a folder in the `~/Blog/posts/` folder and the completed HTML files will be placed in `~/Blog/output/`. --- Kio +## Availible Arguments: -(p.s. and while you're at it, say hi to pearl.) +| Argument | Description | +|-----------------|-----------------------------------------------------------------------------------------------------------------------| +|`input_path` |The folder to read the markdown files from. | +|`output_path` |The folder to place the final HTML files in. | +|`--template_path`|The folder where the template HTML snippets are. Default: `./templates/` | +|`--css_file` |The location of a css file to copy to the output folder defined in `output_path`. Default: `./templates/stylesheet.css`| +|`--site_title` |The title shown on the main page. | +|`--title_all` |If enabled, add the main site title to the HTML Title field on the individual articles. | +|`-v` |More output. | + +# TODO +- Add support for image folders +- Handle files correctly :3 +- GUI interface?