Aiuto:Fasi di sviluppo: differenze tra le versioni

Wikibooks, manuali e libri di testo liberi.
Contenuto cancellato Contenuto aggiunto
Pietrodn (discussione | contributi)
→‎Come faccio a sapere lo stato della pagina quando ci sono dentro?: precisazione, il codice JS non è contenuto nel template, ma lo sfrutta
RamaccoloBot (discussione | contributi)
m Robot: Changing templates: TOCright Aiuto, IndiceCategoria, CompactTOC
Riga 1: Riga 1:
{{Scrivere un libro}}
{{Scrivere un libro}}
{{TOCright Aiuto}}
{{Indice aiuto}}
La '''fase di sviluppo''' indica il progresso di un libro o di un modulo, valutato ad una certa data.
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.
<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.

Versione delle 18:51, 19 lug 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 2007.

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 uno script JavaScript (che si trova qui, funzione onglets() ) che sfrutta il template {{Avanzamento}} contenuto nella pagina.

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).

Quando va usato il template {{stage}}?

Il vecchio template {{stage}} è stato ormai rimpiazzato dai template {{libro}} e {{modulo}} per quanto riguarda l'uso dei link.
Risulta però necessario quando bisogna assegnare un avanzamento a qualcosa che non può essere linkato perché non è una pagina. Ad esempio se si vuole indicare l'avanzamento di una sezione di un libro a cui non corrisponde una pagina specifica: in quel caso si può inserire il template stage accanto nel titolo della sezione; oppure se si vuole indicare l'avanzamento dei singoli paragrafi della pagina, come è fatto ad esempio qui.

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]], ...