doc/shared/lib, branch main

documentation: Modernize custom macros

2026-06-18T03:19:22Z

Convert our custom macros to output asciidoctor instead of raw html, silencing 6500 warnings. This will enable us to turn verbose builds on, which will enable us to actually understand what is going on in the doc tree. Reviewed by: dch, kevans

[macros]: Report faulting anchor in warning

2024-09-23T16:11:45Z

macros: Unbreak build

2024-09-23T05:23:37Z

Use a warning instead of an error for now.

macros: Disallow crossref without description

2024-09-22T17:35:28Z

While here, fix the macro documentation in fdp-primer.

[documentation]: Fix links in all output formats

2024-09-07T18:02:30Z

Use the crossref: macro for intra-file and intra-book links. This will produce the correct link in Single HTML, Splitted HTML and PDF. Rework the macro to include the PDF special render. While here, briefly document macros. PR: 266107 Reviewed by: bcr@, dbaio@, concussious.bugzilla_runbox.com Differential Revision: https://reviews.freebsd.org/D46480

PackagesMacro: Extend the syntax to category/name@flavor[pkgname]

2023-03-19T16:09:25Z

The package macro creates a link to the web interface of the port's origin directory in the ports repository. Extend its usage to cover the case when we want to refer to a speicifed flavor of a port. For example, if we want to refer the aarch64-gcc12 pacakge, in the past we can only specify its origin port, like `pacakge:devel/freebsd-gcc12`, and unable to add the `@aarch64` flavor suffix because it creates a broken link. This change makes it strip the suffix after `@` and accept a parameter of package name as link text. If not provided, use the origin as the original behavior. Thus we can have this kind of notation: package:devel/freebsd-gcc12@aarch64[aarch64-gcc12] which creates linkt to: https://cgit.freebsd.org/ports/tree/devel/freebsd-gcc12/ with link text: aarch64-gcc12 Reviewed by: carlavilla, dbaio Differential Revision: https://reviews.freebsd.org/D39067

macro/ManPage: Update the address of the manual pages

2023-01-28T20:15:38Z

Fix link references in single book

2022-12-07T18:22:10Z

PR: 262661 Submitted by: grahamperrin@

Change packages url to point git web

2021-12-04T16:39:52Z

PR: 260195 Submitted by: PauAmma

Build offline documentation using Hugo and other improvements

2021-11-03T16:44:52Z

* Allow to build the documentation offline using Hugo * Fix link problems * Remove SVN entities * Fix lang problems to help weblate * Move all the AsciiDoctor translations to the shared folder to help weblate * Allow the possibility to build each document. For example each document can be edited in and watched the result in real time in VS Code or Vim/NeoVim. Breaking changes: Eliminate the possibility of building books or articles. They must be builded at the same time. This functionality will be restored when version 0.89.0 is in the repositories in a couple of weeks. Reviewed by: dbaio@ Differential Revision: https://reviews.freebsd.org/D31926