aerodeslizador: en línea en la nube

PROGRAMA:

NOMBRE

aerodeslizador - ¡aerodeslizador! Documentación

Contenido:

INTRODUCCIÓN

GUI están limitar
Solía ​​hacer presentaciones con software típico de presentación de diapositivas, como OpenOffice / LibreOffice
Impresiona, pero estas herramientas se sienten restringidas y limitantes. Necesito reorganizarme mucho
y moverse, y eso podría significar cambiar cosas de listas de viñetas a encabezados para
texto a imágenes y volver a las listas de viñetas una vez más. Esto sucede a lo largo de todo
proceso. Podría darme cuenta de que algo que era solo una viñeta debe ser una diapositiva, o
que un conjunto de diapositivas por razones de tiempo debe reducirse a viñetas. Gran parte de
la reorganización proviene de ver qué cabe en una diapositiva y qué no, y cómo
Necesito ajustar el ritmo de la presentación y, hasta cierto punto, incluso qué tipo de imágenes puedo encontrar.
para ilustrar lo que intento decir, y si las imágenes son divertidas o no.

Presentación software debo give piensa completar libertad a reorganizar Tu presentation on
cada nivel, no sea único by reorganizando diapositivas

La solución para mí y para muchos otros es usar un lenguaje de marcado de texto, como
reStructuredText, Markdown o similar, y luego use una herramienta que genere una diapositiva HTML
mostrar de eso.

Marcado de texto da piensa la comodidad y libertad a rápida movimiento partes en torno a as piensa
gusta.

elegí reStructuredText, porque lo sé y porque tiene un enorme conjunto de funciones. Cuándo
Leí la documentación de otros lenguajes de marcado de texto, no era obvio si tenían la
características que necesitaba o no.

Pan, rotar y Zoom
Las herramientas que existen para hacer presentaciones a partir del marcado de texto harán presentaciones de diapositivas que tengan
una secuencia de diapositivas de izquierda a derecha. Pero la moda ahora es tener presentaciones que
rotar y acercar y alejar. Una solución de código abierto para eso es impresion.js.

Con impresion.js piensa puede “piensen de nuevo sobre los incrementos de precio” tapas españolas fresco presentaciones.

Pero impresion.js requiere que escriba su presentación como HTML, lo cual es molesto, y el
el marcado no es lo suficientemente flexible como para permitirle reorganizar rápidamente las cosas desde viñetas hasta
encabezados, etc.

También debe colocar cada diapositiva por separado, y si inserta una nueva diapositiva en el
en el medio, debe reposicionar todas las diapositivas que siguen.

¡Aerodeslizador!
Entonces, lo que quiero es una herramienta que aproveche el poder, la flexibilidad y la conveniencia de
reStructuredText y me permite generar presentaciones panorámicas, rotar y hacer zoom con
impresion.js, sin tener que reposicionar manualmente cada diapositiva si reorganizo un poco
de la presentación. No pude encontrar uno, así que hice Hovercraft.

El poder del aerodeslizador proviene de la combinación de la conveniencia de reStructuredText con el
genial de impresion.js, junto con una solución flexible y potente para colocar las diapositivas.

Hay cuatro formas de colocar las diapositivas:

1. Posicionamiento absoluto: simplemente agregue las coordenadas X e Y a una diapositiva, en píxeles.
Hacer solo esto no será divertido, pero alguien podría necesitarlo.

2. Posicionamiento relativo: al especificar x y / o y con una r inicial, especifica
la distancia desde la diapositiva anterior. Al utilizar esta forma de posicionamiento, puede
inserte una diapositiva, y las otras diapositivas simplemente se moverán para dejar espacio para la nueva diapositiva.

3. Automáticamente: si no especifica ninguna posición, la diapositiva terminará igual
distancia de la diapositiva anterior como la diapositiva anterior era de su diapositiva anterior.
De forma predeterminada, se mueve 1600px hacia la derecha, lo que significa que si no
posiciones en cualquier lugar de la presentación, obtiene el estándar aburrido
presentación de diapositiva a la izquierda.

