[Bug 266107] FreeBSD Handbook and other books: PDF: broken internal links – crossr ef

From: <bugzilla-noreply_at_freebsd.org>
Date: Tue, 30 Aug 2022 03:48:54 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=266107

            Bug ID: 266107
           Summary: FreeBSD Handbook and other books: PDF: broken internal
                    links – crossref
           Product: Documentation
           Version: Latest
          Hardware: Any
               URL: https://github.com/freebsd/freebsd-doc/blob/main/docum
                    entation/content/en/books/handbook/preface/_index.adoc
                    #intended-audience
                OS: Any
            Status: New
          Severity: Affects Many People
          Priority: ---
         Component: Books & Articles
          Assignee: doc@FreeBSD.org
          Reporter: grahamperrin@freebsd.org

Under
<https://docs.freebsd.org/en/books/handbook/cutting-edge/#freebsdupdate-security-patches>
there's a link (not bugged) to a different page within the handbook: 

   
<https://docs.freebsd.org/en/books/handbook/security/index.html#security-advisories>

In the FreeBSD-packaged PDF (bugged): 

    ../security/index.html#security-advisories

– and so, for example, in Okular: 

> Unable to run the command specified. The file or folder 
> /usr/local/share/doc/freebsd/en/books/security/index.html does not exist.

----

<https://github.com/freebsd/freebsd-doc/blob/main/documentation/content/en/books/handbook/cutting-edge/_index.adoc#22-applying-security-patches>
I see: 

> crossref:security[security-advisories,"FreeBSD Security Advisories"]

----

Keyword, maybe    crossref

* the first page after the table of contents is bugged 
  (the link to the bibliography is broken)

* … and so on. 

I wondered whether this is a misc/freebsd-doc-en bug, probably not; links are
similarly broken in the PDF that's produced by clicking 'Download PDF' within
the online version of the Handbook. 

Also broken: 

* fdp-primer_en.pdf (the first link under 1.2.2.)

* faq_en.pdf (under 6.2)

* …

-- 
You are receiving this mail because:
You are the assignee for the bug.