Reorganize Resources, top menu, and ohw23 & ohw22 menus

emiliom commented 1 year ago

Substantial reorganization of pages and menus.

Resources is now found in the top bar menu
OHW22 was removed from the top bar menu
Some content previously under the resources folder was moved and duplicated to both ohw23 and ohw22: the logistics and projects folders
Copied tutorials and tutorials-index folders from ohw22 to ohw23. So, right now ohw23 tutorials is a stub, pointing to ohw22 tutorials
Created stub ohw23 schedule page. Currently it's just a copy of the old ohw22 page

A bunch of event-specific content will need to be updated. Let's at least add warnings (admonitions) where they're found, while we do the updates.

@abkfenris :

The ohw22 menu is now broken. I tried different things and couldn't get it to work. Could you look into it?
I haven't figured out how you link the ohw-tutorials repo into the tutorials folder. So, that part will be broken for ohw23

This PR is definitely not intended to be merged as is. Let's use it to discuss the reorganization and suggest changes large or small.

netlify[bot] commented 1 year ago

Deploy Preview for oceanhackweek-preview ready!

Name	Link
Latest commit	e8cb1543f4f2fee218f0f954961b37bb22adf9b8
Latest deploy log	https://app.netlify.com/sites/oceanhackweek-preview/deploys/64c29e55e05e710008d824f9
Deploy Preview	https://deploy-preview-261--oceanhackweek-preview.netlify.app
Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

emiliom commented 1 year ago

Once we've merged this PR, we can tackle PR #260

abkfenris commented 1 year ago

For the OHW22 nav, I think that Sphinx only wants to render toctrees that are part of the global toctree hiearchy, so adding the OHW22 index explicitly to another tree should do it.

# on about/pasthackweeks.md ?

```{toctree}
:maxdepth: 1

../ohw22/index.md



- https://sphinx-doc-zh.readthedocs.io/en/latest/markup/toctree.html
- https://sphinx-doc-zh.readthedocs.io/en/latest/config.html#confval-master_doc

The tutorials are linked via a git submodule which is defined [here](https://github.com/oceanhackweek/oceanhackweek.github.io/blob/source/.gitmodules), but there is an incantation for adding them that I don't remember at the moment, but [here is the PR](https://github.com/oceanhackweek/oceanhackweek.github.io/pull/199/files) when I set things up that way.

There are a whole bunch of other errors that I think correspond to changed pages that are probably worth going through.

emiliom commented 1 year ago

Thanks @abkfenris ! I've pushed several commits that:

Added ohw22/index.md to the pasthackweeks.md toctree. That fixed the ohw22 section menu issue!
Did a bunch of other fixes to ensure toctrees are being generated as expected for ohw22 and ohw23
Removed logistics and projects folders from resources, now that they've been moved to the event folders
Moved tutorials/getting_started.md from resources to the individual event folders, renamed as tutorials_getting_started.md

The "tutorials-index" git submodule stuff for ohw23 is still pending. @abkfenris I'll let you take care of that.

How do things look now? FYI Old content is still largely not updated, with minor exceptions. I also for the most part haven't added any new warnings ("admonitions") about old content in individual pages. Once the page organization stabilizes and this PR is merged, maybe @alisonpchase and @btupper can tackle that?

emiliom commented 1 year ago

I've moved the general project content to resources/projects.md, and the event-specific project content to ohw23/projects/index.md and ohw22/projects/index.md. Those two event pages now use an include block to load resources/projects.md. The general project page is also available from the Resources menu.
Let's leave the logistics pages in the event directories for now, duplication and all

There are still some errors that could be fixed w/o too much trouble. Maybe later!

emiliom commented 1 year ago

Added prominent admonition in OHW23 front page about some ohw23 content being currently old
Purged links to ohw22 tutorials, and left in place only the getting started page for now, until ohw23 tutorials land

emiliom commented 1 year ago

The ohw23 tutorials submodule linkage will be done later, in a separate PR. See #263

oceanhackweek / oceanhackweek.github.io