Segue un sommario delle domande con link alle risposte:
- Per cominciare
- cos'è una pull request?
- Vorrei aggiungere un link a un post esterno nel sito
- Vorrei aggiungere un post al sito
- Vorrei modificare Una pagina del sito (non nei post)
- Vorrei modificare un file del sito (non nei post)
- Vorrei creare Una pagina del sito (non nei post)
- Vorrei cambiare le immagini delle pagine
- Vorrei modificare i fogli di stile
- Vorrei modificare la struttura delle pagine
- Vorrei modificare la barra di navigazione
- Modificare l'head
- Modificare l'header
- Modificare il piè di pagina
- Modificare il sito utilizzando git
Unico prerequisito è essere iscritti a github. Entrate in github con le vostre credenziali e andate sul repository del sito (adesso è provvisoriamente https://github.com/gabridome/gabridome.github.io). Lì troverete i file del sito che potrete modificare.
Nel momento in cui farete la prima modifica il repository del sito verrà duplicato (con un fork) sul vostro account e in realtà voi modificherete la vostra copia e aprirete delle richieste di "adozione" delle vostre modifiche dentro al repository del sito (pull requests).
Come utenti non abbiamo accesso in scrittura al repository dov'è contenuto il sito. Github ci permette di aprire delle richieste di modifica del sito ufficiale tramite richieste ufficiali di incorporazione nel seguente modo:
- Crea un fork (un duplicato collegato al repository originale) nel nostro account
- Ogni modifica che facciamo al nostro duplicato del sito ufficiale crea in automatico una "pull request" che è una richiesta fatta ai manutentori del sito ufficiale di "tirare dentro" a questo le modifiche che abbiamo fatto. Creiamo in sintesi delle "Pull requests".
- Queste vengono esaminate dai manutentori ufficiali e possibilmente "fuse" (merge) con il sito ufficiale attraverso un commit (cambiamento di stato del sito).
Quando vogliamo creare la pull request dopo aver fatto una modifica sul nostro fork ci si presenta la videata di richiesta di modifica del sito ufficiale:
Una volta cominciato il processo ci fanno esaminare l'impatto che il cambiamento ha sul repository ufficiale.
l'ultimo passaggio dà la possibilità di commentare e giustificare la richiesta.
La maniera più semplice (senza usare git e senza fare copie locali del sito):
- Andare sul repository (http://github.com/gabridome/gabridome.github.io) e spostarsi nella directory "_post"
- cliccare su "new file"
- chiamare il nuovo file con data e titolo nella forma: AAAA-MM-GG-titoloDell'articolo.md
- scrivere all'inizio del file i campi riportati e sotto un riassunto come nell'esempio qui sotto:
---
layout: post
external_url: http://www.assob.it/index.php/2015/09/18/intervista-a-guido-baroncini-turricchia/
img: http://www.assob.it/wp-content/uploads/2015/09/intervista-a-Guido-Baroncini-Turricchia.png
membro: Guido Baroncini Turricchia
ruolo: Membro fondatore AssoB.it
---
Scrivere qui un brevissimo riassunto dell'articolo.
- Infine creare la pull request premendo il tasto verde sotto e compilando i campi richiesti.
La maniera più semplice (senza usare git e senza fare copie locali del sito):
- Andare sul repository (http://github.com/gabridome/gabridome.github.io) e spostarsi nella directory "_post"
- cliccare su "new file"
- chiamare il nuovo file con data e titolo nella forma: AAAA-MM-GG-titoloDell'articolo.md
- scrivere all'inizio del file i campi riportati e sotto un riassunto come nell'esempio qui sotto:
---
layout: post
img: https://jekyllrb.com/img/logo-2x.png
membro: Gabriele Domenichini
ruolo: presidente AssoB.it
---
- Scrivere l'articolo sotto a
---con il linguaggio Markdown - Infine creare la pull request premendo il tasto verde sotto e compilando i campi richiesti.
- Andare sul repository (http://github.com/gabridome.github.io) e cliccare sul file html che corrisponde alla pagina
- in alto a destra nella finestra di modifica c'è il simbolo della matita. E' per modificare il sito
- individuare il testo nel codice HTML, modificare a piacere
- aprire una pull request
- Andare sul repository (http://github.com/gabridome.github.io) e cliccare sul file da cambiare
- in alto a destra nella finestra di modifica c'è il simbolo della matita. E' per modificare il sito
- individuare il testo nel codice HTML, modificare a piacere
- aprire una pull request
La cosa più veloce è copiare il codice html di una pagina esistente es: about.html e dentro la pagina principale del repository cliccare "new file". Dare il nome al file e nella finestra di modifica incollare il codice e modificare il contenuto di about precedentemente copiato.
E' da tenere presente che questa pagina non è "linkata" da nessun altra esistente e quindi irraggiungibile senza il link preciso.
Si potrebbe creare un post ad hoc o inserire la pagina nella navbar ma è sempre meglio tenere questa molto sintetica.
Le immagini sono inserite nella variabile bgimg che è scritta all'inizio della pagina es nella pagina about.html:
---
layout: default
title: Assob.it
sub-title: Chi siamo
bgimg: img/about-bg.jpg <<<<
---
Puoi seguire le istruzioni relative alla modifica della pagina (non nei post).
Modifica Il foglio di stile del template. Puoi anche modificare il codice HTML della pagina se non è una modifica che vuoi che si rifletta su tutto il sito o non vuoi creare una classe "semantica". Qui le istruzioni per modificare i files
Il layout di più alto livello sta nel file _layout/default.html a cui quasi tutti i files si richiamano nella variabile layout. Basta modificare quindi questo layout. Qui le istruzioni
Il file da modificare è: _includes/navbar.html
Qui le istruzioni ###Vorrei modificare l'elemento head (i meta, il link al file css etc)
Il file da modificare è _includes/head.html
Il file da modificare è
_includes/header.html
Il file da modificare è
_includes/footer.html
Clona il repository e tienilo sincronizzato col tuo. Installa github-pages
gem install github-pages
Per avere la preview del sito:
jekyll build _directoryRepository_
cd _directoryRepository_
jekyll serve --watch
La preview di ciò che modificate nel repository sarà all'indirizzo: http://127.0.0.1:4000.