gdoc-review
gdoc-review
is a simple script utility that utilizes pandoc
and gdrive
tools to generate a google doc directly from a local asciidoc file.
Prerequisites
- Install Asciidoctor: https://docs.asciidoctor.org/asciidoctor/latest/install/linux-packaging/. On Fedora, run
sudo dnf install -y asciidoctor
. - Install Pandoc: https://pandoc.org/installing.html. On Fedora, run
sudo dnf install pandoc
. - Install
gdrive
: https://github.com/prasmussen/gdrive. If you havego
installed, rungo get github.com/prasmussen/gdrive
to install. - Give permission to
gdrive
to write to your Google Drive cloud folder.
Installing
- Copy the
gdoc-review
script to/usr/local/bin
, and runchmod a+x gdoc-review
to allow the script to be executed from anywhere in the file system.
That's it! The script should now be ready to use.
Getting started
To generate a google doc review of any assembly or module, open a command prompt, and navigate to the folder that contains the asciidoc file. Run the following command, passing in the relative name of the asciidoc file, for example:
$ gdoc-review modules/ztp-cluster-provisioning.adoc
Follow the link to navigate to the generated google doc.
Note: Every run of gdoc-review
generates a new output file, previous output files are not overwritten.