#14090: Thematic tutorials: using the notebook, programming python,
comprehensions
-----------------------------------------------------------------------------+
Reporter: nthiery |
Owner: mvngu
Type: enhancement |
Status: needs_review
Priority: major |
Milestone: sage-5.7
Component: documentation |
Resolution:
Keywords: thematic tutorials |
Work issues:
Report Upstream: N/A |
Reviewers: Samuel Lelièvre, Sébastien Labbé
Authors: Franco Saliola, Florent Hivert, Nicolas M. Thiéry, et al. |
Merged in:
Dependencies: |
Stopgaps:
-----------------------------------------------------------------------------+
Comment (by nthiery):
Hi Sébastien!
Replying to [comment:10 slabbe]:
> I get the following 16 warning when building the html:
{{{
/Users/slabbe/Applications/sage-5.7.beta4/devel/sage/doc/en/thematic_tutorials
/tutorial-programm
ing-python.rst:390: WARNING: Literal block expected; none found.
/Users/slabbe/Applications/sage-5.7.beta4/devel/sage/doc/en/thematic_tutorials
/tutorial-programm
ing-python.rst:788: WARNING: image file not readable: media/graph0.png
}}}
Thanks! This is fixed in the updated patch. I also fixed the missing
links to sandpile tutorial (and some others as well!) and the section
tree for the programming Python tutorial, where I did some further
minor improvements.
{{{
/Users/slabbe/Applications/sage-5.7.beta4/devel/sage/doc/en/thematic_tutorials/index.rst:52:
WAR
NING: undefined label: sage.rings.padics.tutorial (if the link has no
caption the label must pre
cede a section header)
/Users/slabbe/Applications/sage-5.7.beta4/devel/sage/doc/en/thematic_tutorials/index.rst:60:
WAR
NING: undefined label: sage.combinat.tutorial (if the link has no caption
the label must precede
a section header)
/Users/slabbe/Applications/sage-5.7.beta4/devel/sage/doc/en/thematic_tutorials/index.rst:88:
WAR
NING: undefined label: sage.categories.primer (if the link has no caption
the label must precede
a section header)
/Users/slabbe/Applications/sage-5.7.beta4/devel/sage/doc/en/thematic_tutorials/index.rst:89:
WAR
NING: undefined label: sage.categories.tutorial (if the link has no
caption the label must prece
de a section header)
writing additional files... genindex search
copying images... [ 2%] media/sandpile/btw.png
}}}
Yes. That's what #14091 is about (links to the reference manual). My
opinion is that we should ignore them, especially since this should be
fixed shortly by #6495.
{{{
checking consistency...
/Users/slabbe/Applications/sage-5.7.beta4/devel/sage/doc/en/thematic_tutorials/functional_programming.rst::
WARNING: document isn't included in any toctree
...
/Users/slabbe/Applications/sage-5.7.beta4/devel/sage/doc/en/thematic_tutorials
/tutorial-programming-python.rst:: WARNING: document isn't included in any
toctree
}}}
Yes, I am not sure how to handle this. The toctree approach is not
well suited here since we want the index to include a mix of
references to local files and external files. I lamely silenced those
warnings by adding a separate "toctree.rst" document which is just
referenced from index.rst.
What do you think?
Cheers,
Nicolas
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/14090#comment:11>
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 unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.
