Page MenuHomeFreeBSD

handbook/advanced-networking: fix internal xrefs
AbandonedPublic

Authored by concussious.bugzilla_runbox.com on Aug 9 2024, 10:38 PM.
Tags
Referenced Files
Unknown Object (File)
Tue, Oct 29, 3:32 AM
Unknown Object (File)
Sat, Oct 26, 7:12 AM
Unknown Object (File)
Sat, Oct 12, 6:23 PM
Unknown Object (File)
Oct 1 2024, 4:44 AM
Unknown Object (File)
Sep 30 2024, 11:22 AM
Unknown Object (File)
Sep 30 2024, 3:12 AM
Unknown Object (File)
Sep 28 2024, 5:09 AM
Unknown Object (File)
Sep 27 2024, 6:57 PM
Subscribers

Details

Reviewers
bcr
fernape
Group Reviewers
docs
Summary

After testing a previous revision, I discovered internal xrefs generated with crossref: do not work at all on PDF [0].
This revision updates all of the internal links in this chapter to use the syntax instructed in Asciidoctor official doc on xrefs [1].

I am currently going through the rest of the handbook for these while digesting the considerations from x11 refactor, this seems like a great task for me.

[0] https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=266107
[1] https://docs.asciidoctor.org/asciidoc/latest/macros/xref/

Test Plan

Links worked in PDF located at doc/documentation/public/en/books/handbook/handbook_en.pdf generated with make pdf-books DOC_LANG="en" HUGO_ARGS="--verbose --debug".

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

Forgot to capitalize "Network Chapter", as it was previously.

fernape requested changes to this revision.Aug 13 2024, 3:06 PM
This revision now requires changes to proceed.Aug 13 2024, 3:06 PM

Closing: overcome by events: Fernape fixed the internal macro in D46480!