Tabla de contenidos:
Machete para hacer algunas cosas en esta wiki
Este índice se hizo con el siguiente código (notar que omite los títulos de nivel 1):
{autotoc activity="yes" levels="2:3:4:5:6" align="page"}
Crear y editar páginas
Para acceder a estas funciones ya hay que haber iniciado sesión en el sitio.
Crear una página desde la barra de navegación
Para crear una página la forma más directa es entrando a esa página. Cada vez que TikiWiki quiere entrar a una página que no existe, lo primero que te va a proponer es crear la página.
Entonces, una forma útil es escribir en la barra de direcciones del navegador "wiki.chela.org.ar/nombre de la página nueva".
Si la página llegara a existir, entonces el navegador te va a llevar de visita a esa página. En ese caso hay que elegir otro nombre para crear una nueva.
Crear una página desde una página que estamos editando
Cuando estamos editando una página y ya sabemos que esa página va a tener un enlace a otra página, entonces podemos ya poner el enlace a esa nueva página y luego, una vez publicada la página, seguimos el nuevo enlace. Como la página todavía no existe, nos va a proponer crearla de la misma manera que con el método anterior.
El código para hacer un enlace a una página es poner su nombre entre doble paréntesis:
((nombre de la página))
Si es una página que no existe, nos va a dar la opción de crearla. Si la página ya llegara a existir, entonces vamos a visitar una página ya existente.
También podemos hacer que un texto nos enlace a una página. En ese caso separamos el texto del nombre de la página con un signo "|" (pipe o palito o barra vertical):
((nombre de la página|texto))
Nota final a la creación de páginas
Sin importar la forma en que una página haya sido creada, hay que tener en cuenta lo siguiente respecto a los espacios, tildes en los acentos y símbolos:
- El nombre puede tener mayúsculas y minúsculas, espacios, tildes y símbolos.
- A la hora de llamar a esa página dentro de la wiki (por ejemplo en un enlace) hay que escribir el nombre tal como se lo haya escrito originalmente ya que TikiWiki distingue mayúsculas, minúsculas, letras con tildes y espacios. La diferencia en una mayúscula, un espacio o un tilde nos puede llevar a otra página o podemos terminar creando innecesariamente una página nueva.
- A la hora de ingresar a través de la barra del navegador a una página, también se debe poner el texto de la página tal como se la haya nombrado (o sea respetando todos esos caracteres). El asunto es el mismo. Acá el detalle es que una vez que se ingresó a la página la barra de navegación podría reemplazar esos símbolos con otros. Eso solo cuenta para la barra de navegación una vez que ya se ingresó a la página y es algo que podría verse.
- Insistimos, siempre hay que escribir el nombre de la página exactamente igual a como se la llamó en un comienzo.
¡A no confundirse!
Editar páginas
Ya sea cuando creamos una página nueva o cuando editamos una ya existente, vamos a trabajar sobre una interface que es un editor de textos. Esa interface tiene varias cosas:
- Un espacio para escribir.
- Una barra de herramientas.
- Botón de vista previa y botón de guardar.
Enlaces a páginas
Como en este texto hablamos de crear páginas a partir de enlaces, vamos a profundizar un poco en este asunto.
Antes mencionamos que el código para crear un enlace a una página es poner su nombre entre doble paréntesis:
((nombre de la página))
Tomamos esta misma página como ejemplo, pero podría ser cualquier otra página de este sitio. Un enlace hacia acá se ve así: Machete para hacer algunas cosas en esta wiki. Si le hacen click van a ver que vuelve a cargar esta página.
Este código puede tener varias modificaciones. La modificación más básica es que la página tenga un nombre y el enlace muestre otro texto. Para eso se separa el nombre de la página del texto que quiero que se lea con una barra vertical (llamada también pipe o pleca):
((nombre de la página|texto que enlaza a esa página))
También haciendo un enlace a esta misma página de ejemplo: uso el texto que se me canta. Usé el texto que se me canta pero si hacen click ahí van a volver a esta página.
Usar imágenes
El proceso de uso de imágenes no es tan directo como uno pensaría pero tampoco es rocket science.
Los pasos normales son dos: subir la imagen (o las imágenes) a la galería de archivos y luego ubicarlas en el texto. Lo que le suma pasos al asunto es ubicar en el lugar correcto las imágenes en la galería y poner la imagen en la página de la forma deseada.
Subir imágenes
Al editar una página, en la barra de herramientas del editor está el ícono de una imagen: . Al hacer click ahí se abre la interface para subir imágenes. El "Modo avanzado" permite elegir la Galería (que sería algo así como la carpeta) donde subir la imagen. Las imágenes se puede arrastrar hasta el "Drop files" o elegir con una ventana de explorador. Una vez elegidas las imágenes, van a aparecer en miniaturas. Ahí se debe hacer click en "upload".
Una vez que la imagen subió va a aparecer la imagen con un código debajo, además de la opción de usar la imgan. De ambas maneras se obtiene el código básico para poner una imagen, que al hacer click en usar lo inserta en el texto de la página, y ese código suele ser algo así:
{img fileId="107" thumb="box"}
Obvio que se puede cambiar ese código de lugar o modificarlo. A esto vamos.
Usar imágenes
La documentación de TikiWiki sobre el plugin img es muy clara y con buenos ejemplos para el uso de imágenes. Acá solo veremos lo más básico.
Cuando uno sube una imagen el código propuesto suele ser algo parecido a lo siguiente:
{img fileId="107" thumb="box"}
El "fileId" corresponde al número id que el programa le asigna al medio cargado y ese número hay que saberlo para poder usar la imagen. Ese código además incluye "thumb="box"", que lo que hace es generar una miniatura de la imagen. Entonces, la imagen se ve así:
Con éste otro código la imagen va a ser tan ancha como el espacio del texto sin superar el ancho de la imagen misma:
{img fileId="107"}
Que se ve así:
Ya que estamos jugando con esta imagen, vamos a usar el siguiente código:
{img fileId="107" button="n" thumb="box" desc=desc max="300"}
Ese código lo que hace es poner la descripción de la imagen ("desc=desc") y la muestra en la página con un tamaño máximo de 300px ("max="300"").
Usar otros tipos de archivos
Todos los archivos hay que subirlos a la galería y se toman desde ahí.
Archivos PDF
Ejemplo de código para mostrar un archivo .pdf que se abre en una pestaña aparte:
{file type="gallery" fileId="63" showicon="y" browserdisplay="y"}
Resultado:
Más información:
https://doc.tiki.org/PluginFile
Archivos de sonido
Ejemplo de código para poner un reproductor con un archivo .mp3:
{mediaplayer src="https://wiki.chela.org.ar/tiki-download_file.php?fileId=67" type="mp3"}
Resultado:
Más información:
https://doc.tiki.org/PluginMediaplayer
Insertar videos desde otras plataformas
Para insertar un video desde YouTube o Vimeo existe un plugin específico para cada una de esas dos plataformas. Requiere únicamente el enlace.
Desde otras plataformas (o método alternativo para YouTube o Vimeo) hay que usar el código para incorporar (embed) con el plugin HTML. Ojo que algunas plataformas no dan ese código (por ejemplo, los shorts de YouTube no lo tienen). El plugin HTML requiere aprobación posterior, no todas las cuentas tienen capacidad de aprobar plugins (los admin seguro que sí).
Usamos un video de timelapse de circo alojado en Vimeo como ejemplo.
Este es el código para incorporar que nos da Vimeo:
<div style="padding:56.25% 0 0 0;position:relative;"><iframe src="https://player.vimeo.com/video/541860822?badge=0&autopause=0&player_id=0&app_id=58479" frameborder="0" allow="autoplay; fullscreen; picture-in-picture; clipboard-write; encrypted-media; web-share" referrerpolicy="strict-origin-when-cross-origin" style="position:absolute;top:0;left:0;width:100%;height:100%;" title="2015-12_Espacios_Circo.mp4"></iframe></div><script src="https://player.vimeo.com/api/player.js"></script>
Ese código se incorpora al plugin HTML, ya sea con la interface del plugin (buscarlo en el botón de "ayuda" que está arriba a la derecha) o usando su código:
{HTML()}<div style="padding:56.25% 0 0 0;position:relative;"><iframe src="https://player.vimeo.com/video/541860822?badge=0&autopause=0&player_id=0&app_id=58479" frameborder="0" allow="autoplay; fullscreen; picture-in-picture; clipboard-write; encrypted-media; web-share" referrerpolicy="strict-origin-when-cross-origin" style="position:absolute;top:0;left:0;width:100%;height:100%;" title="2015-12_Espacios_Circo.mp4"></iframe></div><script src="https://player.vimeo.com/api/player.js"></script>{HTML}
El resultado:
Uso de formularios
El tema de los formularios (Formularios-bd) hay que explorarlo bastante más. Se supone que es una de las herramientas más potentes de TikiWiki. Uno de los usos que se les puede dar es el de armar mapas. Lo básico para entender es que un formulario tiene campos y cada set de data ingresada (cada vez que se hace una entrada en el formulario) se denomina tracker.
(Desarrollar)
Uso de mapas
Otro punto potente pero críptico de TikiWiki. Por ahora vamos a ver únicamente el tema de hacer un mapa con los contenidos de un formulario.
(Desarrollar)
Más cosas
Todo lo antes nombrado puede ser encontrado en al barra de herramientas, en el botón de "ayuda" que está arriba a la derecha. Ese botón abre una interface con dos pestañas: una de la edición directa de texto (syntaxis help) y otra de ayuda de plugins. Notar que en la ayuda de plugins se puede hacer click en el signo de interrogación que te lleva directo a la documentación de tiki wiki, o en el ícono del plugin que despliega la interface para su uso, donde se pueden manipular las opciones básicas.