FAQ
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 creare un articolo sul 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 (https://github.com/assobit/assobit.github.io). Lì troverete i file del sito che potrete:
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).
Se modifichiamo il sito partendo da uno dei numerosi link che danno la possibilità di migliorare le pagine sul sito (ce n'è sempre uno nel piè di pagina) la prima volta ci verrà presentata la presente videata.
Dopo che avremo dato l'assenso al fork del sito e avremo fatto le modifiche del caso ci si presenterà il modulo per creare la pull request con 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.
quella dopo è quella che vi dà proprio la possibilità di aprire la pull request
La richiesta è stata aperta
Se già contribuite a blog o a quotidiani e volete mettere il link a un vostro articolo pubblicato nella sezione news del sito Assob.it potete usare il link "Proponi una news" che trovate in cima ai post.
Se è la prima volta vi verrà chiesto di fare il fork del sito da modificare per poi poter immettere
pull requests
Prestate attenzione che dopo la data nel nome del file andrà messo il titolo dell'articolo legato da segni meno "-".
Dopo aver digitato una breve descrizione sotto si può immettere la pull requests.
- Andare sul repository (http://github.com/assobit/assobit.github.io) e spostarsi nella directory "_post"
- cliccare su "new file"
- chiamare il nuovo file con data e titolo nella forma: AAAA-MM-GG-titolo-Dell-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.
potete usare il link "Proponi una news" che trovate in cima ai post.
Se è la prima volta vi verrà chiesto di fare il fork del sito da modificare per poi poter immettere
pull requests
Prestate attenzione che dopo la data nel nome del file andrà messo il titolo dell'articolo legato da segni meno "-".
Nella zona sottostante alle variabili (quindi sotto a "---") potete scrivere in linguaggio Markdown oppure html il vostro articolo.
Al termine, per proporre la pubblicazione, inoltrate una pull requests.
Per mostrare questi passaggi ho creato un piccolo screencast
<iframe width="560" height="315" src="https://www.youtube.com/embed/4dapZ2y1siM" frameborder="0" allowfullscreen></iframe> #### Se invece **non** passate dal link seguite i passi qui sotto:- Andare sul repository (http://github.com/assobit/assobit.github.io) e spostarsi nella directory "_post"
- cliccare su "new file"
- chiamare il nuovo file con data e titolo nella forma: AAAA-MM-GG-titolo-Dell-articolo.md
- scrivere all'inizio del file i campi riportati e sotto un riassunto come nell'esempio qui sotto:
---
layout: post
external_url:
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
---
Dopo queste righe obbligatorie da compilare
- Infine creare la pull request premendo il tasto verde sotto e compilando i campi richiesti.
---
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.
E' disponibile un nuovo link alla fine della pagina "Improve This Page"
Se cliccate il link andate direttamente al punto 3 della procedura sotto. Se no, senza il cliccare sul link, seguire tutti gli step. Attenzione: la prima vi sarà richiesto di forkare il repository. Dovete farlo per poter proporre la modifica ma, una volta fatto, non vi verrà più richiesto.
- Andare sul repository (http://github.com/assobit/assobit.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
Qui trovate il filmato di una semplice modifica ad una pagina
- Andare sul repository (http://github.com/assobit/assobit.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