Template:Versioni compatibili: differenze tra le versioni

Da Guide@Debianizzati.Org.
Vai alla navigazione Vai alla ricerca
mNessun oggetto della modifica
(task di Revisione Wiki #53, #54, #58 e #61 + parametri case-insensitive + rimozione di quasi tutte le categorie nascoste)
 
(23 versioni intermedie di 2 utenti non mostrate)
Riga 1: Riga 1:
<includeonly>
<includeonly>{{ <!-- ignora maiuscole/minuscole (uc rende tutto maiuscolo) -->
{|style="border-radius: 0.5em; width:250px; float:right; clear:both; margin-bottom:10px; text-align:center; font-variant:small-caps; background:#f8fbfd; border:1px solid #4e88d0; padding-bottom:5px"
  #switch: {{uc: {{{1|}}} }}
|[[Image:Debian-swirl.png|33px|link=]]'''Versioni Compatibili'''{{
  <!-- *DEPRECATO* (senza argomenti) per guide ancora contrassegnate come compatibili per tutte le versioni -->
    #ifeq: {{{1|}}} | ONLY | <br />'''soltanto:''' | }}{{
  |               = {{Versioni_compatibili_Supporto_-_riquadro | versione=TUTTE }} [[Category:Guide compatibili con tutte le versioni di Debian]]
#if: {{{1|}}} | {{Versioni compatibili elenco|{{{1}}}}}{{
  <!-- per nuove guide compatibili per tutte le versioni -->
#if: {{{2|}}} | {{Versioni compatibili elenco|{{{2}}}}}
  | TUTTE        = {{Versioni_compatibili_Supporto_-_tutte_le_versioni
}}{{
                      | <!-- flag speciale --> {{{2|}}} | {{{3|}}} | {{{4|}}} | {{{5|}}} | {{{6|}}} | {{{7|}}} | {{{8|}}} | {{{9|}}}
#if: {{{3|}}} | {{Versioni compatibili elenco|{{{3}}}}}
                    }}
}}{{
  <!-- flag: ONLY segnala la *non* compatibilità per versioni più recenti; FEATURED allunga la compatibilità; NO_REVISION salta il prossimo controllo -->
#if: {{{4|}}} | {{Versioni compatibili elenco|{{{4}}}}}
  | ONLY
}}{{
  | FEATURED
#if: {{{5|}}} | {{Versioni compatibili elenco|{{{5}}}}}
  | NO_REVISION  = {{Versioni_compatibili_Supporto_-_elenco_versioni
}}{{
                      | {{{1|}}} <!--flag--> | {{{2|}}} | {{{3|}}} | {{{4|}}} | {{{5|}}} | {{{6|}}} | {{{7|}}} | {{{8|}}} | {{{9|}}}
#if: {{{6|}}} | <br />ERRORE: Consentiti fino a 5 parametri! [[Categoria: Errori nel template Versioni compatibili]] |
                    }}
}} | <br />Tutte le versioni supportate di Debian [[Categoria: Guide compatibili con tutte le versioni di Debian]] }}{{
  <!-- uso standard (con uso delle informazioni inserite manualmente) -->
#ifeq: {{{1|}}} | ONLY |  | {{
  | <!--default --> {{Versioni_compatibili_Supporto_-_elenco_versioni
  #switch: {{Codename|Oldstable}} | {{{1|}}} | {{{2|}}} | {{{3|}}} | {{{4|}}} | {{{5|}}} = {{
                      | STANDARD  | {{{1|}}} | {{{2|}}} | {{{3|}}} | {{{4|}}} | {{{5|}}} | {{{6|}}} | {{{7|}}} | {{{8|}}} | {{{9|}}}
      #switch: {{Codename|Stable}} | {{{1|}}} | {{{2|}}} | {{{3|}}} | {{{4|}}} | {{{5|}}} =
                    }}
      | <br />[[:Categoria:Guide non compatibili con stable|Verificala con {{Codename|Stable}}]] [[Categoria: Guide non compatibili con stable]]  }}
}}</includeonly><noinclude>
}}
}}
|}</includeonly><noinclude>__NOTOC__
== Introduzione ==
== Introduzione ==
Questo template permette di segnalare le versioni di Debian compatibili con una guida, e il suo uso è obbligatorio per tutte le guide relative a questo sistema operativo. È preferibile che le versioni elencate siano solo quelle per cui la guida è stata esplicitamente testata, o in alternativa che contengono le stesse versioni dei [[pacchetto|pacchetti]] trattati.
Questo template permette di segnalare le versioni di Debian compatibili con una guida, e il suo uso è obbligatorio per tutte le guide relative a questo sistema operativo. È preferibile che le versioni elencate siano solo quelle per cui la guida è stata esplicitamente testata, o in alternativa che contengono le stesse versioni dei [[pacchetto|pacchetti]] trattati.
Riga 28: Riga 25:
== Uso ==
== Uso ==
=== Parametri ===
=== Parametri ===
{{Versioni compatibili|{{Codename|Oldstable}}|{{Codename|Stable}}}}
{|style="float:right; clear:both; width:23%; min-width:133px; margin:0 0 10px 8px; padding-bottom:5px; border-radius:0.5em; border:1px solid #4e88d0; background-color:#f8fbfd; text-align:center;"
|[[Image:Debian-swirl.png|33px|link=]] <span style="font-variant:small-caps;">'''Versioni Compatibili'''</span> <br/> {{Versioni compatibili Supporto - voce|{{Codename|oldstable|IN_TEMPLATE}}}} {{Versioni compatibili Supporto - voce|{{Codename|stable|IN_TEMPLATE}}}}
|}
Aggiungere un parametro per ogni versione compatibile, separati tra loro da un carattere "|". Il nome da inserire è il [[codename]] di Debian, ovvero il nome del personaggio di Toy Story a cui la versione specifica è dedicata. La lista completa è riportata in seguito.
Aggiungere un parametro per ogni versione compatibile, separati tra loro da un carattere "|". Il nome da inserire è il [[codename]] di Debian, ovvero il nome del personaggio di Toy Story a cui la versione specifica è dedicata. La lista completa è riportata in seguito.


