README

Gist ist ein Herbie Plugin, mit dem du Gist-Schnipsel von Github in deine Website einbettest.

Installation

Das Plugin installierst du via Composer.

$ composer require getherbie/plugin-gist

Danach aktivierst du das Plugin in der Konfigurationsdatei.

plugins:
    enable:
        - gist

Konfiguration

Unter plugins.config.gist stehen dir die folgenden Optionen zur Verfügung:

# enable shortcode
shortcode: true

# enable twig function
twig: false

Anwendung

Mit dem Gist-Shortcode kannst du in Seiteninhalten jedes beliebige Gist-Schnipsel einbinden, wobei "123456789" die ID des gewünschten Gist ist.

[gist 123456789]

oder

[gist id="123456789"]    

Möchtest du eine bestimmte Datei innerhalb eines Gist anzeigen, kannst Du dies mit dem optionalen file-Parameter machen:

[gist id="12345" file="filename.md"]

Mit dem Aktivieren der Twig-Funktion kannst du Gist-Schnipsel auch in Layoutdateien einsetzen:

{{ gist id="123456789" }}    

{{ gist id="12345" file="filename.md" }}

Parameter

Demo

https://herbie.tebe.ch/dokumentation/plugins/gist