GitPub is a GitHub Action and PowerShell Module that helps Easily Automate Publishing from GitHub.
GitPub gives you a flexible framework for converting content (primarily from GitHub) into published content.
For example, you can turn GitHub issues that match a certain label into Jeykll posts within a GitHub Page.
You might be reading output from GitPub that way right now. This post started as this GitHub issue.
Publishing this way makes for a more virtuous cycle when working with GitHub.
If you write high quality issues or release notes, you can share them with the world without breaking a sweat.
You can use GitPub as a GitHub Action or as a PowerShell Module.
You can install GitPub from the PowerShell Gallery, or download a release from github:
Install-Module GitPub -Scope CurrentUser -Force
Import-Module GitPub -Force -PassThru
GitPub works using the simple concepts of Sources and Publishers.
Sources can provide content to publish.
GitPub is written so that you can write your own sources easily.
Any function that adds [Reflection.AssemblyMetadata('GitPub.Source','true')]
will be considered a source.
GitPub ships with the following sources:
Name |
---|
Get-GitPubGist |
Get-GitPubIssue |
Get-GitPubRelease |
Any function that adds [Reflection.AssemblyMetadata('GitPub.Publisher','true')]
will be considered a publisher.
Name |
---|
Publish-GitPubJekyll |