Manual de Construcción de Compendios

20 de marzo de 2024 09:20

Lo siguiente contiene información específica para Socios en el Mercado de Roll20.

Aquellas personas interesadas en crear Compendios deben tener un sólido conocimiento del sistema de reglas que les gustaría crear y idealmente tener cierta familiaridad con HTML, JSON, redacción wiki y/o creación de Datos Estructurados. Si estás interesado en obtener más documentación o programar una reunión con uno de nuestros Productores de Contenido para un proceso de integración individual, por favor contacta a licensing@roll20.net.

Recomendación

Si no estás familiarizado con ninguno de los anteriores, actualmente recomendamos contratar a uno de nuestros contratistas de conversión de terceros verificados para la creación de Expansión de Compendios.

Cualquier violación o vandalismo del Compendio resultará en su eliminación.

Página de Herramientas del Compendio

Para acceder a la página de Herramientas del Compendio necesitas tener acceso de edición para al menos una Expansión de Compendio. Esto debe ser configurado por un Administrador de Roll20; contacta a licensing@roll20.net o envía un ticket de soporte a este Centro de Ayuda.

Si tienes el permiso de “Propietario” de compendio tienes acceso de edición a todas las Expansiones dentro del(os) libro(s) que posees.
Si tienes el permiso de “Editor” de compendio tienes acceso de edición a todas las Expansiones de las cuales eres editor.
Si tienes el permiso de “Delegado” y eres un creador de mercado con al menos una Compendio vinculado a tu cuenta, tienes acceso de edición a todas las expansiones en tu página de Gestión de Artículos.

En Roll20 puedes acceder a la página de Herramientas del Compendio haciendo clic en el menú desplegable desde tu nombre en la esquina superior derecha y seleccionando Herramientas del Compendio.

Desplegable de Herramientas del Compendio.jpg

Actualmente, la página de Herramientas del Compendio proporciona la capacidad de ver o eliminar páginas dentro de un compendio que posees. Esto se logra seleccionando primero el Libro del Compendio, luego la Expansión del Compendio y haciendo clic en el botón Mostrar junto a Ver Páginas.

Primero, elige.jpg

Desde aquí puedes hacer clic en los nombres de página con hipervínculo para visitar una página específica o hacer clic en las casillas de verificación a la izquierda del nombre de la página para seleccionarlas. Las páginas seleccionadas pueden eliminarse todas a la vez haciendo clic en el botón Eliminar Sección. Además, si deseas ordenar por categoría, puedes hacerlo usando el menú desplegable debajo de Categoría.

Desde aquí.jpg

Construyendo un Compendio

Creación de Páginas

Una vez que te conviertas en Socio del Mercado de Roll20 y recibas la aprobación para crear Expansiones de Compendio, se te dará acceso a un "libro" en blanco para comenzar a editar y llenar con contenido. Durante el proceso de creación del área de ensayo para el libro, querrás reunir una lista de Categorías necesarias para tu sistema de juego (Reglas, Monstruos, Objetos, Hechizos, etc). Es importante tener la estructura organizativa clara antes de comenzar a trabajar en el Compendio; si estás creando una expansión para un sistema como D&D 5e, te proporcionaremos una plantilla.

