Page MenuHomeFreeBSD

handbook/advanced-networking: fix internal xrefs
AbandonedPublic

Authored by ziaee on Aug 9 2024, 10:38 PM.
Tags
Referenced Files
Unknown Object (File)
Mon, Dec 23, 4:08 AM
Unknown Object (File)
Dec 5 2024, 6:23 PM
Unknown Object (File)
Nov 30 2024, 6:44 AM
Unknown Object (File)
Nov 24 2024, 5:31 AM
Unknown Object (File)
Nov 22 2024, 4:30 AM
Unknown Object (File)
Nov 21 2024, 4:03 PM
Unknown Object (File)
Nov 12 2024, 3:33 PM
Unknown Object (File)
Oct 29 2024, 3:32 AM
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

ziaee requested review of this revision.Aug 9 2024, 10:38 PM
ziaee created this revision.

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!