#13260: Add tutorials and quickstarts from PREP workshops to standard
documentation
---------------------------------------+------------------------------------
Reporter: kcrisman | Owner: mvngu
Type: enhancement | Status: needs_work
Priority: major | Milestone: sage-5.3
Component: documentation | Resolution:
Keywords: | Work issues:
Report Upstream: N/A | Reviewers:
Authors: Karl-Dieter Crisman | Merged in:
Dependencies: | Stopgaps:
---------------------------------------+------------------------------------
Comment (by jhpalmieri):
Replying to [comment:17 kcrisman]:
> Okay, I have heard of this file but don't really understand it. Why
wouldn't I have to do anything for the .rst files, just the images?
Precisely which files have to be in there? Thanks.
MANIFEST.in is [http://docs.python.org/distutils/sourcedist.html#manifest-
template documented here]. The second line of the file is
{{{
recursive-include doc *.rst *.py *.inc
}}}
so all .py and .rst files are included automatically. I'm not sure why we
don't do this for png files; I guess that building the documentation
without the jsMath option can generate lots of png files that we don't
need to include. So anyway, you have to include any png files in there,
with a syntax like
{{{
include doc/en/prep/Quickstarts/Rplot001.png
include doc/en/prep/Quickstarts/heawood-graph-latex.png
recursive-include doc/en/prep/media *
}}}
probably somewhere near the bottom with the rest of the lines related to
the doc directory. (The order doesn't matter, but it's nice if the file is
somewhat organized.) You can test it by running `sage --sdist ...` and
making sure that the appropriate files are included in the Sage spkg.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/13260#comment:18>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en.
