GABRIEL

Your very own markdown angel. Publish google docs to github pages with this simple add-on. Gabriel grabs your document, converts it to markdown, before sprinkling a little metadata (title, author & tags) and committing it to your selected Github Repository.

Designed to make generating a publishing Markdown easier for non-technical or non-confident users and named with a nod to Jekyll & Hyde as it is best used with static Jekyll sites. It’s free, so you can grab the code or install the app from the Google Web Store.

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.

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.

FileFromCopyrightLicense
OAuth2.gsGithub RepoCopyright 2014 Google Inc.
All Rights Reserved.
Apache License, Version 2.0
Markdown.gsGithub RepoCopyright 2013 Google Inc.
All Rights Reserved.
Apache License, Version 2.0
UnderscoreWebsiteCopyright 2009-2015
Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
MIT License
js-yaml.min.gsGithub RepoCopyright (C) 2011-2015 by Vitaly PuzrinMIT License

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

Need Help?

If you are a subscriber, then please email us directly or use the Get Help command under the About menu in any of our web apps to get help with this extension. Otherwise, please feel free to raise an issue on the code repository for this tool (you will need to sign up for a free Github account if you don't already have one). Only subscribers have full access to technical support, but we'll do our best to answer every query if we are able.

© 2015-2018 educ.io. Current site version is 0.1.0a