Si noti che tutti i pacchetti presenti in [[testing]] e [[unstable]] possono ricevere aggiornamenti che ne alterano le funzionalità, oppure essere rimossi durante la fase di [[freeze]] o prima ancora, motivo per cui in questo template si è scelto di prediligere la compatibilità per l'attuale [[stable]] e versioni precedenti di Debian. Per garantire in futuro che tutte le guide verificate per "{{Codename|Testing}}" siano testate per quella che sarà la versione ''stable'' rilasciata, si riservano i [[codename]] per le sole versioni ''stable'' e precedenti di Debian, mentre per le più recenti si utilizzano la [[suite]] e l'anno di verifica.
Si noti che tutti i pacchetti presenti in [[testing]] e [[unstable]] possono ricevere aggiornamenti che ne alterano le funzionalità, oppure essere rimossi durante la fase di [[freeze]] o prima ancora, motivo per cui in questo template si è scelto di prediligere la compatibilità per l'attuale [[stable]] e versioni precedenti di Debian. Per garantire in futuro che tutte le guide verificate per "{{Codename|Testing}}" siano testate per quella che sarà la versione ''stable'' rilasciata, si riservano i [[codename]] per le sole versioni ''stable'' e precedenti di Debian, mentre per le più recenti si utilizzano la [[suite]] e l'ultimo anno di verifica.


Per esempio:
Per esempio:
  <nowiki>{{Versioni compatibili|</nowiki>{{Codename|Oldstable}}<nowiki>|</nowiki>{{Codename|Stable}}<nowiki>}}</nowiki>
  <nowiki>{{Versioni compatibili|</nowiki>{{Codename|oldstable}}<nowiki>|</nowiki>{{Codename|Stable}}<nowiki>}}</nowiki>


Oppure con {{Codename|Stable}}, testing ({{Codename|Testing}}) e unstable/Sid:
Oppure con {{Codename|Stable}}, testing ({{Codename|testing}}) e unstable/sid:
  <nowiki>{{Versioni compatibili|</nowiki>{{Codename|Stable}}<nowiki>|Testing_</nowiki>{{CURRENTYEAR}}<nowiki>|Unstable_</nowiki>{{CURRENTYEAR}}<nowiki>}}</nowiki>
  <nowiki>{{Versioni compatibili|</nowiki>{{Codename|stable}}<nowiki>|testing_</nowiki>{{CURRENTYEAR}}<nowiki>|unstable_</nowiki>{{CURRENTYEAR}}<nowiki>}}</nowiki>


