Ein Buch schreiben/Ein Buch erstellen

Aus Handbuch.io

doi:10.5072/hbio/GAC1G

Aufbau eines Buches

Technisch besteht ein Buch aus einer Startseite, auf der sich mindestens einige Angaben zum Buch und ein Inhaltsverzeichnis befinden müssen. Alle Seiten, die in diesem Inhaltsverzeichnis stehen gehören zum Buch (und die Buchstartseite selber). Der Titel der Startseite muss der Titel des Buches sein. Die Startseite muss in der Katerogie Buch sein. Soll das Buch (noch) nicht auf der Startseite von handbuch.io aufgelistet werden, kann zusätzlich die Kategorie Versteckt hinzugefügt werden. Eventuell muss die Startseite einmal neu gespeichert werden. Die Startseite eines Buches läßt sich mit der "Spezialseite" Buch erstellen erstellen. Alternativ lassen die notwendigen Angaben auch beim normalen Bearbeiten der Seite hinzugefügt werden.

Angaben zum Buch

werden mittels eines Mediawiki-Templates namens "Bookinfo" umgesetzt. In der Bearbeiten-Ansicht reicht ein Klick auf den Info-Bereich, dann lassen sich die Angaben bearbeiten
"Bookinfo" bearbeiten

In der "Quelltext bearbeiten"-Ansicht sehen die Angaben zum Buch so aus:

{{Bookinfo  
|Autoren=Erika Mustermann, John Doe  
|ABSTRACT=Auf dieses Buch hat die Welt gewartet.  
|TITLE=Testbuch
|STAND=31.08.2016
}}  


Das Inhaltsverzeichnis

Das Inhaltsverzeichnis ist eine sortierte Liste von Links. Damit es als Inhaltsverzeichnis des Buches erkannt wird, muss es sich in einem div der Klasse BookTOC befinden:

== Inhaltsverzeichnis ==

<div class="BookTOC"> 

* [[Testbuch/Kapitel_1|Kapitel 1]] 
** [[Testbuch/Kapitel_1#Unterkapitel|Unterkapitel]] 
* [[Testbuch/Kapitel_2|Kapitel 2]]

</div>


Aufbau eines Eintrags im Inhaltsverzeichnis.

Dadurch, dass eine Zeile im Inhaltsverzeichnis mit einer Raute oder einem Sternchen (*) beginnt, handelt es sich um einen Listeneintrag. Die Anzahl der Rauten oder Sternchen am Anfang der Zeile bestimmt die Einrückungstiefe des Punktes im Inhaltsverzeichnis. Die doppelten eckigen Klammern markieren einen internen Link:

Testbuch/Kapitel_1|Kapitel 1

Das Ziel des Links ist Testbuch/Kapitel_1, der Linktext ist der Teil nach dem |, hier also Kapitel 1.

Unterkapitel

Unterkapitel können wie folgt erstellt werden:

[[Buchtitel/Interner Seitenname#Unterkapitel|Unterkapitelname]]

Das Unterkapitel muss eine Überschrift zweiter Ordnung auf der entsprechenden Seite sein.

Das Layout anpassen

Es ist prinzipiell möglich, das Layout für alle Seiten eines Buches anzupassen. Dies erfordert allerdings auf Webserver an richtiger Stelle ein Ordner mit Namen des Buches.

Folgende Dateien in diesem Ordner werden ausgelesen, wenn vorhanden:

  • book.css - Stylesheet-Anpassungen
  • book.js - Javascript-Anpassungen
  • BookTemplate.php
<?php
class BookTemplate{
    
    /*
    * Wenn diese Function vorhanden ist, wird ein zusätzlicher Bereich in den Hauptbereich eingefügt
    */
        static function getSidebar(){

                global $wgOut;
                return '<div class="float: right">' .
                        $wgOut->parse("[[File:OUR_LOGO.jpg|right]]") .
                        "</div>";
        }

    /*
    * Wenn diese Function vorhanden ist, können die Footer-Icons modifiziert werden 
    */
        static function getFooterIcons($icons){
                $icons['contributors']['vw'] = array(
                        'src' => '/w/skins/Booksprint_skin/customize/Testbuch/ANOTHER_FOOTERICON.jpg',
                        'url' => 'http://...'
                );
                return $icons;
        }
}