DisBlog

A new way to host blogs on GitHub

DisBlog is a Blog platform powered by GitHub discussions on your repo. You can post things by creating a discussion and it supports markdown formatting.

View a real demo article (Customised Page Layout), View that page's markdown

To get DisBlog, fork the repository then follow the steps below

  1. Enable discussions on that repository
  2. Authorise the Giscus bot
  3. In the forked repository, go to Settings > Secrets and Variables > Actions > Variables and create a new Repository Variable
  4. Name it BLOG_NAME and set its value to the name of your blog
  5. Then create another repository variable called TEMPLATE_GIST_URL and set it to the URL of your template (preferably a gist raw url). You can use our public one (which is basic) or change it. See the guide on changing it
  6. Create a new discussion category for your posts and set it to the announcements type so only you and collaborators you have invited can use it.

    7. [OPTIONAL] Delete the other categories

  7. Go to settings > Pages and enable github pages as deploy from branch > main > / (root folder)
  8. Create a discussion (in markdown format) and go to YOURUSERNAME.github.io/posts/DISCUSSION_NUMBER
  9. Then if you see something there in 5-10 minutes, DisBlog is working! If not, please raise an issue.