Skip to content
Rose Coste edited this page Mar 5, 2015 · 3 revisions

Everything in this repo is an experiment.

In the wiki for this repo, the experiment is to take a bunch of markdown that was building a ReadTheDocs site, move it into a new structure in a local .docx with a bunch more material and rearrange it there until the structure seems reasonable, then use pandoc to turn the .docx back into markdown and then load the markdown into a GitHub wiki and have it look decent. Images and symbols will fail; what else? What happens to the generated TOC and page footers? Do internal cross-reference links survive? We'll see, starting at guide.


Experiment 1

In first attempt at guide, major defects are loss of all tables (whether created in .docx or copied there from original markdown) and lack of left-hand navigation. Section titles have permalinks, so navigation may be possible.


Experiment 2

Added a sidebar with top-level section headings, manually constructed by copy-pasting those permalinks. It works, but it's too tedious to take deep enough into the structure to make the sidebar a useful TOC.