Building latex documentation with sphinx
Hi, Sorry if this is the not appropriate list for yt-docs. I can't find one. While trying to build the latex documentation with sphinx (using a hg check out), I got a lot of warnings like "/home/0/00work/amr/yt/yt-doc-hg/yt-doc/source/cookbook/aligned_cutting_plane.rst:: WARNING: image file not readable: cookbook/_aligned_cutting_plane/aligned_cutting_plane_RedshiftOutput0005_CuttingPlane__Density.png" and make all-pdf in the _build/ directory failed with messages like "!pdfTeX error: pdflatex (file cookbook/_simple_slice/simple_slice_RedshiftOutput0005_Slice_x_Density.png): cannot find image file" How can it be fixed? Regards, ST --
Hi ST,
This is a perfectly fine place to ask about yt-docs.
The yt-doc mercurial repository right now is undergoing quite a bit of
turnover, as I am pushing hard on writing documentation at the moment.
The current workflow is for me to work on docs, work on recipes,
whatever, and then update the cookbook section with auto-generated
recipes pulled from the cookbook repository. I would run these on my
laptop to generate images and output. Because these components are
auto-generated and 'volatile' I had not checked them into the
repository yet.
I've gone ahead and built a PDF of the current yt-doc repository and
placed it here:
http://yt.enzotools.org/yt_manual.pdf
I'll add and commit the appropriate recipe supplemental material when
we've wrapped up writing the docs -- should not be too long -- and
then the repo will be home-buildable. (But we'll also still provide a
PDF. :)
I hope that helps!
-Matt
On Tue, Oct 6, 2009 at 2:47 AM, LUK ShunTim
Hi,
Sorry if this is the not appropriate list for yt-docs. I can't find one.
While trying to build the latex documentation with sphinx (using a hg check out), I got a lot of warnings like
"/home/0/00work/amr/yt/yt-doc-hg/yt-doc/source/cookbook/aligned_cutting_plane.rst:: WARNING: image file not readable: cookbook/_aligned_cutting_plane/aligned_cutting_plane_RedshiftOutput0005_CuttingPlane__Density.png"
and make all-pdf in the _build/ directory failed with messages like
"!pdfTeX error: pdflatex (file cookbook/_simple_slice/simple_slice_RedshiftOutput0005_Slice_x_Density.png): cannot find image file"
How can it be fixed?
Regards, ST --
_______________________________________________ yt-users mailing list yt-users@lists.spacepope.org http://lists.spacepope.org/listinfo.cgi/yt-users-spacepope.org
Matthew Turk wrote: [snipped]
I've gone ahead and built a PDF of the current yt-doc repository and placed it here:
http://yt.enzotools.org/yt_manual.pdf
I'll add and commit the appropriate recipe supplemental material when we've wrapped up writing the docs -- should not be too long -- and then the repo will be home-buildable. (But we'll also still provide a PDF. :)
I hope that helps!
Hi Matt, Yes, very much indeed. Regards, ST --
participants (3)
-
LUK ShunTim
-
lukshuntim@gmail.com
-
Matthew Turk