Rename examples directories and update readme

Author: wigging

CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to the genja project are documented in this file. The format of this changelog is based on [Keep a Changelog](https://keepachangelog.com). This project adheres to [Calendar Versioning](https://calver.org) based on `YY.MM.MICRO`.
 
+## Genja v24.10
+
+#### Added
+
+- Require Python version 3.12 or higher
+- Improve the `genja clean` command to remove all generated files
+- Add `template_dir` in config file
+- Put examples into subdirectories
+
+#### Changed
+
+- Use TOML instead of JSON for config file
+- Change `input_dir` to `markdown_dir` in config file
+
 ## Genja v24.3
 
 #### Added

README.md

@@ -1,74 +1,61 @@
 # Genja
 
-Genja is a simple static site generator for GitHub Pages. It is a command line tool built in Python that generates HTML files and a JSON feed from Markdown content.
+Genja is a simple static website generator. It is a command line tool built in Python that generates HTML files and a JSON feed from Markdown content.
 
 ## Installation
 
-Download and install Python from [python.org](https://www.python.org) or from [Anaconda](https://www.anaconda.com). Next, install genja from [PyPI](https://pypi.org) using the following command:
+Download and install Python from [python.org](https://www.python.org) or from [Anaconda](https://www.anaconda.com). Next, install Genja from [PyPI](https://pypi.org) using the following command:
 
-```
+```text
 pip install genja
 ```
 
 Check the installed version from the command line:
 
-```
+```text
 genja --version
 ```
 
 ## Usage
 
-Before running genja, create a project structure as shown below. The `content` directory contains Markdown files that are used to generate HTML files. The `templates` directory contains [Jinja](https://jinja.palletsprojects.com/) templates that are used to render the HTML pages. The `docs` directory contains the built website which can be hosted with GitHub Pages. Lastly, the `config.json` defines the URLs and directories for the project.
+Before running Genja, create a project structure as shown below. The `content` directory contains Markdown files that are used to generate HTML files. The `templates` directory contains [Jinja2](https://jinja.palletsprojects.com/) templates that are used to render the HTML pages. The `docs` directory contains the generated website which can be hosted with GitHub Pages. Lastly, the `config.toml` defines the base URL and directories for the project.
 
-```
+```text
 mywebsite/
 |- content/
 |- templates/
 |- docs/
-|- config.json
+|- config.toml
 ```
 
-The items in the `config.json` are shown below. The `base_url` is the URL for the homepage of the website. Markdown files that are parsed by genja are located in the `input_dir` directory. The HTML files generated from genja are located in the `output_dir` directory. Static content such as images and CSS files should go in the output directory.
+The items in the `config.toml` are shown below. The `base_url` is the URL for the homepage of the website. Markdown files that are parsed by Genja are located in the `markdown_dir` directory. The Jinja2 templates used by Genja are located in the `template_dir` directory. The HTML files generated from Genja are located in the `output_dir` directory. Static content such as images and CSS files should go in the output directory.
 
-```json
-{
-    "base_url": "https://example.com/mywebsite",
-    "input_dir": "content",
-    "output_dir": "docs"
-}
+```toml
+base_url = "https://example.com/mywebsite"
+markdown_dir = "content"
+template_dir = "templates"
+output_dir = "docs"
 ```
 
 Use the serve command to build the website and start a local server. This will automatically open the default web browser to view the website. The website will automatically reload when changes are saved to the Markdown files.
 
-```
+```text
 genja serve
 ```
 
 Use the build command to build the website without running a local server.
 
-```
+```text
 genja build
 ```
 
-## Example
-
-To run the example, go to the `example` directory in this repository. The `mdcontent` folder is the input directory containing the Mardkown files. The `website` folder is the output directory containing the built HTML files. Use the commands shown below to build the website and run a local server to view the website in the default web browser. The website will automatically reload in the web browser when changes are saved to the Markdown files.
-
-```
-cd example
-genja serve
-```
-
-Use the commands shown below to build the example website without starting a local server.
+## Examples
 
-```
-cd example
-genja build
-```
+See the `examples` directory in this repository for two example projects that can be built with Genja. The `directory-website` example uses the `website` directory for the generated output. The `toplevel-output` example uses the top-level of the project for the generated output.
 
 ## Contributing
 
-Clone this repository and use the conda environment file to create a Python environment for developing genja. This environment uses [ruff](https://docs.astral.sh/ruff/) for linting and formatting along with [pytest](https://docs.pytest.org) for running tests. Genja is installed in editable mode within the environment.
+Clone this repository and use the conda environment file to create a Python environment for developing Genja. This environment uses [ruff](https://docs.astral.sh/ruff/) for linting and formatting along with [pytest](https://docs.pytest.org) for running tests. Genja is installed in editable mode within the environment.
 
 ```bash
 # Clone this project