Ein Buch schreiben/Ein Buch-erstellen

Aus Handbuch.io

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. 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
}}  


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_2|Kapitel 2]]

</div>


Aufbau eines Eintrags im Inhaltsverzeichnis.

Dadurch, dass eine Zeile im Inhaltsverzeichnis mit * beginnt, handelt es sich um einen Listeneintrag. 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.

Das Layout anpassen

Es ist möglich, das Layout zu einem Buch anzupassen. Hierfür muss allerdings duch die IT ein Ordner, der so heißt wie das Buch, in den Ordner /w/skins/Booksprint_skin/customize auf den Server gelegt werden.

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;
        }
}