Download

• zen_forkawesome.zip (733 kB)

Text

• Webseite
• API Reference
• Documentation (PDF), ~4.5 MB
• Create a package for Android
• Kivy with Python tutorial

Videos

Empfehlenswert sind auch die folgenden Videoreihen:

Kettle...was?

Genau. Okay, du weißt nicht, was Kettlebattle ist, kein Problem. Die Menschen, die diesem Unsinn nachgehen, dürften sich zahlenmäßig aktuell im einstelligen Bereich bewegen (Stand: Januar 2018).

Kettlebattle ist ein kollaboratives Kettlebell-Home-Workout ab zwei Mitspielern.

Die Frontlinie der "Battle" verläuft dabei nicht zwischen den Mitspielern, sondern zwischen Motivation, Schweinehund, Sofa und Hanteln. Team up!

Spielregeln

1. Die Kontaktaufnahme

   Der potentielle Mitspieler wird mit "Kettlebattle?" kontaktiert.

2. Der Workout-Vorschlag

   Hat der Mitspieler die Kontaktaufnahme positiv beantwortet, schlägt der Initiator ein Workout vor, das der Mitspieler akzeptieren muss. Fairness geht vor. Wer nach einem langen Tag mitten in der Nacht seinem Mitspieler ein hartes Workout vorschlägt, hat schnell keine Mitspieler mehr.

3. Do you even lift?

   Do it.

4. Das Finisher-Selfie

   Der krönende Abschluss jeder Kettlebattle ist das Finisher-Foto, das man dem Mitspieler nach dem Workout als Beweis seiner Sportlichkeit zuschickt. Hierbei ist absolute Ernsthaftigkeit zu wahren, es geht hier schließlich um Kettlebattle!

Der Generator

Der Kettlebattle-Generator ist eine Einseiten-Web-App, mit der sich aus einem zuvor definierten Übungspool ein Workout generieren lässt.

Verweise

• Kettlebell-Image: openclipart.org
• Layout: An Introduction to Python’s Flask Framework
• Kettlebattle ist eine Erfindung von ZeEvilKohl und encarsia (yours truly)
• GitHub-Repository

Pläne für später?

• Export in Textbildchen (leben wir nicht in tollen Zeiten?)
• Favoritenliste/Liste der letzten Kettlebattles
• Lokalisation

Zugegeben, darauf hat die Welt nicht gerade gewartet. Aber nun ist es irgendwie trotzdem da. Willkommen!

Glade

Python

GObject.type_register(GtkSource.View)

self.buffer = self.view.get_buffer()

self.sourcefile = GtkSource.File()
self.lang_manager = GtkSource.LanguageManager()

sourcefile.set_location(Gio.File.new_for_path("file"))
buffer.set_language(self.lang_manager.get_language("language"))
loader = GtkSource.FileLoader.new(buffer, sourcefile)
loader.load_async(0, None, None, None, None, None)

#bestehende Datei überschreiben
saver = GtkSource.FileSaver.new(buffer, sourcefile)
#Datei unter anderem Namen speichern
saver = GtkSource.FileSaver.new_with_target(buffer, sourcefile, targetfile)
#Speichern ausführen
saver.save_async(0, None, None, None, None, None)

settings = GtkSource.SearchSettings()
search_context = GtkSource.SearchContext.new(buffer, settings)

builder.get_object("search_entry").bind_property('text', settings, 'search-text')

def find_text(self, start_offset=1):
    buf = self.buffer
    insert = buf.get_iter_at_mark(buf.get_insert())
    start, end = buf.get_bounds()
    insert.forward_chars(start_offset)
    match, start_iter, end_iter, wrapped = self.search_context.forward2(insert)

    if match:
        buf.place_cursor(start_iter)
        buf.move_mark(buf.get_selection_bound(), end_iter)
        self.view.scroll_to_mark(buf.get_insert(), 0.25, True, 0.5, 0.5)
        return True
    else:
        buf.place_cursor(buf.get_iter_at_mark(buf.get_insert()))

StyleChooser

Das Widget zeigt die verfügbaren Stile an. Es ist nicht möglich, lokale Stile anzugeben oder sie zu verändern.

Der angewählte Style lässt sich dann einfach auf den gewünschten Buffer anwenden:

def on_signal_emitted(self, widget, event):
    buffer.set_style_scheme(widget.get_style_scheme())

Links

• GtkSourceView
• GtkSourceView 3 Reference Manual
• GtkSourceView style schemes
• Text Widget Overview
• Multiline Text Editor-Tutorial
• meld, Repository auf GitHub

Weiterlesen…

Vorüberlegungen

Die GitHub-Page läuft mit dem statischen Seitengenerator Nikola, die standardmäßig reStructuredText-Quelldateien parst. Da kommt ein Dokumentationstool, das diese ebenso verarbeiten kann und die Ausgabe in verschiedene Formate ermöglicht, absolut gelegen. All das bietet Sphinx.

