A Mac sysadmin, documenting useful code, ideas, & guides.

Jekyll Pull Requests

· Read in about 2 min · (398 Words)
jekyll

Outdated: I am no longer using this process nor is the original author that I was linking to. He has an archive of his post here.

Github is awesome. Jekyll is awesome. Travis-ci is awesome. Prose.io is awesome. And now…you can be awesome as well. Open Source is a fantastic but it is not without its drawbacks. One of the biggest drawbacks to using a static website like this site is the lack of an easy way to update posts. Sometimes I make a typo or want to add information to a already created post. Unfortunately, this would require me to use my laptop and only my laptop to modify the markdown files, build the website, and upload the new static files of the website to Github.

With some love and lots of error in trial, I was able to modify this site so that I can create changes from any web browser. Mostly thanks to Saepe. In fact anyone can send an edit to a post, from there a Github pull request is created, I can review the request and if I agree with the change can directly add your change. That is what the

Send edit request button at the bottom of this page does.

Note: Now is a time to state that if you are uncomfortable with the Markdown language you might not understand all the syntax of these posts. Which might make editing the page difficult. If you feel uncomfortable feel free to add a comment below and I can make the change.

How to submit a change

  1. When you see a post you want to edit, click on “Send edit request” button at the bottom of the page. Send edit request

  2. You need a free Github account. If you are a developer you probably have one, so just login. If not, you can create one in a breeze.

  3. Once logged in you will need to give Prose permission to use your Github credentials.

  4. After login you will land on a page like below. Edit the text. Then click Save once your done.

  5. You will see what you have changed, and you can add a commit message or leave the default message. Then click “Submit Change Request”.

Done!

How does it work?

Honestly I am using Saepe’s method completely so I will direct you to here.


Articles:
Issue #1,
Jekyll Pull Requests,
Martin Fenner

Comments