git: 6f163cbdc2 - main - Split German porter's handbook

Go to: [ bottom of page ] [ top of archives ] [ this month ]
From: Sergio Carlavilla Delgado <carlavilla_at_FreeBSD.org>
Date: Fri, 26 Nov 2021 20:10:54 UTC
The branch main has been updated by carlavilla:

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

commit 6f163cbdc275897332cddcae36a3a8f1c3237125
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2021-11-26 20:10:06 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2021-11-26 20:10:06 +0000

    Split German porter's handbook
---
 .../content/de/books/porters-handbook/_index.adoc  | 28 ++-------
 .../content/de/books/porters-handbook/book.adoc    | 67 ++++++++++++++++++++++
 .../de/books/porters-handbook/chapters-order.adoc  | 28 ++++-----
 .../keeping-up/{chapter.adoc => _index.adoc}       |  0
 .../makefile/{chapter.adoc => _index.adoc}         |  4 +-
 .../own-port/{chapter.adoc => _index.adoc}         |  2 +-
 .../pkg-files/{chapter.adoc => _index.adoc}        |  0
 .../plist/{chapter.adoc => _index.adoc}            |  0
 .../port-upgrading/{chapter.adoc => _index.adoc}   |  4 +-
 .../porting-dads/{chapter.adoc => _index.adoc}     |  2 +-
 .../porting-samplem/{chapter.adoc => _index.adoc}  |  0
 .../quick-porting/{chapter.adoc => _index.adoc}    |  0
 .../security/{chapter.adoc => _index.adoc}         |  0
 .../slow/{chapter.adoc => _index.adoc}             |  0
 .../special/{chapter.adoc => _index.adoc}          |  6 +-
 .../testing/{chapter.adoc => _index.adoc}          |  2 +-
 .../why-port/{chapter.adoc => _index.adoc}         |  0
 17 files changed, 96 insertions(+), 47 deletions(-)

diff --git a/documentation/content/de/books/porters-handbook/_index.adoc b/documentation/content/de/books/porters-handbook/_index.adoc
index 43795744da..e61ff38a9d 100644
--- a/documentation/content/de/books/porters-handbook/_index.adoc
+++ b/documentation/content/de/books/porters-handbook/_index.adoc
@@ -4,21 +4,22 @@ authors:
   - author: The FreeBSD Documentation Project
 copyright: 2000-2020 The FreeBSD Documentation Project
 trademarks: ["freebsd", "sun", "unix", "general"]
+next: books/porters-handbook/why-port
+add_single_page_link: true
 isIndex: true
 ---
 
 = FreeBSD Porter's Handbook
 :doctype: book
 :toc: macro
-:toclevels: 2
+:toclevels: 1
 :icons: font
 :sectnums:
 :sectnumlevels: 6
 :partnums:
 :source-highlighter: rouge
 :experimental:
-:book: true
-:pdf: false
+:images-path: books/porters-handbook/
 
 ifdef::env-beastie[]
 ifdef::backend-html5[]