4. Con una ruta SVG: en esta última forma de posicionamiento, puede tomar una ruta SVG desde un
Documento SVG y péguelo en la presentación, y esa diapositiva + todas las diapositivas
los siguientes que no tengan un posicionamiento explícito se colocarán en esa ruta. Esto puede
ser un poco complicado de usar, pero puede crear resultados asombrosos, como colocar el
diapositivas como Python serpenteante o similar.

¡Aerodeslizador! también incluye impresion-consola, una consola de presentación que le mostrará su
notas, vistas previas de diapositivas y el tiempo, herramientas imprescindibles para cualquier presentación.

USO ¡AERODESLIZADOR!

¡Puedes usar aerodeslizador! para generar la presentación como HTML en un directorio de destino,
¡O puedes dejar Hovercraft! sirva la presentación desde su servidor web incorporado.

Estos últimos tienen varios beneficios. Una es que la mayoría de los navegadores web serán muy reacios a
abrir ventanas emergentes de páginas servidas desde el sistema de archivos esta es una medida de seguridad que
se puede cambiar, pero es más fácil apuntar el navegador a http://localhost: 8000
.

¡El segundo beneficio es el aerodeslizador! supervisará los archivos fuente de la presentación,
y si son aerodeslizadores modificados! volverá a generar la presentación automáticamente.
¡De esa forma no tienes que ejecutar aerodeslizador! cada vez que guarda un archivo, solo necesita
actualice el navegador.

Parámetros
aerodeslizador [-h] [-t PLANTILLA] [-C CSS] [-un] [-s] [-norte] [-pag PUERTO]
[ ]

Argumentos posicionales:


La ruta al archivo de presentación reStructuredText.


El directorio donde se guarda la presentación. Se creará si no lo hace
existe. Si no especifica un aerodeslizador targetdir! en su lugar, iniciará un
servidor web y sirva la presentación desde ese servidor.

Argumentos opcionales:

-h, --ayuda
Muestre esta ayuda.

-t PLANTILLA, --plantilla PLANTILLA
Especifique una plantilla. Debe ser un archivo .cfg o un directorio con un plantilla.cfg
Archivo. Si no se proporciona, utilizará una plantilla predeterminada.

-c css, --css CSS
Un archivo CSS adicional para que lo use la presentación. Ver también el : css: ajustes
de la presentación.

-a --consola automática
Abre la consola del presentador automáticamente. Esto es útil cuando estás ensayando.
y asegurarse de que las notas del presentador sean correctas. También puede configurar esto
es : auto-consola: su verdadero primero en la presentación.

-s, --saltar-ayuda
No muestre la ventana emergente de ayuda inicial.

-norte, - notas de salto
No incluya notas del presentador en la salida.

-p PUERTO, --Puerto PORT
La dirección y el puerto que usa el servidor. Ex 8080 o 127.0.0.1:9000. Defaults
a 0.0.0.0: 8000.

Calidad in plantillas
¡Hay dos plantillas que vienen con Hovercraft! Uno se llama la página predeterminada y será usado
a menos que especifique una plantilla. Esta es la plantilla que utilizará la mayor parte del tiempo.

El segundo se llama simples y no tiene una consola de presentación. Esta plantilla es
especialmente útil si lo combinas con el - notas de salto parámetro para preparar una versión
de su presentación para que se publique en línea.

HACIENDO PRESENTACIONES

A nota on terminología
Tradicionalmente, una presentación se compone de diapositivas. Llamarlas "diapositivas" no es realmente
relevantes en un contexto de impresion.js, ya que pueden superponerse y no necesariamente se deslizan. El
el nombre "pasos" es mejor, pero también es más ambiguo. Por lo tanto, impresion.js usa los términos
"deslizar" y "paso" significan lo mismo, ¡y también Hovercraft!

¡Aerodeslizador! sintaxis
Las presentaciones son archivos de texto reestructurado. Si está leyendo esta documentación del
código fuente, entonces ya está viendo un documento reStructuredText.

Es bastante simple, subraya los títulos para marcarlos como títulos:

Esto se convierte en un h1
=================

Y este un h2
-------------