'''Numero massimo di parametri''': 5
'''Numero massimo di parametri''': 5


'''Codename ammessi''' (per Debian [[stable]] e precedenti):
'''Codename ammessi''' (per Debian [[stable]] e precedenti):
*Woody
*woody
*...
*...
*{{Codename|Obsoleta}}
*{{Codename|obsoleta}}
*{{Codename|Oldoldstable}}
*{{Codename|oldoldstable}}
*{{Codename|Oldstable}}
*{{Codename|oldstable}}
*{{Codename|Stable}}
*{{Codename|stable}}


'''Suite ammesse''' (per [[testing]] e [[Sid]]):
'''Suite ammesse''' (per [[testing]] e [[sid]]):
*Testing_{{CURRENTYEAR}}, Testing_({{CURRENTYEAR}}+1), ... (per "{{Codename|Testing}}", finché sarà testing)
*testing_{{#expr: {{CURRENTYEAR}} - 1}}, testing_{{CURRENTYEAR}}, testing_{{#expr: {{CURRENTYEAR}} + 1}}, ... (per "{{Codename|testing}}", finché sarà testing)
*Unstable_{{CURRENTYEAR}}, Unstable_({{CURRENTYEAR}}+1), ... (per "Sid")
*unstable_{{#expr: {{CURRENTYEAR}} - 1}}, unstable_{{CURRENTYEAR}}, unstable_{{#expr: {{CURRENTYEAR}} + 1}}, ... (per "sid")


Se si supera il numero massimo di parametri ammessi, è possibile rimuovere le versioni non più supportate. Mentre, per indicare la compatibilità con tutte le cinque versioni supportate di Debian, l'unica possibilità è utilizzare il template senza parametri, come nella sezione sul [[#Nessun parametro|template senza parametri]].
Se si supera il numero massimo di parametri ammessi, è possibile rimuovere le versioni non più supportate. Essendo permessi fino a 6 parametri, è sempre possibile indicare la compatibilità per le attuali [[LTS]], [[oldstable]], [[stable]], [[testing]] e [[unstable]]/[[sid]].


I parametri del template inoltre devono essere ordinati per versione, partendo dalla meno recente (ordine crescente).
Per testing e unstable, si deve utilizzare sempre soltanto un singolo parametro, quello relativo all'ultimo anno di revisione, aggiornandolo quando si effettua una nuova revisione per la stessa versione o rimuovendolo se si considera ormai obsoleta.
 
I parametri del template inoltre devono essere ordinati per versione, partendo dalla meno recente (ordine crescente). Non sono case-sensitive (e quindi maiuscole/minuscole sono ignorate).


==== Non compatibilità ====
==== Non compatibilità ====
{{Versioni compatibili|ONLY|{{Codename|Oldstable}}}}
{|style="float:right; clear:both; width:23%; min-width:133px; margin:0 0 10px 8px; padding-bottom:5px; border-radius:0.5em; border:1px solid #4e88d0; background-color:#f8fbfd; text-align:center;"
|[[Image:Debian-swirl.png|33px|link=]] <span style="font-variant:small-caps;">'''Versioni Compatibili''' <br /><br/> '''soltanto:'''</span> {{Versioni compatibili Supporto - voce|{{Codename|oldstable|IN_TEMPLATE}}}}
|}


Utilizzando la stringa <code>ONLY</code> come primo parametro, è possibile utilizzare questo template per segnalare che soltanto le versioni esplicitamente elencate con i parametri successivi sono supportate.
Utilizzando la stringa <code>ONLY</code> come primo parametro, è possibile utilizzare questo template per segnalare che soltanto le versioni esplicitamente elencate con i parametri successivi sono supportate.


Si consideri che il limite di quattro parametri è ancora valido, e pertanto soltanto altri tre parametri sono possibili, scegliendoli tra gli stessi ammessi nella sezione precedente.
Si consideri che il limite di cinque parametri è ancora valido, e pertanto soltanto altri quattro parametri sono possibili, scegliendoli tra gli stessi ammessi nella sezione precedente.


Tali guide, quando contengono soltanto l'attuale [[oldstable]], saranno anche rimosse dall'elenco di quelle da verificare con la versione [[stable]] corrente di Debian.
Tali guide, quando contengono soltanto l'attuale [[oldstable]], saranno anche rimosse dall'elenco di quelle da verificare con la versione [[stable]] corrente di Debian.


Per esempio:
Per esempio:
  <nowiki>{{Versioni compatibili|ONLY|</nowiki>{{Codename|Oldstable}}<nowiki>}}</nowiki>
  <nowiki>{{Versioni compatibili|ONLY|</nowiki>{{Codename|oldstable}}<nowiki>}}</nowiki>


Inoltre una guida segnalata esplicitamente come non compatibile per altre versioni può diventare obsoleta, ma non da controllare o da adottare.
Inoltre una guida segnalata esplicitamente come non compatibile per altre versioni può diventare obsoleta, ma non da controllare o da adottare.


=== Nessun parametro ===
=== Nessun parametro ===
{{Versioni compatibili}}
{|style="float:right; clear:both; width:23%; min-width:133px; margin:0 0 10px 8px; padding-bottom:5px; border-radius:0.5em; border:1px solid #4e88d0; background-color:#f8fbfd; font-variant:small-caps; text-align:center;"
Se non vengono aggiunti parametri, la guida è compatibile con tutte le versioni supportate di Debian.
|[[Image:Debian-swirl.png|33px|link=]] '''Versioni Compatibili''' <br /><br /> Tutte le versioni supportate di Debian
 
|}
Per "versioni supportate" si intendono tutte le seguenti: [[LTS]], [[oldstable]], [[stable]], [[testing]] e [[Sid]].
Se non vengono aggiunti parametri, la guida è compatibile con tutte le versioni supportate di Debian. '''<u>Questa forma è deprecata!</u>''' È mantenuta solo temporaneamente per retrocompatibilità. [[:Categoria:Guide compatibili con tutte le versioni di Debian|Qui]] l'elenco completo, in attesa di verificarle nuovamente e utilizzare i [[Template:Versioni_compatibili_Supporto_-_tutte_le_versioni|flag di revisione]].


È pertanto '''sconsigliata''' questa forma, salvo si tratti di pacchetti base del sistema (Priorità del pacchetto: ''required'', ''important'' o ''standard'') oppure di cui si garantisce l'impegno a continuare a verificarne la compatibilità.
Per "versioni supportate" si intendono tutte le seguenti: [[LTS]], [[oldstable]], [[stable]], [[testing]] e [[unstable]]/[[sid]].


Per esempio:
Per esempio:
  <nowiki>{{Versioni compatibili}}</nowiki>
  <nowiki>{{Versioni compatibili}}</nowiki>


Le guide che utilizzano questo template senza parametri per pacchetti opzionali del sistema, se non ricevono verifiche e non sono più aggiornate, sono in genere modificate al momento del rilascio della nuova stable con l'aggiunta delle sole versioni precedenti.
'''Limitatamente''' per le guide segnalate come compatibili per tutte le versioni, allo scopo di evitare di doverle aggiornare a ogni nuovo rilascio di Debian in caso si faccia riferimento ai [[codename]] dell'attuale [[stable]], [[testing]], ecc... e si debbano modificare solo quelli, oppure se si voglia utilizzare sempre l'attuale [[mirror]] di default per i [[repository]], sono disponibili due template di supporto:
* [[Template:Codename]]
* [[Template:APT-mirror]]
Ciò ne consentirà un aggiornamento automatico, limitatamente alle informazioni ottenute dai template.


== Errori ==
Per finire le guide contenenti errori con questo template sono rintracciabili in [[:Categoria:Errori nel template Versioni compatibili|questa categoria]].
Le guide contenenti errori con questo template sono rintracciabili in [[:Categoria:Errori nel template Versioni compatibili|questa categoria]].


[[Categoria:Template]]
[[Categoria:Template]]
</noinclude>
</noinclude>

Versione attuale delle 16:29, 6 mar 2021

Introduzione

Questo template permette di segnalare le versioni di Debian compatibili con una guida, e il suo uso è obbligatorio per tutte le guide relative a questo sistema operativo. È preferibile che le versioni elencate siano solo quelle per cui la guida è stata esplicitamente testata, o in alternativa che contengono le stesse versioni dei pacchetti trattati.

Per le guide divise in più pagine è raccomandata l'inclusione del template soltanto nella principale.

Uso

Parametri

Debian-swirl.png Versioni Compatibili

Debian 11 "bullseye"
Debian 12 "bookworm"

Aggiungere un parametro per ogni versione compatibile, separati tra loro da un carattere "|". Il nome da inserire è il codename di Debian, ovvero il nome del personaggio di Toy Story a cui la versione specifica è dedicata. La lista completa è riportata in seguito.

Si noti che tutti i pacchetti presenti in testing e unstable possono ricevere aggiornamenti che ne alterano le funzionalità, oppure essere rimossi durante la fase di freeze o prima ancora, motivo per cui in questo template si è scelto di prediligere la compatibilità per l'attuale stable e versioni precedenti di Debian. Per garantire in futuro che tutte le guide verificate per "trixie" siano testate per quella che sarà la versione stable rilasciata, si riservano i codename per le sole versioni stable e precedenti di Debian, mentre per le più recenti si utilizzano la suite e l'ultimo anno di verifica.

Per esempio:

{{Versioni compatibili|bullseye|bookworm}}

Oppure con bookworm, testing (trixie) e unstable/sid:

{{Versioni compatibili|bookworm|testing_2024|unstable_2024}}

Numero massimo di parametri: 5

Codename ammessi (per Debian stable e precedenti):

  • woody
  • ...
  • stretch
  • buster
  • bullseye
  • bookworm

Suite ammesse (per testing e sid):

  • testing_2023, testing_2024, testing_2025, ... (per "trixie", finché sarà testing)
  • unstable_2023, unstable_2024, unstable_2025, ... (per "sid")

Se si supera il numero massimo di parametri ammessi, è possibile rimuovere le versioni non più supportate. Essendo permessi fino a 6 parametri, è sempre possibile indicare la compatibilità per le attuali LTS, oldstable, stable, testing e unstable/sid.

Per testing e unstable, si deve utilizzare sempre soltanto un singolo parametro, quello relativo all'ultimo anno di revisione, aggiornandolo quando si effettua una nuova revisione per la stessa versione o rimuovendolo se si considera ormai obsoleta.

I parametri del template inoltre devono essere ordinati per versione, partendo dalla meno recente (ordine crescente). Non sono case-sensitive (e quindi maiuscole/minuscole sono ignorate).

Non compatibilità

Debian-swirl.png Versioni Compatibili

soltanto:

Debian 11 "bullseye"

Utilizzando la stringa ONLY come primo parametro, è possibile utilizzare questo template per segnalare che soltanto le versioni esplicitamente elencate con i parametri successivi sono supportate.

Si consideri che il limite di cinque parametri è ancora valido, e pertanto soltanto altri quattro parametri sono possibili, scegliendoli tra gli stessi ammessi nella sezione precedente.

Tali guide, quando contengono soltanto l'attuale oldstable, saranno anche rimosse dall'elenco di quelle da verificare con la versione stable corrente di Debian.

Per esempio:

{{Versioni compatibili|ONLY|bullseye}}

Inoltre una guida segnalata esplicitamente come non compatibile per altre versioni può diventare obsoleta, ma non da controllare o da adottare.

Nessun parametro

Debian-swirl.png Versioni Compatibili

Tutte le versioni supportate di Debian

Se non vengono aggiunti parametri, la guida è compatibile con tutte le versioni supportate di Debian. Questa forma è deprecata! È mantenuta solo temporaneamente per retrocompatibilità. Qui l'elenco completo, in attesa di verificarle nuovamente e utilizzare i flag di revisione.

Per "versioni supportate" si intendono tutte le seguenti: LTS, oldstable, stable, testing e unstable/sid.

Per esempio:

{{Versioni compatibili}}

Limitatamente per le guide segnalate come compatibili per tutte le versioni, allo scopo di evitare di doverle aggiornare a ogni nuovo rilascio di Debian in caso si faccia riferimento ai codename dell'attuale stable, testing, ecc... e si debbano modificare solo quelli, oppure se si voglia utilizzare sempre l'attuale mirror di default per i repository, sono disponibili due template di supporto:

Ciò ne consentirà un aggiornamento automatico, limitatamente alle informazioni ottenute dai template.

Per finire le guide contenenti errori con questo template sono rintracciabili in questa categoria.