Tracker: ocular gatsby v1.0

[ibgreen]

Punch List for completing the port of ocular into a gatsby based static website generator for Uber front-end frameworks.

v1.0 INITIAL OCULAR GATSBY VERSION

• Better docs
• Better error handling (image query errors etc)

For: luma.gl, vis.gl and minor frameworks.

• TOC generation: Async issue (missing pages) (P0, @ibgreen)
• Make relative links work (P0, @jckr)
• Basic Markdown Styling (P0, @jckr)
  • code
  • tables
  • bullets
• Table of Contents: Fix expand/collapse behavior P1 (@jckr)
• Implement gatsby "layout" solution to keep common components loaded (e.g. keep TOC scroll state fixed when switching pages) P0 (@ibgreen)
• Implement example loading and example index generation
• Implement markdown processing and table of contents generation
• Support import/export in gatsby-node (@ibgreen)
• Redefine ocular as a preset config and page processing/generation package for Gatsby (@ibgreen)

[jckr]

with #101 closed we have finished the work for v1.0.
I don't know how fast #100 can be resolved as I'm not super well-versed in webpack. Also this doesn't look like it's blocking.
So, going forward I will focus on:
#109 - using the same approach as for the links. Right now, markdown is turned into HTML then href attributes of links are overridden so they resolve. Using the same process we can replace tokens that refer to an embeddable component. This approach is similar to what was used in legacy Ocular.
#110 - styling through styled components. Once this is done this will make working with ocular and troubleshooting much easier.