Gabriel

Description

Post Google-Docs To GitHub-Pages with Gabriel (The Markdown Angel).

This is a simple Google Apps 'Add-On' which converts a Google Doc to a text based format called Markdown. It adds a little metadata (in YAML format) about the document (e.g. a title, author, categories/tags) and commits it (together with any associated images) to a Github Repository (repo).

It is aimed at users who have a Jekyll blog or static site that is hosted using Github Pages, but who are not especially familiar with the Markdown format, or the technicalities of GitHub 'commits'. Jekyll (see the links below for more information) is a static site generator, transforming Markdown into a fully feature blog or article-driven website. You can host these for free using Github. What Gabriel does is allow you to transform your Google Docs into this Markdown format, and publish in one easy step (and straight from Google Apps).

It's also very useful for Chromebook/Chromebox users who want to be able to draft/save/edit/publish blog posts without locally installed Git tools. For information about how to create a Blog site using Jekyll please have a quick look at the following links, or simply Google for 'creating a jekyll blog on Github'!

http://jmcglone.com/guides/github-pages/
https://github.com/barryclark/jekyll-now
http://joshualande.com/jekyll-github-pages-poole/
http://www.smashingmagazine.com/2014/08/build-blog-jekyll-github-pages/
https://jekyllrb.com/

Gabriel essentially lets you use Google Docs as a simple content authoring system for your blog. Ordinarily, you would author blog posts (in Markdown) on your local computer (then use the Github Command Line Interface or GUI Application to push them to Github) or on the Github website directly (which won't allow you to save your draft whilst working on it). With Gabriel, you can author each post as a document in Google Docs, including tables, links, headers and images. When you're ready to publish it, simply 'save' it to Github and all the technicalities of conversion and publishing are taken care of. If you need to update the post in the future, you can simply make any content change you wish and re-save it, updating the published versions.

It allows for simple permalinks, tagging and titles. You can also submit arbitary YAML if you're doing custom things in Jekyll. All Gabriel related metadata is stored in the DocumentProperties of the document, making it ideal for collaboration (e.g. the settings for each document follow each document, rather than the user).

You can also publish to simultaneous blogs/repos at the same time, making cross-posting much faster and easier.

To use this add-on, you'll need to have a Github account already set up, and ideally your Jekyll-based blog already set up and running (although this is a recommendation, not a requirement). To set up an account, just visit 'https://github.com' and sign up. Once you've done this, the first time you run this add-on, you'll need to authorise it to talk to Github on your behalf. This involves clicking on the link that will appear in the side bar and following the on-screen instructions (Github will ask you to grant 'Gabriel - The Markdown Angel' access to your repositories and to author files within them). If you grant this (which you will need to do for the add-on to work) then you will have to close and re-open the sidebar. Once this is done, you'll be ready to go!

This is open-source software, licensed (apart from contributions, which may be licensed under other permissive licenses) under Apache 2.0. To view full instructions please visit:

https://educ.io/extensions/gabriel

Or to view the source code, and to log any bugs/feature requests/issues, visit:

https://github.com/thiscouldbejd/Gabriel

Thanks!