URNA logo
URNA→ conserva le
cose a cui
Winston Smith
tiene

Urna — il solido ripostiglio di Winston Smith

by Winston Smith
on Fri 24 April 2015

Urna è il repository dei file digitali (audio,video,pdf,ecc…) ed è anche un sito contenente informazioni di lavoro e procedure su come gestire e manutenere tutto il sistema informatico di Winston Smith.

ENTRATE A VOSTRO RISCHIO E PERICOLO.

Tutte le informazioni su questo sito sono altamente instabili e volatili, maneggiare con cura!

Procedure

Siti PMGC (Pelican/Markdown/Github/Casellante)

A Winston Smith non piaccono i CMS ed usa solo siti statici. Ha scelto una tecnologia basata sull'integrazione verticale del sistema Pelican con il formato testuale Markdown, il repository GITHUB sul proprio server denominato Casellante.

Urna — PGMC - come modificare un sito Winston Smith

by Winston Smith
on Fri 24 April 2015

Per modificare uno dei siti Winston Smith realizzati con la catena PMGC è necessario:

Clonare (o aggiornare) il repository sorgente sul proprio sistema
Modificare i file Markdown
Rigenerare i file statici html
Verificare il risultato
Aggiornare il repository sorgente

Dopo la conclusione di quest'ultimo passo è possibile compiere i passi necessari alla pubblicazione del sito su casellante

I repository sorgente di Winston Smith sono i seguenti:

Big Brother Awards
E-Privacy
URNA (questo sito)
ANTANI (sito di prova, facci quello che ti va)

I collaboratori hanno accesso diretto ai repository e possono fare commit direttamente, gli altri possono comunque proporre pull-request.

Clonare (o aggiornare) il repository sorgente sul proprio sistema

Se non si ha una versione locale dei file di creazione del sito è possibile clonare il repository con il comando:

git clone https://github.com/progettowinstonsmith/urna-site.git

Verrà creata una directory urna-site all'interno della quale, tra gli altri ci sono i seguenti file o directory:

pelicanconf.py: File di configurazione del sito

content: Directory contenente i documenti Markdown o i file statici del sito

theme: Directory contenente il tema di rappresentazione del sito

All'interno della directory dei contenuti (content) ci sono i file delle differenti pagine presenti nel sito, ad es:

$ ls -1 content/
attivazione-pelican-markdown.md
pmgc-modificare-siti.md
urna.md

Ciascuno di questi file rappresenta una pagina del sito in formato testuale Markdown.

Se si ha già una directory contenente il clone della directory di lavoro è necessario prima della sessione di lavoro aggiornare i propri file integrando le modifiche esterne con il comando:

git pull

Modificare i file Markdown

I file Markdown devono essere creati o modificati usando un qualsiasi editor di testi (ad es. emacs o vi). Se si creano nuove pagine Markdown è sufficiente inserirle nella directory content per essere prese in considerazione per la pubblicazione, non è necessario aggiornare alcun elenco di pubblicazione.

Rigenerare i file html

Una volta modificata la pagina Markdown è possibile ricreare l'intero sito e tutte le sue pagine HTML usando il comando:

make html

Il sistema risponderà con un messaggio simile:

Done: Processed 3 article(s), 0 draft(s) and 0 page(s) in 0.19 seconds.

Verificare il risultato

I file generati sono disponibili nella cartella output (per capire bene il funzionamento della directory output leggere il documento sulla pubblicazione online ).

Per verificare il risultato sulla macchina di lavoro è possibile lanciare un server HTTP locale con il comando:

make serve

Un server verrà messo in esecuzione in modo sincrono e potrà essere verificato il contenuto del sito collegandosi al server (o a localhost) sulla porta 8000, ad es.:

http://localhost:8000

Il sito dovrà risultare completamente funzionante e navigabile.

Per chiudere il server è sufficiente bloccare il comando con CTRL-C.

È anche possibile attivare un server in background con:

make devserver

Che potrà essere abbattuto con il comando:

make stopserver

Aggiornare il repository sorgente

Accertatisi della correttezza delle modifiche apportate è possibile aggiornare il repository sorgente con il comando:

git pull

oppure preparando una pull-request nelle modalità solite.

Pubblicazione del sito online

Giunti a questo punto è possibile compiere di seguito i passi riportati nel documento di pubblicazione del sito su casellante

Urna — PGMC - come pubblicare un sito Winston Smith

by Winston Smith
on Fri 24 April 2015

Esistono due differenti modi per pubblicare un sito Winston Smith PMGC a seconda che si abbia o meno l'accesso diretto a Casellante:

Se non hai accesso a Casellante

In questo caso:

se non hai accesso neppure al repository dei siti su Github, l'unico modo di contribuire è preparare una pull-request e contattare uno degli amministratori.

Se hai accesso a Casellante

