Other languages: Italiano English

Formattazione testi in TWiki

Lavorare con TWiki è semplice come digitare testo. Non è necessario conoscere l'HTML, ma lo si può usare se si vuole. I link alle pagine sono generati automaticamente quando vengono immesse delle WikiWords. La notazione abbreviata di TWiki dà tutta la potenza dell'HTML all'interno di un sistema semplice di codifica che si impara in breve tempo. È tutto descritto sotto.

Notazione di scrittura TWiki

primo paragrafo

secondo paragrafo

---++ Sushi

---+++ Maguro

*Grassetto*

_Italico_

__Italico grassetto__

=Fixed font=

==Bold fixed==

_Questo funziona_,
_questo no _

<verbatim>
class CatAnimal {
  void purr() {
    <code here>
  }
}
</verbatim>

class CatAnimal {
  void purr() {
    <code here>
  }
}

-------

   * bullet item

      * roba nidificata

   1 Sushi
   1 Dim Sum

   Sushi: Japan
   Dim Sum: S.F.

| *L* | *C* | *R* |
| A2 |  2  |  2 |
| A3 |  3  |  3 |
| multi span |||
| A4 | next | next |

WebNotify

Know.ReadmeFirst

[[wiki syntax]]

[[Main.TWiki users]]

[[WikiSyntax][syntax]]

