Los wikis son excelentes formas de colaborar en la información, ya sea para su documentación interna o un sitio web público o directorio como Wikipedia. El único problema es que los wikis a menudo son complicados de crear y usar, como se vio fácilmente en nuestro tutorial sobre cómo construir tu propia wiki. Utilizan un lenguaje de marcado inusual dentro de una interfaz de usuario a menudo con fecha. Está lejos de sorprender que es difícil lograr que las personas contribuyan a los wikis..
Hoy en día, muchos sistemas de administración de contenido funcionan con Markdown, el lenguaje de marcado de texto simple que se convierte fácilmente a HTML. Es una forma mucho más sencilla de escribir texto con formato. Torchpad tomó la simplicidad de Markdown y la combinó con el poder de una wiki para hacer un motor de wiki mucho más simple.
En este tutorial, aprenderá todo lo que necesita para crear su propia wiki con Markdown en Torchpad y lograr que su equipo colabore con una wiki que sea fácil de usar.
Una vez que se haya registrado en una cuenta de Torchpad, se creará automáticamente un nuevo wiki con un nombre basado en su dirección de correo electrónico. Luego verás la página de inicio de tu wiki..
Torchpad te prepara con un ejemplo de página de inicio.Agrega una nueva página a tu wiki haciendo clic en Nueva pagina Botón en la parte superior izquierda de la pantalla. En la hoja que aparece, escriba el nombre de su nueva página en la Nombre de la página campo. Por ahora, deja el Camino de dir campo en blanco, y haga clic en Crear.
Escriba un nombre para su nueva página.La nueva página que acaba de crear estará en blanco, guarde el título que le dio. Haga clic en el Editar botón en la parte superior derecha para comenzar a agregarle contenido, y verá la vista de edición de esa página.
La vista de edición contiene todas las herramientas que necesitarás.En la vista de edición, puede usar cualquier sintaxis normal de Markdown, junto con las adiciones de GitHub-Flavored Markdown. Los botones a lo largo de la parte superior se pueden usar para insertar rápidamente los símbolos necesarios para cosas como encabezados, listas y énfasis.
Hay algunos atajos de teclado que puede usar, que se muestran en los botones a los que corresponden. Guarda tus cambios con Comando-S, y salir de la vista de edición con Comando-B. prensa Comando-D para obtener una vista previa de cómo se verá la página en su estado actual, lo que es útil para verificar si el Markdown se interpretará de la manera que usted quería. Si no está en la vista de edición, presione Comando-E para entrar en ella.
También puede agregar páginas dentro de las carpetas, si desea agrupar páginas o asignar URL a las páginas con varias partes. Para ello, al hacer clic. Nueva pagina, agrega la ruta que deseas para la página en el Camino de dir campo. Por ejemplo, si desea que la página de Queso se encuentre en / Alimentos / Lácteos / Quesos, tipo "queso" en el Nombre de la página campo, y “Alimentos / Lácteos” en el Camino de dir campo.
Las carpetas se pueden anidar tan profundamente como quieras.Hacer clic Crear para crear la nueva página, y verá la nueva página en la estructura de carpetas que especificó.
Al editar una página en Torchpad, hay un par de cosas adicionales que puedes hacer que no están en Markdown estándar. Lo más importante es que hay una sintaxis especial para crear un enlace interno (un enlace a otra página en el mismo wiki).
Para enlazar a otra página, rodee el nombre de la página en dos conjuntos de corchetes como este: [[Nombre de la página]]. Esto creará automáticamente el enlace para usted, en lugar de tener que encontrar la URL completa para poner en un enlace de Markdown.
Si desea vincular a una página, pero mostrar un texto diferente como enlace, puede hacerlo también. Simplemente coloque primero el texto que desea mostrar, seguido de un carácter de canalización y luego el nombre de la página, como esto: [[Texto a mostrar | Nombre de la página]].
No es necesario encontrar URL largas para enlazar a las páginas.Cuando visite la página, verá que el enlace muestra el texto antes de la canalización, pero enlaza con la página que lleva el nombre de la tubería..
Los enlaces no tienen que mostrar el nombre de la página a la que se vinculan.Las imágenes se pueden agregar a cualquier página al igual que con Markdown normal, pero Torchpad también las alojará si aún no están en línea con una URL para especificar. Arrastra y suelta la imagen en la página y se cargará en Torchpad.
Las imágenes se pueden colocar en cualquier parte de una página..Una vez que se haya cargado, se insertará automáticamente el Markdown para mostrar la imagen. El texto alternativo se establecerá en el nombre de archivo de la imagen que arrastró.
Torchpad hace todo el trabajo cuando se inserta una imagen.Para agregar una lista de códigos a una página, simplemente escriba tres comillas en las líneas inmediatamente antes y después del código.
Insertar algún código en tu página.En la página en vivo, el código se cambiará a una fuente adecuada y se aplicará el resaltado de sintaxis para facilitar la lectura..
El código es mucho más fácil de leer en un bloque de estilo separado.Para cambiar el resaltado de sintaxis para que coincida con el idioma en el que está escrito el código, escriba el nombre del idioma directamente después del primer conjunto de marcas de retroceso, como "rubí. Esto asegurará que el código se resalte correctamente, recogiendo las palabras clave de ese idioma.
Además del código, puede agregar fórmulas matemáticas a sus páginas usando MathJax. Torchpad trata a MathJax como un lenguaje de código, así que rodee su código de MathJax con triplicados, y especifique el idioma mathjax.
Usa la sintaxis de MathJax para incrustar fórmulas matemáticas.El código de MathJax se representará en la página wiki en vivo como cabría esperar..
Las fórmulas renderizadas son mucho más agradables que el texto plano.También puede poner MathJax en línea, igual que el código puede estar en línea en una oración. Para hacer esto, rodee el código con signos de dólar, y rodee ese con backticks individuales.
Inline MathJax es como el código en línea, con $ símbolos adicionales.Igual que antes, el MathJax se renderizará en la página en vivo, pero se diseñará para que encaje en línea.
Inline MathJax es útil para fórmulas cortas de una línea.Una vez que hayas terminado de editar una página, querrás mostrarla al mundo. Para publicar una página, finalice la edición y salga de la vista de edición. Haga clic en Borrador junto al botón Editar, y elijaPublicar o Establecer privado.
Las páginas individuales pueden ser públicas o privadas..Eligiendo Publicar hace que la página sea accesible para cualquier persona sin haber iniciado sesión en Torchpad. Escoger Establecer privado para que la página solo sea accesible para las personas que son autores en tu wiki. Si alguien que no forma parte de tu wiki intenta acceder a una página privada, verá un mensaje de "no encontrado", como si la página no existiera en absoluto..
Hay algunas configuraciones que puedes cambiar para un wiki de Torchpad. Hacer clic Ajustes A la izquierda, arriba de la lista de páginas, para acceder a ellas..
No hay muchas configuraciones, pero ¿qué más podrías necesitar??los Subdominio La opción te permite cambiar la URL de tu wiki. Puedes elegir lo que quieras aquí, y la URL de tu wiki se convertirá en http://what-you-chose.torchpad.com.
los Nombre de wiki opción cambia el nombre de toda la wiki. El nombre que elija se muestra en la barra de título de su wiki y no tiene que coincidir con el subdominio que elija.
Comprobar el Wiki privado casilla de verificación para hacer todo el wiki privado. Esto significa que solo los miembros de tu wiki pueden verlo..
Finalmente, tome su ID de Google Analytics del sitio de Analytics y péguela en el identificación de Google Analytics campo. Esto registrará cualquier visita a su wiki en Google Analytics para permitirle monitorear el tráfico hacia ella..
La parte importante de una wiki es la colaboración, lo que significa que necesitas agregar más personas. Para empezar, haga clic en Ajustes, y luego navegar a la Miembros página.
Los wikis están diseñados para la colaboración, así que agregue más autores..Agregue un nuevo miembro escribiendo su dirección de correo electrónico en el Email campo. Luego, elige un Papel. Un propietario tiene privilegios administrativos completos, lo que significa que pueden cambiar todo lo que puedas, incluso cambiar la configuración. Un autor puede editar páginas, pero no puede cambiar la configuración de la wiki en su conjunto. UNA observador Es simplemente alguien que puede acceder a páginas privadas de la wiki..
Los miembros que agregues ya deben tener una cuenta de Torchpad; intentar agregar a alguien cuya dirección de correo electrónico no esté registrada con Torchpad generará un error.
Una vez agregado, un miembro puede ser eliminado haciendo clic en retirar junto a su nombre en la lista de miembros.
Si desea llevar su wiki a otra parte, o simplemente desea una copia de seguridad de la misma, puede descargar los archivos de Markdown en un archivo zip. Hacer clic Ajustes, y luego haga clic Exportar.
Un archivo zip es genial como copia de seguridad de tu wiki.Hay dos opciones, pero como Torchpad todavía está en versión beta, solo Descargar Zip está disponible. Haga clic para descargar el archivo zip que contiene todos los archivos de Markdown..
En el futuro, el Git Clone La opción estará disponible, lo que le permite descargar el wiki como un repositorio git, incluido todo el historial de edición de cada página..
En este tutorial, te he mostrado cómo agregar y editar páginas en un wiki de Torchpad, publicar el wiki y agregar colaboradores. Un wiki puede ser útil de muchas maneras diferentes, y Torchpad lo hace tan simple como podría serlo. Puede que no tenga todas las características de las herramientas más complicadas, pero aún es posible hacer una gran wiki.
Accentsconagua
Share