Template:APT-mirror: differenze tra le versioni
mNessun oggetto della modifica |
m (rimossa parte inutile nella descrizione sull'utilizzo) |
||
(6 versioni intermedie di uno stesso utente non sono mostrate) | |||
Riga 1: | Riga 1: | ||
<includeonly>{{ | <includeonly>{{ | ||
<!-- | |||
NOTA IN CASO DI CAMBIAMENTI: | |||
Affinché le modifiche siano visibili anche nella sezione di esempio di questa stessa pagina, | |||
è necessario salvare la pagina una seconda volta, dopo aver effettuato le modifiche. | |||
--> | |||
#switch: {{{1|}}} | #switch: {{{1|}}} | ||
| redirector = <nowiki>http:// | <!-- | ||
L'uso di "|" dopo il parametro e prima di "=" rende "redirector" il mirror di default. | |||
Per cambiarlo rimuovere "|" e aggiungerlo a un'altra voce, modificando in modo opportuno | |||
anche la voce "descrizione" e gli esempi. | |||
--> | |||
| redirector | = <nowiki>http://deb.debian.org/debian/</nowiki> | |||
<!-- deve descrivere il default utilizzato (di solito segue immediatamente la parola "mirror") --> | |||
| descrizione = HTTP redirector | |||
<!-- inserire qui altre possibilità, modificando anche la sintassi degli esempi --> | |||
| main = <nowiki>http://ftp.debian.org/debian/</nowiki> | | main = <nowiki>http://ftp.debian.org/debian/</nowiki> | ||
| it = <nowiki>http://ftp.it.debian.org/debian/</nowiki> | |||
| security = <nowiki>http://security.debian.org/debian-security</nowiki> | |||
| fastweb = <nowiki>http://mi.mirror.garr.it/mirrors/debian/</nowiki> | | fastweb = <nowiki>http://mi.mirror.garr.it/mirrors/debian/</nowiki> | ||
| | |||
| < | <!-- errore, per argomenti non validi --> | ||
| <br/><br/>'''ERRORE: parametro non valido nel [[Template:APT-mirror|template APT-mirror]]!'''<br/><br/> | |||
}}</includeonly><noinclude>__NOTOC__ | }}</includeonly><noinclude>__NOTOC__ | ||
Questo template può stampare uno dei [[mirror]] ufficiali di Debian, in modo da garantirne la correttezza e una scelta consistente in tutte le guide che lo includono. | Questo template può stampare uno dei [[mirror]] ufficiali di Debian, in modo da garantirne la correttezza e una scelta consistente in tutte le guide che lo includono. | ||
Inoltre, si dovesse cambiare scelta in futuro, sarà possibile modificare tutte le guide, agendo soltanto su questa pagina. | Inoltre, si dovesse cambiare scelta in futuro, sarà possibile modificare tutte le guide, agendo soltanto su questa pagina. | ||
È da utilizzarsi '''esclusivamente''' per pagine di glossario, oppure per guide su software di sistema molto generali e [[Template:Versioni compatibili|compatibili per tutte le versioni]]. | |||
== Sintassi accettata == | == Sintassi accettata == | ||
<pre> | <pre> | ||
{{APT-mirror[| | {{APT-mirror[|redirector|descrizione|main|it|security|fastweb]}} | ||
</pre> | </pre> | ||
=== Esempi === | === Esempi === | ||
<pre> | |||
{{APT-mirror|redirector}} | |||
</pre> | |||
stampa: | |||
{{APT-mirror|redirector}} | |||
Si noti che '''redirector''' è attualmente la scelta di default, anche in assenza di parametri, ma se la guida che include questo template richiama esplicitamente il redirector, è meglio specificare tale parametro, in modo che resti consistente anche se in futuro si scegliesse un altro mirror di default (a meno di usare anche <nowiki>{{APT-mirror|descrizione}}</nowiki> per richiamarlo nella guida). | |||
<pre> | <pre> | ||
{{APT-mirror|it}} | {{APT-mirror|it}} | ||
{{APT-mirror|main}} | |||
{{APT-mirror|security}} | |||
{{APT-mirror|fastweb}} | |||
</pre> | </pre> | ||
stampano rispettivamente: | |||
{{APT-mirror|it}} | {{APT-mirror|it}} | ||
{{APT-mirror|main}} | |||
{{APT-mirror|security}} | |||
{{APT-mirror|fastweb}} | |||
In alternativa, per stampare il mirror di default: | |||
<pre> | <pre> | ||
{{APT-mirror|redirector}} | {{APT-mirror}} | ||
</pre> | |||
che al momento stamperà: | |||
{{APT-mirror}} | |||
E si può ottenerne una descrizione con <code><nowiki>{{APT-mirror|descrizione}}</nowiki></code> (preferibilmente da usarsi dopo la parola "mirror"), che restituirà: {{APT-mirror|descrizione}}. | |||
Quindi per esempio si può scrivere in una guida: | |||
<pre> | |||
Il mirror di default è: {{APT-mirror|redirector}} (mirror {{APT-mirror|descrizione}}), ... | |||
</pre> | </pre> | ||
che stamperà: | |||
{{APT-mirror|redirector}} | Il mirror di default è: {{APT-mirror|redirector}} (mirror {{APT-mirror|descrizione}}), ... | ||
[[Categoria:Template]]</noinclude> | [[Categoria:Template]]</noinclude> |
Versione attuale delle 15:59, 7 set 2019
Questo template può stampare uno dei mirror ufficiali di Debian, in modo da garantirne la correttezza e una scelta consistente in tutte le guide che lo includono.
Inoltre, si dovesse cambiare scelta in futuro, sarà possibile modificare tutte le guide, agendo soltanto su questa pagina.
È da utilizzarsi esclusivamente per pagine di glossario, oppure per guide su software di sistema molto generali e compatibili per tutte le versioni.
Sintassi accettata
{{APT-mirror[|redirector|descrizione|main|it|security|fastweb]}}
Esempi
{{APT-mirror|redirector}}
stampa:
http://deb.debian.org/debian/
Si noti che redirector è attualmente la scelta di default, anche in assenza di parametri, ma se la guida che include questo template richiama esplicitamente il redirector, è meglio specificare tale parametro, in modo che resti consistente anche se in futuro si scegliesse un altro mirror di default (a meno di usare anche {{APT-mirror|descrizione}} per richiamarlo nella guida).
{{APT-mirror|it}} {{APT-mirror|main}} {{APT-mirror|security}} {{APT-mirror|fastweb}}
stampano rispettivamente:
http://ftp.it.debian.org/debian/ http://ftp.debian.org/debian/ http://security.debian.org/debian-security http://mi.mirror.garr.it/mirrors/debian/
In alternativa, per stampare il mirror di default:
{{APT-mirror}}
che al momento stamperà:
http://deb.debian.org/debian/
E si può ottenerne una descrizione con {{APT-mirror|descrizione}}
(preferibilmente da usarsi dopo la parola "mirror"), che restituirà: HTTP redirector.
Quindi per esempio si può scrivere in una guida:
Il mirror di default è: {{APT-mirror|redirector}} (mirror {{APT-mirror|descrizione}}), ...
che stamperà:
Il mirror di default è: http://deb.debian.org/debian/ (mirror HTTP redirector), ...