Wiki
La Wiki es un sistema muy básico para compartir información con otros usuarios, contiene texto formateado, estructurado y con hipervínculos externos e internos. Pandora ITSM dispone de un sistema de ACL por el cual puede restringir quién tiene acceso de lectura o escritura a él. Además dispone de un sistema de ACL extendido por el que además puede especificar a nivel de usuario quién tiene permiso para ver una página y quién no.
Sintaxis básica
Cabeceras
Se coloca uno o más signos de exclamación al principio de una línea.
!Heading H2 !!Heading H3 !!!Heading H4 !!!!Heading H5
Cuantos más signos de exclamación se utilicen, menor será el título (hasta 5 signos de exclamación). Los signos de exclamación tienen que estar exactamente al comienzo de la línea. Después de guardar la edición, cada título o subtítulo tendrá un botón para editar la sección correspondiente.
Listas y listas numeradas
Para cada elemento de la lista sin numerar se debe comenzar con uno o más asteriscos.
* Fruit ** Apple *** Granny smith ** Orange * Vegetables ** Garlic ** Onion
Para las listas numeradas se utiliza el símbolo numeral de igual manera:
# First item ## First subitem ### First subsubitem ## Second subitem
Estilos de letra
Negrita: tres comillas simples al inicio y final del texto.
'''bold'''
Cursiva: Dos comillas simples al principio y final del texto.
''italic''
Subrayado: Con comilla y dos rayas bajas al inicio y final del texto.
'__underlined__'
Tachado: Con comilla y dos guiones al inicio y final del texto
'--strikethrough--'
Enlaces y ficheros
Simple enlace web:
[http://www.example.com/]
Los correos electrónicos y las páginas web también se reconocen automáticamente:
http://example.com
[email protected]
Enlace web con texto:
[Main project page|http://www.example.com/]
Los enlaces relativos deben comenzar con ./
, de lo contrario se interpretará como página o enlace interno de la Wiki.
[Interesting page|./SomeWebPage.html]
→ Interesting page
Imágenes
Imagen con enlace web:
[http://example.com/image.jpg|link=http://example.com/]
Opcionalmente se puede colocar la imagen a la izquierda, derecha o al centro y agregar un texto descriptivo:
[http://example.com/image.jpg|link=http://example.com/|center|title=Big Leon]
Tablas de contenido
Se pueden generar Tabla de contenidos automáticamente con {TOC}
. Cada título o subtítulo (cabecera) será usado como ítem para la tabla de contenido.
Código fuente
Útil cuando se necesite mostrar exactamente un texto y sin formato alguno. Se utiliza {{
, el código o texto y se cierra con }}
.
{{ import sys if len(sys.argv) == 2: print "Hello",sys.argv[1] }}
Línea horizontal
Se utilizan solamente cuatro guiones juntos ----
en una sola línea.
Evitando el formato Wiki
Usando el carácter ^
antes de cualquier palabra especial (escapado de caracteres).
^{{code}}
Código HTML
Se puede introducir código HTML directamente en la Wiki con las etiquetas {html}
y {/html}
. Así una cabecera se podría colocar de la siguiente manera:
{html}<h2>HTML code for H2</h2>{/html}
Saltos de línea o en blanco
Se utiliza {br}
para introducir saltos de línea y/o líneas en blanco.
First line.{br}Second line.
Menú de la Wiki
Puede modificar el menú de la Wiki, insertando sus propios enlaces en formato HTML. Para ello tiene que una página especial llamada side_menu
. Vaya a la sección Admin pages del menú de la Wiki, para todas las páginas, incluida la página especial side_menu
.
En ella debe poner código HTML directamente enlazando a lo que quiera, puede ser una página de la Wiki o algo externo.
Ejemplo: suponga que tiene una página de la Wiki con el nombre “office”. El enlace sería algo como:
http://localhost/integria/index.php?sec=wiki&sec2=operation/wiki/wiki&page=Office
Debe crear un código en la página side_menu con el siguiente formato:
<li><a href='http://localhost/integria/index.php?sec=wiki&sec2=operation/wiki/wiki&page=Telephone_ES'>Telefonos</a>
Permisos de lectura y escritura
Esta funcionalidad permite gestionar el acceso al contenido. En un principio, todas las páginas son accesibles y se pueden editar por todos los usuarios. Precisamente los usuarios administradores pueden crear listas de acceso para lectura y escritura de cada página en las entradas del menú lateral: Lectura ACL y Escritura ACL.
Si un contenido no tiene usuarios en su lista de lectura o escritura, será accesible para todos. Cuando se añade un usuario a las listas de acceso, solamente tendrán permiso de lectura o escritura dichos usuarios (y cualquier administrador).
Para editar el acceso de una página, se abre esa página en concreto y desde ahí, utilizando las opciones del menú Read ACL o Write ACL se editan las listas de acceso de lectura o escritura, respectivamente. Cada página del Wiki tendrá su propia lista de acceso.