Standard
ATTENZIONE: SI SEGNALA CHE L'EDIT NON FUNZIONA CON EXPLORER (SOLO L'EDIT SOURCE). SI RACCOMANDA DI USARE CHROME.
Indice
Come lavorare sulle pagine e non renderle visibili
Per lavorare su una pagina ma non renderla visibile procedere nel seguente modo:
- Creare la pagina aggiungendo una 'D' davanti al nome, ad es. "DIncident Management" (in alternativa creare la pagina con il nome standard e poi usare la funzione 'move' sul menu dei tab in alto per rinominarla (il 'move' rinomina la pagina)
- Quando la pagina deve essere resa visibile tramite il link originale, effettuare nuovamente un 'move' dando il nome originale (es. "Incident Management")
Esempio di stile heading
Da usare per i titoli di 1° livello nella pagina.
Esempio di stile sub-heading 1
Da usare per i titoli di 2° livello nella pagina.
Esempio di sub-heading 2
Da usare per i titoli di 3° livello nella pagina.
Esempio di sub-heading 3
Da usare per i titoli di 4° livello nella pagina.
Esempio di sub-heading 4
Da usare per i titoli di 5° livello nella pagina.
Convenzioni di scrittura del testo
Fare riferimento a queste convenzioni.
Tabelle
Di base si possono usare due tipologie di tabelle. Per il loro utilizzo si consiglia di passare all'editor "source", copiare il codice relativo, comprenderne il funzionamento, incollare e modificare nella pagina target.
Normale
| Item | Convention | Examples |
|---|---|---|
| Entities | Italic | Project, service, resource, user. |
| Menu functionalities | Bold and italic | Services/Add New refers to the functionality Add New available as a menu item in the submenu Services. |
| Commands | Bold | Delete refers to the application command Delete. |
| References to fields | Underlined | Name refers to the field Name. |
| Values of fields | "Brackets" | "Henry" refers to the content Henry of a field, for example Name. |
| References to tabs or form areas | Italic and underlined | Options refers to the section or tab Options of a form. |
| Relevant text which needs to be highlighted | Bold and underlined | Relevant text. |
Con colonne ordinabili
| Item | Convention | Examples |
|---|---|---|
| Entities | Italic | Project, service, resource, user. |
| Menu functionalities | Bold and italic | Services/Add New refers to the functionality Add New available as a menu item in the submenu Services. |
| Commands | Bold | Delete refers to the application command Delete. |
| References to fields | Underlined | Name refers to the field Name. |
| Values of fields | "Brackets" | "Henry" refers to the content Henry of a field, for example Name. |
| References to tabs or form areas | Italic and underlined | Options refers to the section or tab Options of a form. |
| Relevant text which needs to be highlighted | Bold and underlined | Relevant text. |
Immagini
Le immagini vanno prima caricate con il compando in basso del menu di sx "Upload file".
Si raccomanda, all'atto dell'upload, di mettere nel Summary la category scrivendo:[[Category:CATEGORY NAME]] dove CATEGORY NAME è il nome della category in cui si vuole inserire l'immagine.
Sto creando le categorie che sono consultabili quì.Se ritenete che manchi e debba essere aggiunta una categoria, comunicatemelo.
Esempio di utilizzo di immagini.
Le impostazioni per l'immagine sono le seguenti:
- Nome dell'immagine nel campo "Caption"
- Disabilitare "Wrap text around this item"
- Image type settato a "Thumbnail"
- Image size settata a "Custom", con numero di pixel orizzontali al valore 850.
In alternativa, qualora l'immagine non risultasse ben centrata (in particolare questo succede con immagini piccole), alcune impostazioni possono essere definite come segue:
- Abilitare "Wrap text around this item"
- Selezionare la centratura dell'immagine
Le screenshot di itmSUITE® sono da prendere senza la cornice del browser (non si devono vedere url, etc.).
Gestione link
Si raccomanda di inserire ogni link che dovesse apparire utile. Prima di inserire il link, cercare le parole del nuovo link con lo strumento di Search a sx nella pagina. Se si dovesse identificare una pagina adatta cololegarla, altrimenti inserire un collegamento ad una pagina vuota (eventualmente popolare anche la nuova pagina) che verrà evidenziata in rosso.
Per i link a pagine esistenti, basta creare il collegamento relativo. Si può creare il collegamento ad una sezione interna del documento ma per questo si deve utilizzare il source editor. La sezione di interesse (titolo del paragrafo) deve essere preceduta da #. Esempio di link ad un header di una pagina collegata:[[ItmSUITE®_-_Core_modules#CMS - Configuration Management System|CMS - Configuration Management System]]il cui effetto è CMS - Configuration Management System.
Discussione pagine
Da utilizzare anche la discussione pagine per inserire annotazioni e varie. La struttura può essere quella di questa pagina. In particolare dovranno essere presenti i paragrafi:
- Related Technical Documents (dove inserire tutti i riferimenti a documentazione interna utile sull'argomento, in particolare le RFC)
- Checks (dove elencare tutti i dubbi e domande sull'argomento)
- Changes (dove elencare tutte le proposte di change inerenti l'argomento)
- Wiki Improvements (miglioramenti / completamenti per il wiki)
Le pagine di discussione devono essere protette con accesso ai soli amministratori.
Pagine utili
Creazione link
Pagina di help per la gestione degli hyperlink per http://www.mediawiki.org/wiki/Help:Links#Internal_links.
