A micropub publishing endpoint for Project Helix
None. This is a service.
Micropub is an API for creating posts on Websites. It is supported by a number of clients, most notably IA Writer.
helix-micropub-endpoint
is a Micropub endpoint for GitHub that works great with Helix Pages. If you quickly need to post something from a desktop or mobile client without using the GitHub online editor, you might want to give it a try.
The base URL https://adobeioruntime.net/api/v1/web/trieloff/helix-micropub/publish@v1/<owner>/<repo>/<ref>
includes your GitHub username, repository and the branch where you want posts to show up. Typically that would be master
.
Try the service here:
curl https://adobeioruntime.net/api/v1/web/trieloff/helix-micropub/publish@v1/<owner>/<repo>/<ref>
- Open IA Writer
- Go to Settings and Accounts
- Click the plus button and select Micropub
- Select "Enter Token Manually"
- Paste the URL from above.
- Paste a GitHub developer token that has access to the
repo
anduser
scope (it will commit in your name)
- You are ready to post.
Deploying Helix MicroPub Endpoint requires the wsk
command line client, authenticated to a namespace of your choice. For this project, I am using the trieloff
namespace.
All commits to master that pass the testing will be deployed automatically. All commits to branches that will pass the testing will get commited as /helix-micropub/publish@ci<num>
and tagged with the CI build number.