Wie kann ich Plugins debuggen, die stillschweigend ignoriert werden?

Question

Newcomer zu Jekyll hier (vorher auf Hyde).

• Ruby-Dateien, die im _plugins/-Verzeichnis abgelegt sind, werden scheinbar stillschweigend ignoriert.
• Ich benutze Version 0.11.2 von Jekyll, mit Ruby 1.8.7 auf Ubuntu 12.04.

Sollte ein zusätzlicher Config-Parameter hinzugefügt werden, um diese Plugins zu laden? Das Dokument sagt das nicht - der normale Standard sollte sein, in _plugins zu suchen, und sie sollten automatisch benötigt werden. Wie kann man das Laden von Jekyll-Plugins debuggen?

Answer 1

Für meine Instanz von Jekyll (auch 0.11.2, aber mit Ruby 1.9.2p290 auf einem Mac), muss ich keine zusätzliche Konfiguration hinzufügen, aber Sie können versuchen, die folgende Zeile zu Ihrer obersten Ebene hinzuzufügen " _config.yml "Datei.

plugins:  _plugins 

oder möglicherweise

plugins:  ./_plugins 

---

Die einfachste Art und Weise zu testen, ob Ihre Plugins arbeiten, ist, sie alle zu entfernen mit einer Ausnahme, die Sie arbeiten, wissen. Ich habe folgendes zusammengestellt, was bei meiner Installation wie erwartet funktioniert.

1. Erstellen Sie eine neue Datei in das Stammverzeichnis Ihrer jekyll Quellverzeichnis „plugin_test.md“ mit folgenden Inhalten genannt:

   --- 
   layout: default 
   title: Plugin Test 
   --- 
   
   the quick brown fox jumps over the lazy dog. 
   
   Testing plugin output of '_plugins/testplugin.rb': {% testplugin %} 
   

   Beachten Sie, dass Sie sich ändern müssen: auf „Layout default“ was auch immer du tatsächlich benutzt.

2. Erstellen Sie eine neue Datei auf "_plugins/testplugin.rb" mit folgendem Inhalt:

   module Jekyll 
       class TestPlugin < Liquid::Tag 
       def render(context) 
        "It's Working!" 
       end 
       end 
   end 
   
   Liquid::Template.register_tag('testplugin', Jekyll::TestPlugin) 
   

3. Run jekyll auf Ihrer Quelle Richt.

Alles, was testplugin.rb tut, ist Instanzen des flüssigen Tag ersetzen {% testplugin %} mit dem Text „Es funktioniert!“. Wenn Ihre Plugins auslösen, werden Sie den Ausgang

Testing plugin output of '_plugins/testplugin.rb': It's Working!" 

auf der Seite „plugin_test.html“ an Ihrer Ausgabe Site-Stamm sehen. Wenn Sie sehen:

Testing plugin output of '_plugins/testplugin.rb': 

bedeutet dies, dass das Plugin nicht ausgelöst hat. Wenn Sie darauf stoßen, denke ich, dass es ein Zeichen dafür ist, dass etwas nicht in Ordnung ist und würde die Neuinstallation von Jekyll empfehlen.

Answer 2

Ich weiß, ich bin etwas spät dran, aber für andere, die immer noch auf diese Frage stoßen, möchte ich meine Auflösung hinzufügen: Starten Sie den Server neu, um das neu hinzugefügte Plugin zu erhalten. Stoppen Sie also jekyll serve (Strg C) und starten Sie es erneut mit jekyll serve.