Come posso eseguire il debug dei plugin che vengono ignorati in modo silenzioso?

Question

Nuovo arrivato a Jekyll qui (precedentemente su Hyde).

• I file ruby ​​inseriti nella directory _plugins/vengono ignorati in modo silenzioso.
• Sto usando la versione 0.11.2 di Jekyll, con ruby ​​1.8.7 su Ubuntu 12.04.

È necessario aggiungere un parametro di configurazione aggiuntivo per caricare questi plug-in? Il documento non lo dice - il default corretto dovrebbe essere quello di cercare in _plugins, e dovrebbero essere richiesti automaticamente. Come si può eseguire il debug del caricamento dei plugin di Jekyll?

Answer 1

Per la mia istanza di jekyll (anche 0.11.2, ma con ruby ​​1.9.2p290 su un Mac), non devo aggiungere alcuna configurazione aggiuntiva, ma puoi provare ad aggiungere la seguente riga al tuo livello principale " _config.yml ".

plugins:  _plugins 

o, eventualmente,

plugins:  ./_plugins 

---

Il modo più semplice per verificare che i tuoi plugin stanno lavorando è quello di rimuovere tutti loro tranne che per una che si sa funzionerà. Ho messo insieme il seguente che funziona come previsto sulla mia installazione.

1. Creare un nuovo file nella root della vostra directory sorgente Jekyll chiamata "plugin_test.md" con il seguente contenuto:

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

   Nota che potrebbe essere necessario cambiare "il layout: di default" a qualunque cosa tu stia effettivamente usando.

2. Creare un nuovo file in "_plugins/testplugin.rb" con il seguente contenuto:

   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 sul tuo dir fonte.

Tutto ciò che fa è testplugin.rb le istanze del tag liquido {% testplugin %} con il testo "E 'di lavoro!". Se i plugin sono innescando, vedrete l'uscita

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

sulla pagina "plugin_test.html" al vostro principale del sito di uscita. Se vedete:

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

significa che il plug-in non si attiva. Se ci si imbatte in questo, penso che sia un segnale che qualcosa è piuttosto fuori questione e consiglierei di reinstallare jekyll.

Answer 2

So che sono un po 'in ritardo ma per gli altri che ancora incontrano questa domanda vorrei aggiungere la mia risoluzione: Riavviare il server per far funzionare il plugin appena aggiunto. Quindi, interrompere jekyll serve (Ctrl C) e riavviarlo di nuovo con jekyll serve.