Las diferentes formas de subrayarlas no significan nada, sino que el orden de las mismas es
relevante, por lo que el primer tipo de subrayado encontrado en el archivo hará un nivel 1
título, el segundo tipo un título de nivel 2 y así sucesivamente. En este archivo = se usa para el nivel 1,
y - para el nivel 2.

También puede marcar texto como itálico or , con servicios *único asteriscos * or **doble asteriscos **
respectivamente.

También puede tener listas de viñetas:

* Viñeta 1

* Viñeta 1.1

* Viñeta 2

* Viñeta 3

Y listas numeradas:

1. Tema 1

1.1. Tema 1.1

2. Tema 2

3. Tema 3

Puedes incluir imágenes:

.. imagen :: ruta / a / imagen.png
: altura: 600px
: ancho: 800px

Como puede ver, también puede especificar la altura y el ancho y cargas de otros parámetros, pero ellos
son todos opcionales.

Y puede marcar el texto como preformateado. Lo haces terminando la fila anterior con
dos puntos dobles, o tener una fila de dos puntos dobles por sí solo:

::

Este código aquí estará preformateado
y se muestra con una fuente monoespaciada
y todos los espacios conservados.

Si desea agregar código fuente, puede usar el código directiva y obtener la sintaxis
destacando:

.. código :: python

def some_example_code (foo):
volver foo * foo

El resaltado de sintaxis se realiza mediante Pigmentos y admite montones y montones de idiomas.

También es probable que desee poner un título en la presentación. Haces eso teniendo un ..
título:: declaración antes de la primera diapositiva:

.. title :: Este es el título de la presentación

Esas son las cosas más importantes que necesitará saber sobre reStructuredText para hacer
presentaciones. Hay mucho más por saber y muchas funciones avanzadas como enlaces,
notas al pie de página y más. De hecho, es lo suficientemente avanzado como para que pueda escribir un Se publica el libro en inglés en eso,
pero para todo lo que necesitas leer el documentación.

Externo archivos
Cualquier archivo de imagen al que se haga referencia en la presentación por una ruta relativa se copiará al
directorio de destino, manteniendo su ruta relativa a la presentación. Lo mismo ocurre con las imágenes.
o fuentes a las que se hace referencia en cualquier archivo CSS utilizado por la presentación o la plantilla.

Las imágenes o fuentes referenciadas por rutas absolutas o URI no se copiarán.

Estilismo Tu Presentación
El CSS que se incluye en la plantilla predeterminada son tres archivos.

· ImpresionConsole.css contiene el CSS necesario para que funcione la consola del presentador,

· resaltar.css contiene un estilo predeterminado para resaltar la sintaxis del código, ya que de lo contrario
sería mucho trabajo. Si no le gustan los colores o estilos predeterminados en el
resaltando, este es el archivo que debe copiar y modificar.

· aerodeslizador.css, que solo incluye lo mínimo: oculta el respaldo de impresion.js
mensaje, el presentador nota, y establece un valor predeterminado útil de tener un ancho de paso
1000 píxeles de ancho.

Por esta razón, desea incluir su propio CSS para diseñar sus diapositivas. Para incluir un CSS
archivo agrega un : css:-campo en la parte superior de la presentación:

: css: css / presentation.css

También puede especificar opcionalmente que el CSS solo sea válido para ciertos medios CSS:

: css-pantalla, proyección: css / presentation.css
: css-print: css / print.css

Puede especificar cualquier número de archivos css de esta manera.

También puede agregar un archivo CSS adicional a través de un parámetro de línea de comandos:
aerodeslizador --extra-css = my_extra.css presentationfile.rst outdir /

Estilismo a soluciones y diapositiva
Si desea tener un estilo específico para una diapositiva específica, es una buena idea darle ese
deslice una identificación única:

: id: the-slide-id

Luego puede diseñar esa diapositiva específicamente con:

div # the-slide-id {
/ * CSS personalizado aquí * /
}

Si no le da una identificación específica, obtendrá una identificación basada en su número de secuencia. Y
eso significa que el ID de la diapositiva cambiará si inserta o quita las diapositivas anteriores,
y en ese caso los estilos personalizados de esa diapositiva dejarán de funcionar.

