Linux Day Torino website
Materiale per il Linux Day Torino dal 2016 al 2019.
Installazione sito web
Il sito web vuole permettere l'indipendenza dei temi grafici dei vari anni di ogni Linux Day Torino, centralizzandone le informazioni.
È utilizzata la combinazione PHP+MySQL/MariaDB usando il framework sucklessPhp.
Preparazione
Su un sistema Debian stable:
apt-get install apache2 mariadb-server php5 php5-mysql libapache2-mod-php5 php-gettext libjs-jquery libjs-leaflet libmarkdown-php
a2enmod rewrite
service apache2 reload
File
Clonare i file di questo progetto direttamente nella DocumentRoot del proprio VirtualHost di Apache.
cd /var/www/linuxday
git clone [questo repo] .
In seguito copiare il file htaccess.txt in .htaccess.
Il sito può rimanere tranquillamente in sola lettura per l'utente Apache:
chown root:www-data -R /var/www/linuxday
chmod o= -R /var/www/linuxday
URL
Se il sito ha una cartella diversa dalla root, ricordarsi di variare l'.htaccess in concordanza:
# /.htaccess:
RewriteBase /ldto
E ricordarsi di aggiornare la relativa costante:
# /load.php:
define('ROOT', '/ldto');
Database
Creare un database e importare documentation/database/database-schema.sql.
Creare il file load.php (vedere l'esempio load-example.php) inserendovi le credenziali del database.
Si può applicare un prefisso alle tabelle, specificandolo nella variabile $prefix del file load.php.
Framework
Posizionare il framework Suckless-PHP nella directory includes:
# apt-get install git
git clone https://github.com/valerio-bozzolan/suckless-php includes/suckless-php
API
Le API (aka "tagliatella") possono generare un documento XML che contiene l'elenco dei talk/eventi (in un formato che alcuni chiamano Pentabarf, ma non è il formato Pentabarf, non ha nemmeno un nome in particolare).
La tagliatella restituisce un codice HTTP 500 e qualche uncaught exception se ci sono stati errori.
Multilingua
Il sito è multilingua grazie a GNU Gettext. GNU Gettext è un software un po' anziano ma decisamente rispettabile e adottato da tutti i principali CMS a cui puoi pensare. Riassumere il workflow di GNU Gettext in poche righe confonderebbe soltanto, quindi passiamo al sodo.
Per cambiare una stringa italiana, cambiala dal database o dal codice sorgente.
Quando poi hai deciso di voler tradurre il progetto così com'è:
# Exporting database strings to source code
cd ./2016/l10n/
./mieti.php > ./trebbia.php
cd -
# Export source code to GNU Gettext template (.pot)
./2016/l10n/localize.php .
# Export GNU Gettext template (.pot) in files for Poedit (.po)
./2016/l10n/localize.php .
A questo punto sfodera Poedit e traduci tutti i .po che desideri.
I file .po sono situati nella directory 2016/l10n/.
Per vedere il risultato in funzione (indovina un po'?):
# Compile Poedit files (.po) to binary GNU Gettext files (.mo)
./2016/l10n/localize.php .
Cambiare lingua
Il sito effettua content negotiation controllando la lingua accettata dal browser web (l'header Accept-Language) o eventuali richieste GET/POST/COOKIE con il parametro l=$lingua (en, it, ecc.). La lingua italiana è predefinita.
Aggiunta lingua
Copiare il template GNU Gettext 2016/l10n/linuxday.pot in un nuovo file .po nel nuovo percorso di lingua (e.g.: ./$ANNO/l10n/ru_RU.utf8/LC_MESSAGES/linuxday.po) e modificare quest'ultimo con Poedit. Registrare la lingua in Boz-PHP modificando ./2016/load.php e rieffettuare i passi della sezione multilingua.
Backend
Per poter accedere al backend occorre registrarsi:
./cli/add-user.php --uid=mario.rossi --role=admin --pwd=password
Effettuare poi il login nella pagina 2016/login.php.
Esportazione del database
Nota: a differenza del codice sorgente il database in questo repository è da considerarsi read-only ed è molto meglio contattare il webmaster invece che variarne i contenuti direttamente.
In ogni caso:
vagrant ssh
/vagrant/Vagrant/pull-database.php
exit
Aggiornamento del database
./cli/upgrade.php
Contributi
Ogni contributo avviene sotto i termini di una licenza compatibile con la licenza in calce. L'autore di un nuovo file ricopia l'intestazione della licenza da un file esistente. Autori/contributori si firmano nell'intestazione del file creato/modificato (o della parte creata/modificata) come detentori del diritto d'autore.
Licenza
Salvo ove diversamente specificato, il progetto appartiene ai contributori di Linux Day Torino ed è distribuito sotto licenza GNU Affero General Public License. Eccezione soprattutto per alcuni loghi dei vari partner, che appartengono ai legittimi proprietari e sono concessi in licenza esclusiva a Linux Day Torino, ed ad alcuni temi grafici degli anni 2015 e precedenti.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.