Faq de uso de testEasy

01  ¿Qué es testEasy?

02  ¿Qué es paperEasy?

03  ¿Cómo cargar una revista usando paperEasy?

03.1 A través de iTunes

03.2 A través de FTP

04  Archivo de configuración  config.plist. 

04.1 Orientación de la revista

04.2 Paginación vertical

04.3 Definir el orden de las páginas

04.4 Pasar parámetros

04.5 Páginas dinámicas actualizables.

05  Funcionalidades papereasy

06  Descargas

 01 ¿Qué es testEasy?

testEasy es una aplicación diseñada para poder testear revistas digitales creadas para la tecnología paperEasy,directamente en tu iPad o iPhone sin necesidad de Xcode.

Nota: No te preocupes la revista se verá igual en dispositivos Android, solo que el visor demo ha sido desarrollado para iPad o iPhone

 02  ¿Qué es paperEasy?

paperEasy es una aplicación, para dispositivos móviles, diseñada para gestionar revistas creadas en HTML5 dentro del Newsstand de Apple o el Google Play  de Android.

imagen_1.png

 03 Cómo cargar una revista en tu dispositivo

NOTA: testEasy solo le permitirá leer una revista, si dispone al menos de 5 páginas.

03.1 A través de iTunes

imagen_3.png

03.2 A través de Ftp

03.1 A través de iTunes

NOTA: Este método es recomendado para transferir gran cantidad de ficheros de una sola vez

1.- Conecta el iPad/iPhone a tu ordenador a través del cable USB.

imagen_2.png

2.- Lanza la aplicación iTunes

imagen_3.png

3.- Señala, en la barra lateral izquierda, el dispositivo en el que quieres lanzar tu revista.

imagen_4.png

4.- Señala la pestaña Aplicaciones

imagen_5.png

5.- En la sección de Archivos compartidos, selecciona testEasy

imagen_6.png

6.- Lanza la carpeta que contiene tu revista a la parte de Documentos testEasy

NOTA: la carpeta debe contener al menos 5 archivos html y el archivo de configuración config.plist

Ver 04  Archivo de configuración  config.plist. 

imagen_7.png

7- Lanza testEasy en tu iPad

8.- Encontrarás una revista con el nombre de la carpeta que has transferido a tu dispositivo

9.-  Pulsa el botón Leer.

03.2 A través de Ftp

NOTA: Este método es recomendado para transferir ficheros sueltos. Por ejemplo el cambio de una página o un pequeño conjunto de imágenes.

Para poder usar testEasy en este modo, debes disponer de un cliente FTP.

Nosotros recomendamos Filezilla.

Puedes descargar en https://filezilla-project.org

1. Lanza testEasy en tu iPad/iPhone

2. Pulsa el botón para lanzar el servidor testEasy.

 Una pantalla le mostrará la dirección IP en la que testEasy está escuchando.

3. Lance su cliente FTP y configure una conexión.

dirección IP facilitada por testEasy,

puerto 1313

usuario testEasy

pasword testEasy.

NOTA: Asegúrese de que tanto testEasy como su ordenador están conectados a la misma red wifi.

usuario testEasy 

pasword testEasy

4. Cada carpeta lanzada corresponderá al nombre de una revista, y podrá lanzar los ficheros correspondientes a dicha revista dentro de su carpeta.

Mediante este sistema podrá realizar cualquier tipo de operación: subir ficheros, borrarlos, renombrarlos….

Nota: Este método es recomendado para transferir ficheros sueltos. Por ejemplo el cambio de una página o un pequeño conjunto de imágenes.

04 Archivo de configuración config.plis

NOTA:  Toda revista debe tener al menos 5 paginas y un archivo de configuración llamado config.plis

la página index.html se usa como página sumario dentro de la aplicación ( tap con dos dedos en la parte inferior de tu dispositivo)

04.1 Orientación de la revista

04.2 Paginación vertical

04.3 Definir el orden de las páginas

04.4 Pasar parámetros

04.5 Páginas dinámicas actualizables.

¿Cómo crear una portada para mi revista?

testEasy presenta un icono por defecto para cada revista introducida en el sistema. Si usted quiere usar uno propio, simplemente ha de incluir un fichero llamado cover.jpg dentro de cada carpeta. El tamaño de dicha imagen es de 300 pixeles de ancho por 400 pixeles de alto.

¿Cómo configurar mi revista?

testEasy dispone de multitud de opciones para poder personalizar su revista. Permite definir desde la orientación hasta el orden de lectura de las páginas. Para ello dispone de un fichero de configuración llamado config.plist. Si este fichero no se incluye, el sistema tomará las opciones por defecto.

04.1 Orientación de la revista

 

Define las posibles orientaciones de la revista. Si la revista solo se puede leer en Vertical, el valor ha de ser 1. Si solo en Horizontal, el valor ha de ser 2. Si soporta ambas, el valor es 0. El valor por defecto es 0

<integer>0</integer>     <integer>1</integer>    <integer>2</integer>

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

<plist version="1.0">

<dict>

        <key>horientacion</key>

        <integer>0</integer>

</dict>

</plist>

04.2 Paginación vertical

