Aiuto:Famiglia di wiki

In questa pagina elaboriamo la procedura per passare dalla sola it.cathopedia.org alla famiglia di wiki.

Impostazioni

Nomi delle wiki

Le wiki che vogliamo settare sono:

• www.cathopedia.org: pagina principale del progetto multilingue, contenente:
  • le informazioni sulle wiki già esistenti
  • la presentazione essenziale del progetto in inglese
• commons.cathopedia.org per i file multimediali
• wiki linguistiche: <codice linguistico di due lettere>.cathopedia.org

Apache

Un unico record di apache, che ha ServerName cathopedia.org e DocumentRoot /var/www/cathopedia.org/, nel quale è specificata come ServerAlias la forma che viene usata per ogni lingua tra tutte le <prefisso>.(c|k)athopedia.(org|net).

Per ogni lingua poi un record cathopedia_<prefisso> per fare il reindirizzamento delle forme secondarie (c|k)athopedia.(org|net) alla sola forma che si vuole usare

Codice

Il codice php è unico per tutte le wiki, compreso il LocalSettings.php (che però ha parti personalizzate per le varie lingue).

Le estensioni devono essere tutte internazionalizzate.

Immagini e altri files

Ogni wiki linguistica vede in automatico le immagini su commons.cathopedia.org, e carica di default i files a commons.cathopedia.org.

Ogni wiki ha la sua particolare cartella images/<codice linguistico>/ per le eventuali immagini legate alla sua lingua.

Logo

Mettiamo il logo (135x135px) in images/logo, nella forma logo_cathopedia_<prefisso>.png.

Database

Un database per ogni wiki linguistica, nella forma cathopedia_l_<prefisso>.

www.cathopedia.org e commons.cathopedia.org seguono lo schema cathopedia_<prefisso>.

Alcune tabelle sono da condividere tra tutte le wiki, nel db "cathopedia_share":

• ipblocks
• interwiki

LocalSettings.php

LocalSettings.php deve riconoscere il prefisso anteposto a cathopedia.org, perché in base a quello deve settare vari parametri secondo la wiki. Dovrebbero esserci due file per ogni lingua:

• LocalSettings_<prefisso>_pre.php
• LocalSettings_<prefisso>_post.php

In questa maniera si mettono nel primo i settaggi che vanno messi all'inizio, e nel secondo quelli che vanno dopo le estensioni.

Le estensioni sono in un file a parte: Localsettings_extensions.php

Inoltre sono in un file a parte le credenziali di accesso al db.

update.php

Quando si aggiorna mediawiki bisogna farlo girare per ogni wiki, ma siccome è in LocalSettings.php che viene definito l'accesso al db, occorrono accorgimenti, vedi http://www.mediawiki.org/wiki/Manual:Wiki_family#Updating_wikifarm_from_the_commandline.

Vengono usati gli script update_family.php e update_subdomain.php.

Anche altri eventuali script di maintenance vanno fatti girare con gli script script_on_family.php e script_on_subdomain.php.

Procedure preliminari

• Fatto Cambiare il nome del db di it.cathopedia.org a cathopedia_it.
• Fatto Spostare le immagini di it.cathopedia.org da /var/www/cathopedia.org/w/images/ a /var/www/cathopedia.org/w/images/it/ e aggiustare il LocalSettings.php di conseguenza
• Fatto Fare il db con le tabelle condivise (ipblocks e interwiki), dare i privilegi di accesso e aggiustare il LocalSettings.php di conseguenza
• Fatto Separare il LocalSettings.php nei vari pezzi
• Fatto generare www.cathopedia.org
• Fatto generare commons.cathopedia.org
• Fatto Spostare le immagini da it.cathopedia.org a commons.cathopedia.org. Sono più di 10.000 immagini. Come si fa?
  • Speciale:Esporta, ma non permette di spostare un namespace intero
    • Questa estensione farebbe al caso nostro, ma non funziona
  • lo script maintenance/importImages.php importa solo le immagini, ma non sembrerebbe che non importa la descrizione che c'è nella pagina [[File:Nome immagine.jpg]]
  • DumpBackup.php --filter=namespace:6,7 seguito da ImportDump.php e da importImages.php?
  • prima importImages.php e poi gli altri due?
  • con il bot!
• Fatto rendere tutte le estensioni internazionalizzabili
• Fatto stabilire la possibilità di caricare le immagini su commons, deve essere di default
• Fatto cambiare la dipendenza dei template liturgici: non dalla data delle Ceneri ma da quella della Pasqua (tramite l'estensione Easter che restituisce il numero di giorni dell'anno del giorno di Pasqua)

