Prettify Cycamore docs

[bennibbelink]

Makes essentially the same changes as cyclus/cyclus#1787

zip for preview
html.zip

[github-actions]

Build Status Report - 390f3bc - 2024-09-21 10:02:24 -0400

Build FROM cyclus_20.04_apt/cyclus:latest

• Cycamore: Success ✅
• Cymetric: Success ✅

Build FROM cyclus_20.04_apt/cyclus:stable

• Cycamore: Failure ❌
• Cymetric: Skipped due to upstream failure ⚠️

Build FROM cyclus_20.04_conda/cyclus:latest

• Cycamore: Success ✅
• Cymetric: Success ✅

Build FROM cyclus_20.04_conda/cyclus:stable

• Cycamore: Failure ❌
• Cymetric: Skipped due to upstream failure ⚠️

Build FROM cyclus_22.04_apt/cyclus:latest

• Cycamore: Success ✅
• Cymetric: Success ✅

Build FROM cyclus_22.04_apt/cyclus:stable

• Cycamore: Failure ❌
• Cymetric: Skipped due to upstream failure ⚠️

Build FROM cyclus_22.04_conda/cyclus:latest

• Cycamore: Success ✅
• Cymetric: Success ✅

Build FROM cyclus_22.04_conda/cyclus:stable

• Cycamore: Failure ❌
• Cymetric: Skipped due to upstream failure ⚠️

[gonuke]

LGTM - just one question about reusing the stylesheet from cyclus

[gonuke]

Can we get this from cyclus rather than including it again?

[bennibbelink]

We could modify the cyclus build to install the stylesheet somewhere in ${INSTALL_DIR}/share/cyclus (perhaps we add a doc/ subdirectory). I'm not sure how else to get it from cyclus, what do you think?

[gonuke]

Does it make sense to do the same with the logo?

[gonuke]

I'm happy to merge this now and wait for style sheet cross-repo fixes...

[gonuke]

Thanks @bennibbelink

[bennibbelink]

Something odd is happening... the new style changes (for cyclus) are present in the artifact generated by cyclus.github.com actions but I'm not seeing them in the published site. The docs were present before adding them back into the build so I'm wondering if there's another server somewhere?

[bennibbelink]

Aha! The cyclus repo has Pages set up to serve the docs. Is it okay if I turn this (and the cycamore one) off? That way the docs will be accessible from just the cyclus.github.com site

[gonuke]

Just to make sure I understand... it seems that https://fuelcycle.org/cyclus/api/ is resolving to be the pages that are produced by GitHub at cyclus/cyclus on the gh-pages branch?

And that is blocking the ability to simply serve docs from the website file structure....

I think it's probably OK to turn of pages since the same URL will serve the new information and we never had a mechanism to automate the update of the go-pages.

The other alternative would be something that guarantees that the gh-pages are updated with every merged PR and/or release.

[bennibbelink]

it seems that https://fuelcycle.org/cyclus/api/ is resolving to be the pages that are produced by GitHub at cyclus/cyclus on the gh-pages branch?

And that is blocking the ability to simply serve docs from the website file structure....

Yes, this is my understanding.

The other alternative would be something that guarantees that the gh-pages are updated with every merged PR and/or release.

That is also an option. It would require that we maintain actions in cylus and cycamore to do this. I think I would lean toward managing all of the site content in one place (cyclus.github.com's Dockerfile) for the sake of transparency. Having subpaths of a website served from separate repositories doesn't feel very intuitive, and is part of the reason it took me so long to understand where those docs were being produced.

[bennibbelink]

Also I went ahead and changed this to find the stylesheet/gif at the location installed by cyclus.