Aiuto:Fasi di sviluppo: differenze tra le versioni

Wikibooks, manuali e libri di testo liberi.
Contenuto cancellato Contenuto aggiunto
Ramac (discussione | contributi)
m fix
Ramac (discussione | contributi)
sistemo!!
Riga 1: Riga 1:
{{TOCright Aiuto}}
{{TOCright Aiuto}}
La '''fase di sviluppo''' indica il progresso di un libro o di un modulo, rivisto ad una certa data. Questo può aiutare a focalizzare l'attenzione del lettore su un libro comprensibile e abbastanza completo, e quella dell'autore ad un lavoro che richiede ancora aiuto. Inoltre risulta emotivamente deludente cliccare su un link blu e vedere che è praticamente vuoto, mentre con una indicazione prima la delusione è minore
La '''fase di sviluppo''' indica il progresso di un libro o di un modulo, valutato ad una certa data.
<br/>Questo può aiutare a focalizzare l'attenzione del lettore su un libro comprensibile e abbastanza completo, e quella dell'autore ad un lavoro che richiede ancora aiuto. Inoltre risulta emotivamente deludente cliccare su un link blu e vedere che è praticamente vuoto, mentre con una indicazione prima la delusione è minore.


==Fasi di sviluppo==
==Fasi di sviluppo==
L'icona della fase di sviluppo segue il titolo del libro (può essere utilizzato anche all'interno di un libro, per indicare lo sviluppo dei singoli capitoli) indica il livello di completezza di quel libro in accordo con le seguente scala:
L'icona della fase di sviluppo segue il titolo del libro (può essere utilizzato anche all'interno di un libro, per indicare lo sviluppo dei singoli capitoli) e indica il livello di completezza di quel libro in accordo con le seguente scala:
{{Fasi di sviluppo}}
{{Fasi di sviluppo}}
Una data in piccolo subito dopo indica la data in cui la fase di sviluppo è stata valutata per l'ultima volta da un utente di Wikibooks. Per esempio
Una data in piccolo subito dopo indica la data in cui la fase di sviluppo è stata valutata per l'ultima volta da un utente di Wikibooks. Per esempio
* {{libro|JavaScript}}
* ''Libro primo'' {{stage|50%|23 luglio 2005}}
:Cioè, questo libro è stato valutato come completo al 50% il 23 luglio 2005.
:Cioè, questo libro è stato valutato come completo al 100% il 25 dicembre 2005.


==Come indicare la fase di sviluppo==
==Come indicare la fase di sviluppo==
Anche tu puoi contribuire ad assegnare una fase di sviluppo ai libri che visiti. È facile, e di grande aiuto per i nuovi lettori, che così potranno trovare facilmente e in modo rapido i libri più completi di loro interesse.
Anche tu puoi contribuire ad assegnare una fase di sviluppo ai libri che visiti. È facile, e di grande aiuto per i nuovi lettori, che così potranno trovare facilmente e in modo rapido i libri più completi di loro interesse.


Per dare informazioni sullo stato di completamento del tuo libro e dei moduli e inserirlo automaticamente nella categoria relativa al suo stadio di sviluppo, è stato elaborato il [[Aiuto:template|template]] '''{{tl|avanzamento}}''' che va posto in fondo alla pagina dopo le categorie e gli interwiki in questo modo:
Puoi usare uno dei seguenti [[Aiuto:Template|template]]:


<nowiki>{{avanzamento|xx|''data''}}</nowiki>
* <code><nowiki>{{Stage|25%|23 luglio 2005}}</nowiki></code> crea l'icona della fase con vicino una data in piccolo: {{Stage|25%|23 luglio 2005}}
: (cliccando sulla data sarai indirizzato a questa stessa pagina);


