/powershell-github-issue-blogger

Proof of concept on how to use GitHub Issues as storage for static page blog entries updated by a PowerShell script

Primary LanguageHTMLMIT LicenseMIT

GitHub Issue Blogger

Weekend project as a proof of concept on how to use GitHub issues as a blog post "database". It uses the middleman service RSSHub.app. The PowerShell fetches the issues of your public repository and convertes it into template-styled blog posts.

How to get started.

  1. Clone / use the repository as repository.
  2. Check if the feature "Github Pages" is enabled with "/docs" folder option
  3. Make the converter.ps1 file executeable if necessary (e.g. via chmod +x converter.ps1)
  4. Update the first few properties in the converter.ps1 file
  5. Create some issues to get started
  6. Run the script
  7. Visit your published app at https://<user>.github.io/<repo>/

Folder structure

  • templates/ contains all required template files with embedded placeholders
  • docs will be filled populated with the generated files

Sample

Check the issues of this repository, you will see that these are the same as in the rendered demo blog at the repository's GitHub page.

Sample blog screenshot

Contributing

This is just a fancy-minded weekend project proof of concept. That means, no contribution is necessary but appreciated.

Authors

Just me, Tobi.

License

This project is licensed under the MIT License - see the LICENSE file for details. Dependencies or assets maybe licensed differently.

Acknowledgments