D31926.id95469.diff
No OneTemporary
Actions

Size

558 KB

Referenced Files

None

Subscribers

None

D31926.id95469.diff
View Options

This file is larger than 256 KB, so syntax highlighting was skipped.

	diff --git a/documentation/Makefile b/documentation/Makefile
	--- a/documentation/Makefile
	+++ b/documentation/Makefile
	@@ -33,9 +33,10 @@
	RUBY_CMD = ${LOCALBASE}/bin/ruby
	HUGO_CMD = ${LOCALBASE}/bin/hugo
	HUGO_ARGS?= --verbose --minify
	+HUGO_OFFLINE_ARGS?= --environment offline --verbose --minify
	ASCIIDOCTOR_CMD= ${LOCALBASE}/bin/asciidoctor
	ASCIIDOCTORPDF_CMD= ${LOCALBASE}/bin/asciidoctor-pdf
	-SED_CMD = /usr/bin/sed
	+
	.if defined(DOC_LANG) && !empty(DOC_LANG)
	LANGUAGES= ${DOC_LANG:S/,/ /g}
	.if ${LANGUAGES:Men} == "" && ${.TARGETS:Mpdf} == "" && ${.TARGETS:Mhtml} == ""
	@@ -124,6 +125,15 @@
	${PYTHON_CMD} ./tools/books-toc-examples-creator.py -l ${BOOK_LANGS}
	.endif

	+generate-books-toc-offline: .PHONY
	+.if !empty(BOOK_LANGS)
	+ ${PYTHON_CMD} ./tools/books-toc-parts-creator.py -o -l ${BOOK_LANGS}
	+ ${PYTHON_CMD} ./tools/books-toc-creator.py -o -l ${BOOK_LANGS}
	+ ${PYTHON_CMD} ./tools/books-toc-figures-creator.py -o -l ${BOOK_LANGS}
	+ ${PYTHON_CMD} ./tools/books-toc-tables-creator.py -o -l ${BOOK_LANGS}
	+ ${PYTHON_CMD} ./tools/books-toc-examples-creator.py -o -l ${BOOK_LANGS}
	+.endif
	+
	generate-pgpkeys-txt: static/pgpkeys/pgpkeys.txt

	static/pgpkeys/pgpkeys.txt: static/pgpkeys/*key
	@@ -136,13 +146,16 @@
	build: .PHONY
	HUGO_DISABLELANGUAGES="${SKIP_LANGS}" ${HUGO_CMD} ${HUGO_ARGS}

	+build-offline: .PHONY
	+ HUGO_DISABLELANGUAGES="${SKIP_LANGS}" ${HUGO_CMD} ${HUGO_OFFLINE_ARGS}
	+
	toc-clean: .PHONY
	.if !empty(BOOK_LANGS)
	- rm -f $$(${PYTHON_CMD} ./tools/books-toc-parts-creator.py -l ${BOOK_LANGS} -o)
	- rm -f $$(${PYTHON_CMD} ./tools/books-toc-creator.py -l ${BOOK_LANGS} -o)
	- rm -f $$(${PYTHON_CMD} ./tools/books-toc-figures-creator.py -l ${BOOK_LANGS} -o)
	- rm -f $$(${PYTHON_CMD} ./tools/books-toc-tables-creator.py -l ${BOOK_LANGS} -o)
	- rm -f $$(${PYTHON_CMD} ./tools/books-toc-examples-creator.py -l ${BOOK_LANGS} -o)
	+ rm -f $$(${PYTHON_CMD} ./tools/books-toc-parts-creator.py -l ${BOOK_LANGS} -p)
	+ rm -f $$(${PYTHON_CMD} ./tools/books-toc-creator.py -l ${BOOK_LANGS} -p)
	+ rm -f $$(${PYTHON_CMD} ./tools/books-toc-figures-creator.py -l ${BOOK_LANGS} -p)
	+ rm -f $$(${PYTHON_CMD} ./tools/books-toc-tables-creator.py -l ${BOOK_LANGS} -p)
	+ rm -f $$(${PYTHON_CMD} ./tools/books-toc-examples-creator.py -l ${BOOK_LANGS} -p)
	.endif

	pgp-clean: .PHONY
	@@ -157,252 +170,26 @@
	#
	pdf: pdf-articles pdf-books

	-pdf-books-target:
	+pdf-books: generate-books-toc
	.for _lang in ${BOOK_LANGS}
	-TMP+= ${.CURDIR}/content/${_lang}/books/*/
	+ ./tools/asciidoctor.sh books ${_lang} pdf
	.endfor
	-BOOKSDIR != echo ${TMP}

	-pdf-articles-target:
	+pdf-articles:
	.for _lang in ${ARTICLE_LANGS}
	-TTMP += ${.CURDIR}/content/${_lang}/articles/*/
	-.endfor
	-ARTICLESDIR != echo ${TTMP}
	-
	-pdf-books: pdf-books-target generate-books-toc
	-
	-# Books build
	-#
	-# Notes:
	-# pdf-theme=default-with-fallback-font is
	-# used instead of pdf-theme=./themes/default-pdf-theme.yml because
	-# it allows ja, ru, tr, zh-* fonts to be embedded and rendering is
	-# better for other languages.
	-#
	-# asciidoctor-pdf-cjk and/or specific themes should be used for cjk
	-# fonts
	-.for _curpdf in ${BOOKSDIR}
	- @mkdir -p ${.CURDIR}/public${_curpdf:S\|^${.CURDIR}/content\|\|}
	-.if exists(${_curpdf}book.adoc)
	- ${ASCIIDOCTORPDF_CMD} \
	- -r ./shared/lib/man-macro.rb \
	- -r ./shared/lib/man-macro.rb \
	- -r ./shared/lib/git-macro.rb \
	- -r ./shared/lib/packages-macro.rb \
	- -r ./shared/lib/inter-document-references-macro.rb \
	- -r ./shared/lib/sectnumoffset-treeprocessor.rb \
	- --doctype=book \
	- -a skip-front-matter \
	- -a pdf-theme=default-with-fallback-font \
	- -o ${.CURDIR}/public${_curpdf:S\|^${.CURDIR}/content\|\|}book.pdf \
	- ${_curpdf}book.adoc
	-.else
	-# some books use _index.adoc as main document
	- ${ASCIIDOCTORPDF_CMD} \
	- -r ./shared/lib/man-macro.rb \
	- -r ./shared/lib/man-macro.rb \
	- -r ./shared/lib/git-macro.rb \
	- -r ./shared/lib/packages-macro.rb \
	- -r ./shared/lib/inter-document-references-macro.rb \
	- -r ./shared/lib/sectnumoffset-treeprocessor.rb \
	- --doctype=book \
	- -a skip-front-matter \
	- -a pdf-theme=default-with-fallback-font \
	- -o ${.CURDIR}/public${_curpdf:S\|^${.CURDIR}/content\|\|}book.pdf \
	- ${_curpdf}_index.adoc
	-.endif
	-.endfor
	-
	-pdf-articles: pdf-articles-target
	-
	-# Articles build
	-.for _curpdf in ${ARTICLESDIR}
	- @mkdir -p ${.CURDIR}/public${_curpdf:S\|^${.CURDIR}/content\|\|}
	- ${ASCIIDOCTORPDF_CMD} \
	- -r ./shared/lib/man-macro.rb \
	- -r ./shared/lib/man-macro.rb \
	- -r ./shared/lib/git-macro.rb \
	- -r ./shared/lib/packages-macro.rb \
	- -r ./shared/lib/inter-document-references-macro.rb \
	- -r ./shared/lib/sectnumoffset-treeprocessor.rb \
	- --doctype=article \
	- -a skip-front-matter \
	- -a pdf-theme=default-with-fallback-font \
	- -o ${.CURDIR}/public${_curpdf:S\|^${.CURDIR}/content\|\|}article.pdf \
	- ${_curpdf}_index.adoc
	-.if exists(${.CURDIR}/static/source/articles/${_curpdf:H:T})
	- cp -R ${.CURDIR}/static/source/articles/${_curpdf:H:T}/ \
	- ${.CURDIR}/public${_curpdf:S\|^${.CURDIR}/content\|\|}
	-.endif
	+ ./tools/asciidoctor.sh articles ${_lang} pdf
	.endfor

	pdf-clean: pdf-articles-clean pdf-books-clean

	-pdf-books-clean: pdf-books-target toc-clean
	-.for _curpdf in ${BOOKSDIR}
	- rm -f ${.CURDIR}/public${_curpdf:S\|^${.CURDIR}/content\|\|}book.pdf
	-.endfor
	+pdf-books-clean:
	.for _lang in ${BOOK_LANGS}
	rm -fr ${.CURDIR}/public/${_lang}/books
	-rmdir ${.CURDIR}/public/${_lang}
	.endfor
	-rmdir ${.CURDIR}/public/

	-#
	-# HTML targets
	-# Use DOC_LANG to choose the language, e.g., make DOC_LANG="en fr" html-books
	-#
	-html: html-articles html-books
	-
	-html-books-target:
	-.for _lang in ${BOOK_LANGS}
	-TMPH += ${.CURDIR}/content/${_lang}/books/*/
	-.endfor
	-BOOKSDIR != echo ${TMPH}
	-
	-html-articles-target:
	-.for _lang in ${ARTICLE_LANGS}
	-TTMPH += ${.CURDIR}/content/${_lang}/articles/*/
	-.endfor
	-ARTICLESDIR != echo ${TTMPH}
	-
	-html-books: html-books-target generate-books-toc
	-
	-# Books build
	-#
	-.for _curhtml in ${BOOKSDIR}
	- @mkdir -p ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|}
	-.if exists(${_curhtml}book.adoc)
	- ${ASCIIDOCTOR_CMD} \
	- -B ${.CURDIR}/ \
	- -r ./shared/lib/man-macro.rb \
	- -r ./shared/lib/man-macro.rb \
	- -r ./shared/lib/git-macro.rb \
	- -r ./shared/lib/packages-macro.rb \
	- -r ./shared/lib/inter-document-references-macro.rb \
	- -r ./shared/lib/sectnumoffset-treeprocessor.rb \
	- --doctype=book \
	- -a skip-front-matter \
	- -a linkcss -a copycss=${.CURDIR}/themes/beastie/static/css/docbook.css -a stylesheet=docbook.css -a stylesdir=../../css \
	- -a iconfont-remote! -a iconfont-name=font-awesome-min \
	- -o ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|}book.html \
	- ${_curhtml}book.adoc
	-.if exists(${.CURDIR}/static/images/books/${_curhtml:H:T})
	- @mkdir -p ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|:H:H:H}/images/books/
	- cp -R ${.CURDIR}/static/images/books/${_curhtml:H:T}/ \
	- ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|:H:H:H}/images/books/${_curhtml:H:T}/
	- ${SED_CMD} -i '' -e "s\|../../../../images\|../../images\|g" \
	- ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|}book.html
	-.endif
	-.else
	-# some books use _index.adoc as main document
	- ${ASCIIDOCTOR_CMD} \
	- -B ${.CURDIR}/ \
	- -r ./shared/lib/man-macro.rb \
	- -r ./shared/lib/man-macro.rb \
	- -r ./shared/lib/git-macro.rb \
	- -r ./shared/lib/packages-macro.rb \
	- -r ./shared/lib/inter-document-references-macro.rb \
	- -r ./shared/lib/sectnumoffset-treeprocessor.rb \
	- --doctype=book \
	- -a skip-front-matter \
	- -a linkcss -a copycss=${.CURDIR}/themes/beastie/static/css/docbook.css -a stylesheet=docbook.css -a stylesdir=../../css \
	- -a iconfont-remote! -a iconfont-name=font-awesome-min \
	- -o ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|}book.html \
	- ${_curhtml}_index.adoc
	-.if exists(${.CURDIR}/static/images/books/${_curhtml:H:T})
	- @mkdir -p ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|:H:H:H}/images/books/
	- cp -R ${.CURDIR}/static/images/books/${_curhtml:H:T}/ \
	- ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|:H:H:H}/images/books/${_curhtml:H:T}/
	- ${SED_CMD} -i '' -e "s\|../../../../images\|../../images\|g" \
	- ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|}book.html
	-.endif
	-.endif
	-.if !exists(${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|:H:H:H}/fonts/)
	- mkdir -p ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|:H:H:H}/fonts/
	- cp -R ${.CURDIR}/themes/beastie/static/fonts/ \
	- ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|:H:H:H}/fonts/
	- cp ${.CURDIR}/themes/beastie/static/css/font-awesome-min.css \
	- ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|:H:H:H}/css/
	-.endif
	-.endfor
	-
	-html-articles: html-articles-target
	-
	-# Articles build
	-.for _curhtml in ${ARTICLESDIR}
	- @mkdir -p ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|}
	- ${ASCIIDOCTOR_CMD} \
	- -B ${.CURDIR}/ \
	- -r ./shared/lib/man-macro.rb \
	- -r ./shared/lib/man-macro.rb \
	- -r ./shared/lib/git-macro.rb \
	- -r ./shared/lib/packages-macro.rb \
	- -r ./shared/lib/inter-document-references-macro.rb \
	- -r ./shared/lib/sectnumoffset-treeprocessor.rb \
	- --doctype=article \
	- -a skip-front-matter \
	- -a linkcss -a copycss=${.CURDIR}/themes/beastie/static/css/docbook.css -a stylesheet=docbook.css -a stylesdir=../../css \
	- -a iconfont-remote! -a iconfont-name=font-awesome-min \
	- -o ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|}article.html \
	- ${_curhtml}_index.adoc
	-.if exists(${.CURDIR}/static/source/articles/${_curhtml:H:T})
	- cp -R ${.CURDIR}/static/source/articles/${_curhtml:H:T}/ \
	- ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|}
	-.endif
	-.if exists(${.CURDIR}/static/images/articles/${_curhtml:H:T})
	- @mkdir -p ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|:H:H:H}/images/articles/
	- cp -R ${.CURDIR}/static/images/articles/${_curhtml:H:T}/ \
	- ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|:H:H:H}/images/articles/${_curhtml:H:T}/
	- ${SED_CMD} -i '' -e "s\|../../../images\|../../images\|g" \
	- ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|}article.html
	-.endif
	-.if !exists(${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|:H:H:H}/fonts/)
	- mkdir -p ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|:H:H:H}/fonts/
	- cp -R ${.CURDIR}/themes/beastie/static/fonts/ \
	- ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|:H:H:H}/fonts/
	- cp ${.CURDIR}/themes/beastie/static/css/font-awesome-min.css \
	- ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|:H:H:H}/css/
	-.endif
	-.endfor
	-
	-html-clean: html-resources-clean html-articles-clean html-books-clean
	-
	-html-resources-clean:
	-.for _lang in ${LANGUAGES}
	- rm -fr ${.CURDIR}/public/${_lang}/css
	- rm -fr ${.CURDIR}/public/${_lang}/fonts
	- rm -fr ${.CURDIR}/public/${_lang}/images
	-.endfor
	-
	-html-books-clean: html-books-target toc-clean
	-.for _curhtml in ${BOOKSDIR}
	- rm -f ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|}book.html ${_curhtml}toc*.adoc
	- -rmdir ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|}
	-.endfor
	-.for _lang in ${BOOK_LANGS}
	- rm -fr ${.CURDIR}/public/${_lang}/books
	- rm -fr ${.CURDIR}/public/${_lang}/images/books
	- -rmdir ${.CURDIR}/public/${_lang}
	-.endfor
	- -rmdir ${.CURDIR}/public
	-
	-html-articles-clean: html-articles-target
	-.for _curhtml in ${ARTICLESDIR}
	- rm -f ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|}article.html
	- -rmdir ${.CURDIR}/public${_curhtml:S\|^${.CURDIR}/content\|\|}
	-.endfor
	-.for _lang in ${ARTICLE_LANGS}
	- rm -fr ${.CURDIR}/public/${_lang}/articles
	- rm -fr ${.CURDIR}/public/${_lang}/images/articles
	- -rmdir ${.CURDIR}/public/${_lang}
	-.endfor
	- -rmdir ${.CURDIR}/public
	-
	-pdf-articles-clean: pdf-articles-target
	-.for _curpdf in ${ARTICLESDIR}
	- rm -f ${.CURDIR}/public${_curpdf:S\|^${.CURDIR}/content\|\|}article.pdf
	-.endfor
	+pdf-articles-clean:
	.for _lang in ${ARTICLE_LANGS}
	rm -fr ${.CURDIR}/public/${_lang}/articles
	.if !exists(${.CURDIR}/public/${_lang}/books)
	@@ -411,3 +198,9 @@
	.endfor
	-rmdir ${.CURDIR}/public

	+#
	+# HTML targets
	+#
	+html: generate-books-toc-offline build-offline
	+
	+html-clean: hugo-clean
	diff --git a/documentation/config/_default/config.toml b/documentation/config/_default/config.toml
	--- a/documentation/config/_default/config.toml
	+++ b/documentation/config/_default/config.toml
	@@ -1,5 +1,4 @@
	# FreeBSD documentation
	-# $FreeBSD$

	baseURL = "https://docs.freebsd.org/"
	title = "FreeBSD Documentation Portal"
	@@ -10,17 +9,20 @@
	theme = "beastie"
	disableKinds = [ "taxonomy", "taxonomyTerm" ]
	authors = [ "carlavilla@FreeBSD.org" ]
	-preserveTOC = true
	-ignoreFiles = [ "chapters-order.adoc$", "toc.adoc$", "toc-tables.adoc$", "toc-figures.adoc$", "toc-examples.adoc$", "toc-1.adoc$", "toc-2.adoc$", "toc-3.adoc$", "toc-4.adoc$", "toc-5.adoc$", "books.adoc$", "chapter.adoc$", "\\.po$" ]
	+ignoreFiles = [ "chapters-order.adoc$", "toc.adoc$", "toc-tables.adoc$", "toc-figures.adoc$", "toc-examples.adoc$", "toc-1.adoc$", "toc-2.adoc$", "toc-3.adoc$", "toc-4.adoc$", "toc-5.adoc$", "books.adoc$", "chapter.adoc$", "contrib-386bsd.adoc$", "contrib-additional.adoc$", "contrib-committers.adoc$", "contrib-corealumni.adoc$", "contrib-develalumni.adoc$", "contrib-develinmemoriam.adoc$", "contrib-portmgralumni.adoc$", "\\.po$" ]
	enableRobotsTXT = true

	[params]
	websiteURL = "https://www.FreeBSD.org/"
	description = "FreeBSD Documentation Portal"
	+ isOnline = true

	[markup.asciidocExt]
	preserveTOC = true
	- extensions = ["man-macro", "inter-document-references-macro", "sectnumoffset-treeprocessor", "packages-macro", "git-macro"]
	+ extensions = ["man-macro", "inter-document-references-macro", "cross-document-references-macro", "sectnumoffset-treeprocessor", "packages-macro", "git-macro"]
	+ [markup.asciidocExt.attributes]
	+ env-beastie = true
	+ isOnline = true

	[outputs]
	home = [ "HTML" ]
	diff --git a/documentation/content/bd/articles/explaining-bsd/_index.adoc b/documentation/content/bd/articles/explaining-bsd/_index.adoc
	--- a/documentation/content/bd/articles/explaining-bsd/_index.adoc
	+++ b/documentation/content/bd/articles/explaining-bsd/_index.adoc
	@@ -16,6 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/explaining-bsd/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Abstract
	diff --git a/documentation/content/bd/articles/new-users/_index.adoc b/documentation/content/bd/articles/new-users/_index.adoc
	--- a/documentation/content/bd/articles/new-users/_index.adoc
	+++ b/documentation/content/bd/articles/new-users/_index.adoc
	@@ -16,6 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/new-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Abstract
	diff --git a/documentation/content/da/articles/ipsec-must/_index.adoc b/documentation/content/da/articles/ipsec-must/_index.adoc
	--- a/documentation/content/da/articles/ipsec-must/_index.adoc
	+++ b/documentation/content/da/articles/ipsec-must/_index.adoc
	@@ -16,10 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Indholdsfortegnelse
	-:table-caption: Tabel
	-:figure-caption: Figur
	-:example-caption: Eksempel
	+:images-path: articles/ipsec-must/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumé
	diff --git a/documentation/content/de/articles/contributing/_index.adoc b/documentation/content/de/articles/contributing/_index.adoc
	--- a/documentation/content/de/articles/contributing/_index.adoc
	+++ b/documentation/content/de/articles/contributing/_index.adoc
	@@ -15,24 +15,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Inhaltsverzeichnis
	-:table-caption: Tabelle
	-:figure-caption: Abbildung
	-:example-caption: Beispiel
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/de/mailing-lists.adoc[]
	-include::shared/de/urls.adoc[]
	+:images-path: articles/contributing/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/de/urls.adoc[]
	-include::../../../../shared/de/mailing-lists.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/de/urls.adoc[]
	-include::../../../../shared/de/mailing-lists.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/de/articles/explaining-bsd/_index.adoc b/documentation/content/de/articles/explaining-bsd/_index.adoc
	--- a/documentation/content/de/articles/explaining-bsd/_index.adoc
	+++ b/documentation/content/de/articles/explaining-bsd/_index.adoc
	@@ -16,10 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Inhaltsverzeichnis
	-:table-caption: Tabelle
	-:figure-caption: Abbildung
	-:example-caption: Beispiel
	+:images-path: articles/explaining-bsd/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Zusammenfassung
	diff --git a/documentation/content/de/articles/freebsd-update-server/_index.adoc b/documentation/content/de/articles/freebsd-update-server/_index.adoc
	--- a/documentation/content/de/articles/freebsd-update-server/_index.adoc
	+++ b/documentation/content/de/articles/freebsd-update-server/_index.adoc
	@@ -17,21 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Inhaltsverzeichnis
	-:table-caption: Tabelle
	-:figure-caption: Abbildung
	-:example-caption: Beispiel
	+:images-path: articles/freebsd-update-server/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/de/articles/leap-seconds/_index.adoc b/documentation/content/de/articles/leap-seconds/_index.adoc
	--- a/documentation/content/de/articles/leap-seconds/_index.adoc
	+++ b/documentation/content/de/articles/leap-seconds/_index.adoc
	@@ -12,21 +12,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Inhaltsverzeichnis
	-:table-caption: Tabelle
	-:figure-caption: Abbildung
	-:example-caption: Beispiel
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/de/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/de/urls.adoc[]
	+:images-path: articles/leap-seconds/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/de/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	diff --git a/documentation/content/de/articles/linux-users/_index.adoc b/documentation/content/de/articles/linux-users/_index.adoc
	--- a/documentation/content/de/articles/linux-users/_index.adoc
	+++ b/documentation/content/de/articles/linux-users/_index.adoc
	@@ -16,21 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Inhaltsverzeichnis
	-:table-caption: Tabelle
	-:figure-caption: Abbildung
	-:example-caption: Beispiel
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/de/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/de/urls.adoc[]
	+:images-path: articles/linux-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/de/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/de/articles/nanobsd/_index.adoc b/documentation/content/de/articles/nanobsd/_index.adoc
	--- a/documentation/content/de/articles/nanobsd/_index.adoc
	+++ b/documentation/content/de/articles/nanobsd/_index.adoc
	@@ -15,21 +15,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Inhaltsverzeichnis
	-:table-caption: Tabelle
	-:figure-caption: Abbildung
	-:example-caption: Beispiel
	+:images-path: articles/nanobsd/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/de/articles/new-users/_index.adoc b/documentation/content/de/articles/new-users/_index.adoc
	--- a/documentation/content/de/articles/new-users/_index.adoc
	+++ b/documentation/content/de/articles/new-users/_index.adoc
	@@ -16,24 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Inhaltsverzeichnis
	-:table-caption: Tabelle
	-:figure-caption: Abbildung
	-:example-caption: Beispiel
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/de/mailing-lists.adoc[]
	-include::shared/de/urls.adoc[]
	+:images-path: articles/new-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/de/urls.adoc[]
	-include::../../../../shared/de/mailing-lists.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/de/urls.adoc[]
	-include::../../../../shared/de/mailing-lists.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/de/articles/port-mentor-guidelines/_index.adoc b/documentation/content/de/articles/port-mentor-guidelines/_index.adoc
	--- a/documentation/content/de/articles/port-mentor-guidelines/_index.adoc
	+++ b/documentation/content/de/articles/port-mentor-guidelines/_index.adoc
	@@ -15,21 +15,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Inhaltsverzeichnis
	-:table-caption: Tabelle
	-:figure-caption: Abbildung
	-:example-caption: Beispiel
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/de/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/de/urls.adoc[]
	+:images-path: articles/port-mentor-guidelines/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/de/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	diff --git a/documentation/content/de/articles/solid-state/_index.adoc b/documentation/content/de/articles/solid-state/_index.adoc
	--- a/documentation/content/de/articles/solid-state/_index.adoc
	+++ b/documentation/content/de/articles/solid-state/_index.adoc
	@@ -17,10 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Inhaltsverzeichnis
	-:table-caption: Tabelle
	-:figure-caption: Abbildung
	-:example-caption: Beispiel
	+:images-path: articles/solid-state/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Zusammenfassung
	diff --git a/documentation/content/de/books/developers-handbook/_index.adoc b/documentation/content/de/books/developers-handbook/_index.adoc
	--- a/documentation/content/de/books/developers-handbook/_index.adoc
	+++ b/documentation/content/de/books/developers-handbook/_index.adoc
	@@ -4,7 +4,8 @@
	- author: The FreeBSD Documentation Project
	copyright: 1995-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
	+trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
	+isIndex: true
	---

	= FreeBSD Developers' Handbook
	diff --git a/documentation/content/de/books/faq/_index.adoc b/documentation/content/de/books/faq/_index.adoc
	--- a/documentation/content/de/books/faq/_index.adoc
	+++ b/documentation/content/de/books/faq/_index.adoc
	@@ -4,7 +4,8 @@
	- author: The FreeBSD Documentation Project
	copyright: 1995-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	+isIndex: true
	---

	= Häufig gestellte Fragen zu FreeBSD {rel2-relx} und {rel-relx}
	diff --git a/documentation/content/de/books/handbook/_index.adoc b/documentation/content/de/books/handbook/_index.adoc
	--- a/documentation/content/de/books/handbook/_index.adoc
	+++ b/documentation/content/de/books/handbook/_index.adoc
	@@ -6,6 +6,7 @@
	releaseinfo: "$FreeBSD$"
	trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
	next: books/handbook/preface
	+isIndex: true
	---

	= FreeBSD Handbuch
	diff --git a/documentation/content/de/books/porters-handbook/_index.adoc b/documentation/content/de/books/porters-handbook/_index.adoc
	--- a/documentation/content/de/books/porters-handbook/_index.adoc
	+++ b/documentation/content/de/books/porters-handbook/_index.adoc
	@@ -4,7 +4,8 @@
	- author: The FreeBSD Documentation Project
	copyright: 2000-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "sun", "unix", "general"]
	+trademarks: ["freebsd", "sun", "unix", "general"]
	+isIndex: true
	---

	= FreeBSD Porter's Handbook
	diff --git a/documentation/content/el/articles/bsdl-gpl/_index.adoc b/documentation/content/el/articles/bsdl-gpl/_index.adoc
	--- a/documentation/content/el/articles/bsdl-gpl/_index.adoc
	+++ b/documentation/content/el/articles/bsdl-gpl/_index.adoc
	@@ -18,10 +18,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Πίνακας Περιεχομένων
	-:table-caption: Πίνακας
	-:figure-caption: Σχήμα
	-:example-caption: Παράδειγμα
	+:images-path: articles/bsdl-gpl/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	'''

	diff --git a/documentation/content/el/articles/contributing/_index.adoc b/documentation/content/el/articles/contributing/_index.adoc
	--- a/documentation/content/el/articles/contributing/_index.adoc
	+++ b/documentation/content/el/articles/contributing/_index.adoc
	@@ -16,24 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Πίνακας Περιεχομένων
	-:table-caption: Πίνακας
	-:figure-caption: Σχήμα
	-:example-caption: Παράδειγμα
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/el/urls.adoc[]
	-include::shared/el/mailing-lists.adoc[lines=10..-1]
	+:images-path: articles/contributing/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/el/urls.adoc[]
	-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/el/urls.adoc[]
	-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/el/articles/explaining-bsd/_index.adoc b/documentation/content/el/articles/explaining-bsd/_index.adoc
	--- a/documentation/content/el/articles/explaining-bsd/_index.adoc
	+++ b/documentation/content/el/articles/explaining-bsd/_index.adoc
	@@ -16,10 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Πίνακας Περιεχομένων
	-:table-caption: Πίνακας
	-:figure-caption: Σχήμα
	-:example-caption: Παράδειγμα
	+:images-path: articles/explaining-bsd/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Περίληψη
	diff --git a/documentation/content/el/articles/freebsd-questions/_index.adoc b/documentation/content/el/articles/freebsd-questions/_index.adoc
	--- a/documentation/content/el/articles/freebsd-questions/_index.adoc
	+++ b/documentation/content/el/articles/freebsd-questions/_index.adoc
	@@ -16,24 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Πίνακας Περιεχομένων
	-:table-caption: Πίνακας
	-:figure-caption: Σχήμα
	-:example-caption: Παράδειγμα
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/el/urls.adoc[]
	-include::shared/el/mailing-lists.adoc[]
	+:images-path: articles/freebsd-questions/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/el/urls.adoc[]
	-include::../../../../shared/el/mailing-lists.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/el/urls.adoc[]
	-include::../../../../shared/el/mailing-lists.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/el/articles/gjournal-desktop/_index.adoc b/documentation/content/el/articles/gjournal-desktop/_index.adoc
	--- a/documentation/content/el/articles/gjournal-desktop/_index.adoc
	+++ b/documentation/content/el/articles/gjournal-desktop/_index.adoc
	@@ -16,30 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Πίνακας Περιεχομένων
	-:table-caption: Πίνακας
	-:figure-caption: Σχήμα
	-:example-caption: Παράδειγμα
	+:images-path: articles/gjournal-desktop/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/el/mailing-lists.adoc[lines=10..-1]
	-include::shared/el/urls.adoc[]
	-:imagesdir: ../../../images/articles/gjournal-desktop/
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/el/urls.adoc[]
	-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
	-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/el/urls.adoc[]
	-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
	-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]


	diff --git a/documentation/content/el/articles/greek-language-support/_index.adoc b/documentation/content/el/articles/greek-language-support/_index.adoc
	--- a/documentation/content/el/articles/greek-language-support/_index.adoc
	+++ b/documentation/content/el/articles/greek-language-support/_index.adoc
	@@ -16,24 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Πίνακας Περιεχομένων
	-:table-caption: Πίνακας
	-:figure-caption: Σχήμα
	-:example-caption: Παράδειγμα
	+:images-path: articles/greek-language-support/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/el/urls.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/el/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/el/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/el/articles/linux-users/_index.adoc b/documentation/content/el/articles/linux-users/_index.adoc
	--- a/documentation/content/el/articles/linux-users/_index.adoc
	+++ b/documentation/content/el/articles/linux-users/_index.adoc
	@@ -16,21 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Πίνακας Περιεχομένων
	-:table-caption: Πίνακας
	-:figure-caption: Σχήμα
	-:example-caption: Παράδειγμα
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/el/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/el/urls.adoc[]
	+:images-path: articles/linux-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/el/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/el/articles/mailing-list-faq/_index.adoc b/documentation/content/el/articles/mailing-list-faq/_index.adoc
	--- a/documentation/content/el/articles/mailing-list-faq/_index.adoc
	+++ b/documentation/content/el/articles/mailing-list-faq/_index.adoc
	@@ -14,27 +14,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Πίνακας Περιεχομένων
	-:table-caption: Πίνακας
	-:figure-caption: Σχήμα
	-:example-caption: Παράδειγμα
	+:images-path: articles/mailing-list-faq/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/el/mailing-lists.adoc[lines=10..-1]
	-include::shared/el/urls.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
	-include::../../../../shared/el/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
	-include::../../../../shared/el/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/el/articles/nanobsd/_index.adoc b/documentation/content/el/articles/nanobsd/_index.adoc
	--- a/documentation/content/el/articles/nanobsd/_index.adoc
	+++ b/documentation/content/el/articles/nanobsd/_index.adoc
	@@ -17,21 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Πίνακας Περιεχομένων
	-:table-caption: Πίνακας
	-:figure-caption: Σχήμα
	-:example-caption: Παράδειγμα
	+:images-path: articles/nanobsd/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/el/articles/new-users/_index.adoc b/documentation/content/el/articles/new-users/_index.adoc
	--- a/documentation/content/el/articles/new-users/_index.adoc
	+++ b/documentation/content/el/articles/new-users/_index.adoc
	@@ -16,21 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Πίνακας Περιεχομένων
	-:table-caption: Πίνακας
	-:figure-caption: Σχήμα
	-:example-caption: Παράδειγμα
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/el/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/el/urls.adoc[]
	+:images-path: articles/new-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/el/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/el/articles/problem-reports/_index.adoc b/documentation/content/el/articles/problem-reports/_index.adoc
	--- a/documentation/content/el/articles/problem-reports/_index.adoc
	+++ b/documentation/content/el/articles/problem-reports/_index.adoc
	@@ -15,24 +15,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Πίνακας Περιεχομένων
	-:table-caption: Πίνακας
	-:figure-caption: Σχήμα
	-:example-caption: Παράδειγμα
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/el/mailing-lists.adoc[lines=10..-1]
	-include::shared/el/urls.adoc[]
	+:images-path: articles/problem-reports/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
	-include::../../../../shared/el/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
	-include::../../../../shared/el/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/el/articles/releng/_index.adoc b/documentation/content/el/articles/releng/_index.adoc
	--- a/documentation/content/el/articles/releng/_index.adoc
	+++ b/documentation/content/el/articles/releng/_index.adoc
	@@ -17,34 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:xrefstyle: full
	-:toc-title: Πίνακας Περιεχομένων
	-:table-caption: Πίνακας
	-:figure-caption: Σχήμα
	-:example-caption: Παράδειγμα
	+:images-path: articles/releng/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/el/mailing-lists.adoc[lines=10..-1]
	-include::shared/el/teams.adoc[lines=21..-1]
	-include::shared/el/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
	-include::../../../../shared/el/teams.adoc[lines=21..-1]
	-include::../../../../shared/el/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
	-include::../../../../shared/el/teams.adoc[lines=21..-1]
	-include::../../../../shared/el/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/el/books/faq/_index.adoc b/documentation/content/el/books/faq/_index.adoc
	--- a/documentation/content/el/books/faq/_index.adoc
	+++ b/documentation/content/el/books/faq/_index.adoc
	@@ -4,7 +4,8 @@
	- author: Η Ομάδα Τεκμηρίωσης του FreeBSD
	copyright: 1995-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "ibm", "ieee", "3com", "adobe", "intel", "linux", "microsoft", "opengroup", "sparc", "sun", "oracle", "xfree86", "general"]
	+trademarks: ["freebsd", "ibm", "ieee", "3com", "adobe", "intel", "linux", "microsoft", "opengroup", "sparc", "sun", "oracle", "xfree86", "general"]
	+isIndex: true
	---

	= Συχνές Ερωτήσεις για το FreeBSD 6.X και 7.X
	diff --git a/documentation/content/el/books/handbook/_index.adoc b/documentation/content/el/books/handbook/_index.adoc
	--- a/documentation/content/el/books/handbook/_index.adoc
	+++ b/documentation/content/el/books/handbook/_index.adoc
	@@ -6,6 +6,7 @@
	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"]
	next: books/handbook/preface
	+isIndex: true
	---

	= Εγχειρίδιο του FreeBSD
	diff --git a/documentation/content/en/articles/bsdl-gpl/_index.adoc b/documentation/content/en/articles/bsdl-gpl/_index.adoc
	--- a/documentation/content/en/articles/bsdl-gpl/_index.adoc
	+++ b/documentation/content/en/articles/bsdl-gpl/_index.adoc
	@@ -17,6 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/bsdl-gpl/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	'''

	diff --git a/documentation/content/en/articles/building-products/_index.adoc b/documentation/content/en/articles/building-products/_index.adoc
	--- a/documentation/content/en/articles/building-products/_index.adoc
	+++ b/documentation/content/en/articles/building-products/_index.adoc
	@@ -19,27 +19,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/building-products/

	-
	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/urls.adoc[]
	-:imagesdir: ../../../images/articles/building-products/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:imagesdir: ../../../../static/images/articles/building-products/
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:imagesdir: ../../../../static/images/articles/building-products/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -180,7 +172,7 @@

	FreeBSD does not have "corporate" committers.
	Individual committers are required to take responsibility for the changes they introduce to the code.
	-The link:{committers-guide}[FreeBSD Committer's guide] <<ComGuide>> documents the rules and responsibilities for committers.
	+The extref:{committers-guide}[FreeBSD Committer's guide] <<ComGuide>> documents the rules and responsibilities for committers.

	FreeBSD's project model is examined in detail in <<Nik2005>>.

	@@ -200,7 +192,7 @@
	Code lines are kept alive for as long as there is user and developer interest in them.

	Machine architectures are grouped into "tiers"; _Tier 1_ architectures are fully supported by the project's release engineering and security teams, _Tier 2_ architectures are supported on a best effort basis, and experimental architectures comprise _Tier 3_.
	-The list of link:{committers-guide}#archs[supported architectures] is part of the FreeBSD documentation collection.
	+The list of extref:{committers-guide}[supported architectures, archs] is part of the FreeBSD documentation collection.

	The release engineering team publishes a link:https://www.FreeBSD.org/releng/[road map] for future releases of FreeBSD on the project's web site.
	The dates laid down in the road map are not deadlines; FreeBSD is released when its code and documentation are ready.
	@@ -280,7 +272,7 @@
	Setup processes that help in tracking the development of FreeBSD.
	For example:
	+
	-Track FreeBSD source code. The project makes it easy to mirror its SVN repository using link:{committers-guide}#svn-advanced-use-setting-up-svnsync[svnsync]. Having the complete history of the source is useful when debugging complex problems and offers valuable insight into the intentions of the original developers. Use a capable source control system that allows you to easily merge changes between the upstream FreeBSD code base and your own in-house code.
	+Track FreeBSD source code. The project makes it easy to mirror its SVN repository using extref:{committers-guide}[svnsync, svn-advanced-use-setting-up-svnsync]. Having the complete history of the source is useful when debugging complex problems and offers valuable insight into the intentions of the original developers. Use a capable source control system that allows you to easily merge changes between the upstream FreeBSD code base and your own in-house code.
	+
	<<fig-svn-blame, An annotated source listing generated using `svn blame`>> shows a portion of an annotated listing of the file referenced by the change log in <<fig-change-log, A sample change log entry>>.
	The ancestry of each line of the source is clearly visible.
	@@ -340,7 +332,7 @@
	The project has a dedicated link:https://www.FreeBSD.org/donations/[donations liaison] to assist donors.
	The project also maintains a web page where developers link:https://www.FreeBSD.org/donations/wantlist/[list their needs].
	+
	-As a policy the FreeBSD project link:{contributors}[acknowledges] all contributions received on its web site.
	+As a policy the FreeBSD project extref:{contributors}[acknowledges] all contributions received on its web site.

	[[conclusion]]
	== Conclusion
	@@ -359,19 +351,19 @@

	[[Carp1996]] [Carp1996] http://www.ietf.org/rfc/rfc1958.txt[The Architectural Principles of the Internet] B. Carpenter. The Internet Architecture Board.The Internet Architecture Board. Copyright(R) 1996.

	-[[ComGuide]] [ComGuide] link:{committers-guide}[Committer's Guide] The FreeBSD Project. Copyright(R) 2005.
	+[[ComGuide]] [ComGuide] extref:{committers-guide}[Committer's Guide] The FreeBSD Project. Copyright(R) 2005.

	[[GoldGab2005]] [GoldGab2005] http://dreamsongs.com/IHE/IHE.html[Innovation Happens Elsewhere: Open Source as Business Strategy] Ron Goldman. Richard Gabriel. Copyright(R) 2005. Morgan-Kaufmann.

	-[[Hub1994]] [Hub1994] link:{contributing}[Contributing to the FreeBSD Project] Jordan Hubbard. Copyright(R) 1994-2005. The FreeBSD Project.
	+[[Hub1994]] [Hub1994] extref:{contributing}[Contributing to the FreeBSD Project] Jordan Hubbard. Copyright(R) 1994-2005. The FreeBSD Project.

	[[McKu1999]] [McKu1999] http://www.usenix.org/publications/library/proceedings/usenix99/mckusick.html[Soft Updates: A Technique for Eliminating Most Synchronous Writes in the Fast Filesystem] Kirk McKusick. Gregory Ganger. Copyright(R) 1999.

	[[McKu1999-1]] [McKu1999-1] http://www.oreilly.com/catalog/opensources/book/kirkmck.html[Twenty Years of Berkeley Unix: From AT&T-Owned to Freely Redistributable] Marshall Kirk McKusick. http://www.oreilly.com/catalog/opensources/book/toc.html[Open Sources: Voices from the Open Source Revolution] O'Reilly Inc.. Copyright(R) 1993.

	-[[Mon2005]] [Mon2005] link:{bsdl-gpl}[Why you should use a BSD style license for your Open Source Project] Bruce Montague. The FreeBSD Project. Copyright(R) 2005.
	+[[Mon2005]] [Mon2005] extref{bsdl-gpl}[Why you should use a BSD style license for your Open Source Project] Bruce Montague. The FreeBSD Project. Copyright(R) 2005.

	-[[Nik2005]] [Nik2005] link:{dev-model}[A project model for the FreeBSD Project] Niklas Saers. Copyright(R) 2005. The FreeBSD Project.
	+[[Nik2005]] [Nik2005] extref:{dev-model}[A project model for the FreeBSD Project] Niklas Saers. Copyright(R) 2005. The FreeBSD Project.

	[[Nor1993]] [Nor1993] http://www.norvig.com/luv-slides.ps[Tutorial on Good Lisp Programming Style] Peter Norvig. Kent Pitman. Copyright(R) 1993.

	@@ -379,4 +371,4 @@

	[[Ray2004]] [Ray2004] http://www.catb.org/~esr/faqs/smart-questions.html[How to ask questions the smart way] Eric Steven Raymond. Copyright(R) 2004.

	-[[RelEngDoc]] [RelEngDoc] link:{releng}[FreeBSD Release Engineering] Murray Stokely. Copyright(R) 2001. The FreeBSD Project.
	+[[RelEngDoc]] [RelEngDoc] extref:{releng}[FreeBSD Release Engineering] Murray Stokely. Copyright(R) 2001. The FreeBSD Project.
	diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc
	--- a/documentation/content/en/articles/committers-guide/_index.adoc
	+++ b/documentation/content/en/articles/committers-guide/_index.adoc
	@@ -18,26 +18,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/committers-guide/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/en/teams.adoc[lines=16..-1]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/teams.adoc[lines=16..-1]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/teams.adoc[lines=16..-1]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -290,10 +283,10 @@

	* Changes in [.filename]#documentation/content/en/books/porters-handbook/versions/_index.adoc#
	+
	-link:{porters-handbook}versions/[__FreeBSD_version Values (Porter's Handbook)], mainly used for src committers.
	+extref:{porters-handbook}versions/[__FreeBSD_version Values (Porter's Handbook)], mainly used for src committers.
	* Changes in [.filename]#documentation/content/en/articles/contributors/contrib-additional.adoc#
	+
	-link:{contributors}#contrib-additional[Additional FreeBSD Contributors'] maintenance.
	+extref:{contributors}[Additional FreeBSD Contributors, contrib-additional] maintenance.
	* All link:#commit-steps[Steps for New Committers], doc related
	* Security advisories; Errata Notices; Releases;
	+
	@@ -302,7 +295,7 @@
	+
	Used by {donations}.

	-Before any commit, a build test is necessary; see the 'Overview' and 'The FreeBSD Documentation Build Process' sections of the link:{fdp-primer}[FreeBSD Documentation Project Primer for New Contributors] for more details.
	+Before any commit, a build test is necessary; see the 'Overview' and 'The FreeBSD Documentation Build Process' sections of the extref:{fdp-primer}[FreeBSD Documentation Project Primer for New Contributors] for more details.

	[[git-primer]]
	== Git Primer
	@@ -510,7 +503,7 @@
	....
	so that won't be covered in depth here.

	-If you want to build a custom kernel, link:{handbook}#kernelconfig[the kernel config section] of the FreeBSD Handbook recommends creating a file MYKERNEL under sys/${ARCH}/conf with your changes against GENERIC.
	+If you want to build a custom kernel, extref:{handbook}[the kernel config section, kernelconfig] of the FreeBSD Handbook recommends creating a file MYKERNEL under sys/${ARCH}/conf with your changes against GENERIC.
	To have MYKERNEL disregarded by Git, it can be added to .git/info/exclude.

	===== Updating
	@@ -666,7 +659,7 @@
	The cgit repository web interface for use with web browsers is at https://cgit.FreeBSD.org/ports/ .
	The production Git repository is at https://git.FreeBSD.org/ports.git and at ssh://anongit@git.FreeBSD.org/ports.git (or anongit@git.FreeBSD.org:ports.git).

	-There is also a mirror on GitHub, see link:{handbook}mirrors/#mirrors[External mirrors] for an overview.
	+There is also a mirror on GitHub, see extref:{handbook}/mirrors[External mirrors, mirrors] for an overview.
	The 'current' branch is 'main' .
	The quarterly branches are named 'yyyyQn' for year 'yyyy' and quarter 'n'.

	@@ -2481,7 +2474,7 @@
	[.filename]#doc/shared/authors.adoc# - Add an author entity. Later steps depend on this entity, and missing this step will cause the [.filename]#doc/# build to fail. This is a relatively easy task, but remains a good first test of version control skills.
	. Update the List of Developers and Contributors
	+
	-[.filename]#doc/documentation/content/en/articles/contributors/contrib-committers.adoc# - Add an entry, which will then appear in the "Developers" section of the link:{contributors}#staff-committers[Contributors List]. Entries are sorted by last name.
	+[.filename]#doc/documentation/content/en/articles/contributors/contrib-committers.adoc# - Add an entry, which will then appear in the "Developers" section of the extref:{contributors}[Contributors List, staff-committers]. Entries are sorted by last name.
	+
	[.filename]#doc/documentation/content/en/articles/contributors/contrib-additional.adoc# - _Remove_ the entry. Entries are sorted by first name.
	. Add a News Item
	@@ -3205,7 +3198,7 @@

	You can find out more about Bugzilla at:

	-* link:{pr-guidelines}[FreeBSD Problem Report Handling Guidelines]
	+* extref:{pr-guidelines}[FreeBSD Problem Report Handling Guidelines]
	* link:https://www.FreeBSD.org/support/[https://www.FreeBSD.org/support]

	[[phabricator]]
	@@ -3237,7 +3230,7 @@
	It is not a conflict resolution body.
	The vast majority of documentation related discussion takes place on the {freebsd-doc}.
	More details regarding the doceng team can be found in its https://www.FreeBSD.org/internal/doceng/[charter].
	-Committers interested in contributing to the documentation should familiarize themselves with the link:{fdp-primer}[Documentation Project Primer].
	+Committers interested in contributing to the documentation should familiarize themselves with the extref:{fdp-primer}[Documentation Project Primer].

	`{re-members}`::
	These are the members of the `{re}`.
	@@ -3391,7 +3384,7 @@
	. Respect existing maintainers if listed.
	+
	Many parts of FreeBSD are not "owned" in the sense that any specific individual will jump up and yell if you commit a change to "their" area, but it still pays to check first.
	-One convention we use is to put a maintainer line in the [.filename]#Makefile# for any package or subtree which is being actively maintained by one or more people; see link:{developers-handbook}#policies[Source Tree Guidelines and Policies] for documentation on this.
	+One convention we use is to put a maintainer line in the [.filename]#Makefile# for any package or subtree which is being actively maintained by one or more people; see extref:{developers-handbook}[Source Tree Guidelines and Policies, policies] for documentation on this.
	Where sections of code have several maintainers, commits to affected areas by one maintainer need to be reviewed by at least one other maintainer.
	In cases where the "maintainer-ship" of something is not clear, look at the repository logs for the files in question and see if someone has been working recently or predominantly in that area.
	. Any disputed change must be backed out pending resolution of the dispute if requested by a maintainer. Security related changes may override a maintainer's wishes at the Security Officer's discretion.
	@@ -3683,19 +3676,19 @@

	Check the port, preferably to make sure it compiles and packages correctly.

	-The link:{porters-handbook}testing[Porters Handbook's Testing Chapter] contains more detailed instructions.
	-See the link:{porters-handbook}testing#testing-portclippy[Portclippy / Portfmt] and the link:{porters-handbook}testing#testing-poudriere[Poudriere] sections.
	+The extref:{porters-handbook}testing[Porters Handbook's Testing Chapter] contains more detailed instructions.
	+See the extref:{porters-handbook}testing[Portclippy / Portfmt, testing-portclippy] and the extref:{porters-handbook}testing[Poudriere, testing-poudriere] sections.

	You do not necessarily have to eliminate all warnings but make sure you have fixed the simple ones.

	-If the port came from a submitter who has not contributed to the Project before, add that person's name to the link:{contributors}#contrib-additional[Additional Contributors] section of the FreeBSD Contributors List.
	+If the port came from a submitter who has not contributed to the Project before, add that person's name to the extref:{contributors}[Additional Contributors, contrib-additional] section of the FreeBSD Contributors List.

	Close the PR if the port came in as a PR.
	To close a PR, change the state to `Issue Resolved` and the resolution as `Fixed`.

	[NOTE]
	====
	-If for some reason using link:{porters-handbook}testing#testing-poudriere[Poudriere] to test the new port is not possible, the bare minimum of testing includes this sequence:
	+If for some reason using extref:{porters-handbook}testing[Poudriere, testing-poudriere] to test the new port is not possible, the bare minimum of testing includes this sequence:

	[source,shell]
	....
	@@ -3809,7 +3802,7 @@
	[[ports-qa-new-category-how]]
	==== What is the procedure for creating a new category?

	-Please see link:{porters-handbook}#proposing-categories[Proposing a New Category] in the Porter's Handbook.
	+Please see extref:{porters-handbook}[Proposing a New Category, proposing-categories] in the Porter's Handbook.
	Once that procedure has been followed and the PR has been assigned to the {portmgr}, it is their decision whether or not to approve it.
	If they do, it is their responsibility to:

	@@ -3843,7 +3836,7 @@
	. Once this is done, you can commit the updated [.filename]#ports/Makefile# to connect the new category to the build and also commit the [.filename]#Makefile# changes for the old category or categories.
	. Add appropriate entries to [.filename]#ports/MOVED#.
	. Update the documentation by modifying:
	-** the link:{porters-handbook}#PORTING-CATEGORIES[list of categories] in the Porter's Handbook
	+** the extref:{porters-handbook}[list of categories, PORTING-CATEGORIES] in the Porter's Handbook
	+
	. Only once all the above have been done, and no one is any longer reporting problems with the new ports, should the old ports be deleted from their previous locations in the repository.
	====
	@@ -3852,7 +3845,7 @@

	This is much simpler than a physical category. Only a few modifications are needed:

	-* the link:{porters-handbook}#PORTING-CATEGORIES[list of categories] in the Porter's Handbook
	+* the extref:{porters-handbook}[list of categories, PORTING-CATEGORIES] in the Porter's Handbook

	[[ports-qa-misc-questions]]
	=== Miscellaneous Questions
	diff --git a/documentation/content/en/articles/contributing/_index.adoc b/documentation/content/en/articles/contributing/_index.adoc
	--- a/documentation/content/en/articles/contributing/_index.adoc
	+++ b/documentation/content/en/articles/contributing/_index.adoc
	@@ -19,20 +19,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+:images-path: articles/contributing/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -76,7 +75,7 @@
	All that these people need to contribute is an investment of time and a willingness to learn.

	. Read through the FAQ and Handbook periodically. If anything is poorly explained, ambiguous, out of date or incorrect, let us know. Even better, send us a fix (AsciiDoc is not difficult to learn, but there is no objection to plain text submissions).
	-. Help translate FreeBSD documentation into your native language. If documentation already exists for your language, you can help translate additional documents or verify that the translations are up-to-date and correct. First take a look at the link:{fdp-primer}#translations[Translations FAQ] in the FreeBSD Documentation Project Primer. You are not committing yourself to translating every single FreeBSD document by doing this - as a volunteer, you can do as much or as little translation as you desire. Once someone begins translating, others almost always join the effort. If you only have the time or energy to translate one part of the documentation, please translate the installation instructions.
	+. Help translate FreeBSD documentation into your native language. If documentation already exists for your language, you can help translate additional documents or verify that the translations are up-to-date and correct. First take a look at the extref:{fdp-primer}[Translations FAQ, translations] in the FreeBSD Documentation Project Primer. You are not committing yourself to translating every single FreeBSD document by doing this - as a volunteer, you can do as much or as little translation as you desire. Once someone begins translating, others almost always join the effort. If you only have the time or energy to translate one part of the documentation, please translate the installation instructions.
	. Read the {freebsd-questions} occasionally (or even regularly). It can be very satisfying to share your expertise and help people solve their problems; sometimes you may even learn something new yourself! These forums can also be a source of ideas for things to improve upon.

	[[ongoing-programmer-tasks]]
	@@ -119,7 +118,7 @@

	There are a number of easy ways you can contribute to keeping the ports tree up to date and in good working order:

	-* Find some cool or useful software and link:{porters-handbook}[create a port] for it.
	+* Find some cool or useful software and extref:{porters-handbook}[create a port] for it.
	* There are a large number of ports that have no maintainer. Become a maintainer and <<adopt-port>>.
	* If you have created or adopted a port, be aware of <<maintain-port>>.
	* When you are looking for a quick challenge you could <<fix-broken>>.
	@@ -139,7 +138,7 @@

	An idea or suggestion of _general_ technical interest should be mailed to the {freebsd-hackers}.
	Likewise, people with an interest in such things (and a tolerance for a _high_ volume of mail!) may subscribe to the {freebsd-hackers}.
	-See link:{handbook}#eresources-mail[The FreeBSD Handbook] for more information about this and other mailing lists.
	+See extref:{handbook}[The FreeBSD Handbook, eresources-mail] for more information about this and other mailing lists.

	If you find a bug or are submitting a specific change, please report it using the https://bugs.FreeBSD.org/submit/[bug submission form].
	Try to fill-in each field of the bug report.
	@@ -151,19 +150,19 @@
	After filing a report, you should receive confirmation along with a tracking number.
	Keep this tracking number so that you can update us with details about the problem.

	-See also link:{problem-reports}[this article] on how to write good problem reports.
	+See also extref:{problem-reports}[this article] on how to write good problem reports.

	=== Changes to the Documentation

	Changes to the documentation are overseen by the {freebsd-doc}.
	-Please look at the link:{fdp-primer}[FreeBSD Documentation Project Primer] for complete instructions.
	+Please look at the extref:{fdp-primer}[FreeBSD Documentation Project Primer] for complete instructions.
	Send submissions and changes (even small ones are welcome!) using the same method as any other bug report.

	=== Changes to Existing Source Code

	An addition or change to the existing source code is a somewhat trickier affair and depends a lot on how far out of date you are with the current state of FreeBSD development.
	There is a special on-going release of FreeBSD known as "FreeBSD-CURRENT" which is made available in a variety of ways for the convenience of developers working actively on the system.
	-See link:{handbook}#current-stable[The FreeBSD Handbook] for more information about getting and using FreeBSD-CURRENT.
	+See extref:{handbook}[The FreeBSD Handbook, current-stable] for more information about getting and using FreeBSD-CURRENT.

	Working from older sources unfortunately means that your changes may sometimes be too obsolete or too divergent for easy re-integration into FreeBSD.
	Chances of this can be minimized somewhat by subscribing to the {freebsd-announce} and the {freebsd-current} lists, where discussions on the current state of the system take place.
	@@ -280,7 +279,7 @@
	==== How to adopt the port

	First make sure you understand your <<maintain-port>>.
	-Also read the link:{porters-handbook}[Porter's Handbook].
	+Also read the extref:{porters-handbook}[Porter's Handbook].
	_Please do not commit yourself to more than you feel you can comfortably handle._

	You may request maintainership of any unmaintained port as soon as you wish.
	@@ -331,7 +330,7 @@
	This section outlines the process to follow to keep your ports up to date.

	This is an overview.
	-More information about upgrading a port is available in the link:{porters-handbook}[Porter's Handbook].
	+More information about upgrading a port is available in the extref:{porters-handbook}[Porter's Handbook].

	[.procedure]
	====
	@@ -361,13 +360,13 @@
	. Submit changes
	+
	Send your update by submitting a PR with an explanation of the changes and a patch containing the differences between the original port and the updated one.
	-Please refer to link:{problem-reports}[Writing FreeBSD Problem Reports] for information on how to write a really good PR.
	+Please refer to extref:{problem-reports}[Writing FreeBSD Problem Reports] for information on how to write a really good PR.
	+
	[NOTE]
	======
	Please do not submit a man:shar[1] archive of the entire port; instead, use man:git-format-patch[1] or man:diff[1] `-ruN`.
	In this way, committers can much more easily see exactly what changes are being made.
	-The Porter's Handbook section on link:{porters-handbook}#port-upgrading[Upgrading] has more information.
	+The Porter's Handbook section on extref:{porters-handbook}[Upgrading, port-upgrading] has more information.
	======
	. Wait
	+
	@@ -550,9 +549,9 @@
	[[resources]]
	=== Resources for ports maintainers and contributors

	-The link:{porters-handbook}[Porter's Handbook] is your hitchhiker's guide to the ports system. Keep it handy!
	+The extref:{porters-handbook}[Porter's Handbook] is your hitchhiker's guide to the ports system. Keep it handy!

	-link:{problem-reports}[Writing FreeBSD Problem Reports] describes how to best formulate and submit a PR.
	+extref:{problem-reports}[Writing FreeBSD Problem Reports] describes how to best formulate and submit a PR.
	In 2005 more than eleven thousand ports PRs were submitted! Following this article will greatly assist us in reducing the time needed to handle your PRs.

	The https://bugs.freebsd.org/bugzilla/query.cgi[Problem Report database].
	@@ -569,7 +568,7 @@

	man:portlint[1] is an application which can be used to verify that your port conforms to many important stylistic and functional guidelines.
	portlint is a simple heuristic application, so you should use it __only as a guide__.
	-If portlint suggests changes which seem unreasonable, consult the link:{porters-handbook}[Porter's Handbook] or ask for advice.
	+If portlint suggests changes which seem unreasonable, consult the extref:{porters-handbook}[Porter's Handbook] or ask for advice.

	The {freebsd-ports} is for general ports-related discussion.
	It is a good place to ask for help.
	diff --git a/documentation/content/en/articles/contributors/_index.adoc b/documentation/content/en/articles/contributors/_index.adoc
	--- a/documentation/content/en/articles/contributors/_index.adoc
	+++ b/documentation/content/en/articles/contributors/_index.adoc
	@@ -11,26 +11,24 @@
	:toclevels: 1
	:icons: font
	:sectnums:
	+:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:sectnumlevels: 6
	+:images-path: articles/contributors/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/en/urls.adoc[]
	-:include-path: content/en/articles/contributors/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:include-path:
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+:include-path: content/{{% lang %}}/articles/contributors/
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	:include-path:
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -106,7 +104,7 @@

	* _Special contributors:_

	-** http://www.osd.bsdi.com/[BSDi] (formerly Walnut Creek CDROM) has donated almost more than we can say (see the 'About the FreeBSD Project' section of the link:{handbook}[FreeBSD Handbook] for more details). In particular, we would like to thank them for the original hardware used for `freefall.FreeBSD.org`, our primary development machine, and for `thud.FreeBSD.org`, a testing and build box. We are also indebted to them for funding various contributors over the years and providing us with unrestricted use of their T1 connection to the Internet.
	+** http://www.osd.bsdi.com/[BSDi] (formerly Walnut Creek CDROM) has donated almost more than we can say (see the 'About the FreeBSD Project' section of the extref:{handbook}[FreeBSD Handbook] for more details). In particular, we would like to thank them for the original hardware used for `freefall.FreeBSD.org`, our primary development machine, and for `thud.FreeBSD.org`, a testing and build box. We are also indebted to them for funding various contributors over the years and providing us with unrestricted use of their T1 connection to the Internet.
	** The http://www.interface-business.de/[interface business GmbH, Dresden] has been patiently supporting {joerg} who has often preferred FreeBSD work over paid work, and used to fall back to their (quite expensive) EUnet Internet connection whenever his private connection became too slow or flaky to work with it...
	** http://www.bsdi.com/[Berkeley Software Design, Inc.] has contributed their DOS emulator code to the remaining BSD world, which is used in the _doscmd_ command.

	diff --git a/documentation/content/en/articles/cups/_index.adoc b/documentation/content/en/articles/cups/_index.adoc
	--- a/documentation/content/en/articles/cups/_index.adoc
	+++ b/documentation/content/en/articles/cups/_index.adoc
	@@ -14,9 +14,23 @@
	:toclevels: 1
	:icons: font
	:sectnums:
	+:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:sectnumlevels: 6
	+:images-path: articles/cups/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Abstract
	diff --git a/documentation/content/en/articles/explaining-bsd/_index.adoc b/documentation/content/en/articles/explaining-bsd/_index.adoc
	--- a/documentation/content/en/articles/explaining-bsd/_index.adoc
	+++ b/documentation/content/en/articles/explaining-bsd/_index.adoc
	@@ -14,9 +14,23 @@
	:toclevels: 1
	:icons: font
	:sectnums:
	+:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:sectnumlevels: 6
	+:images-path: articles/explaining-bsd/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Abstract
	diff --git a/documentation/content/en/articles/filtering-bridges/_index.adoc b/documentation/content/en/articles/filtering-bridges/_index.adoc
	--- a/documentation/content/en/articles/filtering-bridges/_index.adoc
	+++ b/documentation/content/en/articles/filtering-bridges/_index.adoc
	@@ -14,20 +14,22 @@
	:toclevels: 1
	:icons: font
	:sectnums:
	+:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:sectnumlevels: 6
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/en/urls.adoc[]
	+:images-path: articles/filtering-bridges/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -87,7 +89,7 @@
	The first line is to compile the bridge support, the second one is the firewall and the third one is the logging functions of the firewall.

	Now it is necessary to build and install the new kernel.
	-You may find detailed instructions in the link:{handbook}#kernelconfig-building[Building and Installing a Custom Kernel] section of the FreeBSD Handbook.
	+You may find detailed instructions in the extref:{handbook}[Building and Installing a Custom Kernel, kernelconfig-building] section of the FreeBSD Handbook.

	[[filtering-bridges-modules]]
	=== Modules Loading
	diff --git a/documentation/content/en/articles/fonts/_index.adoc b/documentation/content/en/articles/fonts/_index.adoc
	--- a/documentation/content/en/articles/fonts/_index.adoc
	+++ b/documentation/content/en/articles/fonts/_index.adoc
	@@ -15,9 +15,23 @@
	:toclevels: 1
	:icons: font
	:sectnums:
	+:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:sectnumlevels: 6
	+:images-path: articles/fonts/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Abstract
	diff --git a/documentation/content/en/articles/freebsd-questions/_index.adoc b/documentation/content/en/articles/freebsd-questions/_index.adoc
	--- a/documentation/content/en/articles/freebsd-questions/_index.adoc
	+++ b/documentation/content/en/articles/freebsd-questions/_index.adoc
	@@ -17,20 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+:images-path: articles/freebsd-questions/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -146,7 +145,7 @@
	. If the question relates to a bug, and you are _sure_ that it is a bug (for example, you can pinpoint the place in the code where it happens, and you maybe have a fix), then send the message to `FreeBSD-hackers`.
	. If the question relates to enhancements to FreeBSD, and you can make suggestions about how to implement them, then send the message to `FreeBSD-hackers`.

	-There are also a number of other link:{handbook}#eresources-mail[specialized mailing lists], which caters to more specific interests.
	+There are also a number of other extref:{handbook}[specialized mailing lists, eresources-mail], which caters to more specific interests.
	The criteria above still apply, and it is in your interest to stick to them, since you are more likely to get good results that way.

	== Before Submitting a Question
	@@ -154,7 +153,7 @@
	You can (and should) do some things yourself before asking a question on one of the mailing lists:

	* Try solving the problem on your own. If you post a question which shows that you have tried to solve the problem, your question will generally attract more positive attention from people reading it. Trying to solve the problem yourself will also enhance your understanding of FreeBSD, and will eventually let you use your knowledge to help others by answering questions posted to the mailing lists.
	-* Read the manual pages, and the FreeBSD documentation (either installed in [.filename]#/usr/doc# or accessible via WWW at http://www.FreeBSD.org[http://www.FreeBSD.org]), especially the link:{handbook}[handbook] and the link:{faq}[FAQ].
	+* Read the manual pages, and the FreeBSD documentation (either installed in [.filename]#/usr/doc# or accessible via WWW at http://www.FreeBSD.org[http://www.FreeBSD.org]), especially the extref:{handbook}[handbook] and the extref:{faq}[FAQ].
	* Browse and/or search the archives for the mailing list, to see if your question or a similar one has been asked (and possibly answered) on the list. You can browse and/or search the mailing list archives at https://www.FreeBSD.org/mail[https://www.FreeBSD.org/mail] and https://www.FreeBSD.org/search/#mailinglists[https://www.FreeBSD.org/search/#mailinglists] respectively. This can be done at other WWW sites as well, for example at http://marc.theaimsgroup.com[http://marc.theaimsgroup.com].
	* Use a search engine such as http://www.google.com[Google] or http://www.yahoo.com[Yahoo] to find answers to your question.

	diff --git a/documentation/content/en/articles/freebsd-releng/_index.adoc b/documentation/content/en/articles/freebsd-releng/_index.adoc
	--- a/documentation/content/en/articles/freebsd-releng/_index.adoc
	+++ b/documentation/content/en/articles/freebsd-releng/_index.adoc
	@@ -36,6 +36,33 @@
	:branchReleasex: release/12.0.0/
	:branchRevision: 12.0

	+:images-path: articles/freebsd-releng/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]
	+
	[.abstract-title]
	Abstract

	diff --git a/documentation/content/en/articles/freebsd-src-lsp/_index.adoc b/documentation/content/en/articles/freebsd-src-lsp/_index.adoc
	--- a/documentation/content/en/articles/freebsd-src-lsp/_index.adoc
	+++ b/documentation/content/en/articles/freebsd-src-lsp/_index.adoc
	@@ -13,12 +13,26 @@
	= Use Language Servers for Development in the FreeBSD Src Tree
	:doctype: article
	:toc: macro
	-:toclevels: 2
	+:toclevels: 1
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/freebsd-src-lsp/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/articles/freebsd-update-server/_index.adoc b/documentation/content/en/articles/freebsd-update-server/_index.adoc
	--- a/documentation/content/en/articles/freebsd-update-server/_index.adoc
	+++ b/documentation/content/en/articles/freebsd-update-server/_index.adoc
	@@ -18,20 +18,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/freebsd-update-server/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -72,7 +71,7 @@
	====
	* A user account with at least 4 GB of available space. This will allow the creation of updates for 7.1 and 7.2, but the exact space requirements may change from version to version.
	* An man:ssh[1] account on a remote machine to upload distributed updates.
	-* A web server, like link:{handbook}#network-apache[Apache], with over half of the space required for the build. For instance, test builds for 7.1 and 7.2 consume a total amount of 4 GB, and the webserver space needed to distribute these updates is 2.6 GB.
	+* A web server, like extref:{handbook}[Apache, network-apache], with over half of the space required for the build. For instance, test builds for 7.1 and 7.2 consume a total amount of 4 GB, and the webserver space needed to distribute these updates is 2.6 GB.
	* Basic knowledge of shell scripting with Bourne shell, man:sh[1].

	[[Configuration]]
	@@ -386,9 +385,9 @@

	The uploaded files will need to be in the document root of the webserver in order for updates to be distributed.
	The exact configuration will vary depending on the web server used.
	-For the Apache web server, please refer to the link:{handbook}#network-apache[Configuration of Apache servers] section in the Handbook.
	+For the Apache web server, please refer to the extref:{handbook}[Configuration of Apache servers, network-apache] section in the Handbook.

	-Update client's `KeyPrint` and `ServerName` in [.filename]#/etc/freebsd-update.conf#, and perform updates as instructed in the link:{handbook}#updating-upgrading-freebsdupdate[FreeBSD Update] section of the Handbook.
	+Update client's `KeyPrint` and `ServerName` in [.filename]#/etc/freebsd-update.conf#, and perform updates as instructed in the extref:{handbook}[FreeBSD Update, updating-upgrading-freebsdupdate] section of the Handbook.

	[IMPORTANT]
	====
	@@ -421,7 +420,7 @@

	As an example, take the patch for man:named[8].
	Read the advisory, and grab the necessary file from link:https://www.FreeBSD.org/security/advisories/[FreeBSD Security Advisories].
	-More information on interpreting the advisory, can be found in the link:{handbook}#security-advisories[FreeBSD Handbook].
	+More information on interpreting the advisory, can be found in the extref:{handbook}[FreeBSD Handbook, security-advisories].

	In the https://security.freebsd.org/advisories/FreeBSD-SA-09:12.bind.asc[security brief], this advisory is called `SA-09:12.bind`.
	After downloading the file, it is required to rename the file to an appropriate patch level.
	@@ -586,7 +585,7 @@
	[[tips]]
	== Tips

	-* If a custom release is built using the native `make release` link:{releng}#release-build[procedure], freebsd-update-server code will work from your release. As an example, a release without ports or documentation can be built by clearing functionality pertaining to documentation subroutines `findextradocs ()`, `addextradocs ()` and altering the download location in `fetchiso ()`, respectively, in [.filename]#scripts/build.subr#. As a last step, change the man:sha256[1] hash in [.filename]#build.conf# under your respective release and architecture and you are ready to build off your custom release.
	+* If a custom release is built using the native `make release` extref:{releng}[procedure, release-build], freebsd-update-server code will work from your release. As an example, a release without ports or documentation can be built by clearing functionality pertaining to documentation subroutines `findextradocs ()`, `addextradocs ()` and altering the download location in `fetchiso ()`, respectively, in [.filename]#scripts/build.subr#. As a last step, change the man:sha256[1] hash in [.filename]#build.conf# under your respective release and architecture and you are ready to build off your custom release.
	+
	[.programlisting]
	....
	@@ -615,7 +614,7 @@
	make ${COMPATFLAGS} release.1 release.2 2>&1
	....

	-* Create an appropriate link:{handbook}#network-dns[DNS] SRV record for the update server, and put others behind it with variable weights. Using this facility will provide update mirrors, however this tip is not necessary unless you wish to provide a redundant service.
	+* Create an appropriate extref:{handbook}[DNS, network-dns] SRV record for the update server, and put others behind it with variable weights. Using this facility will provide update mirrors, however this tip is not necessary unless you wish to provide a redundant service.
	+
	[.programlisting]
	....
	diff --git a/documentation/content/en/articles/geom-class/_index.adoc b/documentation/content/en/articles/geom-class/_index.adoc
	--- a/documentation/content/en/articles/geom-class/_index.adoc
	+++ b/documentation/content/en/articles/geom-class/_index.adoc
	@@ -17,17 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/en/urls.adoc[]
	+:images-path: articles/geom-class/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -49,8 +51,8 @@
	Documentation on kernel programming is scarce - it is one of few areas where there is nearly nothing in the way of friendly tutorials, and the phrase "use the source!" really holds true.
	However, there are some bits and pieces (some of them seriously outdated) floating around that should be studied before beginning to code:

	-* The link:{developers-handbook}[FreeBSD Developer's Handbook] - part of the documentation project, it does not contain anything specific to kernel programming, but rather some general useful information.
	-* The link:{arch-handbook}[FreeBSD Architecture Handbook] - also from the documentation project, contains descriptions of several low-level facilities and procedures. The most important chapter is 13, link:{arch-handbook}#driverbasics[Writing FreeBSD device drivers].
	+* The extref:{developers-handbook}[FreeBSD Developer's Handbook] - part of the documentation project, it does not contain anything specific to kernel programming, but rather some general useful information.
	+* The extref:{arch-handbook}[FreeBSD Architecture Handbook] - also from the documentation project, contains descriptions of several low-level facilities and procedures. The most important chapter is 13, extref:{arch-handbook}[Writing FreeBSD device drivers, driverbasics].
	* The Blueprints section of http://www.freebsddiary.org[FreeBSD Diary] web site - contains several interesting articles on kernel facilities.
	* The man pages in section 9 - for important documentation on kernel functions.
	* The man:geom[4] man page and http://phk.freebsd.dk/pubs/[PHK's GEOM slides] - for general introduction of the GEOM subsystem.
	diff --git a/documentation/content/en/articles/gjournal-desktop/_index.adoc b/documentation/content/en/articles/gjournal-desktop/_index.adoc
	--- a/documentation/content/en/articles/gjournal-desktop/_index.adoc
	+++ b/documentation/content/en/articles/gjournal-desktop/_index.adoc
	@@ -17,35 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/gjournal-desktop/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../images/articles/gjournal-desktop/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -380,7 +364,7 @@
	options GEOM_JOURNAL # You will have to add this one
	....

	-Rebuild and reinstall your kernel following the relevant link:{handbook}#kernelconfig[instructions in the FreeBSD Handbook.]
	+Rebuild and reinstall your kernel following the relevant extref:{handbook}[instructions in the FreeBSD Handbook., kernelconfig]

	Do not forget to remove the relevant "load" entry from [.filename]#/boot/loader.conf# if you have previously used it.

	@@ -513,7 +497,7 @@
	Journaling is a fairly new feature of FreeBSD, and as such, it is not very well documented yet.
	You may however find the following additional references useful:

	-* A link:{handbook}#geom-gjournal[new section on journaling] is now part of the FreeBSD Handbook.
	+* A extref:{handbook}[new section on journaling, geom-gjournal] is now part of the FreeBSD Handbook.
	* https://lists.freebsd.org/pipermail/freebsd-current/2006-June/064043.html[This post] in {freebsd-current} by man:gjournal[8]'s developer, `{pjd}`.
	* https://lists.freebsd.org/pipermail/freebsd-questions/2008-April/173501.html[This post] in {freebsd-questions} by `{ivoras}`.
	* The manual pages of man:gjournal[8] and man:geom[8].
	diff --git a/documentation/content/en/articles/hubs/_index.adoc b/documentation/content/en/articles/hubs/_index.adoc
	--- a/documentation/content/en/articles/hubs/_index.adoc
	+++ b/documentation/content/en/articles/hubs/_index.adoc
	@@ -23,23 +23,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/hubs/

	-ifeval::["{backend}" == "html5"]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/urls.adoc[]
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-include::../../../../shared/releases.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-include::../../../../shared/releases.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -366,7 +362,7 @@
	* provide FTP and rsync access

	Furthermore, admins should be subscribed to the {freebsd-hubs}.
	-See link:{handbook}#eresources-mail[this link] for details, how to subscribe.
	+See extref:{handbook}[this link, eresources-mail] for details, how to subscribe.

	[IMPORTANT]
	====
	diff --git a/documentation/content/en/articles/ipsec-must/_index.adoc b/documentation/content/en/articles/ipsec-must/_index.adoc
	--- a/documentation/content/en/articles/ipsec-must/_index.adoc
	+++ b/documentation/content/en/articles/ipsec-must/_index.adoc
	@@ -17,17 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/en/urls.adoc[]
	+:images-path: articles/ipsec-must/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -134,7 +136,7 @@
	Most of the modern versions of FreeBSD have IPsec support in their base source.
	So you will need to include the `IPSEC` option in your kernel config and, after kernel rebuild and reinstall, configure IPsec connections using man:setkey[8] command.

	-A comprehensive guide on running IPsec on FreeBSD is provided in link:{handbook}#ipsec[FreeBSD Handbook].
	+A comprehensive guide on running IPsec on FreeBSD is provided in extref:{handbook}[FreeBSD Handbook, ipsec].

	[[kernel]]
	== src/sys/i386/conf/KERNELNAME
	diff --git a/documentation/content/en/articles/ldap-auth/_index.adoc b/documentation/content/en/articles/ldap-auth/_index.adoc
	--- a/documentation/content/en/articles/ldap-auth/_index.adoc
	+++ b/documentation/content/en/articles/ldap-auth/_index.adoc
	@@ -18,6 +18,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/ldap-auth/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Abstract
	diff --git a/documentation/content/en/articles/leap-seconds/_index.adoc b/documentation/content/en/articles/leap-seconds/_index.adoc
	--- a/documentation/content/en/articles/leap-seconds/_index.adoc
	+++ b/documentation/content/en/articles/leap-seconds/_index.adoc
	@@ -13,17 +13,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/en/urls.adoc[]
	+:images-path: articles/leap-seconds/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	@@ -47,7 +49,7 @@
	[[leapseconds-posix]]
	== Default Leap Second Handling on FreeBSD

	-The easiest way to handle leap seconds is with the POSIX time rules FreeBSD uses by default, combined with link:{handbook}#network-ntp[NTP].
	+The easiest way to handle leap seconds is with the POSIX time rules FreeBSD uses by default, combined with extref:{handbook}[NTP, network-ntp].
	When man:ntpd[8] is running and the time is synchronized with upstream NTP servers that handle leap seconds correctly, the leap second will cause the system time to automatically repeat the last second of the day.
	No other adjustments are necessary.

	diff --git a/documentation/content/en/articles/linux-emulation/_index.adoc b/documentation/content/en/articles/linux-emulation/_index.adoc
	--- a/documentation/content/en/articles/linux-emulation/_index.adoc
	+++ b/documentation/content/en/articles/linux-emulation/_index.adoc
	@@ -17,17 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/linux-emulation/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/en/articles/linux-users/_index.adoc b/documentation/content/en/articles/linux-users/_index.adoc
	--- a/documentation/content/en/articles/linux-users/_index.adoc
	+++ b/documentation/content/en/articles/linux-users/_index.adoc
	@@ -17,17 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/en/urls.adoc[]
	+:images-path: articles/linux-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -45,7 +47,7 @@
	This document highlights some of the technical differences between FreeBSD and Linux(R) so that intermediate to advanced Linux(R) users can quickly familiarize themselves with the basics of FreeBSD.

	This document assumes that FreeBSD is already installed.
	-Refer to the link:{handbook}#bsdinstall[Installing FreeBSD] chapter of the FreeBSD Handbook for help with the installation process.
	+Refer to the extref:{handbook}[Installing FreeBSD, bsdinstall] chapter of the FreeBSD Handbook for help with the installation process.

	[[shells]]
	== Default Shell
	@@ -56,7 +58,7 @@
	man:sh[1] is very similar to Bash but with a much smaller feature-set.
	Generally shell scripts written for man:sh[1] will run in Bash, but the reverse is not always true.

	-However, Bash and other shells are available for installation using the FreeBSD link:{handbook}#ports[Packages and Ports Collection].
	+However, Bash and other shells are available for installation using the FreeBSD extref:{handbook}[Packages and Ports Collection, ports].

	After installing another shell, use man:chsh[1] to change a user's default shell.
	It is recommended that the `root` user's default shell remain unchanged since shells which are not included in the base distribution are installed to [.filename]#/usr/local/bin#.
	@@ -96,7 +98,7 @@
	# pkg install apache24
	....

	-For more information on packages refer to section 5.4 of the FreeBSD Handbook: link:{handbook}#pkgng-intro[Using pkgng for Binary Package Management].
	+For more information on packages refer to section 5.4 of the FreeBSD Handbook: extref:{handbook}[Using pkgng for Binary Package Management, pkgng-intro].

	[[ports]]
	=== Ports
	@@ -105,7 +107,7 @@
	When installing a port, the system will fetch the source code, apply any required patches, compile the code, and install the application and any required dependencies.

	The Ports Collection, sometimes referred to as the ports tree, can be installed to [.filename]#/usr/ports# using man:portsnap[8].
	-Detailed instructions for installing the Ports Collection can be found in link:{handbook}#ports-using[section 5.5] of the FreeBSD Handbook.
	+Detailed instructions for installing the Ports Collection can be found in extref:{handbook}[section 5.5, ports-using] of the FreeBSD Handbook.

	To compile a port, change to the port's directory and start the build process. The following example installs Apache 2.4 from the Ports Collection:

	@@ -124,7 +126,7 @@
	# make WITH_LDAP="YES" install clean
	....

	-Refer to link:{handbook}#ports-using[Using the Ports Collection] for more information.
	+Refer to extref:{handbook}[Using the Ports Collection, ports-using] for more information.

	[[startup]]
	== System Startup
	@@ -139,7 +141,7 @@
	The scripts in [.filename]#/usr/local/etc/rc.d/# are for user-installed applications such as Apache and Squid.

	Since FreeBSD is developed as a complete operating system, user-installed applications are not considered to be part of the "base" system.
	-User-installed applications are generally installed using link:{handbook}#ports-using[Packages or Ports].
	+User-installed applications are generally installed using extref:{handbook}[Packages or Ports, ports-using].
	In order to keep them separate from the base system, user-installed applications are installed under [.filename]#/usr/local/#.
	Therefore, user-installed binaries reside in [.filename]#/usr/local/bin/#, configuration files are in [.filename]#/usr/local/etc/#, and so on.

	@@ -222,9 +224,9 @@
	FreeBSD does not use Linux(R) IPTABLES for its firewall.
	Instead, FreeBSD offers a choice of three kernel level firewalls:

	-* link:{handbook}#firewalls-pf[PF]
	-* link:{handbook}#firewalls-ipf[IPFILTER]
	-* link:{handbook}#firewalls-ipfw[IPFW]
	+* extref:{handbook}[PF, firewalls-pf]
	+* extref:{handbook}[IPFILTER, firewalls-ipf]
	+* extref:{handbook}[IPFW, firewalls-ipfw]

	PF is developed by the OpenBSD project and ported to FreeBSD.
	PF was created as a replacement for IPFILTER and its syntax is similar to that of IPFILTER.
	@@ -281,7 +283,7 @@

	====

	-For more information on source and binary updates, refer to link:{handbook}#updating-upgrading[the chapter on updating] in the FreeBSD Handbook.
	+For more information on source and binary updates, refer to extref:{handbook}[the chapter on updating, updating-upgrading] in the FreeBSD Handbook.

	[[procfs]]
	== procfs: Gone But Not Forgotten
	@@ -365,4 +367,4 @@
	== Conclusion

	This document has provided an overview of FreeBSD.
	-Refer to the link:{handbook}[FreeBSD Handbook] for more in-depth coverage of these topics as well as the many topics not covered by this document.
	+Refer to the extref:{handbook}[FreeBSD Handbook] for more in-depth coverage of these topics as well as the many topics not covered by this document.
	diff --git a/documentation/content/en/articles/mailing-list-faq/_index.adoc b/documentation/content/en/articles/mailing-list-faq/_index.adoc
	--- a/documentation/content/en/articles/mailing-list-faq/_index.adoc
	+++ b/documentation/content/en/articles/mailing-list-faq/_index.adoc
	@@ -16,23 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/mailing-list-faq/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -110,7 +106,7 @@

	You have already taken the most important step by reading this document.
	However, if you are new to FreeBSD, you may first need to familiarize yourself with the software, and all the social history around it, by reading the numerous link:https://www.FreeBSD.org/docs/books/[books and articles] that are available.
	-Items of particular interest include the link:{faq}[FreeBSD Frequently Asked Questions (FAQ)] document, the link:{handbook}[FreeBSD Handbook], and the articles link:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list], link:{explaining-bsd}[Explaining BSD], and link:{new-users}[FreeBSD First Steps].
	+Items of particular interest include the extref:{faq}[FreeBSD Frequently Asked Questions (FAQ)] document, the extref:{handbook}[FreeBSD Handbook], and the articles extref:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list], extref:{explaining-bsd}[Explaining BSD], and extref:{new-users}[FreeBSD First Steps].

	It is always considered bad form to ask a question that is already answered in the above documents.
	This is not because the volunteers who work on this project are particularly mean people, but after a certain number of times answering the same questions over and over again, frustration begins to set in.
	@@ -188,7 +184,7 @@
	== What Is A "Bikeshed"?

	Literally, a `bikeshed` is a small outdoor shelter into which one may store one's two-wheeled form of transportation.
	-However, in FreeBSD parlance, the term refers to topics that are simple enough that (nearly) anyone can offer an opinion about, and often (nearly) everyone does. The genesis of this term is explained in more detail link:{faq}#bikeshed-painting[in this document].
	+However, in FreeBSD parlance, the term refers to topics that are simple enough that (nearly) anyone can offer an opinion about, and often (nearly) everyone does. The genesis of this term is explained in more detail extref:{faq}[in this document, bikeshed-painting].
	You simply must have a working knowledge of this concept before posting to any FreeBSD mailing list.

	More generally, a bikeshed is a topic that will tend to generate immediate meta-discussions and flames if you have not read up on their past history.
	@@ -200,7 +196,7 @@
	== Acknowledgments

	`{grog}`::
	-Original author of most of the material on mailing list etiquette, taken from the article on link:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list].
	+Original author of most of the material on mailing list etiquette, taken from the article on extref:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list].

	`{linimon}`::
	Creation of the rough draft of this FAQ.
	diff --git a/documentation/content/en/articles/nanobsd/_index.adoc b/documentation/content/en/articles/nanobsd/_index.adoc
	--- a/documentation/content/en/articles/nanobsd/_index.adoc
	+++ b/documentation/content/en/articles/nanobsd/_index.adoc
	@@ -17,20 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/nanobsd/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -243,7 +242,7 @@
	With `NANO_BOOTLOADER` a bootloader file can be chosen.
	The most common possible options are between [.filename]#boot0sio# and [.filename]#boot0# depending on whether the appliance has a serial port or not.
	It is best to avoid supplying a different bootloader, but it is possible.
	-To do so, it is best to have checked the link:{handbook}boot/[FreeBSD Handbook] chapter on the boot process.
	+To do so, it is best to have checked the extref:{handbook}boot[FreeBSD Handbook] chapter on the boot process.

	With `NANO_BOOT0CFG`, the booting process can be tweaked, like selecting on which partition the NanoBSD image will actually boot.
	It is best to check the man:boot0cfg[8] page before changing the default value of this variable.
	@@ -266,7 +265,7 @@
	* The `NANO_MEDIASIZE` variable must be set to the size (in 512 bytes sectors) of the storage media that will be used. If you set it wrong, it is possible that the NanoBSD image will not boot at all, and a message at boot time will be warning about incorrect disk geometry.

	* The [.filename]#/etc#, [.filename]#/var#, and [.filename]#/tmp# directories are allocated as man:md[4] (malloc) disks at boot time; so their sizes can be tailored to suit the appliance needs. The `NANO_RAM_ETCSIZE` variable sets the size of the [.filename]#/etc#; and the `NANO_RAM_TMPVARSIZE` variable sets the size of both the [.filename]#/var# and [.filename]#/tmp# directory, as [.filename]#/tmp# is symbolically linked to [.filename]#/var/tmp#. By default, both malloc disks sizes are set at 20MB each. They can always be changed, but usually the [.filename]#/etc# does not grow too much in size, so 20MB is a good starting point, whereas the [.filename]#/var# and especially [.filename]#/tmp# can grow much larger if not careful about it. For memory constrained systems, smaller filesystem sizes may be chosen.
	-* As NanoBSD is mainly designed to build a system image for an appliance, it is assumed that the storage media used will be relatively small. For that reason, the filesystem that is laid out is configured to have a small block size (4Kb) and a small fragment size (512b). The configuration options of the filesystem can be modified through the `NANO_NEWFS` variable, but the syntax must respect the man:newfs[8] command format. Also, by default, the filesystem has Soft Updates enabled. The link:{handbook}[FreeBSD Handbook] can be checked about this.
	+* As NanoBSD is mainly designed to build a system image for an appliance, it is assumed that the storage media used will be relatively small. For that reason, the filesystem that is laid out is configured to have a small block size (4Kb) and a small fragment size (512b). The configuration options of the filesystem can be modified through the `NANO_NEWFS` variable, but the syntax must respect the man:newfs[8] command format. Also, by default, the filesystem has Soft Updates enabled. The extref:{handbook}[FreeBSD Handbook] can be checked about this.
	* The different partition sizes can be set through the use of `NANO_CODESIZE`, `NANO_CONFSIZE`, and `NANO_DATASIZE` as a multiple of 512 bytes sectors. `NANO_CODESIZE` defines the size of the first two image partitions: `code#1` and `code#2`. They have to be big enough to hold all the files that will be produced as a result of the `buildworld` and `buildkernel` processes. `NANO_CONFSIZE` defines the size of the configuration file partition, so it does not need to be very big; but do not make it so small that it will not hold all configuration files. Finally, `NANO_DATASIZE` defines the size of an optional partition, that can be used on the appliance. The last partition can be used, for example, to keep files created on the fly on disk.

	==== Custom Functions
	diff --git a/documentation/content/en/articles/new-users/_index.adoc b/documentation/content/en/articles/new-users/_index.adoc
	--- a/documentation/content/en/articles/new-users/_index.adoc
	+++ b/documentation/content/en/articles/new-users/_index.adoc
	@@ -17,6 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/new-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Abstract
	diff --git a/documentation/content/en/articles/pam/_index.adoc b/documentation/content/en/articles/pam/_index.adoc
	--- a/documentation/content/en/articles/pam/_index.adoc
	+++ b/documentation/content/en/articles/pam/_index.adoc
	@@ -17,6 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/pam/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Abstract
	diff --git a/documentation/content/en/articles/pgpkeys/_index.adoc b/documentation/content/en/articles/pgpkeys/_index.adoc
	--- a/documentation/content/en/articles/pgpkeys/_index.adoc
	+++ b/documentation/content/en/articles/pgpkeys/_index.adoc
	@@ -13,28 +13,26 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/pgpkeys/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/en/teams.adoc[lines=16..-1]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	:include-path: static/pgpkeys/
	endif::[]

	// PGP keys are not included during the build
	// See 29e47423be969b7fcc7125977c1b22ddd33fc671 revision
	// (a wrong path is used as a workaround)
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/teams.adoc[lines=16..-1]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	:include-path: ../../../static/pgpkeys/
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/teams.adoc[lines=16..-1]
	-:include-path: ../../../../static/pgpkeys/
	-endif::[]
	-
	'''

	toc::[]
	diff --git a/documentation/content/en/articles/port-mentor-guidelines/_index.adoc b/documentation/content/en/articles/port-mentor-guidelines/_index.adoc
	--- a/documentation/content/en/articles/port-mentor-guidelines/_index.adoc
	+++ b/documentation/content/en/articles/port-mentor-guidelines/_index.adoc
	@@ -16,17 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/en/urls.adoc[]
	+:images-path: articles/port-mentor-guidelines/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	@@ -71,7 +73,7 @@
	We expect that mentors should take responsibility for the actions of their mentee.
	A mentor should follow up with all commits the mentee makes, both approved and implicit.

	-We expect mentors to make sure their mentees read the link:{porters-handbook}[Porter's Handbook], the link:{pr-guidelines}[PR handling guide], and the link:{committers-guide}[Committer's Guide].
	+We expect mentors to make sure their mentees read the extref:{porters-handbook}[Porter's Handbook], the extref:{pr-guidelines}[PR handling guide], and the extref:{committers-guide}[Committer's Guide].
	While it is not necessary to memorize all the details, every committer needs to have an overview of these things to be an effective part of the community (and avoid as many rookie mistakes as possible).

	[[mentees]]
	diff --git a/documentation/content/en/articles/pr-guidelines/_index.adoc b/documentation/content/en/articles/pr-guidelines/_index.adoc
	--- a/documentation/content/en/articles/pr-guidelines/_index.adoc
	+++ b/documentation/content/en/articles/pr-guidelines/_index.adoc
	@@ -17,20 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+:images-path: articles/pr-guidelines/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -506,4 +505,4 @@
	This is a list of resources relevant to the proper writing and processing of problem reports.
	It is by no means complete.

	-* link:{problem-reports}[How to Write FreeBSD Problem Reports]-guidelines for PR originators.
	+* extref:{problem-reports}[How to Write FreeBSD Problem Reports]-guidelines for PR originators.
	diff --git a/documentation/content/en/articles/problem-reports/_index.adoc b/documentation/content/en/articles/problem-reports/_index.adoc
	--- a/documentation/content/en/articles/problem-reports/_index.adoc
	+++ b/documentation/content/en/articles/problem-reports/_index.adoc
	@@ -17,20 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+:images-path: articles/problem-reports/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -72,7 +71,7 @@

	* Please do not submit problem reports that simply state that a newer version of an application is available. Ports maintainers are automatically notified by portscout when a new version of an application becomes available. Actual patches to update a port to the latest version are welcome.
	* For unmaintained ports (`MAINTAINER` is `ports@FreeBSD.org`), a PR without an included patch is unlikely to get picked up by a committer. To become the maintainer of an unmaintained port, submit a PR with the request (patch preferred but not required).
	-* In either case, following the process described in link:{porters-handbook}#port-upgrading[Porter's Handbook] will yield the best results. (You might also wish to read link:{contributing}#ports-contributing[Contributing to the FreeBSD Ports Collection].)
	+* In either case, following the process described in extref:{porters-handbook}[Porter's Handbook, port-upgrading] will yield the best results. (You might also wish to read extref:{contributing}[Contributing to the FreeBSD Ports Collection, ports-contributing].)

	A bug that cannot be reproduced can rarely be fixed.
	If the bug only occurred once and you cannot reproduce it, and it does not seem to happen to anybody else, chances are none of the developers will be able to reproduce it or figure out what is wrong.
	@@ -88,7 +87,7 @@
	Then, ascertain whether the problem is timely.
	There are few things that will annoy a developer more than receiving a problem report about a bug she has already fixed.

	-If the problem is in the base system, first read the FAQ section on link:{faq}#LATEST-VERSION[FreeBSD versions], if you are not already familiar with the topic.
	+If the problem is in the base system, first read the FAQ section on extref:{faq}[FreeBSD versions, LATEST-VERSION], if you are not already familiar with the topic.
	It is not possible for FreeBSD to fix problems in anything other than certain recent branches of the base system, so filing a bug report about an older version will probably only result in a developer advising you to upgrade to a supported version to see if the problem still recurs.
	The Security Officer team maintains the link:https://www.FreeBSD.org/security/[list of supported versions].

	@@ -103,8 +102,8 @@
	You should therefore check all the obvious places before submitting your problem report.
	For FreeBSD, this means:

	-* The FreeBSD link:{faq}[Frequently Asked Questions] (FAQ) list. The FAQ attempts to provide answers for a wide range of questions, such as those concerning link:{faq}#hardware[hardware compatibility], link:{faq}#applications[user applications], and link:{faq}#kernelconfig[kernel configuration].
	-* The link:{handbook}#eresources-mail[mailing lists]-if you are not subscribed, use https://www.FreeBSD.org/search/#mailinglists[the searchable archives] on the FreeBSD web site. If the problem has not been discussed on the lists, you might try posting a message about it and waiting a few days to see if someone can spot something that has been overlooked.
	+* The FreeBSD extref:{faq}[Frequently Asked Questions] (FAQ) list. The FAQ attempts to provide answers for a wide range of questions, such as those concerning extref:{faq}[hardware compatibility, hardware], extref:{faq}[user applications, applications], and extref:{faq}[kernel configuration, kernelconfig].
	+* The extref:{handbook}[mailing lists, eresources-mail]-if you are not subscribed, use https://www.FreeBSD.org/search/#mailinglists[the searchable archives] on the FreeBSD web site. If the problem has not been discussed on the lists, you might try posting a message about it and waiting a few days to see if someone can spot something that has been overlooked.
	* Optionally, the entire web-use your favorite search engine to locate any references to the problem. You may even get hits from archived mailing lists or newsgroups you did not know of or had not thought to search through.
	* Next, the searchable https://bugs.freebsd.org/bugzilla/query.cgi[FreeBSD PR database] (Bugzilla). Unless the problem is recent or obscure, there is a fair chance it has already been reported.
	* Most importantly, attempt to see if existing documentation in the source base addresses your problem.
	@@ -260,9 +259,9 @@

	There are a few ways to do so, ideally in the following order, with a few days between attempting each communication channel:

	-* Find the relevant FreeBSD mailing list for the problem report from the link:{handbook}#eresources-mail[list in the Handbook] and send a message to that list asking about assistance or comments on the problem report.
	+* Find the relevant FreeBSD mailing list for the problem report from the extref:{handbook}[list in the Handbook, eresources-mail] and send a message to that list asking about assistance or comments on the problem report.
	* Join the relevant IRC channels. A partial listing is here: https://wiki.freebsd.org/IrcChannels[]. Inform the people in that channel about the problem report and ask for assistance. Be patient and stay in the channel after posting, so that the people from different time zones around the world have a chance to catch up.
	-* Find committers interested in the problem that was reported. If the problem was in a particular tool, binary, port, document, or source file, check the https://cgit.FreeBSD.org[Git Repository]. Locate the last few committers who made substantive changes to the file, and try to reach them via IRC or email. A list of committers and their emails can be found in the link:{contributors}[Contributors to FreeBSD] article.
	+* Find committers interested in the problem that was reported. If the problem was in a particular tool, binary, port, document, or source file, check the https://cgit.FreeBSD.org[Git Repository]. Locate the last few committers who made substantive changes to the file, and try to reach them via IRC or email. A list of committers and their emails can be found in the extref:{contributors}[Contributors to FreeBSD] article.

	Remember that these people are volunteers, just like maintainers and users, so they might not be immediately available to assist with the problem report.
	Patience and consistency in the follow-ups is highly advised and appreciated.
	@@ -281,4 +280,4 @@
	It is by no means complete.

	* https://github.com/smileytechguy/reporting-bugs-effectively/blob/master/ENGLISH.md[How to Report Bugs Effectively]-an excellent essay by Simon G. Tatham on composing useful (non-FreeBSD-specific) problem reports.
	-* link:{pr-guidelines}[Problem Report Handling Guidelines]-valuable insight into how problem reports are handled by the FreeBSD developers.
	+* extref:{pr-guidelines}[Problem Report Handling Guidelines]-valuable insight into how problem reports are handled by the FreeBSD developers.
	diff --git a/documentation/content/en/articles/rc-scripting/_index.adoc b/documentation/content/en/articles/rc-scripting/_index.adoc
	--- a/documentation/content/en/articles/rc-scripting/_index.adoc
	+++ b/documentation/content/en/articles/rc-scripting/_index.adoc
	@@ -18,17 +18,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/en/urls.adoc[]
	+:images-path: articles/rc-scripting/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -578,7 +580,7 @@
	The crucial step is to install the script in [.filename]#/etc/rc.d# (for the base system) or [.filename]#/usr/local/etc/rc.d# (for ports).
	Both [.filename]#bsd.prog.mk# and [.filename]#bsd.port.mk# provide convenient hooks for that, and usually you do not have to worry about the proper ownership and mode.
	System scripts should be installed from [.filename]#src/etc/rc.d# through the [.filename]#Makefile# found there.
	-Port scripts can be installed using `USE_RC_SUBR` as described link:{porters-handbook}#rc-scripts[in the Porter's Handbook].
	+Port scripts can be installed using `USE_RC_SUBR` as described extref:{porters-handbook}[in the Porter's Handbook, rc-scripts].

	However, we should consider beforehand the place of our script in the system startup sequence.
	The service handled by our script is likely to depend on other services.
	diff --git a/documentation/content/en/articles/releng/_index.adoc b/documentation/content/en/articles/releng/_index.adoc
	--- a/documentation/content/en/articles/releng/_index.adoc
	+++ b/documentation/content/en/articles/releng/_index.adoc
	@@ -18,34 +18,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:xrefstyle: full
	+:images-path: articles/releng/

	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/releases.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/en/teams.adoc[lines=16..-1]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/urls.adoc[]
	-:imagesdir: ../../../images/articles/releng/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/teams.adoc[lines=16..-1]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:imagesdir: ../../../../static/images/articles/releng/
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::shared/releases.adoc[]
	-include::shared/authors.adoc[]
	-include::shared/en/teams.adoc[lines=16..-1]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/urls.adoc[]
	-:imagesdir: ../../../../static/images/articles/releng/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -55,7 +40,7 @@
	====
	This document is outdated and does not accurately describe the current release procedures of the FreeBSD Release Engineering team.
	It is retained for historical purposes.
	-The current procedures used by the FreeBSD Release Engineering team are available in the link:{freebsd-releng}[FreeBSD Release Engineering] article.
	+The current procedures used by the FreeBSD Release Engineering team are available in the extref:{freebsd-releng}[FreeBSD Release Engineering] article.
	====

	This paper describes the approach used by the FreeBSD release engineering team to make production quality releases of the FreeBSD Operating System.
	@@ -74,7 +59,7 @@
	This has been a huge help in attracting more talented developers to FreeBSD.
	However, I think everyone would agree that chaos would soon manifest if write access to the main repository was opened up to everyone on the Internet.
	Therefore only a "select" group of nearly 300 people are given write access to the Subversion repository.
	-These link:{contributors}#staff-committers[FreeBSD committers]footnote:[link:{contributors}#staff-committers[FreeBSD committers]] are usually the people who do the bulk of FreeBSD development.
	+These extref:{contributors}[FreeBSD committers, staff-committers]footnote:[extref:{contributors}[FreeBSD committers, staff-committers]] are usually the people who do the bulk of FreeBSD development.
	An elected link:https://www.FreeBSD.org/administration/#t-core[Core Team]footnote:[link:https://www.FreeBSD.org/administration/#t-core[FreeBSD Core Team]] of developers provide some level of direction over the project.

	The rapid pace of `FreeBSD` development makes the main development branch unsuitable for the everyday use by the general public.
	@@ -94,7 +79,7 @@
	In most cases, binaries from the older _STABLE_ systems run unmodified on newer systems, including __HEAD__, assuming that the system management interfaces are not used.

	In the interim period between releases, weekly snapshots are built automatically by the FreeBSD Project build machines and made available for download from `ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/`.
	-The widespread availability of binary release snapshots, and the tendency of our user community to keep up with -STABLE development with Subversion and "`make buildworld`" footnote:[link:{handbook}#makeworld[Rebuilding world]] helps to keep FreeBSD-STABLE in a very reliable condition even before the quality assurance activities ramp up pending a major release.
	+The widespread availability of binary release snapshots, and the tendency of our user community to keep up with -STABLE development with Subversion and "`make buildworld`" footnote:[extref:{handbook}[Rebuilding world, makeworld]] helps to keep FreeBSD-STABLE in a very reliable condition even before the quality assurance activities ramp up pending a major release.

	In addition to installation ISO snapshots, weekly virtual machine images are also provided for use with VirtualBox, qemu, or other popular emulation software.
	The virtual machine images can be downloaded from `ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/VM-IMAGES/`.
	@@ -172,7 +157,7 @@
	In all examples below, `$FSVN` refers to the location of the FreeBSD Subversion repository, `svn+ssh://svn.FreeBSD.org/base/`.
	====

	-The layout of FreeBSD branches in Subversion is described in the link:{committers-guide}#subversion-primer-base-layout[Committer's Guide].
	+The layout of FreeBSD branches in Subversion is described in the extref:{committers-guide}[Committer's Guide, subversion-primer-base-layout].
	The first step in creating a branch is to identify the revision of the `stable/_X_` sources that you want to branch _from_.

	[source,shell]
	@@ -277,7 +262,7 @@
	== Release Building

	FreeBSD "releases" can be built by anyone with a fast machine and access to a source repository.
	-(That should be everyone, since we offer Subversion access! See the link:{handbook}#svn[Subversion section in the Handbook] for details.)
	+(That should be everyone, since we offer Subversion access! See the extref:{handbook}[Subversion section in the Handbook, svn] for details.)
	The _only_ special requirement is that the man:md[4] device must be available.
	If the device is not loaded into your kernel, then the kernel module should be automatically loaded when man:mdconfig[8] is executed during the boot media creation phase.
	All of the tools necessary to build a release are available from the Subversion repository in [.filename]#src/release#.
	@@ -393,7 +378,7 @@
	The ISO images. The "*" is [.filename]#disc1#, [.filename]#disc2#, etc.
	Only if there is a [.filename]#disc1# and there is an alternative first installation CD (for example a stripped-down install with no windowing system) there may be a [.filename]#mini# as well.

	-For more information about the distribution mirror architecture of the FreeBSD FTP sites, please see the link:{hubs}[Mirroring FreeBSD] article.
	+For more information about the distribution mirror architecture of the FreeBSD FTP sites, please see the extref:{hubs}[Mirroring FreeBSD] article.

	It may take many hours to two days after updating `ftp-master` before a majority of the Tier-1 FTP sites have the new software depending on whether or not a package set got loaded at the same time.
	It is imperative that the release engineers coordinate with the {mirror-announce} before announcing the general availability of new software on the FTP sites.
	@@ -420,7 +405,7 @@
	=== Scripting `bsdinstall`

	The FreeBSD system installation and configuration tool, man:bsdinstall[8], can be scripted to provide automated installs for large sites.
	-This functionality can be used in conjunction with Intel(R) PXE footnote:[link:{handbook}#network-diskless[Diskless Operation with PXE]] to bootstrap systems from the network.
	+This functionality can be used in conjunction with Intel(R) PXE footnote:[extref:{handbook}[Diskless Operation with PXE, network-diskless]] to bootstrap systems from the network.

	[[lessons-learned]]
	== Lessons Learned from FreeBSD 4.4
	diff --git a/documentation/content/en/articles/remote-install/_index.adoc b/documentation/content/en/articles/remote-install/_index.adoc
	--- a/documentation/content/en/articles/remote-install/_index.adoc
	+++ b/documentation/content/en/articles/remote-install/_index.adoc
	@@ -18,20 +18,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/remote-install/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -227,7 +226,7 @@

	Next, create slices and label them with your preferred tool.
	While it is considered easier to use `sysinstall`, a powerful and also probably less buggy method will be to use standard text-based UNIX(R) tools, such as man:fdisk[8] and man:bsdlabel[8], which will also be covered in this section.
	-The former option is well documented in the link:{handbook}#install-steps[Installing FreeBSD] chapter of the FreeBSD Handbook.
	+The former option is well documented in the extref:{handbook}[Installing FreeBSD, install-steps] chapter of the FreeBSD Handbook.
	As it was mentioned in the introduction, this article will present how to set up a system with RAID-1 and ZFS capabilities.
	Our set up will consist of a small man:gmirror[8] mirrored [.filename]#/# (root), [.filename]#/usr# and [.filename]#/var# dataset, and the rest of the disk space will be allocated for a man:zpool[8] mirrored ZFS file system.
	Please note, that the ZFS file system will be configured after the FreeBSD operating system is successfully installed and booted.
	diff --git a/documentation/content/en/articles/serial-uart/_index.adoc b/documentation/content/en/articles/serial-uart/_index.adoc
	--- a/documentation/content/en/articles/serial-uart/_index.adoc
	+++ b/documentation/content/en/articles/serial-uart/_index.adoc
	@@ -17,21 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/serial-uart/

	-
	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -873,7 +871,7 @@
	So if you have it unplugged, probes of those ports will fail.
	I have never tested booting with the box unplugged and plugging it back in, and I suggest you do not either.

	-If you do not already have a custom kernel configuration file set up, refer to link:{handbook}#kernelconfig[Kernel Configuration] chapter of the FreeBSD Handbook for general procedures.
	+If you do not already have a custom kernel configuration file set up, refer to extref:{handbook}[Kernel Configuration, kernelconfig] chapter of the FreeBSD Handbook for general procedures.
	The following are the specifics for the Boca 16 board and assume you are using the kernel name MYKERNEL and editing with vi.

	[.procedure]
	diff --git a/documentation/content/en/articles/solid-state/_index.adoc b/documentation/content/en/articles/solid-state/_index.adoc
	--- a/documentation/content/en/articles/solid-state/_index.adoc
	+++ b/documentation/content/en/articles/solid-state/_index.adoc
	@@ -18,6 +18,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/solid-state/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Abstract
	diff --git a/documentation/content/en/articles/vinum/_index.adoc b/documentation/content/en/articles/vinum/_index.adoc
	--- a/documentation/content/en/articles/vinum/_index.adoc
	+++ b/documentation/content/en/articles/vinum/_index.adoc
	@@ -15,20 +15,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/en/urls.adoc[]
	-:imagesdir: ../../../images/articles/vinum/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/en/urls.adoc[]
	-:imagesdir: ../../../../static/images/articles/vinum/
	+:images-path: articles/vinum/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/vinum/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	@@ -52,7 +51,7 @@

	[NOTE]
	====
	-Starting with FreeBSD 5, [.filename]#vinum# has been rewritten in order to fit into the link:{handbook}#geom[GEOM architecture], while retaining the original ideas, terminology, and on-disk metadata.
	+Starting with FreeBSD 5, [.filename]#vinum# has been rewritten in order to fit into the extref:{handbook}[GEOM architecture, geom], while retaining the original ideas, terminology, and on-disk metadata.
	This rewrite is called _gvinum_ (for _GEOM vinum_).
	While this chapter uses the term [.filename]#vinum#, any command invocations should be performed with `gvinum`.
	The name of the kernel module has changed from the original [.filename]#vinum.ko# to [.filename]#geom_vinum.ko#, and all device nodes reside under [.filename]#/dev/gvinum# instead of [.filename]#/dev/vinum#.
	@@ -684,7 +683,7 @@
	==== Only Primary Bootstrap Loads

	If [.filename]#/boot/loader# fails to load, but the primary bootstrap still loads (visible by a single dash in the left column of the screen right after the boot process starts), an attempt can be made to interrupt the primary bootstrap by pressing kbd:[space].
	-This will make the bootstrap stop in link:{handbook}#boot-boot1[stage two].
	+This will make the bootstrap stop in extref:{handbook}[stage two, boot-boot1].
	An attempt can be made here to boot off an alternate partition, like the partition containing the previous root file system that has been moved away from `a`.

	[[vinum-root-panic]]
	@@ -695,6 +694,6 @@
	However, the stage one and two bootstraps plus the bsdlabel require 8 KB.
	So if a [.filename]#vinum# partition was started at offset 0 within a slice or disk that was meant to be bootable, the [.filename]#vinum# setup will trash the bootstrap.

	-Similarly, if the above situation has been recovered, by booting from a "Fixit" media, and the bootstrap has been re-installed using `bsdlabel -B` as described in link:{handbook}#boot-boot1[stage two], the bootstrap will trash the [.filename]#vinum# header, and [.filename]#vinum# will no longer find its disk(s).
	+Similarly, if the above situation has been recovered, by booting from a "Fixit" media, and the bootstrap has been re-installed using `bsdlabel -B` as described in extref:{handbook}[stage two, boot-boot1], the bootstrap will trash the [.filename]#vinum# header, and [.filename]#vinum# will no longer find its disk(s).
	Though no actual [.filename]#vinum# configuration data or data in [.filename]#vinum# volumes will be trashed, and it would be possible to recover all the data by entering exactly the same [.filename]#vinum# configuration data again, the situation is hard to fix.
	It is necessary to move the entire [.filename]#vinum# partition by at least 4 KB, in order to have the [.filename]#vinum# header and the system bootstrap no longer collide.
	diff --git a/documentation/content/en/articles/vm-design/_index.adoc b/documentation/content/en/articles/vm-design/_index.adoc
	--- a/documentation/content/en/articles/vm-design/_index.adoc
	+++ b/documentation/content/en/articles/vm-design/_index.adoc
	@@ -17,17 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-
	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../images/articles/vm-design/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/articles/vm-design/
	+:images-path: articles/vm-design/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/vm-design/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/en/books/arch-handbook/_index.adoc b/documentation/content/en/books/arch-handbook/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/_index.adoc
	@@ -9,6 +9,7 @@
	next: books/arch-handbook/parti
	weight: 50
	add_single_page_link: true
	+isIndex: true
	---

	= FreeBSD Architecture Handbook
	@@ -18,37 +19,23 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	+:images-path: books/arch-handbook/

	-ifeval::["{backend}" == "html5"]
	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-:chapters-path: content/en/books/arch-handbook/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:chapters-path:
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:chapters-path:
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -56,7 +43,7 @@

	Welcome to the FreeBSD Architecture Handbook. This manual is a _work in progress_ and is the work of many individuals. Many sections do not yet exist and some of those that do exist need to be updated. If you are interested in helping with this project, send email to the {freebsd-doc}.

	-The latest version of this document is always available from the link:https://www.FreeBSD.org/[FreeBSD World Wide Web server]. It may also be downloaded in a variety of formats and compression options from the https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous link:{handbook}#mirrors-ftp/[mirror sites].
	+The latest version of this document is always available from the link:https://www.FreeBSD.org/[FreeBSD World Wide Web server]. It may also be downloaded in a variety of formats and compression options from the https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous extref:{handbook}[mirror sites, mirrors-ftp].

	'''

	diff --git a/documentation/content/en/books/arch-handbook/bibliography/_index.adoc b/documentation/content/en/books/arch-handbook/bibliography/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/bibliography/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/bibliography/_index.adoc
	@@ -12,19 +12,25 @@
	:toc: macro
	:toclevels: 1
	:icons: font
	-:sectnums!:
	+:sectnums:
	+:sectnumlevels: 6
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[1] _Marshall Kirk McKusick, Keith Bostic, Michael J Karels, and John S Quarterman._ Copyright © 1996 Addison-Wesley Publishing Company, Inc.. 0-201-54979-4. Addison-Wesley Publishing Company, Inc.. The Design and Implementation of the 4.4 BSD Operating System. 1-2.
	diff --git a/documentation/content/en/books/arch-handbook/book.adoc b/documentation/content/en/books/arch-handbook/book.adoc
	--- a/documentation/content/en/books/arch-handbook/book.adoc
	+++ b/documentation/content/en/books/arch-handbook/book.adoc
	@@ -14,48 +14,29 @@
	:toc: macro
	:toclevels: 2
	:icons: font
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	:sectnums:
	:sectnumlevels: 6
	:partnums:
	-:chapter-signifier: Chapter
	-:part-signifier: Part
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	:book: true
	:pdf: false
	+:images-path: books/arch-handbook/

	-ifeval::["{backend}" == "html5"]
	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-:chapters-path: content/en/books/arch-handbook/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:chapters-path:
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+:chapters-path: content/{{% lang %}}/books/arch-handbook/
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	:chapters-path:
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -63,7 +44,7 @@

	Welcome to the FreeBSD Architecture Handbook. This manual is a _work in progress_ and is the work of many individuals. Many sections do not yet exist and some of those that do exist need to be updated. If you are interested in helping with this project, send email to the {freebsd-doc}.

	-The latest version of this document is always available from the link:https://www.FreeBSD.org/[FreeBSD World Wide Web server]. It may also be downloaded in a variety of formats and compression options from the https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous link:{handbook}#mirrors-ftp/[mirror sites].
	+The latest version of this document is always available from the link:https://www.FreeBSD.org/[FreeBSD World Wide Web server]. It may also be downloaded in a variety of formats and compression options from the https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous extref:{handbook}[mirror sites, mirrors-ftp].

	'''

	@@ -72,28 +53,28 @@
	// Section one
	include::{chapters-path}parti.adoc[lines=7..8]

	-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}locking/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}kobj/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}jail/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}sysinit/_index.adoc[leveloffset=+1], lines=9..23;34..-1]
	-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=14..28;39..-1]
	-include::{chapters-path}vm/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}smp/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	+include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}locking/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}kobj/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}jail/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}sysinit/_index.adoc[leveloffset=+1], lines=9..20;39..-1]
	+include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=14..25;44..-1]
	+include::{chapters-path}vm/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}smp/_index.adoc[leveloffset=+1, lines=9..20;39..-1]

	// Section two
	include::{chapters-path}partii.adoc[lines=7..8]

	-include::{chapters-path}driverbasics/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}isa/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}pci/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}scsi/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}usb/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}newbus/_index.adoc[leveloffset=+1, lines=14..28;39..-1]
	-include::{chapters-path}sound/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}pccard/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	+include::{chapters-path}driverbasics/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}isa/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}pci/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}scsi/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}usb/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}newbus/_index.adoc[leveloffset=+1, lines=14..25;44..-1]
	+include::{chapters-path}sound/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}pccard/_index.adoc[leveloffset=+1, lines=9..20;39..-1]

	// Section three
	include::{chapters-path}partiii.adoc[lines=7..8]

	-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..21;30..-1]
	+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..19;36..-1]
	diff --git a/documentation/content/en/books/arch-handbook/boot/_index.adoc b/documentation/content/en/books/arch-handbook/boot/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/boot/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/boot/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 1
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 1
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/arch-handbook/driverbasics/_index.adoc b/documentation/content/en/books/arch-handbook/driverbasics/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/driverbasics/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/driverbasics/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 9
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 9
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/arch-handbook/isa/_index.adoc b/documentation/content/en/books/arch-handbook/isa/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/isa/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/isa/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 10
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 10
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/arch-handbook/jail/_index.adoc b/documentation/content/en/books/arch-handbook/jail/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/jail/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/jail/_index.adoc
	@@ -14,26 +14,31 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 4
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 4
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	On most UNIX(R) systems, `root` has omnipotent power. This promotes insecurity. If an attacker gained `root` on a system, he would have every function at his fingertips. In FreeBSD there are sysctls which dilute the power of `root`, in order to minimize the damage caused by an attacker. Specifically, one of these functions is called `secure levels`. Similarly, another function which is present from FreeBSD 4.0 and onward, is a utility called man:jail[8]. Jail chroots an environment and sets certain restrictions on processes which are forked within the jail. For example, a jailed process cannot affect processes outside the jail, utilize certain system calls, or inflict any damage on the host environment.

	-Jail is becoming the new security model. People are running potentially vulnerable servers such as Apache, BIND, and sendmail within jails, so that if an attacker gains `root` within the jail, it is only an annoyance, and not a devastation. This article mainly focuses on the internals (source code) of jail. For information on how to set up a jail see the link:{handbook}#jails/[handbook entry on jails].
	+Jail is becoming the new security model. People are running potentially vulnerable servers such as Apache, BIND, and sendmail within jails, so that if an attacker gains `root` within the jail, it is only an annoyance, and not a devastation. This article mainly focuses on the internals (source code) of jail. For information on how to set up a jail see the extref:{handbook}[handbook entry on jails, jails].

	[[jail-arch]]
	== Architecture
	diff --git a/documentation/content/en/books/arch-handbook/kobj/_index.adoc b/documentation/content/en/books/arch-handbook/kobj/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/kobj/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/kobj/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 3
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 3
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/arch-handbook/locking/_index.adoc b/documentation/content/en/books/arch-handbook/locking/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/locking/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/locking/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 2
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 2
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/arch-handbook/mac/_index.adoc b/documentation/content/en/books/arch-handbook/mac/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/mac/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/mac/_index.adoc
	@@ -19,20 +19,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 6
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 6
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/arch-handbook/newbus/_index.adoc b/documentation/content/en/books/arch-handbook/newbus/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/newbus/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/newbus/_index.adoc
	@@ -19,20 +19,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 14
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 14
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/arch-handbook/parti.adoc b/documentation/content/en/books/arch-handbook/parti.adoc
	--- a/documentation/content/en/books/arch-handbook/parti.adoc
	+++ b/documentation/content/en/books/arch-handbook/parti.adoc
	@@ -1,6 +1,6 @@
	---
	title: Part I. Kernel
	-prev: books/arch-handbook/
	+prev: books/arch-handbook
	next: books/arch-handbook/boot
	---

	diff --git a/documentation/content/en/books/arch-handbook/pccard/_index.adoc b/documentation/content/en/books/arch-handbook/pccard/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/pccard/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/pccard/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 16
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 16
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/arch-handbook/pci/_index.adoc b/documentation/content/en/books/arch-handbook/pci/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/pci/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/pci/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 11
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 11
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/arch-handbook/scsi/_index.adoc b/documentation/content/en/books/arch-handbook/scsi/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/scsi/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/scsi/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 12
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 12
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/arch-handbook/smp/_index.adoc b/documentation/content/en/books/arch-handbook/smp/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/smp/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/smp/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 8
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 8
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/arch-handbook/sound/_index.adoc b/documentation/content/en/books/arch-handbook/sound/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/sound/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/sound/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 15
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 15
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/arch-handbook/sysinit/_index.adoc b/documentation/content/en/books/arch-handbook/sysinit/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/sysinit/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/sysinit/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 5
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 5
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/arch-handbook/usb/_index.adoc b/documentation/content/en/books/arch-handbook/usb/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/usb/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/usb/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 13
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 13
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/arch-handbook/vm/_index.adoc b/documentation/content/en/books/arch-handbook/vm/_index.adoc
	--- a/documentation/content/en/books/arch-handbook/vm/_index.adoc
	+++ b/documentation/content/en/books/arch-handbook/vm/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 7
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 7
	+:images-path: books/arch-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/design-44bsd/_index.adoc b/documentation/content/en/books/design-44bsd/_index.adoc
	--- a/documentation/content/en/books/design-44bsd/_index.adoc
	+++ b/documentation/content/en/books/design-44bsd/_index.adoc
	@@ -10,6 +10,7 @@
	trademarks: ["design-44bsd"]
	weight: 60
	tags: ["4.4BSD", "design", "operating system", "BSD", "UNIX"]
	+isIndex: true
	---

	= The Design and Implementation of the 4.4BSD Operating System
	@@ -17,47 +18,26 @@
	:toc: macro
	:toclevels: 2
	:icons: font
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	:sectnums:
	:sectnumlevels: 6
	:partnums:
	-:chapter-signifier: Chapter
	-:part-signifier: Part
	+:sectnumoffset: 2
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:sectnumoffset: 2
	+:images-path: books/design-44bsd/

	-ifeval::["{backend}" == "html5"]
	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-:imagesdir: ../../../images/books/design-44bsd/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:imagesdir: ../../../../static/images/books/design-44bsd/
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:imagesdir: ../../../../static/images/books/design-44bsd/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	diff --git a/documentation/content/en/books/dev-model/_index.adoc b/documentation/content/en/books/dev-model/_index.adoc
	--- a/documentation/content/en/books/dev-model/_index.adoc
	+++ b/documentation/content/en/books/dev-model/_index.adoc
	@@ -7,6 +7,7 @@
	trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	weight: 45
	tags: ["model", "project model", "FreeBSD"]
	+isIndex: true
	---

	= A project model for the FreeBSD Project
	@@ -14,46 +15,25 @@
	:toc: macro
	:toclevels: 2
	:icons: font
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	:sectnums:
	:sectnumlevels: 6
	:partnums:
	-:chapter-signifier: Chapter
	-:part-signifier: Part
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	+:images-path: books/dev-model/

	-ifeval::["{backend}" == "html5"]
	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-:imagesdir: ../../../../images/books/dev-model/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:imagesdir: ../../../../static/images/books/dev-model/
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:imagesdir: ../../../../static/images/books/dev-model/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	@@ -1209,7 +1189,7 @@

	Like the ports sub-project, the Documentation project can appoint documentation committers without FreeBSD Core's approval. [<<freebsd-doceng-charter, FreeBSD, 2003B>>].

	-The Documentation project has link:{fdp-primer}[a primer].
	+The Documentation project has extref:{fdp-primer}[a primer].
	This is used both to introduce new project members to the standard tools and syntaxes and to act as a reference when working on the project.

	:sectnums!:
	@@ -1234,28 +1214,28 @@
	[FreeBSD, 2000A] Copyright © 2002 The FreeBSD Project. Core Bylaws. https://www.freebsd.org/internal/bylaws/.

	[[freebsd-developer-handbook]]
	-[FreeBSD, 2002A] Copyright © 2002 The FreeBSD Documentation Project. FreeBSD Developer's Handbook. link:{developers-handbook}[Developers Handbook].
	+[FreeBSD, 2002A] Copyright © 2002 The FreeBSD Documentation Project. FreeBSD Developer's Handbook. extref:{developers-handbook}[Developers Handbook].

	[[bsd-election2002]]
	[FreeBSD, 2002B] Copyright © 2002 The FreeBSD Project. Core team election 2002. http://election.uk.freebsd.org/candidates.html.

	[[freebsd-handle-pr]]
	-[FreeBSD, 2002C] Dag-Erling Smørgrav and Hiten Pandya. Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Problem Report Handling Guidelines. link:{pr-guidelines}[Problem Report Handling Guidelines].
	+[FreeBSD, 2002C] Dag-Erling Smørgrav and Hiten Pandya. Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Problem Report Handling Guidelines. extref:{pr-guidelines}[Problem Report Handling Guidelines].

	[[freebsd-send-pr]]
	-[FreeBSD, 2002D] Dag-Erling Smørgrav. Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Writing FreeBSD Problem Reports. link:{problem-reports}[Writing FreeBSD Problem Reports].
	+[FreeBSD, 2002D] Dag-Erling Smørgrav. Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Writing FreeBSD Problem Reports. extref:{problem-reports}[Writing FreeBSD Problem Reports].

	[[freebsd-committer]]
	-[FreeBSD, 2001] Copyright © 2001 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Committers Guide. link:{committers-guide}[Committer's Guide].
	+[FreeBSD, 2001] Copyright © 2001 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Committers Guide. extref:{committers-guide}[Committer's Guide].

	[[freebsd-releng]]
	-[FreeBSD, 2002E] Murray Stokely. Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. FreeBSD Release Engineering. https://link:{releng}[FreeBSD Release Engineering].
	+[FreeBSD, 2002E] Murray Stokely. Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. FreeBSD Release Engineering. https://extref:{releng}[FreeBSD Release Engineering].

	[[ref-bsd-handbook]]
	-[FreeBSD, 2003A] The FreeBSD Documentation Project. FreeBSD Handbook. link:{handbook}[FreeBSD Handbook].
	+[FreeBSD, 2003A] The FreeBSD Documentation Project. FreeBSD Handbook. extref:{handbook}[FreeBSD Handbook].

	[[freebsd-contributors]]
	-[FreeBSD, 2002F] Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Contributors to FreeBSD. link:{contributors}[Contributors to FreeBSD].
	+[FreeBSD, 2002F] Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Contributors to FreeBSD. extref:{contributors}[Contributors to FreeBSD].

	[[freebsd-election]]
	[FreeBSD, 2002G] Copyright © 2002 The FreeBSD Project. The FreeBSD Project. Core team elections 2002. http://election.uk.freebsd.org.
	diff --git a/documentation/content/en/books/developers-handbook/_index.adoc b/documentation/content/en/books/developers-handbook/_index.adoc
	--- a/documentation/content/en/books/developers-handbook/_index.adoc
	+++ b/documentation/content/en/books/developers-handbook/_index.adoc
	@@ -9,6 +9,7 @@
	weight: 25
	tags: ["FreeBSD Developers' Handbook"]
	add_single_page_link: true
	+isIndex: true
	---

	= FreeBSD Developers' Handbook
	@@ -18,34 +19,23 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	+:images-path: books/developers-handbook/

	-ifeval::["{backend}" == "html5"]
	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -57,7 +47,7 @@
	If you are interested in helping with this project, send email to the {freebsd-doc}.

	The latest version of this document is always available from the link:https://www.FreeBSD.org[FreeBSD World Wide Web server].
	-It may also be downloaded in a variety of formats and compression options from the link:https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous link:{handbook}#mirrors-ftp/[mirror sites].
	+It may also be downloaded in a variety of formats and compression options from the link:https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous extref:{handbook}[mirror sites, mirrors-ftp].

	'''

	diff --git a/documentation/content/en/books/developers-handbook/bibliography/_index.adoc b/documentation/content/en/books/developers-handbook/bibliography/_index.adoc
	--- a/documentation/content/en/books/developers-handbook/bibliography/_index.adoc
	+++ b/documentation/content/en/books/developers-handbook/bibliography/_index.adoc
	@@ -12,21 +12,27 @@
	:toc: macro
	:toclevels: 1
	:icons: font
	-:sectnums!:
	+:sectnums:
	+:sectnumlevels: 6
	+:sectnumoffset: A
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: A
	+:images-path: books/developers-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[[COD,1]] [1] Dave A Patterson and John L Hennessy. Copyright(R) 1998 Morgan Kaufmann Publishers, Inc. 1-55860-428-6. Morgan Kaufmann Publishers, Inc. Computer Organization and Design. The Hardware / Software Interface. 1-2.

	diff --git a/documentation/content/en/books/developers-handbook/book.adoc b/documentation/content/en/books/developers-handbook/book.adoc
	--- a/documentation/content/en/books/developers-handbook/book.adoc
	+++ b/documentation/content/en/books/developers-handbook/book.adoc
	@@ -14,51 +14,29 @@
	:toc: macro
	:toclevels: 2
	:icons: font
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	:sectnums:
	:sectnumlevels: 6
	:partnums:
	-:chapter-signifier: Chapter
	-:part-signifier: Part
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	:book: true
	:pdf: false
	+:images-path: books/developers-handbook/

	-ifeval::["{backend}" == "html5"]
	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-:imagesdir: ../../../../images/books/developers-handbook/
	-:chapters-path: content/en/books/developers-handbook/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:imagesdir: ../../../../static/images/books/developers-handbook/
	-:chapters-path:
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+:chapters-path: content/{{% lang %}}/books/developers-handbook/
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:imagesdir: ../../../../static/images/books/developers-handbook/
	+ifndef::env-beastie[]
	:chapters-path:
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -70,7 +48,7 @@
	If you are interested in helping with this project, send email to the {freebsd-doc}.

	The latest version of this document is always available from the link:https://www.FreeBSD.org[FreeBSD World Wide Web server].
	-It may also be downloaded in a variety of formats and compression options from the link:https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous link:{handbook}#mirrors-ftp/[mirror sites].
	+It may also be downloaded in a variety of formats and compression options from the link:https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous extref:{handbook}[mirror sites, mirrors-ftp].

	'''

	@@ -78,27 +56,27 @@

	// Section one
	include::{chapters-path}parti.adoc[lines=7..8]
	-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=12..26;37..-1]
	-include::{chapters-path}tools/_index.adoc[leveloffset=+1, lines=12..28;39..-1]
	-include::{chapters-path}secure/_index.adoc[leveloffset=+1, lines=11..25;36..-1]
	-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=10..24;35..-1]
	-include::{chapters-path}policies/_index.adoc[leveloffset=+1, lines=12..26;37..-1]
	-include::{chapters-path}testing/_index.adoc[leveloffset=+1, lines=10..24;35..-1]
	+include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=12..23;42..-1]
	+include::{chapters-path}tools/_index.adoc[leveloffset=+1, lines=12..25;44..-1]
	+include::{chapters-path}secure/_index.adoc[leveloffset=+1, lines=11..22;41..-1]
	+include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=10..21;40..-1]
	+include::{chapters-path}policies/_index.adoc[leveloffset=+1, lines=12..23;42..-1]
	+include::{chapters-path}testing/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	// Section two
	include::{chapters-path}partii.adoc[lines=7..8]
	-include::{chapters-path}sockets/_index.adoc[leveloffset=+1, lines=11..25;37..-1]
	-include::{chapters-path}ipv6/_index.adoc[leveloffset=+1, lines=11..25;36..-1]
	+include::{chapters-path}sockets/_index.adoc[leveloffset=+1, lines=11..22;41..-1]
	+include::{chapters-path}ipv6/_index.adoc[leveloffset=+1, lines=11..22;41..-1]

	// Section three
	include::{chapters-path}partiii.adoc[lines=7..8]
	-include::{chapters-path}kernelbuild/_index.adoc[leveloffset=+1, lines=10..24;35..-1]
	-include::{chapters-path}kerneldebug/_index.adoc[leveloffset=+1, lines=13..27;38..-1]
	+include::{chapters-path}kernelbuild/_index.adoc[leveloffset=+1, lines=10..21;40..-1]
	+include::{chapters-path}kerneldebug/_index.adoc[leveloffset=+1, lines=13..24;43..-1]

	// Section four
	include::{chapters-path}partiv.adoc[lines=7..8]
	-include::{chapters-path}x86/_index.adoc[leveloffset=+1, lines=10..24;35..-1]
	+include::{chapters-path}x86/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	// Appendices
	include::{chapters-path}partv.adoc[lines=7..8]
	-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..22;31..-1]
	+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..20;37..-1]
	diff --git a/documentation/content/en/books/developers-handbook/introduction/_index.adoc b/documentation/content/en/books/developers-handbook/introduction/_index.adoc
	--- a/documentation/content/en/books/developers-handbook/introduction/_index.adoc
	+++ b/documentation/content/en/books/developers-handbook/introduction/_index.adoc
	@@ -17,20 +17,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 1
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 1
	+:images-path: books/developers-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/developers-handbook/ipv6/_index.adoc b/documentation/content/en/books/developers-handbook/ipv6/_index.adoc
	--- a/documentation/content/en/books/developers-handbook/ipv6/_index.adoc
	+++ b/documentation/content/en/books/developers-handbook/ipv6/_index.adoc
	@@ -16,20 +16,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 8
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 8
	+:images-path: books/developers-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/developers-handbook/kernelbuild/_index.adoc b/documentation/content/en/books/developers-handbook/kernelbuild/_index.adoc
	--- a/documentation/content/en/books/developers-handbook/kernelbuild/_index.adoc
	+++ b/documentation/content/en/books/developers-handbook/kernelbuild/_index.adoc
	@@ -15,20 +15,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 9
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 9
	+:images-path: books/developers-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	@@ -36,11 +41,11 @@
	To debug the FreeBSD kernel it is required to be able to build one.
	There are two known ways to do so:

	-The supported procedure to build and install a kernel is documented in the link:{handbook}#kernelconfig-building[Building and Installing a Custom Kernel] chapter of the FreeBSD Handbook.
	+The supported procedure to build and install a kernel is documented in the extref:{handbook}[Building and Installing a Custom Kernel, kernelconfig-building] chapter of the FreeBSD Handbook.

	[NOTE]
	====
	-It is supposed that the reader of this chapter is familiar with the information described in the link:{handbook}#kernelconfig-building[Building and Installing a Custom Kernel] chapter of the FreeBSD Handbook.
	+It is supposed that the reader of this chapter is familiar with the information described in the extref:{handbook}[Building and Installing a Custom Kernel, kernelconfig-building] chapter of the FreeBSD Handbook.
	If this is not the case, please read through the above mentioned chapter to understand how the build process works.
	====

	diff --git a/documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc b/documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc
	--- a/documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc
	+++ b/documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc
	@@ -18,20 +18,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 10
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 10
	+:images-path: books/developers-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	@@ -312,7 +317,7 @@
	....

	to your config file, and rebuild.
	-(See link:{handbook}/[The FreeBSD Handbook] for details on configuring the FreeBSD kernel).
	+(See extref:{handbook}[The FreeBSD Handbook] for details on configuring the FreeBSD kernel).

	Once your DDB kernel is running, there are several ways to enter DDB.
	The first, and earliest way is to use the boot flag `-d`.
	diff --git a/documentation/content/en/books/developers-handbook/l10n/_index.adoc b/documentation/content/en/books/developers-handbook/l10n/_index.adoc
	--- a/documentation/content/en/books/developers-handbook/l10n/_index.adoc
	+++ b/documentation/content/en/books/developers-handbook/l10n/_index.adoc
	@@ -15,20 +15,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 4
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 4
	+:images-path: books/developers-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/developers-handbook/parti.adoc b/documentation/content/en/books/developers-handbook/parti.adoc
	--- a/documentation/content/en/books/developers-handbook/parti.adoc
	+++ b/documentation/content/en/books/developers-handbook/parti.adoc
	@@ -1,6 +1,6 @@
	---
	title: Part I. Basics
	-prev: books/developers-handbook/
	+prev: books/developers-handbook
	next: books/developers-handbook/introduction
	---

	diff --git a/documentation/content/en/books/developers-handbook/policies/_index.adoc b/documentation/content/en/books/developers-handbook/policies/_index.adoc
	--- a/documentation/content/en/books/developers-handbook/policies/_index.adoc
	+++ b/documentation/content/en/books/developers-handbook/policies/_index.adoc
	@@ -17,20 +17,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 5
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 5
	+:images-path: books/developers-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/developers-handbook/secure/_index.adoc b/documentation/content/en/books/developers-handbook/secure/_index.adoc
	--- a/documentation/content/en/books/developers-handbook/secure/_index.adoc
	+++ b/documentation/content/en/books/developers-handbook/secure/_index.adoc
	@@ -16,20 +16,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 3
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 3
	+:images-path: books/developers-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/developers-handbook/sockets/_index.adoc b/documentation/content/en/books/developers-handbook/sockets/_index.adoc
	--- a/documentation/content/en/books/developers-handbook/sockets/_index.adoc
	+++ b/documentation/content/en/books/developers-handbook/sockets/_index.adoc
	@@ -16,21 +16,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 7
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 7
	+:images-path: books/developers-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-:imagesdir: ../../../../images/books/developers-handbook/
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/developers-handbook/testing/_index.adoc b/documentation/content/en/books/developers-handbook/testing/_index.adoc
	--- a/documentation/content/en/books/developers-handbook/testing/_index.adoc
	+++ b/documentation/content/en/books/developers-handbook/testing/_index.adoc
	@@ -15,20 +15,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 6
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 6
	+:images-path: books/developers-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/developers-handbook/tools/_index.adoc b/documentation/content/en/books/developers-handbook/tools/_index.adoc
	--- a/documentation/content/en/books/developers-handbook/tools/_index.adoc
	+++ b/documentation/content/en/books/developers-handbook/tools/_index.adoc
	@@ -17,22 +17,27 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 2
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 2
	:c-plus-plus-command: c++
	:clang-plus-plus-command: clang++
	+:images-path: books/developers-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	@@ -88,7 +93,7 @@

	Here is a list of interpreters that are available from the FreeBSD Ports Collection, with a brief discussion of some of the more popular interpreted languages.

	-Instructions on how to get and install applications from the Ports Collection can be found in the link:{handbook}#ports-using/[Ports section] of the handbook.
	+Instructions on how to get and install applications from the Ports Collection can be found in the extref:{handbook}[Ports section, ports-using] of the handbook.

	BASIC::
	Short for Beginner's All-purpose Symbolic Instruction Code.
	@@ -683,13 +688,13 @@

	[NOTE]
	====
	-The `lldb` command is available for FreeBSD {rel113-current} link:{handbook}#ports-using/[from ports or packages] as package:devel/llvm[].
	+The `lldb` command is available for FreeBSD {rel113-current} extref:{handbook}[from ports or packages, ports-using] as package:devel/llvm[].
	This will install the default version of lldb (currently 9.0).
	====

	The other debugger available with FreeBSD is called `gdb` (GNU debugger).
	Unlike lldb, it is not installed by default on FreeBSD {rel121-current};
	-to use it, link:{handbook}#ports-using/[install] package:devel/gdb[] from ports or packages.
	+to use it, extref:{handbook}#ports-using/[install] package:devel/gdb[] from ports or packages.
	The version installed by default on FreeBSD {rel113-current} is old; instead, install package:devel/gdb[] there as well.
	It has quite good on-line help, as well as a set of info pages.

	@@ -938,7 +943,7 @@
	[NOTE]
	====
	The described functionality is available starting with LLDB version 12.0.0.
	-Users of FreeBSD releases containing an earlier LLDB version may wish to use the snapshot available in link:{handbook}#ports-using/[ports or packages], as package:devel/llvm-devel[].
	+Users of FreeBSD releases containing an earlier LLDB version may wish to use the snapshot available in extref:{handbook}[ports or packages, ports-using], as package:devel/llvm-devel[].
	====

	Starting with LLDB 12.0.0, remote debugging is supported on FreeBSD.
	diff --git a/documentation/content/en/books/developers-handbook/x86/_index.adoc b/documentation/content/en/books/developers-handbook/x86/_index.adoc
	--- a/documentation/content/en/books/developers-handbook/x86/_index.adoc
	+++ b/documentation/content/en/books/developers-handbook/x86/_index.adoc
	@@ -15,20 +15,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 11
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 11
	+:images-path: books/developers-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc
	--- a/documentation/content/en/books/faq/_index.adoc
	+++ b/documentation/content/en/books/faq/_index.adoc
	@@ -7,6 +7,7 @@
	trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	weight: 5
	tags: ["FAQ", "FreeBSD FAQ"]
	+isIndex: true
	---

	= Frequently Asked Questions for FreeBSD {rel2-relx} and {rel-relx}
	@@ -14,17 +15,12 @@
	:toc: macro
	:toclevels: 1
	:icons: font
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	:sectnums:
	:sectnumlevels: 6
	:partnums:
	-:chapter-signifier: Chapter
	-:part-signifier: Part
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	+:images-path: books/faq/
	:rel-numbranch: 4
	:rel-head: 14-CURRENT
	:rel-head-relx: 14.X
	@@ -42,32 +38,18 @@
	:rel3-releng: stable/11/
	:rel3-relengdate: October 2016

	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -76,7 +58,7 @@
	This is the Frequently Asked Questions (FAQ) for FreeBSD versions {rel-relx}, {rel2-relx}, and {rel3-relx}.
	Every effort has been made to make this FAQ as informative as possible; if you have any suggestions as to how it may be improved, send them to the {freebsd-doc}.

	-The latest version of this document is always available from the link:{faq}[FreeBSD website].
	+The latest version of this document is always available from the extref:{faq}[FreeBSD website].
	It may also be downloaded as one large link:.[HTML] file with HTTP or as a variety of other formats from the https://download.freebsd.org/ftp/doc/[FreeBSD FTP server].

	'''
	@@ -97,7 +79,7 @@

	FreeBSD is used by companies, Internet Service Providers, researchers, computer professionals, students and home users all over the world in their work, education and recreation.

	-For more detailed information on FreeBSD, refer to the link:{handbook}[FreeBSD Handbook].
	+For more detailed information on FreeBSD, refer to the extref:{handbook}[FreeBSD Handbook].

	[[FreeBSD-goals]]
	=== What is the goal of the FreeBSD Project?
	@@ -142,7 +124,7 @@
	Users migrating to FreeBSD from another UNIX(R)-like environment will find FreeBSD to be similar.
	Windows(R) and Mac OS(R) users may be interested in instead using https://www.ghostbsd.org/[GhostBSD], https://www.midnightbsd.org/[MidnightBSD] or https://www.nomadbsd.org/[NomadBSD] three FreeBSD-based desktop distributions.
	Non-UNIX(R) users should expect to invest some additional time learning the UNIX(R) way of doing things.
	-This FAQ and the link:{handbook}[FreeBSD Handbook] are excellent places to start.
	+This FAQ and the extref:{handbook}[FreeBSD Handbook] are excellent places to start.

	[[why-called-FreeBSD]]
	=== Why is it called FreeBSD?
	@@ -188,9 +170,9 @@
	[[current]]
	=== What is _FreeBSD-CURRENT_?

	-link:{handbook}#current[FreeBSD-CURRENT] is the development version of the operating system, which will in due course become the new FreeBSD-STABLE branch.
	+extref:{handbook}[FreeBSD-CURRENT, current] is the development version of the operating system, which will in due course become the new FreeBSD-STABLE branch.
	As such, it is really only of interest to developers working on the system and die-hard hobbyists.
	-See the link:{handbook}#current[relevant section] in the link:{handbook}[Handbook] for details on running _-CURRENT_.
	+See the extref:{handbook}[relevant section, current] in the extref:{handbook}[Handbook] for details on running _-CURRENT_.

	Users not familiar with FreeBSD should not use FreeBSD-CURRENT.
	This branch sometimes evolves quite quickly and due to mistake can be un-buildable at times.
	@@ -206,7 +188,7 @@
	Users who do not have the resources to perform testing should instead run the most recent release of FreeBSD.
	_FreeBSD-CURRENT_, on the other hand, has been one unbroken line since 2.0 was released.

	-For more detailed information on branches see "link:{releng}#rel-branch[FreeBSD Release Engineering: Creating the Release Branch]",
	+For more detailed information on branches see "extref:{releng}[FreeBSD Release Engineering: Creating the Release Branch, rel-branch]",
	the status of the branches and the upcoming release schedule can be found on the https://www.FreeBSD.org/releng[Release Engineering Information] page.

	Version https://download.FreeBSD.org/ftp/releases/amd64/amd64/{rel121-current}-RELEASE/[{rel121-current}] is the latest release from the {rel-stable} branch; it was released in {rel121-current-date}.
	@@ -247,7 +229,7 @@

	The key decisions concerning the FreeBSD project, such as the overall direction of the project and who is allowed to add code to the source tree,
	are made by a link:https://www.FreeBSD.org/administration#t-core[core team] of 9 people.
	-There is a much larger team of more than 350 link:{contributors}#staff-committers[committers] who are authorized to make changes directly to the FreeBSD source tree.
	+There is a much larger team of more than 350 extref:{contributors}[committers, staff-committers] who are authorized to make changes directly to the FreeBSD source tree.

	However, most non-trivial changes are discussed in advance in the <<mailing,mailing lists>>,
	and there are no restrictions on who may take part in the discussion.
	@@ -261,7 +243,7 @@
	* link:https://www.FreeBSD.org/snapshots/[Snapshot] releases are made monthly for the <<current,-CURRENT>> and <<stable,-STABLE>> branch, these being of service purely to bleeding-edge testers and developers.
	* The latest {rel2-stable} release, {rel113-current}-RELEASE can be found in the https://download.FreeBSD.org/ftp/releases/amd64/amd64/{rel113-current}-RELEASE/[{rel113-current}-RELEASE directory].

	-Information about obtaining FreeBSD on CD, DVD, and other media can be found in link:{handbook}#mirrors/[the Handbook].
	+Information about obtaining FreeBSD on CD, DVD, and other media can be found in extref:{handbook}[the Handbook, mirrors].

	[[access-pr]]
	=== How do I access the Problem Report database?
	@@ -270,7 +252,7 @@

	The link:https://www.FreeBSD.org/support/bugreports[web-based problem report submission interface] can be used to submit problem reports through a web browser.

	-Before submitting a problem report, read link:{problem-reports}[Writing FreeBSD Problem Reports], an article on how to write good problem reports.
	+Before submitting a problem report, read extref:{problem-reports}[Writing FreeBSD Problem Reports], an article on how to write good problem reports.

	[[support]]
	== Documentation and Support
	@@ -408,7 +390,7 @@
	[[mailing]]
	=== Where do I find info on the FreeBSD mailing lists? What FreeBSD news groups are available?

	-Refer to the link:{handbook}#eresources-mail[Handbook entry on mailing-lists] and the link:{handbook}#eresources-news/[Handbook entry on newsgroups].
	+Refer to the extref:{handbook}[Handbook entry on mailing-lists, eresources-mail] and the extref:{handbook}[Handbook entry on newsgroups, eresources-news].

	[[irc]]
	=== Are there FreeBSD IRC (Internet Relay Chat) channels?
	@@ -472,7 +454,7 @@
	\|A minimal image that requires network access during installation to completely install FreeBSD.
	\|===

	-Full instructions on this procedure and a little bit more about installation issues in general can be found in the link:{handbook}#bsdinstall/[Handbook entry on installing FreeBSD].
	+Full instructions on this procedure and a little bit more about installation issues in general can be found in the extref:{handbook}[Handbook entry on installing FreeBSD, bsdinstall].

	[[floppy-image-too-large]]
	=== What do I do if the install image does not boot?
	@@ -488,13 +470,13 @@
	[[install-instructions-location]]
	=== Where are the instructions for installing FreeBSD?

	-Installation instructions can be found at link:{handbook}#bsdinstall/[Handbook entry on installing FreeBSD].
	+Installation instructions can be found at extref:{handbook}[Handbook entry on installing FreeBSD, bsdinstall].

	[[custom-boot-floppy]]
	=== How can I make my own custom release or install disk?

	Customized FreeBSD installation media can be created by building a custom release.
	-Follow the instructions in the link:{releng}[Release Engineering] article.
	+Follow the instructions in the extref:{releng}[Release Engineering] article.

	[[windows-coexist]]
	=== Can Windows(R) co-exist with FreeBSD? (x86-specific)
	@@ -647,7 +629,7 @@
	FreeBSD divides support into multiple tiers.
	Tier 1 architectures, such as i386 or amd64; are fully supported.
	Tiers 2 and 3 are supported on a best-effort basis.
	-A full explanation of the tier system is available in the link:{committers-guide}#archs/[Committer's Guide.]
	+A full explanation of the tier system is available in the extref:{committers-guide}[Committer's Guide., archs]

	A complete list of supported architectures can be found on the https://www.FreeBSD.org/platforms/[platforms page.]

	@@ -852,7 +834,7 @@
	If the machine is heavily loaded, increase `kern.maxusers`.
	This will increase these other system limits in addition to the maximum number of processes.

	-To adjust the `kern.maxusers` value, see the link:{handbook}#kern-maxfiles[File/Process Limits] section of the Handbook.
	+To adjust the `kern.maxusers` value, see the extref:{handbook}[File/Process Limits, kern-maxfiles] section of the Handbook.
	While that section refers to open files, the same limits apply to processes.

	If the machine is lightly loaded but running a very large number of processes, adjust the `kern.maxproc` tunable by defining it in [.filename]#/boot/loader.conf#.
	@@ -906,7 +888,7 @@
	=== Why does file: table is full show up repeatedly in man:dmesg[8]?

	This error message indicates that the number of available file descriptors have been exhausted on the system.
	-Refer to the link:{handbook}#kern-maxfiles[kern.maxfiles] section of the link:{handbook}#configtuning-kernel-limits/[Tuning Kernel Limits] section of the Handbook for a discussion and solution.
	+Refer to the extref:{handbook}[kern.maxfiles, kern-maxfiles] section of the extref:{handbook}[Tuning Kernel Limits, configtuning-kernel-limits] section of the Handbook for a discussion and solution.

	[[computer-clock-skew]]
	=== Why does the clock on my computer keep incorrect time?
	@@ -1039,7 +1021,7 @@
	[[ports-4x]]
	=== Why can I not build this port on my {rel2-relx} -, or {rel-relx} -STABLE machine?

	-If the installed FreeBSD version lags significantly behind _-CURRENT_ or _-STABLE_, update the Ports Collection using the instructions in link:{handbook}#ports-using/[Using the Ports Collection].
	+If the installed FreeBSD version lags significantly behind _-CURRENT_ or _-STABLE_, update the Ports Collection using the instructions in extref:{handbook}[Using the Ports Collection, ports-using].
	If the system is up-to-date, someone might have committed a change to the port which works for _-CURRENT_ but which broke the port for _-STABLE_.
	https://bugs.FreeBSD.org/submit/[Submit] a bug report, since the Ports Collection is supposed to work for both the _-CURRENT_ and _-STABLE_ branches.

	@@ -1056,7 +1038,7 @@
	=== I updated the sources, now how do I update my installed ports?

	FreeBSD does not include a port upgrading tool, but it does have some tools to make the upgrade process somewhat easier.
	-Additional tools are available to simplify port handling and are described the link:{handbook}#ports-using/[Upgrading Ports] section in the FreeBSD Handbook.
	+Additional tools are available to simplify port handling and are described the extref:{handbook}[Upgrading Ports, ports-using] section in the FreeBSD Handbook.

	[[ports-major-upgrade]]
	=== Do I need to recompile every port each time I perform a major version update?
	@@ -1067,7 +1049,7 @@
	When the system is upgraded, various shared libraries, loadable modules, and other parts of the system will be replaced with newer versions.
	Applications linked against the older versions may fail to start or, in other cases, fail to function properly.

	-For more information, see link:{handbook}#freebsdupdate-upgrade[the section on upgrades] in the FreeBSD Handbook.
	+For more information, see extref:{handbook}[the section on upgrades, freebsdupdate-upgrade] in the FreeBSD Handbook.

	[[ports-minor-upgrade]]
	=== Do I need to recompile every port each time I perform a minor version update?
	@@ -1094,7 +1076,7 @@
	[[make-kernel]]
	=== I would like to customize my kernel. Is it difficult?

	-Not at all! Check out the link:{handbook}#kernelconfig/[kernel config section of the Handbook].
	+Not at all! Check out the extref:{handbook}[kernel config section of the Handbook, kernelconfig].

	[NOTE]
	====
	@@ -1151,7 +1133,7 @@
	Unneeded devices can be removed from the kernel to further reduce the size.
	See <<make-kernel>> for more information.

	-To put any of these options into effect, follow the instructions to link:{handbook}#kernelconfig-building/[build and install] the new kernel.
	+To put any of these options into effect, follow the instructions to extref:{handbook}[build and install, kernelconfig-building] the new kernel.

	For reference, the FreeBSD 11 amd64 kernel ([.filename]#/boot/kernel/kernel#) is approximately 25 MB.

	@@ -1186,7 +1168,7 @@
	[[adding-disks]]
	=== How can I add my new hard disk to my FreeBSD system?

	-See the link:{handbook}#disks-adding/[Adding Disks] section in the FreeBSD Handbook.
	+See the extref:{handbook}[Adding Disks, disks-adding] section in the FreeBSD Handbook.

	[[new-huge-disk]]
	=== How do I move my system over to my huge new disk?
	@@ -1334,7 +1316,7 @@
	=== Is there a cryptographic file system for FreeBSD?

	Yes, man:gbde[8] and man:geli[8].
	-See the link:{handbook}#disks-encrypting/[Encrypting Disk Partitions] section of the FreeBSD Handbook.
	+See the extref:{handbook}[Encrypting Disk Partitions, disks-encrypting] section of the FreeBSD Handbook.

	[[grub-loader]]
	=== How do I boot FreeBSD and Linux(R) using GRUB?
	@@ -1413,31 +1395,31 @@
	=== Why do I get Incorrect super block when mounting a CD?

	The type of device to mount must be specified.
	-This is described in the Handbook section on link:{handbook}#mounting-cd[Using Data CDs].
	+This is described in the Handbook section on extref:{handbook}[Using Data CDs, mounting-cd].

	[[cdrom-not-configured]]
	=== Why do I get Device not configured when mounting a CD?

	This generally means that there is no CD in the drive, or the drive is not visible on the bus.
	-Refer to the link:{handbook}#mounting-cd[Using Data CDs] section of the Handbook for a detailed discussion of this issue.
	+Refer to the extref:{handbook}[Using Data CDs, mounting-cd] section of the Handbook for a detailed discussion of this issue.

	[[cdrom-unicode-filenames]]
	=== Why do all non-English characters in filenames show up as ? on my CDs when mounted in FreeBSD?

	The CD probably uses the "Joliet" extension for storing information about files and directories.
	-This is discussed in the Handbook section on link:{handbook}#mounting-cd[Using Data CD-ROMs].
	+This is discussed in the Handbook section on extref:{handbook}[Using Data CD-ROMs, mounting-cd].

	[[burncd-isofs]]
	=== A CD burned under FreeBSD cannot be read under any other operating system. Why?

	This means a raw file was burned to the CD, rather than creating an ISO 9660 file system.
	-Take a look at the Handbook section on link:{handbook}#mounting-cd[Using Data CDs].
	+Take a look at the Handbook section on extref:{handbook}[Using Data CDs].

	[[copy-cd]]
	=== How can I create an image of a data CD?

	-This is discussed in the Handbook section on link:{handbook}#mkisofs[Writing Data to an ISO File System].
	-For more on working with CD-ROMs, see the link:{handbook}#creating-cds/[Creating CDs Section] in the Storage chapter in the Handbook.
	+This is discussed in the Handbook section on extref:{handbook}[Writing Data to an ISO File System, mkisofs].
	+For more on working with CD-ROMs, see the extref:{handbook}[Creating CDs Section, creating-cds] in the Storage chapter in the Handbook.

	[[mount-audio-CD]]
	=== Why can I not mount an audio CD?
	@@ -1529,7 +1511,7 @@
	[[add-swap-space]]
	=== How can I add more swap space?

	-This section link:{handbook}#adding-swap-space/[of the Handbook] describes how to do this.
	+This section extref:{handbook}[of the Handbook, adding-swap-space] describes how to do this.

	[[manufacturer-disk-size]]
	=== Why does FreeBSD see my disk as smaller than the manufacturer says it is?
	@@ -1719,13 +1701,13 @@
	[[printer-setup]]
	=== Why am I having trouble setting up my printer?

	-See the link:{handbook}#printing/[Handbook entry on printing] for troubleshooting tips.
	+See the extref:{handbook}[Handbook entry on printing, printing] for troubleshooting tips.

	[[keyboard-mappings]]
	=== How can I correct the keyboard mappings for my system?

	-Refer to the Handbook section on link:{handbook}#using-localization/[using localization],
	-specifically the section on link:{handbook}#setting-console[console setup].
	+Refer to the Handbook section on extref:{handbook}[using localization, using-localization],
	+specifically the section on extref:{handbook}[console setup, setting-console].

	[[user-quotas]]
	=== Why can I not get user quotas to work properly?
	@@ -1738,7 +1720,7 @@
	options QUOTA
	....
	+
	-Refer to the link:{handbook}#quotas/[Handbook entry on quotas] for full details.
	+Refer to the extref:{handbook}[Handbook entry on quotas, quotas] for full details.
	. Do not turn on quotas on [.filename]#/#.
	. Put the quota file on the file system that the quotas are to be enforced on:
	+
	@@ -1801,7 +1783,7 @@
	====
	If the root partition cannot be mounted from single-user mode,
	it is possible that the partitions are encrypted and it is impossible to mount them without the access keys.
	-For more information see the section about encrypted disks in the FreeBSD link:{handbook}#disks-encrypting/[Handbook].
	+For more information see the section about encrypted disks in the FreeBSD extref:{handbook}[Handbook, disks-encrypting].
	====

	[[CAD-reboot]]
	@@ -1875,7 +1857,7 @@
	Once in the RC stage, only the most critical bugs found can be fixed.
	Once the release (6.3-RELEASE in this example) and release branch have been made, the branch will be renamed to 6.3-STABLE.

	-For more information on version numbers and the various Subversion branches, refer to the link:{releng}[Release Engineering] article.
	+For more information on version numbers and the various Subversion branches, refer to the extref:{releng}[Release Engineering] article.

	[[kernel-chflag-failure]]
	=== I tried to install a new kernel, and the man:chflags[1] failed. How do I get around this?
	@@ -2018,7 +2000,7 @@
	# pkg install xorg
	....

	-After the installation of Xorg, follow the instructions from the link:{handbook}#x-config/[X11 Configuration] section of the FreeBSD Handbook.
	+After the installation of Xorg, follow the instructions from the extref:{handbook}[X11 Configuration, x-config] section of the FreeBSD Handbook.

	[[running-X-securelevels]]
	=== I tried to run X, but I get a No devices detected. error when I type startx. What do I do now?
	@@ -2259,7 +2241,7 @@
	[[install-splash]]
	=== How do I install a splash screen and where do I find them?

	-The detailed answer for this question can be found in the link:{handbook}#boot-splash/[Boot Time Splash Screens] section of the FreeBSD Handbook.
	+The detailed answer for this question can be found in the extref:{handbook}[Boot Time Splash Screens, boot-splash] section of the FreeBSD Handbook.

	[[windows-keys]]
	=== Can I use the kbd:[Windows] keys on my keyboard in X?
	@@ -2339,19 +2321,19 @@
	=== Where can I get information on diskless booting?

	"Diskless booting" means that the FreeBSD box is booted over a network, and reads the necessary files from a server instead of its hard disk.
	-For full details, see link:{handbook}#network-diskless/[the Handbook entry on diskless booting].
	+For full details, see extref:{handbook}[the Handbook entry on diskless booting, network-diskless].

	[[router]]
	=== Can a FreeBSD box be used as a dedicated network router?

	-Yes. Refer to the Handbook entry on link:{handbook}#advanced-networking/[advanced networking],
	-specifically the section on link:{handbook}#network-routing/[routing and gateways].
	+Yes. Refer to the Handbook entry on extref:{handbook}[advanced networking, advanced-networking],
	+specifically the section on extref:{handbook}[routing and gateways, network-routing].

	[[natd]]
	=== Does FreeBSD support NAT or Masquerading?

	-Yes. For instructions on how to use NAT over a PPP connection, see the link:{handbook}#userppp/[Handbook entry on PPP].
	-To use NAT over some other sort of network connection, look at the link:{handbook}#network-natd[natd] section of the Handbook.
	+Yes. For instructions on how to use NAT over a PPP connection, see the extref:{handbook}[Handbook entry on PPP, userppp].
	+To use NAT over some other sort of network connection, look at the extref:{handbook}[natd, network-natd] section of the Handbook.

	[[ethernet-aliases]]
	=== How can I set up Ethernet aliases?
	@@ -2370,7 +2352,7 @@
	# ifconfig ed0 alias 172.16.141.5 netmask 0xffffff00
	....

	-More information can be found in the FreeBSD link:{handbook}#configtuning-virtual-hosts/[Handbook].
	+More information can be found in the FreeBSD extref:{handbook}[Handbook, configtuning-virtual-hosts].

	[[nfs-linux]]
	=== Why can I not NFS-mount from a Linux(R) box?
	@@ -2386,8 +2368,8 @@
	=== Why does mountd keep telling me it can't change attributes and that I have a bad exports list on my FreeBSD NFS server?

	The most frequent problem is not understanding the correct format of [.filename]#/etc/exports#.
	-Review man:exports[5] and the link:{handbook}#network-nfs/[NFS] entry in the Handbook,
	-especially the section on link:{handbook}#configuring-nfs[configuring NFS].
	+Review man:exports[5] and the extref:{handbook}[NFS, network-nfs] entry in the Handbook,
	+especially the section on extref:{handbook}[configuring NFS, configuring-nfs].

	[[ip-multicast]]
	=== How do I enable IP multicast support?
	@@ -2397,7 +2379,7 @@
	[[fqdn-hosts]]
	=== Why do I have to use the FQDN for hosts on my site?

	-See the answer in the FreeBSD link:{handbook}#mail-trouble/[Handbook].
	+See the answer in the FreeBSD extref:{handbook}[Handbook, mail-trouble].

	[[network-permission-denied]]
	=== Why do I get an error, Permission denied, for all networking operations?
	@@ -2414,7 +2396,7 @@

	Consider setting `firewall_type="open"` in [.filename]#/etc/rc.conf#.

	-For further information on configuring this firewall, see the link:{handbook}#firewalls-ipfw/[Handbook chapter].
	+For further information on configuring this firewall, see the extref:{handbook}[Handbook chapter, firewalls-ipfw].

	[[ipfw-fwd]]
	=== Why is my `ipfw` “fwd” rule to redirect a service to another machine not working?
	@@ -2641,7 +2623,7 @@
	[[serial-console-prompt]]
	=== How do I get the boot: prompt to show on the serial console?

	-See link:{handbook}#serialconsole-setup/[this section of the Handbook].
	+See extref:{handbook}[this section of the Handbook, serialconsole-setup].

	[[found-serial]]
	=== How do I tell if FreeBSD found my serial ports or modem cards?
	@@ -2717,7 +2699,7 @@
	[[default-serial-params]]
	=== Can I set the default serial parameters for a port?

	-See the link:{handbook}#serial/#serial-hw-config[Serial Communications] section in the FreeBSD Handbook.
	+See the extref:{handbook}serialcomms[Serial Communications, serial-hw-config] section in the FreeBSD Handbook.

	[[cannot-tip]]
	=== Why can I not run tip or cu?
	@@ -2799,7 +2781,7 @@
	[[translation]]
	=== What do I need to do to translate a FreeBSD document into my native language?

	-See the link:{fdp-primer}#translations/[Translation FAQ] in the FreeBSD Documentation Project Primer.
	+See the extref:{fdp-primer}[Translation FAQ, translations] in the FreeBSD Documentation Project Primer.

	[[freebsd-mail-bounces]]
	=== Why does my email to any address at FreeBSD.org bounce?
	@@ -2858,7 +2840,7 @@
	[[glossary]]
	=== I have seen an acronym or other term on the mailing lists and I do not understand what it means. Where should I look?

	-Refer to the link:{handbook}#freebsd-glossary/[FreeBSD Glossary].
	+Refer to the extref:{handbook}[FreeBSD Glossary, freebsd-glossary].

	[[bikeshed-painting]]
	=== Why should I care what color the bikeshed is?
	@@ -3023,7 +3005,7 @@
	[[learn-advanced]]
	=== How can I learn more about FreeBSD's internals?

	-See the link:{arch-handbook}[FreeBSD Architecture Handbook].
	+See the extref:{arch-handbook}[FreeBSD Architecture Handbook].

	Additionally, much general UNIX(R) knowledge is directly applicable to FreeBSD.

	@@ -3031,7 +3013,7 @@
	=== How can I contribute to FreeBSD? What can I do to help?

	We accept all types of contributions: documentation, code, and even art.
	-See the article on link:{contributing}[Contributing to FreeBSD] for specific advice on how to do this.
	+See the article on extref:{contributing}[Contributing to FreeBSD] for specific advice on how to do this.

	And thanks for the thought!

	@@ -3220,4 +3202,4 @@

	This innocent little Frequently Asked Questions document has been written, rewritten, edited, folded, spindled, mutilated, eviscerated, contemplated, discombobulated, cogitated, regurgitated, rebuilt, castigated, and reinvigorated over the last decade, by a cast of hundreds if not thousands. Repeatedly.

	-We wish to thank every one of the people responsible, and we encourage you to link:{contributing}[join them] in making this FAQ even better.
	+We wish to thank every one of the people responsible, and we encourage you to extref:{contributing}[join them] in making this FAQ even better.
	diff --git a/documentation/content/en/books/fdp-primer/_index.adoc b/documentation/content/en/books/fdp-primer/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/_index.adoc
	@@ -9,6 +9,7 @@
	weight: 10
	tags: ["FDP", "documentation", "FreeBSD", "Index"]
	add_single_page_link: true
	+isIndex: true
	---

	= FreeBSD Documentation Project Primer for New Contributors
	@@ -18,7 +19,24 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:partnums:
	+:source-highlighter: rouge
	:experimental:
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Abstract
	diff --git a/documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc b/documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc
	@@ -14,15 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 6
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 6
	-
	-include::shared/en/urls.adoc[]
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	@@ -212,12 +222,12 @@
	. Then create a link using the AsciiDoctor variable to the `ipsec-must` article.
	+
	....
	-link:{ipsec-must}[IPSec-Must article]
	+extref:{ipsec-must}[IPSec-Must article]
	....
	+
	And this would be rendered as.
	+
	-link:{ipsec-must}[IPSec-Must article]
	+extref:{ipsec-must}[IPSec-Must article]

	[[asciidoctor-conclusion]]
	== Conclusion
	diff --git a/documentation/content/en/books/fdp-primer/book.adoc b/documentation/content/en/books/fdp-primer/book.adoc
	--- a/documentation/content/en/books/fdp-primer/book.adoc
	+++ b/documentation/content/en/books/fdp-primer/book.adoc
	@@ -14,48 +14,29 @@
	:toc: macro
	:toclevels: 2
	:icons: font
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	:sectnums:
	:sectnumlevels: 6
	:partnums:
	-:chapter-signifier: Chapter
	-:part-signifier: Part
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	:book: true
	:pdf: false
	+:images-path: books/fdp-primer/

	-ifeval::["{backend}" == "html5"]
	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-:chapters-path: content/en/books/fdp-primer/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:chapters-path:
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+:chapters-path: content/{{% lang %}}/books/fdp-primer/
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	:chapters-path:
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -79,38 +60,38 @@

	:sectnums!:

	-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=9..-1]
	+include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=9..16; 33..-1]

	:sectnums:

	-include::{chapters-path}overview/_index.adoc[leveloffset=+1, lines=9..23; 30..-1]
	+include::{chapters-path}overview/_index.adoc[leveloffset=+1, lines=9..20; 39..-1]

	-include::{chapters-path}tools/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
	+include::{chapters-path}tools/_index.adoc[leveloffset=+1, lines=9..20; 39..-1]

	-include::{chapters-path}working-copy/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
	+include::{chapters-path}working-copy/_index.adoc[leveloffset=+1, lines=9..20; 39..-1]

	-include::{chapters-path}structure/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
	+include::{chapters-path}structure/_index.adoc[leveloffset=+1, lines=9..20; 39..-1]

	-include::{chapters-path}doc-build/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
	+include::{chapters-path}doc-build/_index.adoc[leveloffset=+1, lines=9..20; 39..-1]

	-include::{chapters-path}asciidoctor-primer/_index.adoc[leveloffset=+1, lines=9..23; 29..-1]
	+include::{chapters-path}asciidoctor-primer/_index.adoc[leveloffset=+1, lines=9..20; 39..-1]

	-include::{chapters-path}rosetta/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
	+include::{chapters-path}rosetta/_index.adoc[leveloffset=+1, lines=9..20; 39..-1]

	-include::{chapters-path}translations/_index.adoc[leveloffset=+1, lines=9..23; 30..-1]
	+include::{chapters-path}translations/_index.adoc[leveloffset=+1, lines=9..20; 39..-1]

	-include::{chapters-path}po-translations/_index.adoc[leveloffset=+1, lines=9..23; 29..-1]
	+include::{chapters-path}po-translations/_index.adoc[leveloffset=+1, lines=9..20; 39..-1]

	-include::{chapters-path}manual-pages/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
	+include::{chapters-path}manual-pages/_index.adoc[leveloffset=+1, lines=9..20; 39..-1]

	-include::{chapters-path}writing-style/_index.adoc[leveloffset=+1, lines=9..23; 29..-1]
	+include::{chapters-path}writing-style/_index.adoc[leveloffset=+1, lines=9..20; 39..-1]

	-include::{chapters-path}editor-config/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
	+include::{chapters-path}editor-config/_index.adoc[leveloffset=+1, lines=9..20; 39..-1]

	-include::{chapters-path}see-also/_index.adoc[leveloffset=+1, lines=9..23; 29..-1]
	+include::{chapters-path}see-also/_index.adoc[leveloffset=+1, lines=9..20; 39..-1]

	:sectnums!:

	-include::{chapters-path}examples/_index.adoc[leveloffset=+1, lines=8..23; 27..-1]
	+include::{chapters-path}examples/_index.adoc[leveloffset=+1, lines=8..20; 39..-1]

	:sectnums:
	diff --git a/documentation/content/en/books/fdp-primer/doc-build/_index.adoc b/documentation/content/en/books/fdp-primer/doc-build/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/doc-build/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/doc-build/_index.adoc
	@@ -14,13 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 5
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 5
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/fdp-primer/editor-config/_index.adoc b/documentation/content/en/books/fdp-primer/editor-config/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/editor-config/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/editor-config/_index.adoc
	@@ -14,13 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 12
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 12
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/fdp-primer/examples/_index.adoc b/documentation/content/en/books/fdp-primer/examples/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/examples/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/examples/_index.adoc
	@@ -14,13 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: A
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: A
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/fdp-primer/manual-pages/_index.adoc b/documentation/content/en/books/fdp-primer/manual-pages/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/manual-pages/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/manual-pages/_index.adoc
	@@ -14,13 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 10
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 10
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	@@ -249,7 +261,7 @@

	Include the BSD license::
	Include the BSD license on new manual pages.
	-The preferred license is available from the link:{committers-guide}[Committer's Guide].
	+The preferred license is available from the extref:{committers-guide}[Committer's Guide].

	[[manual-pages-markup-tricks]]
	=== Markup Tricks
	diff --git a/documentation/content/en/books/fdp-primer/overview/_index.adoc b/documentation/content/en/books/fdp-primer/overview/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/overview/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/overview/_index.adoc
	@@ -14,16 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 1
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 1
	+:images-path: books/fdp-primer/

	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/fdp-primer/po-translations/_index.adoc b/documentation/content/en/books/fdp-primer/po-translations/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/po-translations/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/po-translations/_index.adoc
	@@ -14,15 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 9
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 9
	-
	-include::shared/en/urls.adoc[]
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	@@ -40,7 +50,7 @@
	The procedure shown in crossref:overview[overview-quick-start,Quick Start] is assumed to have already been performed.
	The `TRANSLATOR` option is required and already enabled by default in the package:textproc/docproj[] port.

	-This example shows the creation of a Spanish translation of the short link:{leap-seconds}[Leap Seconds] article.
	+This example shows the creation of a Spanish translation of the short extref:{leap-seconds}[Leap Seconds] article.

	[[po-translations-quick-start-install-po-editor]]

	@@ -255,7 +265,7 @@
	.Creating a Spanish Translation of the Porter's Handbook
	[example]
	====
	-Create a new Spanish translation of the link:{porters-handbook}[Porter's Handbook].
	+Create a new Spanish translation of the extref:{porters-handbook}[Porter's Handbook].
	The original is a book in [.filename]#~/doc/documentation/content/en/books/porters-handbook/#.

	[.procedure]
	@@ -350,7 +360,7 @@
	....
	msgid ""
	"This example shows the creation of a Spanish translation of the short "
	-"link:{leap-seconds}[Leap Seconds] article."
	+"extref:{leap-seconds}[Leap Seconds] article."
	....

	Spanish translation:
	@@ -359,7 +369,7 @@
	....
	msgid ""
	"Este ejemplo muestra la creación de un artículo con poco contenido como el artículo "
	-"link:{leap-seconds}[Leap Seconds]."
	+"extref:{leap-seconds}[Leap Seconds]."
	....

	====
	diff --git a/documentation/content/en/books/fdp-primer/preface/_index.adoc b/documentation/content/en/books/fdp-primer/preface/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/preface/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/preface/_index.adoc
	@@ -1,6 +1,6 @@
	---
	title: Preface
	-prev: books/fdp-primer/
	+prev: books/fdp-primer
	next: books/fdp-primer/overview
	description: Preface about the FreeBSD Documentation Project
	tags: ["preface", "prompts", "conventions"]
	@@ -10,15 +10,25 @@
	[[preface]]
	= Preface
	:doctype: book
	-:toc: macro
	-:toclevels: 1
	:icons: font
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[[preface-prompts]]
	== Shell Prompts
	diff --git a/documentation/content/en/books/fdp-primer/rosetta/_index.adoc b/documentation/content/en/books/fdp-primer/rosetta/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/rosetta/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/rosetta/_index.adoc
	@@ -14,13 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 7
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 7
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/fdp-primer/see-also/_index.adoc b/documentation/content/en/books/fdp-primer/see-also/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/see-also/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/see-also/_index.adoc
	@@ -14,15 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 13
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 13
	-
	-include::shared/en/urls.adoc[]
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	@@ -33,7 +43,7 @@
	== The FreeBSD Documentation Project

	* link:https://www.FreeBSD.org/docproj/[The FreeBSD Documentation Project web pages]
	-* link:{handbook}[The FreeBSD Handbook]
	+* extref:{handbook}[The FreeBSD Handbook]

	[[see-also-asciidoc]]
	== AsciiDoctor
	diff --git a/documentation/content/en/books/fdp-primer/structure/_index.adoc b/documentation/content/en/books/fdp-primer/structure/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/structure/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/structure/_index.adoc
	@@ -14,13 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 4
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 4
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/fdp-primer/tools/_index.adoc b/documentation/content/en/books/fdp-primer/tools/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/tools/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/tools/_index.adoc
	@@ -14,13 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 2
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 2
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/fdp-primer/translations/_index.adoc b/documentation/content/en/books/fdp-primer/translations/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/translations/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/translations/_index.adoc
	@@ -14,16 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 8
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 8
	-
	-include::shared/en/teams.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	@@ -87,7 +96,7 @@
	% git diff abff932fe8 2191c44469 documentation/content/en/articles/committers-guide/_index.adoc
	....

	-Please see the complete explanation of using Git in FreeBSD in the link:{handbook}mirrors/#git[FreeBSD Handbook].
	+Please see the complete explanation of using Git in FreeBSD in the extref:{handbook}mirrors[FreeBSD Handbook, git].

	== How do I find out who else might be translating to the same language?

	diff --git a/documentation/content/en/books/fdp-primer/working-copy/_index.adoc b/documentation/content/en/books/fdp-primer/working-copy/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/working-copy/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/working-copy/_index.adoc
	@@ -14,13 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 3
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 3
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/fdp-primer/writing-style/_index.adoc b/documentation/content/en/books/fdp-primer/writing-style/_index.adoc
	--- a/documentation/content/en/books/fdp-primer/writing-style/_index.adoc
	+++ b/documentation/content/en/books/fdp-primer/writing-style/_index.adoc
	@@ -14,15 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 11
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 11
	-
	-include::shared/en/mailing-lists.adoc[]
	+:images-path: books/fdp-primer/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/handbook/_index.adoc b/documentation/content/en/books/handbook/_index.adoc
	--- a/documentation/content/en/books/handbook/_index.adoc
	+++ b/documentation/content/en/books/handbook/_index.adoc
	@@ -9,6 +9,7 @@
	next: books/handbook/preface
	weight: 1
	add_single_page_link: true
	+isIndex: true
	---

	= FreeBSD Handbook
	@@ -18,11 +19,24 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	+:images-path: books/handbook/

	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Abstract
	diff --git a/documentation/content/en/books/handbook/advanced-networking/_index.adoc b/documentation/content/en/books/handbook/advanced-networking/_index.adoc
	--- a/documentation/content/en/books/handbook/advanced-networking/_index.adoc
	+++ b/documentation/content/en/books/handbook/advanced-networking/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 32
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 32
	+:images-path: books/handbook/advanced-networking/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/advanced-networking/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[advanced-networking-synopsis]]
	diff --git a/documentation/content/en/books/handbook/audit/_index.adoc b/documentation/content/en/books/handbook/audit/_index.adoc
	--- a/documentation/content/en/books/handbook/audit/_index.adoc
	+++ b/documentation/content/en/books/handbook/audit/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 17
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 17
	+:images-path: books/handbook/audit/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/audit/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/audit/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/audit/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[audit-synopsis]]
	diff --git a/documentation/content/en/books/handbook/basics/_index.adoc b/documentation/content/en/books/handbook/basics/_index.adoc
	--- a/documentation/content/en/books/handbook/basics/_index.adoc
	+++ b/documentation/content/en/books/handbook/basics/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 3
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 3
	+:images-path: books/handbook/basics/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/basics/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/basics/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/basics/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[basics-synopsis]]
	diff --git a/documentation/content/en/books/handbook/bibliography/_index.adoc b/documentation/content/en/books/handbook/bibliography/_index.adoc
	--- a/documentation/content/en/books/handbook/bibliography/_index.adoc
	+++ b/documentation/content/en/books/handbook/bibliography/_index.adoc
	@@ -11,22 +11,30 @@
	[[bibliography]]
	= Bibliography
	:doctype: book
	+:toc: macro
	+:toclevels: 1
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: B
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: B
	+:images-path: books/handbook/bibliography/

	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	While manual pages provide a definitive reference for individual pieces of the FreeBSD operating system, they seldom illustrate how to put the pieces together to make the whole operating system run smoothly.
	For this, there is no substitute for a good book or users' manual on UNIX(R) system administration.
	@@ -101,7 +109,7 @@
	* Leffler, Samuel J., Marshall Kirk McKusick, _The Design and Implementation of the 4.3BSD UNIX Operating System: Answer Book_. Reading, Mass. : Addison-Wesley, 1991. ISBN 0-201-54629-9
	* McKusick, Marshall Kirk, Keith Bostic, Michael J Karels, and John Quarterman. _The Design and Implementation of the 4.4BSD Operating System_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-54979-4
	+
	-(Chapter 2 of this book is available link:{design-44bsd}[online] as part of the FreeBSD Documentation Project.)
	+(Chapter 2 of this book is available extref:{design-44bsd}[online] as part of the FreeBSD Documentation Project.)
	* Marshall Kirk McKusick, George V. Neville-Neil _The Design and Implementation of the FreeBSD Operating System_. Boston, Mass. : Addison-Wesley, 2004. ISBN 0-201-70245-2
	* Marshall Kirk McKusick, George V. Neville-Neil, Robert N. M. Watson _The Design and Implementation of the FreeBSD Operating System, 2nd Ed._. Westford, Mass. : Pearson Education, Inc., 2014. ISBN 0-321-96897-2
	* Stevens, W. Richard. _TCP/IP Illustrated, Volume 1: The Protocols_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-63346-9
	diff --git a/documentation/content/en/books/handbook/book.adoc b/documentation/content/en/books/handbook/book.adoc
	--- a/documentation/content/en/books/handbook/book.adoc
	+++ b/documentation/content/en/books/handbook/book.adoc
	@@ -14,49 +14,30 @@
	:toc: macro
	:toclevels: 2
	:icons: font
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	:sectnums:
	:sectnumlevels: 6
	:partnums:
	-:chapter-signifier: Chapter
	-:part-signifier: Part
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	:book: true
	:pdf: false
	+:images-path: books/handbook/
	:pgpkeys-path: ../../../../../

	-ifeval::["{backend}" == "html5"]
	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-:chapters-path: content/en/books/handbook/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:chapters-path:
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+:chapters-path: content/{{% lang %}}/books/handbook/
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	:chapters-path:
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	@@ -79,97 +60,97 @@

	:sectnums!:

	-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=8..-1]
	+include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=9..18;35..-1]

	:sectnums:

	// Section one
	include::{chapters-path}parti.adoc[lines=7..18]

	-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	// Section two
	include::{chapters-path}partii.adoc[lines=7..18]

	-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}wine/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}wine/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	// Section three
	include::{chapters-path}partiii.adoc[lines=7..12]

	-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}zfs/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}zfs/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}dtrace/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}dtrace/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}usb-device-mode/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}usb-device-mode/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	// Section four
	include::{chapters-path}partiv.adoc[lines=7..19]

	-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
	+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=10..21;40..-1]

	// Section five
	include::{chapters-path}partv.adoc[lines=7..8]

	:sectnums!:

	-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=10..23;32..-1]
	+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=10..22;39..-1]

	-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=10..23;31..-1]
	+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=10..22;39..-1]

	-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=10..23;32..-1]
	+include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=10..22;39..-1]

	-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=10..23;33..-1]
	+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=10..22;40..-1]

	:sectnums:
	diff --git a/documentation/content/en/books/handbook/boot/_index.adoc b/documentation/content/en/books/handbook/boot/_index.adoc
	--- a/documentation/content/en/books/handbook/boot/_index.adoc
	+++ b/documentation/content/en/books/handbook/boot/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 13
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 13
	+:images-path: books/handbook/boot/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/boot/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/boot/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/boot/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[boot-synopsis]]
	diff --git a/documentation/content/en/books/handbook/bsdinstall/_index.adoc b/documentation/content/en/books/handbook/bsdinstall/_index.adoc
	--- a/documentation/content/en/books/handbook/bsdinstall/_index.adoc
	+++ b/documentation/content/en/books/handbook/bsdinstall/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 2
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 2
	+:images-path: books/handbook/bsdinstall/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/bsdinstall/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[bsdinstall-synopsis]]
	diff --git a/documentation/content/en/books/handbook/colophon.adoc b/documentation/content/en/books/handbook/colophon.adoc
	--- a/documentation/content/en/books/handbook/colophon.adoc
	+++ b/documentation/content/en/books/handbook/colophon.adoc
	@@ -8,14 +8,28 @@
	[[colophon]]
	= Colophon
	:doctype: book
	+:toc: macro
	+:toclevels: 1
	:icons: font
	:!sectnums:
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	+:images-path: books/handbook/colophon/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	This book is the combined work of hundreds of contributors to "The FreeBSD Documentation Project".
	The text is authored in AsciiDoc.
	diff --git a/documentation/content/en/books/handbook/config/_index.adoc b/documentation/content/en/books/handbook/config/_index.adoc
	--- a/documentation/content/en/books/handbook/config/_index.adoc
	+++ b/documentation/content/en/books/handbook/config/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 12
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 12
	+:images-path: books/handbook/config/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/x11/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/x11/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/x11/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[config-synopsis]]
	@@ -329,7 +323,7 @@
	By carefully setting these keywords for each startup script, an administrator has a fine-grained level of control of the startup order of the scripts, without the need for "runlevels" used by some UNIX(R) operating systems.

	Additional information can be found in man:rc[8] and man:rc.subr[8].
	-Refer to link:{rc-scripting}[this article] for instructions on how to create custom man:rc[8] scripts.
	+Refer to extref:{rc-scripting}[this article] for instructions on how to create custom man:rc[8] scripts.

	[[configtuning-core-configuration]]
	=== Managing System-Specific Configuration
	diff --git a/documentation/content/en/books/handbook/cutting-edge/_index.adoc b/documentation/content/en/books/handbook/cutting-edge/_index.adoc
	--- a/documentation/content/en/books/handbook/cutting-edge/_index.adoc
	+++ b/documentation/content/en/books/handbook/cutting-edge/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 24
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 24
	+:images-path: books/handbook/cutting-edge/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/cutting-edge/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[updating-upgrading-synopsis]]
	@@ -486,13 +480,13 @@
	This section describes how to use either source or the FreeBSD Ports Collection to keep a local copy of the FreeBSD documentation up-to-date.

	For information on editing and submitting corrections to the documentation,
	-refer to the FreeBSD Documentation Project Primer for New Contributors (link:{fdp-primer}[FreeBSD Documentation Project Primer for New Contributors]).
	+refer to the FreeBSD Documentation Project Primer for New Contributors (extref:{fdp-primer}[FreeBSD Documentation Project Primer for New Contributors]).

	[[updating-installed-documentation]]
	=== Updating Documentation from Source

	Rebuilding the FreeBSD documentation from source requires a collection of tools which are not part of the FreeBSD base system.
	-The required tools can be installed following link:{fdp-primer}#overview-quick-start[these steps] from the FreeBSD Documentation Project Primer.
	+The required tools can be installed following extref:{fdp-primer}[these steps, overview-quick-start] from the FreeBSD Documentation Project Primer.

	Once installed, use `git` to fetch a clean copy of the documentation source:

	diff --git a/documentation/content/en/books/handbook/desktop/_index.adoc b/documentation/content/en/books/handbook/desktop/_index.adoc
	--- a/documentation/content/en/books/handbook/desktop/_index.adoc
	+++ b/documentation/content/en/books/handbook/desktop/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 6
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 6
	+:images-path: books/handbook/desktop/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/desktop/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/desktop/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/desktop/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[desktop-synopsis]]
	diff --git a/documentation/content/en/books/handbook/disks/_index.adoc b/documentation/content/en/books/handbook/disks/_index.adoc
	--- a/documentation/content/en/books/handbook/disks/_index.adoc
	+++ b/documentation/content/en/books/handbook/disks/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 18
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 18
	+:images-path: books/handbook/disks/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/disks/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/disks/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/disks/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[disks-synopsis]]
	diff --git a/documentation/content/en/books/handbook/dtrace/_index.adoc b/documentation/content/en/books/handbook/dtrace/_index.adoc
	--- a/documentation/content/en/books/handbook/dtrace/_index.adoc
	+++ b/documentation/content/en/books/handbook/dtrace/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 25
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 25
	+:images-path: books/handbook/dtrace/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/dtrace/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/dtrace/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/dtrace/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[dtrace-synopsis]]
	diff --git a/documentation/content/en/books/handbook/eresources/_index.adoc b/documentation/content/en/books/handbook/eresources/_index.adoc
	--- a/documentation/content/en/books/handbook/eresources/_index.adoc
	+++ b/documentation/content/en/books/handbook/eresources/_index.adoc
	@@ -11,23 +11,30 @@
	[[eresources]]
	= Resources on the Internet
	:doctype: book
	+:toc: macro
	+:toclevels: 1
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: C
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: C
	+:images-path: books/handbook/eresources/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	The rapid pace of FreeBSD progress makes print media impractical as a means of following the latest developments.
	Electronic resources are the best, if not often the only, way to stay informed of the latest advances.
	@@ -60,9 +67,9 @@
	Please do not send test messages to any other list.
	====

	-When in doubt about what list to post a question to, see link:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list].
	+When in doubt about what list to post a question to, see extref:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list].

	-Before posting to any list, please learn about how to best use the mailing lists, such as how to help avoid frequently-repeated discussions, by reading the link:{mailing-list-faq}[Mailing List Frequently Asked Questions] (FAQ) document.
	+Before posting to any list, please learn about how to best use the mailing lists, such as how to help avoid frequently-repeated discussions, by reading the extref:{mailing-list-faq}[Mailing List Frequently Asked Questions] (FAQ) document.

	Archives are kept for all of the mailing lists and can be searched using the https://www.FreeBSD.org/search/[FreeBSD World Wide Web server].
	The keyword searchable archive offers an excellent way of finding answers to frequently asked questions and should be consulted before posting a question.
	diff --git a/documentation/content/en/books/handbook/filesystems/_index.adoc b/documentation/content/en/books/handbook/filesystems/_index.adoc
	--- a/documentation/content/en/books/handbook/filesystems/_index.adoc
	+++ b/documentation/content/en/books/handbook/filesystems/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 21
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 21
	+:images-path: books/handbook/filesystems/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/filesystems/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/filesystems/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/filesystems/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[filesystems-synopsis]]
	diff --git a/documentation/content/en/books/handbook/firewalls/_index.adoc b/documentation/content/en/books/handbook/firewalls/_index.adoc
	--- a/documentation/content/en/books/handbook/firewalls/_index.adoc
	+++ b/documentation/content/en/books/handbook/firewalls/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 31
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 31
	+:images-path: books/handbook/firewalls/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/firewalls/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/firewalls/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/firewalls/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[firewalls-intro]]
	diff --git a/documentation/content/en/books/handbook/geom/_index.adoc b/documentation/content/en/books/handbook/geom/_index.adoc
	--- a/documentation/content/en/books/handbook/geom/_index.adoc
	+++ b/documentation/content/en/books/handbook/geom/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 19
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 19
	+:images-path: books/handbook/geom/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/geom/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/geom/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/geom/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[geom-synopsis]]
	@@ -1296,4 +1290,4 @@
	Refer to man:gjournal[8] and man:tunefs[8] for more information about these commands.

	It is possible to journal the boot disk of a FreeBSD system.
	-Refer to the article link:{gjournal-desktop}[Implementing UFS Journaling on a Desktop PC] for detailed instructions.
	+Refer to the article extref:{gjournal-desktop}[Implementing UFS Journaling on a Desktop PC] for detailed instructions.
	diff --git a/documentation/content/en/books/handbook/glossary.adoc b/documentation/content/en/books/handbook/glossary.adoc
	--- a/documentation/content/en/books/handbook/glossary.adoc
	+++ b/documentation/content/en/books/handbook/glossary.adoc
	@@ -9,16 +9,28 @@
	[[freebsd-glossary]]
	= FreeBSD Glossary
	:doctype: book
	+:toc: macro
	+:toclevels: 1
	:icons: font
	:!sectnums:
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-
	-include::shared/en/urls.adoc[]
	+:images-path: books/handbook/glossary/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	This glossary contains terms and acronyms used within the FreeBSD community and documentation.

	@@ -144,7 +156,7 @@
	[[bikeshed-glossary]]
	Bikeshed Building::
	A phenomenon whereby many people will give an opinion on an uncomplicated topic, whilst a complex topic receives little or no discussion.
	-See the link:{faq}#bikeshed-painting[FAQ] for the origin of the term.
	+See the extref:{faq}[FAQ, bikeshed-painting] for the origin of the term.

	[discrete]
	== C
	@@ -767,7 +779,7 @@
	[[pr-glossary]]
	Problem Report::
	A description of some kind of problem that has been found in either the FreeBSD source or documentation.
	-See link:{problem-reports}[Writing FreeBSD Problem Reports].
	+See extref:{problem-reports}[Writing FreeBSD Problem Reports].

	[[pid-glossary]]
	Process ID::
	diff --git a/documentation/content/en/books/handbook/introduction/_index.adoc b/documentation/content/en/books/handbook/introduction/_index.adoc
	--- a/documentation/content/en/books/handbook/introduction/_index.adoc
	+++ b/documentation/content/en/books/handbook/introduction/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 1
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 1
	+:images-path: books/handbook/introduction/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/introduction/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/introduction/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/introduction/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[introduction-synopsis]]
	@@ -98,7 +92,7 @@
	* _Education:_ Are you a student of computer science or a related engineering field? There is no better way of learning about operating systems, computer architecture and networking than the hands on, under the hood experience that FreeBSD can provide. A number of freely available CAD, mathematical and graphic design packages also make it highly useful to those whose primary interest in a computer is to get _other_ work done!
	* _Research:_ With source code for the entire system available, FreeBSD is an excellent platform for research in operating systems as well as other branches of computer science. FreeBSD's freely available nature also makes it possible for remote groups to collaborate on ideas or shared development without having to worry about special licensing agreements or limitations on what may be discussed in open forums.
	* _Networking:_ Need a new router? A name server (DNS)? A firewall to keep people out of your internal network? FreeBSD can easily turn that unused PC sitting in the corner into an advanced router with sophisticated packet-filtering capabilities.
	-* _Embedded:_ FreeBSD makes an excellent platform to build embedded systems upon. With support for the ARM(R), MIPS(R) and PowerPC(R) platforms, coupled with a robust network stack, cutting edge features and the permissive link:{faq}#bsd-license-restrictions[BSD license] FreeBSD makes an excellent foundation for building embedded routers, firewalls, and other devices.
	+* _Embedded:_ FreeBSD makes an excellent platform to build embedded systems upon. With support for the ARM(R), MIPS(R) and PowerPC(R) platforms, coupled with a robust network stack, cutting edge features and the permissive extref:{faq}[BSD license, bsd-license-restrictions] FreeBSD makes an excellent foundation for building embedded routers, firewalls, and other devices.
	* _Desktop:_ FreeBSD makes a fine choice for an inexpensive desktop solution using the freely available X11 server. FreeBSD offers a choice from many open-source desktop environments, including the standard GNOME and KDE graphical user interfaces. FreeBSD can even boot "diskless" from a central server, making individual workstations even cheaper and easier to administer.
	* _Software Development:_ The basic FreeBSD system comes with a full suite of development tools including a full C/C++ compiler and debugger suite. Support for many other languages are also available through the ports and packages collection.

	@@ -205,7 +199,7 @@
	[[development]]
	=== The FreeBSD Development Model

	-The development of FreeBSD is a very open and flexible process, being literally built from the contributions of thousands of people around the world, as can be seen from our link:{contributors}[list of contributors].
	+The development of FreeBSD is a very open and flexible process, being literally built from the contributions of thousands of people around the world, as can be seen from our extref:{contributors}[list of contributors].
	FreeBSD's development infrastructure allow these thousands of contributors to collaborate over the Internet.
	We are constantly on the lookout for new developers and ideas, and those interested in becoming more closely involved with the project need simply contact us at the {freebsd-hackers}.
	The {freebsd-announce} is also available to those wishing to make other FreeBSD users aware of major areas of work.
	@@ -242,7 +236,7 @@
	The primary way of keeping in touch with FreeBSD's more non-centralized development is to subscribe to the {freebsd-hackers} where such things are discussed.
	See crossref:eresources[eresources, Resources on the Internet] for more information about the various FreeBSD mailing lists.
	+
	-link:{contributors}[The FreeBSD Contributors List] is a long and growing one, so why not join it by contributing something back to FreeBSD today?
	+extref:{contributors}[The FreeBSD Contributors List] is a long and growing one, so why not join it by contributing something back to FreeBSD today?
	+
	Providing code is not the only way of contributing to the project; for a more complete list of things that need doing, please refer to the link:https://www.FreeBSD.org/[FreeBSD Project web site].

	diff --git a/documentation/content/en/books/handbook/jails/_index.adoc b/documentation/content/en/books/handbook/jails/_index.adoc
	--- a/documentation/content/en/books/handbook/jails/_index.adoc
	+++ b/documentation/content/en/books/handbook/jails/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 15
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 15
	+:images-path: books/handbook/jails/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/jails/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/jails/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/jails/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[jails-synopsis]]
	diff --git a/documentation/content/en/books/handbook/kernelconfig/_index.adoc b/documentation/content/en/books/handbook/kernelconfig/_index.adoc
	--- a/documentation/content/en/books/handbook/kernelconfig/_index.adoc
	+++ b/documentation/content/en/books/handbook/kernelconfig/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 8
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 8
	+:images-path: books/handbook/kernelconfig/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/kernelconfig/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[kernelconfig-synopsis]]
	diff --git a/documentation/content/en/books/handbook/l10n/_index.adoc b/documentation/content/en/books/handbook/l10n/_index.adoc
	--- a/documentation/content/en/books/handbook/l10n/_index.adoc
	+++ b/documentation/content/en/books/handbook/l10n/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 23
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 23
	+:images-path: books/handbook/l10n/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/l10n/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/l10n/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/l10n/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[l10n-synopsis]]
	diff --git a/documentation/content/en/books/handbook/linuxemu/_index.adoc b/documentation/content/en/books/handbook/linuxemu/_index.adoc
	--- a/documentation/content/en/books/handbook/linuxemu/_index.adoc
	+++ b/documentation/content/en/books/handbook/linuxemu/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 10
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 10
	+:images-path: books/handbook/linuxemu/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/linuxemu/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[linuxemu-synopsis]]
	diff --git a/documentation/content/en/books/handbook/mac/_index.adoc b/documentation/content/en/books/handbook/mac/_index.adoc
	--- a/documentation/content/en/books/handbook/mac/_index.adoc
	+++ b/documentation/content/en/books/handbook/mac/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 16
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 16
	+:images-path: books/handbook/mac/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/mac/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/mac/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/mac/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[mac-synopsis]]
	diff --git a/documentation/content/en/books/handbook/mail/_index.adoc b/documentation/content/en/books/handbook/mail/_index.adoc
	--- a/documentation/content/en/books/handbook/mail/_index.adoc
	+++ b/documentation/content/en/books/handbook/mail/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 29
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 29
	+:images-path: books/handbook/mail/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/mail/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/mail/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/mail/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[mail-synopsis]]
	diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc
	--- a/documentation/content/en/books/handbook/mirrors/_index.adoc
	+++ b/documentation/content/en/books/handbook/mirrors/_index.adoc
	@@ -11,23 +11,30 @@
	[[mirrors]]
	= Obtaining FreeBSD
	:doctype: book
	+:toc: macro
	+:toclevels: 1
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: A
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: A
	+:images-path: books/handbook/mirrors/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[[mirrors-cdrom]]
	== CD and DVD Sets
	@@ -577,7 +584,7 @@

	=== For Developers

	-Please see the link:{committers-guide}#git-mini-primer[Committer's Guide].
	+Please see the extref:{committers-guide}[Committer's Guide, git-mini-primer].

	[[external-mirrors]]
	=== External mirrors
	@@ -616,7 +623,7 @@
	- https://lists.freebsd.org/mailman/listinfo/dev-commits-src-branches[dev-commits-src-branches]: All changes to all stable branches of the src repository

	For more information, please refer to the "Commit message lists" section of C.2.
	-"Mailing Lists" in handbook: https://docs.freebsd.org/en/books/handbook/eresources/#eresources-mail
	+"Mailing Lists" in handbook: crossref:handbook/eresources[eresources-mail, Mailing lists].

	[[svn]]
	== Using Subversion
	diff --git a/documentation/content/en/books/handbook/multimedia/_index.adoc b/documentation/content/en/books/handbook/multimedia/_index.adoc
	--- a/documentation/content/en/books/handbook/multimedia/_index.adoc
	+++ b/documentation/content/en/books/handbook/multimedia/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 7
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 7
	+:images-path: books/handbook/multimedia/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/multimedia/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/multimedia/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/multimedia/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[multimedia-synopsis]]
	diff --git a/documentation/content/en/books/handbook/network-servers/_index.adoc b/documentation/content/en/books/handbook/network-servers/_index.adoc
	--- a/documentation/content/en/books/handbook/network-servers/_index.adoc
	+++ b/documentation/content/en/books/handbook/network-servers/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 30
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 30
	+:images-path: books/handbook/network-servers/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/network-servers/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/network-servers/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/network-servers/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[network-servers-synopsis]]
	@@ -1317,7 +1311,7 @@
	# pkg install openldap-server
	....

	-There is a large set of default options enabled in the link:{linux-users}#software[package].
	+There is a large set of default options enabled in the extref:{linux-users}[package, software].
	Review them by running `pkg info openldap-server`.
	If they are not sufficient (for example if SQL support is needed), please consider recompiling the port using the appropriate crossref:ports[ports-using,framework].

	diff --git a/documentation/content/en/books/handbook/pgpkeys/_index.adoc b/documentation/content/en/books/handbook/pgpkeys/_index.adoc
	--- a/documentation/content/en/books/handbook/pgpkeys/_index.adoc
	+++ b/documentation/content/en/books/handbook/pgpkeys/_index.adoc
	@@ -11,28 +11,35 @@
	[[pgpkeys]]
	= OpenPGP Keys
	:doctype: book
	+:toc: macro
	+:toclevels: 1
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: B
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: D
	+:images-path: books/handbook/pgpkeys/
	+:pgpkeys-path:

	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]

	-:pgpkeys-path:
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	The OpenPGP keys of the `FreeBSD.org` officers are shown here.
	These keys can be used to verify a signature or send encrypted email to one of the officers.
	-A full list of FreeBSD OpenPGP keys is available in the link:{pgpkeys}[PGP Keys] article.
	+A full list of FreeBSD OpenPGP keys is available in the extref:{pgpkeys}[PGP Keys] article.
	The complete keyring can be downloaded at link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].

	[[pgpkeys-officers]]
	diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc
	--- a/documentation/content/en/books/handbook/ports/_index.adoc
	+++ b/documentation/content/en/books/handbook/ports/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 4
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 4
	+:images-path: books/handbook/ports/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/ports/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/ports/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/ports/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[ports-synopsis]]
	@@ -649,7 +643,7 @@
	* [.filename]#pkg-plist#: a list of all the files that will be installed by the port. It also tells the ports system which files to remove upon deinstallation.

	Some ports include [.filename]#pkg-message# or other files to handle special situations.
	-For more details on these files, and on ports in general, refer to the link:{porters-handbook}[FreeBSD Porter's Handbook].
	+For more details on these files, and on ports in general, refer to the extref:{porters-handbook}[FreeBSD Porter's Handbook].

	The port does not include the actual source code, also known as a [.filename]#distfile#.
	The extract portion of building a port will automatically save the downloaded source to [.filename]#/usr/ports/distfiles#.
	@@ -714,7 +708,7 @@

	If more control over the ports tree is needed or if local changes need to be maintained, or if running FreeBSD-CURRENT,
	Git can be used to obtain the Ports Collection.
	-Refer to link:{committers-guide}#git-primer[the Git Primer] for a detailed description of Git.
	+Refer to extref:{committers-guide}[the Git Primer, git-primer] for a detailed description of Git.

	. Git must be installed before it can be used to check out the ports tree. If a copy of the ports tree is already present, install Git like this:
	+
	@@ -1325,7 +1319,7 @@
	+
	[NOTE]
	====
	-Some ports are not maintained by an individual but instead by a group maintainer represented by a link:{mailing-list-faq}[mailing list].
	+Some ports are not maintained by an individual but instead by a group maintainer represented by a extref:{mailing-list-faq}[mailing list].
	Many, but not all, of these addresses look like mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org].
	Please take this into account when sending an email.

	@@ -1333,6 +1327,6 @@
	Instead, any fixes and support come from the general community who subscribe to that mailing list. More volunteers are always needed!
	====
	+
	-If there is no response to the email, use Bugzilla to submit a bug report using the instructions in link:{problem-reports}[Writing FreeBSD Problem Reports].
	-. Fix it! The link:{porters-handbook}[Porter's Handbook] includes detailed information on the ports infrastructure so that you can fix the occasional broken port or even submit your own!
	+If there is no response to the email, use Bugzilla to submit a bug report using the instructions in extref:{problem-reports}[Writing FreeBSD Problem Reports].
	+. Fix it! The extref:{porters-handbook}[Porter's Handbook] includes detailed information on the ports infrastructure so that you can fix the occasional broken port or even submit your own!
	. Install the package instead of the port using the instructions in <<pkgng-intro>>.
	diff --git a/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc
	--- a/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc
	+++ b/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 28
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 28
	+:images-path: books/handbook/ppp-and-slip/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/ppp-and-slip/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[ppp-and-slip-synopsis]]
	diff --git a/documentation/content/en/books/handbook/preface/_index.adoc b/documentation/content/en/books/handbook/preface/_index.adoc
	--- a/documentation/content/en/books/handbook/preface/_index.adoc
	+++ b/documentation/content/en/books/handbook/preface/_index.adoc
	@@ -1,6 +1,6 @@
	---
	title: Preface
	-prev: books/handbook/
	+prev: books/handbook
	next: books/handbook/parti
	description: The FreeBSD newcomer will find that the first section of this book guides the user through the FreeBSD installation process and gently introduces the concepts and conventions that underpin UNIX
	tags: ["preface", "audience", "organization", "conventions", "acknowledgments"]
	@@ -13,12 +13,24 @@
	:toc: macro
	:toclevels: 1
	:icons: font
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	+:images-path: books/handbook/preface/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[[preface-audience]]
	== Intended Audience
	diff --git a/documentation/content/en/books/handbook/printing/_index.adoc b/documentation/content/en/books/handbook/printing/_index.adoc
	--- a/documentation/content/en/books/handbook/printing/_index.adoc
	+++ b/documentation/content/en/books/handbook/printing/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 9
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 9
	+:images-path: books/handbook/printing/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/printing/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/printing/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/printing/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	Putting information on paper is a vital function, despite many attempts to eliminate it.
	@@ -881,7 +875,7 @@
	=== CUPS (Common UNIX(R) Printing System)

	CUPS is a popular printing system available on many operating systems.
	-Using CUPS on FreeBSD is documented in a separate article: link:{cups}[CUPS]
	+Using CUPS on FreeBSD is documented in a separate article: extref:{cups}[CUPS]

	[[printing-other-hplip]]
	=== HPLIP
	diff --git a/documentation/content/en/books/handbook/security/_index.adoc b/documentation/content/en/books/handbook/security/_index.adoc
	--- a/documentation/content/en/books/handbook/security/_index.adoc
	+++ b/documentation/content/en/books/handbook/security/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 14
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 14
	+:images-path: books/handbook/security/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/security/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/security/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/security/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[security-synopsis]]
	diff --git a/documentation/content/en/books/handbook/serialcomms/_index.adoc b/documentation/content/en/books/handbook/serialcomms/_index.adoc
	--- a/documentation/content/en/books/handbook/serialcomms/_index.adoc
	+++ b/documentation/content/en/books/handbook/serialcomms/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 27
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 27
	+:images-path: books/handbook/serialcomms/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/serialcomms/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[serial-synopsis]]
	diff --git a/documentation/content/en/books/handbook/usb-device-mode/_index.adoc b/documentation/content/en/books/handbook/usb-device-mode/_index.adoc
	--- a/documentation/content/en/books/handbook/usb-device-mode/_index.adoc
	+++ b/documentation/content/en/books/handbook/usb-device-mode/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 26
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 26
	+:images-path: books/handbook/usb-device-mode/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/usb-device-mode/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/usb-device-mode/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/usb-device-mode/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[usb-device-mode-synopsis]]
	diff --git a/documentation/content/en/books/handbook/virtualization/_index.adoc b/documentation/content/en/books/handbook/virtualization/_index.adoc
	--- a/documentation/content/en/books/handbook/virtualization/_index.adoc
	+++ b/documentation/content/en/books/handbook/virtualization/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 22
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 22
	+:images-path: books/handbook/virtualization/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/virtualization/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/virtualization/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/virtualization/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[virtualization-synopsis]]
	diff --git a/documentation/content/en/books/handbook/wine/_index.adoc b/documentation/content/en/books/handbook/wine/_index.adoc
	--- a/documentation/content/en/books/handbook/wine/_index.adoc
	+++ b/documentation/content/en/books/handbook/wine/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 11
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 11
	+:images-path: books/handbook/wine/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/wine/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/wine/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/wine/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[wine-synopsis]]
	diff --git a/documentation/content/en/books/handbook/x11/_index.adoc b/documentation/content/en/books/handbook/x11/_index.adoc
	--- a/documentation/content/en/books/handbook/x11/_index.adoc
	+++ b/documentation/content/en/books/handbook/x11/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 5
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 5
	+:images-path: books/handbook/x11/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/x11/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/x11/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/x11/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	[[x11-synopsis]]
	@@ -1223,7 +1217,7 @@
	For an nVidia-based graphics card, the proprietary driver is required for good performance.
	Users of other graphics cards can skip this section and continue with the [.filename]#xorg.conf# configuration.

	-To determine which nVidia driver is needed see the link:{faq}#idp59950544[FAQ question on the subject].
	+To determine which nVidia driver is needed see the extref:{faq}[FAQ question on the subject, idp59950544].

	Having determined the correct driver to use for your card, installation is as simple as installing any other package.

	diff --git a/documentation/content/en/books/handbook/zfs/_index.adoc b/documentation/content/en/books/handbook/zfs/_index.adoc
	--- a/documentation/content/en/books/handbook/zfs/_index.adoc
	+++ b/documentation/content/en/books/handbook/zfs/_index.adoc
	@@ -15,32 +15,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 20
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 20
	+:images-path: books/handbook/zfs/

	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../../images/books/handbook/zfs/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/books/handbook/zfs/
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/books/handbook/zfs/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-include::shared/authors.adoc[]
	-include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-
	toc::[]

	The _Z File System_, or ZFS, is an advanced file system designed to overcome many of the major problems found in previous designs.
	diff --git a/documentation/content/en/books/porters-handbook/_index.adoc b/documentation/content/en/books/porters-handbook/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/_index.adoc
	@@ -9,6 +9,7 @@
	weight: 15
	tags: ["FreeBSD Porter's Handbook", "Porting", "FreeBSD Ports Collection"]
	add_single_page_link: true
	+isIndex: true
	---

	= FreeBSD Porter's Handbook
	@@ -18,8 +19,24 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	+:images-path: books/porters-handbook/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	'''

	diff --git a/documentation/content/en/books/porters-handbook/book.adoc b/documentation/content/en/books/porters-handbook/book.adoc
	--- a/documentation/content/en/books/porters-handbook/book.adoc
	+++ b/documentation/content/en/books/porters-handbook/book.adoc
	@@ -14,46 +14,29 @@
	:toc: macro
	:toclevels: 2
	:icons: font
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	:sectnums:
	:sectnumlevels: 6
	:partnums:
	-:chapter-signifier: Chapter
	-:part-signifier: Part
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	+:book: true
	+:pdf: false
	+:images-path: books/porters-handbook/

	-ifeval::["{backend}" == "html5"]
	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	-:chapters-path: content/en/books/porters-handbook/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	-:chapters-path:
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+:chapters-path: content/{{% lang %}}/books/porters-handbook/
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/mirrors.adoc[]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/en/mailing-lists.adoc[]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/en/urls.adoc[]
	+ifndef::env-beastie[]
	:chapters-path:
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	@@ -64,21 +47,21 @@

	include::{chapters-path}toc-examples.adoc[]

	-include::{chapters-path}porting-why/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}new-port/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}quick-porting/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}slow-porting/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}makefiles/_index.adoc[leveloffset=+1, lines=9..24;35..-1]
	-include::{chapters-path}special/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}flavors/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}plist/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}pkg-files/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}testing/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}upgrading/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}porting-dads/_index.adoc[leveloffset=+1, lines=9..25;36..-1]
	-include::{chapters-path}porting-samplem/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}order/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}keeping-up/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
	-include::{chapters-path}uses/_index.adoc[leveloffset=+1, lines=9..24;35..-1]
	-include::{chapters-path}versions/_index.adoc[leveloffset=+1, lines=8..22;33..-1]
	+include::{chapters-path}porting-why/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}new-port/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}quick-porting/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}slow-porting/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}makefiles/_index.adoc[leveloffset=+1, lines=9..21;40..-1]
	+include::{chapters-path}special/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}flavors/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}plist/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}pkg-files/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}testing/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}upgrading/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}porting-dads/_index.adoc[leveloffset=+1, lines=9..22;41..-1]
	+include::{chapters-path}porting-samplem/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}order/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}keeping-up/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}uses/_index.adoc[leveloffset=+1, lines=9..20;39..-1]
	+include::{chapters-path}versions/_index.adoc[leveloffset=+1, lines=8..19;38..-1]
	diff --git a/documentation/content/en/books/porters-handbook/flavors/_index.adoc b/documentation/content/en/books/porters-handbook/flavors/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/flavors/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/flavors/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 7
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 7
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/porters-handbook/keeping-up/_index.adoc b/documentation/content/en/books/porters-handbook/keeping-up/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/keeping-up/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/keeping-up/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 16
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 16
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
	@@ -14,21 +14,26 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 5
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 5
	:g-plus-plus: g++
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	@@ -1035,7 +1040,7 @@

	Our existing practice has been to avoid creating a new physical category unless either a large number of ports would logically belong to it, or the ports that would belong to it are a logically distinct group that is of limited general interest (for instance, categories related to spoken human languages), or preferably both.

	-The rationale for this is that such a change creates a link:{committers-guide}#ports[fair amount of work] for both the committers and also for all users who track changes to the Ports Collection.
	+The rationale for this is that such a change creates a extref:{committers-guide}[fair amount of work, ports] for both the committers and also for all users who track changes to the Ports Collection.
	In addition, proposed category changes just naturally seem to attract controversy.
	(Perhaps this is because there is no clear consensus on when a category is "too big", nor whether categories should lend themselves to browsing (and thus what number of categories would be an ideal number), and so forth.)

	@@ -1053,7 +1058,7 @@
	** (for extra credit, include the other files that have to change, as per the procedure in the Committer's Guide.)

	. Since it affects the ports infrastructure and involves moving and patching many ports but also possibly running regression tests on the build cluster, assign the PR to the {portmgr}.
	-. If that PR is approved, a committer will need to follow the rest of the procedure that is link:{committers-guide}#PORTS[outlined in the Committer's Guide].
	+. If that PR is approved, a committer will need to follow the rest of the procedure that is extref:{committers-guide}[outlined in the Committer's Guide, ports].

	Proposing a new virtual category is similar to the above but much less involved, since no ports will actually have to move.
	In this case, the only patches to include in the PR would be those to add the new category to `CATEGORIES` of the affected ports.
	@@ -2445,7 +2450,7 @@
	That merely confuses the Ports infrastructure and most tools using it.

	The maintainer is responsible for keeping the port up to date and making sure that it works correctly.
	-For a detailed description of the responsibilities of a port maintainer, refer to link:{contributing}#maintain-port[The challenge for port maintainers].
	+For a detailed description of the responsibilities of a port maintainer, refer to extref:{contributing}[The challenge for port maintainers, maintain-port].

	[NOTE]
	====
	@@ -2460,7 +2465,7 @@
	These fixes do not need approval from the maintainer.

	Blanket approval for most ports applies to fixes like infrastructure changes, or trivial and _tested_ build and runtime fixes.
	-The current list is available in link:{committers-guide}#ports-qa-misc-blanket-approval[Ports section of the Committer's Guide].
	+The current list is available in extref:{committers-guide}[Ports section of the Committer's Guide, ports-qa-misc-blanket-approval].
	====

	Other changes to the port will be sent to the maintainer for review and approval before being committed.
	diff --git a/documentation/content/en/books/porters-handbook/new-port/_index.adoc b/documentation/content/en/books/porters-handbook/new-port/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/new-port/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/new-port/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 2
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 2
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/porters-handbook/order/_index.adoc b/documentation/content/en/books/porters-handbook/order/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/order/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/order/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 15
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 15
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/porters-handbook/pkg-files/_index.adoc b/documentation/content/en/books/porters-handbook/pkg-files/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/pkg-files/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/pkg-files/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 9
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 9
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/porters-handbook/plist/_index.adoc b/documentation/content/en/books/porters-handbook/plist/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/plist/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/plist/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 8
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 8
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/porters-handbook/porting-dads/_index.adoc b/documentation/content/en/books/porters-handbook/porting-dads/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/porting-dads/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/porting-dads/_index.adoc
	@@ -14,22 +14,27 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 13
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 13
	:freebsd-version: __FreeBSD_version
	:freebsd: __FreeBSD__
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	@@ -38,13 +43,13 @@

	Here is a list of common dos and don'ts that are encountered during the porting process.
	Check the port against this list, but also check ports in the https://bugs.FreeBSD.org/search/[PR database] that others have submitted.
	-Submit any comments on ports as described in link:{contributing}#CONTRIB-GENERAL[Bug Reports and General Commentary].
	+Submit any comments on ports as described in extref:{contributing}[Bug Reports and General Commentary, CONTRIB-GENERAL].
	Checking ports in the PR database will both make it faster for us to commit them, and prove that you know what you are doing.

	[[porting-wrkdir]]
	== `WRKDIR`

	-Do not write anything to files outside `WRKDIR`. `WRKDIR` is the only place that is guaranteed to be writable during the port build (see link:{handbook}#PORTS-CD[ installing ports from a CDROM] for an example of building ports from a read-only tree).
	+Do not write anything to files outside `WRKDIR`. `WRKDIR` is the only place that is guaranteed to be writable during the port build (see extref:{handbook}[ installing ports from a CDROM, PORTS-CD] for an example of building ports from a read-only tree).
	The [.filename]##pkg-*## files can be modified by crossref:pkg-files[pkg-names,redefining a variable] rather than overwriting the file.

	[[porting-wrkdirprefix]]
	diff --git a/documentation/content/en/books/porters-handbook/porting-samplem/_index.adoc b/documentation/content/en/books/porters-handbook/porting-samplem/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/porting-samplem/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/porting-samplem/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 14
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 14
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/porters-handbook/porting-why/_index.adoc b/documentation/content/en/books/porters-handbook/porting-why/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/porting-why/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/porting-why/_index.adoc
	@@ -1,6 +1,6 @@
	---
	title: Chapter 1. Introduction
	-prev: books/porters-handbook/
	+prev: books/porters-handbook
	next: books/porters-handbook/new-port
	description: Why port a program to the FreeBSD Ports Collection
	tags: ["ports", "why porting"]
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 1
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 1
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc b/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 3
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 3
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	@@ -293,7 +298,7 @@
	To get a listing of _open_ port PRs, select _Open_ and _Ports & Packages_ in the search form, then click btn:[Search].

	After looking at the new port, we will reply if necessary, and commit it to the tree.
	-The submitter's name will also be added to the list of link:{contributors}#contrib-additional[Additional FreeBSD Contributors] and other files.
	+The submitter's name will also be added to the list of extref:{contributors}[Additional FreeBSD Contributors, contrib-additional] and other files.

	It is also possible to submit ports using a man:shar[1] file.
	Using the previous example with the `oneko` port above.
	diff --git a/documentation/content/en/books/porters-handbook/security/_index.adoc b/documentation/content/en/books/porters-handbook/security/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/security/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/security/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 12
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 12
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/porters-handbook/slow-porting/_index.adoc b/documentation/content/en/books/porters-handbook/slow-porting/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/slow-porting/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/slow-porting/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 4
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 4
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/porters-handbook/special/_index.adoc b/documentation/content/en/books/porters-handbook/special/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/special/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/special/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 6
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 6
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	@@ -4429,9 +4434,9 @@

	[.filename]#rc.d# scripts are used to start services on system startup, and to give administrators a standard way of stopping, starting and restarting the service.
	Ports integrate into the system [.filename]#rc.d# framework.
	-Details on its usage can be found in link:{handbook}#configtuning-rcd/[the rc.d Handbook chapter].
	+Details on its usage can be found in extref:{handbook}[the rc.d Handbook chapter, configtuning-rcd].
	Detailed explanation of the available commands is provided in man:rc[8] and man:rc.subr[8].
	-Finally, there is link:{rc-scripting}[an article] on practical aspects of [.filename]#rc.d# scripting.
	+Finally, there is extref:{rc-scripting}[an article] on practical aspects of [.filename]#rc.d# scripting.

	With a mythical port called _doorman_, which needs to start a _doormand_ daemon.
	Add the following to the [.filename]#Makefile#:
	diff --git a/documentation/content/en/books/porters-handbook/testing/_index.adoc b/documentation/content/en/books/porters-handbook/testing/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/testing/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/testing/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 10
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 10
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	@@ -252,7 +257,7 @@
	The server from where jails are installed and updated when using Subversion.
	Also used for ports tree when not using man:portsnap[8].
	Again, choose a nearby location.
	-A list of official Subversion mirrors can be found in the link:{handbook}#svn-mirrors[FreeBSD Handbook Subversion section].
	+A list of official Subversion mirrors can be found in the extref:{handbook}[FreeBSD Handbook Subversion section, svn-mirrors].

	[[testing-poudriere-create-jails]]
	=== Creating Poudriere Jails
	diff --git a/documentation/content/en/books/porters-handbook/upgrading/_index.adoc b/documentation/content/en/books/porters-handbook/upgrading/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/upgrading/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/upgrading/_index.adoc
	@@ -14,20 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 11
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 11
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	@@ -35,7 +40,7 @@
	The port might have already been updated to the new version.

	When working with more than a few ports, it will probably be easier to use Git to keep the whole ports collection up-to-date,
	-as described in the link:{handbook}#ports-using/[Handbook].
	+as described in the extref:{handbook}[Handbook, ports-using].
	This will have the added benefit of tracking all the port's dependencies.

	The next step is to see if there is an update already pending.
	@@ -83,7 +88,7 @@

	If the port is unmaintained, and you are actively using it, please consider volunteering to become its maintainer.
	FreeBSD has over 4000 ports without maintainers, and this is an area where more volunteers are always needed.
	-(For a detailed description of the responsibilities of maintainers, refer to the section in the link:{developers-handbook}#POLICIES-MAINTAINER[Developer's Handbook].)
	+(For a detailed description of the responsibilities of maintainers, refer to the section in the extref:{developers-handbook}[Developer's Handbook, POLICIES-MAINTAINER].)

	To submit the diff, use the https://bugs.freebsd.org/submit/[bug submit form] (product `Ports & Packages`, component `Individual Port(s)`).
	Always include the category with the port name, followed by colon, and brief descripton of the issue.
	@@ -91,7 +96,7 @@
	Please mention any added or deleted files in the message, as they have to be explicitly specified to man:git[1] when doing a commit.
	Do not compress or encode the diff.

	-Before submitting the bug, review the link:{problem-reports}#pr-writing/[ Writing the problem report] section in the Problem Reports article.
	+Before submitting the bug, review the extref:{problem-reports}[Writing the problem report, pr-writing] section in the Problem Reports article.
	It contains far more information about how to write useful problem reports.

	[IMPORTANT]
	@@ -127,7 +132,7 @@

	<.> This can be anywhere, of course. Building ports is not limited to within [.filename]#/usr/ports/#.

	-<.> https://git.FreeBSD.org/[git.FreeBSD.org] is the FreeBSD public Git server. See link:{handbook}mirrors/#git-url-table[FreeBSD Git Repository URL Table] for more information.
	+<.> https://git.FreeBSD.org/[git.FreeBSD.org] is the FreeBSD public Git server. See extref:{handbook}mirrors[FreeBSD Git Repository URL Table, git-url-table] for more information.

	While in the port directory, make any changes that are needed.
	If adding, moving, or removing a file, use `git` to track these changes:
	@@ -173,7 +178,7 @@
	`git add` or `git rm` must be run after the patch is applied.
	====

	-Send the patch following the link:{problem-reports}#pr-writing/[problem report submission guidelines].
	+Send the patch following the extref:{problem-reports}[problem report submission guidelines, pr-writing].

	[[moved-and-updating-files]]
	== UPDATING and MOVED
	diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/uses/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc
	@@ -14,21 +14,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 17
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 17
	-:c-plus-plus: c++
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/en/books/porters-handbook/versions/_index.adoc b/documentation/content/en/books/porters-handbook/versions/_index.adoc
	--- a/documentation/content/en/books/porters-handbook/versions/_index.adoc
	+++ b/documentation/content/en/books/porters-handbook/versions/_index.adoc
	@@ -13,20 +13,25 @@
	:icons: font
	:sectnums:
	:sectnumlevels: 6
	+:sectnumoffset: 18
	+:partnums:
	:source-highlighter: rouge
	:experimental:
	-:skip-front-matter:
	-:xrefstyle: basic
	-:relfileprefix: ../
	-:outfilesuffix:
	-:sectnumoffset: 18
	+:images-path: books/porters-handbook/

	-include::shared/mirrors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/en/mailing-lists.adoc[]
	-include::shared/en/teams.adoc[]
	-include::shared/en/urls.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+include::shared/attributes/attributes-{{% lang %}}.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	toc::[]

	diff --git a/documentation/content/es/articles/bsdl-gpl/_index.adoc b/documentation/content/es/articles/bsdl-gpl/_index.adoc
	--- a/documentation/content/es/articles/bsdl-gpl/_index.adoc
	+++ b/documentation/content/es/articles/bsdl-gpl/_index.adoc
	@@ -18,6 +18,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/bsdl-gpl/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	'''

	diff --git a/documentation/content/es/articles/building-products/_index.adoc b/documentation/content/es/articles/building-products/_index.adoc
	--- a/documentation/content/es/articles/building-products/_index.adoc
	+++ b/documentation/content/es/articles/building-products/_index.adoc
	@@ -21,27 +21,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/building-products/

	-
	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/es/mailing-lists.adoc[]
	-include::shared/es/urls.adoc[]
	-:imagesdir: ../../../images/articles/building-products/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/es/mailing-lists.adoc[]
	-include::../../../../shared/es/urls.adoc[]
	-:imagesdir: ../../../../static/images/articles/building-products/
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/releases.adoc[]
	-include::../../../../shared/es/mailing-lists.adoc[]
	-include::../../../../shared/es/urls.adoc[]
	-:imagesdir: ../../../../static/images/articles/building-products/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/es/articles/contributing/_index.adoc b/documentation/content/es/articles/contributing/_index.adoc
	--- a/documentation/content/es/articles/contributing/_index.adoc
	+++ b/documentation/content/es/articles/contributing/_index.adoc
	@@ -17,16 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	-
	-include::shared/es/urls.adoc[]
	+:images-path: articles/contributing/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumen
	diff --git a/documentation/content/es/articles/contributors/_index.adoc b/documentation/content/es/articles/contributors/_index.adoc
	--- a/documentation/content/es/articles/contributors/_index.adoc
	+++ b/documentation/content/es/articles/contributors/_index.adoc
	@@ -11,26 +11,24 @@
	:toclevels: 1
	:icons: font
	:sectnums:
	+:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:sectnumlevels: 6
	+:images-path: articles/contributors/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/es/urls.adoc[]
	-:include-path: content/es/articles/contributors/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/es/urls.adoc[]
	-:include-path:
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+:include-path: content/{{% lang %}}/articles/contributors/
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/es/urls.adoc[]
	+ifndef::env-beastie[]
	:include-path:
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/es/articles/cups/_index.adoc b/documentation/content/es/articles/cups/_index.adoc
	--- a/documentation/content/es/articles/cups/_index.adoc
	+++ b/documentation/content/es/articles/cups/_index.adoc
	@@ -16,14 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	+:images-path: articles/cups/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumen
	diff --git a/documentation/content/es/articles/explaining-bsd/_index.adoc b/documentation/content/es/articles/explaining-bsd/_index.adoc
	--- a/documentation/content/es/articles/explaining-bsd/_index.adoc
	+++ b/documentation/content/es/articles/explaining-bsd/_index.adoc
	@@ -16,14 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	+:images-path: articles/explaining-bsd/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumen
	diff --git a/documentation/content/es/articles/filtering-bridges/_index.adoc b/documentation/content/es/articles/filtering-bridges/_index.adoc
	--- a/documentation/content/es/articles/filtering-bridges/_index.adoc
	+++ b/documentation/content/es/articles/filtering-bridges/_index.adoc
	@@ -16,14 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	+:images-path: articles/filtering-bridges/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	include::shared/es/urls.adoc[]

	diff --git a/documentation/content/es/articles/fonts/_index.adoc b/documentation/content/es/articles/fonts/_index.adoc
	--- a/documentation/content/es/articles/fonts/_index.adoc
	+++ b/documentation/content/es/articles/fonts/_index.adoc
	@@ -17,14 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	+:images-path: articles/fonts/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumen
	diff --git a/documentation/content/es/articles/freebsd-questions/_index.adoc b/documentation/content/es/articles/freebsd-questions/_index.adoc
	--- a/documentation/content/es/articles/freebsd-questions/_index.adoc
	+++ b/documentation/content/es/articles/freebsd-questions/_index.adoc
	@@ -16,16 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	-
	-include::shared/es/urls.adoc[]
	+:images-path: articles/freebsd-questions/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumen
	diff --git a/documentation/content/es/articles/ipsec-must/_index.adoc b/documentation/content/es/articles/ipsec-must/_index.adoc
	--- a/documentation/content/es/articles/ipsec-must/_index.adoc
	+++ b/documentation/content/es/articles/ipsec-must/_index.adoc
	@@ -16,16 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	-
	-include::shared/es/urls.adoc[]
	+:images-path: articles/ipsec-must/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumen
	diff --git a/documentation/content/es/articles/leap-seconds/_index.adoc b/documentation/content/es/articles/leap-seconds/_index.adoc
	--- a/documentation/content/es/articles/leap-seconds/_index.adoc
	+++ b/documentation/content/es/articles/leap-seconds/_index.adoc
	@@ -12,16 +12,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	-
	-include::shared/es/urls.adoc[]
	+:images-path: articles/leap-seconds/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	'''

	diff --git a/documentation/content/es/articles/linux-users/_index.adoc b/documentation/content/es/articles/linux-users/_index.adoc
	--- a/documentation/content/es/articles/linux-users/_index.adoc
	+++ b/documentation/content/es/articles/linux-users/_index.adoc
	@@ -16,16 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	-
	-include::shared/es/urls.adoc[]
	+:images-path: articles/linux-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumen
	diff --git a/documentation/content/es/articles/mailing-list-faq/_index.adoc b/documentation/content/es/articles/mailing-list-faq/_index.adoc
	--- a/documentation/content/es/articles/mailing-list-faq/_index.adoc
	+++ b/documentation/content/es/articles/mailing-list-faq/_index.adoc
	@@ -15,16 +15,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	-
	-include::shared/es/urls.adoc[]
	+:images-path: articles/mailing-list-faq/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumen
	diff --git a/documentation/content/es/articles/nanobsd/_index.adoc b/documentation/content/es/articles/nanobsd/_index.adoc
	--- a/documentation/content/es/articles/nanobsd/_index.adoc
	+++ b/documentation/content/es/articles/nanobsd/_index.adoc
	@@ -16,14 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	+:images-path: articles/nanobsd/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumen
	diff --git a/documentation/content/es/articles/port-mentor-guidelines/_index.adoc b/documentation/content/es/articles/port-mentor-guidelines/_index.adoc
	--- a/documentation/content/es/articles/port-mentor-guidelines/_index.adoc
	+++ b/documentation/content/es/articles/port-mentor-guidelines/_index.adoc
	@@ -16,16 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	-
	-include::shared/es/urls.adoc[]
	+:images-path: articles/port-mentor-guidelines/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	'''

	diff --git a/documentation/content/es/articles/pr-guidelines/_index.adoc b/documentation/content/es/articles/pr-guidelines/_index.adoc
	--- a/documentation/content/es/articles/pr-guidelines/_index.adoc
	+++ b/documentation/content/es/articles/pr-guidelines/_index.adoc
	@@ -16,16 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	-
	-include::shared/es/urls.adoc[]
	+:images-path: articles/pr-guidelines/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumen
	diff --git a/documentation/content/es/articles/problem-reports/_index.adoc b/documentation/content/es/articles/problem-reports/_index.adoc
	--- a/documentation/content/es/articles/problem-reports/_index.adoc
	+++ b/documentation/content/es/articles/problem-reports/_index.adoc
	@@ -16,16 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	-
	-include::shared/es/urls.adoc[]
	+:images-path: articles/problem-reports/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumen
	diff --git a/documentation/content/es/articles/releng/_index.adoc b/documentation/content/es/articles/releng/_index.adoc
	--- a/documentation/content/es/articles/releng/_index.adoc
	+++ b/documentation/content/es/articles/releng/_index.adoc
	@@ -17,32 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:xrefstyle: full
	-: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
	+:images-path: articles/releng/

	-include::shared/releases.adoc[]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/es/teams.adoc[]
	-include::shared/es/mailing-lists.adoc[]
	-include::shared/es/urls.adoc[]
	-
	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../images/articles/releng/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/articles/releng/
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/releng/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/es/articles/remote-install/_index.adoc b/documentation/content/es/articles/remote-install/_index.adoc
	--- a/documentation/content/es/articles/remote-install/_index.adoc
	+++ b/documentation/content/es/articles/remote-install/_index.adoc
	@@ -17,16 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	-
	-include::shared/es/urls.adoc[]
	+:images-path: articles/remote-install/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumen
	diff --git a/documentation/content/es/articles/solid-state/_index.adoc b/documentation/content/es/articles/solid-state/_index.adoc
	--- a/documentation/content/es/articles/solid-state/_index.adoc
	+++ b/documentation/content/es/articles/solid-state/_index.adoc
	@@ -17,14 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-: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
	+:images-path: articles/solid-state/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumen
	diff --git a/documentation/content/es/articles/vinum/_index.adoc b/documentation/content/es/articles/vinum/_index.adoc
	--- a/documentation/content/es/articles/vinum/_index.adoc
	+++ b/documentation/content/es/articles/vinum/_index.adoc
	@@ -16,20 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/es/urls.adoc[]
	-:imagesdir: ../../../images/articles/vinum/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/es/urls.adoc[]
	-:imagesdir: ../../../../static/images/articles/vinum/
	+:images-path: articles/vinum/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/vinum/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	diff --git a/documentation/content/es/articles/vm-design/_index.adoc b/documentation/content/es/articles/vm-design/_index.adoc
	--- a/documentation/content/es/articles/vm-design/_index.adoc
	+++ b/documentation/content/es/articles/vm-design/_index.adoc
	@@ -18,17 +18,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-
	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../images/articles/vm-design/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/articles/vm-design/
	+:images-path: articles/vm-design/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/vm-design/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/es/books/faq/_index.adoc b/documentation/content/es/books/faq/_index.adoc
	--- a/documentation/content/es/books/faq/_index.adoc
	+++ b/documentation/content/es/books/faq/_index.adoc
	@@ -3,7 +3,8 @@
	authors:
	- author: El proyecto de documentación de FreeBSD
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	+isIndex: true
	---

	= Preguntas Frecuentes para FreeBSD 9.X y 10.X
	diff --git a/documentation/content/es/books/handbook/_index.adoc b/documentation/content/es/books/handbook/_index.adoc
	--- a/documentation/content/es/books/handbook/_index.adoc
	+++ b/documentation/content/es/books/handbook/_index.adoc
	@@ -6,6 +6,7 @@
	releaseinfo: "$FreeBSD$"
	trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
	next: books/handbook/preface
	+isIndex: true
	---

	= Manual de FreeBSD
	diff --git a/documentation/content/fr/articles/building-products/_index.adoc b/documentation/content/fr/articles/building-products/_index.adoc
	--- a/documentation/content/fr/articles/building-products/_index.adoc
	+++ b/documentation/content/fr/articles/building-products/_index.adoc
	@@ -18,30 +18,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Table des matières
	-:part-signifier: Partie
	-:chapter-signifier: Chapitre
	-:appendix-caption: Annexe
	-:table-caption: Tableau
	-:example-caption: Exemple
	+:images-path: articles/building-products/

	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/fr/urls.adoc[]
	-include::shared/fr/mailing-lists.adoc[]
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-:imagesdir: ../../../images/articles/building-products/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/fr/mailing-lists.adoc[]
	-include::../../../../shared/fr/urls.adoc[]
	-include::../../../../shared/releases.adoc[]
	-:imagesdir: ../../../../static/images/articles/building-products/
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/building-products/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/fr/articles/committers-guide/_index.adoc b/documentation/content/fr/articles/committers-guide/_index.adoc
	--- a/documentation/content/fr/articles/committers-guide/_index.adoc
	+++ b/documentation/content/fr/articles/committers-guide/_index.adoc
	@@ -16,29 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Table des matières
	-:part-signifier: Partie
	-:chapter-signifier: Chapitre
	-:appendix-caption: Annexe
	-:table-caption: Tableau
	-:example-caption: Exemple
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/authors.adoc[]
	-include::shared/fr/mailing-lists.adoc[lines=11..-1]
	-include::shared/fr/urls.adoc[]
	-endif::[]
	+:images-path: articles/committers-guide/

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/fr/mailing-lists.adoc[lines=11..-1]
	-include::../../../../shared/fr/urls.adoc[]
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/fr/mailing-lists.adoc[lines=11..-1]
	-include::../../../../shared/fr/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/fr/articles/contributing/_index.adoc b/documentation/content/fr/articles/contributing/_index.adoc
	--- a/documentation/content/fr/articles/contributing/_index.adoc
	+++ b/documentation/content/fr/articles/contributing/_index.adoc
	@@ -15,26 +15,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Table des matières
	-:part-signifier: Partie
	-:chapter-signifier: Chapitre
	-:appendix-caption: Annexe
	-:table-caption: Tableau
	-:example-caption: Exemple
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/fr/urls.adoc[]
	-include::shared/fr/mailing-lists.adoc[lines=11..-1]
	+:images-path: articles/contributing/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/fr/urls.adoc[]
	-include::../../../../shared/fr/mailing-lists.adoc[lines=11..-1]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/fr/urls.adoc[]
	-include::../../../../shared/fr/mailing-lists.adoc[lines=11..-1]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/fr/articles/explaining-bsd/_index.adoc b/documentation/content/fr/articles/explaining-bsd/_index.adoc
	--- a/documentation/content/fr/articles/explaining-bsd/_index.adoc
	+++ b/documentation/content/fr/articles/explaining-bsd/_index.adoc
	@@ -16,12 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Table des matières
	-:part-signifier: Partie
	-:chapter-signifier: Chapitre
	-:appendix-caption: Annexe
	-:table-caption: Tableau
	-:example-caption: Exemple
	+:images-path: articles/explaining-bsd/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Résumé
	diff --git a/documentation/content/fr/articles/filtering-bridges/_index.adoc b/documentation/content/fr/articles/filtering-bridges/_index.adoc
	--- a/documentation/content/fr/articles/filtering-bridges/_index.adoc
	+++ b/documentation/content/fr/articles/filtering-bridges/_index.adoc
	@@ -16,23 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Table des matières
	-:part-signifier: Partie
	-:chapter-signifier: Chapitre
	-:appendix-caption: Annexe
	-:table-caption: Tableau
	-:example-caption: Exemple
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/fr/urls.adoc[]
	+:images-path: articles/filtering-bridges/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/fr/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/fr/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/fr/articles/fonts/_index.adoc b/documentation/content/fr/articles/fonts/_index.adoc
	--- a/documentation/content/fr/articles/fonts/_index.adoc
	+++ b/documentation/content/fr/articles/fonts/_index.adoc
	@@ -17,12 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Table des matières
	-:part-signifier: Partie
	-:chapter-signifier: Chapitre
	-:appendix-caption: Annexe
	-:table-caption: Tableau
	-:example-caption: Exemple
	+:images-path: articles/fonts/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Résumé
	diff --git a/documentation/content/fr/articles/ipsec-must/_index.adoc b/documentation/content/fr/articles/ipsec-must/_index.adoc
	--- a/documentation/content/fr/articles/ipsec-must/_index.adoc
	+++ b/documentation/content/fr/articles/ipsec-must/_index.adoc
	@@ -16,23 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Table des matières
	-:part-signifier: Partie
	-:chapter-signifier: Chapitre
	-:appendix-caption: Annexe
	-:table-caption: Tableau
	-:example-caption: Exemple
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/fr/urls.adoc[]
	+:images-path: articles/ipsec-must/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/fr/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/fr/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/fr/articles/leap-seconds/_index.adoc b/documentation/content/fr/articles/leap-seconds/_index.adoc
	--- a/documentation/content/fr/articles/leap-seconds/_index.adoc
	+++ b/documentation/content/fr/articles/leap-seconds/_index.adoc
	@@ -12,23 +12,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Table des matières
	-:part-signifier: Partie
	-:chapter-signifier: Chapitre
	-:appendix-caption: Annexe
	-:table-caption: Tableau
	-:example-caption: Exemple
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/fr/urls.adoc[]
	+:images-path: articles/leap-seconds/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/fr/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/fr/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	diff --git a/documentation/content/fr/articles/linux-users/_index.adoc b/documentation/content/fr/articles/linux-users/_index.adoc
	--- a/documentation/content/fr/articles/linux-users/_index.adoc
	+++ b/documentation/content/fr/articles/linux-users/_index.adoc
	@@ -16,23 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Table des matières
	-:part-signifier: Partie
	-:chapter-signifier: Chapitre
	-:appendix-caption: Annexe
	-:table-caption: Tableau
	-:example-caption: Exemple
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/fr/urls.adoc[]
	+:images-path: articles/linux-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/fr/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/fr/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/fr/articles/nanobsd/_index.adoc b/documentation/content/fr/articles/nanobsd/_index.adoc
	--- a/documentation/content/fr/articles/nanobsd/_index.adoc
	+++ b/documentation/content/fr/articles/nanobsd/_index.adoc
	@@ -16,23 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Table des matières
	-:part-signifier: Partie
	-:chapter-signifier: Chapitre
	-:appendix-caption: Annexe
	-:table-caption: Tableau
	-:example-caption: Exemple
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/authors.adoc[]
	-endif::[]
	+:images-path: articles/nanobsd/

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/fr/articles/new-users/_index.adoc b/documentation/content/fr/articles/new-users/_index.adoc
	--- a/documentation/content/fr/articles/new-users/_index.adoc
	+++ b/documentation/content/fr/articles/new-users/_index.adoc
	@@ -16,23 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Table des matières
	-:part-signifier: Partie
	-:chapter-signifier: Chapitre
	-:appendix-caption: Annexe
	-:table-caption: Tableau
	-:example-caption: Exemple
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/fr/urls.adoc[]
	+:images-path: articles/new-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/fr/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/fr/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/fr/articles/pam/_index.adoc b/documentation/content/fr/articles/pam/_index.adoc
	--- a/documentation/content/fr/articles/pam/_index.adoc
	+++ b/documentation/content/fr/articles/pam/_index.adoc
	@@ -16,12 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Table des matières
	-:part-signifier: Partie
	-:chapter-signifier: Chapitre
	-:appendix-caption: Annexe
	-:table-caption: Tableau
	-:example-caption: Exemple
	+:images-path: articles/pam/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Abstract
	diff --git a/documentation/content/fr/articles/pr-guidelines/_index.adoc b/documentation/content/fr/articles/pr-guidelines/_index.adoc
	--- a/documentation/content/fr/articles/pr-guidelines/_index.adoc
	+++ b/documentation/content/fr/articles/pr-guidelines/_index.adoc
	@@ -16,12 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Table des matières
	-:part-signifier: Partie
	-:chapter-signifier: Chapitre
	-:appendix-caption: Annexe
	-:table-caption: Tableau
	-:example-caption: Exemple
	+:images-path: articles/pr-guidelines/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Résumé
	diff --git a/documentation/content/fr/articles/problem-reports/_index.adoc b/documentation/content/fr/articles/problem-reports/_index.adoc
	--- a/documentation/content/fr/articles/problem-reports/_index.adoc
	+++ b/documentation/content/fr/articles/problem-reports/_index.adoc
	@@ -16,12 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Table des matières
	-:part-signifier: Partie
	-:chapter-signifier: Chapitre
	-:appendix-caption: Annexe
	-:table-caption: Tableau
	-:example-caption: Exemple
	+:images-path: articles/problem-reports/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Résumé
	diff --git a/documentation/content/fr/books/developers-handbook/_index.adoc b/documentation/content/fr/books/developers-handbook/_index.adoc
	--- a/documentation/content/fr/books/developers-handbook/_index.adoc
	+++ b/documentation/content/fr/books/developers-handbook/_index.adoc
	@@ -4,7 +4,8 @@
	- author: Le groupe du projet de documentation FreeBSD
	copyright: 1995-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
	+trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
	+isIndex: true
	---

	= Livre de chevet du développeur FreeBSD
	diff --git a/documentation/content/fr/books/faq/_index.adoc b/documentation/content/fr/books/faq/_index.adoc
	--- a/documentation/content/fr/books/faq/_index.adoc
	+++ b/documentation/content/fr/books/faq/_index.adoc
	@@ -4,7 +4,8 @@
	- author: The FreeBSD Documentation Project
	copyright: 1995-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	+isIndex: true
	---

	= Questions Fréquemment Posées sur FreeBSD 2.X, 3.X et 4.X
	diff --git a/documentation/content/fr/books/handbook/_index.adoc b/documentation/content/fr/books/handbook/_index.adoc
	--- a/documentation/content/fr/books/handbook/_index.adoc
	+++ b/documentation/content/fr/books/handbook/_index.adoc
	@@ -4,6 +4,7 @@
	releaseinfo: "$FreeBSD$"
	trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
	next: books/handbook/preface
	+isIndex: true
	---

	= Manuel FreeBSD
	diff --git a/documentation/content/hu/articles/cups/_index.adoc b/documentation/content/hu/articles/cups/_index.adoc
	--- a/documentation/content/hu/articles/cups/_index.adoc
	+++ b/documentation/content/hu/articles/cups/_index.adoc
	@@ -16,10 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Tartalom
	-:table-caption: Táblázat
	-:figure-caption: Ábra
	-:example-caption: Példa
	+:images-path: articles/cups/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Kivonat
	diff --git a/documentation/content/hu/articles/explaining-bsd/_index.adoc b/documentation/content/hu/articles/explaining-bsd/_index.adoc
	--- a/documentation/content/hu/articles/explaining-bsd/_index.adoc
	+++ b/documentation/content/hu/articles/explaining-bsd/_index.adoc
	@@ -16,21 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Tartalom
	-:table-caption: Táblázat
	-:figure-caption: Ábra
	-:example-caption: Példa
	+:images-path: articles/explaining-bsd/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/hu/articles/gjournal-desktop/_index.adoc b/documentation/content/hu/articles/gjournal-desktop/_index.adoc
	--- a/documentation/content/hu/articles/gjournal-desktop/_index.adoc
	+++ b/documentation/content/hu/articles/gjournal-desktop/_index.adoc
	@@ -17,33 +17,21 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Tartalom
	-:table-caption: Táblázat
	-:figure-caption: Ábra
	-:example-caption: Példa
	+:images-path: articles/gjournal-desktop/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/hu/mailing-lists.adoc[]
	-include::shared/hu/urls.adoc[]
	-:imagesdir: ../../../images/articles/gjournal-desktop/
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/hu/mailing-lists.adoc[]
	-include::../../../../shared/hu/urls.adoc[]
	-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/hu/mailing-lists.adoc[]
	-include::../../../../shared/hu/urls.adoc[]
	-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
	-endif::[]
	-
	-
	[.abstract-title]
	Kivonat

	diff --git a/documentation/content/hu/articles/linux-users/_index.adoc b/documentation/content/hu/articles/linux-users/_index.adoc
	--- a/documentation/content/hu/articles/linux-users/_index.adoc
	+++ b/documentation/content/hu/articles/linux-users/_index.adoc
	@@ -16,21 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Tartalom
	-:table-caption: Táblázat
	-:figure-caption: Ábra
	-:example-caption: Példa
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/hu/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/hu/urls.adoc[]
	+:images-path: articles/linux-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/hu/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/hu/books/faq/_index.adoc b/documentation/content/hu/books/faq/_index.adoc
	--- a/documentation/content/hu/books/faq/_index.adoc
	+++ b/documentation/content/hu/books/faq/_index.adoc
	@@ -4,7 +4,8 @@
	- author: A FreeBSD Dokumentációs Projekt
	copyright: 1995-2020 A FreeBSD Dokumentációs Projekt
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "ibm", "ieee", "3com", "adobe", "intel", "linux", "microsoft", "opengroup", "sparc", "sun", "oracle", "xfree86", "general"]
	+trademarks: ["freebsd", "ibm", "ieee", "3com", "adobe", "intel", "linux", "microsoft", "opengroup", "sparc", "sun", "oracle", "xfree86", "general"]
	+isIndex: true
	---

	= Gyakran Ismételt Kérdések a FreeBSD 6.X, 7.X és 8.X változatairól
	diff --git a/documentation/content/hu/books/handbook/_index.adoc b/documentation/content/hu/books/handbook/_index.adoc
	--- a/documentation/content/hu/books/handbook/_index.adoc
	+++ b/documentation/content/hu/books/handbook/_index.adoc
	@@ -6,6 +6,7 @@
	releaseinfo: "$FreeBSD$"
	trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
	next: books/handbook/preface
	+isIndex: true
	---

	= FreeBSD kézikönyv
	diff --git a/documentation/content/it/articles/bsdl-gpl/_index.adoc b/documentation/content/it/articles/bsdl-gpl/_index.adoc
	--- a/documentation/content/it/articles/bsdl-gpl/_index.adoc
	+++ b/documentation/content/it/articles/bsdl-gpl/_index.adoc
	@@ -16,13 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Indice
	-:part-signifier: Parte
	-:chapter-signifier: Capitolo
	-:appendix-caption: Appendice
	-:table-caption: Tabella
	-:figure-caption: Figura
	-:example-caption: Esempio
	+:images-path: articles/bsdl-gpl/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	'''

	diff --git a/documentation/content/it/books/handbook/_index.adoc b/documentation/content/it/books/handbook/_index.adoc
	--- a/documentation/content/it/books/handbook/_index.adoc
	+++ b/documentation/content/it/books/handbook/_index.adoc
	@@ -6,6 +6,7 @@
	releaseinfo: "$FreeBSD$"
	trademarks: ["freebsd", "3com", "3ware", "arm", "adaptec", "adobe", "apple", "corel", "creative", "cvsup", "heidelberger", "ibm", "ieee", "intel", "intuit", "linux", "lsilogic", "m-systems", "macromedia", "microsoft", "netscape", "nexthop", "opengroup", "oracle", "powerquest", "realnetworks", "redhat", "sap", "sun", "symantec", "themathworks", "thomson", "usrobotics", "vmware", "waterloomaple", "wolframresearch", "xfree86", "xiph", "general"]
	next: books/handbook/preface
	+isIndex: true
	---

	= Manuale di FreeBSD
	diff --git a/documentation/content/ja/articles/contributing/_index.adoc b/documentation/content/ja/articles/contributing/_index.adoc
	--- a/documentation/content/ja/articles/contributing/_index.adoc
	+++ b/documentation/content/ja/articles/contributing/_index.adoc
	@@ -15,27 +15,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目次
	-:part-signifier: パート
	-:chapter-signifier: 第
	-:appendix-caption: 付録
	-:table-caption: 表
	-:figure-caption: 図
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/ja/mailing-lists.adoc[]
	-include::shared/ja/urls.adoc[]
	+:images-path: articles/contributing/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/ja/mailing-lists.adoc[]
	-include::../../../../shared/ja/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/ja/mailing-lists.adoc[]
	-include::../../../../shared/ja/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/ja/articles/fonts/_index.adoc b/documentation/content/ja/articles/fonts/_index.adoc
	--- a/documentation/content/ja/articles/fonts/_index.adoc
	+++ b/documentation/content/ja/articles/fonts/_index.adoc
	@@ -17,24 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目次
	-:part-signifier: パート
	-:chapter-signifier: 第
	-:appendix-caption: 付録
	-:table-caption: 表
	-:figure-caption: 図
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/ja/urls.adoc[]
	+:images-path: articles/fonts/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/ja/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/ja/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/ja/articles/ipsec-must/_index.adoc b/documentation/content/ja/articles/ipsec-must/_index.adoc
	--- a/documentation/content/ja/articles/ipsec-must/_index.adoc
	+++ b/documentation/content/ja/articles/ipsec-must/_index.adoc
	@@ -11,29 +11,24 @@
	:doctype: article
	:toc: macro
	:toclevels: 1
	-:sectnumlevels: 6
	:icons: font
	:sectnums:
	+:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目次
	-:part-signifier: パート
	-:chapter-signifier: 第
	-:appendix-caption: 付録
	-:table-caption: 表
	-:figure-caption: 図
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/ja/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/ja/urls.adoc[]
	+:images-path: articles/ipsec-must/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/ja/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/ja/articles/leap-seconds/_index.adoc b/documentation/content/ja/articles/leap-seconds/_index.adoc
	--- a/documentation/content/ja/articles/leap-seconds/_index.adoc
	+++ b/documentation/content/ja/articles/leap-seconds/_index.adoc
	@@ -12,24 +12,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目次
	-:part-signifier: パート
	-:chapter-signifier: 第
	-:appendix-caption: 付録
	-:table-caption: 表
	-:figure-caption: 図
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/ja/urls.adoc[]
	+:images-path: articles/leap-seconds/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/ja/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/ja/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	diff --git a/documentation/content/ja/articles/problem-reports/_index.adoc b/documentation/content/ja/articles/problem-reports/_index.adoc
	--- a/documentation/content/ja/articles/problem-reports/_index.adoc
	+++ b/documentation/content/ja/articles/problem-reports/_index.adoc
	@@ -16,27 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目次
	-:part-signifier: パート
	-:chapter-signifier: 第
	-:appendix-caption: 付録
	-:table-caption: 表
	-:figure-caption: 図
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/ja/mailing-lists.adoc[]
	-include::shared/ja/urls.adoc[]
	+:images-path: articles/problem-reports/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/ja/mailing-lists.adoc[]
	-include::../../../../shared/ja/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/ja/mailing-lists.adoc[]
	-include::../../../../shared/ja/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/ja/books/design-44bsd/_index.adoc b/documentation/content/ja/books/design-44bsd/_index.adoc
	--- a/documentation/content/ja/books/design-44bsd/_index.adoc
	+++ b/documentation/content/ja/books/design-44bsd/_index.adoc
	@@ -7,7 +7,8 @@
	- author: John S. Quarterman [FAMILY Given]
	copyright: 1996 Addison-Wesley Longman, Inc
	releaseinfo: "$FreeBSD$"
	-trademarks: ["design-44bsd"]
	+trademarks: ["design-44bsd"]
	+isIndex: true
	---

	= 4.4BSD オペレーティングシステムの設計と実装
	diff --git a/documentation/content/ja/books/faq/_index.adoc b/documentation/content/ja/books/faq/_index.adoc
	--- a/documentation/content/ja/books/faq/_index.adoc
	+++ b/documentation/content/ja/books/faq/_index.adoc
	@@ -4,7 +4,8 @@
	- author: FreeBSD ドキュメンテーションプロジェクト
	copyright: 1995-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	+isIndex: true
	---

	= FreeBSD 2.X、3.X、4.X についての FAQ (よくある質問とその答え)
	diff --git a/documentation/content/ja/books/handbook/_index.adoc b/documentation/content/ja/books/handbook/_index.adoc
	--- a/documentation/content/ja/books/handbook/_index.adoc
	+++ b/documentation/content/ja/books/handbook/_index.adoc
	@@ -6,6 +6,7 @@
	releaseinfo: "$FreeBSD$"
	trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
	next: books/handbook/preface
	+isIndex: true
	---

	= FreeBSD ハンドブック
	diff --git a/documentation/content/ja/books/porters-handbook/_index.adoc b/documentation/content/ja/books/porters-handbook/_index.adoc
	--- a/documentation/content/ja/books/porters-handbook/_index.adoc
	+++ b/documentation/content/ja/books/porters-handbook/_index.adoc
	@@ -5,6 +5,7 @@
	copyright: 2000-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	trademarks: ["freebsd", "sun", "unix", "general"]
	+isIndex: true
	---

	= FreeBSD port 作成者のためのハンドブック
	diff --git a/documentation/content/ko/articles/bsdl-gpl/_index.adoc b/documentation/content/ko/articles/bsdl-gpl/_index.adoc
	--- a/documentation/content/ko/articles/bsdl-gpl/_index.adoc
	+++ b/documentation/content/ko/articles/bsdl-gpl/_index.adoc
	@@ -16,10 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 차례
	-:table-caption: 표
	-:figure-caption: 그림
	-:example-caption: 예시
	+:images-path: articles/bsdl-gpl/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	'''

	diff --git a/documentation/content/ko/articles/contributing/_index.adoc b/documentation/content/ko/articles/contributing/_index.adoc
	--- a/documentation/content/ko/articles/contributing/_index.adoc
	+++ b/documentation/content/ko/articles/contributing/_index.adoc
	@@ -17,21 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 차례
	-:table-caption: 표
	-:figure-caption: 그림
	-:example-caption: 예시
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/ko/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/ko/urls.adoc[]
	+:images-path: articles/contributing/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/ko/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/ko/articles/explaining-bsd/_index.adoc b/documentation/content/ko/articles/explaining-bsd/_index.adoc
	--- a/documentation/content/ko/articles/explaining-bsd/_index.adoc
	+++ b/documentation/content/ko/articles/explaining-bsd/_index.adoc
	@@ -16,10 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 차례
	-:table-caption: 표
	-:figure-caption: 그림
	-:example-caption: 예시
	+:images-path: articles/explaining-bsd/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	초록
	diff --git a/documentation/content/mn/books/handbook/_index.adoc b/documentation/content/mn/books/handbook/_index.adoc
	--- a/documentation/content/mn/books/handbook/_index.adoc
	+++ b/documentation/content/mn/books/handbook/_index.adoc
	@@ -6,6 +6,7 @@
	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"]
	next: books/handbook/preface
	+isIndex: true
	---

	= FreeBSD гарын авлага
	diff --git a/documentation/content/nl/articles/contributing/_index.adoc b/documentation/content/nl/articles/contributing/_index.adoc
	--- a/documentation/content/nl/articles/contributing/_index.adoc
	+++ b/documentation/content/nl/articles/contributing/_index.adoc
	@@ -15,27 +15,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Inhoudsopgave
	-:part-signifier: Deel
	-:chapter-signifier: Hoofdstuk
	-:appendix-caption: Bijlage
	-:table-caption: Tabel
	-:figure-caption: Afbeelding
	-:example-caption: Voorbeeld
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/nl/mailing-lists.adoc[]
	-include::shared/nl/urls.adoc[]
	+:images-path: articles/contributing/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/nl/mailing-lists.adoc[]
	-include::../../../../shared/nl/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/nl/mailing-lists.adoc[]
	-include::../../../../shared/nl/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/nl/articles/explaining-bsd/_index.adoc b/documentation/content/nl/articles/explaining-bsd/_index.adoc
	--- a/documentation/content/nl/articles/explaining-bsd/_index.adoc
	+++ b/documentation/content/nl/articles/explaining-bsd/_index.adoc
	@@ -16,13 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Inhoudsopgave
	-:part-signifier: Deel
	-:chapter-signifier: Hoofdstuk
	-:appendix-caption: Bijlage
	-:table-caption: Tabel
	-:figure-caption: Afbeelding
	-:example-caption: Voorbeeld
	+:images-path: articles/explaining-bsd/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Samenvatting
	diff --git a/documentation/content/nl/articles/leap-seconds/_index.adoc b/documentation/content/nl/articles/leap-seconds/_index.adoc
	--- a/documentation/content/nl/articles/leap-seconds/_index.adoc
	+++ b/documentation/content/nl/articles/leap-seconds/_index.adoc
	@@ -12,24 +12,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Inhoudsopgave
	-:part-signifier: Deel
	-:chapter-signifier: Hoofdstuk
	-:appendix-caption: Bijlage
	-:table-caption: Tabel
	-:figure-caption: Afbeelding
	-:example-caption: Voorbeeld
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/nl/urls.adoc[]
	+:images-path: articles/leap-seconds/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/nl/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/nl/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	diff --git a/documentation/content/nl/articles/problem-reports/_index.adoc b/documentation/content/nl/articles/problem-reports/_index.adoc
	--- a/documentation/content/nl/articles/problem-reports/_index.adoc
	+++ b/documentation/content/nl/articles/problem-reports/_index.adoc
	@@ -16,27 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Inhoudsopgave
	-:part-signifier: Deel
	-:chapter-signifier: Hoofdstuk
	-:appendix-caption: Bijlage
	-:table-caption: Tabel
	-:figure-caption: Afbeelding
	-:example-caption: Voorbeeld
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/nl/mailing-lists.adoc[]
	-include::shared/nl/urls.adoc[]
	+:images-path: articles/problem-reports/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/nl/mailing-lists.adoc[]
	-include::../../../../shared/nl/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/nl/mailing-lists.adoc[]
	-include::../../../../shared/nl/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/nl/articles/solid-state/_index.adoc b/documentation/content/nl/articles/solid-state/_index.adoc
	--- a/documentation/content/nl/articles/solid-state/_index.adoc
	+++ b/documentation/content/nl/articles/solid-state/_index.adoc
	@@ -17,13 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Inhoudsopgave
	-:part-signifier: Deel
	-:chapter-signifier: Hoofdstuk
	-:appendix-caption: Bijlage
	-:table-caption: Tabel
	-:figure-caption: Afbeelding
	-:example-caption: Voorbeeld
	+:images-path: articles/solid-state/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Samenvatting
	diff --git a/documentation/content/nl/books/handbook/_index.adoc b/documentation/content/nl/books/handbook/_index.adoc
	--- a/documentation/content/nl/books/handbook/_index.adoc
	+++ b/documentation/content/nl/books/handbook/_index.adoc
	@@ -6,6 +6,7 @@
	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"]
	next: books/handbook/preface
	+isIndex: true
	---

	= FreeBSD handboek
	diff --git a/documentation/content/pl/articles/filtering-bridges/_index.adoc b/documentation/content/pl/articles/filtering-bridges/_index.adoc
	--- a/documentation/content/pl/articles/filtering-bridges/_index.adoc
	+++ b/documentation/content/pl/articles/filtering-bridges/_index.adoc
	@@ -16,24 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Spis treści
	-:part-signifier: Część
	-:chapter-signifier: Rozdział
	-:appendix-caption: Dodatek
	-:table-caption: Tabela
	-:figure-caption: Rysunek
	-:example-caption: Przykład
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/pl/urls.adoc[]
	+:images-path: articles/filtering-bridges/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/pl/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/pl/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/pl/articles/new-users/_index.adoc b/documentation/content/pl/articles/new-users/_index.adoc
	--- a/documentation/content/pl/articles/new-users/_index.adoc
	+++ b/documentation/content/pl/articles/new-users/_index.adoc
	@@ -16,13 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Spis treści
	-:part-signifier: Część
	-:chapter-signifier: Rozdział
	-:appendix-caption: Dodatek
	-:table-caption: Tabela
	-:figure-caption: Rysunek
	-:example-caption: Przykład
	+:images-path: articles/new-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Abstrakt
	diff --git a/documentation/content/pl/books/handbook/_index.adoc b/documentation/content/pl/books/handbook/_index.adoc
	--- a/documentation/content/pl/books/handbook/_index.adoc
	+++ b/documentation/content/pl/books/handbook/_index.adoc
	@@ -6,6 +6,7 @@
	releaseinfo: "$FreeBSD$"
	trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
	next: books/handbook/preface
	+isIndex: true
	---

	= Podręcznik FreeBSD
	diff --git a/documentation/content/pt-br/articles/bsdl-gpl/_index.adoc b/documentation/content/pt-br/articles/bsdl-gpl/_index.adoc
	--- a/documentation/content/pt-br/articles/bsdl-gpl/_index.adoc
	+++ b/documentation/content/pt-br/articles/bsdl-gpl/_index.adoc
	@@ -18,6 +18,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/bsdl-gpl/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	'''

	diff --git a/documentation/content/pt-br/articles/building-products/_index.adoc b/documentation/content/pt-br/articles/building-products/_index.adoc
	--- a/documentation/content/pt-br/articles/building-products/_index.adoc
	+++ b/documentation/content/pt-br/articles/building-products/_index.adoc
	@@ -18,26 +18,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	-
	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../images/articles/building-products/
	+:images-path: articles/buiding-products/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/articles/building-products/
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/building-products/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/pt-br/articles/committers-guide/_index.adoc b/documentation/content/pt-br/articles/committers-guide/_index.adoc
	--- a/documentation/content/pt-br/articles/committers-guide/_index.adoc
	+++ b/documentation/content/pt-br/articles/committers-guide/_index.adoc
	@@ -16,15 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/committers-guide/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/contributing/_index.adoc b/documentation/content/pt-br/articles/contributing/_index.adoc
	--- a/documentation/content/pt-br/articles/contributing/_index.adoc
	+++ b/documentation/content/pt-br/articles/contributing/_index.adoc
	@@ -17,15 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/contributing/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/contributors/_index.adoc b/documentation/content/pt-br/articles/contributors/_index.adoc
	--- a/documentation/content/pt-br/articles/contributors/_index.adoc
	+++ b/documentation/content/pt-br/articles/contributors/_index.adoc
	@@ -11,33 +11,24 @@
	:toclevels: 1
	:icons: font
	:sectnums:
	+:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-:sectnumlevels: 6
	+:images-path: articles/contributors/

	-ifeval::["{backend}" == "html5"]
	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/pt-br/urls.adoc[]
	-:include-path: content/pt-br/articles/contributors/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/pt-br/urls.adoc[]
	-:include-path:
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+:include-path: content/{{% lang %}}/articles/contributors/
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/pt-br/urls.adoc[]
	+ifndef::env-beastie[]
	:include-path:
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/pt-br/articles/cups/_index.adoc b/documentation/content/pt-br/articles/cups/_index.adoc
	--- a/documentation/content/pt-br/articles/cups/_index.adoc
	+++ b/documentation/content/pt-br/articles/cups/_index.adoc
	@@ -16,13 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	+:images-path: articles/cups/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/explaining-bsd/_index.adoc b/documentation/content/pt-br/articles/explaining-bsd/_index.adoc
	--- a/documentation/content/pt-br/articles/explaining-bsd/_index.adoc
	+++ b/documentation/content/pt-br/articles/explaining-bsd/_index.adoc
	@@ -18,13 +18,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	+:images-path: articles/explaining-bsd/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/filtering-bridges/_index.adoc b/documentation/content/pt-br/articles/filtering-bridges/_index.adoc
	--- a/documentation/content/pt-br/articles/filtering-bridges/_index.adoc
	+++ b/documentation/content/pt-br/articles/filtering-bridges/_index.adoc
	@@ -16,15 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/filtering-bridges/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/fonts/_index.adoc b/documentation/content/pt-br/articles/fonts/_index.adoc
	--- a/documentation/content/pt-br/articles/fonts/_index.adoc
	+++ b/documentation/content/pt-br/articles/fonts/_index.adoc
	@@ -17,13 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	+:images-path: articles/fonts/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/freebsd-questions/_index.adoc b/documentation/content/pt-br/articles/freebsd-questions/_index.adoc
	--- a/documentation/content/pt-br/articles/freebsd-questions/_index.adoc
	+++ b/documentation/content/pt-br/articles/freebsd-questions/_index.adoc
	@@ -16,13 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	+:images-path: articles/freebsd-questions/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	include::shared/pt-br/urls.adoc[]

	diff --git a/documentation/content/pt-br/articles/freebsd-releng/_index.adoc b/documentation/content/pt-br/articles/freebsd-releng/_index.adoc
	--- a/documentation/content/pt-br/articles/freebsd-releng/_index.adoc
	+++ b/documentation/content/pt-br/articles/freebsd-releng/_index.adoc
	@@ -20,13 +20,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	+:images-path: articles/freebsd-releng/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/freebsd-update-server/_index.adoc b/documentation/content/pt-br/articles/freebsd-update-server/_index.adoc
	--- a/documentation/content/pt-br/articles/freebsd-update-server/_index.adoc
	+++ b/documentation/content/pt-br/articles/freebsd-update-server/_index.adoc
	@@ -17,15 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/freebsd-update-server/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/geom-class/_index.adoc b/documentation/content/pt-br/articles/geom-class/_index.adoc
	--- a/documentation/content/pt-br/articles/geom-class/_index.adoc
	+++ b/documentation/content/pt-br/articles/geom-class/_index.adoc
	@@ -16,15 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/geom-class/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/gjournal-desktop/_index.adoc b/documentation/content/pt-br/articles/gjournal-desktop/_index.adoc
	--- a/documentation/content/pt-br/articles/gjournal-desktop/_index.adoc
	+++ b/documentation/content/pt-br/articles/gjournal-desktop/_index.adoc
	@@ -16,26 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	-
	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../images/articles/gjournal-desktop/
	+:images-path: articles/gjournal-desktop/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/pt-br/articles/hubs/_index.adoc b/documentation/content/pt-br/articles/hubs/_index.adoc
	--- a/documentation/content/pt-br/articles/hubs/_index.adoc
	+++ b/documentation/content/pt-br/articles/hubs/_index.adoc
	@@ -22,15 +22,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/hubs/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/ipsec-must/_index.adoc b/documentation/content/pt-br/articles/ipsec-must/_index.adoc
	--- a/documentation/content/pt-br/articles/ipsec-must/_index.adoc
	+++ b/documentation/content/pt-br/articles/ipsec-must/_index.adoc
	@@ -16,15 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/ipsec-must/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/ldap-auth/_index.adoc b/documentation/content/pt-br/articles/ldap-auth/_index.adoc
	--- a/documentation/content/pt-br/articles/ldap-auth/_index.adoc
	+++ b/documentation/content/pt-br/articles/ldap-auth/_index.adoc
	@@ -17,13 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	+:images-path: articles/ldap-auth/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/leap-seconds/_index.adoc b/documentation/content/pt-br/articles/leap-seconds/_index.adoc
	--- a/documentation/content/pt-br/articles/leap-seconds/_index.adoc
	+++ b/documentation/content/pt-br/articles/leap-seconds/_index.adoc
	@@ -13,24 +13,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/leap-seconds/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/pt-br/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/pt-br/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	diff --git a/documentation/content/pt-br/articles/linux-emulation/_index.adoc b/documentation/content/pt-br/articles/linux-emulation/_index.adoc
	--- a/documentation/content/pt-br/articles/linux-emulation/_index.adoc
	+++ b/documentation/content/pt-br/articles/linux-emulation/_index.adoc
	@@ -16,13 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	+:images-path: articles/linux-emulation/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/linux-users/_index.adoc b/documentation/content/pt-br/articles/linux-users/_index.adoc
	--- a/documentation/content/pt-br/articles/linux-users/_index.adoc
	+++ b/documentation/content/pt-br/articles/linux-users/_index.adoc
	@@ -16,15 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/linux-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/mailing-list-faq/_index.adoc b/documentation/content/pt-br/articles/mailing-list-faq/_index.adoc
	--- a/documentation/content/pt-br/articles/mailing-list-faq/_index.adoc
	+++ b/documentation/content/pt-br/articles/mailing-list-faq/_index.adoc
	@@ -16,15 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/mailing-list-faq/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/nanobsd/_index.adoc b/documentation/content/pt-br/articles/nanobsd/_index.adoc
	--- a/documentation/content/pt-br/articles/nanobsd/_index.adoc
	+++ b/documentation/content/pt-br/articles/nanobsd/_index.adoc
	@@ -16,13 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	+:images-path: articles/nanobsd/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/new-users/_index.adoc b/documentation/content/pt-br/articles/new-users/_index.adoc
	--- a/documentation/content/pt-br/articles/new-users/_index.adoc
	+++ b/documentation/content/pt-br/articles/new-users/_index.adoc
	@@ -16,13 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	+:images-path: articles/new-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/pam/_index.adoc b/documentation/content/pt-br/articles/pam/_index.adoc
	--- a/documentation/content/pt-br/articles/pam/_index.adoc
	+++ b/documentation/content/pt-br/articles/pam/_index.adoc
	@@ -16,13 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	+:images-path: articles/pam/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/pgpkeys/_index.adoc b/documentation/content/pt-br/articles/pgpkeys/_index.adoc
	--- a/documentation/content/pt-br/articles/pgpkeys/_index.adoc
	+++ b/documentation/content/pt-br/articles/pgpkeys/_index.adoc
	@@ -12,16 +12,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	+:images-path: articles/pgpkeys/

	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/pt-br/teams.adoc[lines=21..-1]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	'''

	diff --git a/documentation/content/pt-br/articles/port-mentor-guidelines/_index.adoc b/documentation/content/pt-br/articles/port-mentor-guidelines/_index.adoc
	--- a/documentation/content/pt-br/articles/port-mentor-guidelines/_index.adoc
	+++ b/documentation/content/pt-br/articles/port-mentor-guidelines/_index.adoc
	@@ -15,15 +15,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/port-mentor-guidelines/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	'''

	diff --git a/documentation/content/pt-br/articles/pr-guidelines/_index.adoc b/documentation/content/pt-br/articles/pr-guidelines/_index.adoc
	--- a/documentation/content/pt-br/articles/pr-guidelines/_index.adoc
	+++ b/documentation/content/pt-br/articles/pr-guidelines/_index.adoc
	@@ -16,15 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/pr-guidelines/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/problem-reports/_index.adoc b/documentation/content/pt-br/articles/problem-reports/_index.adoc
	--- a/documentation/content/pt-br/articles/problem-reports/_index.adoc
	+++ b/documentation/content/pt-br/articles/problem-reports/_index.adoc
	@@ -16,13 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	+:images-path: articles/problem-reports/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/rc-scripting/_index.adoc b/documentation/content/pt-br/articles/rc-scripting/_index.adoc
	--- a/documentation/content/pt-br/articles/rc-scripting/_index.adoc
	+++ b/documentation/content/pt-br/articles/rc-scripting/_index.adoc
	@@ -17,15 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/rc-scripting/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/releng/_index.adoc b/documentation/content/pt-br/articles/releng/_index.adoc
	--- a/documentation/content/pt-br/articles/releng/_index.adoc
	+++ b/documentation/content/pt-br/articles/releng/_index.adoc
	@@ -16,27 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:xrefstyle: full
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	-
	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../images/articles/releng/
	+:images-path: articles/releng/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/articles/releng/
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/releng/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/pt-br/articles/remote-install/_index.adoc b/documentation/content/pt-br/articles/remote-install/_index.adoc
	--- a/documentation/content/pt-br/articles/remote-install/_index.adoc
	+++ b/documentation/content/pt-br/articles/remote-install/_index.adoc
	@@ -17,15 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/remote-install/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/serial-uart/_index.adoc b/documentation/content/pt-br/articles/serial-uart/_index.adoc
	--- a/documentation/content/pt-br/articles/serial-uart/_index.adoc
	+++ b/documentation/content/pt-br/articles/serial-uart/_index.adoc
	@@ -16,15 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	+:images-path: articles/serial-uart/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/solid-state/_index.adoc b/documentation/content/pt-br/articles/solid-state/_index.adoc
	--- a/documentation/content/pt-br/articles/solid-state/_index.adoc
	+++ b/documentation/content/pt-br/articles/solid-state/_index.adoc
	@@ -17,13 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	+:images-path: articles/solid-state/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Resumo
	diff --git a/documentation/content/pt-br/articles/vinum/_index.adoc b/documentation/content/pt-br/articles/vinum/_index.adoc
	--- a/documentation/content/pt-br/articles/vinum/_index.adoc
	+++ b/documentation/content/pt-br/articles/vinum/_index.adoc
	@@ -13,26 +13,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-include::shared/pt-br/urls.adoc[]
	-
	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../images/articles/vinum/
	+:images-path: articles/vinum/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/articles/vinum/
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/vinum/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	diff --git a/documentation/content/pt-br/articles/vm-design/_index.adoc b/documentation/content/pt-br/articles/vm-design/_index.adoc
	--- a/documentation/content/pt-br/articles/vm-design/_index.adoc
	+++ b/documentation/content/pt-br/articles/vm-design/_index.adoc
	@@ -16,24 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Índice
	-:part-signifier: Parte
	-:chapter-signifier: Capítulo
	-:appendix-caption: Apêndice
	-:table-caption: Tabela
	-:figure-caption: Figura
	-:example-caption: Exemplo
	-
	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../images/articles/vm-design/
	+:images-path: articles/vm-design/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/articles/vm-design/
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/vm-design/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/pt-br/books/dev-model/_index.adoc b/documentation/content/pt-br/books/dev-model/_index.adoc
	--- a/documentation/content/pt-br/books/dev-model/_index.adoc
	+++ b/documentation/content/pt-br/books/dev-model/_index.adoc
	@@ -3,7 +3,8 @@
	authors:
	- author: Niklas Saers
	copyright: Copyright © 2002-2005 Niklas Saers
	-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	+isIndex: true
	---

	= Um modelo de projeto para o projeto FreeBSD
	diff --git a/documentation/content/pt-br/books/faq/_index.adoc b/documentation/content/pt-br/books/faq/_index.adoc
	--- a/documentation/content/pt-br/books/faq/_index.adoc
	+++ b/documentation/content/pt-br/books/faq/_index.adoc
	@@ -2,7 +2,8 @@
	title: Perguntas freqüentes para o FreeBSD 11.X e 12.X
	authors:
	releaseinfo: "$FreeBSD$"
	-trademarks: []
	+trademarks: []
	+isIndex: true
	---

	= Perguntas freqüentes para o FreeBSD {rel2-relx} e {rel-relx}
	diff --git a/documentation/content/pt-br/books/fdp-primer/_index.adoc b/documentation/content/pt-br/books/fdp-primer/_index.adoc
	--- a/documentation/content/pt-br/books/fdp-primer/_index.adoc
	+++ b/documentation/content/pt-br/books/fdp-primer/_index.adoc
	@@ -10,6 +10,7 @@
	title: 'Primer do Projeto de Documentação do FreeBSD para Novos Colaboradores'
	trademarks: ["general"]
	weight: 10
	+isIndex: true
	---

	= Primer do Projeto de Documentação do FreeBSD para Novos Colaboradores
	diff --git a/documentation/content/pt-br/books/handbook/_index.adoc b/documentation/content/pt-br/books/handbook/_index.adoc
	--- a/documentation/content/pt-br/books/handbook/_index.adoc
	+++ b/documentation/content/pt-br/books/handbook/_index.adoc
	@@ -6,6 +6,7 @@
	releaseinfo: "$FreeBSD$"
	trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
	next: books/handbook/preface
	+isIndex: true
	---

	= FreeBSD Handbook
	diff --git a/documentation/content/pt-br/books/porters-handbook/_index.adoc b/documentation/content/pt-br/books/porters-handbook/_index.adoc
	--- a/documentation/content/pt-br/books/porters-handbook/_index.adoc
	+++ b/documentation/content/pt-br/books/porters-handbook/_index.adoc
	@@ -4,7 +4,8 @@
	- author: Projeto de Documentação do FreeBSD
	copyright: 2000-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "sun", "unix", "general"]
	+trademarks: ["freebsd", "sun", "unix", "general"]
	+isIndex: true
	---

	= FreeBSD Porter's Handbook
	diff --git a/documentation/content/ru/articles/committers-guide/_index.adoc b/documentation/content/ru/articles/committers-guide/_index.adoc
	--- a/documentation/content/ru/articles/committers-guide/_index.adoc
	+++ b/documentation/content/ru/articles/committers-guide/_index.adoc
	@@ -17,18 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	+:images-path: articles/committers-guide/

	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/ru/teams.adoc[]
	-include::shared/ru/mailing-lists.adoc[]
	-include::shared/ru/urls.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Аннотация
	diff --git a/documentation/content/ru/articles/contributing/_index.adoc b/documentation/content/ru/articles/contributing/_index.adoc
	--- a/documentation/content/ru/articles/contributing/_index.adoc
	+++ b/documentation/content/ru/articles/contributing/_index.adoc
	@@ -15,16 +15,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	-
	-include::shared/ru/mailing-lists.adoc[lines=9..-1]
	-include::shared/ru/urls.adoc[]
	+:images-path: articles/contributing/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Аннотация
	diff --git a/documentation/content/ru/articles/cups/_index.adoc b/documentation/content/ru/articles/cups/_index.adoc
	--- a/documentation/content/ru/articles/cups/_index.adoc
	+++ b/documentation/content/ru/articles/cups/_index.adoc
	@@ -16,13 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	+:images-path: articles/cups/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Аннотация
	diff --git a/documentation/content/ru/articles/explaining-bsd/_index.adoc b/documentation/content/ru/articles/explaining-bsd/_index.adoc
	--- a/documentation/content/ru/articles/explaining-bsd/_index.adoc
	+++ b/documentation/content/ru/articles/explaining-bsd/_index.adoc
	@@ -16,13 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	+:images-path: articles/explaining-bsd/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Аннотация
	diff --git a/documentation/content/ru/articles/fonts/_index.adoc b/documentation/content/ru/articles/fonts/_index.adoc
	--- a/documentation/content/ru/articles/fonts/_index.adoc
	+++ b/documentation/content/ru/articles/fonts/_index.adoc
	@@ -17,13 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	+:images-path: articles/fonts/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Аннотация
	diff --git a/documentation/content/ru/articles/freebsd-questions/_index.adoc b/documentation/content/ru/articles/freebsd-questions/_index.adoc
	--- a/documentation/content/ru/articles/freebsd-questions/_index.adoc
	+++ b/documentation/content/ru/articles/freebsd-questions/_index.adoc
	@@ -16,16 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	-
	-include::shared/ru/mailing-lists.adoc[lines=9..-1]
	-include::shared/ru/urls.adoc[]
	+:images-path: articles/freebsd-questions/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Аннотация
	diff --git a/documentation/content/ru/articles/geom-class/_index.adoc b/documentation/content/ru/articles/geom-class/_index.adoc
	--- a/documentation/content/ru/articles/geom-class/_index.adoc
	+++ b/documentation/content/ru/articles/geom-class/_index.adoc
	@@ -16,15 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	-
	-include::shared/ru/urls.adoc[]
	+:images-path: articles/geom-class/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Аннотация
	diff --git a/documentation/content/ru/articles/gjournal-desktop/_index.adoc b/documentation/content/ru/articles/gjournal-desktop/_index.adoc
	--- a/documentation/content/ru/articles/gjournal-desktop/_index.adoc
	+++ b/documentation/content/ru/articles/gjournal-desktop/_index.adoc
	@@ -16,28 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	+:images-path: articles/gjournal-desktop/

	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/ru/mailing-lists.adoc[lines=9..-1]
	-include::shared/ru/urls.adoc[]
	-
	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../images/articles/gjournal-desktop/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/ru/articles/hubs/_index.adoc b/documentation/content/ru/articles/hubs/_index.adoc
	--- a/documentation/content/ru/articles/hubs/_index.adoc
	+++ b/documentation/content/ru/articles/hubs/_index.adoc
	@@ -23,17 +23,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	-
	-include::shared/ru/mailing-lists.adoc[lines=9..-1]
	-include::shared/ru/urls.adoc[]
	+:images-path: articles/hubs/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Аннотация
	diff --git a/documentation/content/ru/articles/ipsec-must/_index.adoc b/documentation/content/ru/articles/ipsec-must/_index.adoc
	--- a/documentation/content/ru/articles/ipsec-must/_index.adoc
	+++ b/documentation/content/ru/articles/ipsec-must/_index.adoc
	@@ -16,15 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	-
	-include::shared/ru/urls.adoc[]
	+:images-path: articles/ipsec-must/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Аннотация
	diff --git a/documentation/content/ru/articles/mailing-list-faq/_index.adoc b/documentation/content/ru/articles/mailing-list-faq/_index.adoc
	--- a/documentation/content/ru/articles/mailing-list-faq/_index.adoc
	+++ b/documentation/content/ru/articles/mailing-list-faq/_index.adoc
	@@ -15,18 +15,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	+:images-path: articles/mailing-list-faq/

	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	-include::shared/ru/mailing-lists.adoc[lines=9..-1]
	-include::shared/ru/urls.adoc[]
	-
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]
	[.abstract-title]
	Аннотация

	diff --git a/documentation/content/ru/articles/new-users/_index.adoc b/documentation/content/ru/articles/new-users/_index.adoc
	--- a/documentation/content/ru/articles/new-users/_index.adoc
	+++ b/documentation/content/ru/articles/new-users/_index.adoc
	@@ -16,13 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	+:images-path: articles/new-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Аннотация
	diff --git a/documentation/content/ru/articles/pam/_index.adoc b/documentation/content/ru/articles/pam/_index.adoc
	--- a/documentation/content/ru/articles/pam/_index.adoc
	+++ b/documentation/content/ru/articles/pam/_index.adoc
	@@ -15,13 +15,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	+:images-path: articles/pam/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Abstract
	diff --git a/documentation/content/ru/articles/pr-guidelines/_index.adoc b/documentation/content/ru/articles/pr-guidelines/_index.adoc
	--- a/documentation/content/ru/articles/pr-guidelines/_index.adoc
	+++ b/documentation/content/ru/articles/pr-guidelines/_index.adoc
	@@ -16,16 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	-
	-include::shared/ru/mailing-lists.adoc[lines=9..-1]
	-include::shared/ru/urls.adoc[]
	+:images-path: articles/pr-guidelines/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Аннотация
	diff --git a/documentation/content/ru/articles/problem-reports/_index.adoc b/documentation/content/ru/articles/problem-reports/_index.adoc
	--- a/documentation/content/ru/articles/problem-reports/_index.adoc
	+++ b/documentation/content/ru/articles/problem-reports/_index.adoc
	@@ -16,17 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	-
	-include::shared/ru/teams.adoc[]
	-include::shared/ru/mailing-lists.adoc[]
	-include::shared/ru/urls.adoc[]
	+:images-path: articles/problem-reports/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Аннотация
	diff --git a/documentation/content/ru/articles/releng/_index.adoc b/documentation/content/ru/articles/releng/_index.adoc
	--- a/documentation/content/ru/articles/releng/_index.adoc
	+++ b/documentation/content/ru/articles/releng/_index.adoc
	@@ -17,31 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:xrefstyle: full
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	+:images-path: articles/releng/

	+ifdef::env-beastie+backend-html5[]
	include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	include::shared/releases.adoc[]
	-include::shared/ru/teams.adoc[]
	-include::shared/ru/mailing-lists.adoc[]
	-include::shared/ru/urls.adoc[]
	-
	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../images/articles/releng/
	-endif::[]
	-
	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/articles/releng/
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/releng/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/ru/articles/solid-state/_index.adoc b/documentation/content/ru/articles/solid-state/_index.adoc
	--- a/documentation/content/ru/articles/solid-state/_index.adoc
	+++ b/documentation/content/ru/articles/solid-state/_index.adoc
	@@ -17,13 +17,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	+:images-path: articles/solid-state/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Аннотация
	diff --git a/documentation/content/ru/articles/vm-design/_index.adoc b/documentation/content/ru/articles/vm-design/_index.adoc
	--- a/documentation/content/ru/articles/vm-design/_index.adoc
	+++ b/documentation/content/ru/articles/vm-design/_index.adoc
	@@ -16,24 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: Содержание
	-:part-signifier: Часть
	-:chapter-signifier: Глава
	-:appendix-caption: Приложение
	-:table-caption: Таблица
	-:figure-caption: Рисунок
	-:example-caption: Пример
	-
	-ifeval::["{backend}" == "html5"]
	-:imagesdir: ../../../images/articles/vm-design/
	+:images-path: articles/vm-design/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-:imagesdir: ../../../../static/images/articles/vm-design/
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-:imagesdir: ../../../../static/images/articles/vm-design/
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/ru/books/design-44bsd/_index.adoc b/documentation/content/ru/books/design-44bsd/_index.adoc
	--- a/documentation/content/ru/books/design-44bsd/_index.adoc
	+++ b/documentation/content/ru/books/design-44bsd/_index.adoc
	@@ -7,7 +7,8 @@
	- author: John S. Quarterman
	copyright: 1996 Addison-Wesley Longman, Inc
	releaseinfo: "$FreeBSD$"
	-trademarks: ["design-44bsd"]
	+trademarks: ["design-44bsd"]
	+isIndex: true
	---

	= Архитектура и реализация операционной системы 4.4BSD
	diff --git a/documentation/content/ru/books/developers-handbook/_index.adoc b/documentation/content/ru/books/developers-handbook/_index.adoc
	--- a/documentation/content/ru/books/developers-handbook/_index.adoc
	+++ b/documentation/content/ru/books/developers-handbook/_index.adoc
	@@ -4,7 +4,8 @@
	- author: The FreeBSD Documentation Project
	copyright: 1995-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
	+trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
	+isIndex: true
	---

	= Руководство FreeBSD для разработчиков
	diff --git a/documentation/content/ru/books/faq/_index.adoc b/documentation/content/ru/books/faq/_index.adoc
	--- a/documentation/content/ru/books/faq/_index.adoc
	+++ b/documentation/content/ru/books/faq/_index.adoc
	@@ -4,7 +4,8 @@
	- author: Проект документации FreeBSD
	copyright: 1995-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	+isIndex: true
	---

	= Часто задаваемые вопросы по FreeBSD {rel2-relx} и {rel-relx}
	diff --git a/documentation/content/ru/books/handbook/_index.adoc b/documentation/content/ru/books/handbook/_index.adoc
	--- a/documentation/content/ru/books/handbook/_index.adoc
	+++ b/documentation/content/ru/books/handbook/_index.adoc
	@@ -6,6 +6,7 @@
	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"]
	next: books/handbook/preface
	+isIndex: true
	---

	= FreeBSD Handbook
	diff --git a/documentation/content/ru/books/porters-handbook/_index.adoc b/documentation/content/ru/books/porters-handbook/_index.adoc
	--- a/documentation/content/ru/books/porters-handbook/_index.adoc
	+++ b/documentation/content/ru/books/porters-handbook/_index.adoc
	@@ -4,7 +4,8 @@
	- author: The FreeBSD Documentation Project
	copyright: 2000-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "sun", "unix", "general"]
	+trademarks: ["freebsd", "sun", "unix", "general"]
	+isIndex: true
	---

	= Руководство FreeBSD по созданию портов
	diff --git a/documentation/content/tr/articles/explaining-bsd/_index.adoc b/documentation/content/tr/articles/explaining-bsd/_index.adoc
	--- a/documentation/content/tr/articles/explaining-bsd/_index.adoc
	+++ b/documentation/content/tr/articles/explaining-bsd/_index.adoc
	@@ -16,6 +16,20 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	+:images-path: articles/explaining-bsd/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	+endif::[]
	+
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	+endif::[]

	[.abstract-title]
	Özet
	diff --git a/documentation/content/zh-cn/articles/contributing/_index.adoc b/documentation/content/zh-cn/articles/contributing/_index.adoc
	--- a/documentation/content/zh-cn/articles/contributing/_index.adoc
	+++ b/documentation/content/zh-cn/articles/contributing/_index.adoc
	@@ -15,26 +15,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/zh-cn/mailing-lists.adoc[]
	-include::shared/zh-cn/urls.adoc[]
	+:images-path: articles/contributing/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/zh-cn/mailing-lists.adoc[]
	-include::../../../../shared/zh-cn/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/zh-cn/mailing-lists.adoc[]
	-include::../../../../shared/zh-cn/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/zh-cn/articles/leap-seconds/_index.adoc b/documentation/content/zh-cn/articles/leap-seconds/_index.adoc
	--- a/documentation/content/zh-cn/articles/leap-seconds/_index.adoc
	+++ b/documentation/content/zh-cn/articles/leap-seconds/_index.adoc
	@@ -12,23 +12,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/zh-cn/urls.adoc[]
	+:images-path: articles/leap-seconds/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/zh-cn/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/zh-cn/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	diff --git a/documentation/content/zh-cn/articles/linux-users/_index.adoc b/documentation/content/zh-cn/articles/linux-users/_index.adoc
	--- a/documentation/content/zh-cn/articles/linux-users/_index.adoc
	+++ b/documentation/content/zh-cn/articles/linux-users/_index.adoc
	@@ -16,23 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/zh-cn/urls.adoc[]
	+:images-path: articles/linux-users/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/zh-cn/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/zh-cn/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/zh-cn/articles/nanobsd/_index.adoc b/documentation/content/zh-cn/articles/nanobsd/_index.adoc
	--- a/documentation/content/zh-cn/articles/nanobsd/_index.adoc
	+++ b/documentation/content/zh-cn/articles/nanobsd/_index.adoc
	@@ -16,23 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/authors.adoc[]
	-endif::[]
	+:images-path: articles/nanobsd/

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/zh-cn/articles/rc-scripting/_index.adoc b/documentation/content/zh-cn/articles/rc-scripting/_index.adoc
	--- a/documentation/content/zh-cn/articles/rc-scripting/_index.adoc
	+++ b/documentation/content/zh-cn/articles/rc-scripting/_index.adoc
	@@ -17,23 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/zh-cn/urls.adoc[]
	+:images-path: articles/rc-scripting/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/zh-cn/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/zh-cn/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/zh-cn/articles/remote-install/_index.adoc b/documentation/content/zh-cn/articles/remote-install/_index.adoc
	--- a/documentation/content/zh-cn/articles/remote-install/_index.adoc
	+++ b/documentation/content/zh-cn/articles/remote-install/_index.adoc
	@@ -17,26 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/authors.adoc[]
	-include::shared/zh-cn/urls.adoc[]
	-endif::[]
	+:images-path: articles/remote-install/

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/zh-cn/urls.adoc[]
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/zh-cn/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/zh-cn/books/arch-handbook/_index.adoc b/documentation/content/zh-cn/books/arch-handbook/_index.adoc
	--- a/documentation/content/zh-cn/books/arch-handbook/_index.adoc
	+++ b/documentation/content/zh-cn/books/arch-handbook/_index.adoc
	@@ -5,7 +5,8 @@
	- author: FreeBSD 中文计划
	copyright: Copyright © 2000-2006, 2012-2013 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "apple", "microsoft", "unix", "general"]
	+trademarks: ["freebsd", "apple", "microsoft", "unix", "general"]
	+isIndex: true
	---

	= FreeBSD 系统结构手册
	diff --git a/documentation/content/zh-cn/books/handbook/_index.adoc b/documentation/content/zh-cn/books/handbook/_index.adoc
	--- a/documentation/content/zh-cn/books/handbook/_index.adoc
	+++ b/documentation/content/zh-cn/books/handbook/_index.adoc
	@@ -7,6 +7,7 @@
	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"]
	next: books/handbook/preface
	+isIndex: true
	---

	= FreeBSD 使用手册
	diff --git a/documentation/content/zh-cn/books/porters-handbook/_index.adoc b/documentation/content/zh-cn/books/porters-handbook/_index.adoc
	--- a/documentation/content/zh-cn/books/porters-handbook/_index.adoc
	+++ b/documentation/content/zh-cn/books/porters-handbook/_index.adoc
	@@ -5,7 +5,8 @@
	- author: FreeBSD 中文计划
	copyright: 2000-2020 The FreeBSD Documentation Project
	trademarks: ["freebsd", "sun", "unix", "general"]
	-releaseinfo: "$FreeBSD$"
	+releaseinfo: "$FreeBSD$"
	+isIndex: true
	---

	= FreeBSD Porter 手册
	diff --git a/documentation/content/zh-tw/articles/contributing/_index.adoc b/documentation/content/zh-tw/articles/contributing/_index.adoc
	--- a/documentation/content/zh-tw/articles/contributing/_index.adoc
	+++ b/documentation/content/zh-tw/articles/contributing/_index.adoc
	@@ -15,27 +15,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:chapter-signifier: 第
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/zh-tw/mailing-lists.adoc[]
	-include::shared/zh-tw/urls.adoc[]
	+:images-path: articles/contributing/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/zh-tw/mailing-lists.adoc[]
	-include::../../../../shared/zh-tw/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/zh-tw/mailing-lists.adoc[]
	-include::../../../../shared/zh-tw/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/zh-tw/articles/freebsd-questions/_index.adoc b/documentation/content/zh-tw/articles/freebsd-questions/_index.adoc
	--- a/documentation/content/zh-tw/articles/freebsd-questions/_index.adoc
	+++ b/documentation/content/zh-tw/articles/freebsd-questions/_index.adoc
	@@ -16,27 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:chapter-signifier: 第
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/zh-tw/mailing-lists.adoc[]
	-include::shared/zh-tw/urls.adoc[]
	+:images-path: articles/freebsd-questions/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/zh-tw/mailing-lists.adoc[]
	-include::../../../../shared/zh-tw/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/zh-tw/mailing-lists.adoc[]
	-include::../../../../shared/zh-tw/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/zh-tw/articles/hubs/_index.adoc b/documentation/content/zh-tw/articles/hubs/_index.adoc
	--- a/documentation/content/zh-tw/articles/hubs/_index.adoc
	+++ b/documentation/content/zh-tw/articles/hubs/_index.adoc
	@@ -22,24 +22,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:chapter-signifier: 第
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/zh-tw/urls.adoc[]
	+:images-path: articles/hubs/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/zh-tw/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/zh-tw/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/zh-tw/articles/leap-seconds/_index.adoc b/documentation/content/zh-tw/articles/leap-seconds/_index.adoc
	--- a/documentation/content/zh-tw/articles/leap-seconds/_index.adoc
	+++ b/documentation/content/zh-tw/articles/leap-seconds/_index.adoc
	@@ -12,24 +12,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:chapter-signifier: 第
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/zh-tw/urls.adoc[]
	+:images-path: articles/leap-seconds/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/zh-tw/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/zh-tw/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	'''
	diff --git a/documentation/content/zh-tw/articles/mailing-list-faq/_index.adoc b/documentation/content/zh-tw/articles/mailing-list-faq/_index.adoc
	--- a/documentation/content/zh-tw/articles/mailing-list-faq/_index.adoc
	+++ b/documentation/content/zh-tw/articles/mailing-list-faq/_index.adoc
	@@ -15,30 +15,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:chapter-signifier: 第
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/authors.adoc[]
	-include::shared/zh-tw/mailing-lists.adoc[]
	-include::shared/zh-tw/urls.adoc[]
	-endif::[]
	+:images-path: articles/mailing-list-faq/

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/zh-tw/mailing-lists.adoc[]
	-include::../../../../shared/zh-tw/urls.adoc[]
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/zh-tw/mailing-lists.adoc[]
	-include::../../../../shared/zh-tw/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/zh-tw/articles/nanobsd/_index.adoc b/documentation/content/zh-tw/articles/nanobsd/_index.adoc
	--- a/documentation/content/zh-tw/articles/nanobsd/_index.adoc
	+++ b/documentation/content/zh-tw/articles/nanobsd/_index.adoc
	@@ -16,24 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:chapter-signifier: 第
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/authors.adoc[]
	-endif::[]
	+:images-path: articles/nanobsd/

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/zh-tw/articles/pr-guidelines/_index.adoc b/documentation/content/zh-tw/articles/pr-guidelines/_index.adoc
	--- a/documentation/content/zh-tw/articles/pr-guidelines/_index.adoc
	+++ b/documentation/content/zh-tw/articles/pr-guidelines/_index.adoc
	@@ -16,27 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:chapter-signifier: 第
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/zh-tw/mailing-lists.adoc[]
	-include::shared/zh-tw/urls.adoc[]
	+:images-path: articles/pr-guidelines/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/zh-tw/mailing-lists.adoc[]
	-include::../../../../shared/zh-tw/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/zh-tw/mailing-lists.adoc[]
	-include::../../../../shared/zh-tw/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/zh-tw/articles/problem-reports/_index.adoc b/documentation/content/zh-tw/articles/problem-reports/_index.adoc
	--- a/documentation/content/zh-tw/articles/problem-reports/_index.adoc
	+++ b/documentation/content/zh-tw/articles/problem-reports/_index.adoc
	@@ -16,30 +16,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:chapter-signifier: 第
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/en/teams.adoc[]
	-include::shared/zh-tw/mailing-lists.adoc[]
	-include::shared/zh-tw/urls.adoc[]
	+:images-path: articles/problem-reports/
	+
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/zh-tw/mailing-lists.adoc[]
	-include::../../../../shared/zh-tw/urls.adoc[]
	-endif::[]
	-
	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/en/teams.adoc[]
	-include::../../../../shared/zh-tw/mailing-lists.adoc[]
	-include::../../../../shared/zh-tw/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/zh-tw/articles/remote-install/_index.adoc b/documentation/content/zh-tw/articles/remote-install/_index.adoc
	--- a/documentation/content/zh-tw/articles/remote-install/_index.adoc
	+++ b/documentation/content/zh-tw/articles/remote-install/_index.adoc
	@@ -17,27 +17,19 @@
	:sectnumlevels: 6
	:source-highlighter: rouge
	:experimental:
	-:toc-title: 目录
	-:part-signifier: 部分
	-:chapter-signifier: 第
	-:appendix-caption: 附录
	-:table-caption: 表
	-:figure-caption: 图
	-:example-caption: 例
	-
	-ifeval::["{backend}" == "html5"]
	-include::shared/authors.adoc[]
	-include::shared/zh-tw/urls.adoc[]
	-endif::[]
	+:images-path: articles/remote-install/

	-ifeval::["{backend}" == "pdf"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/zh-tw/urls.adoc[]
	+ifdef::env-beastie+backend-html5[]
	+include::shared/authors.adoc[]
	+include::shared/mirrors.adoc[]
	+include::shared/releases.adoc[]
	+include::shared/{{% lang %}}/mailing-lists.adoc[]
	+include::shared/{{% lang %}}/urls.adoc[]
	+:imagesdir: ../../../images/{images-path}
	endif::[]

	-ifeval::["{backend}" == "epub3"]
	-include::../../../../shared/authors.adoc[]
	-include::../../../../shared/zh-tw/urls.adoc[]
	+ifndef::env-beastie[]
	+include::../../../../shared/asciidoctor.adoc[]
	endif::[]

	[.abstract-title]
	diff --git a/documentation/content/zh-tw/books/developers-handbook/_index.adoc b/documentation/content/zh-tw/books/developers-handbook/_index.adoc
	--- a/documentation/content/zh-tw/books/developers-handbook/_index.adoc
	+++ b/documentation/content/zh-tw/books/developers-handbook/_index.adoc
	@@ -4,7 +4,8 @@
	- author: FreeBSD 文件計畫
	copyright: 1995-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "ibm", "ieee", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
	+trademarks: ["freebsd", "ibm", "ieee", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
	+isIndex: true
	---

	= FreeBSD Developers' Handbook
	diff --git a/documentation/content/zh-tw/books/faq/_index.adoc b/documentation/content/zh-tw/books/faq/_index.adoc
	--- a/documentation/content/zh-tw/books/faq/_index.adoc
	+++ b/documentation/content/zh-tw/books/faq/_index.adoc
	@@ -4,7 +4,8 @@
	- author: FreeBSD 文件計畫
	copyright: 1995-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
	+isIndex: true
	---

	= FreeBSD {rel2-relx} and {rel-relx} 常見問答集
	diff --git a/documentation/content/zh-tw/books/handbook/_index.adoc b/documentation/content/zh-tw/books/handbook/_index.adoc
	--- a/documentation/content/zh-tw/books/handbook/_index.adoc
	+++ b/documentation/content/zh-tw/books/handbook/_index.adoc
	@@ -6,6 +6,7 @@
	releaseinfo: "$FreeBSD$"
	trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
	next: books/handbook/preface
	+isIndex: true
	---

	= FreeBSD 使用手冊
	diff --git a/documentation/content/zh-tw/books/porters-handbook/_index.adoc b/documentation/content/zh-tw/books/porters-handbook/_index.adoc
	--- a/documentation/content/zh-tw/books/porters-handbook/_index.adoc
	+++ b/documentation/content/zh-tw/books/porters-handbook/_index.adoc
	@@ -4,7 +4,8 @@
	- author: The FreeBSD Documentation Project
	copyright: 2000-2020 The FreeBSD Documentation Project
	releaseinfo: "$FreeBSD$"
	-trademarks: ["freebsd", "sun", "unix", "general"]
	+trademarks: ["freebsd", "sun", "unix", "general"]
	+isIndex: true
	---

	= FreeBSD Porter 手冊
	diff --git a/documentation/themes/beastie/layouts/articles/baseof.html b/documentation/themes/beastie/layouts/articles/baseof.html
	--- a/documentation/themes/beastie/layouts/articles/baseof.html
	+++ b/documentation/themes/beastie/layouts/articles/baseof.html
	@@ -11,15 +11,25 @@
	<title>{{ block "title" . }}{{ .Site.Title }}{{ with .Params.Title }} \| {{ . }}{{ end }}{{ end }}</title>

	<!-- FAVICON -->
	+ {{ if $.Site.Params.isOnline }}
	<link rel="shortcut icon" href="{{ absLangURL ($.Site.BaseURL) }}favicon.ico">
	+ {{ else }}
	+ <link rel="shortcut icon" href="../../../favicon.ico">
	+ {{ end }}

	<meta name="theme-color" content="#790000">
	<!-- END FAVICON -->

	+ {{ if $.Site.Params.isOnline }}
	<link rel="stylesheet" href="{{ absLangURL ($.Site.BaseURL) }}css/docbook.css">
	<link rel="stylesheet" href="{{ absLangURL ($.Site.BaseURL) }}css/font-awesome-min.css">
	+ {{ else }}
	+ <link rel="stylesheet" href="../../../css/docbook.css">
	+ <link rel="stylesheet" href="../../../css/font-awesome-min.css">
	+ {{ end }}

	<!-- SEO -->
	+ {{ if $.Site.Params.isOnline }}
	<meta name="twitter:card" content="summary"/>
	<meta name="twitter:domain" content="docs.FreeBSD.org"/>
	<meta name="twitter:site" content="@freebsd"/>
	@@ -45,6 +55,7 @@
	<!-- END SEO -->

	<script src="{{ absLangURL ($.Site.BaseURL) }}js/google.js"></script>
	+ {{ end }}
	</head>
	<body>
	<main>
	diff --git a/documentation/themes/beastie/layouts/articles/single.html b/documentation/themes/beastie/layouts/articles/single.html
	--- a/documentation/themes/beastie/layouts/articles/single.html
	+++ b/documentation/themes/beastie/layouts/articles/single.html
	@@ -43,7 +43,7 @@
	{{ $releaseInfo := split .Params.releaseinfo " " }}

	{{if gt (len $releaseInfo) 3}}
	- Revision:
	+ {{ i18n "revision" }}:
	<a href="https://cgit.freebsd.org/doc/commit/?id=">
	<span class="gitref">{{ index $releaseInfo 2 }}</span>
	</a>
	diff --git a/documentation/themes/beastie/layouts/books/baseof.html b/documentation/themes/beastie/layouts/books/baseof.html
	--- a/documentation/themes/beastie/layouts/books/baseof.html
	+++ b/documentation/themes/beastie/layouts/books/baseof.html
	@@ -11,15 +11,30 @@
	<title>{{ block "title" . }}{{ .Site.Title }}{{ with .Params.Title }} \| {{ . }}{{ end }}{{ end }}</title>

	<!-- FAVICON -->
	+ {{ if $.Site.Params.isOnline }}
	<link rel="shortcut icon" href="{{ absLangURL ($.Site.BaseURL) }}favicon.ico">
	+ {{ else }}
	+ <link rel="shortcut icon" href="../../../../favicon.ico">
	+ {{ end }}

	<meta name="theme-color" content="#790000">
	<!-- END FAVICON -->

	+ {{ if $.Site.Params.isOnline }}
	<link rel="stylesheet" href="{{ absLangURL ($.Site.BaseURL) }}css/docbook.css">
	<link rel="stylesheet" href="{{ absLangURL ($.Site.BaseURL) }}css/font-awesome-min.css">
	+ {{ else }}
	+ {{ if .Params.isIndex }}
	+ <link rel="stylesheet" href="../../../css/docbook.css">
	+ <link rel="stylesheet" href="../../../css/font-awesome-min.css">
	+ {{ else }}
	+ <link rel="stylesheet" href="../../../../css/docbook.css">
	+ <link rel="stylesheet" href="../../../../css/font-awesome-min.css">
	+ {{ end }}
	+ {{ end }}

	<!-- SEO -->
	+ {{ if $.Site.Params.isOnline }}
	<meta name="twitter:card" content="summary"/>
	<meta name="twitter:domain" content="docs.FreeBSD.org"/>
	<meta name="twitter:site" content="@freebsd"/>
	@@ -45,6 +60,7 @@
	<!-- END SEO -->

	<script src="{{ absLangURL ($.Site.BaseURL) }}js/google.js"></script>
	+ {{ end }}
	</head>
	<body>
	<main>
	diff --git a/documentation/themes/beastie/layouts/books/list.html b/documentation/themes/beastie/layouts/books/list.html
	--- a/documentation/themes/beastie/layouts/books/list.html
	+++ b/documentation/themes/beastie/layouts/books/list.html
	@@ -3,7 +3,19 @@
	<div class="navheader">
	<div class="prev">
	{{ if .Params.prev }}
	- <a href={{ .Params.Prev \| absLangURL }}>{{ i18n "prev" }}</a>
	+ {{ if $.Site.Params.isOnline }}
	+ <a href={{ .Params.Prev \| absLangURL }}>{{ i18n "prev" }}</a>
	+ {{ else }}
	+ {{ $pathSectionsPrev := split .Params.Prev "/" }}
	+
	+ {{if eq (len $pathSectionsPrev) 3}}
	+ {{ $path := index $pathSectionsPrev 2 }}
	+ <a href=../{{ $path }}/index.html>{{ i18n "prev" }}</a>
	+ {{ end }}
	+ {{if eq (len $pathSectionsPrev) 2}}
	+ <a href=../index.html>{{ i18n "prev" }}</a>
	+ {{ end }}
	+ {{ end }}
	{{ end }}
	</div>
	<div class="chapter">
	@@ -14,7 +26,24 @@
	</div>
	<div class="next">
	{{ if .Params.next }}
	+ {{ if $.Site.Params.isOnline }}
	<a href={{ .Params.Next \| absLangURL }}>{{ i18n "next" }}</a>
	+ {{ else }}
	+ {{ $pathSectionsNext := split .Params.Next "/" }}
	+ {{if eq (len $pathSectionsNext) 3}}
	+ {{ if .Params.isIndex }}
	+ {{ $book := index $pathSectionsNext 1 }}
	+ {{ $path := index $pathSectionsNext 2 }}
	+ <a href=../{{ $book }}/{{ $path }}/index.html>{{ i18n "next" }}</a>
	+ {{ else }}
	+ {{ $path := index $pathSectionsNext 2 }}
	+ <a href=../{{ $path }}/index.html>{{ i18n "next" }}</a>
	+ {{ end }}
	+ {{ end }}
	+ {{if eq (len $pathSectionsNext) 2}}
	+ <a href=../index.html>{{ i18n "next" }}</a>
	+ {{ end }}
	+ {{ end }}
	{{ end }}
	</div>
	</div>
	@@ -82,12 +111,12 @@
	{{ i18n "last-modified" }} {{ index $releaseInfo 3 }} {{ $hour }} {{ i18n "by" }} {{ index $releaseInfo 5 }}.
	{{ end }}
	</div>
	-{{ if .Params.add_split_page_link }}
	+{{ if and (.Params.add_split_page_link) ($.Site.Params.isOnline) }}
	<div>
	[ <a href="../">Split HTML</a> / Single HTML ]
	</div>
	{{ end }}
	-{{ if .Params.add_single_page_link }}
	+{{ if and (.Params.add_single_page_link) ($.Site.Params.isOnline) }}
	<div>
	[ Split HTML / <a href="book/">Single HTML</a> ]
	</div>
	@@ -97,7 +126,19 @@
	<div class="navfooter">
	<div class="prev">
	{{ if .Params.prev }}
	- <a href={{ .Params.Prev \| absLangURL }}>{{ i18n "prev" }}</a>
	+ {{ if $.Site.Params.isOnline }}
	+ <a href={{ .Params.Prev \| absLangURL }}>{{ i18n "prev" }}</a>
	+ {{ else }}
	+ {{ $pathSectionsPrev := split .Params.Prev "/" }}
	+
	+ {{if eq (len $pathSectionsPrev) 3}}
	+ {{ $path := index $pathSectionsPrev 2 }}
	+ <a href=../{{ $path }}/index.html>{{ i18n "prev" }}</a>
	+ {{ end }}
	+ {{if eq (len $pathSectionsPrev) 2}}
	+ <a href=../index.html>{{ i18n "prev" }}</a>
	+ {{ end }}
	+ {{ end }}
	{{ end }}
	</div>
	<div class="home">
	@@ -105,7 +146,24 @@
	</div>
	<div class="next">
	{{ if .Params.next }}
	+ {{ if $.Site.Params.isOnline }}
	<a href={{ .Params.Next \| absLangURL }}>{{ i18n "next" }}</a>
	+ {{ else }}
	+ {{ $pathSectionsNext := split .Params.Next "/" }}
	+ {{if eq (len $pathSectionsNext) 3}}
	+ {{ if .Params.isIndex }}
	+ {{ $book := index $pathSectionsNext 1 }}
	+ {{ $path := index $pathSectionsNext 2 }}
	+ <a href=../{{ $book }}/{{ $path }}/index.html>{{ i18n "next" }}</a>
	+ {{ else }}
	+ {{ $path := index $pathSectionsNext 2 }}
	+ <a href=../{{ $path }}/index.html>{{ i18n "next" }}</a>
	+ {{ end }}
	+ {{ end }}
	+ {{if eq (len $pathSectionsNext) 2}}
	+ <a href=../index.html>{{ i18n "next" }}</a>
	+ {{ end }}
	+ {{ end }}
	{{ end }}
	</div>
	</div>
	diff --git a/documentation/themes/beastie/layouts/books/single.html b/documentation/themes/beastie/layouts/books/single.html
	--- a/documentation/themes/beastie/layouts/books/single.html
	+++ b/documentation/themes/beastie/layouts/books/single.html
	@@ -3,7 +3,19 @@
	<div class="navheader">
	<div class="prev">
	{{ if .Params.prev }}
	- <a href={{ .Params.Prev \| absLangURL }}>{{ i18n "prev" }}</a>
	+ {{ if $.Site.Params.isOnline }}
	+ <a href={{ .Params.Prev \| absLangURL }}>{{ i18n "prev" }}</a>
	+ {{ else }}
	+ {{ $pathSectionsPrev := split .Params.Prev "/" }}
	+
	+ {{if eq (len $pathSectionsPrev) 3}}
	+ {{ $path := index $pathSectionsPrev 2 }}
	+ <a href=../{{ $path }}/index.html>{{ i18n "prev" }}</a>
	+ {{ end }}
	+ {{if eq (len $pathSectionsPrev) 2}}
	+ <a href=../index.html>{{ i18n "prev" }}</a>
	+ {{ end }}
	+ {{ end }}
	{{ end }}
	</div>
	<div class="chapter">
	@@ -14,7 +26,24 @@
	</div>
	<div class="next">
	{{ if .Params.next }}
	+ {{ if $.Site.Params.isOnline }}
	<a href={{ .Params.Next \| absLangURL }}>{{ i18n "next" }}</a>
	+ {{ else }}
	+ {{ $pathSectionsNext := split .Params.Next "/" }}
	+ {{if eq (len $pathSectionsNext) 3}}
	+ {{ if .Params.isIndex }}
	+ {{ $book := index $pathSectionsNext 1 }}
	+ {{ $path := index $pathSectionsNext 2 }}
	+ <a href=../{{ $book }}/{{ $path }}/index.html>{{ i18n "next" }}</a>
	+ {{ else }}
	+ {{ $path := index $pathSectionsNext 2 }}
	+ <a href=../{{ $path }}/index.html>{{ i18n "next" }}</a>
	+ {{ end }}
	+ {{ end }}
	+ {{if eq (len $pathSectionsNext) 2}}
	+ <a href=../index.html>{{ i18n "next" }}</a>
	+ {{ end }}
	+ {{ end }}
	{{ end }}
	</div>
	</div>
	@@ -82,12 +111,12 @@
	{{ i18n "last-modified" }} {{ index $releaseInfo 3 }} {{ $hour }} {{ i18n "by" }} {{ index $releaseInfo 5 }}.
	{{ end }}
	</div>
	-{{ if .Params.add_split_page_link }}
	+{{ if and (.Params.add_split_page_link) ($.Site.Params.isOnline) }}
	<div>
	[ <a href="../">Split HTML</a> / Single HTML ]
	</div>
	{{ end }}
	-{{ if .Params.add_single_page_link }}
	+{{ if and (.Params.add_single_page_link) ($.Site.Params.isOnline) }}
	<div>
	[ Split HTML / <a href="book/">Single HTML</a> ]
	</div>
	@@ -97,7 +126,19 @@
	<div class="navfooter">
	<div class="prev">
	{{ if .Params.prev }}
	- <a href={{ .Params.Prev \| absLangURL }}>{{ i18n "prev" }}</a>
	+ {{ if $.Site.Params.isOnline }}
	+ <a href={{ .Params.Prev \| absLangURL }}>{{ i18n "prev" }}</a>
	+ {{ else }}
	+ {{ $pathSectionsPrev := split .Params.Prev "/" }}
	+
	+ {{if eq (len $pathSectionsPrev) 3}}
	+ {{ $path := index $pathSectionsPrev 2 }}
	+ <a href=../{{ $path }}/index.html>{{ i18n "prev" }}</a>
	+ {{ end }}
	+ {{if eq (len $pathSectionsPrev) 2}}
	+ <a href=../index.html>{{ i18n "prev" }}</a>
	+ {{ end }}
	+ {{ end }}
	{{ end }}
	</div>
	<div class="home">
	@@ -105,7 +146,24 @@
	</div>
	<div class="next">
	{{ if .Params.next }}
	+ {{ if $.Site.Params.isOnline }}
	<a href={{ .Params.Next \| absLangURL }}>{{ i18n "next" }}</a>
	+ {{ else }}
	+ {{ $pathSectionsNext := split .Params.Next "/" }}
	+ {{if eq (len $pathSectionsNext) 3}}
	+ {{ if .Params.isIndex }}
	+ {{ $book := index $pathSectionsNext 1 }}
	+ {{ $path := index $pathSectionsNext 2 }}
	+ <a href=../{{ $book }}/{{ $path }}/index.html>{{ i18n "next" }}</a>
	+ {{ else }}
	+ {{ $path := index $pathSectionsNext 2 }}
	+ <a href=../{{ $path }}/index.html>{{ i18n "next" }}</a>
	+ {{ end }}
	+ {{ end }}
	+ {{if eq (len $pathSectionsNext) 2}}
	+ <a href=../index.html>{{ i18n "next" }}</a>
	+ {{ end }}
	+ {{ end }}
	{{ end }}
	</div>
	</div>
	diff --git a/documentation/tools/books-toc-creator.py b/documentation/tools/books-toc-creator.py
	--- a/documentation/tools/books-toc-creator.py
	+++ b/documentation/tools/books-toc-creator.py
	@@ -126,17 +126,20 @@
	def main(argv):

	justPrintOutput = False
	+ offline = False
	langargs = []
	try:
	- opts, args = getopt.gnu_getopt(argv,"hl:o",["language="])
	+ opts, args = getopt.gnu_getopt(argv,"hl:o:p",["language="])
	except getopt.GetoptError:
	- print('books-toc-creator.py [-o] -l <language>')
	+ print('books-toc-creator.py [-o] [-p] -l <language>')
	sys.exit(2)
	for opt, arg in opts:
	if opt == '-h':
	- print('books-toc-creator.py [-o] -l <language>')
	+ print('books-toc-creator.py [-o] [-p] -l <language>')
	sys.exit()
	elif opt == '-o':
	+ offline = True
	+ elif opt == '-p':
	justPrintOutput = True
	elif opt in ("-l", "--language"):
	langargs = arg.replace(" ",",").split(',')
	@@ -175,7 +178,10 @@
	with open('./content/{0}/books/{1}/{2}'.format(language, book, chapter), 'r', encoding = 'utf-8') as chapterFile:
	chapterContent = chapterFile.read().splitlines()
	chapterFile.close()
	- chapter = chapter.replace("/_index.adoc", "").replace(".adoc", "")
	+ if offline:
	+ chapter = chapter.replace("/_index.adoc", "/index.html").replace(".adoc", ".html")
	+ else:
	+ chapter = chapter.replace("/_index.adoc", "").replace(".adoc", "")

	if checkIsPart(chapter):
	for lineNumber, chapterLine in enumerate(chapterContent, 1):
	@@ -197,7 +203,7 @@
	toc += "** link:{0}[{1} {2}]\n".format(chapter, setAppendixTitle(language), chapterLine.replace("=", "").strip())

	elif re.match(r"^={2} [^\n]+", chapterLine):
	- toc += "*** link:{0}/#{1}[{2}]\n".format(chapter, chapterContent[lineNumber-2].replace("[[", "").replace("]]", ""), chapterLine.replace("==", "").lstrip())
	+ toc += "*** link:{0}#{1}[{2}]\n".format(chapter, chapterContent[lineNumber-2].replace("[[", "").replace("]]", ""), chapterLine.replace("==", "").lstrip())

	else: # Normal chapter
	for lineNumber, chapterLine in enumerate(chapterContent, 1):
	@@ -206,7 +212,7 @@
	toc += "** link:{0}[{1} {2}. {3}]\n".format(chapter, setChapterTitle(language), chapterCounter, chapterLine.replace("=", "").strip())

	elif re.match(r"^={2} [^\n]+", chapterLine):
	- toc += "*** link:{0}/#{1}[{2}.{3}. {4}]\n".format(chapter, chapterContent[lineNumber-2].replace("[[", "").replace("]]", ""), chapterCounter, subChapterCounter, chapterLine.replace("==", "").lstrip())
	+ toc += "*** link:{0}#{1}[{2}.{3}. {4}]\n".format(chapter, chapterContent[lineNumber-2].replace("[[", "").replace("]]", ""), chapterCounter, subChapterCounter, chapterLine.replace("==", "").lstrip())
	subChapterCounter += 1

	chapterCounter += 1
	diff --git a/documentation/tools/books-toc-examples-creator.py b/documentation/tools/books-toc-examples-creator.py
	--- a/documentation/tools/books-toc-examples-creator.py
	+++ b/documentation/tools/books-toc-examples-creator.py
	@@ -57,17 +57,20 @@
	def main(argv):

	justPrintOutput = False
	+ offline = False
	langargs = []
	try:
	- opts, args = getopt.gnu_getopt(argv,"hl:o",["language="])
	+ opts, args = getopt.gnu_getopt(argv,"hl:o:p",["language="])
	except getopt.GetoptError:
	- print('books-toc-examples-creator.py [-o] -l <language>')
	+ print('books-toc-examples-creator.py [-o] [-p] -l <language>')
	sys.exit(2)
	for opt, arg in opts:
	if opt == '-h':
	- print('books-toc-examples-creator.py [-o] -l <language>')
	+ print('books-toc-examples-creator.py [-o] [-p] -l <language>')
	sys.exit()
	if opt == '-o':
	+ offline = True
	+ if opt == '-p':
	justPrintOutput = True
	elif opt in ("-l", "--language"):
	langargs = arg.replace(" ",",").split(',')
	@@ -105,7 +108,11 @@
	with open('./content/{0}/books/{1}/{2}'.format(language, book, chapter), 'r', encoding = 'utf-8') as chapterFile:
	chapterContent = chapterFile.read().splitlines()
	chapterFile.close()
	- chapter = chapter.replace("/_index.adoc", "").replace(".adoc", "").replace("/chapter.adoc", "")
	+
	+ if offline:
	+ chapter = chapter.replace("/_index.adoc", "/index.html").replace(".adoc", ".html").replace("/chapter.adoc", "/index.html")
	+ else:
	+ chapter = chapter.replace("/_index.adoc", "").replace(".adoc", "").replace("/chapter.adoc", "")

	exampleId = ""
	exampleTitle = ""
	diff --git a/documentation/tools/books-toc-figures-creator.py b/documentation/tools/books-toc-figures-creator.py
	--- a/documentation/tools/books-toc-figures-creator.py
	+++ b/documentation/tools/books-toc-figures-creator.py
	@@ -55,19 +55,22 @@
	return languages.get(language)

	def main(argv):
	-
	+
	+ offline = False
	justPrintOutput = False
	langargs = []
	try:
	- opts, args = getopt.gnu_getopt(argv,"hl:o",["language="])
	+ opts, args = getopt.gnu_getopt(argv,"hl:o:p",["language="])
	except getopt.GetoptError:
	- print('books-toc-figures-creator.py [-o] -l <language>')
	+ print('books-toc-figures-creator.py [-o] [-p] -l <language>')
	sys.exit(2)
	for opt, arg in opts:
	if opt == '-h':
	- print('books-toc-figures-creator.py [-o] -l <language>')
	+ print('books-toc-figures-creator.py [-o] [-p] -l <language>')
	sys.exit()
	if opt == '-o':
	+ offline = True
	+ if opt == '-p':
	justPrintOutput = True
	elif opt in ("-l", "--language"):
	langargs = arg.replace(" ",",").split(',')
	@@ -105,7 +108,11 @@
	with open('./content/{0}/books/{1}/{2}'.format(language, book, chapter), 'r', encoding = 'utf-8') as chapterFile:
	chapterContent = chapterFile.read().splitlines()
	chapterFile.close()
	- chapter = chapter.replace("/_index.adoc", "").replace(".adoc", "").replace("/chapter.adoc", "")
	+
	+ if offline:
	+ chapter = chapter.replace("/_index.adoc", "/index.html").replace(".adoc", ".html").replace("/chapter.adoc", "/index.html")
	+ else:
	+ chapter = chapter.replace("/_index.adoc", "").replace(".adoc", "").replace("/chapter.adoc", "")

	figureId = ""
	figureTitle = ""
	diff --git a/documentation/tools/books-toc-parts-creator.py b/documentation/tools/books-toc-parts-creator.py
	--- a/documentation/tools/books-toc-parts-creator.py
	+++ b/documentation/tools/books-toc-parts-creator.py
	@@ -121,18 +121,21 @@
	def main(argv):
	global justPrintOutput

	+ offline = False
	justPrintOutput = False
	langargs=[]
	try:
	- opts, args = getopt.gnu_getopt(argv,"hl:o",["language="])
	+ opts, args = getopt.gnu_getopt(argv,"hl:o:p",["language="])
	except getopt.GetoptError:
	- print('books-toc-creator.py [-o] -l <language>')
	+ print('books-toc-creator.py [-o] [-p] -l <language>')
	sys.exit(2)
	for opt, arg in opts:
	if opt == '-h':
	- print('books-toc-creator.py [-o] -l <language>')
	+ print('books-toc-creator.py [-o] [-p] -l <language>')
	sys.exit()
	elif opt == '-o':
	+ offline = True
	+ elif opt == '-p':
	justPrintOutput = True
	elif opt in ("-l", "--language"):
	langargs = arg.replace(" ",",").split(',')
	@@ -165,7 +168,11 @@
	with open('./content/{0}/books/{1}/{2}'.format(language, book, chapter), 'r', encoding = 'utf-8') as chapterFile:
	chapterContent = chapterFile.read().splitlines()
	chapterFile.close()
	- chapter = chapter.replace("/_index.adoc", "").replace(".adoc", "")
	+
	+ if offline:
	+ chapter = chapter.replace("/_index.adoc", "/index.html").replace(".adoc", ".html")
	+ else:
	+ chapter = chapter.replace("/_index.adoc", "").replace(".adoc", "")

	if checkIsPart(chapter):

	@@ -186,7 +193,7 @@
	toc += "* link:../{0}[{1} {2}]\n".format(chapter, setAppendixTitle(language), chapterLine.replace("=", "").strip())

	elif (re.match(r"^={2} [^\n]+", chapterLine)):
	- toc += "** link:../{0}/#{1}[{2}]\n".format(chapter, chapterContent[lineNumber-2].replace("[[", "").replace("]]", ""), chapterLine.replace("==", "").lstrip())
	+ toc += "** link:../{0}#{1}[{2}]\n".format(chapter, chapterContent[lineNumber-2].replace("[[", "").replace("]]", ""), chapterLine.replace("==", "").lstrip())

	else:
	for lineNumber, chapterLine in enumerate(chapterContent, 1):
	@@ -195,7 +202,7 @@
	toc += "* link:../{0}[{1} {2}. {3}]\n".format(chapter, setChapterTitle(language), chapterCounter, chapterLine.replace("=", "").strip())

	elif re.match(r"^={2} [^\n]+", chapterLine):
	- toc += "** link:../{0}/#{1}[{2}.{3}. {4}]\n".format(chapter, chapterContent[lineNumber-2].replace("[[", "").replace("]]", ""), chapterCounter, subChapterCounter, chapterLine.replace("==", "").lstrip())
	+ toc += "** link:../{0}#{1}[{2}.{3}. {4}]\n".format(chapter, chapterContent[lineNumber-2].replace("[[", "").replace("]]", ""), chapterCounter, subChapterCounter, chapterLine.replace("==", "").lstrip())
	subChapterCounter += 1

	chapterCounter += 1
	diff --git a/documentation/tools/books-toc-tables-creator.py b/documentation/tools/books-toc-tables-creator.py
	--- a/documentation/tools/books-toc-tables-creator.py
	+++ b/documentation/tools/books-toc-tables-creator.py
	@@ -55,18 +55,21 @@

	def main(argv):

	+ offline = False
	justPrintOutput = False
	langargs= []
	try:
	- opts, args = getopt.gnu_getopt(argv,"hl:o",["language="])
	+ opts, args = getopt.gnu_getopt(argv,"hl:o:p",["language="])
	except getopt.GetoptError:
	- print('books-toc-tables-creator.py [-o] -l <language>')
	+ print('books-toc-tables-creator.py [-o] [-p] -l <language>')
	sys.exit(2)
	for opt, arg in opts:
	if opt == '-h':
	- print('books-toc-tables-creator.py [-o] -l <language>')
	+ print('books-toc-tables-creator.py [-o] [-p] -l <language>')
	sys.exit()
	if opt == '-o':
	+ offline = True
	+ if opt == '-p':
	justPrintOutput = True
	elif opt in ("-l", "--language"):
	langargs = arg.replace(" ",",").split(',')
	@@ -104,7 +107,11 @@
	with open('./content/{0}/books/{1}/{2}'.format(language, book, chapter), 'r', encoding = 'utf-8') as chapterFile:
	chapterContent = chapterFile.read().splitlines()
	chapterFile.close()
	- chapter = chapter.replace("/_index.adoc", "").replace(".adoc", "").replace("/chapter.adoc", "")
	+
	+ if offline:
	+ chapter = chapter.replace("/_index.adoc", "/index.html").replace(".adoc", ".html").replace("/chapter.adoc", "/index.html")
	+ else:
	+ chapter = chapter.replace("/_index.adoc", "").replace(".adoc", "").replace("/chapter.adoc", "")

	tableId = ""
	tableTitle = ""
	diff --git a/shared/en/urls.adoc b/shared/en/urls.adoc
	--- a/shared/en/urls.adoc
	+++ b/shared/en/urls.adoc
	@@ -1,51 +1,60 @@
	-// $FreeBSD$

	+ifeval::[{isonline} == 1]
	:main-site: https://docs.freebsd.org/en
	+endif::[]
	+
	+ifeval::[{isonline} == 0]
	+:main-site: ../../../en
	+endif::[]
	+
	+ifndef::isonline[]
	+:main-site: https://docs.freebsd.org/en
	+endif::[]

	// books
	-:dev-model: {main-site}/books/dev-model/
	-:faq: {main-site}/books/faq/
	-:handbook: {main-site}/books/handbook/
	-:developers-handbook: {main-site}/books/developers-handbook/
	-:arch-handbook: {main-site}/books/arch-handbook/
	-:porters-handbook: {main-site}/books/porters-handbook/
	-:design-44bsd: {main-site}/books/design-44bsd/
	-:fdp-primer: {main-site}/books/fdp-primer/
	+:dev-model: {main-site}/books/dev-model
	+:faq: {main-site}/books/faq
	+:handbook: {main-site}/books/handbook
	+:developers-handbook: {main-site}/books/developers-handbook
	+:arch-handbook: {main-site}/books/arch-handbook
	+:porters-handbook: {main-site}/books/porters-handbook
	+:design-44bsd: {main-site}/books/design-44bsd
	+:fdp-primer: {main-site}/books/fdp-primer

	// articles
	-:bsdl-gpl: {main-site}/articles/bsdl-gpl/
	-:building-products: {main-site}/articles/building-products/
	-:committers-guide: {main-site}/articles/committers-guide/
	-:contributing: {main-site}/articles/contributing/
	-:contributors: {main-site}/articles/contributors/
	-:cups: {main-site}/articles/cups/
	-:explaining-bsd: {main-site}/articles/explaining-bsd/
	-:filtering-bridges: {main-site}/articles/filtering-bridges/
	-:fonts: {main-site}/articles/fonts/
	-:freebsd-questions-article: {main-site}/articles/freebsd-questions/
	-:freebsd-src-lsp: {main-site}/articles/freebsd-src-lsp/
	-:freebsd-update-server: {main-site}/articles/freebsd-update-server/
	-:geom-class: {main-site}/articles/geom-class/
	-:gjournal-desktop: {main-site}/articles/gjournal-desktop/
	-:hubs: {main-site}/articles/hubs/
	-:ipsec-must: {main-site}/articles/ipsec-must/
	-:ldap-auth: {main-site}/articles/ldap-auth/
	-:leap-seconds: {main-site}/articles/leap-seconds/
	-:linux-emulation: {main-site}/articles/linux-emulation/
	-:linux-users: {main-site}/articles/linux-users/
	-:mailing-list-faq: {main-site}/articles/mailing-list-faq/
	-:nanobsd: {main-site}/articles/nanobsd/
	-:new-users: {main-site}/articles/new-users/
	-:pam: {main-site}/articles/pam/
	-:pgpkeys: {main-site}/articles/pgpkeys/
	-:port-mentor-guidelines: {main-site}/articles/port-mentor-guidelines/
	-:pr-guidelines: {main-site}/articles/pr-guidelines/
	-:problem-reports: {main-site}/articles/problem-reports/
	-:rc-scripting: {main-site}/articles/rc-scripting/
	-:releng: {main-site}/articles/releng/
	-:freebsd-releng: {main-site}/articles/freebsd-releng/
	-:remote-install: {main-site}/articles/remote-install/
	-:serial-uart: {main-site}/articles/serial-uart/
	-:solid-state: {main-site}/articles/solid-state/
	-:vinum: {main-site}/articles/vinum/
	-:vm-design: {main-site}/articles/vm-design/
	+:bsdl-gpl: {main-site}/articles/bsdl-gpl
	+:building-products: {main-site}/articles/building-products
	+:committers-guide: {main-site}/articles/committers-guide
	+:contributing: {main-site}/articles/contributing
	+:contributors: {main-site}/articles/contributors
	+:cups: {main-site}/articles/cups
	+:explaining-bsd: {main-site}/articles/explaining-bsd
	+:filtering-bridges: {main-site}/articles/filtering-bridges
	+:fonts: {main-site}/articles/fonts
	+:freebsd-questions-article: {main-site}/articles/freebsd-questions
	+:freebsd-src-lsp: {main-site}/articles/freebsd-src-lsp
	+:freebsd-update-server: {main-site}/articles/freebsd-update-server
	+:geom-class: {main-site}/articles/geom-class
	+:gjournal-desktop: {main-site}/articles/gjournal-desktop
	+:hubs: {main-site}/articles/hubs
	+:ipsec-must: {main-site}/articles/ipsec-must
	+:ldap-auth: {main-site}/articles/ldap-auth
	+:leap-seconds: {main-site}/articles/leap-seconds
	+:linux-emulation: {main-site}/articles/linux-emulation
	+:linux-users: {main-site}/articles/linux-users
	+:mailing-list-faq: {main-site}/articles/mailing-list-faq
	+:nanobsd: {main-site}/articles/nanobsd
	+:new-users: {main-site}/articles/new-users
	+:pam: {main-site}/articles/pam
	+:pgpkeys: {main-site}/articles/pgpkeys
	+:port-mentor-guidelines: {main-site}/articles/port-mentor-guidelines
	+:pr-guidelines: {main-site}/articles/pr-guidelines
	+:problem-reports: {main-site}/articles/problem-reports
	+:rc-scripting: {main-site}/articles/rc-scripting
	+:releng: {main-site}/articles/releng
	+:freebsd-releng: {main-site}/articles/freebsd-releng
	+:remote-install: {main-site}/articles/remote-install
	+:serial-uart: {main-site}/articles/serial-uart
	+:solid-state: {main-site}/articles/solid-state
	+:vinum: {main-site}/articles/vinum
	+:vm-design: {main-site}/articles/vm-design
	diff --git a/shared/lib/InterDocumentReferencesMacro/extension.rb b/shared/lib/InterDocumentReferencesMacro/extension.rb
	--- a/shared/lib/InterDocumentReferencesMacro/extension.rb
	+++ b/shared/lib/InterDocumentReferencesMacro/extension.rb
	@@ -12,12 +12,21 @@
	destination = target
	anchor = attrs[1]
	text = attrs[2]
	-
	+
	doc = parent.document
	+
	if doc.attributes['book'] == 'True'
	+ if doc.attributes['isonline'] == 1
	(create_anchor parent, text, type: :link, target: %(./##{anchor})).render
	+ else
	+ (create_anchor parent, text, type: :link, target: %(./index.html##{anchor})).render
	+ end
	else
	+ if doc.attributes['isonline'] == 1
	(create_anchor parent, text, type: :link, target: %(../#{destination}/##{anchor})).render
	+ else
	+ (create_anchor parent, text, type: :link, target: %(../#{destination}/index.html##{anchor})).render
	+ end
	end

	end

File Metadata

Mime Type: text/plain
Expires: Sat, Dec 20, 7:27 AM (17 h, 52 m)
Storage Engine: blob
Storage Format: Raw Data
Storage Handle: 27093466
Default Alt Text: D31926.id95469.diff (558 KB)

D31926.id95469.diffNo OneTemporaryActions

D31926.id95469.diffView Options

File Metadata

Event Timeline

D31926.id95469.diff
No OneTemporary
Actions

D31926.id95469.diff
View Options