Opened 11 years ago
Last modified 11 years ago
#8786 closed defect
graph.py: autogenerated broken links to Wikipedia — at Version 4
Reported by: | was | Owned by: | mvngu |
---|---|---|---|
Priority: | major | Milestone: | sage-4.4.2 |
Component: | documentation | Keywords: | |
Cc: | Merged in: | ||
Authors: | Minh Van Nguyen, Nathann Cohen | Reviewers: | Minh Van Nguyen |
Report Upstream: | N/A | Work issues: | |
Branch: | Commit: | ||
Dependencies: | Stopgaps: |
Description (last modified by )
This is in devel/sage/sage/graphs/graph.py:
class Graph(GenericGraph): r""" Undirected graph. A graph is a set of vertices connected by edges (cf. http://en.wikipedia.org/wiki/Graph_(mathematics) ).
If you look at http://sagemath.org/doc/reference/sage/graphs/graph.html and search for "mathematics", then click the link, you'll see it is broken. Fix this by:
- fixing sphinx? too tricky, maybe
- finding sphinx docs and figuring out how to explicitly specify a URL.
Apply patches in the following order:
Change History (8)
comment:1 Changed 11 years ago by
- Summary changed from in graph.py, there is an autogenerated broken link to Wikipedia. replace it by something not autogenerated that works (probably trivial), or fix the url parser in sphinx (really hard) to graph.py: autogenerated broken links to Wikipedia
Changed 11 years ago by
comment:2 Changed 11 years ago by
- Status changed from new to needs_review
The attached patch should fix the broken links in graph.py
to Wikipedia. Any URL can be encapsulated using the markup:
`descriptive-name <valid-URL>`_
comment:3 Changed 11 years ago by
And here are a few more corrections (to be applied on top of Minh's)... Some were not a problem as they contained no parenthesis, but as I had an Emacs macro available... :-)
By the way, I noticed something funny while working on this patch :
~/sage/sage-doc/sage/graphs$ grep -e "def.*eedback" * digraph.py: def feedback_edge_set(self,value_only=False): digraph.py: def feedback_vertex_set(self,value_only=False): generic_graph.py: def feedback_edge_set(self,value_only=False): generic_graph.py: def feedback_vertex_set(self,value_only=False): ~/sage/sage-doc/sage/graphs$
It must have occurred during the splitting of graph.py... I'll create another ticket to take care of it :-)
Nathann
Changed 11 years ago by
Changed 11 years ago by
Changed 11 years ago by
comment:4 Changed 11 years ago by
- Description modified (diff)
- Reviewers set to Minh Van Nguyen
The patch trac_8786-other_fixes.2.patch is the same as trac_8786-other_fixes.patch, but with the ticket number in its commit message. The reviewer patch trac_8786-reviewer.patch contains the following changes:
- The patch trac_8786-other_fixes.2.patch does some fixes about broken links. But it removes the context about why we need such links. Restore that context.
- Some links in trac_8786-other_fixes.2.patch do not link to a Wikipedia article. Correct such links to point to Wikipedia articles.
So only the following patches now need review by anyone but me:
based on Sage 4.4