Usare Jekyll
Comandi vari:
Per avviare un server Jekyll, ripulire i file generati, aggiornare Jekyll e installare i bundle, esegui:
bundle exec jekyll serve
bundle exec jekyll clean
bundle update jekyll
bundle install
- Se il gemfile viene modificato, è necessario eseguire
bundle - Se il file YAML di configurazione viene modificato (per esempio aggiornando il tema), è necessario eseguire
bundle update
Caution
A volte Gemfile.lock vincola l’uso a una versione diversa di Bundler. Verifica:
gem list bundler
tail -n +1 Gemfile.lock | sed -n '/BUNDLED WITH/,$p'
Rimuovere il file risolve il problema.
Important
non eseguire mai e poi mai bundle con sudo
Per aggiornare Bundler a una versione compatibile con la tua versione di Ruby e verificare / disinstallare le vecchie versioni:
sudo gem update --system
sudo gem update bundler
sudo gem install bundler
gem list bundler
sudo gem uninstall bundler -v 2.6.5
A volte è necessario rimuovere completamente Bundler e reinstallarlo:
sudo rm -f /opt/homebrew/bin/bundle /opt/homebrew/bin/bundler
sudo gem uninstall bundler -aIx
Estensioni mancanti
I seguenti messaggi:
Source locally installed gems is ignoring #<Bundler::StubSpecification name=nokogiri version=1.18.3 platform=ruby> because it is missing extensions
Possono essere risolti eseguendo:
gem pristine <module>
bundle install
Stile
- Si usa Minima
- L’ordine delle schede è determinato dal nome del file, quindi puoi anteporre
a_ecc. - Elenco dei font: https://fonts.google.com
- La posizione dei file di Minima può essere individuata con
bundle show minima.
Avvisi:
Aggiungere quanto segue al gruppo jekyll_plugins nel gemfile abilita gli avvisi nei file Markdown:
gem "jekyll-gfm-admonitions"
Gli avvisi possono essere creati così:
> [!NOTE]
> Note text line1
> Note text line2
Gli avvisi disponibili sono:
[!NOTE], [!TIP], [!WARNING], [!CAUTION], [!IMPORTANT]
Aggiungere contenuti
I file nelle directory il cui nome inizia con un trattino basso non vengono elaborati da Jekyll se specificati nel file _config.yml in questo modo:
# this add content to the website from the local dirs starting with _
collections:
pi0:
output: true
Facoltativamente è possibile aggiungere i permalink per la navigazione.
Funzionalità aggiuntive di Markdown
- Link web:
This site was built using [GitHub Pages](https://pages.github.com/). - Link alle sezioni:
See the [Admonitions](#admonitions) section for more details. - Indirizzi email:
You can contact me at [gemc@jlab.org](mailto:gemc@jlab.org)