Skip to content

[Doc]: 3.5.0 PDF is unavailable #21655

Closed

Description

@QuLogic

Problem

There are some issues with the structure of the PDF, so I have not yet posted it.

For example, the ToC for the PDF in 3.5.0 looks like:
Screenshot from 2021-11-16 20-10-48
compared with the HTML which looks like:
image
The 'Installing from source' and 'Installing FAQ' both appear before the 'Installation' page, but are hidden in the HTML version.

Matplotlib Version

3.5.0

Activity

  1. added this to the v3.5-doc milestone on Nov 17, 2021
  2. pinned this issue on Nov 17, 2021
  3. QuLogic commented on Nov 17, 2021

    @QuLogic
    MemberAuthor

    @jklymak @timhoffm You last re-arranged the docs to have Tutorials/Examples first, and then the General guide:
    image
    This is OK in the website, because we have the top bar that can link to any of those.

    But in the PDF, it's all very linear, and it seems odd to have a bunch of tutorials first, followed by a Getting Started and Installation Guide:
    Screenshot from 2021-11-17 16-27-02

    Since this doesn't really affect the HTML site that much, what do you think of re-ordering these?

  4. jklymak commented on Nov 18, 2021

    @jklymak
    Member

    @timhoffm was the proponent of reordering them. I'm fine either way.

  5. jklymak commented on Nov 19, 2021

    @jklymak
    Member

    The other approach is to just have the TOC in the middle of the page, and

    - :doc:`/tutorials/index` 
    - :doc:`/gallery/index`
    

    instead of explicit TOC here..

  6. timhoffm commented on Nov 20, 2021

    @timhoffm
    Member

    I have the feeling that this is the result of not having a clear hierarchical structure in the docs. But I don't want to dive down into docs structure again right now. So I'm fine with any solution that works to fix the PDF.

  7. unpinned this issue on Nov 28, 2021
  8. pinned this issue on Nov 29, 2021
  9. unpinned this issue on Dec 2, 2021
  10. QuLogic commented on Dec 7, 2021

    @QuLogic
    MemberAuthor

    The PDF is now 109.59 MB and gets blocked by GitHub for being too large. I'm not sure why it ballooned so much, but we'll have to shrink it in order to put it online.

  11. reopened this on Dec 7, 2021
  12. pinned this issue on Dec 7, 2021
  13. QuLogic commented on Dec 14, 2021

    @QuLogic
    MemberAuthor

    The PDF has now been shrunk and uploaded with 3.5.1; I will not attempt to fix it for 3.5.0.

  14. modified the milestones: v3.5-doc, v3.5.1 on Dec 14, 2021
  15. unpinned this issue on Dec 14, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions