git: d03ac46811 - main - pt-br/books/fdp-primer: Sync with en

From: Danilo G. Baio <dbaio_at_FreeBSD.org>
Date: Tue, 24 Jan 2023 23:36:44 UTC
The branch main has been updated by dbaio:

URL: https://cgit.FreeBSD.org/doc/commit/?id=d03ac468111dfbb96c010bfb5a6b4d3996586888

commit d03ac468111dfbb96c010bfb5a6b4d3996586888
Author:     Danilo G. Baio <dbaio@FreeBSD.org>
AuthorDate: 2023-01-24 23:22:14 +0000
Commit:     Danilo G. Baio <dbaio@FreeBSD.org>
CommitDate: 2023-01-24 23:22:14 +0000

    pt-br/books/fdp-primer: Sync with en
    
    Obtained from:  https://translate-dev.freebsd.org
---
 .../pt-br/books/fdp-primer/doc-build/_index.adoc   |  23 +-
 .../pt-br/books/fdp-primer/doc-build/_index.po     | 277 +++++++++-------
 .../books/fdp-primer/editor-config/_index.adoc     |  73 ++++-
 .../pt-br/books/fdp-primer/editor-config/_index.po | 275 +++++++++++-----
 .../pt-br/books/fdp-primer/overview/_index.adoc    |  10 +-
 .../pt-br/books/fdp-primer/overview/_index.po      | 120 ++++---
 .../pt-br/books/fdp-primer/structure/_index.adoc   |  20 +-
 .../pt-br/books/fdp-primer/structure/_index.po     | 208 +++++++-----
 .../pt-br/books/fdp-primer/trademarks/_index.adoc  |  10 +-
 .../pt-br/books/fdp-primer/trademarks/_index.po    | 137 ++++----
 .../books/fdp-primer/writing-style/_index.adoc     | 101 ++++++
 .../pt-br/books/fdp-primer/writing-style/_index.po | 355 ++++++++++++++++++++-
 12 files changed, 1168 insertions(+), 441 deletions(-)

diff --git a/documentation/content/pt-br/books/fdp-primer/doc-build/_index.adoc b/documentation/content/pt-br/books/fdp-primer/doc-build/_index.adoc
index 55cf94f713..f442a911c5 100644
--- a/documentation/content/pt-br/books/fdp-primer/doc-build/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/doc-build/_index.adoc
@@ -115,13 +115,13 @@ Para renderizar a documentação e o site em `html`, use um dos seguintes exempl
 Exemplos avançados de compilação são apresentados abaixo:
 
 [[documentation-build-example-verbose]]
-.Compile a documentação com mensagens de debug e no modo verboso
+.Compile a documentação em Inglês e Espanhol com mensagens de debug e no modo verboso
 [example]
 ====
 [source, shell]
 ....
 % cd ~/doc/documentation
-% make HUGO_ARGS="--verbose --debug --path-warnings"
+% make DOC_LANG="en es" HUGO_ARGS="--verbose --debug"
 ....
 ====
 
@@ -151,6 +151,25 @@ Um `hostname` também pode ser definido como url base para o servidor web intern
 ....
 ====
 
+[[documentation-build-example-offline]]
+.Compile a documentação em html para uso offline
+[example]
+====
+[source, shell]
+....
+% cd ~/doc/documentation
+% make html
+....
+
+Para compactar a saída em html, adicione `DOC_HTML_ARCHIVE=1`:
+
+[source, shell]
+....
+% cd ~/doc/documentation
+% DOC_HTML_ARCHIVE=1 make html
+....
+====
+
 [[doc-build-rendering-pdf]]
 === Renderizando em pdf
 
diff --git a/documentation/content/pt-br/books/fdp-primer/doc-build/_index.po b/documentation/content/pt-br/books/fdp-primer/doc-build/_index.po
index f36303377c..2ad692800d 100644
--- a/documentation/content/pt-br/books/fdp-primer/doc-build/_index.po
+++ b/documentation/content/pt-br/books/fdp-primer/doc-build/_index.po
@@ -1,12 +1,12 @@
 # SOME DESCRIPTIVE TITLE
 # Copyright (C) YEAR The FreeBSD Project
 # This file is distributed under the same license as the FreeBSD Documentation package.
-# Danilo G. Baio <dbaio@FreeBSD.org>, 2021, 2022.
+# Danilo G. Baio <dbaio@FreeBSD.org>, 2021, 2022, 2023.
 msgid ""
 msgstr ""
 "Project-Id-Version: FreeBSD Documentation VERSION\n"
-"POT-Creation-Date: 2022-07-07 23:22-0300\n"
-"PO-Revision-Date: 2022-02-06 18:52+0000\n"
+"POT-Creation-Date: 2023-01-24 17:44-0300\n"
+"PO-Revision-Date: 2023-01-24 22:31+0000\n"
 "Last-Translator: Danilo G. Baio <dbaio@FreeBSD.org>\n"
 "Language-Team: Portuguese (Brazil) <https://translate-dev.freebsd.org/"
 "projects/documentation/booksfdp-primerdoc-build_index/pt_BR/>\n"
@@ -15,7 +15,7 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=2; plural=n > 1;\n"
-"X-Generator: Weblate 4.10.1\n"
+"X-Generator: Weblate 4.15.1\n"
 
 #. type: YAML Front Matter: description
 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:1
@@ -205,18 +205,18 @@ msgstr "Exemplos avançados de compilação são apresentados abaixo:"
 #. type: Block title
 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:118
 #, no-wrap
-msgid "Build the documentation with verbose and debug messages"
-msgstr "Compile a documentação com mensagens de debug e no modo verboso"
+msgid "Build English and Spanish documentation with verbose and debug messages"
+msgstr "Compile a documentação em Inglês e Espanhol com mensagens de debug e no modo verboso"
 
 #. type: delimited block . 4
 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:125
 #, no-wrap
 msgid ""
 "% cd ~/doc/documentation\n"
-"% make HUGO_ARGS=\"--verbose --debug --path-warnings\"\n"
+"% make DOC_LANG=\"en es\" HUGO_ARGS=\"--verbose --debug\"\n"
 msgstr ""
 "% cd ~/doc/documentation\n"
-"% make HUGO_ARGS=\"--verbose --debug --path-warnings\"\n"
+"% make DOC_LANG=\"en es\" HUGO_ARGS=\"--verbose --debug\"\n"
 
 #. type: Block title
 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:129
@@ -267,26 +267,57 @@ msgstr ""
 msgid "% make run BIND=192.168.15.10 HOSTNAME=example.com\n"
 msgstr "% make run BIND=192.168.15.10 HOSTNAME=example.com\n"
 
-#. type: Title ===
+#. type: Block title
 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:155
 #, no-wrap
+msgid "Build documentation in html for offline usage"
+msgstr "Compile a documentação em html para uso offline"
+
+#. type: delimited block . 4
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:162
+#, no-wrap
+msgid ""
+"% cd ~/doc/documentation\n"
+"% make html\n"
+msgstr ""
+"% cd ~/doc/documentation\n"
+"% make html\n"
+
+#. type: Plain text
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:165
+msgid "To compress the html output, add `DOC_HTML_ARCHIVE=1`:"
+msgstr "Para compactar a saída em html, adicione `DOC_HTML_ARCHIVE=1`:"
+
+#. type: delimited block . 4
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:170
+#, no-wrap
+msgid ""
+"% cd ~/doc/documentation\n"
+"% DOC_HTML_ARCHIVE=1 make html\n"
+msgstr ""
+"% cd ~/doc/documentation\n"
+"% DOC_HTML_ARCHIVE=1 make html\n"
+
+#. type: Title ===
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:174
+#, no-wrap
 msgid "Rendering to pdf"
 msgstr "Renderizando em pdf"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:158
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:177
 msgid ""
 "To render the documentation to `pdf`, use one of the following examples."
 msgstr "Para gerar a documentação em `pdf`, use um dos seguintes exemplos."
 
 #. type: Block title
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:160
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:179
 #, no-wrap
 msgid "Build all documents in pdf"
 msgstr "Compilar todos os documentos em pdf"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:167
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:186
 #, no-wrap
 msgid ""
 "% cd ~/doc/documentation\n"
@@ -296,13 +327,13 @@ msgstr ""
 "% make pdf\n"
 
 #. type: Block title
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:171
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:190
 #, no-wrap
 msgid "Build all articles in pdf"
 msgstr "Compilar todos os artigos em pdf"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:178
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:197
 #, no-wrap
 msgid ""
 "% cd ~/doc/documentation\n"
@@ -312,13 +343,13 @@ msgstr ""
 "% make pdf-articles\n"
 
 #. type: Block title
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:182
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:201
 #, no-wrap
 msgid "Build all books in pdf"
 msgstr "Compilar todos os livros em pdf"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:189
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:208
 #, no-wrap
 msgid ""
 "% cd ~/doc/documentation\n"
@@ -328,13 +359,13 @@ msgstr ""
 "% make pdf-books\n"
 
 #. type: Block title
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:193
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:212
 #, no-wrap
 msgid "Build documents in pdf for specific languages"
 msgstr "Compilar todos os documentos em pdf de um idioma em específico"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:200
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:219
 #, no-wrap
 msgid ""
 "% cd ~/doc/documentation\n"
@@ -344,12 +375,12 @@ msgstr ""
 "% make DOC_LANG=\"en\" pdf\n"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:202
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:221
 msgid "This will build all English documents in pdf."
 msgstr "Este comando irá compilar todos os documentos em pdf do idioma Inglês."
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:207
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:226
 #, no-wrap
 msgid ""
 "% cd ~/doc/documentation\n"
@@ -359,54 +390,54 @@ msgstr ""
 "% make DOC_LANG=\"en fr\" pdf-books\n"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:209
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:228
 msgid "This will build all English and French books in pdf."
 msgstr ""
 "Este comando irá compilar todos os livros em pdf dos idiomas Inglês e "
 "Francês."
 
 #. type: Title ==
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:212
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:231
 #, no-wrap
 msgid "The FreeBSD Documentation Build Toolset"
 msgstr "O Conjunto de Ferramentas de Compilação da Documentação do FreeBSD"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:215
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:234
 msgid "These are the tools used to build and install the FDP documentation."
 msgstr ""
 "Essas são as ferramentas usadas para compilar e instalar a documentação FDP."
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:217
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:236
 msgid "The primary build tool is man:make[1], specifically Berkeley Make."
 msgstr ""
 "A principal ferramenta de compilação é o man:make[1], especificamente o "
 "Berkeley Make."
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:218
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:237
 msgid "Hugo"
 msgstr "Hugo"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:219
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:238
 msgid "AsciiDoctor"
 msgstr "AsciiDoctor"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:220
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:239
 msgid "Git"
 msgstr "Git"
 
 #. type: Title ==
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:222
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:241
 #, no-wrap
 msgid "Understanding the Makefile in the Documentation Tree"
 msgstr "Compreendendo o Makefile na Árvore de Documentação"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:225
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:244
 msgid ""
 "There are three [.filename]#Makefile# files for building some or all of the "
 "documentation project."
@@ -415,7 +446,7 @@ msgstr ""
 "projeto de documentação."
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:227
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:246
 msgid ""
 "The [.filename]#Makefile# in the [.filename]#documentation# directory will "
 "build only the documentation."
@@ -424,7 +455,7 @@ msgstr ""
 "apenas a documentação."
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:228
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:247
 msgid ""
 "The [.filename]#Makefile# in the [.filename]#website# directory will build "
 "only the website."
@@ -433,14 +464,14 @@ msgstr ""
 "apenas a website."
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:229
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:248
 msgid ""
 "The [.filename]#Makefile# at the top of the tree will build both the "
 "documentation and the website."
 msgstr "O [.filename]#Makefile# na raíz irá compilar a documentação e o site."
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:232
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:251
 msgid ""
 "The [.filename]#Makefile# appearing in subdirectories also support `make "
 "run` to serve built content with Hugo's internal webserver.  This webserver "
@@ -451,18 +482,18 @@ msgstr ""
 "servidor web roda na porta 1313 por padrão."
 
 #. type: Title ===
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:234
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:253
 #, no-wrap
 msgid "Documentation Makefile"
 msgstr "Makefile da Documentação"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:237
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:256
 msgid "This [.filename]#Makefile# takes the following form:"
 msgstr "Este [.filename]#Makefile# suporta o seguinte:"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:262
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:281
 #, no-wrap
 msgid ""
 "# Generate the FreeBSD documentation\n"
@@ -512,14 +543,14 @@ msgstr ""
 "# webserver on port 1313.\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:264
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:546
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:283
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:565
 #, no-wrap
 msgid "MAINTAINER=carlavilla@FreeBSD.org <.>\n"
 msgstr "MAINTAINER=carlavilla@FreeBSD.org <.>\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:269
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:288
 #, no-wrap
 msgid ""
 "# List of languages without book translations\n"
@@ -533,7 +564,7 @@ msgstr ""
 "BOOKONLY_LANGS=\t\tmn\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:272
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:291
 #, no-wrap
 msgid ""
 "# List of all languages we have content for\n"
@@ -543,14 +574,14 @@ msgstr ""
 "ALL_LANGUAGES=\tbn-bd da de el en es fr hu it ja ko mn nl pl pt-br ru tr zh-cn zh-tw <.>\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:274
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:551
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:293
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:570
 #, no-wrap
 msgid "LOCALBASE?=\t/usr/local\n"
 msgstr "LOCALBASE?=\t/usr/local\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:281
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:300
 #, no-wrap
 msgid ""
 "RUBY_CMD =\t${LOCALBASE}/bin/ruby <.>\n"
@@ -568,7 +599,7 @@ msgstr ""
 "ASCIIDOCTORPDF_CMD=\t${LOCALBASE}/bin/asciidoctor-pdf\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:291
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:310
 #, no-wrap
 msgid ""
 ".if defined(DOC_LANG) && !empty(DOC_LANG)\n"
@@ -592,7 +623,7 @@ msgstr ""
 ".endif\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:294
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:313
 #, no-wrap
 msgid ""
 "RUBYLIB =\t../shared/lib\n"
@@ -602,7 +633,7 @@ msgstr ""
 ".export\tRUBYLIB\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:298
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:317
 #, no-wrap
 msgid ""
 "RUN_DEPENDS=\t${HUGO_CMD} \\\n"
@@ -614,8 +645,8 @@ msgstr ""
 "\t\t${LOCALBASE}/bin/rougify\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:308
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:567
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:327
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:586
 #, no-wrap
 msgid ""
 ".ifndef HOSTNAME\n"
@@ -639,7 +670,7 @@ msgstr ""
 ".endif\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:315
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:334
 #, no-wrap
 msgid ""
 "# Strip the languages with only articles from the list of languages we\n"
@@ -657,7 +688,7 @@ msgstr ""
 ".endfor\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:322
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:341
 #, no-wrap
 msgid ""
 "# Strip the languages with only books from the list of languages we\n"
@@ -675,7 +706,7 @@ msgstr ""
 ".endfor\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:331
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:350
 #, no-wrap
 msgid ""
 "# Take the list of all languages, and take out the ones we have been\n"
@@ -697,14 +728,14 @@ msgstr ""
 ".endfor\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:333
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:588
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:352
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:607
 #, no-wrap
 msgid ".ORDER: all run <.>\n"
 msgstr ".ORDER: all run <.>\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:338
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:357
 #, no-wrap
 msgid ""
 ".ORDER: requirements <.>\n"
@@ -718,7 +749,7 @@ msgstr ""
 ".ORDER: build\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:341
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:360
 #, no-wrap
 msgid ""
 "all: requirements starting-message generate-pgpkeys-txt build\n"
@@ -728,7 +759,7 @@ msgstr ""
 "run: requirements starting-message generate-pgpkeys-txt run-local\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:344
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:363
 #, no-wrap
 msgid ""
 "# clean does not call pdf-clean as that is a subset of hugo-clean\n"
@@ -738,7 +769,7 @@ msgstr ""
 "clean: hugo-clean pgp-clean\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:351
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:370
 #, no-wrap
 msgid ""
 "requirements:\n"
@@ -756,7 +787,7 @@ msgstr ""
 ".endfor\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:356
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:375
 #, no-wrap
 msgid ""
 "requirements-pdf:\n"
@@ -770,7 +801,7 @@ msgstr ""
 ".endif\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:361
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:380
 #, no-wrap
 msgid ""
 "requirements-epub:\n"
@@ -784,7 +815,7 @@ msgstr ""
 ".endif\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:368
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:387
 #, no-wrap
 msgid ""
 "starting-message: .PHONY <.>\n"
@@ -802,13 +833,13 @@ msgstr ""
 "\t@echo ---------------------------------------------------------------\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:370
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:389
 #, no-wrap
 msgid "generate-pgpkeys-txt: static/pgpkeys/pgpkeys.txt\n"
 msgstr "generate-pgpkeys-txt: static/pgpkeys/pgpkeys.txt\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:373
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:392
 #, no-wrap
 msgid ""
 "static/pgpkeys/pgpkeys.txt: static/pgpkeys/*key\n"
@@ -818,7 +849,7 @@ msgstr ""
 "\t${RUBY_CMD} ./tools/global-pgpkeys-creator.rb\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:377
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:396
 #, no-wrap
 msgid ""
 "run-local: .PHONY <.>\n"
@@ -830,8 +861,8 @@ msgstr ""
 "\t\t${HUGO_ARGS} -D $(BIND:D--bind=$(BIND)) --baseURL=\"http://$(.HOST):1313\"\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:380
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:622
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:399
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:641
 #, no-wrap
 msgid ""
 "build: .PHONY <.>\n"
@@ -841,7 +872,7 @@ msgstr ""
 "\tHUGO_DISABLELANGUAGES=\"${SKIP_LANGS}\" ${HUGO_CMD} ${HUGO_ARGS}\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:383
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:402
 #, no-wrap
 msgid ""
 "build-offline: .PHONY\n"
@@ -851,7 +882,7 @@ msgstr ""
 "\tHUGO_DISABLELANGUAGES=\"${SKIP_LANGS}\" ${HUGO_CMD} ${HUGO_OFFLINE_ARGS}\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:386
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:405
 #, no-wrap
 msgid ""
 "pgp-clean: .PHONY\n"
@@ -861,7 +892,7 @@ msgstr ""
 "\trm -f static/pgpkeys/pgpkeys.txt\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:389
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:408
 #, no-wrap
 msgid ""
 "hugo-clean: .PHONY\n"
@@ -871,7 +902,7 @@ msgstr ""
 "\trm -rf resources public\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:395
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:414
 #, no-wrap
 msgid ""
 "#\n"
@@ -887,7 +918,7 @@ msgstr ""
 "pdf: pdf-articles pdf-books\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:400
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:419
 #, no-wrap
 msgid ""
 "pdf-books: requirements-pdf\n"
@@ -901,7 +932,7 @@ msgstr ""
 ".endfor\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:405
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:424
 #, no-wrap
 msgid ""
 "pdf-articles: requirements-pdf\n"
@@ -915,13 +946,13 @@ msgstr ""
 ".endfor\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:407
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:426
 #, no-wrap
 msgid "pdf-clean: pdf-articles-clean pdf-books-clean\n"
 msgstr "pdf-clean: pdf-articles-clean pdf-books-clean\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:414
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:433
 #, no-wrap
 msgid ""
 "pdf-books-clean:\n"
@@ -939,7 +970,7 @@ msgstr ""
 "\t-rmdir ${.CURDIR}/public/\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:423
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:442
 #, no-wrap
 msgid ""
 "pdf-articles-clean:\n"
@@ -961,7 +992,7 @@ msgstr ""
 "\t-rmdir ${.CURDIR}/public\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:428
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:447
 #, no-wrap
 msgid ""
 "#\n"
@@ -975,13 +1006,13 @@ msgstr ""
 "html: build-offline html-clean-global html-clean-articles html-clean-books html-archive html-archive-clean-files\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:430
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:449
 #, no-wrap
 msgid "html-clean: hugo-clean\n"
 msgstr "html-clean: hugo-clean\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:434
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:453
 #, no-wrap
 msgid ""
 "html-clean-global:\n"
@@ -993,7 +1024,7 @@ msgstr ""
 "\trm -rf pgpkeys js\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:440
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:459
 #, no-wrap
 msgid ""
 "html-clean-articles:\n"
@@ -1009,7 +1040,7 @@ msgstr ""
 ".endfor\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:445
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:464
 #, no-wrap
 msgid ""
 "html-clean-books:\n"
@@ -1023,7 +1054,7 @@ msgstr ""
 ".endfor\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:455
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:474
 #, no-wrap
 msgid ""
 "html-archive:\n"
@@ -1047,7 +1078,7 @@ msgstr ""
 ".endif\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:461
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:480
 #, no-wrap
 msgid ""
 "html-archive-clean-files:\n"
@@ -1063,7 +1094,7 @@ msgstr ""
 ".endif\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:467
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:486
 #, no-wrap
 msgid ""
 "#\n"
@@ -1079,7 +1110,7 @@ msgstr ""
 "epub: epub-articles epub-books\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:480
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:499
 #, no-wrap
 msgid ""
 "epub-books: requirements-epub\n"
@@ -1109,7 +1140,7 @@ msgstr ""
 ".endfor\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:493
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:512
 #, no-wrap
 msgid ""
 "epub-articles: requirements-epub\n"
@@ -1139,13 +1170,13 @@ msgstr ""
 ".endfor\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:495
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:514
 #, no-wrap
 msgid "epub-clean: epub-articles-clean epub-books-clean\n"
 msgstr "epub-clean: epub-articles-clean epub-books-clean\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:502
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:521
 #, no-wrap
 msgid ""
 "epub-books-clean:\n"
@@ -1163,7 +1194,7 @@ msgstr ""
 "\t-rmdir ${.CURDIR}/public/\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:511
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:530
 #, no-wrap
 msgid ""
 "epub-articles-clean:\n"
@@ -1185,13 +1216,13 @@ msgstr ""
 "\t-rmdir ${.CURDIR}/public\n"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:514
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:636
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:533
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:655
 msgid "The `MAINTAINER` flag specifies who is the maintainer of this Makefile."
 msgstr "A flag `MAINTAINER` especifica quem é o mantenedor deste Makefile."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:515
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:534
 msgid ""
 "`ALL_LANGUAGES` flag specifies in which languages the table of contents has "
 "to be generated."
@@ -1199,20 +1230,20 @@ msgstr ""
 "A flag `ALL_LANGUAGES` especifica em quais idiomas o índice deve ser gerado."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:516
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:637
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:535
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:656
 msgid "`RUBY_CMD` flag specifies the location of the Ruby binary."
 msgstr "A flag `RUBY_CMD` especifica a localização do binário Ruby."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:517
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:638
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:536
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:657
 msgid "`HUGO_CMD` flag specifies the location of the Hugo binary."
 msgstr "A flag `HUGO_CMD` especifica a localização do binário Hugo."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:518
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:639
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:537
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:658
 msgid ""
 "`.ORDER` directives are used to ensure multiple make jobs may run without "
 "problem."
@@ -1221,7 +1252,7 @@ msgstr ""
 "executados sem problemas."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:519
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:538
 msgid ""
 "`all` target builds the documentation and puts the result in *~/doc/"
 "documentation/public*."
