Opened 9 months ago

Last modified 4 weeks ago

#30451 positive_review defect

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 (6)

comment:1 Changed 9 months ago by egourgoulhon

  • Cc egourgoulhon added

comment:2 follow-up: Changed 9 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 9 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 9 months ago by egourgoulhon (previous) (diff)

comment:4 in reply to: ↑ 3 Changed 8 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 8 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 4 weeks ago by slelievre

  • Reviewers set to Kwankyu Lee, Samuel Lelièvre
  • Status changed from needs_review to positive_review
Note: See TracTickets for help on using tickets.