{"id":13620301,"url":"https://github.com/symkat/MarkdownSite","last_synced_at":"2025-04-14T19:31:47.278Z","repository":{"id":42223214,"uuid":"458574410","full_name":"symkat/MarkdownSite","owner":"symkat","description":"Create a website from a git repository in one click","archived":false,"fork":false,"pushed_at":"2022-12-10T06:58:28.000Z","size":1440,"stargazers_count":407,"open_issues_count":0,"forks_count":17,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-08T06:41:31.510Z","etag":null,"topics":["hosting","infrastructure","markdown","static-site","website"],"latest_commit_sha":null,"homepage":"https://markdownsite.com","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/symkat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":"FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"symkat"}},"created_at":"2022-02-12T16:20:19.000Z","updated_at":"2024-08-31T06:37:57.000Z","dependencies_parsed_at":"2023-01-26T00:01:47.934Z","dependency_job_id":null,"html_url":"https://github.com/symkat/MarkdownSite","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/symkat%2FMarkdownSite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/symkat%2FMarkdownSite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/symkat%2FMarkdownSite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/symkat%2FMarkdownSite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/symkat","download_url":"https://codeload.github.com/symkat/MarkdownSite/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248945949,"owners_count":21187414,"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":["hosting","infrastructure","markdown","static-site","website"],"created_at":"2024-08-01T21:00:54.297Z","updated_at":"2025-04-14T19:31:42.270Z","avatar_url":"https://github.com/symkat.png","language":"CSS","funding_links":["https://github.com/sponsors/symkat"],"categories":["CSS"],"sub_categories":[],"readme":"# No Longer Maintained\n\nPlease note, this code base is no longer maintained.  For the successor, please see [MyJekyllBlog](https://github.com/symkat/MyJekyllBlog)\n\n## What Is MarkdownSite?\n\nMarkdownSite is a platform for hosting websites.\n\nPeople who want their websites hosted enter a git url for their repository.\n\nMarkdownSite downloads their repo and turns anything in `public/` into a static website hosted at a random subdomain.\n\nAnything MarkdownSite finds in `site/` that is an `.md` file will be rendered as HTML.\n\nOnce MarkdownSite downloads and builds the website, it is sent to one or more webservers and accepts traffic from the Internet.\n\n## How do I use MarkdownSite?\n\nYou can use [MarkdownSite](https://markdownsite.com/) to host a website.\n\nYou can build your own version of MarkdownSite to host as many websites as you want on your own infrastructure.  See the `devops/` directory for instructions on getting an instance running.\n\n## What are the directories here?\n\n(**NOTE**: MarkdownSite is getting a panel with user accounts! It's being developed right now, so if you want to install MarkdownSite you should use commit e927f46a7d2949c87d2da3182c722486cfe3c4fb, or wait until the the panel development is complete)\n\n**CGI** contains the Markdown::CGI program.  This renders markdown files to HTML, and is installed on the webservers.\n\n**Manager-DB** contains the markdownsite database schema, and the code for MarkdownSite::Manager::DB, a DBIx::Class interface to the database.\n\n**Manager** is MarkdownSite::Manager, a mojolicious-based webapp for submitting the repository and viewing build status.  This contains a Minion worker that handles building and deploying the websites.\n\n**devops/setup** contains an ansible code base to install servers by their server type, and documentation explaining it.\n\n**devops/config** contains an ansible code base that can be maintained and extended -- it is configuration management for an active MarkdownSite instance.\n\n**devops/** contains additional graphs and network diagrams,\n\n## Visual View Of MarkdownSite\n\nThis is a birds-eye view of a three-node setup, without insight server.\n\n```mermaid\nflowchart TB\n    subgraph one[Panel Node]\n    a1[PostgresSQL]\n    a2[MarkdownSite::Manager Daemon]\n    a3[Nginx]\n    a1 \u003c-- MarkdownSite::Manager::DB / Minion--\u003e a2\n    a3 -- Hypnotoad PSGI --\u003e a2\n\n    end\n    subgraph two[Build Node]\n    b1[Clone \u0026 Build Website]\n    b2[MarkdownSite::Manager Worker]\n    b2 \u003c-- PSQL Private IP --\u003e a1\n    end\n    subgraph three[WebServer Node]\n    c1[Lighttpd]\n    c2[Static Files]\n    c3[MarkdownSite::CGI]\n    c1 \u003c-- Static File Exists --\u003e c2\n    c1 \u003c-- No File Exists--\u003e c3\n    c3 -- Generate \u0026 Store HTML Page From Markdown--\u003e c2  \n    end\n\n    b1 -- Ansible SSH--\u003e three\n    q[Internet User] \u003c-- View Hosted Website --\u003ec1\n    z[MarkdownSite User] \u003c-- Submit Git Repo For Hosting --\u003ea3\n```\n\nMarkdownSite has an additional server, insight, that does metrics and graphs with Graphite, Grafana, and Collectd.\n\n![Grafana Graphs](https://markdownsite.com/img/grafana-graphs.png)\n\n## Thanks For Looking!\n\nThank you for taking the time to checkout this repository.  I hope the information here has been useful.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsymkat%2FMarkdownSite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsymkat%2FMarkdownSite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsymkat%2FMarkdownSite/lists"}