MediaWiki/La barra laterale: differenze tra le versioni

Wikibooks, manuali e libri di testo liberi.
Contenuto cancellato Contenuto aggiunto
mNessun oggetto della modifica
Riga 145: Riga 145:


=== Creare le Tabelle===
=== Creare le Tabelle===
Se volete che nella vostra '''Barra Laterale sinistra''' siano presenti i '''collegamenti''' alle varie '''versioni linguistiche internazionali di wikipedia''', gemellandovi per così dire con essa, potete creare velocemente le Tabelle andando semplicemente a pescare i file che terminano in <code>.sql</code> presenti all'interno della vostra cartella <tt>/maintenance/</tt>, dove avrete installato il wiki.
Se volete che nella vostra '''Barra Laterale sinistra''' siano presenti i '''collegamenti''' alle varie '''versioni linguistiche internazionali di wikipedia''', gemellandovi per così dire con essa, bisogna modificare il database.


Prima di tutto si individua il file che vi interessa: nella cartella <tt>/maintenance/</tt>, dove è installato MediaWiki,
*Il file <tt>interwiki.sql</tt> contiene gli interwiki utilizzati sui progetti della Wikimedia Foundation;
*Il file <tt>wikipedia-interwiki.sql</tt> contiene i collegamenti verso le versioni di Wikipedia nelle varie lingue;
*il file <tt>interwiki.sql</tt> contiene gli interwiki utilizzati sui progetti della Wikimedia Foundation;
*Il file <tt>wiktionary-interwiki.sql</tt> contiene i collegamenti verso le versioni di Wikizionario nelle varie lingue.
*il file <tt>wikipedia-interwiki.sql</tt> contiene i collegamenti verso le versioni di Wikipedia nelle varie lingue;
*il file <tt>wiktionary-interwiki.sql</tt> contiene i collegamenti verso le versioni di Wikizionario nelle varie lingue.


