Materiale per il Linux Day Torino dal 2016 al 2019.
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.
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
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
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');
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
.
Posizionare il framework Suckless-PHP nella directory includes
:
# apt-get install git
git clone https://github.com/valerio-bozzolan/suckless-php includes/suckless-php
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.
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 .
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.
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.
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
.
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
./cli/upgrade.php
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.
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/.