Add capability to instantly render whole directories instead of single files only. When detecting an index.rst within the directory, open that file in the Browser.
right now, the preview script can only render a single standalone file. if that file references image in the same directory, they will be broken when viewing the HTML
additionally, it might be possible to allow linking to other documents in the directory
the only problem I see with this is that for the standalone preview to work, we essentially build a simple sphinx project with one file (named index.rst and soft linked to your original file). to create a sphinx project on the fly from a directory with multiple files, we would have to link all the files together using a toctree directive
you could do this by placing an index.rst file in each directory and generating the toctree so that there is an automatic navigation system in place for any ad-hoc collection of files. however, the actual index.rst files would be empty aside from a table of contents
from @amotl:
right now, the preview script can only render a single standalone file. if that file references image in the same directory, they will be broken when viewing the HTML
additionally, it might be possible to allow linking to other documents in the directory
the only problem I see with this is that for the standalone preview to work, we essentially build a simple sphinx project with one file (named
index.rstand soft linked to your original file). to create a sphinx project on the fly from a directory with multiple files, we would have to link all the files together using a toctree directiveyou could do this by placing an
index.rstfile in each directory and generating thetoctreeso that there is an automatic navigation system in place for any ad-hoc collection of files. however, the actualindex.rstfiles would be empty aside from a table of contents