Repository navigation
Test folding the OHW19-21 built files into source #314
Description
@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.
Activity
emiliom commentedon May 7, 2024
I've tested this. I copied the
ohw19folder from themasterbranch to my working branch, then built pages usingmake 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"](inconf.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 movedohw19to a subfolder,ohw18-21/ohw19and sethtml_extra_path = ["ohw18-21"]. That did exactly what we want -- to create ohw19 files under aohw19folder.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.