Getting Started (Windows)

Installare Jekyll su Windows

Queste istruzioni sono state provate su un'installazione di Windows 7 64 bit ma dovrebbero funzionare anche su altre macchine.

Installare Ruby

Clicca sul menu Start e cerca il programma cmd. Digita il comando ruby -vper verificare se Ruby è installato sul tuo computer.

Se non ricevi un output come questo:

ruby 2.3.1p112 (2016-04-26 revision 54768) [x64-mingw32]

Significa che devi installare ruby. Per farlo, vai su RubyInstaller e scarica l'ultima versione compatibile con il tuo sistema operativo. Puoi verificare su Sistema se il tuo computer viagga x32 o x64.

Importante: durante il processo di installazione metti la spunta sulla voce Add Ruby executables to your PATH. Altrimenti potresti incorrere in errori più avanti.

Installare Jekyll

A questo punto non ti resta che lanciare il comando:

gem install jekyll bundler jekyll-seo-tag

E attendere che l'installazione venga completata.

Errori e soluzioni

Ruby/Gem is not recognized...

Se ricevi uno dei seguenti errori:

ruby is not recognized as an internal or external command, operable or batch file gem is not recognized as an internal or external command, operable or batch file

significa che non hai messo la spunta su Add Ruby executables to your PATH durante la fase di installazione. Niente paura! Hai due possibili soluzioni:

1. Reinstallare Ruby
2. Seguire le istruzioni come spiegato qui

Per comodità le riporto di seguito:

Start menu -> Right click on Computer -> Properties -> Advanced system settings (in the left panel) -> Advanced tab -> Environment Variables button

Step 1 In the User variables section, double click on Path (or select Path and press Edit).

If there is anything else there put a semicolon after it ; and add the path to your Ruby bin folder -> for example C:\Ruby193\bin or C:\Ruby200\bin  Then press OK

ps. the 3 digits are the version of your Ruby installation. Just go to your C: drive and check the name of the Ruby folder.

Step 2 In the System variables section, press New. For variable name enter RYBUOPT and for variable value rubygems Press OK on the small window and on the other two that remained opened.

Step 3 To check if everything is okay now, go back to your Command Prompt window and type in

ruby – v

If you get a message with your ruby version, you managed to solve the problem. Great!

Unable to download data from http://rubygems.org/...

Se ricevi un errore del genere il motivo è che c'è un problema di connessione sicura con il server che scarica i pacchetti. Io ho risolto in questo modo:

gem sources --remove https://rubygems.org gem sources --add http://rubygems.org

Ti verrà chiesta conferma perché stai dicendo di usare una connessione non sicura. Digita y e fine.

Ora dovresti essere in grado di installare tutti i pacchetti indicati sopra e ad usare Jekyll.

Fork del repository

Segui le istruzioni nel Getting Started (macOS) per capire come procedere con il fork del repository.

Jekyll in locale

Una volta scaricato il repository, usando sempre l'applicazione cmd vai nella cartella dove hai salvato i file

cd C:\Users\Federico\Desktop\website-dev\

e lancia il comando

jekyll serve

Per fermare il server premi CTRL+C.