Make SageTeX support SAGE_SPKG_INSTALL_DOCS

[jasongrout]

See #10823 for details about SAGE_SPKG_INSTALL_DOCS. We should build the docs fresh, which would be a nice test of if they had the necessary components to actually do SageTeX stuff.

CC: @dandrake

Component: packages: standard

Reviewer: Dan Drake

Issue created by migration from https://trac.sagemath.org/ticket/10908

[jasongrout]

comment:1

Also, it might be nice to distribute "tkz-graph.sty" and "tkz-berge.sty" with SageTeX, as the example file depends on it, I believe, and other nice features in Sage also depend on it.

[jasongrout]

comment:4

Replying to @dandrake:

Replying to @jasongrout:

Also, it might be nice to distribute "tkz-graph.sty" and "tkz-berge.sty" with SageTeX, as the example file depends on it, I believe, and other nice features in Sage also depend on it.

That's a good idea, although of course you also need PGF/TikZ. Can we assume that anyone with a reasonable TeX setup has TikZ? Distributing tkz-graph and tkz-berge isn't too useful if lots of people don't even have TikZ.

I think lots of people do have tikz installed, but almost no one has tkz-graph.sty and tkz-berge.sty installed since you have to manually install it. Tikz seems like a pretty standard package on newer tex installs these days.

[jasongrout]

comment:5

Replying to @dandrake:

Another thought: we could just try to build things, and if that doesn't work, just put a small file in the doc directory that points the user to https://bitbucket.org/ddrake/sagetex/downloads and the files there. That doesn't quite solve the problem Jason described at #10823 (being offline) but it does point in the right direction.

That sounds like a good way to do things. Just check the error code after trying to build the docs.

[jasongrout]

comment:7

See #11197 for building docs after Sage is built.

[kcrisman]

comment:14

Just confirming that this makes sense.