Die naheliegende, sich aber möglicherweise als naiv herausstellende, Überlegung war nun, die bestehenden Blogartikelquelldateien so vorzubereiten, dass sich mit wenig Aufwand gewünschte Ausgabeformate immer wieder neu generieren lassen.

Sphinx bietet Builder für

• EPUB, dem offenen E-Book-Standard, nativ von allen E-Reader-Fabrikaten außer den Kindles unterstützt
• PDF, das per LaTeX (verschiedene Engines verfügbar) erzeugt wird

Sphinx

$ sphinx-quickstart

$ make epub
$ make latexpdf

#HTML-Dateien vor dem Inhalt der index.rst einfügen
epub_pre_files = [('info.xhtml', 'Info')]
html_additional_pages = {'info': 'info.html'}

#Titel erzeugen
epub_cover = ('_static/cover.png', 'epub-cover.html')

#Stichwortverzeichnis auslassen
epub_use_index = False

#Bezeichnung der Ausgabedatei
epub_basename = output_basename

#für die Generierung der info.xhtml benötigt, da sonst None
html_last_updated_fmt = '%d. %B %Y'

#Papierformat (Standard ist US-Letter), leere Seiten vermeiden
latex_elements = {
    'papersize': 'a4paper',
    'classoptions': 'oneside,openany'
}

#Logo auf der Titelseite
latex_logo = '_static/logo.png'

pygments_style = 'borland'
output_basename = 'gladepytutorial'

.. toctree::
    :maxdepth: 1
    :numbered:
    :caption: Inhalt

    teildokument1
    teildokument2
    ...

.. only:: latex

    .. include:: info.rst

Bonus: Mobi

"Ich habe doch einen Kindle und hätte auch gern so ein E-Book!"

Aber klar doch.

$ kindlegen input.epub

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />

<meta charset="utf-8" />

.. meta::
    :http-equiv=Content-Type: text/html; charset=UTF-8

Nikola

Das Resultat des ersten Durchlaufs von Sphinx mit der Übersichtsseite und drei Artikeln lässt vorsichtig optimistisch werden. Trotzdem gibt es an diversen Stellen Optimierungsbedarf:

1. Die Nikola-eigenen Kurzverweise (slug) funktionieren nicht und erfordern eine Konvertierung in ":ref:"erenz.

2. Die Artikelüberschrift ist kein Gliederungselement und fehlt demzufolge im Inhaltsverzeichnis

3. Nikola-eigene Directives verursachen Fehler. Konvertierung von

   • thumbnail -> image
   • listings -> literalinclude

4. relative Pfade in image-Directives anpassen

5. Animierte GIFs ignorieren (erzeugen Fehler im LaTeX-Durchlauf, aber nicht im Epub)

6. Inhaltsverzeichnisse in den Artikel überflüssig

7. "Kommentieren auf G+"-Button entfernen

8. Für die Generierung der Mobi-Datei muss jede Datei eine Meta-Anweisung erhalten

Für eine zufriedenstellende Ausgabe ist es also erforderlich, die Ausgangsdateien hinsichtlich dieser Punkte per Skript zu modifizieren.

Automatisierung

Das ist er, der Elefant im Raum.

Sphinx läuft und die index.rst ist eingerichtet. Die Mission besteht nun aus folgenden Teilaufgaben:

1. Sphinx soll sich der aktuellen Dateien der GitHub-Page bedienen.
2. Diese Dateien sollen gemäß der oben genannten Punkte bearbeitet werden.
3. Sphinx soll ein Epub und ein PDF erzeugen.
4. KindleGen soll ein Mobi erzeugen.
5. Die Dateien sollen im entsprechenden Ordner im GitHub Page-Verzeichnis abgelegt und deployt werden.

Let's do this.

Die diffizile Arbeit ist bereits erledigt: die Einrichtung von Sphinx und die Problemerfassung. Das Skript selbst arbeitet nun die oben genannten Punkte ab. Weiterhin gibt es der Übersichtlichkeit halber zwei weitere Dateien. Es befinden sich nun im Sphinx-Projektverzeichnis folgende neue Dateien:

1. nibook.py: sammelt, kopiert, bearbeitet die Quelldateien, erstellt die E-Books und füttert die GitHub-Page (Code)

2. index.lst: Liste von Dateinamen (ohne Endung), die im Dokument enthalten sein sollen

übersicht
artikel1
artikel2
artikel5

3. index.tmpl: aus dieser und der index.lst wird die index.rst generiert

.. generated by nibook, posts will be inserted after ".. include-start"

.. some text documentation master file, created by
   sphinx-quickstart on Thu Oct 26 20:26:54 2017.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

.. meta::
   :http-equiv=Content-Type: text/html; charset=UTF-8

.. only:: latex

    .. include:: info.rst

****************************
Glade-Tutorial mit PyGObject
****************************

.. toctree::
    :maxdepth: 1
    :numbered:
    :caption: Inhalt
    :name: mastertoc

    .. include-start

Fazit

Wieder was gelernt.

Download