Opened 13 months ago

Closed 3 months ago

#30451 closed defect (invalid)

Fix glitch in pdf documentation table of contents

Reported by: slelievre Owned by:
Priority: major Milestone: sage-duplicate/invalid/wontfix
Component: documentation Keywords: manifolds, website, doc-pdf
Cc: egourgoulhon Merged in:
Authors: Reviewers: Kwankyu Lee, Samuel Lelièvre
Report Upstream: N/A Work issues:
Branch: Commit:
Dependencies: Stopgaps:

Status badges

Description

In Sage 9.1, the section "Geometry and Topology" of the index page for the pdf reference manual at

starts with "Euclidean Spaces and Vector Calculus" where the link is broken and appears as

:doc:`Euclidean Spaces and Vector Calculus`

This ticket is to fix that.

Reported by Ask Sage user danielvolinski at

Change History (7)

comment:1 Changed 13 months ago by egourgoulhon

  • Cc egourgoulhon added

comment:2 follow-up: Changed 13 months ago by chapoton

This page looks totally broken right now. The sphinx markup is not respected.

comment:3 in reply to: ↑ 2 ; follow-up: Changed 13 months ago by egourgoulhon

Replying to chapoton:

This page looks totally broken right now. The sphinx markup is not respected.

Indeed. How does one get to that page in the first place? From https://www.sagemath.org/, clicking either on "Documentation" or on "Help->Online Documentation" in the top menu leads to https://doc.sagemath.org/, the PDF section of which seems OK (except for reference.pdf which is a mere TOC without any actual content).

Last edited 13 months ago by egourgoulhon (previous) (diff)

comment:4 in reply to: ↑ 3 Changed 13 months ago by klee

Replying to chapoton:

This page looks totally broken right now. The sphinx markup is not respected.

This page is now fixed (among other things) by #29993, now merged to Sage 9.2.beta11.

Replying to egourgoulhon:

How does one get to that page in the first place?

After you built Sage 9.2.beta11,

  1. Build html and pdf documetation sage --docbuild all html and sage --docbuild all pdf
  2. Then open the reference manual.
  3. Then click the Sage icon at the upper left corner.
  4. Then click the (missing) pdf icon next to the Reference link.

To recover the missing pdf icon for you, run sage --docbuild website html and reload the reference manual.

If you know how to fix the missing pdf icon issue, visit #30418.

comment:5 Changed 13 months ago by klee

  • Milestone changed from sage-9.2 to sage-duplicate/invalid/wontfix
  • Status changed from new to needs_review

comment:6 Changed 6 months ago by slelievre

  • Reviewers set to Kwankyu Lee, Samuel Lelièvre
  • Status changed from needs_review to positive_review

comment:7 Changed 3 months ago by mkoeppe

  • Resolution set to invalid
  • Status changed from positive_review to closed
Note: See TracTickets for help on using tickets.