Standard

Da itm wiki.

ATTENZIONE: SI SEGNALA CHE L'EDIT NON FUNZIONA CON EXPLORER (SOLO L'EDIT SOURCE). SI RACCOMANDA DI USARE CHROME.

Come lavorare sulle pagine e non renderle visibili

Per lavorare su una pagina ma non renderla visibile procedere nel seguente modo:

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

Login Screen

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.