getherbie/plugin-gist

Gist Plugin for Herbie.

Herbie Gist Plugin

Gist ist ein Herbie Plugin, mit dem du Gist-Schnipsel von Github in deine Website einbettest., _(*1)

Installation

Das Plugin installierst du via Composer., _(*2)

$ composer require getherbie/plugin-gist

Danach aktivierst du das Plugin in der Konfigurationsdatei., _(*3)

plugins:
    enable:
        - gist

Konfiguration

Unter plugins.config.gist stehen dir die folgenden Optionen zur Verfügung:, _(*4)

# 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., _(*5)

[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:, _(*6)

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

Mit dem Aktivieren der Twig-Funktion kannst du Gist-Schnipsel auch in Layoutdateien einsetzen:, _(*7)

{{ gist id="123456789" }}    

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

Parameter

Demo

https://herbie.tebe.ch/dokumentation/plugins/gist, _(*8)