Open jnywong opened 7 months ago
Exploratory work
_config.yml
– does not contain any custom content from the original conf.py
and there are currently a lot of warnings
- How do we implement the top navigation bar pointing to the Infrastructure guide, Support and social links?
Ah! I think this is achieved by using https://github.com/2i2c-org/sphinx-2i2c-theme
Ah! I think this is achieved by using https://github.com/2i2c-org/sphinx-2i2c-theme
Correct :-)
If it's helpful, I'm happy to do a quick runthrough of the tech with you this week. Lemme know if that could save you some exploration time. Alternatively, if there is information you'd find useful that I could record in a write-up or a short video, let me know and I can do that asynchronously and share
@choldgraf I made a fair amount of progress today and getting to grips with the tech! Thank you for the offer, I'll make sure to let you know if I come up against anything, but so far so good.
(I especially enjoy your breadcrumbs of knowledge spread throughout the internet, e.g. https://chrisholdgraf.com/blog/2022/sphinx-custom-crossrefs/) 😆
hah glad you found that useful :-) I miss writing blog posts like that!
One word of advice: don't get too creative with Sphinx, because if we want to transition things to mystmd.org at some point, we don't want to have too much Sphinx-specific logic. I know that I've already built a bunch of sphinx-specific logic into the websites already and I regret it because it makes the sites harder to understand and maintain!
I had a great chat with @agoose77, who provided a lot of clarity around some small questions that I had. The main outcome of the conversation is captured in #212.
Exploratory work
custom.js
file in commit https://github.com/2i2c-org/docs/pull/209/commits/815b00f458deab557776538e9f944c401f76e123 🥳 Exploratory work
jupyter-book build --builder linkchecker
and fixed all of the errors by either fixing the stale link "upstream" in our Google Drive https://github.com/2i2c-org/meta/issues/941 or amending out-of-date content. My next step is to upstream this to our 2i2c-org .github/workflows
and incorporate this into the CI/CDconf.py
into the scripts
folder and these will be run during CI/CD pre-build phase. I tried executing this code in Jupyter Notebooks at first within the jupyter build
command (à la the Jupyter Book docs), but the CSV file generated for the feature table was not detected by the rest of the build process, so the csv-table
in about/distributions/index.md
failed..readthedocs.yml
to generate a preview using jupyter-book build
rather than sphinx-build
👍