Esta página está pensada para poderse descargar los ficheros necesarios para instalar la aplicación de cálculo de leyes en cualquier blog o página web que lo quiera incorporar.
- Partes de la aplicación
La aplicación consta de 2 partes:
A) Los cálculos propiamente dichos: es un programa en Javascript.
B) El interfaz de uso, que consta a su vez de 3 partes:
- definiciones de agunos estilos utilizados
- controles HTML para presentar los datos y fijar los valores de los parámetros variables (jugadas, mano, modo reyes, etc.)
- rutinas Javascript para completar la validación de los datos anteriores
A) Los cálculos propiamente dichos: es un programa en Javascript.
B) El interfaz de uso, que consta a su vez de 3 partes:
- definiciones de agunos estilos utilizados
- controles HTML para presentar los datos y fijar los valores de los parámetros variables (jugadas, mano, modo reyes, etc.)
- rutinas Javascript para completar la validación de los datos anteriores
- Instalación sencilla
La forma más sencilla de instalarlo en un blog es descargarse el fichero de texto acme_leyes.txt y copiar su contenido tal cual en un widget HTML.
Si es en una página web, puede que funcione igualmente, pero su ubicación concreta dependerá del diseño de la misma, pudiendo incluso tener que situar cada una de sus partes (estilos y javascript) en lugares diferentes.
El ancho de la página que debe reservare para contener esta aplicación tal cual debe ser de 300 pixels. Si se quiere ubicar en una zona menor habrá recurrir a personalizarlo.
Este fichero no contiene en realidad los programas javascript ni de los cálculos ni de la presentación, sino que hace a su vez llamadas a los ficheros correspondientes.
El código incluido es bastante sencillo y puede también cortarse y pegarse desde el recuadro adjunto:
La 4ª parte es la que lanza realmente toda la ejecución.
La última parte es opcional y vale tan sólo para sacar un aviso si no está javascript activado.
Si es en una página web, puede que funcione igualmente, pero su ubicación concreta dependerá del diseño de la misma, pudiendo incluso tener que situar cada una de sus partes (estilos y javascript) en lugares diferentes.
El ancho de la página que debe reservare para contener esta aplicación tal cual debe ser de 300 pixels. Si se quiere ubicar en una zona menor habrá recurrir a personalizarlo.
Este fichero no contiene en realidad los programas javascript ni de los cálculos ni de la presentación, sino que hace a su vez llamadas a los ficheros correspondientes.
El código incluido es bastante sencillo y puede también cortarse y pegarse desde el recuadro adjunto:
<style type="text/css" media="screen">@import "https://sites.google.com/site/acmemus/acme_leyes.css?attredirects=0";</style>
<script src="https://sites.google.com/site/acmemus/acme_calculos.js?attredirects=0"></script>
<script src="https://sites.google.com/site/acmemus/acme_leyes.js?attredirects=0"></script>
<script>iniciarLeyes();</script>
<noscript><a class='nok'>Parece que tienes desactivado Javascript.<br />Debes activarlo si quieres que te funcione.</a></noscript>
La 1ª parte es la llamada al fichero de estilos y las 2 siguientes las llamadas a los javascript externos.<script src="https://sites.google.com/site/acmemus/acme_calculos.js?attredirects=0"></script>
<script src="https://sites.google.com/site/acmemus/acme_leyes.js?attredirects=0"></script>
<script>iniciarLeyes();</script>
<noscript><a class='nok'>Parece que tienes desactivado Javascript.<br />Debes activarlo si quieres que te funcione.</a></noscript>
La 4ª parte es la que lanza realmente toda la ejecución.
La última parte es opcional y vale tan sólo para sacar un aviso si no está javascript activado.
- Adaptación personal
Mediante la instalación sencilla descrita, se consigue que la aplicación quede disponible en cualquier blog, y lo hará tomando los colores de texto y de fondo que tenga dicho blog por defecto, por lo que no harán falta más retoques a no ser que se quiera cambiar estos colores o el tamaño u otros aspectos más concretos.
Si los cambios requeridos son genéricos para toda la aplicación (por ejemplo cambiar color de todos sus textos o del fondo, etc, puede que sea suficiente con cambiar los atributos CSS del contenedor externo cuyo identificador es "acmeleyes", que se podrá referenciar en cualquier hoja CSS ya existente o simplemente crear unas pocas líneas HTML para este fin que podrán añadirse por ejemplo al widget que lanza la aplicación.
Por ejemplo, el código siguiente hará que la aplicación se presente con texto azul sobre fondo blanco y ocupando un ancho de 500px:
Pero si se quiere hacer algún tipo de retoque o adaptación personal más complicado sobre la parte de funcionalidad de presentación o incluso de los cálculos (esto no se recomienda mucho), o si simplemente se desea tener los ficheros alojados localmente o en otro servidor, deben descargarse aparte los ficheros javascript / css y o bien incluirlos en el blog o página web o bien alojarlos en otro servicio de hosting, debiendo retocar asimismo las líneas del anterior fichero que hacen referencia a las ubicaciones originales y que deberán quitarse (si se incluyen en otra parte de la página/blog) o actualizarse (si se alojan en otro servidor). Estas referencias son las URLs contenidas en cada una de las líneas del fichero visto en apartado anterior de instalación sencilla ("https://sites.google.com/site/acmemus...")
Para realizar estas adaptaciones es preciso tener conocimientos de HTML, CSS y javascript (aparte de asumir encontrarse con muchas herejías de diseño de webs que deberán achacarse a la poca experiencia del autor en estas lides).
Los enlaces para descarga de estos ficheros son:
- Scripts de cálculos: acme_calculos.js
- Scripts de presentación: acme_leyes.js
- Hoja de estilos de presentación: acme_leyes.css
Para retocar la parte de estilos (colores, tamaños, etc), debe hacerse sobre el fichero css descargado, y se puede alterar la composición de cada estilo ya incluido, pero si se quieren añadir nuevos estilos habrá además que detallar su uso en la parte HTML. El código CSS contenido en el citado fichero ha sido validado según los estándares CSS 2.1 y es lo que se representa con el icono adjunto.
Si se van a retocar estos ficheros, se ruega encarecidamente que se señalicen muy bien mediante comentarios todas las partes alteradas, de modo que puedan siempre volver a rehacerse si se decide volver a bajar una nueve versión del fichero original por querer incorporar alguna nueva modificación que pudiera tener.
Los elementos HTML no están directamente incluidos como tal en los ficheros descargados, sino que forman parte de una función javascript denominada muestraControles. Esto se hace así para facilitar el uso externo de una forma simple garantizando las actualizaciones futuras.
Si los cambios requeridos son genéricos para toda la aplicación (por ejemplo cambiar color de todos sus textos o del fondo, etc, puede que sea suficiente con cambiar los atributos CSS del contenedor externo cuyo identificador es "acmeleyes", que se podrá referenciar en cualquier hoja CSS ya existente o simplemente crear unas pocas líneas HTML para este fin que podrán añadirse por ejemplo al widget que lanza la aplicación.
Por ejemplo, el código siguiente hará que la aplicación se presente con texto azul sobre fondo blanco y ocupando un ancho de 500px:
<style type="text/css" >
#acmeleyes {
color: blue;
background-color: white;
padding: 20px 100px;
width: 300px;
}
</style>
#acmeleyes {
color: blue;
background-color: white;
padding: 20px 100px;
width: 300px;
}
</style>
Pero si se quiere hacer algún tipo de retoque o adaptación personal más complicado sobre la parte de funcionalidad de presentación o incluso de los cálculos (esto no se recomienda mucho), o si simplemente se desea tener los ficheros alojados localmente o en otro servidor, deben descargarse aparte los ficheros javascript / css y o bien incluirlos en el blog o página web o bien alojarlos en otro servicio de hosting, debiendo retocar asimismo las líneas del anterior fichero que hacen referencia a las ubicaciones originales y que deberán quitarse (si se incluyen en otra parte de la página/blog) o actualizarse (si se alojan en otro servidor). Estas referencias son las URLs contenidas en cada una de las líneas del fichero visto en apartado anterior de instalación sencilla ("https://sites.google.com/site/acmemus...")
Para realizar estas adaptaciones es preciso tener conocimientos de HTML, CSS y javascript (aparte de asumir encontrarse con muchas herejías de diseño de webs que deberán achacarse a la poca experiencia del autor en estas lides).
Los enlaces para descarga de estos ficheros son:
- Scripts de cálculos: acme_calculos.js
- Scripts de presentación: acme_leyes.js
- Hoja de estilos de presentación: acme_leyes.css
Para retocar la parte de estilos (colores, tamaños, etc), debe hacerse sobre el fichero css descargado, y se puede alterar la composición de cada estilo ya incluido, pero si se quieren añadir nuevos estilos habrá además que detallar su uso en la parte HTML. El código CSS contenido en el citado fichero ha sido validado según los estándares CSS 2.1 y es lo que se representa con el icono adjunto.Si se van a retocar estos ficheros, se ruega encarecidamente que se señalicen muy bien mediante comentarios todas las partes alteradas, de modo que puedan siempre volver a rehacerse si se decide volver a bajar una nueve versión del fichero original por querer incorporar alguna nueva modificación que pudiera tener.
Los elementos HTML no están directamente incluidos como tal en los ficheros descargados, sino que forman parte de una función javascript denominada muestraControles. Esto se hace así para facilitar el uso externo de una forma simple garantizando las actualizaciones futuras.
- Ventajas e inconvenientes
¡¡IMPORTANTE!!: poner esta aplicación en tu blog o web puede penalizar su rendimiento ya que los cálculos que realiza son bastante exigentes, por lo que los usuarios que accedan sobre todo mediante internet explorer (versiones anteriores a la 9) se pueden ver seriamente afectados. Por tanto, te recomendamos que no lo pongas en tu página principal.
A la hora de elegir entre las opciones de instalación indicadas (uso de ficheros originales o su descarga y uso local) deben tenerse en cuenta, aparte de la sencillez, algunas ventajas o inconvenientes que pueden encontrase con cada una de ellas:
- La llamada instalación sencilla garantiza que se actualizará automáticamente cualquier modificación futura que se haga en los ficheros originales, pero esto puede ser bueno o malo dependiendo de si la aplicación se va a seguir utilizando tal cual se bajó o se piensa adaptar algún detalle, en cuyo caso se corre el riesgo de que los cambios afecten a lo adaptado y pueda dejar de funcionar.
- Por otro lado, el alojamiento actual de los ficheros en google sites en realidad no es muy adecuado para ficheros javascript por lo que no se puede garantizar su funcionamiento y depende de las trabas que siga poniendo google para ello. De hecho oficialmente no está soportado aunque funcione.
A la hora de elegir entre las opciones de instalación indicadas (uso de ficheros originales o su descarga y uso local) deben tenerse en cuenta, aparte de la sencillez, algunas ventajas o inconvenientes que pueden encontrase con cada una de ellas:
- La llamada instalación sencilla garantiza que se actualizará automáticamente cualquier modificación futura que se haga en los ficheros originales, pero esto puede ser bueno o malo dependiendo de si la aplicación se va a seguir utilizando tal cual se bajó o se piensa adaptar algún detalle, en cuyo caso se corre el riesgo de que los cambios afecten a lo adaptado y pueda dejar de funcionar.
- Por otro lado, el alojamiento actual de los ficheros en google sites en realidad no es muy adecuado para ficheros javascript por lo que no se puede garantizar su funcionamiento y depende de las trabas que siga poniendo google para ello. De hecho oficialmente no está soportado aunque funcione.
- Condiciones de uso
-----------------------------------------La utilización total o parcial de los ficheros descargados de esta aplicación se permite con las siguientes limitaciones:
- solamente se permite para uso personal, no comercial.
- debe mencionarse siempre la fuente de procedencia (ACME).
- en posteriores difusiones del producto parcial o modificado debe mantenerse el mismo tipo de licenciamiento.
- para más detalles ver el contenido completo de la licencia:
- solamente se permite para uso personal, no comercial.
- debe mencionarse siempre la fuente de procedencia (ACME).
- en posteriores difusiones del producto parcial o modificado debe mantenerse el mismo tipo de licenciamiento.
- para más detalles ver el contenido completo de la licencia:
Si tuvieras activado Javascript podrías ver esta página un poco mejor con detalles desplegables u ocultables.
No hay comentarios:
Publicar un comentario