pdf manual on zenodo

[tjhei]

We have uploaded a pdf to zenodo, see https://figshare.com/articles/journal_contribution/ASPECT_Advanced_Solver_for_Problems_in_Earth_s_ConvecTion_User_Manual/4865333 , but our pdf manual is by now probably out of date.

We need to either:
a) make the sphinx doc compilable to a PDF (I tried a long time ago and failed)
b) delete references to the PDF manual (citation page, readme, release)

Thoughts?

[tjhei]

There is also sphinx singlehtml mode, that could be archived.

[tjhei]

sphinx make latexpdf fails due to image formats (svgs) and the resulting .tex document has many, many math formatting errors.

[tjhei]

singlehtml converted to pdf is not too bad:
https://www.math.clemson.edu/~heister/files/ASPECT%202.6.0-pre.pdf

[tjhei]

Any thoughts on this? We need to figure this out for the release.

[gassmoeller]

I would say we use what you posted above (the singlehtml to pdf converted version). We can still try for the next release to get the native pdf support working, but I do not think it has the highest priority. By using readthedocs all of the prior releases are available anyway (e.g. https://aspect-documentation.readthedocs.io/en/v2.4.0/) so that the Zenodo version is purely a way to cite the documentation. I would also be ok with removing all the references to the manual, but it is probably more work that continuing with the singlehtml version.

[tjhei]

Sounds good. I guess we can put a link to the online version inside the zenodo description as well.
The only annoying part is that this pdf is 78MB big.