Il sito che stai visitando è realizzato con Jekyll ed ospitato dalle pagine di GitHub(GitHub Pages).
Figo?
Figo!
Lo vogliamo anche noi!
Bene, di seguito vi spiegherò come farlo.
Requisiti:
- Sistema Linux(non strettamente necessario ma vi semplifica la vita)
- Ruby
- Git
- Un account GitHub
- Una ventina di minuti
1. Crea un nuovo Repository
Collegati a https://github.com e crea un nuovo repository con nome uguale al tuo username, esempio: USERNAME.github.com . Nel mio caso thetom88.github.com.
In seguito per convenzione userò il mio username (thetom88), sostituitelo con il vostro!
2. Crea un repository locale e collegalo al repository remoto
Crea una cartella dove inserirai il progetto, crea il repository locale e collegalo al repository remoto:
mkdir CARTELLA_DEL_PROGETTO cd CARTELLA_DEL_PROGETTO git init git remote add origin https://github.com/thetom88/thetom88.git
3. Installa Jekyll ed il plugin GitHub Pages
Occorre innanzitutto installare il gem di Jeckyll e quello di GitHub Pages. Per farlo ci conviene sfruttare il gemfile per poi ricreare l’ambiente in caso di necessità in un secondo momento.
Create quindi nella vostra directory del progetto un file di nome .Gemfile e copiate il successivo contenuto al suo interno:
source 'https://rubygems.org' gem 'jekyll' gem 'github-pages'
A questo punto installate il tutto con il comando bundle install
4. Crea il tuo sito con Jekyll
Niente di più facile, basta lanciare il comando jekyll new ./ che si occuperà di creare tutto il necessario.
Per visualizzare il tuo sito, Jekyll mette a disposizione un piccolo server locale, ti basterà lanciare il comando jekyll serve e collegarti con un browser alla pagina indicata.
L’altra grande comodità che ci fornisce jekyll con il comando serve è il watching dei files. Cosa vuol dire? Che Jekyll controllerà tutti i files nel progetto e si occuperà di ricreare il website così che tu debba solo fare un refresh della pagina ogni volta che farai una modifica. Spettacolo!
Per fermare tutte queste fantasticherie ti basterà premere ctrl + c
5. Pubblica il sito sulla tua pagina di GitHub
Molto molto semplice, innanzitutto devi aggiungere i files del progetto appena creato al repository:
git add .
Poi devi creare un nuovo commit:
git commit -am "Il mio primo commit sulla mia GitHub Page!"
Ed infine devi caricare il tutto:
git push origin master
Ora ti verrà chiesto il tuo username e la tua password. Fatto questo potrai andare finalmente a vedere la tua GitHub Page!