Open emiliom opened 4 months ago
I've tested this. I copied the ohw19
folder from the master
branch to my working branch, then built pages using make live
.
Without any other changes, the only ohw19 page that was built was README.md
! It looks like Sphinx is configured to ignore HTML and related files.
Doing some digging, I learnt about the html_extra_path configuration. When I set it to html_extra_path = ["ohw19"]
(in conf.py
), then ohw19 got built into the root folder, which isn't good (the files overwrote the root index, among other things). After some digging, I moved ohw19
to a subfolder, ohw18-21/ohw19
and set html_extra_path = ["ohw18-21"]
. That did exactly what we want -- to create ohw19 files under a ohw19
folder. Except, the root index file was still overwritten with the ohw19 index page!
@abkfenris can you look into this? I may be stretching my Sphinx chops at this point.
Update: I've submitted a PR, #315, with these changes. Let's continue the discussion there.
@abkfenris and I have discussed the current website infrastructure; see #237 and #249 for past, still-current discussions of the core issues. As a first step to simplifying the current setup and exploring a potential move to ReadTheDocs (#249), we're going to test folding into the current (starting with OHW22) site files the Jekyll-based built files from OHW19 to OHW21 (note: OHW18 files are in a separate repo, https://github.com/oceanhackweek/ohw2018). That'll be an incremental step towards deprecating the release/version-based hosting of github pages built files from OHW19-21.
After copying the OHW19-21 files, I'll test the Sphinx rendering locally and create a PR to test it on the Netlify preview.
Note: we use the master branch as the github pages branch.