Sito dell'associazione Assob.it

Il sistema Git, github, github pages e jekyll costituiscono un insieme di strumenti molto utili per la manutenzione collaborativa di un sito Web e la nostra associazione deve basarsi necessariamente sulla collaborazione.

Per cominciare (non esperti)

Bisogna iscriversi a Github
Seguire le istruzioni sulle FAQ per fare le operazioni comuni usando solo github.com

Le pull requests (modifiche proposte) sono attualmente valutate da me ma sono discusse pubblicamente. Spero prestissimo di avere collaboratori (più sono meglio sto).

To have

Un sistema per dare al non esperto immediata visibilità delle sue modifiche. Se uno dei nostri legali fa modifiche a una parte di testo vorrà vedere come viene e sarebbe bello dargli la possibilità di apprezzare un 'anteprima delle modifiche. Attualmente github non visualizza anteprime di un tuo repository se non tramite github pages ed è possibile solo un sito github pages per account utente (da esplorare la possibilità di fare pagine di progetto con gh-pages).

Per cominciare (esperti di git)

Bisogna iscriversi a Github
Fare un fork di questo repository creando una copia sul proprio account github
Clonare il repo in locale

git clone *urlRepositoryDaClonare
Configurare il repository di origine come "upstream" con il comando git remote. In questo modo IL NOSTRO FORK sarà configurato come "origin" *configurare il REPOSITORY DI ORIGINE come "upstream"

git remote add upstream *urlDelRepositoryOrigineDelClone
mantenerlo sincronizzato con quello di origine In sintesi si tratta di recuperare spesso tutte le branch dal repository di origine (upstream) fare il merge, fare il commit e il push sul proprio repository su github

git fetch upstream

Fare il checkout della branch del proprio repository da sincronizzare con quello di origine (es:master)

git checkout master

git merge upstream/master

fare le modifiche e poi aggiornare la propria copia su github del repository

git push

Aprire una branch per ogni gruppo di modifiche uniformi (è più ordinato)
quando una modifica è pronta per essere sottoposta ai "committers" si apre una pull request sul proprio repository forkato di github. Questo non è altro che un invito ai committers a "tirare dentro" al repository ufficiale le modifiche su cui abbiamo lavorato.

Per vedere i risultati del proprio lavoro in locale è necessario installare github-pages come "gemma" in Ruby

gem install github-pages costruire l'ambiente per jekyll dentro al sito: jekyll new ilNomeDelRepository # va invocato dalla directory padre cd myblog jekyll serve --watch

Il primo comando può essere sostituito da jekyll new . se lanciato dentro al repository.

Poi dovete andare con un browser alla pagina 127.0.0.1:4000

Errori e Problemi