{"id":19163237,"url":"https://github.com/programmer-ke/ssitegen","last_synced_at":"2025-07-05T20:37:59.241Z","repository":{"id":27472851,"uuid":"30952185","full_name":"programmer-ke/ssitegen","owner":"programmer-ke","description":"A simple static site generator","archived":false,"fork":false,"pushed_at":"2017-02-24T12:07:51.000Z","size":89,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-03T21:43:21.578Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/programmer-ke.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-02-18T04:34:05.000Z","updated_at":"2016-02-20T15:06:13.000Z","dependencies_parsed_at":"2022-09-02T07:51:33.618Z","dependency_job_id":null,"html_url":"https://github.com/programmer-ke/ssitegen","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/programmer-ke%2Fssitegen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/programmer-ke%2Fssitegen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/programmer-ke%2Fssitegen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/programmer-ke%2Fssitegen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/programmer-ke","download_url":"https://codeload.github.com/programmer-ke/ssitegen/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240245887,"owners_count":19771029,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-11-09T09:14:36.150Z","updated_at":"2025-02-22T22:42:39.575Z","avatar_url":"https://github.com/programmer-ke.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NAME\nssitegen - generate a static site\n\n# SYNOPSIS\nssitegen [-h] [-i DIRNAME ]\n\n# DESCRIPTION\nssitegen generates a collection of html files that can be used to serve a website from\ninput files written in markdown. It uses an opinionated directory structure\nfor both the input files and the output html files, plus other static assets like\nimages and stylesheets. A website can then be served from the output directory depending\non the preferred method of hosting, for example by pointing a webserver to its location or \nuploading it to some other web hosting service.\n\n## Basic Usage\n\nRunning the command `ssitegen -i mysite` will create a directory named `mysite`, if it\ndoesn't already exist and add the necessary files and directories within it.\n\nInside `mysite`, are the following:\n\n- settings - site specific configuration file\n- static - directory containing static assets like images, JavaScript, css etc\n- templates - directory containing templates for common parts of the html pages\n- content - directory containing the actual blog entry/page as markdown files\n\nChange the following in `settings` according to your preferences:\n\n- blog_title\n- blog_description\n- blog_image (this should be a link to a publicly accessible image stored \n  somewhere on the web e.g. gravatar)\n\nPut something descriptive in your about page: `content/pages/about.md`\n\nThe directory `content/entries` contains your blog entries. Any files that end\nwith `.md` here will be converted to html entries. Use `sample_entry.md.draft` \nas a template for new entries. `first_entry.md` has been provided as an example.\n\nRunning the command `ssitegen` while directly inside the `mysite` created above \nwill create a new directory named `output`. This directory contains all the \nnecessary files needed to serve the website, i.e.\n\n- index.html - the site's landing page\n- static - contains the site's static assets\n- a html file for each blog entry/page\n\n## Development\n\nTrello board: https://trello.com/b/qBxOPk1y/ssitegen\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprogrammer-ke%2Fssitegen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprogrammer-ke%2Fssitegen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprogrammer-ke%2Fssitegen/lists"}