[[http://gnu.org][GNU]]

[[http://xml.org XML]]

[[WebHome#NotThere]]

[[#MyAnchor][Jump]]

#MyAnchor To here

<nop>SunOS

 <noautolink>
 RedHat &
 SuSE
 </noautolink>

[[mailto:a@z.com Mail]]

[[mailto:?subject=Hi Hi]]

Uso di HTML

Potete usare praticamente ogni tag HTML senza problemi, ma ci sono alcune considerazioni tecniche e di usabilità da tenere a mente.

HTML e Usabilità di TWiki

• Sulle pagine di collaborazione, è preferibile NON usare l'HTML e usare invece la NotazioneTWiki^? - questo mantiene il testo pulito e facile da modificare.

• NOTA: TWiki per disegno funziona con un ampia gamma di browser e piattaforme, mantenendo la compatibilità con HTML 3.2 nell'installazione standard - l'aggiunta di HTML, in particolare tag funzionanti solo con alcuni browser (o altro mark-up che non degrada bene) ridurrà la compatibilità.

TWiki HTML Rendering

• TWiki converte la notazione abbreviata in XHTML 1.0 per mostrarlo. Per copiare una pagina con tutto il mark-up, è sufficiente visualizzare il sorgente nel browser e salvare il contenuto.
  • Se avete bisogno di salvare l'HTML di frequente, potete dare un'occhiata a TWiki:Plugins/GenHTMLAddon - "genererà una directory contenente la versione visualizzabile di un insieme di pagine TWiki insieme a ogni file in attachment."
• NOTA: Le parentesi angolari - <...> - di un tag HTML devono essere sulla stessa riga, o il tag sarà rotto.
  • Questa feature ti permette di inserire una parentesi angolare non chiusa - come un segno di maggiore o di minore - e far sì che sia automaticamete visualizzata come se avessi inserito il carattere HTML corrispondente, <, es: a > b
  • Se stai incollanto un testo HTML preformattato e noti problemi, controlla il file in un editor senza "a capo automatico". Inoltre, salva "senza andate a capo automatiche" nel tuo editor HTML.

Iperlinks

Una delle caratteristiche di base di TWiki è quella di creare link senza nessuna formattazione particolare attraverso le WikiWord. Nuove regole di collegamento forniscono un nuovo insieme di opzioni.

Collegamenti Interni

• GoodStyle è una WikiWord che collega al topic GoodStyle nella sezione corrente TWiki.

• NonAncoraEsistente^? è un topic che aspetta di essere scritto. Create il topic clickando su ?. (dopo aver clickato seleziona Cancel - altrimenti quest'esempio non funzionerà più!)

Collegamenti Esterni

• http://..., https://..., ftp://..., gopher://..., news://..., file://..., telnet://... e mailto:...@... sono linkati automaticamente.

• Indirizzi Email come name@domain.com sono linkati automaticamente.

• [[Parentesi quadre]] ti permettono di creare link facilemente per non-WikiWord links.
  • puoi anche scrivere [[http://yahoo.com Yahoo home page]] come un facile modo di fare riferementi esterni con testo descrittivo come Yahoo home page.

TWiki Variables

Le Variabili sono nomi rinchiusi tra segni di percentuale % che sono espansi al volo.

• %TOC% : genera automaticamente un indice basato sulle intestazionin del topic.

• %WEB% : La sezione corrente TWiki.

• %TOPIC% : Il noem del topic corrente, RegoleDiFormattazioneTWiki.

• %ATTACHURL% : L'URL degli allegati del topic corrente. Esempio se si allega un file ad un topic ci si può riferire a tale file come %ATTACHURL%/image.gif per mostrare il file o l'immagine nel topic.

• %INCLUDE{"SomeTopic"}% : Include topic dal server. La sezione corrente TWiki è la sezione di default. Esempio: %INCLUDE{"TWiki.SiteMap"}%

• %SEARCH{"sushi"}% : Inline search mostra i risultati inseriti nel topic. FormattedSearch permette di personalizzare il risultato.

• TWikiPreferences defines site-wide variables. Among others:
  • Line break: Write %BR% to start a new line.
  • Colored text: Write: %RED% Red %ENDCOLOR% and %BLUE% blue %ENDCOLOR% colors to get: Red and blue colors.
  • Documentation Graphics: Write: %H% Help, %T% Tip, %X% Alert to get: Help, Tip, Alert. For more info see TWikiDocGraphics.

• There are many more variables, see TWikiVariables.

TWikiPlugin Formatting Extensions

Plugins provide additional text formatting capabilities and can extend the functionality of TWiki into many other areas. For example, the optional SpreadSheetPlugin lets you create a spreadsheet with the same basic notation used in TWiki tables.

Available Plugins are located in the Plugins web on TWiki.org. Currently enabled plugins on this TWiki installation, as listed by %PLUGINDESCRIPTIONS%:

• DefaultPlugin: This plugin can be used to specify some simple custom rendering rules. It also renders depreciated *_text_* as bold italic text.
• SpreadSheetPlugin: Add spreadsheet calculation like "$SUM( $ABOVE() )" to tables located in TWiki topics.
• BatchUploadPlugin: Plugin implementing TWiki:Codev.MultipleAttachmentsAtOnce
• CommentPlugin: Allows users to quickly post comments to a page without an edit/preview/save cycle.
• EditTablePlugin: Edit TWiki tables using edit fields, date pickers and drop down boxes
• InterwikiPlugin: Link ExternalSite:Page text to external sites based on aliases defined in the InterWikis topic
• RenderListPlugin: Render bullet lists in a variety of formats
• SlideShowPlugin: Create web based presentations based on topics with headings.
• SmiliesPlugin: Render smilies as icons, like  :-) for or  :cool: for
• TablePlugin: Control attributes of tables and sorting of table columns

Check on current Plugin status and settings for this site in TWikiPreferences.

Common Editing Errors

TWiki formatting rules are fairly simple to use and quick to type. However, there are some things to watch out for, taken from the TextFormattingFAQ:

• Q: Text enclosed in angle brackets like <filename> is not displayed. How can I show it as it is?
  • A: The '<' and '>' characters have a special meaning in HTML, they define HTML tags. You need to escape them, so write '<' instead of '<', and '>' instead of '>'.
    Example: Type 'prog <filename>' to get 'prog <filename>'.

• Q: Why is the '&' character sometimes not displayed?
  • A: The '&' character has a special meaning in HTML, it starts a so called character entity, i.e. '©' is the © copyright character. You need to escape '&' to see it as it is, so write '&' instead of '&'.
    Example: Type 'This & that' to get 'This & that'.

-- MikeMannix^? - 02 Dec 2001
-- PeterThoeny - 01 Feb 2003

-- AntonioBellezza^? - 03 Mar 2004

-- RobertoBernetti - 11 Apr 2005
All'inizio