Squiffy - Documentación

Squiffy es una herramienta para la creación de ficción interactiva o librojuegos - esto es, juegos con multiples opciones orientados a la historia y el texto.. Los jugadores navegan a través de la historia o el texto haciendo click en enlaces. En ocasiones este tipo de juegos o historias son conocidos como librojuegos o juegos estilo Elige tu propia aventura.

Squiffy es libre y de código abierto. Crea ficheros HTML y JavaScript, que puedes alojar en tu propia página web, o puedes subirlos de forma gratuita a textadventures.co.uk. También puedes convertir tu juego en APP para dispositvos móviles usando PhoneGap.

El estado del jugador es automaticamente guardado en el propio almacenamiento de su navegador, de esta forma siempre podrán regresar al lugar donde lo dejaron simplemente abriendo de nuevo la página.

Documentación

Secciones y Pasajes
Usando JavaScript
Contando turnos
Limpiando la pantalla
Atributos
Embebiendo texto
Controlando que secciones y pasajes se han visitado
Estableciendo la sección de inicio
Estableciendo el título
Enlaces para continuar
Reemplazando texto
Rotaciones y secuencias
Secciones y Pasajes maestros
Importando ficheros (solo versión línea de comandos)
Personalizando HTML y CSS (solo versión línea de comandos)
Tutorial en castellano

Usando Squiffy

Puedes usar Squiffy en tu propio navegador web
O puedes descargar Squiffy para Windows, OS X o Linux
O puedes usar cualquier editor de texto y compilar los juegos usando la versión de línea de comandos

Ejemplo

Squiffy es una herramienta para crear historias interactivas. Puedes escribir tu historia en un fichero de texto. Cada elección esta representada por [[una seccion]]. Puedes crear enlaces a nuevas secciones colocándolas entre dobles corchetes. [[una seccion]]: Además de las secciones, Squiffy implementa el concepto de pasajes. Esto son secciones de texto que no avanzan la historia. Por ejemplo, puedes hacer click en este [enlace de pasaje], y este [otro enlace de pasaje], pero la historia no avanzará hasta que hagas click en este [[enlace de seccion]]. [enlace de pasaje]: Este es el texto para el primer enlace de pasaje. [otro enlace de pasaje]: Este es el texto para el segundo enlace de pasaje. [[enlace de seccion]]: Cuando una nueva sección aparece, cualquier enlace de pasaje de las secciones previas son deshabilitados.

Editar el ejemplo en ScratchPad →

Publicando tu juego

Squiffy crea ficheros HTML, CSS y JavaScript, por lo que puedes alojarlos en cualquier sitio. No necesitas distribuir tu código fuente .squiffy - todo lo necesario para hacer funcionar el juego está contenido en los ficheros HTML y JavaScript.

Si estás usando la versión web, tan sólo haz click en el botón Publicar para publicar tu juego en textadventures.co.uk. Puedes también elegir “Exportar HTML y JavaScript” en el menú Descargar, esto te entregará un fichero ZIP que puedes alojar en cualquier página web.

Si estas utilizando la app para Windows, OS X o Linux, haz click en el botón Construir para crear los ficheros HTML, CSS y JavaScript en el mismo directorio donde se encuentra el fichero del juego. Esto también te permite abrir el resultado en tu navegador web para que puedas previsualizarlo. Puedes crear un fichero ZIP conteniendo estos archivos y subirlos a textadventures.co.uk, o alojarlos en tu propia página web.

Contribuyendo

Hoja de ruta de desarrollo

Squiffy esta alojado en dos repositorios diferentes de GitHub:

textadventures/squiffy - el compilador de Squiffy
textadventures/squiffy-editor - el editor (ambas versiones web y descargable proceden del mismo código)

Si encuentras un bug, por favor deja un mensaje en Squiffy problema en compilador o en Squiffy problema en editor.

También puedes ir a los foros de Squiffy.

Squiffy es completamente de código abierto, ¡incluyendo esta documentación! El código fuente y la documentación ambos se aloja en GitHub (la documentación es la rama gh-pages).