build html and pdf for repo/official releases

[soerenthomsen]

I suggest we try to do this before Julius is back mid November.

If I understand correctly we can deploy locally via GitHub actions as

• html
• pdf

The later would be nice as so far we miss this in the oxygen SOP. At the moment the user can only create a pdf of the single sections on the jupyter book deployment.

[soerenthomsen]

This worked on @isgiddy local machine. We still aim to produce a html and pdf file into the repo!

[soerenthomsen]

@isgiddy do you want to set this also up for the GitHub repo? Would be nice to also have a full pdf build in the repo.

[soerenthomsen]

As discussed yesterday with Julius we will wait with this pdf generation until the community review is done to avoid multiple versions circulating. Only if community members explicitly ask for a full pdf we will create it. @isgiddy i also suggest to remove the outdated pdf from the repo again.

Like this we will ensure that the most recent version is commented on. And people can generate their chapters on the jupiter book.

When we close the community review we will generate pdf etc together with releases and doi's.

So we could include a pdf builder into the action just to test it but disable for now.

[jbusecke]

I dont anticipate a lot of friction to build this (famous last words haha), so I would opt to integrate this closer to the end of the review process. Could you remind me about the proposed date?

[soerenthomsen]

The official community review process will end February 2022 for this SOP but already end of January 2022 for the oxygen SOP. I suggest we start with the Oxygen SOP and do this mid January.

[jbusecke]

Sounds great. If you could ping me here a week earlier, Id be happy to get back on this.

[soerenthomsen]

As we solved this for the oxygen SOP and just need to redo it.