Una vez que te proporcionen la URL del nuevo libro de Compendio por parte del Equipo de Roll20, crea nuevas páginas agregando el nombre de la nueva página al final de la URL en la barra de direcciones y presionando Enter. (ejemplo: https://roll20.net/compendium/MyBook/Página de Prueba) Para caracteres especiales como espacios, paréntesis y apóstrofos: una vez que presiones Enter, el nombre de la página se ajustará automáticamente para usar Código HTML para los caracteres ASCII necesarios.

NOTA: Por favor, no uses dos puntos ":" en las URL de las páginas. Estos se interpretan como categorías por la URL y harán que tu página no se pueda usar

Dado que la página aún no existe, el Compendio mostrará una página que dice:

No encontrado: [nombre de la página]

Actualmente no tenemos una página que coincida con ese nombre. ¿Quieres intentarlo de nuevo?

¿O tal vez te gustaría crear esta página?

Debajo de esto habrá un menú desplegable para la categoría a la que deseas agregar la página. Si esta es la primera página, no tendrás ninguna categoría disponible para elegir en el menú desplegable aparte de Varios para comenzar, así que aquí es donde debes comenzar a agregar tus propias categorías.

NOTA: Las páginas creadas en las categorías de Varios e Índice del Libro no pueden ser editadas por nadie excepto un desarrollador de Roll20. Por favor, evita estas categorías.

Una vez que hayas establecido o añadido una categoría a la página, haz clic en el botón azulCrear Página para crearla. Esto te llevará a la página recién creada para comenzar a editarla.

Editar una página

Una vez creada, una página de Compendio se dividirá en dos partes distintas: Un editor de textoy, debajo, una tabla de atributos.

Editor de Texto

El editor de texto puede cambiar entre una versión WYSIWYG y una versión HTML haciendo clic en el botón</>, que es el último botón del lado derecho de la barra de herramientas del editor de texto. Asegúrate de hacer clic en el botón</> después de ingresar tu HTML para que la página se actualice antes de guardar. El editor de texto es donde incluyes biografías de monstruos/clases/razas, hazañas y habilidades. El contenido de la página se puede leer fuera de cualquier bloque de estadísticas creado. Utilice etiquetas de encabezado (<h1>, <h2>, <h3>, etc.) de manera consistente para dividir su contenido para una integración eficiente. Es increíblemente importante que el formato del texto también se mantenga consistente en todo el libro del Compendio.

Carga de imágenes

La mayoría de las ediciones se pueden realizar en la dirección web estándar "roll20.net". Para cargar imágenes, las URL deben ser editadas en "app.roll20.net". Luego, las imágenes se pueden arrastrar al área correspondiente y se cargarán automáticamente. El compendio de Roll20 cambia automáticamente el tamaño y la resolución de las imágenes. Si esto no es deseado, se debe editar la etiqueta HTML de cada imagen.

Iluminación Dinámica

No es necesario crear manualmente enlaces de página dentro del texto de las páginas de su Compendio. La vinculación de páginas se realiza automáticamente después de que Roll20 inicie una compilación del Compendio. Este proceso automatizado escanea el contenido de texto de cada entrada del Compendio para encontrar cadenas que coincidan con los títulos de página disponibles. Cuando se encuentra una coincidencia (el nombre de la página y la cadena deben ser idénticos excepto por la mayúscula inicial), la cadena se vincula automáticamente a la página coincidente. Este proceso se realizará cuando el Compendio esté en vivo.

Nota: El autovinculador puede ser sociable. Tenga cuidado al nombrar páginas con una frase común como "Magia"

Creación de páginas de lista

Para listas grandes de páginas relevantes, muchos sistemas de juegos pueden beneficiarse de una lista buscable.

Crea una nueva página. Para una convención de nomenclatura, sugerimos: <Category> Lista. Las páginas de Habilidades, Hechizos, Monstruos, etc. generalmente deben estar en la categoría de Listas. Ejemplo: Lista de Hechizos
Haz clic en "Editar Atributos" y establece "data-Lista" a {"términosDeBúsqueda":[], "columnas":[], "filtros":[], "ordenables":[]}. Este atributo debería crearse automáticamente por defecto, pero es posible que necesites Editar/Guardar el contenido de la página para que aparezca.
Ve a "Editar Contenido", establece "Lista para Categoría" al valor deseado y añade un nuevo Atributo de Búsqueda: Atributo = “Categoría”, Valor = <Name of Category>, y Coincidencia = “Exacta”. Asegúrate de guardar tus ediciones.
Editando la lista
- "Columnas de Visualización de Lista" - Esto controla lo que aparece debajo de cada columna de artículo. Esto no se utiliza si se ha definido una tarjeta de artículo para la categoría.
  - "Atributo" - El nombre del atributo a mostrar.
  - "Orden" - El orden en el que se muestra este atributo.
  - "Reemplazo de valor" - Una cadena con formato .json de pares clave/valor para reemplazar ciertos valores.
  - Por ejemplo, {"0":"Cantrip"} hace que los hechizos de nivel 0 se muestren como "Cantrip" en la lista de resultados.
  - "Ordenable" - Esto está obsoleto. El ordenamiento ahora se controla en la sección "Botones de ordenamiento"
- "Atributos de filtro" - Esto controla los filtros predefinidos disponibles.
  - "Cualquiera" - Devuelve cualquier resultado donde el valor del filtro coincide con cualquier parte del valor del atributo.
  - "Exacto" - Solo devuelve resultados donde el valor del filtro coincide exactamente con el valor del atributo.
  - "Inverso" - Solo devuelve resultados donde el valor del filtro no coincide con el valor del atributo.
  - "Atributo" - El nombre del atributo por el que se filtrará.
  - "Orden" - El orden en el que se muestra este filtro.
  - "Tipo de filtro" - El tipo de entrada para el filtro.
  - "Valor predeterminado" - El valor predeterminado para el filtro.
  - "Coincidencia" - Cómo devuelve el filtro el resultado.
  - "Valores de entrada del filtro" - Para los tipos de filtro de selección y selección múltiple, esta es una cadena formateada en .json que determina qué valores están disponibles. Si está en blanco, se rellenará la selección con todos los valores posibles.
- "Botones de ordenación" - Para definir los atributos ordenables.
  - "Alfabético" - Los resultados se ordenan alfanuméricamente, con los resultados numerados que se devuelven primero. "19 ft." y "40 Winks" se listarían primero antes de "Ale of Drunkening" y "Potion of Sobering", etc.
  - "Numérico" - Los resultados se ordenan numéricamente. El código encontrará el primer valor numérico y lo usará para ordenar, es decir, "Speed 30 ft. (15 ft. flying)" se analizará como "30".
  - "Atributo" - El nombre del atributo por el que se va a ordenar.
  - "Orden" - El orden en el que se muestra este botón.
  - "Título de visualización" - El texto que se mostrará en el botón, si es diferente al nombre del atributo.
  - "Tipo" - Cómo se ordenan los resultados.

Tabla de atributos

A continuación del Editor de texto se encuentra la Tabla de atributos. Esta área es para ingresar contenido de bloque de estadísticas tradicionales que es consistente en todas sus Categorías: Clase de armadura, Idiomas, Debilidades, Inmunidades, PV, PX, Percepción pasiva, etc., para Monstruos. Peso, Tipo de objeto, Clase de armadura, Calificación de sigilo para Objetos. Tipo de daño, Peso, Propiedades, Dado de daño para Armas. Comúnmente, estos atributos ya se desglosan en una tabla dentro de su libro de reglas para llevarlos a sus entradas del Compendio.

Añadir atributos

Cuando estás empezando con una nueva página, no habrá atributos asignados a ella. Para empezar a añadir atributos, haz clic en el enlaceEditar atributosa la derecha del encabezado de Atributos. Esto no solo revelará Atributos ocultos (si los hay), sino que también agregará un nuevo enlace en la parte inferior de la Tabla de Atributos etiquetado+ Agregar Nuevo Atributo.

Aparecerá un menú desplegable etiquetadoElija un atributo...en una nueva fila de la tabla. Si ha creado Atributos anteriormente en otras entradas, esos Atributos aparecerán como opciones en este menú desplegable. La primera opción del menú esCrear nuevo atributo...y probablemente será la que utilice mayoritariamente hasta que tenga creados todos los atributos que desee.

A_screenshot_of_the_Create_New_Attribute_field_of_a_Compendium.png

Una vez seleccionado, aparecerá un campo vacío a la derecha del menú desplegable y un campo más pequeño justo debajo del menú desplegable con el texto temporal , "New Attr Name", en su interior. Como era de esperar, el campo "Nuevo nombre de atributo" es para el nombre del atributo que desea crear. El campo en blanco de la derecha es el valor que tiene la entrada actual para este nuevo Atributo. En la imagen de ejemplo anterior, el atributo que se está creando lleva la cuenta del "Elemento" de una entrada. Asigno al elemento de esta entrada el valor "Fuego". El valor de un Atributo puede ser numérico o puede ser una cadena.

Siga añadiendo los atributos que necesite de esta forma, creándolos desde cero o eligiéndolos del menú desplegable. Cuando haya terminado, desplácese hasta el encabezamiento Atributos y hasta donde solía estar el enlaceEditar atributos. Mientras esté en el modo de edición, la etiqueta de este enlace cambiará aGuardar atributos. Al hacer clic en esta opción no sólo se guardan los cambios, sino que también se registran los atributos recién creados para que puedan volver a aparecer en una nueva página.

Editar o borrar atributos

No puede eliminar los atributos hasta que no los haya guardado primero. Una vez guardados, puede volver a hacer clic en el enlaceEditar atributospara regresar al modo de edición. Cualquier Atributo añadido/creado previamente tendrá un icono de bolígrafo y papelera que aparecerá en la parte derecha de la fila de Atributos cuando pase el ratón por encima de cualquiera de ellos. Haciendo clic en el icono del bolígrafo se abrirá de nuevo el Atributo para poder editarlo, mientras que el icono de la papelera lo borrará. Recuerde hacer clic enGuardar atributospara salir del modo de edición y guardar los cambios.

Importando Páginas desde Archivos JSON de Compendio

La página de Herramientas del Compendio incluye un método alternativo para construir Expansiones de Compendio que puede ser mucho más rápido que crear páginas manualmente.

El Importador de JSON de Compendio te permite definir cualquier número de páginas en un archivo JSON, luego cargar ese archivo para crear instantáneamente esas páginas en la Expansión de Compendio deseada.

Para comenzar a importar contenido de Compendio, primero necesitarás formatear los datos de página de tu Compendio en un archivo .json de acuerdo con la especificación JSON de Compendio de Roll20. El siguiente ejemplo ilustra el esquema JSON completo del Compendio:

bloque de código 1.JPG

Este JSON de Compendio define tres páginas: “Mansión Embrujada,” “Cementerio” y “Esqueleto Espeluznante.” Las dos primeras páginas están en la categoría de “Lore”, mientras que la página “Esqueleto Espeluznante” está en la categoría de “Monstruos”.

Observa cómo las dos primeras páginas se definen como “TÍTULO_DE_PÁGINA”: “HTML_DE_PÁGINA”, mientras que la página “Esqueleto Espeluznante” se define con un formato ligeramente más complejo:

bloque de código 2.JPG

El formato más simple utilizado por “Mansión Embrujada” y “Cementerio” es una forma abreviada para cuando solo deseas importar contenido HTML, mientras que el formato “expandido” es necesario cuando también deseas importar Atributos.

Una vez que tu archivo JSON de Compendio esté preparado, navega a la página de Herramientas del Compendio de Roll20, luego usa los menús desplegables para seleccionar la Expansión de Compendio en la que deseas importar.

Una vez que hayas seleccionado una Expansión, haz clic en el botón “Mostrar” junto al encabezado “Importar Páginas desde JSON” para revelar la interfaz de importación de JSON.

A continuación, usa el botón “Examinar” para cargar el archivo JSON de Compendio desde tu computadora. Finalmente, haz clic en “Importar Páginas” y espera unos momentos para que se complete el proceso. Cuando la importación finalice, verás un encabezado de “Páginas Creadas” y/o un encabezado de “Páginas Actualizadas”. Debajo de cada uno de estos encabezados, verás una lista de todas las páginas que fueron creadas/actualizadas por la importación de JSON.

Integración del compendio

La funciónRoll20 Compendiumes un repositorio de información como reglas, hechizos, objetos y monstruos para sistemas de juego selectos de licencia abierta. Al designar que su hoja es compatible con un Compendio, los jugadores tendrán acceso directo a ese Compendio en la barra lateral derecha durante el juego.

Designar la compatibilidad de su hoja

Para designar la compatibilidad con un compendio, sólo tiene que incluir el nombre abreviado del compendio en el campo "compendio" de su archivosheet.json. Para ver un ejemplo, consulte el archivosheet.json de la Hoja OGL de 5ª Edición de Roll20en Github.

Si está utilizando una hoja personalizada, hay un ajuste en la página Configuración del juego que le permitirá seleccionar manualmente un Compendio para utilizarlo en su juego.

Habilitar la función de arrastrar y soltar para su hoja

Además de la compatibilidad básica, tiene la opción de indicarle a Roll20 cómo incluir directamente la información del Compendio en su hoja. Esto permite a los jugadores arrastrar y soltar una entrada del compendio directamente en su hoja, y Roll20 rellenará los valores que usted especifique. Para ello, debe añadir la clase compendium-drop-targeta la etiquetadivque rodea la sección que desea rellenar. Para las secciones que se repiten, colóquelo dentro de la etiquetafieldset. A continuación, añada el atributoaccept="Attribute Name"a una o varias etiquetasinput, select, textarea . He aquí un ejemplo sencillo que sería compatible con la entradaBola de fuegodel Compendio SRD de 5ª Edición.

<fieldset class="repeating_spells"><div class="compendium-drop-target"><input type="text" name="attr_SpellName" accept="Name" /><input type="text" name="attr_SpellDamage" accept="Damage" /><select name="attr_SpellSchool" aceptar="Escuela"><valor de opción="Abjuración">Abjuración</opción><valor de opción="Conjuración">Conjuración</opción><valor de opción="Adivinación">Adivinación</opción><valor de opción="Encantamiento">Encantamiento</opción><valor de opción="Evocación">Evocación</opción><valor de opción="Ilusión">Ilusión</opción><valor de opción="Nigromancia">Nigromancia</opción><valor de opción="Transmutación">Transmutación</opción></select><tipo de entrada="casilla de verificación" nombre="attr_SpellRitual" valor="Sí" aceptar="Ritual"></div></fieldset>

El<Attribute Name>enaccept="<Attribute Name>"debe coincidir con el nombre de un Atributo de la sección inferior de la entrada del Compendio. Consulte cada Compendio individual para obtener un listado de los Atributos disponibles.
Para las etiquetasinputytextarea, se insertará directamente el valor del Compendio.
Para las etiquetasinput[type=checkbox]yinput[type=radio], la casilla quedará marcada/radio seleccionada si el valor del compendio coincide exactamente con el atributo value de la etiqueta.
Para las etiquetasseleccione, se seleccionará la opciónque coincida con el valor de Compendium en el atributo value O en el texto dentro de la etiqueta option.
Puede utilizaraccept="Content"si desea recibir el contenido en texto plano de la entrada (el contenido situado encima de la cabecera "Atributos").
Puede utilizaraccept="data"si desea recibir todos los atributos de una página de compendio en formato json.

Tenga en cuenta que el proceso de cambio de estos valores desencadenará eventos del Sheet Worker local y de la API remota exactamente igual que si el propio usuario hubiera introducido los datos a mano. Así que también puede crear entradas ocultas para aceptar datos del Compendio y luego procesar esos datos más a fondo utilizando Sheet Workers si desea un mayor control sobre cómo se presentan los datos. Consulte la sección Hechizos en la hoja de la OGL de5ª Ediciónpara ver un ejemplo avanzado de este proceso.

Compendio Botones

El botón del compendio se puede utilizar para abrir una entrada del compendio directamente desde una hoja de personaje, del mismo modo que si hiciera clic en una entrada del compendio de la aplicación. Esto se puede utilizar como una forma más cómoda de acceder a las reglas y descripciones, por ejemplo, para un hechizo, el botón del compendio se puede utilizar para ver fácilmente la descripción completa de ese hechizo.

La sintaxis es<button type="compendium" value="<entryname>">. He aquí algunos ejemplos válidos:

<botón tipo="compendio" valor="Bardo"></botón>

Se trata de una sintaxis válida, pero dado que existe tanto una entrada del compendio de Clases como una de Monstruos titulada "Bardo", la ventana resultante le presentará una selección de entradas en lugar de ir directamente a una de ellas.

<botón tipo="compendio" valor="Clases:Bardo"></botón>

Esta es la sintaxis preferida. Especificar la categoría garantiza que sólo habrá una coincidencia.

<tipo de botón="compendium" valor="Classes:Bard#Spellcasting"></botón>

Si añade un "#" seguido del título de un subtítulo, la ventana se abrirá directamente en esa sección. Este ejemplo abrirá la entrada de la clase Bardo, previamente desplazada a la sección de Hechicería. Si no se encuentra ninguna sección con ese nombre, la ventana se abrirá desplazada hacia arriba. Arrastrar una entrada desde el compendio contiene un atributo específico para este botón,uniqueName, una cadena que contiene tanto la categoría como el nombre de la entrada, lo que garantiza que sólo habrá una coincidencia en el compendio. Así, la sintaxis de este botón en una sección de caída de compendio es la siguiente:

<button type="compendium" name="attr_infoButton" accept="uniqueName"></button>

También puede añadir una subsección a este atributo a través de sheetworker, de modo que si el objeto caído del compendio era un monstruo y desea que el botón abra directamente la sección "Acciones", puede establecer el valor del botón enuniqueName + "#Actions".

Ver también

Compendio- Cómo manejar los Compendios en general
Creación de fichas de personaje- Otros aspectos de la creación de fichas de personaje
OGL de 5ª Edición de Roll20 - Una hoja que tiene integrado el acceso al Compendio