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.

Esta funcionalidad de ACL extendido permite gestionar el acceso a un contenido específico.

Siempre y cuando se tengan los permisos respectivos (WR y WW) en un perfil asignado, en principio todas las páginas son accesibles y se pueden editar por todos los usuarios.

Los usuarios administradores de la Wiki (permiso WM en un perfil asignado o superadmin) pueden crear listas de acceso para lectura y escritura de cada página en las entradas del menú lateral, Read ACL y Write ACL, para cada una de las páginas del contenido.

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.

Por defecto la Wiki PITSM trae una página principal en donde se puede crear un menú con todas las subpáginas que se necesiten. Sin embargo existen páginas que son más leídas y/o son más útiles que las demás.

Para estas páginas destacadas se puede modificar el menú de la Wiki PITSM, insertando sus propios enlaces en formato HTML dentro una página especial llamada side_menu y tener así un submenú de PITSM en sí mismo para cada una de ellas.

En la sección Admin pages del menú de la Wiki aparecen todas las páginas, incluida la página especial side_menu, en la cual haciendo clic en su nombre se entra en modo de edición pulsando el icono .

• Enlace a una página de la Wiki PITSM:

Para agregar un enlace a una página llamada Office en la sección Add side menu se debe colocar en Page name el nombre y en URL el siguiente código con dicho nombre al final.

index.php?sec=wiki&sec2=operation/wiki/wiki&page=Office

Luego se debe pulsar en el botón de agregado , se debe obtener algo parecido a esto:

• Enlace web externo:

Funciona de manera similar a la de una página de la Wiki PITSM, con la diferencia de que la dirección debe incluir HTTP o HTTPS. Téngase en cuenta que el enlace abrirá en la misma ventana, dejando atrás la Consola web PITSM.

• Borrado de menú:

Para poder visualizar el nuevo submenú de la Wiki PITSM, luego de haber guardado pulsando el botón Save changes, se debe pulsar Wiki → Admin pages. Al volver a abrir el submenú, si se es usuario administrador de la Wiki aparecerá un botón de borrado con el icono . Luego de haber borrado la página deseada se debe pulsar Wiki → Admin pages para cargar los cambios en el menú.

• Edición de página de menú:

Si se tienen derechos de escritura, al hacer clic en un nuevo submenú de la Wiki PITSM automáticamente entrará en modo de edición, utilizando la sintaxis se creará su contenido y se guardarán los cambios.

En el menú Wiki → Syntax se tiene en línea la sintaxis completa de la Wiki PITSM.

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.

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

li {
  list-style-type: circle;
}

Negrita: tres comillas simples al inicio y final del texto.

'''bold'''

Cursiva: Dos comillas simples al principio y final del texto.

''italic''

Subrayado: Con comillas y dos rayas bajas al inicio y final del texto.

'__underlined__'

Tachado: Con comillas y dos guiones al inicio y final del texto

'--strikethrough--'

Para enlazar a una página o enlace interno de la Wiki PITSM:

[Sample sub page|sample subpage] → Sample subpage

Al guardar y recargar la página que contiene el enlace interno, al hacer clic en él (y si se tienen derechos de escritura) se abrirá en modo de edición a fin de colocar su contenido respectivo.

Los enlaces relativos deben comenzar con ./, de lo contrario se interpretará como página o enlace interno de la Wiki PITSM:

[Interesting page|./SomeWebPage.html] → Interesting page

Simple enlace web:

[http://www.example.com/]

→ http://www.example.com

Enlace web externo con texto:

[Main project page|https://www.example.com/]

→ Main project page

Los correos electrónicos y las páginas web también se reconocen automáticamente:

http://example.com

→ http://example.com

johndoe@example.com

→ johndoe@example.com

Si un usuario tiene permiso de escritura podrá almacenar las imágenes necesarias en el PITSM server. Para una mayor organización también se podrán crear subdirectorios para almacenar los recursos de cada página de manera independiente.

Si se almacena una imagen llamada image_name.png en el directorio raíz se puede utilizar el siguiente código:

[./wiki_data/upload/image_name.png]

Si se almacena dicha imagen en un directorio llamado dir1:

[./wiki_data/upload/dir1/image_name.png]

Las imágenes pueden tener más opciones de presentación que son utilizadas también con las imágenes externas.

Algunos sitios web pueden permitir enlazar imágenes (aunque esta práctica debe ser evitada), se recomienda siempre almacenar las imágenes en el PITSM server.

Imagen con su tamaño original:

[http://example.com/image.jpg]

Imagen con enlace web:

[http://example.com/image.jpg|link=http://example.com/]

Opcionalmente se puede colocar la imagen al centro (o a la derecha o izquierda) y agregar un texto descriptivo:

[http://example.com/image.jpg|link=http://example.com/|center|title=Example image]

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.

Ú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]
}}

Se utilizan solamente cuatro guiones juntos ---- en una sola línea.

Usando el carácter ^ antes de cualquier palabra especial (escapado de caracteres).

^{{code}}

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}

Se utiliza {br} para introducir saltos de línea y/o líneas en blanco.

First line.{br}Second line.

Volver al índice de documentación de Pandora ITSM