Wiki
Volver al índice de documentación de Pandora FMS
El 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. Al ser editable es una herramienta sencilla de colaboración y compartición de información que soporta las siguientes funcionalidades:
- Sintaxis Wiki para jerarquías de títulos, hiperenlaces, listas, imágenes.
- Gestión de cambios.
- Subir ficheros y enlazarlos desde el Wiki.
- Generar tablas de contenidos y vistas jerárquicas de información (título, subtítulo, etcétera).
- Preformateado, negrita, cursiva.
- El Wiki de Integria IMS 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
Este es un resumen breve de su sintaxis.
Cabeceras
Se coloca uno o más signos de exclamación al principio de una línea. Ejemplo:
!Heading H2 !!Heading H3 !!!Heading H4
Cuantos más signos de exclamación utilice, 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 se debe comenzar con uno o más asteriscos. Ejemplo de lista sin numerar:
* Fruit ** Apple *** Granny smith ** Orange * Vegetables ** Garlic ** Onion
Se verá como:
- Fruit
- Apple
- Granny smith
- Orange
- Vegetables
- Garlic
- Onion
Ejemplo de lista numerada:
# First item ## First subitem ### First subsubitem ## Second subitem
Se verá como:
- 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
Basta con escribir el enlace así:
[http://www.example.com/]
O, si desea colocar texto al enlace:
[Main project page|http://www.example.com/]
Los emails y las páginas web también se reconocen automáticamente:
http://example.com
[email protected]
Puede utilizar también los enlaces relativos, pero tiene que comenzar con ./
(de lo contrario se interpretará como página o enlace interno de la Wiki). Así que si usted desea vincular alguna página HTML en el mismo directorio, se utiliza:
[Interesting page|./SomeWebPage.html]
→ Interesting page
Imágenes
Para usar la imagen como enlace:
[http://miweb.com/leon.jpg|link=http://miweb.com/]
Puede poner la imagen a la izquierda, derecha o centrada y agregar un título, como en este ejemplo.
[http://miweb.com/leon.jpg|link=http://miweb.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 o preformato
Es muy útil cuando queremos evitar que el Wiki nos “formatee” algo o lo malinterprete, útil para poner código, o información en bruto. Se utiliza { {
, el código o texto y } }
. Todo el texto entre medias irá formateado como este:
{{ import sys if len(sys.argv) == 2: print "Hello",sys.argv[1] }}
Línea horizontal
Usando cuatro guiones —-
en una línea sin nada más.
Evitando el formato Wiki
Usando el carácter ^
antes de cualquier palabra especial (escapado de caracteres). Por ejemplo:
^{{code}}
Código HTML
Puede meter código HTML directamente en el wiki, mientras use los tags {html}
y {/html}
. Por ejemplo, una cabecera también se podría colocar de la siguiente manera:
{html}<h2>HTML code</h2>{/html}
Línea en blanco
Utilice {br}
para introducir saltos de línea y/o líneas en blanco.
Menú del Wiki
Puede modificar el menú del 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ú del 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 del Wiki o algo externo.
Ejemplo: suponga que tiene una página del 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 Enterprise permite gestionar el acceso al contenido. En un principio, todas las páginas son accesibles y editables por todos los usuarios. Pero 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. Vea por ejemplo el acceso de lectura para esta página:
Cuando añadimos un usuario a las listas de acceso, sólo tendrán permiso de lectura o escritura dichos usuarios (y cualquier administrador).
Para editar el acceso de una página, vaya a esa página en concreto y desde ahí, utilice las opciones del menú Read ACL o Write ACL para editar las listas de acceso de lectura o escritura de esa página en concreto. Cada página del Wiki tendrá su propia lista de acceso.