(ed hai pure particolare fretta tanto da non voler attendere l'aggiornamento periodico)

rigenera la versione statica e senza attendere il prossimo aggiornamento periodico,
forza la sincronizzazione immediata

Come rigenerare la versione statica del sito

Segui semplicemente i passi già indicati in come modificare un sito Winston Smith, nel tuo ambiente di lavoro o in quello di ampleforth. Verifica sempre che il sito non abbia problemi.

Come forzare l'immediata sincronizzazione

Entrare nel proprio utente di Casellante ed eseguire il comando:

~/bin/eprivacy-resync-now

A questo punto abbi fiducia e dopo qualche minuto verifica che sia andato tutto bene.

Trucco veramente sporco per sincronizzare SUBITO

Se sei uno dei pochi fortunati dotato di un accesso ssh ai siti web di casellante, puoi dare il seguente comando direttamente dalla directory <progetto>-site dopo aver rigenerato (e verificato la correttezza del sito):

make ssh_update

PS - Perché questo trucco funzioni c'è un ingrediente segreto che dovrò dirti a voce.

Urna - PMGC - Attivazione di un sottosistema pelican/markdown

by Winston Smith
on Fri 24 April 2015

Per attivare un sistema di lavorazione delle pagine web dei nuovi siti di Winston Smith è necessario attivare un sistema autonomo Pelican/Markdown sul proprio computer (i pochi sfortunati che hanno accesso ai server del PWS troveranno un sistema già attivo all'account ampleforth).

Il processo è costituito in tre passi:

Installazione dell'interprete Python
Creazione di un ambiente virtuale dedicato a Pelican
Installazione di Pelican e Markdown

Se hai già a disposizione (o sai come fare in autonomia) ciascuno di questi passi, puoi direttamente saltare a quello successivo.

Installazione di python (con Miniconda)

Miniconda è un progetto che mette a disposizione nello spazio d'utente una installazione completa di Python e un gestore di pacchetti (conda). È un modo molto semplice per gestire ambienti virtuali e installazioni di pacchetti Python anche da parte di chi è alle prime armi. È possibile installare un interprete python con Miniconda anche se si ha già un python installato nel sistema, semplicemente ad un certo punto si sceglierà di usare quello messo a disposizione da miniconda.

Per installare Miniconda scarica il file adatto al tuo sistema operativo (Linux, Mac OS X, Windows) dalla pagina http://conda.pydata.org/miniconda.html e segui le informazioni per l'installazione (in breve: esegui il file dalla linea di comando).

La procedura d'installazione creerà una distribuzione Python completa e funzionante nella tua directory utente $HOME (di solito nella cartella $HOME/miniconda). Non hai bisogno dei privilegi di amministrazione del sistema per installare miniconda. Dopo l'installazione basterà includere la directory dei binari per poter utilizzare il nuovo interprete, ad es. sui sistemi basati su Unix si userà il comando:

export PATH=~/miniconda/bin:$PATH

Questo comando puoi metterlo nella .bash_profile per poter usare quest'interprete anche la prossima volta che ti colleghi al sistema.

Hai così installato un interprete python.

Creazione di un ambiente virtuale per Pelican

Sebbene sia possibile installare i pacchetti necessari al lavoro su Pelican direttamente nell'ambiente base di python è solitamente consigliato creare un ambiente virtuale python dedicato. È molto conosciuto il progetto virtualenv per questo. Con Miniconda però il sistema di distribuzione dei pacchetti (chiamato conda) permette di creare ambienti di lavoro separati per progetti.

Quindi ti basterà usare il comando:

conda create -n pws python pip

per creare un nuovo ambiente virtuale chiamato pws (ma poteva essere qualsiasi altro nome). Installerà all'interno il linguaggio python e il pacchetto pip.

Per attivare l'ambiente sarà sufficiente usare il comando:

source activate pws

Da quel momento all'estrema sinistra del prompt vedrai l'indicazione dell'ambiente virtuale:

 (pws) casellante:~#

Nella prossima sessione di lavoro non ci sarà bisogno di ricreare l'ambiente virtuale, basterà solo attivarlo con il comando già visto:

source activate pws

Hai così realizzato un ambiente virtuale python per poter lavorare con pelican e i siti PMGC di Winston Smith.

Installazione di Pelican e Markdown

L'ultimo passo da compiere, una volta creato l'ambiente virtuale di lavoro, è l'installazione dei package di lavoro pelican e markdown attraverso il sistema di packaging standard di python pip.

Il comando è:

pip install pelican markdown

Il sistema pip scaricherà questi pacchetti e tutte quelli necessari e completerà l'installazione in breve. Al termine potrai usare il comando:

pelican-quickstart

come indicato dal tutorial di pelican.

Ecco fatto!

Ora puoi iniziare a modificare una pagina di un sito PMGC