Documentazione/Extensions

Da Slacky.eu.

Pre - Testo preformattato

L'estensione permette di inserire del testo al quale non verrà applicata la formattazione HTML. Si usa quando si deve inserire un testo sorgente di esempio da visualizzare in un riquadro. Comunque per riquadrare una sola riga (o poche vicine) in Mediawiki è sufficiente intestare la riga con uno spazio vuoto. Da notare che l'estensione SyntaxHighlight può produrre lo stesso risultato di <pre>.

Uso dell'estensione:

 <pre>
 ... linee di testo ...
 <pre>

SyntaxHighlight GeSHi

Questa estensione è veramente utile per la documentazione di script e programmi sorgente in generale. I linguaggi supportati sono un'infinità, quelli più comuni in questo wiki sono sicuramente:

c, cpp, asm, perl, python, ruby, java, php,
bash, diff, make, cmake, autoconf, xorg_conf, text

Uso dell'estensione:

 <source lang="linguaggio">
 ... codice sorgente ...
 </source>

Esempio di colorazione bash script /etc/rc.d/rc.dhcpd:

#!/bin/sh
#
# /etc/rc.d/rc.dhcpd
#
# Start/stop/restart the DHCP server.
#
# To make DHCP daemon start automatically at boot, make this
# file executable:  chmod 755 /etc/rc.d/rc.dhcpd
#

case "$1" in
   'start')
      /usr/sbin/dhcpd ;;
   'stop')
      killall -s 9 dhcpd ;;
   'restart')
      killall -s 9 dhcpd
      /usr/sbin/dhcpd  ;;
   *)
      echo "usage $0 start|stop|restart" ;;
esac

Citazioni e riferimenti

L'estensione Cite si usa in particolare per le citazioni a fondo pagina (come in un libro), ma è anche molto utile per "piazzare" delle ancore cliccabili nel testo. Ecco un esempio:

Il sorgente:

<big>According to scientists, the Sun is pretty big.<ref name="miller"/>
The Moon, however, is not so big.<ref name="smith"/></big>

'''References:'''

<references>
<ref name="miller">E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.</ref> 
<ref name="smith">R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44-6.</ref>
</references>

Il risultato:

According to scientists, the Sun is pretty big.[1] The Moon, however, is not so big.[2]

References:

  1. E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.
  2. R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44-6.