3. Está chupao con BookStack
Toda la edición del libro la puedes hacer directamente en aquí, en https://libros.catedu.es/ .
La edición es tan intuitiva que sólo comentaremos los aspectos más avanzados.
Seleccionando el formato
Para garantizar una apariencia homogénea y una exportación coherente a distintos formatos de descarga, sólo se pueden modificar los estilos de cada párrafo de texto. Es decir, puedes decir si el texto que estás escribiendo es un párrafo, un título grande, mediano, una cita... pero no podrás especificar que el texto de esa cita sea en rojo o con la tipografía sheriff.
Si queremos usar una caja de información como ésta en más de un párrafo consecutivo, presiona Mayus+Enter para cambiar de línea. Si presionas Enter se iniciarás otra caja.
Si quieres volver al formato normal, Enter y selecciona Paragraph o lo que quieras en la caja de selección de formato.
¡Ojo con el copia-pega!
Al copiar y pegar de una web, un documento online... si clicas con el botón derecho del ratón y seleccionas "Pegar", o haces Ctrl+V, estarás pegando con los estilos de la fuente, lo que poco a poco irá ensuciando el libro. Además, las imágenes no estarán en nuestra base de datos, si no que enlazarán con la fuente inicial. Esto impedirá que las imágenes se muestren en el .PDF si alguien lo quisiera descargar, a parte de que la imagen puede desaparecer en el futuro, pues no la tendremos nosotros.
Si tienes un documento en el que lo tienes todo ya escrito, es tentador copiar-pegar y dejarlo tal cual, pero con dos sencillos pasos, quedará toda la página lista para su correcta visualización y descarga.
- Copia el contenido -> pégalo en la página -> selecciona lo copiado -> clica en limpiar formato
en la barra de herramientas de edición. - Con cada imagen que hayas pegado junto con el contenido, puedes hacer lo siguiente: clica con el botón derecho sobre la imagen -> clica en
Copiar imagen-> ahora sí, pega (Ctrl+V)
¿Cómo sé si la imagen está correctamente añadida? En la interfaz de edición, cuando cliques sobre una imagen que está bien añadida a nuestra base de datos, verás que aparece el menú contextual. Si no aparece, no está bien añadida.
Importando contenido ya creado
Con el paso de los años, Aularagón tiene una base de conocimiento considerable, y puede ser que algo concreto que tú quieras añadir en tu libro, ya esté elaborado. Tienes a tu disposición un buscador que busca dentro del libro y de todo el sitio en la barra superior:
La siguiente información ha sido extraída de la documentación oficial de BookStack.
Una vez encuentres información que te valga, para incluir el contenido de una página dentro de otra puedes usar la siguiente sintaxis:
{{@page_id}} o {{@page_id#content_id}}
Estos son algunos ejemplos de esto en uso:
- {{@5}} - Incluye todo el contenido de la página con un id de '5'.
- {{@10#bkmrk-copyright-year}}: incluye el contenido dentro del elemento de id bkmrk-copyright-year en la página con una identificación de '10'.
Simplemente introduce ese código en el editor de la página y luego, cuando se cargue la página, el contenido se recuperará dinámicamente. Esto significa que puede actualizar el contenido al que se hace referencia y mostrará los mismos cambios en cualquier página en la que se incluya el contenido.
Extraer fácilmente el código a insertar
Encontrar la identificación de una página puede ser difícil, por lo que BookStack incorpora una manera rápida y fácil de encontrar etiquetas de inclusión. Vea una página con algún contenido que desee reutilizar. Usa tu ratón para seleccionar algún contenido y verás aparecer una ventana emergente. Por defecto, esto contiene un enlace directo a ese contenido. Si haces clic en el ícono de enlace a la izquierda, cambiará para mostrarte la etiqueta de inclusión para ese contenido. Simplemente copia eso y colócalo en otra página. Elimina el # y la identificación del contenido para incluir todo el contenido de la página en lugar de solo un bloque.
Editar una página importada
Si por el contrario, queremos editar una página en la que sólo vemos el código de inserción {{@12}}, deberemos introducir en la barra de direcciones de nuestro buscador la ruta https://libros.catedu.es/link/12 y ya podremos editarla.
Insertar documentos de Google
Supongamos que tenemos un documento de Google que queremos insertar en nuestro BookStack, vamos pues al código de inserción de Google :
Y lo pegamos en la ventana de código
ATENCIÓN SALE MUY PEQUEÑO para ello modificamos el código indicando el píxeles el ancho y alto, por ejemplo si queremos 800 de ancho y 600 de alto se indica así: width="800px" height="600px"
Un ejemplo lo tienes aquí https://libros.catedu.es/books/arduino-en-el-aula/page/paquete-de-prestamo
Ordenar páginas de un libro
Desde la página principal del libro, clicaremos en "Ordenar" para, posteriormente, arrastrar la página a la posición deseada.