Aiuto:Famiglia di wiki

Da Cathopedia, l'enciclopedia cattolica.
Vai alla navigazione Vai alla ricerca

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

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.

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[2], 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
    • 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
  • FinkCommander in use.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
  • x 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
    • FinkCommander in use.png 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
    • FinkCommander in use.png 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
    • FinkCommander in use.png da automatizzare Trasferire alla pagina principale della nuova wiki il contenuto di en:Main page (quando sarà pronta)
      • FinkCommander in use.png non automatizzabile farla tradurre
    • FinkCommander in use.png non automatizzabile Importare alla nuova wiki le principali pagine del namespace Cathopedia:
      • FinkCommander in use.png non automatizzabile farle tradurre
      • (lista)
    • FinkCommander in use.png non automatizzabile Importare alla nuova wiki le principali pagine del namespace Aiuto.
      • FinkCommander in use.png non automatizzabile farle tradurre
      • (lista)
    • FinkCommander in use.png non automatizzabile Creare l'utente dell'amministratore e dargli i privilegi di amministratore
    • FinkCommander in use.png 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
  • x 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
  • FinkCommander in use.png non automatizzabile internazionalizzare le estensioni:
    • ArticleComments
    • ArticleContributor
    • BiblePassagge, compreso il file dei libri biblici BiblePassage.Books.i18n.php
    • ContactPage
    • ContributionScores
    • PayPal
    • RegistrationPage
    • Suggestion
  • FinkCommander in use.png non automatizzabile internazionalizzare alcuni messaggi di sistema sulla base di quelli di it.cathopedia.org
    • (lista)
  • x 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)
  • x 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