Define el comportamiento de desplazamiento vertical de cada página de la revista. Puede ser mediante paginación( valor true), el desplazamiento se hace en incrementos del alto del dispositivo, o libre (valor false). El valor por defecto es libre.

<key>paginacion_vertical</key> <true/>                         <key>paginacion_vertical</key><false/>

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

<plist version="1.0">

<dict>

        <key>paginacion_vertical</key>

        <true/>

</dict>

</plist>

04.3 Definir el orden de las páginas

testEasy dispone de un sistema de paginación por defecto. Cada html se nombra de 00.html, 01.html… hasta XX.html, siendo 00.html la portada de la publicación y XX.html la última página de la misma. Es sistema presentará las páginas según el orden numérico ascendente.

00.html   01.html  02.html 03.html…… 10.html 11.html 12.html

O podemos definir un orden determinado indicando el nombre y orden de cada página dentro del array

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

<plist version="1.0">

<dict>

<key>paginas</key>

        <array>

                <string>portada.html</string>

                <string>editorial.html</string>

                <string>pagina1.html</string>

                <string>entrevista_estudio.html</string>

                <string>seccion_musica.html</string>

                <string>bazar.html</string>

                <string>pagina2.html</string>

        </array>

</dict>

</plist>

04.4 Pasar parámetros y variables

El sistema personalizado también le permite la posibilidad de pasar parámetros a sus ficheros html.

<string>02.html?textos=textos/variable.txt</string>

<string>02.html?carpeta=variablecarpeta</string>

en el html se declara una variable igual a la que se define en la url accesible por javascrip en todo el documento

equivale a declarar la varibla en javascript dentro del documento

<script type="text/javascript" >var carpeta="Adver.aussiebum";</script>

esto nos permite usar plantillas predefinidas y cargar las imágenes y textos Xml concretos de esa plantilla mediante variables

04.5 Páginas dinámicas actualizables.

NOTA: testEasy solo le permitirá leer una revista, si dispone al menos de 5 páginas.

Otra característica que posibilita el sistema de paginación personalizado es el de poder incluir lo que llamamos páginas dinámicas actualizables. Para ello indicamos al sistema que la página está alojada en un servidor

<string>http://www.miservidor.com/pagina1.html</string>

Cuando usamos esta opción es necesario incluir un fichero HTML con el mismo nombre dentro de la carpeta de nuestra revista, pagina1.html en este caso.

El funcionamiento es el siguiente

1.- Si no se dispone de conexión, el sistema presentará la página de mismo nombre incluida en la carpeta de la revista (pagina1.html)

2.- Si dispone de conexión, el sistema presentará la página que se encuentra online.

3. Una vez el sistema haya podido acceder a la página online, será esta la que presentará cada vez que se abra de nuevo la revista, incluso si no tiene conexión. Si la tiene, realizará de nuevo el paso 2, teniendo siempre la página actualizada.

Es un sistema interesante cuando se necesita tener contenido que precisa de actualizaciones constantes o información dinámica.

Recuerde que cada fichero html dispone de elementos necesarios para su correcto funcionamiento (imágenes, css,js) que ha de incluir también dentro de la carpeta de su revista.

Un fichero de configuración completo

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

<plist version="1.0">

<dict>

        <key>horientacion</key>

        <integer>0</integer>

        <key>paginacion_vertical</key>

        <true/>

        <key>paginas</key>

        <array>

                <string>portada.html</string>

                <string>editorial.html</string>

                <string>pagina1.html</string>

                <string>entrevista_estudio.html</string>

                <string>seccion_musica.html</string>

                <string>bazar.html</string>

                <string>pagina2.html</string>

        </array>

</dict>

</plist>

04 Funcionalidades paperEasy

Funcionalidades disponibles desde el HTML

Facebook

        paperEasy permite compartir en Facebook, y sin salir de la propia aplicación un contenido específico así como su imagen correspondiente. Para ellos simplemente insertaremos en nuestro código HTML una llamada de este tipo:

        <a href="internal:facebookPost?Texto_a_publicar?imagen_a_publicar">

la imagen a publicar puede ser una referencia a una imagen contenida en la carpeta /directorio/imagen o una referencia a una imagen online http://www.miservidor.com/imagen

Twitter

paperEasy permite compartir en Twitter, y sin salir de la propia aplicación un contenido específico así como su imagen correspondiente. Para ellos simplemente insertaremos en nuestro código HTML una llamada de este tipo:

        <a href="internal:twitterPost?Texto_a_publicar?imagen_a_publicar">

la imagen a publicar puede ser una referencia a una imagen contenida en la carpeta /directorio/imagen o una referencia a una imagen online http://www.miservidor.com/imagen

Abrir un video externo en ventana completa

paperEasy permite abrir un video externo en una ventana completa dentro de la propia aplicación

<a href="internal:openVideo?http://www.miservidor.com/video">

Abrir un video externo en ventana completa

paperEasy permite abrir un video interno en una ventana completa dentro de la propia aplicación

<a href="internal:openVideo?ruta_al_video">

 06  Descargas

Descarga nuestro Book

Book Demo

www.magmagoo.com