Creative Commons License
Excepto donde se indique otra cosa, todo el contenido de este lugar está bajo una licencia de Creative Commons.
Taquiones > software > factory > syntax: un plugin para ikiwiki

Realzado de síntaxis con IkiWiki

He escrito un plugin para ikiwiki que le añade las capacidades de resaltado de síntaxis de Vim a través del módulo Perl Text::VimColor.

El módulo registra una directiva nueva, syntax, que incluye esos fragmentos HTML en la página directamente:

A continuación un poco de código en Perl:

[[!syntax type="perl" description="Mi primer programa en Perl" text="""
#!/usr/bin/perl

print "Hola, mundo\n";
"""]]

aunque también es posible optar por incluir un archivo externo:

Un archivo directamente incluído:

[[!syntax type="bash" file="/etc/profile"]]

Como es obvio, el archivo debe estar disponible siempre que se reconstruya el wiki.

Además de esto, en cualquiera de los dos casos es posible incluir una descripción que se mostrará en una zona independiente, mediante el parámetro description en la llamada a la directiva.

Version 0.6: en la que se añade un parámetro llamado linenumbers para activar la numeración de líneas en la salida. Si el valor de este parámetro es un número mayor que cero la primera línea comenzará por él; en caso contrario se utiliza el uno.

Hojas de estilo

Se añaden las siguientes hojas de estilo para el XHTML producido:

  • synComment
  • synConstant
  • synIdentifier
  • synStatement
  • synPreProc
  • synType
  • synSpecial
  • synUnderlined
  • synError
  • synTodo
  • synTitle
  • synLineNumber

y ahora podemos descargar una hoja de estilo para incluir en nuestro web directamente.

También he creado una página con algunos ejemplos de uso.