@@ -1230,8 +1261,8 @@ msgstr ""
 "e coloca o resultado em *~/doc/documentation/public*."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:520
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:641
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:539
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:660
 msgid ""
 "`starting-message` shows a message in the CLI to show the user that the "
 "process is running."
@@ -1240,8 +1271,8 @@ msgstr ""
 "que o processo está em execução."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:521
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:644
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:540
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:663
 msgid ""
 "`run-local` runs hugo webserver on port 1313, or a random free port if that "
 "is already in use."
@@ -1250,7 +1281,7 @@ msgstr ""
 "aleatória se esta já estiver em uso."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:522
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:541
 msgid ""
 "`build` builds the documentation and puts the result in the *~/doc/"
 "documentation/public*."
@@ -1259,18 +1290,18 @@ msgstr ""
 "public*."
 
 #. type: Title ===
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:524
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:543
 #, no-wrap
 msgid "Website Makefile"
 msgstr "Makefile do Website"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:527
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:546
 msgid "This [.filename]#Makefile# takes the form of:"
 msgstr "Este é o [.filename]#Makefile#:"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:544
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:563
 #, no-wrap
 msgid ""
 "# Generate the FreeBSD website\n"
@@ -1304,7 +1335,7 @@ msgstr ""
 "# webserver on port 1313.\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:549
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:568
 #, no-wrap
 msgid ""
 "# List of all languages we have content for\n"
@@ -1314,7 +1345,7 @@ msgstr ""
 "ALL_LANGUAGES=\tde el en es fr hu it ja nl ru tr zh-cn zh-tw\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:557
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:576
 #, no-wrap
 msgid ""
 "RUBY_CMD =\t${LOCALBASE}/bin/ruby <.>\n"
@@ -1330,7 +1361,7 @@ msgstr ""
 ".export\tRUBYLIB\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:577
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:596
 #, no-wrap
 msgid ""
 ".if defined(DOC_LANG) && !empty(DOC_LANG)\n"
@@ -1354,7 +1385,7 @@ msgstr ""
 ".endif\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:586
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:605
 #, no-wrap
 msgid ""
 "# Take the list of all languages, and take out the ones we have been\n"
@@ -1376,7 +1407,7 @@ msgstr ""
 ".endfor\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:594
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:613
 #, no-wrap
 msgid ""
 ".ORDER: starting-message generate-releases\n"
@@ -1392,7 +1423,7 @@ msgstr ""
 ".ORDER: post-build end-message\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:598
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:617
 #, no-wrap
 msgid ""
 "all: starting-message generate-releases build post-build end-message <.>\n"
@@ -1404,7 +1435,7 @@ msgstr ""
 "clean: hugo-clean releases-clean\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:605
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:624
 #, no-wrap
 msgid ""
 "starting-message: .PHONY <.>\n"
@@ -1422,7 +1453,7 @@ msgstr ""
 "\t@echo \"---------------------------------------------------------------\"\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:610
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:629
 #, no-wrap
 msgid ""
 "end-message: .PHONY\n"
@@ -1436,13 +1467,13 @@ msgstr ""
 "\t@echo ---------------------------------------------------------------\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:612
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:631
 #, no-wrap
 msgid "generate-releases: data/releases.toml <.>\n"
 msgstr "generate-releases: data/releases.toml <.>\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:615
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:634
 #, no-wrap
 msgid ""
 "data/releases.toml:\n"
@@ -1452,7 +1483,7 @@ msgstr ""
 "\t${RUBY_CMD} ./tools/releases-toml.rb\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:619
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:638
 #, no-wrap
 msgid ""
 "run-local: .PHONY <.>\n"
@@ -1464,13 +1495,13 @@ msgstr ""
 "\t    ${HUGO_ARGS} -D $(BIND:D--bind=$(BIND)) --baseURL=\"http://$(.HOST):1313\"\n"
*** 2502 LINES SKIPPED ***