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:

Status badges

Description (last modified by mvngu)

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:

  1. fixing sphinx? too tricky, maybe
  1. finding sphinx docs and figuring out how to explicitly specify a URL.

Apply patches in the following order:

  1. trac_8786-wikipedia-links.patch
  2. trac_8786-other_fixes.2.patch
  3. trac_8786-reviewer.patch

Change History (8)

comment:1 Changed 11 years ago by mvngu

  • 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 mvngu

based on Sage 4.4

comment:2 Changed 11 years ago by mvngu

  • Authors set to Minh Van Nguyen
  • 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 ncohen

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 ncohen

Changed 11 years ago by mvngu

Changed 11 years ago by mvngu

comment:4 Changed 11 years ago by mvngu

  • Authors changed from Minh Van Nguyen to Minh Van Nguyen, Nathann Cohen
  • 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:

So only the following patches now need review by anyone but me:

Note: See TracTickets for help on using tickets.