On 11/30/2010 02:49 AM, John Cremona wrote: > On Mon, Nov 29, 2010 at 11:50 PM, John H Palmieri > <jhpalmier...@gmail.com> wrote: >> On Nov 29, 2:24 pm, Niles <nil...@gmail.com> wrote: >>> On Nov 29, 9:11 am, John Cremona <john.crem...@gmail.com> wrote: >>> >>>> Can anyone tell me how to make just part of the pdf reference manual, >>>> specifically the part from a single .py file? >>> >>> I'd like to know how to do this too, and also how to produce the html >>> version! >> >> This will work for files in the Sage library (although you could add >> them temporarily if they weren't there). This is also kind of >> destructive, so I would suggest working in a clone. But: edit the >> file >> >> SAGE_ROOT/devel/sage/doc/en/reference/index.rst >> >> so that it looks something like >> >> .. toctree:: >> >> sage/matrix/matrix0 >> sage/rings/integer >> sage/graphs/graph_latex >> >> >> Of course, replace sage/matrix/matrix0, etc., with whatever files you >> want. Then run "sage -docbuild reference html" or "sage -docbuild >> reference pdf". You'll probably get lots of warnings, but the docs >> should look okay; they'll be stored in SAGE_ROOT/devel/sage/doc/ >> output/. It will have some extra stuff in it, though: table of >> contents, indices, etc. I don't know a way to get rid of them without >> just selecting a page-range from the pdf file. Oh, you could also >> edit the latex file, SAGE_ROOT/devel/sage/doc/output/latex/en/ >> reference/reference.tex. Delete the stuff you don't want and then try >> running pdflatex on the file. > > Thanks John, I'll try that.
The doc builder builds any DOCUMENT (see 'sage -docbuild -D') whose name ends with 'reference' as if it is a reference manual, so you could do cd SAGE_ROOT/devel/sage/doc/en cp -r reference myreference prune/edit files under myreference/, and run sage -docbuild myreference html -j # -j uses JSMath for math say. To placate 'hg stat' I usually make myreference a symlink to a directory outside the repository. -- To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org
