GABRIEL

Gabriel 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 is a static site generator, transforming Markdown into a fully featured blog or article-driven website. You can host these for free using Github. What this add-on does is allow you to transform your Google Docs into this Markdown format, and publish in one easy step; all directly from Google Apps.

• Creating and Hosting a Personal Site on GitHub
• Template Github Pages / Jekyll Blog
• Create a Beautiful and Minimal Blog Using Jekyll, Github Pages, and Poole
• Build A Blog With Jekyll And GitHub Pages

We help you use Google Docs as a 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 doesn’t allow you to save a draft while 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, just make your content changes and re-save it, which will update 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 simultaneous publish to multiple blogs/repos at the same time, making cross-posting much faster.

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). 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 sidebar and following the on-screen instructions (Github will ask you to grant ‘Gabriel - The Markdown Angel’ access to your repositories and 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!

The code is fully open-source but does contain code (many thanks!) from the projects below (any alterations or modifications are marked in the code). Everything else is copyright JD, 2015-2017. This software is licensed under the Apache License, Version 2.0 (the “License”); you may not use this software except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

The logo incorporates the Markdown Mark which is licensed under the Creative Commons License (CC0 UNIVERSAL PUBLIC DOMAIN DEDICATION LICENSE).