Utente:Codicorumus/Template:Avviso esempio

Questo template, che deve sempre essere substato, inserisce nel wikicode un commento che correla le pagine di esempio con quelle in cui gli esempi sono adoperati, in modo da preservarne la validità in caso di cambiamenti nelle une o nelle altre.

Inoltre inserisce la pagina nella appropriata categoria che permette di seguire l'utilizzo del template, benché substato, e di fare manutenzione degli esempi. Rispettivamente :

• Categoria:Avvisi esempio in pagina d'aiuto
• Categoria:Avvisi esempio in pagina d'esempio

Quando {{Avviso esempio}} non viene substato, il template {{Verifica subst}} inserisce la pagina in una categoria di manutenzione.

Parametri

aiuto/esempio

Può avere i valori "aiuto" o "esempio", a seconda che si tratti dell'avviso nella pagina di aiuto o in quella di esempio. Non indicarlo o non dargli il valore "aiuto" equivale ad indicare "esempio".

pagina

pagine

Vanno usati per indicare la pagina o le pagine correlate a quella corrente.

Nelle pagine di aiuto la forma singolare o plurale produce nel testo la corretta concordanza di numero.

Nelle pagine di esempio i due parametri sono equivalenti.

riferimento

Nelle pagine d'aiuto, indica il riferimento con cui queste sono citate nel commento in pagina d'esempio (col parametro pagina).

Nelle pagine d'esempio non è usato.

descrizione

Nelle pagine d'esempio, imposta il testo descrittivo con cui inizia il primo punto del commento, che si chiude con in {{{pagina}}}.

Nelle pagine d'aiuto non è usato.

altro

Questo parametro permette di aggiungere del testo opzionale in coda al commento, prima della data di inserimento.

Esempi di utilizzo

In pagina d'aiuto

{{subst:Avviso esempio
|aiuto/esempio = aiuto
|pagine = [[Adige]] e [[l'Adige]]
|riferimento = [[Aiuto:Disambigua#Tipi di disambiguazione]] (§B.B1)
}}

produce

<!--
## ATTENZIONE ##
* In [[Adige]] e [[l'Adige]] sono presenti dei commenti che rimandano qui con il riferimento "[[Aiuto:Disambigua#Tipi di disambiguazione]] (§B.B1)".
* Se cambi o togli l'esempio: elimina quei commenti e la categoria [[Categoria:Avvisi esempio in pagina d'esempio]] immediatamente successiva; se l'esempio rimanda a più pagine, cancella solo il riferimento a questa pagina.
* Se sposti l'esempio: modifica il riferimento in quei commenti.
----
Inserito il 28 mar 2012, 15:25:49, substando [[Template:Avviso esempio]].
-->[[Categoria:Avvisi esempio in pagina d'aiuto]]

In pagina d'esempio

{{subst:Avviso esempio
|aiuto/esempio = esempio
|pagina = [[Aiuto:Disambigua#Tipi di disambiguazione]] (§B.B1)
|descrizione = Questa nota disambigua è usata come
}}

produce

<!--

## ATTENZIONE ##
* Questa nota disambigua è usata come esempio in [[Aiuto:Disambigua#Tipi di disambiguazione]] (§B.B1).
* Se fai delle modifiche: verifica che l'esempio resti valido, oppure sostituiscilo con un altro.
----
Inserito il 28 mar 2012, 15:25:49, substando [[Template:Avviso esempio]].
-->[[Categoria:Avvisi esempio in pagina d'esempio]]

Avvertenze per la modifica

L'#ifeq posto all'inizio permette di verificare se il template viene substato o meno. Nel primo caso viene inserito nel wikicode il testo con il commento che correla la pagina d'aiuto e quella di esempio. Nel secondo caso, invece, viene mostrato in pagina un avviso di mancanza del subst. Il codice del template non ammette l'uso dei commenti nella parte che contiene il testo del commento correlante.