Una volta inserito il tempate {{tl|avanzamento}} nella pagina questo sarà automaticamente utilizzato per la generazione dei link (usando i template {{tl|modulo}} e {{tl|libro}}) e per la compilazione dei [[Aiuto:bollettino|bollettini]].
* <code><nowiki>{{Stage|25%|23 luglio 2005|breve}}</nowiki></code> crea solo l'icona della fase di sviluppo: {{Stage|25%|23 luglio 2005|breve}}
: (nota che se ti posizioni sull'icona, in entrambi i casi compare la data).

* <code><nowiki>{{Stage wik|23 luglio 2005}}</nowiki></code> crea solo l'icona ed indica che il modulo è da [[Aiuto:wikificare|wikificare]]: {{Stage wik|23 luglio 2005}}

In realtà la prima versione non è più utilizzata; una volta serviva per i sommari nelle pagine principale dei libr, ma oggi è preferibile utilizzare anche lì gli [[Aiuto:indice di navigazione|indici di navigazione]], all'interno dei quali si usa la sintassi abbreviata: accanto ad ogni pagina, va inserito anche il relativo stage.

Puoi assegnare uno dei seguenti stati di sviluppo:
* vuoto: se il libro è una pagina che ancora non esiste ("link rosso"), non assegnare nessuna fase di sviluppo.


Usa lo schema che segue per classificare i libri:
{| {{prettytable}}
{| {{prettytable}}
!Pulsante
! colspan="6" style="background-color: #D0E2EE;"|Fasi di sviluppo
!Fase di sviluppo
!Codice
!Descrizione
|-
|-
| [[Immagine:Button 00%.png]] || [[Immagine:00%.svg]] <code>00%</code>
!Fase
|<code><nowiki>{{avanzamento|00%}}</nowiki></code>
!Spiegazione
|Quando il libro ha solo la pagina principale e l'introduzione o pochi capitoli a loro volta ''stub''. Per ulteriori informazioni vedi [[Aiuto:Stub]]
|-
|-
| [[Immagine:Button 25%.png]] || [[Immagine:25%.svg]] <code>25%</code>
|Stub: {{Stage|00%|23 luglio 2005|breve}}
|<code><nowiki>{{avanzamento|25%}}</nowiki></code>
|Un testo che è stato appena iniziato o è ancora quasi vuoto, di cui ancora si stanno organizzando finalità e caratteristiche.
|Quando il libro è stato suddiviso in capitoli e alcuni di questi hanno del contenuto
|-
|-
| [[Immagine:Button 50%.png]] ||[[Immagine:50%.svg]] <code><nowiki>50%</nowiki></code>
|Testo in via di sviluppo: {{Stage|25%|23 luglio 2005|breve}}
|<code><nowiki>{{avanzamento|50%}}</nowiki></code>
|Un testo non vuoto ma ancora molto incompleto, in cui c'è ancora tanto da contribuire.
|Quando almeno metà dei capitoli hanno informazioni complete
|-
|-
| [[Immagine:Button 75%.png]] ||[[Immagine:75%.svg]] <code><nowiki>75%</nowiki></code>
|Testo abbastanza completo: {{Stage|50%|23 luglio 2005|breve}}
|<code><nowiki>{{avanzamento|75%}}</nowiki></code>
|Un testo che è a metà del suo sviluppo.
|Quando tutti o la maggior parte capitoli hanno informazioni complete
|-
|-
| [[Immagine:Button 100%.png]] ||[[Immagine:100%.svg]] <code><nowiki>100%</nowiki></code>
|Testo maturo: {{Stage|75%|23 luglio 2005|breve}}
|<code><nowiki>{{avanzamento|100%}}</nowiki></code>
|Un testo che possiede molte delle caratteristiche desiderate, ma viene ancora modificato da un punto di vista sia strutturale che contenutistico.
|Quando il libro è stato riletto (errori di ortografia, inezie del layout ecc..)
|-
|Testo completo: {{Stage|100%|23 luglio 2005|breve}}
|il 100% dei capitoli del libro sono completati. Non ci sono link rossi, e tutti i capitoli sono scritti e completi. Pur essendo un libro che potrebbe essere stampato, gli utenti possono ancora contribuire a migliorarlo (revisionandolo, aggiungendo nuove idee, aggiornandolo, eccetera).
|}
|}
Per valutare invece un modulo, se non sei tu l'autore il libro, valuta in base ai contenuti che ti ''aspetteresti di trovare''. Se sei tu l'autore del modulo, e sai quindi quanto dovrà essere lunga la pagina, inserisci l'avanzamento come più ritieni giusto.

Per facilitare l'inserimento del template sono stati sviluppati dei pulsanti per la barra di modifica. Cliccando su ciascun pulsante si cambia l'avanzamento della pagina al livello desiderato.
{{vedi anche|Aiuto:Barra degli strumenti di modifica}}


Devi dare un'occhiata a '''tutti i capitoli del libro''' per poter valutare correttamente la sua fase di sviluppo. È consigliato, soprattutto per i libri più completi, inserire delle fasi di sviluppo (senza data) per ogni capitolo. Se hai suggerimenti per lo sviluppo del libro, per favore scrivili sulla sua pagina di [[Aiuto:Pagina di discussione|discussione]].
Devi dare un'occhiata a '''tutti i capitoli del libro''' per poter valutare correttamente la sua fase di sviluppo. È consigliato, soprattutto per i libri più completi, inserire delle fasi di sviluppo (senza data) per ogni capitolo. Se hai suggerimenti per lo sviluppo del libro, per favore scrivili sulla sua pagina di [[Aiuto:Pagina di discussione|discussione]].

Ancora, controlla se il '''titolo''' del libro corrisponde ancora al suo contenuto. Se il titolo è troppo generale (per esempio, un libro intitolato ''Sport'' che contiene solo un capitolo riguardante una squadra di calcio, per esempio il Genoa), allora suggerisci nella sua pagina di discussione di cambiare il titolo. Il libro intitolato ''Sport'' sarà indicato come 00%{{Stage|00%|23 luglio 2005|breve}}, mentre lo stesso libro intitolato ''Genoa Football Club'' potrà ottenere il 100%{{Stage|100%|23 luglio 2005|breve}}, se è completo.


Questo processo di revisione ruba del tempo, ma aumenta la qualità di Wikibooks. Perciò è suggerito '''controllare solo uno o pochi libri alla volta''', indicando inoltre utili e intelligenti suggerimenti per lo sviluppo del libro. Per favore, controlla solo libri che non siano stati ricontrollati da un po' di tempo (qualche settimane, qualche mese) o che mostrano un livello di sviluppo basso.
Questo processo di revisione ruba del tempo, ma aumenta la qualità di Wikibooks. Perciò è suggerito '''controllare solo uno o pochi libri alla volta''', indicando inoltre utili e intelligenti suggerimenti per lo sviluppo del libro. Per favore, controlla solo libri che non siano stati ricontrollati da un po' di tempo (qualche settimane, qualche mese) o che mostrano un livello di sviluppo basso.


=== Come faccio a sapere lo stato della pagina quando ci sono dentro? ===
== Dove mettere il template e il template ''avanzamento'' ==
Come facciamo a sapere lo stato di una pagina quando ci troviamo dentro, per verificare che sia aggiornata? Semplice: basta guardare in alto a sinistra nella linguetta ''modulo'' e vedremo un immagine che indica la fase di sviluppo. Questo è possibile grazie ad un javascript integrato sempre nel template {{tl|Avanzamento}}.

== Dove mettere i template ==


Indicare a che punto è un libro è una pratica '''fortemente consigliata''', questo perché, vedendone lo stato di sviluppo, ognuno possa decidere se dare il suo contributo o meno, per questo o quest'altro wikibook.
Indicare a che punto è un libro è una pratica '''fortemente consigliata''', questo perché, vedendone lo stato di sviluppo, ognuno possa decidere se dare il suo contributo o meno, per questo o quest'altro wikibook.


Questo è reso molto facile dalle presenza dei template {{tl|libro}} e {{tl|modulo}} che, quando sono inseriti, attivano un particolare script che recupera l'avanzamento dalle pagine interessate e lo inserisce dove è necessario.
Pertanto, vi consigliamo di inserire/aggiornare sempre il template &#123;&#123;[[Template:Stage|Stage]]&#125;&#125;, basta inserirlo in tre contesti:


Questi template vanno usati:
*Nella pagina del [[Wikibooks:Biblioteca|ripiano]] corrispondente, dopo il titolo del libro
*Nella pagina del [[Wikibooks:Ripiani|ripiano]] corrispondente (template {{tl|libro}})
*Nel template di navigazione ripiano raggiiungibile dalla pagina principale.
*Nell'[[aiuto:indice di navigazione|indice di navigazione]] del libro (template {{tl|libro}})


Ad esempio, per il wikibook [[Html|linguaggio HTML]] metteremo il template, dopo il titolo, all'interno del ripiano [[Ripiano:Informatica|ripiano Tecnologia Informatica]], all'interno dell'[[Ripiano:Informatica|elenco di tutti i libri]] (ogni libro avrà il suo, ovviamente).
Ad esempio, per il wikibook [[Html|linguaggio HTML]] metteremo il template, dopo il titolo, all'interno del ripiano [[Ripiano:Informatica|ripiano Tecnologia Informatica]], all'interno dell'[[Ripiano:Informatica|elenco di tutti i libri]] (ogni libro avrà il suo, ovviamente).

===Il template Avanzamento===

Come facciamo a sapere lo stato di una pagina quando ci troviamo dentro, per verificare che sia aggiornata? Semplice: basta guardare in alto a sinistra nella linguetta ''modulo'' e vedremo un immagine che indica la fase di sviluppo. Questo è possibile grazie ad un javascript integrato nel template. Il template {{tl|Avanzamento}} deve essere messo alla fine del contenuto del [[Aiuto:Modulo|modulo]] e prima delle eventuali [[Aiuto:Categoria|categorie]] con questa sintassi: <pre><nowiki>{{avanzamento|25%}}</nowiki></pre>


==Vecchi template==
==Vecchi template==
Le vecchie fasi di sviluppo erano semplici immagini senza alcun riferimento alla data in cui il libro era stato controllato.
Le vecchie fasi di sviluppo erano semplici immagini senza alcun riferimento alla data in cui il libro era stato controllato.
* Una volta erano usati i template {{tl|stage}} accanto ai link. Oggi sono stati rimpiazzati dai template {{tl|libro}} e {{tl|modulo}}.
* Vecchia versione: immagine semplice: <nowiki>[[Image:25%.svg]], [[Image:50%.svg]], ...</nowiki>
* Vecchia versione: immagine semplice: <nowiki>[[Image:25%.svg]], [[Image:50%.svg]], ...</nowiki>
* Ancora più vecchia: Codice di colore: <nowiki>[[image:yellow.png]], [[image:red.png]], ...</nowiki>
* Ancora più vecchia: Codice di colore: <nowiki>[[image:yellow.png]], [[image:red.png]], ...</nowiki>
Nota che il vecchio codice di colore non aveva l'equivalente dello "00%", così è probabile che molti libri vadano riportati dal livello "25%" allo "00%".
*non aver timore nell abbassare la fase di sviluppo di libri che non ritieni completi.
Ricorda che ora "25%" significa "''almeno'' il 25% dei capitoli del libro sono completati".

Per favore, '''non accontentatevi di rimpiazzare''' le vecchie immagini con questi nuovi template, ma rimpiazzateli '''solo dopo aver ricontrollato voi stessi il libro'''.


[[da:Wikibooks:Udviklingsstadier]]
[[da:Wikibooks:Udviklingsstadier]]

Versione delle 18:33, 13 mar 2008

La fase di sviluppo indica il progresso di un libro o di un modulo, valutato ad una certa data.
Questo può aiutare a focalizzare l'attenzione del lettore su un libro comprensibile e abbastanza completo, e quella dell'autore ad un lavoro che richiede ancora aiuto. Inoltre risulta emotivamente deludente cliccare su un link blu e vedere che è praticamente vuoto, mentre con una indicazione prima la delusione è minore.

Fasi di sviluppo

L'icona della fase di sviluppo segue il titolo del libro (può essere utilizzato anche all'interno di un libro, per indicare lo sviluppo dei singoli capitoli) e indica il livello di completezza di quel libro in accordo con le seguente scala:

Fasi di sviluppo
Stub: In via di sviluppo: Completo a metà: Quasi completo: Completo:

Una data in piccolo subito dopo indica la data in cui la fase di sviluppo è stata valutata per l'ultima volta da un utente di Wikibooks. Per esempio

Cioè, questo libro è stato valutato come completo al 100% il 25 dicembre 2005.

Come indicare la fase di sviluppo

Anche tu puoi contribuire ad assegnare una fase di sviluppo ai libri che visiti. È facile, e di grande aiuto per i nuovi lettori, che così potranno trovare facilmente e in modo rapido i libri più completi di loro interesse.

Per dare informazioni sullo stato di completamento del tuo libro e dei moduli e inserirlo automaticamente nella categoria relativa al suo stadio di sviluppo, è stato elaborato il template {{avanzamento}} che va posto in fondo alla pagina dopo le categorie e gli interwiki in questo modo:

{{avanzamento|xx|''data''}}

Una volta inserito il tempate {{avanzamento}} nella pagina questo sarà automaticamente utilizzato per la generazione dei link (usando i template {{modulo}} e {{libro}}) e per la compilazione dei bollettini.

Usa lo schema che segue per classificare i libri:

Pulsante Fase di sviluppo Codice Descrizione
00% {{avanzamento|00%}} Quando il libro ha solo la pagina principale e l'introduzione o pochi capitoli a loro volta stub. Per ulteriori informazioni vedi Aiuto:Stub
25% {{avanzamento|25%}} Quando il libro è stato suddiviso in capitoli e alcuni di questi hanno del contenuto
50% {{avanzamento|50%}} Quando almeno metà dei capitoli hanno informazioni complete
75% {{avanzamento|75%}} Quando tutti o la maggior parte capitoli hanno informazioni complete
100% {{avanzamento|100%}} Quando il libro è stato riletto (errori di ortografia, inezie del layout ecc..)

Per valutare invece un modulo, se non sei tu l'autore il libro, valuta in base ai contenuti che ti aspetteresti di trovare. Se sei tu l'autore del modulo, e sai quindi quanto dovrà essere lunga la pagina, inserisci l'avanzamento come più ritieni giusto.

Per facilitare l'inserimento del template sono stati sviluppati dei pulsanti per la barra di modifica. Cliccando su ciascun pulsante si cambia l'avanzamento della pagina al livello desiderato.

Per approfondire, vedi Aiuto:Barra degli strumenti di modifica.

Devi dare un'occhiata a tutti i capitoli del libro per poter valutare correttamente la sua fase di sviluppo. È consigliato, soprattutto per i libri più completi, inserire delle fasi di sviluppo (senza data) per ogni capitolo. Se hai suggerimenti per lo sviluppo del libro, per favore scrivili sulla sua pagina di discussione.

Questo processo di revisione ruba del tempo, ma aumenta la qualità di Wikibooks. Perciò è suggerito controllare solo uno o pochi libri alla volta, indicando inoltre utili e intelligenti suggerimenti per lo sviluppo del libro. Per favore, controlla solo libri che non siano stati ricontrollati da un po' di tempo (qualche settimane, qualche mese) o che mostrano un livello di sviluppo basso.

Come faccio a sapere lo stato della pagina quando ci sono dentro?

Come facciamo a sapere lo stato di una pagina quando ci troviamo dentro, per verificare che sia aggiornata? Semplice: basta guardare in alto a sinistra nella linguetta modulo e vedremo un immagine che indica la fase di sviluppo. Questo è possibile grazie ad un javascript integrato sempre nel template {{Avanzamento}}.

Dove mettere i template

Indicare a che punto è un libro è una pratica fortemente consigliata, questo perché, vedendone lo stato di sviluppo, ognuno possa decidere se dare il suo contributo o meno, per questo o quest'altro wikibook.

Questo è reso molto facile dalle presenza dei template {{libro}} e {{modulo}} che, quando sono inseriti, attivano un particolare script che recupera l'avanzamento dalle pagine interessate e lo inserisce dove è necessario.

Questi template vanno usati:

Ad esempio, per il wikibook linguaggio HTML metteremo il template, dopo il titolo, all'interno del ripiano ripiano Tecnologia Informatica, all'interno dell'elenco di tutti i libri (ogni libro avrà il suo, ovviamente).

Vecchi template

Le vecchie fasi di sviluppo erano semplici immagini senza alcun riferimento alla data in cui il libro era stato controllato.

  • Una volta erano usati i template {{stage}} accanto ai link. Oggi sono stati rimpiazzati dai template {{libro}} e {{modulo}}.
  • Vecchia versione: immagine semplice: [[Image:25%.svg]], [[Image:50%.svg]], ...
  • Ancora più vecchia: Codice di colore: [[image:yellow.png]], [[image:red.png]], ...