menu

Jekyll

Jekyll è un generatore di siti Web statici che utilizza file in formato Markdown come base.

Panoramica

Conosci Ruby? Quindi, quello era il linguaggio di programmazione scelto per sviluppare Jekyll.

Il programma è gratuito e open source.

Tra le migliaia di siti che utilizzano Jekyll per convertire i file Markdown in HTML, uno di questi è degno di nota, le GitHub Pages.

GitHub Pages utilizza Jekyll come strumento principale per convertire i file Markdown in HTML sul suo servizio di hosting di siti Web gratuito.

Il processore Markdown utilizzato dall'applicazione è kramdown.

Jekyll carica kramdown con le impostazioni predefinite, ma puoi modificarle come mostrato nell'esempio seguente.

kramdown:
syntax_highlighter: rouge
input: GFM
auto_ids: true
toc_levels: 1..3

Il file di configurazione si chiama _config.yml, puoi fare clic qui per saperne di più sulle impostazioni di Jekyll.

Sito ufficiale: https://jekyllrb.com/

Supporto di Markdown su Jekyll

La Tabella 1.1 presenta gli elementi Markdown compatibili con Jekyll.

Elemento Supporto Informazione
Titoli
Paragrafi
Interruzioni di riga
Grassetto
Corsivo
Blockquote
Elenchi ordinati
Elenchi non ordinati
Codice
Linee orizzontali
Links
immagini
Tabelle
Blocchi di codice recintati Inserisci l'opzione syntax_highlighter: rouge nella sezione kramdown del file _config.yml per abilitare l'evidenziazione della lingua all'interno del blocco.
Note a piè di pagina
ID titolo
Elenchi di definizioni
Barrato Per cancellare una parola in Jekyll usa le tessere ~~ parola ~~ o solo una tessera ~ parola ~ attorno al contenuto. Entrambe le sintassi funzionano.
Elenchi di attività
Emoji (copia e incolla)
Emoji (codici di accesso) No Jekyll non fornisce supporto per impostazione predefinita, ma puoi aggiungere plugin jemoji.
automatico URL Link
Disabilita URL link automatico
HTML

Supporto per elementi di sintassi aggiuntivi

In Table 1.2 puoi vedere elementi più oscuri supportati da Jekyll.

Elemento Markdown Uscita
Abbreviazione *[HTML]: Hyper Text Markup Language
La specifica di HTML è mantenuta dal W3C.
La specifica di HTML è mantenuta dal W3C

Vedi anche

Opzioni di configurazione di Markdown su Jekyll

Documentazione kramdown