Go to file
Govindas f4de859172 Finish dropdown in navbar 2022-02-07 14:18:31 +02:00
example Finish dropdown in navbar 2022-02-07 14:18:31 +02:00
gsitegen Finish dropdown in navbar 2022-02-07 14:18:31 +02:00
tests Setup Python project template. 2022-01-25 14:40:35 +00:00
.gitignore Better navbar styling support 2022-02-03 15:34:15 +02:00
README.md Update README.md 2022-01-31 13:03:04 +02:00
setup.py Fix description 2022-01-25 14:47:00 +00:00
tox.ini Setup Python project template. 2022-01-25 14:40:35 +00:00

README.md

Static Site Generator

Generates simple webpages.

How to use

  1. Create a file with .page extension in the same directory as generate.py, the file name will be title of the page, for example: About.page
  2. Use markdown in the created file, it will be auto-converted to HTML. You can also use raw HTML in the file, with > symbol, like this:
**Example**
>
  <p>Hello world</p>
**Back to just markdown**

Line before HTML code must be a single character > and HTML code below must be indented by 2 spaces. You can also use Markdown inside HTML, for example:

<p>**Hello world**<p>

will display as bold.

  1. (Optional) Create a file called navbar and/or footer to have a navigation bar/footer that is added to every generated page file. Example navbar file:
[Home](/)
[About](/about)

It also supports HTML, but HTML code will not be formatted as navigation bar automatically.

  1. (Optional) Add resources folder, its contents will be copied to generated site's folder. You can create subfolders in it that have the same name as a specific .page file, in order to put resources in that page's folder. Note: folder name must be lowercase and spaces must be replaced with - character.

  2. Run generate.py, it will generate output website files in website-output folder.

To-do list

  • Better styling support for navigation bar, footer etc.
  • Delete removed page files from website-output during next site generation (Last, to be done on release, so it doesn't disturb development)