@@ -44,23 +45,4 @@ endif::[]
 
 '''
 
-toc::[]
-
-include::{chapters-path}toc-tables.adoc[]
-
-include::{chapters-path}toc-examples.adoc[]
-
-include::{chapters-path}why-port/chapter.adoc[leveloffset=+1]
-include::{chapters-path}own-port/chapter.adoc[leveloffset=+1]
-include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1]
-include::{chapters-path}slow/chapter.adoc[leveloffset=+1]
-include::{chapters-path}makefile/chapter.adoc[leveloffset=+1]
-include::{chapters-path}special/chapter.adoc[leveloffset=+1]
-include::{chapters-path}plist/chapter.adoc[leveloffset=+1]
-include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1]
-include::{chapters-path}testing/chapter.adoc[leveloffset=+1]
-include::{chapters-path}port-upgrading/chapter.adoc[leveloffset=+1]
-include::{chapters-path}security/chapter.adoc[leveloffset=+1]
-include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1]
-include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1]
-include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1]
+include::{chapters-path}toc.adoc[]
diff --git a/documentation/content/de/books/porters-handbook/book.adoc b/documentation/content/de/books/porters-handbook/book.adoc
new file mode 100644
index 0000000000..de88775b11
--- /dev/null
+++ b/documentation/content/de/books/porters-handbook/book.adoc
@@ -0,0 +1,67 @@
+---
+title: FreeBSD Porter's Handbook
+authors: 
+  - author: The FreeBSD Documentation Project
+copyright: 2000-2020 The FreeBSD Documentation Project
+trademarks: ["freebsd", "sun", "unix", "general"]
+add_split_page_link: true
+---
+
+= FreeBSD Porter's Handbook
+:doctype: book
+:toc: macro
+:toclevels: 2
+:icons: font
+:sectnums:
+:sectnumlevels: 6
+:partnums:
+:source-highlighter: rouge
+:experimental:
+:book: true
+:pdf: false
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/porters-handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+
+'''
+
+toc::[]
+
+include::{chapters-path}toc-tables.adoc[]
+
+include::{chapters-path}toc-examples.adoc[]
+
+include::{chapters-path}why-port/_index.adoc[leveloffset=+1]
+include::{chapters-path}own-port/_index.adoc[leveloffset=+1]
+include::{chapters-path}quick-porting/_index.adoc[leveloffset=+1]
+include::{chapters-path}slow/_index.adoc[leveloffset=+1]
+include::{chapters-path}makefile/_index.adoc[leveloffset=+1]
+include::{chapters-path}special/_index.adoc[leveloffset=+1]
+include::{chapters-path}plist/_index.adoc[leveloffset=+1]
+include::{chapters-path}pkg-files/_index.adoc[leveloffset=+1]
+include::{chapters-path}testing/_index.adoc[leveloffset=+1]
+include::{chapters-path}port-upgrading/_index.adoc[leveloffset=+1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
+include::{chapters-path}porting-dads/_index.adoc[leveloffset=+1]
+include::{chapters-path}porting-samplem/_index.adoc[leveloffset=+1]
+include::{chapters-path}keeping-up/_index.adoc[leveloffset=+1]
+ 
diff --git a/documentation/content/de/books/porters-handbook/chapters-order.adoc b/documentation/content/de/books/porters-handbook/chapters-order.adoc
index 606ef5a93c..8ab4706cdf 100644
--- a/documentation/content/de/books/porters-handbook/chapters-order.adoc
+++ b/documentation/content/de/books/porters-handbook/chapters-order.adoc
@@ -1,14 +1,14 @@
-why-port/chapter.adoc
-own-port/chapter.adoc
-quick-porting/chapter.adoc
-slow/chapter.adoc
-makefile/chapter.adoc
-special/chapter.adoc
-plist/chapter.adoc
-pkg-files/chapter.adoc
-testing/chapter.adoc
-port-upgrading/chapter.adoc
-security/chapter.adoc
-porting-dads/chapter.adoc
-porting-samplem/chapter.adoc
-keeping-up/chapter.adoc
+why-port/_index.adoc
+own-port/_index.adoc
+quick-porting/_index.adoc
+slow/_index.adoc
+makefile/_index.adoc
+special/_index.adoc
+plist/_index.adoc
+pkg-files/_index.adoc
+testing/_index.adoc
+port-upgrading/_index.adoc
+security/_index.adoc
+porting-dads/_index.adoc
+porting-samplem/_index.adoc
+keeping-up/_index.adoc
diff --git a/documentation/content/de/books/porters-handbook/keeping-up/chapter.adoc b/documentation/content/de/books/porters-handbook/keeping-up/_index.adoc
similarity index 100%
rename from documentation/content/de/books/porters-handbook/keeping-up/chapter.adoc
rename to documentation/content/de/books/porters-handbook/keeping-up/_index.adoc
diff --git a/documentation/content/de/books/porters-handbook/makefile/chapter.adoc b/documentation/content/de/books/porters-handbook/makefile/_index.adoc
similarity index 98%
rename from documentation/content/de/books/porters-handbook/makefile/chapter.adoc
rename to documentation/content/de/books/porters-handbook/makefile/_index.adoc
index e6c81caaad..9b6ac63c44 100644
--- a/documentation/content/de/books/porters-handbook/makefile/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/makefile/_index.adoc
@@ -1380,7 +1380,7 @@ eine Abhängigkeit für GCC34 für jeden Port einschliesslich GCC34 selbst hinzu
 |Dieser Port benötigt eine bestimmte Version von `gcc` zur Erstellung. Die genaue Version kann festgelegt werden mit Werten wie `3.4`. Mit `3.4+` kann die mindestens erforderliche Version spezifiziert werden. Der `gcc` aus dem Basissystem wird genutzt, wenn er die erforderliche Version erfüllt, andernfalls wird eine geeignete Version des `gcc` aus den Ports kompiliert und die Variablen `CC` und `CXX` werden angepasst.
 |===
 
-Variablen zugehörig zu gmake und dem [.filename]#configure#-Skript werden in <<building>> beschrieben, währenddessen autoconf, automake und libtool in <<using-autotools>> beschrieben sind. Perl-spezifische Variablen werden in <<using-perl>> behandelt. X11-Variablen sind aufgelistet in <<using-x11>>. <<using-gnome>> behandelt GNOME-bezogene Variablen und <<using-kde>> KDE-bezogene Variablen. <<using-java>> dokumentiert Java-Variablen, während <<using-php>>Informationen zu Apache, PHP und PEAR-Modulen enthält. Python wird in <<using-python>> und Ruby in <<using-ruby>> erörtert. <<using-sdl>> stellt Variablen für SDL-Programme zur Verfügung und <<using-xfce>> enthält schliesslich Variablen für Xfce.
+Variablen zugehörig zu gmake und dem [.filename]#configure#-Skript werden in crossref:special[building, Build-Mechanismen] beschrieben, währenddessen autoconf, automake und libtool in crossref:special[using-autotools, Benutzung von GNU autotools] beschrieben sind. Perl-spezifische Variablen werden in crossref:special[using-perl, Die Benutzung von `perl`] behandelt. X11-Variablen sind aufgelistet in crossref:special[using-x11, Benutzung von X11]. crossref:special[using-gnome, Benutzung von GNOME] behandelt GNOME-bezogene Variablen und crossref:special[using-kde, Benutzung von KDE] KDE-bezogene Variablen. crossref:special[using-java, Benutzung von Java] dokumentiert Java-Variablen, während crossref:special[using-php, Webanwendungen, Apache und PHP]Informationen zu Apache, PHP und PEAR-Modulen enthält. Python wird in crossref:special[using-python, Python benutzen] und Ruby in crossref:special[using-ruby, Ruby benutzen] erörtert. crossref:special[using-sdl, SDL verwenden] stellt Va
 riablen für SDL-Programme zur Verfügung und crossref:special[using-xfce, Xfce verwenden] enthält schliesslich Variablen für Xfce.
 
 === Minimale Version einer Abhängigkeit
 
@@ -1735,7 +1735,7 @@ Es gibt drei verschiedene Variablen, um einen Konflikt zwischen Paketen und Port
 
 [NOTE]
 ====
-`CONFLICTS` setzt automatisch die Variable `IGNORE`, die ausführlicher in <<dads-noinstall>> beschrieben wird.
+`CONFLICTS` setzt automatisch die Variable `IGNORE`, die ausführlicher in crossref:porting-dads[dads-noinstall, Einen Port durch `BROKEN` - `FORBIDDEN` oder `IGNORE` als nicht installierbar markieren] beschrieben wird.
 ====
 
 Beim Entfernen eines von mehreren in Konflikt stehenden Ports ist es ratsam, die `CONFLICTS`-Einträge in den anderen Ports für einige Monate beizubehalten, um Nutzer zu unterstützen, die ihre Ports nur sporadisch aktualisieren.
diff --git a/documentation/content/de/books/porters-handbook/own-port/chapter.adoc b/documentation/content/de/books/porters-handbook/own-port/_index.adoc
similarity index 94%
rename from documentation/content/de/books/porters-handbook/own-port/chapter.adoc
rename to documentation/content/de/books/porters-handbook/own-port/_index.adoc
index 42a774de4e..35fdad8270 100644
--- a/documentation/content/de/books/porters-handbook/own-port/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/own-port/_index.adoc
@@ -44,7 +44,7 @@ endif::[]
 
 Sie sind also daran interessiert, einen neuen Port zu erstellen oder einen vorhandenen zu aktualisieren? Großartig!
 
-Die folgenden Kapitel beinhalten einige Richtlinien, um einen neuen Port für FreeBSD zu erstellen. Wenn Sie einen vorhandenen Port auf den neuesten Stand bringen wollen, sollten Sie mit <<port-upgrading>> fortfahren.
+Die folgenden Kapitel beinhalten einige Richtlinien, um einen neuen Port für FreeBSD zu erstellen. Wenn Sie einen vorhandenen Port auf den neuesten Stand bringen wollen, sollten Sie mit crossref:port-upgrading[port-upgrading, Einen existierenden Port aktualisieren] fortfahren.
 
 Wenn Ihnen dieses Dokument nicht detailliert genug ist, sollten Sie einen Blick in [.filename]#/usr/ports/Mk/bsd.port.mk# werfen. Das Makefile jedes Ports bindet diese Datei ein. Auch wenn Sie nicht täglich mit Makefiles arbeiten, sollten Sie gut damit zurecht kommen, da die Datei gut dokumentiert ist und Sie eine Menge Wissen daraus erlangen können. Zusätzlich können Sie speziellere Fragen an die {freebsd-ports}-Mailingliste stellen.
 
diff --git a/documentation/content/de/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/de/books/porters-handbook/pkg-files/_index.adoc
similarity index 100%
rename from documentation/content/de/books/porters-handbook/pkg-files/chapter.adoc
rename to documentation/content/de/books/porters-handbook/pkg-files/_index.adoc
diff --git a/documentation/content/de/books/porters-handbook/plist/chapter.adoc b/documentation/content/de/books/porters-handbook/plist/_index.adoc
similarity index 100%
rename from documentation/content/de/books/porters-handbook/plist/chapter.adoc
rename to documentation/content/de/books/porters-handbook/plist/_index.adoc
diff --git a/documentation/content/de/books/porters-handbook/port-upgrading/chapter.adoc b/documentation/content/de/books/porters-handbook/port-upgrading/_index.adoc
similarity index 97%
rename from documentation/content/de/books/porters-handbook/port-upgrading/chapter.adoc
rename to documentation/content/de/books/porters-handbook/port-upgrading/_index.adoc
index 1acc172e34..f3ff518c1a 100644
--- a/documentation/content/de/books/porters-handbook/port-upgrading/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/port-upgrading/_index.adoc
@@ -79,7 +79,7 @@ Wenn Sie Ihre Aktualisierung aufgrund von Sicherheitsbedenken oder eines schwerw
 Noch einmal: Bitte verwenden Sie man:diff[1] und nicht man:shar[1], um Aktualisierungen existierender Ports zu senden. Sie erleichtern es damit den Ports-Committern, Ihre Änderungen nachzuvollziehen.
 ====
 
-Nun, da Sie all das geschafft haben, können Sie in <<keeping-up>> nachlesen, wie Sie den Port aktuell halten.
+Nun, da Sie all das geschafft haben, können Sie in crossref:keeping-up[keeping-up, Auf dem Laufenden bleiben] nachlesen, wie Sie den Port aktuell halten.
 
 [[cvs-diff]]
 == Patches mit CVS erstellen
@@ -107,7 +107,7 @@ Danach modifizieren Sie den Port in gewohnter Weise. Falls Sie Dateien hinzufüg
 % cvs remove deleted_file
 ....
 
-Überprüfen Sie die Funktion Ihres Ports anhand der Checklisten in <<porting-testing>> und <<porting-portlint>>.
+Überprüfen Sie die Funktion Ihres Ports anhand der Checklisten in crossref:quick-porting[porting-testing, Den Port testen] und crossref:quick-porting[porting-portlint,Ihren Port mit `portlint` überprüfen].
 
 [source,shell]
 ....
diff --git a/documentation/content/de/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/de/books/porters-handbook/porting-dads/_index.adoc
similarity index 99%
rename from documentation/content/de/books/porters-handbook/porting-dads/chapter.adoc
rename to documentation/content/de/books/porters-handbook/porting-dads/_index.adoc
index 09279e202a..6853f0ec12 100644
--- a/documentation/content/de/books/porters-handbook/porting-dads/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/porting-dads/_index.adoc
@@ -2723,7 +2723,7 @@ Es gibt keine Vorschrift wie lange die Vorwarnzeit sein muss. Gegenwärtig ist e
 
 Der korrekte Weg eines [.filename]#Makefile# anzuzeigen, dass der Port aufgrund eines externen Grundes nicht installiert werden kann (zum Beispiel, weil der Benutzer eine ungültige Kombination von Build-Optionen angegeben hat), ist `IGNORE` auf einen nicht leeren Wert zu setzen. Dieser wird dann formatiert und dem Benutzer von `make install` ausgegeben.
 
-Es ist ein verbreiteter Fehler `.error` für diesem Zweck zu verwenden. Das Problem dabei ist, dass viele automatisierte Werkzeuge, die mit dem Ports-Baum arbeiten, in dieser Situation fehlschlagen. Am Häufigsten tritt das Problem beim Versuch [.filename]#/usr/ports/INDEX# zu bauen auf (siehe <<make-describe>>). Jedoch schlagen auch trivialere Befehle wie `make maintainer` in diesem Fall fehl. Dies ist nicht akzeptabel!
+Es ist ein verbreiteter Fehler `.error` für diesem Zweck zu verwenden. Das Problem dabei ist, dass viele automatisierte Werkzeuge, die mit dem Ports-Baum arbeiten, in dieser Situation fehlschlagen. Am Häufigsten tritt das Problem beim Versuch [.filename]#/usr/ports/INDEX# zu bauen auf (siehe crossref:testing[make-describe, `make describe` ausführen]). Jedoch schlagen auch trivialere Befehle wie `make maintainer` in diesem Fall fehl. Dies ist nicht akzeptabel!
 
 [[dot-error-breaks-index]]
 .Wie vermeidet man die Verwendung von `.error`
diff --git a/documentation/content/de/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/de/books/porters-handbook/porting-samplem/_index.adoc
similarity index 100%
rename from documentation/content/de/books/porters-handbook/porting-samplem/chapter.adoc
rename to documentation/content/de/books/porters-handbook/porting-samplem/_index.adoc
diff --git a/documentation/content/de/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/de/books/porters-handbook/quick-porting/_index.adoc
similarity index 100%
rename from documentation/content/de/books/porters-handbook/quick-porting/chapter.adoc
rename to documentation/content/de/books/porters-handbook/quick-porting/_index.adoc
diff --git a/documentation/content/de/books/porters-handbook/security/chapter.adoc b/documentation/content/de/books/porters-handbook/security/_index.adoc
similarity index 100%
rename from documentation/content/de/books/porters-handbook/security/chapter.adoc
rename to documentation/content/de/books/porters-handbook/security/_index.adoc
diff --git a/documentation/content/de/books/porters-handbook/slow/chapter.adoc b/documentation/content/de/books/porters-handbook/slow/_index.adoc
similarity index 100%
rename from documentation/content/de/books/porters-handbook/slow/chapter.adoc
rename to documentation/content/de/books/porters-handbook/slow/_index.adoc
diff --git a/documentation/content/de/books/porters-handbook/special/chapter.adoc b/documentation/content/de/books/porters-handbook/special/_index.adoc
similarity index 99%
rename from documentation/content/de/books/porters-handbook/special/chapter.adoc
rename to documentation/content/de/books/porters-handbook/special/_index.adoc
index 36a48ca28a..8af1f93de0 100644
--- a/documentation/content/de/books/porters-handbook/special/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/special/_index.adoc
@@ -967,7 +967,7 @@ Zusätzlich sind die folgenden Konstanten definiert, damit alle Java-Ports auf e
 |Das Verzeichnis, in dem JAR-Dateien, die von anderen Ports installiert wurden, liegen. Standardmäßig [.filename]#${LOCALBASE}/shared/java/classes#.
 |===
 
-Die entsprechenden Einträge sind sowohl in `PLIST_SUB` (dokumentiert in <<plist-sub>>) als auch in `SUB_LIST` definiert.
+Die entsprechenden Einträge sind sowohl in `PLIST_SUB` (dokumentiert in crossref:plist[plist-sub,Änderungen an pkg-plist mit Hilfe von make-Variablen]) als auch in `SUB_LIST` definiert.
 
 [[java-building-with-ant]]
 === Kompilieren mit Ant
@@ -988,7 +988,7 @@ Beim Portieren einer Java-Applikation installiert der Port normalerweise alles u
 
 Unabhängig von der Art Ihres Ports (Bibliothek oder Applikation), sollte die zusätzliche Dokumentation an die <<install-documentation,gleiche Stelle>> installiert werden wie bei jedem anderen Port auch. Das JavaDoc-Werkzeug ist dafür bekannt einen unterschiedlichen Satz von Dateien abhängig von der Version des benutzten JDKs zu erstellen. Für Ports, die nicht die Benutzung eines bestimmten JDKs vorgeben, ist es deshalb eine komplexe Aufgabe die Packliste ([.filename]#pkg-plist#) festzulegen. Dies ist ein Grund, warum dringend angeraten wird, das `PORTDOCS`-Makro zu benutzen. Außerdem, selbst wenn Sie den Satz von Dateien, den `javadoc` erzeugen wird, voraussagen können, die Größe der resultierenden [.filename]#pkg-plist# befürwortet die Benutzung von `PORTDOCS`.
 
-Der Vorgabewert für `DATADIR` ist [.filename]#${PREFIX}/shared/${PORTNAME}#. Es ist eine gute Idee, `DATADIR` für Java-Ports stattdessen auf [.filename]#${JAVASHAREDIR}/${PORTNAME}# zu setzen. In der Tat wird `DATADIR` automatisch zu `PLIST_SUB` (dokumentiert in <<plist-sub>>) hinzugefügt, d.h. Sie können `%%DATADIR%%` direkt in [.filename]#pkg-plist# benutzen.
+Der Vorgabewert für `DATADIR` ist [.filename]#${PREFIX}/shared/${PORTNAME}#. Es ist eine gute Idee, `DATADIR` für Java-Ports stattdessen auf [.filename]#${JAVASHAREDIR}/${PORTNAME}# zu setzen. In der Tat wird `DATADIR` automatisch zu `PLIST_SUB` (dokumentiert in crossref:plist[plist-sub,Änderungen an pkg-plist mit Hilfe von make-Variablen]) hinzugefügt, d.h. Sie können `%%DATADIR%%` direkt in [.filename]#pkg-plist# benutzen.
 
 Zu der Frage, ob Java-Ports aus dem Quelltext gebaut werden, oder direkt bereitgestellte binäre Distributionen benutzt werden sollten, gab es, als dies geschrieben wurde, keine definierte Richtlinie. Allerdings ermutigen Mitglieder des http://www.freebsd.org/java/[FreeBSD Java-Projekts] Porter dazu, Ihre Ports aus dem Quelltext kompilieren zu lassen, wann immer dies kein Problem darstellt.
 
@@ -996,7 +996,7 @@ Alle Eigenschaften, die in diesem Abschnitt präsentiert wurden sind in [.filena
 
 Obwohl es eine `java`-Kategorie für Fehlerberichte gibt, bezieht sich diese auf die JDK-Portierungsbemühungen des FreeBSD Java-Projektes. Deshalb sollten Sie Ihren Java-Port in der `ports`-Kategorie einreichen wie bei jeden anderen Port auch - es sei denn, die Angelegenheit, die Sie zu klären versuchen, steht in Zusammenhang entweder mit einer JDK-Implementierung oder [.filename]#bsd.java.mk#.
 
-Gleichermaßen gibt es eine definierte Richtlinie für die `CATEGORIES` eines Java-Ports, die in <<makefile-categories>> erklärt wird.
+Gleichermaßen gibt es eine definierte Richtlinie für die `CATEGORIES` eines Java-Ports, die in crossref:flavors[makefile-categories, Kategorisierung] erklärt wird.
 
 [[using-php]]
 == Webanwendungen, Apache und PHP
diff --git a/documentation/content/de/books/porters-handbook/testing/chapter.adoc b/documentation/content/de/books/porters-handbook/testing/_index.adoc
similarity index 98%
rename from documentation/content/de/books/porters-handbook/testing/chapter.adoc
rename to documentation/content/de/books/porters-handbook/testing/_index.adoc
index c9d3cda064..5213ae7b86 100644
--- a/documentation/content/de/books/porters-handbook/testing/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/testing/_index.adoc
@@ -49,7 +49,7 @@ Einige der FreeBSD-Werkzeuge zur Pflege von Ports, wie zum Beispiel man:portupgr
 
 [NOTE]
 ====
-Es ist wichtig diese Datei erzeugen zu können, unabhängig davon, welche Optionen in [.filename]#make.conf# vorhanden sind. Bitte vermeiden Sie es daher beispielsweise `.error`-Anweisungen zu benutzen, wenn zum Beispiel eine Abhängigkeit nicht erfüllt wird (Lesen Sie dazu bitte <<dads-dot-error>>).
+Es ist wichtig diese Datei erzeugen zu können, unabhängig davon, welche Optionen in [.filename]#make.conf# vorhanden sind. Bitte vermeiden Sie es daher beispielsweise `.error`-Anweisungen zu benutzen, wenn zum Beispiel eine Abhängigkeit nicht erfüllt wird (Lesen Sie dazu bitte crossref:porting-dads[dads-dot-error,Vermeiden Sie den Gebrauch des `.error`-Konstruktes]).
 ====
 
 Wenn `make describe` eine Zeichenkette anstatt einer Fehlermeldung erzeugt, sind Sie wahrscheinlich auf der sicheren Seite. Vergleichen Sie die erzeugte Zeichenkette mit [.filename]#bsd.port.mk#, um mehr über deren Bedeutung zu erfahren.
diff --git a/documentation/content/de/books/porters-handbook/why-port/chapter.adoc b/documentation/content/de/books/porters-handbook/why-port/_index.adoc
similarity index 100%
rename from documentation/content/de/books/porters-handbook/why-port/chapter.adoc
rename to documentation/content/de/books/porters-handbook/why-port/_index.adoc