Build offline documentation using Hugo and other improvements

* 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

1 files changed, 53 insertions, 74 deletions

diff --git a/documentation/content/es/books/handbook/book.adoc b/documentation/content/es/books/handbook/book.adoc
index ec8cf05539..b73958407e 100644
--- a/documentation/content/es/books/handbook/book.adoc
+++ b/documentation/content/es/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: Manual de FreeBSD
 authors:
   - author: Proyecto de Documentación de FreeBSD
 copyright: 1995-2020 Proyecto de Documentación de FreeBSD
-releaseinfo: "$FreeBSD$" 
 trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"] 
 ---
 
@@ -12,55 +11,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
 :toc: macro
 :toclevels: 2
 :icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
 :sectnums:
 :sectnumlevels: 6
 :partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
 :book: true
 :pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
 
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
 include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
 include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
-:chapters-path: content/es/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
 endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/es/mailing-lists.adoc[]
-include::../../../../shared/es/teams.adoc[]
-include::../../../../shared/es/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
 endif::[]
 
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/es/mailing-lists.adoc[]
-include::../../../../shared/es/teams.adoc[]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
 endif::[]
 
 [.abstract-title]
@@ -75,91 +54,91 @@ toc::[]
 
 :sectnums!:
 
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
 
 :sectnums:
 
 // Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
 
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..27;37..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}install/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}install/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
 
 // Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
 
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
 
 // Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
 
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}users/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}users/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}vinum/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}vinum/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
 
 // Section four
-include::{chapters-path}partiv.adoc[lines=7..18]
+include::{chapters-path}partiv.adoc[lines=15..26]
 
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
 
 // Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
 
 :sectnums!:
 
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
 
 :sectnums: