aboutsummaryrefslogtreecommitdiff
path: root/shared/lib/InterDocumentReferencesMacro
Commit message (Collapse)AuthorAgeFilesLines
* documentation: Modernize custom macrosAlexander Ziaee2026-06-181-4/+4
| | | | | | | | | 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 warningFernando Apesteguía2024-09-231-1/+1
|
* macros: Unbreak buildFernando Apesteguía2024-09-231-1/+1
| | | | Use a warning instead of an error for now.
* macros: Disallow crossref without descriptionFernando Apesteguía2024-09-221-0/+4
| | | | While here, fix the macro documentation in fdp-primer.
* [documentation]: Fix links in all output formatsFernando Apesteguía2024-09-071-13/+19
| | | | | | | | | | | | | 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
* Fix link references in single bookSergio Carlavilla Delgado2022-12-071-3/+3
| | | | | PR: 262661 Submitted by: grahamperrin@
* Build offline documentation using Hugo and other improvementsSergio Carlavilla Delgado2021-11-031-0/+9
| | | | | | | | | | | | | | | | | | | | | | * 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
* Migrate doc to Hugo/AsciiDoctorSergio Carlavilla Delgado2021-01-251-0/+25
I'm very pleased to announce the release of our new website and documentation using the new toolchain with Hugo and AsciiDoctor. To get more information about the new toolchain please read the FreeBSD Documentation Project Primer[1], Hugo docs[2] and AsciiDoctor docs[3]. Acknowledgment: Benedict Reuschling <bcr@> Glen Barber <gjb@> Hiroki Sato <hrs@> Li-Wen Hsu <lwhsu@> Sean Chittenden <seanc@> The FreeBSD Foundation [1] https://docs.FreeBSD.org/en/books/fdp-primer/ [2] https://gohugo.io/documentation/ [3] https://docs.asciidoctor.org/home/ Approved by: doceng, core