Use recipies from justfile in live website build?

[joelostblom]

A question/comment: would it be beneficial to run our justfile recipies for creating the live website, so that we don't risk that there is drift between how it is created locally and for the live site? I'm not sure how this would look with netlify, but I imagine that the github action could just push the _site dir after building, just like we would if we used github pages? Or is there already some reason for why we are not doing this and have a separate worflow for the website? I understand there can be some differences building locally and for the website, but that might be less of an issue than something going out of sync.

As an example, the quartodoc build has evolved to something like this in e.g. flower:

# Build the Python docstrings as a section in the website using quartodoc
build-quartodoc:
    # To let Quarto know where python is.
    export QUARTO_PYTHON=.venv/bin/python3
    # Delete any previously built files from quartodoc.
    # -f is to not give an error if the files don't exist yet.
    rm -rf docs/reference
    uv run quartodoc build

whereas the website build just runs uv run quartodoc build. Now all that is probably not required, but also not harmful I think. I also don't see build-examples anywhere in the website workflow?

[lwjohnst86]

Yea, I'm currently migrating the workflows away from using reusable workflows to having them fully writing out in the templates. So this repo (at least the reusable workflows) will be archived in the not too distant future.

As for using the justfiles vs the Quarto provided ones, I believe that the Quarto action includes things like handling caching as well as publishing and I don't think there is a 1-to-1 correspondence between local building and what happens in the workflow. In the justfile we don't publish to Netlify as an example of that difference. I'm not opposed to the idea, but I think it's a bit more complicated that it seems.