add anchors and titles to source blocks

Author: nikbucher

de/04_02.adoc

@@ -8,6 +8,8 @@ Es wird empfohlen, das Beispiel-Datenmodell nur grob zu überfliegen und dann Ka
 [#_4_2_1]
 ==== Ahland.ili – Das nationale Grundlagenmodell
 
+[#listing-04_02-001]
+.link:#listing-04_02-001[Listing 04.02-001]
 [source]
 ----
 !! Das nachfolgende Modell ist in der Version 2.3 von INTERLIS geschrieben.
@@ -92,6 +94,8 @@ END Ahland.
 
 Das Modell für Gebäudeadressen wird nicht abgedruckt, denn es würde mehrere Seiten umfassen und ist im Zusammenhang des Ilistals nicht im Detail von Interesse. Das Ilistaler Tourismus-Modell etabliert jedoch eine Beziehung zwischen Gasthäusern und den im Adressmodell definierten Hauseingängen.
 
+[#listing-04_02-002]
+.link:#listing-04_02-002[Listing 04.02-002]
 [source]
 ----
 INTERLIS 2.3;
@@ -114,6 +118,8 @@ END Adressen.
 [#_4_2_3]
 ==== NatTour.ili – Das Modell des Nationalen Tourismus-Verbands
 
+[#listing-04_02-003]
+.link:#listing-04_02-003[Listing 04.02-003]
 [source]
 ----
 INTERLIS 2.3;
@@ -293,6 +299,8 @@ END NatTour.
 [#_4_2_4]
 ==== IlisTour.ili – Das Ilistaler Tourismus-Modell
 
+[#listing-04_02-004]
+.link:#listing-04_02-004[Listing 04.02-004]
 [source]
 ----
 INTERLIS 2.3;

de/04_03.adoc

@@ -8,6 +8,8 @@ Drei Punkte (...) zeigen die Auslassungen an; die Kästchen rechts sind lediglic
 .Die Bergbahnen auf das Ilishorn sind ein Teil der Daten, die in einer Transferdatei enthalten sind (Wiederholung von Abbildung 11). Die nachfolgende Datei enthält einige Daten für den Ponylift Ilisdorf.
 image::img/image11.png[]
 
+[#listing-04_03-001]
+.link:#listing-04_03-001[Listing 04.03-001]
 [source,xml]
 ----
 <?xml version="1.0" encoding="utf-8"?>

de/05_01.adoc

@@ -32,6 +32,8 @@ image::img/image25.png[]
 
 Einen Hinweis darauf, ob sich das Unterteilen in spezielle Klassen lohnt, geben die jeweili­gen Eigenschaften. So hat jede Bahn einen Namen, aber nur Bergbahnen besitzen eine Tal- und eine Bergstation.
 
+[#listing-05_01-001]
+.link:#listing-05_01-001[Listing 05.01-001]
 [source]
 ----
 CLASS Bahn =

de/05_02.adoc

@@ -5,6 +5,8 @@ Hundert Zeichen für den Namen einer Bahn mag im allgemeinen Fall ja angemessen
 
 Aber eine Tramlinie mit hundert Buchstaben? Hier reichen fünf Zeichen definitiv aus.
 
+[#listing-05_02-001]
+.link:#listing-05_02-001[Listing 05.02-001]
 [source]
 ----
 CLASS Bahn =

de/05_03.adoc

@@ -8,6 +8,8 @@ Soll es von einer Klasse keine konkreten Objekte geben können, wird sie als *ab
 
 Häufig sind in einem Datenmodell sogar alle Oberklassen abstrakt und nur die untersten, speziellsten Klassen konkret.
 
+[#listing-05_03-001]
+.link:#listing-05_03-001[Listing 05.03-001]
 [source]
 ----
 CLASS Bahn (ABSTRACT) =

de/05_04.adoc

@@ -3,6 +3,8 @@
 
 Angenommen, ein internationaler Verband möchte sicherstellen, dass Billette mit ihren Preisen erfasst werden. Er will aber keine bestimmte Währung für die Preisangabe vor­schreiben, und entsprechend ist auch nicht klar, was eine sinnvolle Obergrenze für den Preis wäre. Fest steht andererseits, dass «Preis» eine Zahl sein soll, und dass es sich um Geld handelt. Schliesslich werden Preise nicht in Kilometern pro Stunde gemessen!
 
+[#listing-05_04-001]
+.link:#listing-05_04-001[Listing 05.04-001]
 [source]
 ----
 CLASS BillettartWeltweit (ABSTRACT) =

de/06_01.adoc

@@ -12,6 +12,8 @@ Bei der Modellierung auf konzeptueller Stufe möchte man sich aber eigentlich ni
 
 Da sich die Preise zwischen 10 und 635 Talern bewegen, könnte man also schreiben:
 
+[#listing-06_01-001]
+.link:#listing-06_01-001[Listing 06.01-001]
 [source]
 ----
 Preis: 10 .. 635;
@@ -21,6 +23,8 @@ Damit würde man aber auch festlegen, dass ein Preis nie kleiner als 10 Taler un
 
 Dabei ist es natürlich auch wichtig zu überlegen, wie viele Nachkommastellen nötig sind. Wenn die Preise auch Groschen aufweisen können, werden die Schranken eben mit jeweils zwei Nachkommastellen festgelegt. Bei einem Attribut, das z.B. ein Investitionsbudget dar­stellt, möchte man sich nur mit Millionen abgeben; wo es nur um Grössenordnungen geht, reichen zwei Ziffern. Diese können sich aber auf Tausend, eine Million oder gar eine Milliarde beziehen.
 
+[#listing-06_01-002]
+.link:#listing-06_01-002[Listing 06.01-002]
 [source]
 ----
 Preis: 0.00 .. 9999.99;
@@ -35,6 +39,8 @@ Die Anzahl der Stellen bezeichnet die Genauigkeit: «4.3 Millionen» (4.3E6 = 4.
 
 Sind das jetzt Taler, Franken, Euro oder Dollar? Die Einheit ist – nicht nur beim Geld – von entscheidender Bedeutung. Darum ist es empfehlenswert, die Einheit nicht nur als Kommentar oder als Teil des Attributnamens anzugeben, sondern als Bestandteil des Typs:
 
+[#listing-06_01-003]
+.link:#listing-06_01-003[Listing 06.01-003]
 [source]
 ----
 UNIT
@@ -55,6 +61,8 @@ Im Interesse der Klarheit wird empfohlen, immer Einheiten anzugeben. Das INTERLI
 
 Da die Ilishornbahnen nie Billette abgeben werden, die mehr als tausend Taler kosten, könnte man auf die Idee kommen, dies in einer eigenen Klasse zu definieren:
 
+[#listing-06_01-004]
+.link:#listing-06_01-004[Listing 06.01-004]
 [source]
 ----
 CLASS Billettart (EXTENDED) =
@@ -70,6 +78,8 @@ Eine Preisangabe 0 .. 1000 ist also eine zulässige Einschränkung des national
 
 Die Ilistaler wollen auch die Möglichkeit haben, Billette auszugeben, deren Preis nicht zwin­gend ein voller Talerbetrag ist. Man möchte folgende Definition schreiben:
 
+[#listing-06_01-005]
+.link:#listing-06_01-005[Listing 06.01-005]
 [source]
 ----
 CLASS Billettart (EXTENDED) =
@@ -90,20 +100,26 @@ Und noch etwas: Die Einheiten der Erweiterung müssen immer mit derjenigen der B
 
 Kann der nationale Verband festlegen, welcher Preis für ein Billett zulässig ist? Sind die Schranken noch völlig unbekannt, kann – im Rahmen abstrakter Attribute – auf ihre An­gabe verzichtet werden. Es ist aber möglich, dennoch bereits eine Einheit festzulegen.
 
+[#listing-06_01-006]
+.link:#listing-06_01-006[Listing 06.01-006]
 [source]
 ----
 Preis (ABSTRACT): NUMERIC [Ahland.Taler];
 ----
 
 Vielleicht ist sogar die Einheit noch unklar. Man weiss erst, dass es sich z.B. um eine Währung handelt.
 
+[#listing-06_01-007]
+.link:#listing-06_01-007[Listing 06.01-007]
 [source]
 ----
 Preis (ABSTRACT): NUMERIC [MONEY];
 ----
 
 Damit ist immerhin der Charakter der Einheit festgelegt. In einer Erweiterung können damit nur noch Einheiten definiert werden, die Konkretisierungen der abstrakten Einheit MONEY sind (zu abstrakten Eigenschaften siehe auch Abschnitt <<_5_4>>).
 
+[#listing-06_01-008]
+.link:#listing-06_01-008[Listing 06.01-008]
 [source]
 ----
 Preis (EXTENDED): 0 .. 10000 [CHF]; !! erlaubt

de/06_02.adoc

@@ -3,6 +3,8 @@
 
 Für eine grobe Übersicht genügt es, die Bergbahnen grob einzuteilen: Zahnradbahn, Standseilbahn, Luftseilbahn, Skilift, Sessellift, Gondelbahn. Im einfachsten Fall wird die Art als Textattribut festgehalten.
 
+[#listing-06_02-001]
+.link:#listing-06_02-001[Listing 06.02-001]
 [source]
 ----
 CLASS Bergbahn =
@@ -13,6 +15,8 @@ END Bergbahn;
 
 Als Folge ist die Person, welche die Daten erfasst, in der Beschreibung sehr frei. Seilbahn, Schwebebahn, Skilift, Ski-Lift – es ist zu befürchten, dass ein rechter Wildwuchs an Be­zeichnungen entsteht. Vermeiden lässt sich dies mit einer Aufzählung.
 
+[#listing-06_02-002]
+.link:#listing-06_02-002[Listing 06.02-002]
 [source]
 ----
 CLASS Bergbahn =
@@ -38,6 +42,8 @@ Es gibt aber keine Bergbahnen, die ausschliesslich Bergbahn sind und nicht gleic
 
 In der textuellen Schreibweise von INTERLIS 2 werden abstrakte Klassen mit der Angabe (ABSTRACT) in Klammern bezeichnet. Nur nebenbei: Das INTERLIS-Einheitenmodell «Units» kennt eine Einheit «CountedObjects» für abgezählte Objekte wie zum Beispiel die Zahl der Personen in einer Luftseilbahnkabine.
 
+[#listing-06_02-003]
+.link:#listing-06_02-003[Listing 06.02-003]
 [source]
 ----
 CLASS Bergbahn (ABSTRACT) =

de/06_03.adoc

@@ -6,6 +6,8 @@
 
 Um den Schwierigkeitsgrad von Skipisten grob zu beschreiben, wurden drei Farben gewählt: blau, rot, schwarz. Es soll nur diese und keine anderen Schwierigkeitsgrade geben. Zudem sind sie geordnet. Blau bezeichnet eine einfache Piste, eine rote Piste ist schwieriger als eine blaue, eine schwarze am anspruchsvollsten. Dies wird mit der folgenden Definition be­schrieben:
 
+[#listing-06_03-001]
+.link:#listing-06_03-001[Listing 06.03-001]
 [source]
 ----
 CLASS Piste =
@@ -15,6 +17,8 @@ END Piste;
 
 Würde die FINAL-Angabe fehlen, könnte die Aufzählung in einer Erweiterung noch ergänzt werden. Zum Beispiel könnte dies bei der Art von Bergbahnen Sinn machen:
 
+[#listing-06_03-002]
+.link:#listing-06_03-002[Listing 06.03-002]
 [source]
 ----
 !! Modell des Nationalen Tourismusverbandes
@@ -36,6 +40,8 @@ Jede (horizontale) Erweiterung kann durch weitere Werte ergänzt werden, solange
 
 Für die Basisklasse ist der Wert Schneebus (und allfällige weitere Werte) nur noch als OTHER erkennbar. Wird jedoch FINAL angegeben, kann der Wert OTHER nicht mehr auftreten. Ist eine Aufzählung zyklisch (*CIRCULAR*) definiert, sind solche Ergänzungen nie möglich, heisst doch zyklisch, dass nach dem höchsten Wert wieder der niedrigste kommt und man sonst gar nicht wüsste, welches der höchste ist.
 
+[#listing-06_03-003]
+.link:#listing-06_03-003[Listing 06.03-003]
 [source]
 ----
 Windrichtung: (N, NE, E, SE, S, SW, W, NW) CIRCULAR;
@@ -48,6 +54,8 @@ Man hatte also beschlossen, die verschiedenen Arten von Bergbahnen nicht mit ein
 
 Für jeden Wert einer Aufzählung kann eine Unteraufzählung definiert werden. Dies kann direkt innerhalb der Basisdefinition oder erst in einer Erweiterung erfolgen.
 
+[#listing-06_03-004]
+.link:#listing-06_03-004[Listing 06.03-004]
 [source]
 ----
 CLASS IhBBergbahn EXTENDS Bergbahn =

de/06_04.adoc

@@ -3,6 +3,8 @@
 
 Bezeichnungen können grundsätzlich beliebig lange Namen enthalten. Der nationale Verband hat jedoch festgelegt, dass der Name einer Bergbahn höchstens 100 Zeichen aufweisen darf. In der Regel sind die Namen natürlich durchaus kürzer, man wollte einfach sicher gehen.
 
+[#listing-06_04-001]
+.link:#listing-06_04-001[Listing 06.04-001]
 [source]
 ----
 STRUCTURE Bahnbezeichnung EXTENDS Bezeichnung =
@@ -12,13 +14,17 @@ END Bahnbezeichnung;
 
 Ist die Länge eines Text-Attributes beliebig oder noch vollkommen unbekannt, kann auf die Angabe der Länge verzichtet werden. Ist es klar, dass die Länge im Rahmen einer Klassenerweiterung noch festgelegt wird, wird das Attribut als abstrakt bezeichnet:
 
+[#listing-06_04-002]
+.link:#listing-06_04-002[Listing 06.04-002]
 [source]
 ----
 Beschreibung (ABSTRACT): TEXT;
 ----
 
 Manche Bahnen im Ilistal haben eine Web-Kamera installiert, die laufend die Umgebung der Bergstation aufnimmt. Interessierte Touristen können so sehen, ob sich die Reise lohnt. Die Internet-Adresse des aktuellen Bildes ist ebenfalls eine (etwas besondere) Art von Text.
 
+[#listing-06_04-003]
+.link:#listing-06_04-003[Listing 06.04-003]
 [source]
 ----
 CLASS IhBBergbahn =