Per iniziare una nuova wiki

• in automatico Generare il logo provvisorio a images/logo/logo_cathopedia_<prefisso>.png
• non automatizzabile Generare o far generare quello definitivo: tradurre la scritta "l'enciclopedia cattolica" del logo e caricare il logo sul server

Dal terminale

• non necessario per la procedura automatica (se se ne creano varie, solo prima di creare la prima wiki) fare un link symbolico da /var/lib/mediawiki/config a /var/www/cathopedia.org/w/config (con sudo)
• in automaticocopiare il file /var/www/cathopedia.org/w/LocalSettings_it_pre a /var/www/cathopedia.org/w/LocalSettings_<prefisso>_pre (con sudo cp -a), renderlo leggibile e scrivibile solo dal proprietario, ma togliere i vincoli sul non poter creare pagine prima di un certo tempo e numero di modifiche
  • non automatizzabile personalizzarne i valori (con sudo -u www-data)
• in automaticocopiare il file /var/www/cathopedia.org/w/LocalSettings_it_post a /var/www/cathopedia.org/w/LocalSettings_<prefisso>_post (con sudo cp -a), renderlo leggibile e scrivibile solo dal proprietario
  • non automatizzabile e personalizzarne i valori (con sudo -u www-data)
• in automatico creare la cartella /var/www/cathopedia.org/images/<prefisso> (con sudo -u www-data)

Dal navigatore

• in automatico Installare http://<prefisso>.cathopedia.org/, aprendo http://<prefisso>.cathopedia.org/w/config. Non è necessario mettere tutti i dati. Quelli necessari sono:
  • Wiki name: Cathopedia
  • Language: <prefisso>
  • Admin username: WikiSysop
  • Password: la stessa usata per le altre wiki
  • Database host: localhost
  • Database name: cathopedia_<prefisso>
  • DB username: lo stesso delle altre wiki
  • DB password e DB password confirm: la stessa delle altre wiki
  • Superuser account: selezionarlo
  • Superuser name: il superuser di mysql
  • Superuser password: la relativa password
  • Cliccare quindi sul bottone Install Mediawiki in fondo: viene generato il db e il file /var/lib/mediawiki/LocalSettings.php, che peraltro non verrà usato
• da phpmyadmin
  • in automatico dare accesso al db cathopedia_<prefisso> all'utente cp_backup con privilegi "SELECT, LOCK TABLES"
  • in automatico Aggiungere l'interwiki <prefisso> nella tabella interwiki del database cathopedia_share
  • in automatico creare la tabella titlekey dall'apposito file dell'estensione
• Sulla nuova wiki:
  • in automatico Mettere l'interfaccia in italiano all'utente WikiSysop e confermarne l'email
  • in automatico Importare da it.cathopedia.org i css del monobook
  • da automatizzare Trasferire alla pagina principale della nuova wiki il contenuto di en:Main page (quando sarà pronta)
    • non automatizzabile farla tradurre
  • non automatizzabile Importare alla nuova wiki le principali pagine del namespace Cathopedia:
    • non automatizzabile farle tradurre
    • (lista)
  • non automatizzabile Importare alla nuova wiki le principali pagine del namespace Aiuto.
    • non automatizzabile farle tradurre
    • (lista)
  • non automatizzabile Creare l'utente dell'amministratore e dargli i privilegi di amministratore
  • non automatizzabile Creare la categorie fondamentali:
    • (lista)
• In piwik, aggiungere il nuovo sito, quindi prendere il codice e metterlo nel file /var/wwwc/cathopedia.org/piwik_codes/piwik_<prefisso>

Dal terminale

• non necessario per la procedura automatica rinominare /var/lib/mediawiki/config/LocalSettings.php a /var/lib/mediawiki/config/LocalSettings_<prefisso>.php: non serve a niente ma rimane per documentazione
• non automatizzabile internazionalizzare le estensioni:
  • ArticleComments
  • ArticleContributor
  • BiblePassagge, compreso il file dei libri biblici BiblePassage.Books.i18n.php
  • ContactPage
  • ContributionScores
  • PayPal
  • RegistrationPage
  • Suggestion
• non automatizzabile internazionalizzare alcuni messaggi di sistema sulla base di quelli di it.cathopedia.org
  • (lista)
• non necessario per la procedura automatica (se si creano varie wiki, solo quando si ha finito) cancellare /var/www/cathopedia.org/w/config (con sudo)
• non necessario per la procedura automatica (se si creano varie wiki, solo quando si ha finito) far girare lo script ./update_wikifarm.sh (con sudo -u www-data)

C'è uno script che fa tutte le procedure automatizzabili.

Note