Estuche de carga presentaciones
¡Desde aerodeslizador! genera presentaciones HTML5, puede usar cualquier computadora que tenga un
navegador moderno instalado para ver o mostrar la presentación. Esto les permite a ambos aguantar
la presentación en línea y utilizar una computadora prestada para su conferencia o cliente
presentación.

Cuando viaja, no sabe qué equipo tiene que usar cuando muestra su
presentación, y es sorprendentemente común encontrar un proyector que se niega a hablar con
tu computadora. También es muy fácil olvidar su dongle si tiene una MacBook, y no
Incluso ha habido casos de computadoras que se apagan completamente cuando las conecta a
un proyector, aunque todas las demás computadoras parecen funcionar bien.

La principal forma de asegurarse de que su presentación sea portátil es probarla en diferentes
navegadores y diferentes computadoras. Pero esto último puede ser inviable, no todo el mundo tiene ambos
Computadoras con Windows, Linux y OS X en casa. Para ayudar a que sus presentaciones sean portátiles, es
Es una buena idea definir sus propias @ font-face y utilizarlas, de modo que esté seguro de que el objetivo
El navegador utilizará las mismas fuentes que usted. ¡Aerodeslizador! encontrará automáticamente @ font-face
definiciones y copie los archivos de fuentes en el directorio de destino.

impresion.js campos
La documentación sobre impresion.js está contenida como comentarios en el demostración html presentar. No lo es
siempre muy claro, por lo que aquí viene un breve resumen para mayor comodidad.

Los diferentes campos de datos que utilizará impresion.js en 0.5.3, que es la versión actual,
son los siguientes:

· duración de la transición de datos: El tiempo que se tarda en pasar de una diapositiva a otra.
El valor predeterminado es 1000 (1 segundo). Esto solo es válido en la presentación en su conjunto.

· perspectiva de datos: Controla la "perspectiva" en los efectos 3D. Su valor predeterminado es 500.
Establecerlo en 0 desactiva los efectos 3D.

· datos-x: La posición horizontal de una diapositiva en píxeles. Puede ser negativo.

· datos-y: La posición vertical de una diapositiva en píxeles. Puede ser negativo.

· escala de datos: Establece la escala de una diapositiva, que es lo que crea el zoom. Por defecto es 1. A
un valor de 4 significa que la diapositiva es cuatro veces más grande. En resumen: más bajo significa acercar,
más alto significa alejarse.

· datos-rotar-z: La rotación de una diapositiva en el eje x, en grados. Esto causará el
deslice para girar en sentido horario o antihorario.

· rotación de datos: Lo mismo que datos-rotar-z.

· datos-rotar-x: La rotación de una diapositiva en el eje x, en grados. Esto significa que eres
moviendo la diapositiva en una tercera dimensión en comparación con otras diapositivas. Esto es generalmente
efecto frío, si se usa correctamente.

· datos-rotar-y: La rotación de una diapositiva en el eje x, en grados.

· datos-z: Esto controla la posición de la diapositiva en el eje z. Estableciendo este valor en
-3000 significa que está ubicado a -3000 píxeles de distancia. Esto solo es útil cuando usa
datos-rotar-x or datos-rotar-y, de lo contrario solo dará la impresión de que el
la diapositiva se hace más pequeña, lo que no es realmente útil.

¡Aerodeslizador! especialidades
¡Aerodeslizador! tiene algunas formas específicas en que usa reStructuredText. En primer lugar, el
La "transición" de reStructuredText se utiliza para marcar la separación entre diferentes diapositivas o
pasos. Una transición es simplemente una línea con cuatro o más guiones:

----

