{"id":21595767,"url":"https://github.com/wigging/genja","last_synced_at":"2026-03-11T03:04:20.933Z","repository":{"id":63486482,"uuid":"559718073","full_name":"wigging/genja","owner":"wigging","description":"Static website generator and command line tool built with Python","archived":false,"fork":false,"pushed_at":"2025-10-11T19:04:29.000Z","size":637,"stargazers_count":8,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-19T20:24:50.140Z","etag":null,"topics":["markdown","python","static-site-generator","static-website"],"latest_commit_sha":null,"homepage":"https://genja.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wigging.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"wigging","patreon":"wigging","custom":["https://www.paypal.me/gavinwiggins","https://www.buymeacoffee.com/wigging"]}},"created_at":"2022-10-31T00:04:23.000Z","updated_at":"2025-10-11T19:04:33.000Z","dependencies_parsed_at":"2024-03-02T21:34:06.512Z","dependency_job_id":"936c5c99-5db9-4b04-b657-e4a00203734a","html_url":"https://github.com/wigging/genja","commit_stats":{"total_commits":74,"total_committers":1,"mean_commits":74.0,"dds":0.0,"last_synced_commit":"f11987d7ed6511707522e9acf8da8f5b8f1385fe"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/wigging/genja","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wigging%2Fgenja","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wigging%2Fgenja/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wigging%2Fgenja/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wigging%2Fgenja/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wigging","download_url":"https://codeload.github.com/wigging/genja/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wigging%2Fgenja/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30368662,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T21:41:54.280Z","status":"online","status_checked_at":"2026-03-11T02:00:07.027Z","response_time":84,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["markdown","python","static-site-generator","static-website"],"created_at":"2024-11-24T17:43:52.272Z","updated_at":"2026-03-11T03:04:20.890Z","avatar_url":"https://github.com/wigging.png","language":"Python","funding_links":["https://github.com/sponsors/wigging","https://patreon.com/wigging","https://www.paypal.me/gavinwiggins","https://www.buymeacoffee.com/wigging"],"categories":[],"sub_categories":[],"readme":"# Genja\n\nGenja is a simple static website generator. It is a Python command line tool that generates HTML files and a JSON feed from Markdown content.\n\nInstallation\n------------\n\nInstall uv by following the installation steps at https://docs.astral.sh/uv. After installing uv, use the `uv tool` command to install Genja as a command line tool on your computer:\n\n```bash\nuv tool install genja\n```\n\nCheck the installed version from the command line to make sure installation was successful:\n\n```bash\ngenja --version\n```\n\n## Usage\n\nBefore running Genja, create a project structure as shown below. Markdown files go into the `_pages` and `_posts` directories. The pages directory is for standalone content that is not dated such as an about page or contact page. The posts directory is for dated content such as blog posts or articles. The `_templates` directory contains [Jinja](https://jinja.palletsprojects.com/) templates that are used to render the HTML pages. The `mysite` directory contains the generated website which can be hosted with GitHub Pages or some other web hosting platform. This directory can be named anything but it must be defined in the `genja.toml` configuration file using the `site_output` variable. The `genja.toml` file defines the URLs and directories for the project.\n\n```text\nmyproject/\n├── mysite/\n│   ├── img/\n│   └── styles.css\n├── _pages/\n│   ├── about.md\n│   └── contact.md\n├── _posts/\n│   ├── apple.md\n│   └── orange.md\n├── _templates/\n│   ├── index.html\n│   ├── page.html\n│   └── post.html\n└── genja.toml\n```\n\nThe items in the `genja.toml` file are shown below. The `base_url` is the URL for the homepage of the website. The `posts_output` defines the output directory for the generated posts. The HTML files generated from Genja are located in the `site_output` directory. Static content such as images and CSS files should go in this directory. The title of the website is defined by the `title` key.\n\n```toml\nbase_url = \"https://example.com\"\nposts_output = \"blog\"\nsite_output = \"mysite\"\ntitle = \"My Website\"\n```\n\nUse 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.\n\n```bash\ngenja serve\n```\n\nUse the build command to build the website without running a local server.\n\n```bash\ngenja build\n```\n\n## Examples\n\nSee the examples directory in this repository for projects that can be built with Genja. For more information about each example, see the Examples section in the [Genja documentation](https://genja.readthedocs.io).\n\n## Contributing\n\nSee the [CONTRIBUTING.md](CONTRIBUTING.md) document for information about contributing to this project.\n\n## Support\n\nSupport this project by using the **:heart: Sponsor** button at the top of this page. Thank you :smile:.\n\n## License\n\nThis project is licensed under the terms of the MIT license. See the [LICENSE.md](LICENSE.md) document for the license text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwigging%2Fgenja","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwigging%2Fgenja","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwigging%2Fgenja/lists"}