driveraker

A Google Drive to static site generator via Hugo, Pandoc, and Drive.

View the Project on GitHub

About the Project

A Google Drive to static site generator via Hugo, Pandoc, and Drive. Created for Google Summer of Code 2017 under the supervision of Portland State University. Here is the Google Summer of Code Project Site

About the name

driveraker is styled without capitalization. The name derives from the term muckraker, an insult (or compliment) directed at journalists, I named driveraker such because driveraker aims to integrate Google Drive with a static site generator like Hugo in order to provide a website for a news publication.

You can read the changelog here. And downloads can be found here.

Installation

Requirements:

Installation instructions

WIP

How to use driveraker

Google Document Template

driveraker relies on Google Documents synced to have a specific format for certain aspect of the article processing. Here is an example of a template document for driveraker.

As you can see: tags, categories, publication date, and updated date values are listed at the top of the file with corresponding variables.

driveraker also relies on the Google Document synced to convert the header (title style in Google Drive) into the first Markdown header so it can be made into the article title on the webpage. This logic extends to the subheader (or subtitle style in Google Drive), image caption (or heading 3 style in Google Drive), byline (or heading 1 style in Google Drive), and in-article header (or heading 2 style in Google Drive).

In order to preserve image quality it’s recommended that images are uploaded to Google Drive and then inserted into the article either under the driveraker variables on a new line for an image appearing at the beginning of an article or as a thumbnail, or within the article for an inline image.

The byline of an article is also special since driveraker will parse all the names after “By” with respect to commas/and in order to prepend the names of the authors into the article’s webpage to link to their author pages.