Gli ultimi due utilizzano uno stesso insieme di prefissi (i prefissi linguistici del gruppo [[w:ISO-639|ISO-639]]), pertanto non sono compatibili tra loro (ciascuno sovrascrive l'altro).
Gli ultimi due utilizzano uno stesso insieme di prefissi (i prefissi linguistici del gruppo [[w:ISO-639|ISO-639]]), pertanto non sono compatibili tra loro (ciascuno sovrascrive l'altro).


Per impostare gli interwiki, si eseguono le query SQL contenute in questi file. Il modo più semplice per farlo è usare il pannello di controllo del database (per es. phpMyAdmin) e copiare il testo del file interessato.
Dovrete agire sulle Tabelle del vostro Database [[:w:it:MySQL|MySQL]], con ''PhAdmin'', dal pannello di controllo del vostro sito.


Se invece volete, personalizzare e creare da voi le Tabelle ad altri progetti wiki, nel senso che, non ve ne frega niente di "gemellarvi" con wikipedia, allora potete anche saltare questo primo passaggio, e andare subito a modificarle e crearle avvalendovi dell'estensione "Special interwiki".
Se invece volete, personalizzare e creare da voi le Tabelle ad altri progetti wiki, nel senso che, non ve ne frega niente di "gemellarvi" con wikipedia, allora potete anche saltare questo primo passaggio, e andare subito a modificarle e crearle avvalendovi dell'estensione "Special interwiki".

Versione delle 23:11, 17 feb 2012

Indice del libro

Per modificare la Barra Laterale sinistra, cercate la pagina MediaWiki:Sidebar all'interno del vostro wiki; da lì, potrete cambiare la disposizione, oppure il nome degli elementi. Per farlo cliccate su "Modifica pagina", per modificare questa pagina però dovrete avere i privilegi di amministratore ed essere loggati

due esempi di Sidebar modificate

da cui potrete trarre spunto:

Primo esempio

* navigation 
** mainpage|mainpage
** recentchanges-url|recentchanges
** Speciale:SearchFeed|RSS ultime modifiche
** randompage-url|randompage
** vetrina-url|vetrina
** helppage|help

* comunità
** portal-url|portal
** sitesupport-url|sitesupport
** contact-url|contact
<!-- 1 -->


PS: al posto del numero 1, lasciate dentro le parentesi le altre voci che volete cancellare, resteranno invisibili, ma pronte per essere riutilizzate.

Secondo esempio

* navigation
** mainpage|mainpage-description
** bar|Bar
** recentchanges-url|recentchanges
** randompage-url|Una pagina a caso
** helppage|help
** portal-url|Linee Guida

* prova
** Sandbox|pagina delle prove

<!-- * comunità -->
<!-- ** portal-url|portal -->
<!-- ** contact-url|contatto -->

<!-- 1 -->
<!-- ** vetrina-url|vetrina -->
<!-- ** sitesupport-url|sitesupport -->
<!-- ** Donazioni|Donazioni -->

<!-- ** currentevents-url|currentevents ; oppure  -->
<!-- ** Ultime notizie|Ultime notizie -->


<!-- * SEARCH -->
<!-- * TOOLBOX -->
<!-- * LANGUAGES -->

Collegamento di "Carica su Commons"

Se v'interessasse solamente il Collegamento di "Carica su Commons" sulla Barra Laterale a sinistra, copiatevi allora sul monobook.js solo questo pezzettino:

Per approfondire, vedi Gli Stili.
/*** Collegamento diretto alla pagina di upload di Commons nel menu di sinistra, da WP:PT */
function linkUploadToCommons()
{
    if (document.getElementById("carrega-para-commons")) return;
    var li_carrega = document.getElementById("t-upload");
    if (!li_carrega) return;
    var afegit = li_carrega.nextSibling;
    var ul_eines = li_carrega.parentNode;
    var li = document.createElement("li");
    li.id = "carrega-para-commons";
    li.innerHTML = '<a href="http://commons.wikimedia.org/wiki/Commons:Upload/it">Carica su Commons</a>';
    if (afegit) ul_eines.insertBefore(li, afegit);
    else ul_eines.appendChild(li);
}

addLoadEvent(linkUploadToCommons);

/*** Fine del collegamento diretto alla pagina di upload di Commons */

Ovviamente, come spiegato nel capitolo dedicato, nel Local Settings dovrete anche aggiungere:

$wgForeignFileRepos[] = array(
   'class'                   => 'ForeignAPIRepo',
   'name'                    => 'shared',
   'apibase'                 => 'http://commons.wikimedia.org/w/api.php',
   'fetchDescription'        => true, // Optional
   'descriptionCacheExpiry'  => 43200, // 12 hours, optional (values are seconds)
   'apiThumbCacheExpiry'     => 43200, // 12 hours, optional, but required for local thumb caching
);

Una variante dei dati di default, potrebbe essere questa:

   'name'                    => 'shared',
   'hashLevels'              => '2',
   'hasSharedCache'          => $wgCacheSharedUploads, 
   'descriptionCacheExpiry'  => 604800, // hours, (values are seconds)
   'apiThumbCacheExpiry'     => 86400000, // hours, optional, but required for local thumb caching

Approfondimento

Per approfondire, vedi Local Settings: Collegamento "Carica su Commons".

Come aggiungere un diverso "Contenitore d'immagini" esterno

Si possono anche aggiungere "altri siti" diversi da commons.

Per esempio, per le immagini da it.wiki, aggiungere al Local Settings.php:

$wgForeignFileRepos[] = array(
   'class'            => 'ForeignAPIRepo',
   'name'             => 'sharedwp',
   'apibase'          => 'http://it.wikipedia.org/w/api.php',
   'fetchDescription' => true, // Optional
   'descriptionCacheExpiry'  => 43200, // 12 ore, opzionale (valori in secondi)
   'apiThumbCacheExpiry'     => 43200, // 12 ore, opzionale, ma richiesto per la cache di thumb locale
);

Similmente, si può fare per altri siti che svolgono un servizio simile, se si conosce la loro root corretta per l'apibase.


Approfondimenti

Come mettere i Collegamenti interlingua, e ad altri wiki (interwiki)

Si parla di interwiki quando, in un wiki, si collegano all'interno di un articolo, delle parole ad un altro articolo presente su di un altro wiki; e, si parla di collegamenti interlingua, quando, questi interlink", corrispondono a dei wiki stranieri che, generalmente, fanno parte di uno stesso "progetto" comune e traducono il proprio principale.

Gli "interlink", sono presenti solo all'interno delle voci; mentre, i collegamenti interlingua, si ritrovano sulla barra laterale sinistra, in fondo. Qui di seguito spiegheremo, come utilizzare questi "collegamenti" a sinistra per "gemellare" più wiki assieme, non necesariamente per la traduzione della lingua, e ..non necessariamente facenti parte di uno stesso "progetto".

Creare le Tabelle

Se volete che nella vostra Barra Laterale sinistra siano presenti i collegamenti alle varie versioni linguistiche internazionali di wikipedia, gemellandovi per così dire con essa, bisogna modificare il database.

Prima di tutto si individua il file che vi interessa: nella cartella /maintenance/, dove è installato MediaWiki,

  • il file interwiki.sql contiene gli interwiki utilizzati sui progetti della Wikimedia Foundation;
  • il file wikipedia-interwiki.sql contiene i collegamenti verso le versioni di Wikipedia nelle varie lingue;
  • il file wiktionary-interwiki.sql contiene i collegamenti verso le versioni di Wikizionario nelle varie lingue.

Gli ultimi due utilizzano uno stesso insieme di prefissi (i prefissi linguistici del gruppo ISO-639), pertanto non sono compatibili tra loro (ciascuno sovrascrive l'altro).

Per impostare gli interwiki, si eseguono le query SQL contenute in questi file. Il modo più semplice per farlo è usare il pannello di controllo del database (per es. phpMyAdmin) e copiare il testo del file interessato.

Se invece volete, personalizzare e creare da voi le Tabelle ad altri progetti wiki, nel senso che, non ve ne frega niente di "gemellarvi" con wikipedia, allora potete anche saltare questo primo passaggio, e andare subito a modificarle e crearle avvalendovi dell'estensione "Special interwiki".

Modificare il file "Names.php"

Dopodichè, per fare apparire i collegamenti che avete appena creato appunto sulla barra laterale, dovrete agire sul file "Names.php", che trovate dentro la cartella /Languages/ (nella root del vostro wiki). Per cambiarne i prefissi, e mettere e organizzare nella barra laterale sinistra solo quelli corrispondenti ai nostri bisogni, invece che lasciare quelli per la lingua.

Successivamente, non dovremmo fare altro che mantenere aggiornato il file Names.php, con soli quei prefissi che vorremmo avere a sinistra, come interlink, scartando gli altri.


Ovviamente, bisogna agire sulle 'Tabelle' per far corrispondere un 'prefisso' con il collegamento Url, del sito che vogliamo associarvici.

Ecco perché, viene molto utile a questo scopo l'estensione Interwiki, che oltre ad aiutarci a creare i prefissi senza dover andar a toccare le Tabelle tramite pannello PhAdmin, ce ne offre anche una vista d'insieme che aiuta a non farci dimenticare i prefissi creati ed associati.

Cambiare il messaggio: "Altre Lingue"

Infine, per cambiare il messaggio "Altre Lingue" (che si trova di Default, sulla Barra Laterale sinistra) si agisce sul file Monobook.php, che trovate dentro alla cartella "/Skin/" (sempre nella root d'installazione del vostro wiki).

Code

Per approfondire, vedi mw:Manual:Skinning#Interlanguage_Links.

Dentro al File Monobook.php, cercate questo pezzo di codice:

--------------------------------------------------------------------
	function languageBox() {
		if( $this->data['language_urls'] ) {
?>
	<div id="p-lang" class="portlet">
		<h5><?php $this->msg('jumpto') ?></h5>
		<div class="pBody">
			<ul>
<?php		foreach($this->data['language_urls'] as $langlink) { ?>
				<li class="<?php echo htmlspecialchars($langlink['class'])?>"><?php
				?><a href="<?php echo htmlspecialchars($langlink['href']) ?>"><?php echo $langlink['text'] ?></a></li>
<?php		} ?>
			</ul>
		</div>
	</div>
<?php
		}
	}
-------------------------------------------------------------------

e andate a modificare la scritta dentro le parentesi ('otherlanguages'), appena dopo 'MSG', qui cambiata per 'JUMPTO'. Il risultato sarà che, al posto di "Altre Lingue", vi ritroverete sulla barra laterale un generico "VAI A".

Fonti di riferimento su MediaWiki