Differential Revision: https://reviews.freebsd.org/D55726

Reviewed by: andy
Differential Revision: https://reviews.freebsd.org/D53847

Reviewed by: andy
Differential Revision: https://reviews.freebsd.org/D53494

Reviewed by: mizhka
Differential Revision: https://reviews.freebsd.org/D52052

"path:" parameter in the front matter was not documented and it has been
deprecated in gohugo 0.144.0.

Create a custom parameter with the same name in preparation for the upcoming
update of www/gohugo to 0.144.1

These adjustments ensure menu and navigation will work fine with the
recent changes.

Reviewed by:	fernape
Differential Revision:	https://reviews.freebsd.org/D44284

I'm very pleased to announce the release of
our new Documentation Portal.

Key features:
* Responsive
* Modern design
* Theme support: Light, Dark, High contrast
* Removed Python dependency

Acknowledgment:

* Alexander Leidinger <netchild (at) FreeBSD.org>
* Baptiste Daroussin <bapt (at) FreeBSD.org>
* Benedict Reuschling <bcr (at) freebsd.org>
* Daniel Ebdrup Jensen <debdrup (at) FreeBSD.org>
* Danilo G. Baio <dbaio (at) FreeBSD.org>
* Dave Cottlehuber <dch (at) FreeBSD.org>
* Ed Maste <emaste (at) FreeBSD.org>
* Fernando Apesteguía <fernape (at) FreeBSD.org>
* Pedro Giffuni <pfg (at) FreeBSD.org>
* Joseph Mingrone <jrm (at) ftfl.ca>
* Rocky Hotas <rockyhotas (at) firemail.cc>
* Pau Amma <pauamma (at) gundo.com>
* The FreeBSD Foundation

Approved by: core, doceng

* 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

This reverts commit 3462d12db6ebf303064db168a2333374344f369a.

Too soon, it broke asciidoctor-pdf which doesn't know Hugo's shortcode.
It will take more time and care.

This is a prerequisite for the translation workflow through .po files
and Weblate.

The asciidoctor include with the shortcode variable will help because
won't be needed to change the includes manually after converting the
translation (.po file) back to .adoc.

It will help other areas like, language attributes, which today is fixed
in every document.

The use of shortcode was suggested by jmooring@ from Hugo's project on
Github.

Reviewed by:	carlavilla
Differential Revision: https://reviews.freebsd.org/D30823