No tiene que usar guiones, puede usar cualquiera de los caracteres usados ​​para subrayar
encabezados = - ` : . ' " ~ ^ _ * + #. Y al igual que los títulos de ancho, utilizando diferentes
caracteres indica diferentes "niveles". De esta manera puede hacer una jerarquización
presentación, con pasos y subpasos. Sin embargo, impresion.js no es compatible con eso, por lo que este
sólo es útil si crea sus propias plantillas que utilizan otra biblioteca de Javascript, para
(aqui) Revelar.js. Si tiene más de un nivel de transición con las plantillas incluidas
con Hovercraft, la presentación resultante puede comportarse de manera extraña.

Todos los campos reStructuredText se convierten en atributos en la etiqueta actual. La mayoría de
estos normalmente serán ignorados por la renderización a HTML, pero hay dos lugares donde
las etiquetas marcarán la diferencia, y eso es colocándolas primero en el documento, o
primero en una diapositiva.

Cualquier campo que coloque primero en un documento se convertirá en atributos en el archivo principal.
impresion.js <div></div>. Esto actualmente solo se usa para establecer la duración de la transición con
duración de la transición de datos.

Los campos que coloque primero en una diapositiva se convertirán en atributos en la diapositiva. <div></div>.
Esto se usa principalmente para establecer la posición / zoom / rotación de la diapositiva, ya sea con el
datos-x, datos-y y otras configuraciones de impresion.js, o el ruta de aerodeslizador entorno, más sobre eso
más tarde.

¡Aerodeslizador! comenzará a hacer la primera diapositiva cuando se encuentre por primera vez con una transición
o un encabezado. Todo lo que venga antes pertenecerá a la presentación en su conjunto.

Por lo tanto, una presentación puede verse así:

: duración de la transición de datos: 2000
: skip-help: true

.. title: Título de la presentación

----

Esta es la primera diapositiva
=======================

Aquí viene un texto.

----

: datos-x: 300
: datos-año: 2000

Esta es la segunda diapositiva
========================

#. Aquí tenemos

#. Una lista numerada

#. Será correcto

#. Números automáticamente

Relativo posicionamiento
¡Aerodeslizador! le ofrece la posibilidad de colocar diapositivas entre sí. Tu hiciste esto
comenzando las coordenadas con "r". Esto colocará la diapositiva 500 píxeles a la derecha
y mil píxeles por encima de la diapositiva anterior:

: datos-x: r500
: datos-y: r-1000

Las rutas relativas le permiten insertar y quitar diapositivas y ajustar otras diapositivas
automáticamente. Probablemente sea la forma más útil de posicionamiento.

Automático posicionamiento
Si no especifica un atributo, la configuración de la diapositiva será la misma que la anterior
diapositiva. Esto significa que si usó un posicionamiento relativo, la siguiente diapositiva moverá el
misma distancia.

Esto le da un movimiento lineal y sus diapositivas terminarán en línea recta.

Por defecto, el movimiento es de 1600 píxeles a la derecha, lo que significa que si no
coloque las diapositivas en absoluto, obtendrá una presentación estándar donde las diapositivas simplemente
deslice de derecha a izquierda.

SVG Caminos
¡Aerodeslizador! admite el posicionamiento de diapositivas a lo largo de una ruta SVG. Esto es útil, ya que puedes
cree un dibujo en un software que admita SVG y luego copie y pegue esa ruta de dibujo
en su presentación.

Usted especifica la ruta SVG con el : ruta-aerodeslizador: campo. Por ejemplo:

: ruta del aerodeslizador: m275,175 v-150 a150,150 0 0,0 -150,150 z

Cada diapositiva siguiente que no tenga ningún posicionamiento explícito se colocará en este
camino.

Hay algunas cosas con las que debe tener cuidado al usar rutas SVG.

Relativo y fotometría absoluta) coordenadas
En SVG, las coordenadas pueden ser absolutas, con una referencia al origen de la página; o
relativo, que se refiere al último punto. ¡Aerodeslizador! puede manejar ambos, pero que
no se puede manejar muy bien es una mezcla de ellos.

Específicamente, si toma una ruta SVG que comienza con un movimiento relativo y extrae
que desde el documento SVG, perderá el contexto. Todas las coordenadas posteriores deben
también sea relativo. Si tienes una coordenada absoluta, de repente recuperas el contexto,
y todo después de la primera coordenada absoluta estará fuera de lugar en comparación con el
puntos que vienen antes.

Lo más notable es que el software de código abierto "Inkscape" mezclará valores absolutos y relativos
coordenadas, si le permite utilizar coordenadas relativas. Por lo tanto, debe entrar en
sus configuraciones y desmarque la casilla de verificación que le permite usar coordenadas relativas. Esta
obliga a Inkscape a guardar todas las coordenadas como absolutas, lo que funcionará bien.

Sus datos Aqui posición
Por defecto, la posición de inicio de la ruta y, por lo tanto, la posición de inicio de la primera
diapositiva, será la posición de inicio que hubiera sido si la diapositiva no tuviera posicionamiento
en absoluto. Si desea cambiar esta posición, simplemente incluya : datos-x: or : datos-y: campos.
Tanto el posicionamiento relativo como el absoluto funcionarán aquí.

En todos los casos, la primera m or M el comando de la ruta SVG se ignora efectivamente, pero
tengo que incluirlo de todos modos.

SVG transformara
SVG te permite trazar una ruta y luego transformarla. ¡Aerodeslizador! no tiene soporte para estos
transforma, por lo que antes de extraer la ruta, debe asegurarse de que el software SVG no
utilizar transforma. En Inkscape, puede hacer esto con el comando "Simplificar".

Otros SVG formas
¡Aerodeslizador! no admite otras formas SVG, solo la ruta. Esto se debe a que organizar
diapositivas en cuadrados, etc., es bastante simple de todos modos, y las formas se pueden convertir en caminos.
Por lo general, en el software tendrá que seleccionar la forma y decirle a su software que haga
en un camino. En Inkscape, transformar un objeto en una ruta generalmente significa que
todo el camino está hecho de curvas CubicBezier, que son innecesariamente complejas. Utilizando el
El comando "Simplificar" en Inkscape suele ser suficiente para convertir las formas en trazados.

Escala de forma
¡Aerodeslizador! escalará la ruta para que todas las diapositivas que deben encajar en la ruta
encajar en el camino. Por lo tanto, si tiene varias rutas en su presentación, no sea
mantienen sus tamaños relativos, pero se cambiarán de tamaño para que se ajusten las diapositivas. Si necesita tener el
las formas mantienen sus tamaños relativos, es necesario combinarlas en un solo camino.

Ejemplos
¡Para ver cómo se usa el aerodeslizador! en la práctica, se incluyen tres presentaciones de ejemplo
con aerodeslizador!

aerodeslizador.rst
La presentación de demostración que puede ver en http://regebro.github.com/hovercraft

tutorial.primero
¡Una guía paso a paso de las características de Hovercraft!

posiciones.primero
Una explicación de cómo utilizar las funciones de posicionamiento.

DISEÑO SU PRESENTACIONES

Existen varios trucos para realizar presentaciones. Ciertamente no pretendo ser un
experto, pero aquí hay algunos consejos para principiantes.

Toma it de forma sencilla
No se esfuerce demasiado en el zoom. Tener una diferencia entre dos diapositivas en escala de más
de 5 rara vez se verá bien. Sería un buen efecto de zoom si se
lo hizo, pero esto no es para lo que están diseñados los navegadores, por lo que no lo hará.

Y los efectos 3D pueden ser realmente geniales si se usan bien. Pero no todo el tiempo, se vuelve agotador
para la audiencia

Intente, si puede, utilizar el zoom y los efectos 3D cuando tengan sentido en la presentación.
Por ejemplo, puede mencionar los temas principales en una diapositiva y luego acercar cada tema.
cuando lo comenta con más detalle. De esa forma, los efectos ayudan a aclarar la presentación,
en lugar de distraerse.

Personalizado fuentes
Los navegadores tienden a representar las cosas de manera sutilmente diferente.

También tienen diferentes fuentes predeterminadas y diferentes sistemas operativos tienen diferentes
implementaciones de las mismas fuentes. Así que para asegurarse de tener el mayor control sobre el
diseño como sea posible, siempre debe incluir fuentes con la presentación. Una buena fuente
para fuentes gratuitas son Google Fuentes web. Esas fuentes son gratuitas y de código abierto, por lo que puede usar
ellos sin costo y sin riesgo de ser demandado. También se pueden descargar o incluir
en línea.

Online vs Descargado
Si está haciendo una presentación que se ejecutará en su computadora en una conferencia o
reunión con el cliente, descargue siempre las fuentes y téngalas como parte de la presentación.
Ponlos en una carpeta llamada fuentes debajo de la carpeta donde está su presentación.

También necesitas definir la familia de fuentes en tu CSS. Fuente: Ardillagenerador de fuentes web
le proporcionará un conjunto de herramientas independiente de la plataforma para generar tanto la fuente varius
formatos y el CSS.

Si la presentación es solo en línea, puede poner un @incluir-declaración en su CSS para
incluir fuentes web de Google directamente:

@import url (http://fonts.googleapis.com/css? familia = Libre + Baskerville | Racing + Sans + One | Satisfacer);

Pero no use esto para cosas que necesita mostrar en su computadora, ya que requiere que
tener acceso a internet.

Prueba con una experiencia diferente navegadores
Si está poniendo la presentación en línea, pruébela con un par de navegadores principales, para
asegúrese de que nada se rompa y de que todo se vea bien. No solo hay sutiles
diferencias en cómo se pueden colocar las cosas, los diferentes navegadores también son buenos para
cosas diferentes.

He probado algunos navegadores, todos en Ubuntu, y es probable que se comporten de forma diferente en
otros sistemas operativos, por lo que debe probarlo usted mismo.

Firefox
Firefox 18 es bastante lento de usar con impresion.js, especialmente para cosas en 3D, por lo que puede tener
Movimientos muy bruscos de un tobogán a otro. Mantiene el buen aspecto del texto sin importar cómo
mucho te acercas. Por otro lado, se niega a escalar el texto infinitamente, por lo que si también escala
Muchos personajes no crecerán, sino que empezarán a moverse.

Firefox 19 es mejor, pero para las cosas en 3D sigue siendo un poco lento.

Chrome
Chrome 24 es rápido, pero no volverá a dibujar texto en diferentes tamaños, sino que creará un
imagen de ellos y cambiar su escala, lo que da como resultado que la diapositiva anterior tenga una imagen pixelada borrosa
efecto.

Epifanía
Epiphany 3.4.1 es comparable a Firefox 19, posiblemente un poco más suave, y el texto parece
bien. Pero tiene errores en la forma en que maneja los datos 3D, y la barra de ubicación es visible en
modo de pantalla completa, lo que lo hace menos adecuado para cualquier tipo de presentación.

TEMPLATES

Afortunadamente, en la mayoría de los casos no es necesario que cree su propia plantilla, ya que es la predeterminada
La plantilla es muy simple y la mayoría de las cosas que debe hacer se pueden realizar con CSS. Sin embargo, yo
¡No quiero aerodeslizadores! para instalar una pared donde no sea lo suficientemente flexible para sus necesidades, por lo que
Agregué soporte para hacer tus propias plantillas.

¡Necesita crear su propia plantilla si no está satisfecho con el HTML que Hovercraft!
genera, por ejemplo, si necesita utilizar otra versión de HTML o si el
reStructuredText que está utilizando no se representa de una manera que sea útil para usted.
Aunque si no está satisfecho con el HTML generado a partir del reStructuredText, podría
Muy bien, será un error, así que abre un problema en Github para discutirlo.

¡Aerodeslizador! genera presentaciones convirtiendo el reStructuredText en XML y luego
utilizando XSLT para traducir el XML a HTML.

Las plantillas son directorios con un archivo de configuración, un archivo XSL de plantilla y cualquier número
de CSS, JS y otros archivos de recursos.

El plantilla configuración presentar
El archivo de configuración normalmente se llama template.cfg, pero si tiene varios
archivos de configuración en un directorio de plantilla, puede especificar cuál usar
especificando la ruta completa al archivo de configuración. Sin embargo, si solo especifica el
directorio de plantillas, plantilla.cfg se utilizará.

Los archivos de plantilla están en formato configparser, que es un formato extendido de estilo ini. Ellos son
muy simple, y solo tiene una sección, [aerodeslizador]. Cualquier otra sección será ignorada.
Muchos de los parámetros son listas que a menudo no caben en una línea. En ese caso puedes
divida la línea en varias líneas, pero sangrando las líneas. La cantidad de sangría
no hace ninguna diferencia, excepto estéticamente.

Los parámetros de la sección [aerodeslizador] son:
plantilla El nombre de la plantilla xsl.

css A lista of CSS nombres de archivo separó by espacio en blanco. Estos archivos
se incluirá en el archivo final con "todos" como especificación de medios.

css- A lista of CSS nombres de archivo separó by espacio en blanco. Estos archivos
se incluirá en el archivo final con los medios proporcionados en el parámetro. Entonces
los archivos listados para el parámetro "css-print" obtendrán "print" como su medio
especificación y una clave como "css-screen, print" devolverá el medio
"captura de pantalla".

encabezado js A lista of nombres de archivo separó by espacio en blanco. Estos archivos
se incluirán en el archivo de destino como enlaces de secuencias de comandos de encabezado.

js-cuerpo A lista of nombres de archivo separó by espacio en blanco. Estos archivos
se incluirá en el archivo de destino como enlaces de secuencia de comandos al final del archivo. El
Los archivos impresion.js, ImpresionConsole.js y hovercraft.js normalmente deben ser
incluido aquí.

Recurso A lista of nombres de archivo separó by espacio en blanco que will be
copiados en el directorio de destino, pero no se hace nada más con ellos. Imágenes y
Las fuentes utilizadas por CSS se copiarán de todos modos, pero se pueden agregar otros recursos aquí.

Un ejemplo:

[aerodeslizador]
plantilla = plantilla.xsl

css = css / screen.css
css / impresionConsole.css

css-print = css / print.css

js-header = js / dateinput.js

js-body = js / impresion.js
js / PrintedConsole.js
js / hovercraft.js

resource = images / back.png
images / forward.png
images / up.png
images / down.png

El plantilla presentar
El archivo especificado con el plantilla parámetros es la plantilla XSLT real que
realizar la traducción de XML a HTML.

La mayoría de las veces, puede simplemente copiar el archivo de plantilla predeterminado en
aerodeslizador / templates / default / template.xsl y modificarlo. XSLT es muy complejo, pero
modificar las plantillas HTML es bastante sencillo siempre que no tenga que tocar
cualquiera de los las etiquetas.

Además, el HTML que se genera es compatible con XHTML y bastante sencillo, por lo que para el
en la mayoría de los casos, todo lo que necesitaría para generar otra versión de HTML, por ejemplo, estricto
XHTML, sería cambiar el tipo de documento.

Pero si necesita agregar o cambiar el HTML generado principal, puede agregar y cambiar HTML
declaraciones en este archivo principal como desee. Vea, por ejemplo, cómo es la pequeña ventana emergente de ayuda
agregado al final del HTML.

Si desea cambiar la forma en que se representa el texto reStructuredText, las cosas se ponen un poco más
complejo. Las reglas XSLT que convierten el XML reStructuredText en HTML están contenidas en un
archivo separado, descanso.xsl. En su mayor parte, solo puede incluirlo en el archivo de plantilla
con el siguiente código:



El recurso: ¡La parte aquí no es parte de XSLT, sino parte de Hovercraft! Le dice al
Traducción XSLT de que el archivo especificado no debe buscarse en el sistema de archivos, pero
como un recurso de paquete de Python. Actualmente el templates / reST.xsl el archivo es el único XSLT
importación de recursos disponible.

Si necesita cambiar la forma en que se representa reStructuredText, debe hacer una copia de ese
archivo y modificarlo. Luego debe hacer una copia de la plantilla principal y cambiar el
referencia en él a su archivo XSLT modificado.

Ninguno de los archivos XSLT necesita copiarse en el destino y no debe aparecer como un
recurso en el archivo de configuración de la plantilla.

Utilice aerodeslizadores en línea utilizando los servicios de onworks.net