Vorwort

Hallo. Dies ist ein minimales funktionierendes Beispiel für alle Features, die unsere bookbuilderpy Tool Suite bietet. bookbuilderpy gibt es als Python-Package auf pypi und als Docker-Image, in dem alle der benötigten Bibliotheken und Werkzeuge enthalten sind. Sie können es als Vorlage verwenden, wenn Sie ein eigenes Buch schreiben wollen.

Als ein Beispiel für eine Literaturreferenz zitiere ich nun mein altes Buch [1]. Diese Referenz wird dann zu einem BibTeX-Eintrag in der Datai bibliography.bib aufgelöst. Jetzt können Sie ruhig Abschnitt 1 lesen.

1 Erstes Kapitel

Wilkommen zum ersten Kapitel.

1.1 Erster Abschnitt des Ersten Kapitels

Mit # fängt eine Kapitelüberschrift an, wie in Abschnitt 1. Mit ## fängt eine Abschnittsüberschrift an, wie in Abschnitt 1.1. ### started einen Unterabschnitt und so weiter und so fort.

Betrachten Sie nun Abbildung 1.1.

Schauen Sie bitte auf die Gleichung Gleichung 1.1. Wir können Formeln auch direkt in den Text einbetten und z.B. schreiben.

Tabelle 1.1 ist auch wichtig. Definitionen können auch eingefügt und aus dem Text heraus referenziert werden. Ein Beispiel dafür ist Definition 1 unten:

def log(message):
    print(f"{datetime.datetime.now()}: {message}")

def log(message: str) -> None:
    """
    Write a message to the log.

    :param str message: the message
    """
    print(f"{datetime.datetime.now()}: {message}")

Kode 1.1 ist ein lokale Kode-Datei, die im selben Ordner wie die markdown-Datei dieses Kapitels liegt. Kode 1.2 kommt direkt von GitHub, von dem Repository bb, welches wir in den Metadaten deklariert haben.

Sie können auch auf die Metadaten des Buches über das Kommando meta zugreifen. Beispiele dafür sind:

1. buchbezogene Metadaten:
   • Titel (title): Buch in Deutsch
   • Autor (author): Thomas Weise
   • Stichworte (keywords): Deutsch, Buch
2. datumsbezogene Metadaten:
   • Datum und Uhrzeit (time): 2022‑11‑01 05:29 UTC
   • Datum (date): 2022‑11‑01
   • Jahr (year): 2022
3. Sprache:
   • lang: de
   • locale: de_DE
   • lang.name: Deutsch
4. Repository-bezogene Metadaten (diese stehen nur zur Verfügung wenn das Buch als git Repository geladen wurde):
   • repo.name: thomasWeise/bookbuilderpy-mwe
   • repo.url: https://github.com/thomasWeise/bookbuilderpy-mwe
   • repo.commit: b24990965fbefa9228db4f26bee1f0e7fe6dd8cd
   • repo.date: 2022‑11‑01 13:27 UTC+08:00
5. externe Repository-Information sind über das Kommando repo mit dem Repository-Schlüssel und der Informationsanfrage zugänglich¹:
   • repo.name für bb: thomasWeise/bookbuilderpy-mwe
   • repo.commit für bb: b24990965fbefa9228db4f26bee1f0e7fe6dd8cd
   • repo.date für bb: 2022‑11‑01 13:27 UTC+08:00

Referenzen