diff --git a/README-ES.md b/README-ES.md new file mode 100644 index 00000000..aa79be69 --- /dev/null +++ b/README-ES.md @@ -0,0 +1,1329 @@ +LungoJS +======= +LungoJS es un framework HTML5 pensado en lo desarrolladores a los que también les gusta el diseño, desarrollado para que crear aplicaciones compatibles con todos los dispositivos. + + * **Apps HTML5 optimizadas**: Soporta los open web standards como HMTL5, CSS3 y JavaScript. Proporciona un entorno consistente basado en navegador para cualquier dispositivo movil, TVs y aplicaciones de escritorio. + + * **Proyecto Open Source**: Cada nueva linea de código en Lungo es bienvenida, esperamos que cualquier desarrollador con mente intrépida nos ayude a mejorar dia a dia Lungo. + + * **Una poderos API JavaScript**: Existen muchas maneras de desarrollar un app pero no todas ellas de manera optimizada. Lungo te ofrece una API robusta con la que puedes tener completo control de todo lo que suceda en tu App. + + * **Soporte multiplataforma**: Es sabido que desarrollar apps para cada plataforma tiene un coste alto y mas aún si se tienen en cuenta el desarrollo para tablets y SmartTVs. Lungo se ajusta a todos ellos crean una interfaz de usuario única para todos ellos. + +*Current version: [2.2.0]()* + + + +Empieza a usarlo +---------------- +La idea de Lungo surgió en el año 2010 cuando Javi Jiménez Villar ([**soyjavi**](https://twitter.com/soyjavi)) se dio cuenta de que los frameworks existentes en aquella época no eran muy versátiles y no hacían uso de las principales funcionalidades de HMTL5. + +### Comunidad +Si esta documentación se te queda corta siempre te puedes suscribir a la comunidad de Lungo para compartir experiencias y conocimientos. En [Inglés](https://groups.google.com/forum/#!forum/lungojs) o [Castellano](https://groups.google.com/forum/#!forum/lungojs_es), tu decides. + + +### GitHub +Este es un proyecto opensource, asi que sientete libre de hacer un fork del proyecto para ayudarnos a mejorar Lungo. Todo el código fuente está escrito en CoffeScript y Stylus, como es código limpio podrás modificarlo de manera sencilla y realizar tus aportes. + +[https://github.com/tapquo/lungo.js](https://github.com/tapquo/lungo.js) + +### Licencia +Lungo esta bajo una licencia GPLv3 para mas información [LICENSE](https://github.com/tapquo/Lungo.js/blob/master/LICENSE.md). + +### Ayudanos a mejorar +Por favor no tengas ninguna duda en contactarnos si crees que puedes realizar mejoras sobre la API. Si piensas que deberíamos dar soporte a alguna nueva funcionalidad o si encuentras un bug, utiliza GitHub issues](https://github.com/tapquo/lungo.js/issues). Sientete libre de mejorar esta documentación y mandanos tus *pull requests* con tus mejoras. + +Para contactar con nosotros o con otros desarrolladores acerca de la API de Lungo suscribete a nuestra [**lista de correo**](https://groups.google.com/forum/#!forum/lungojs). + +Fácil de Prototipar +=================== +El objetivo es crear una estructura semántica en todo el proyecto, desde el lenguaje de marcado HTML, pasando por las clases CSS bien organizadas y acabando con la API JavaScript. Lungo ofrece una gran sencillez a la hora de hacer un prototipo rápido de tu aplicación, no te será necesario escribir ninguna línea de JavaScript para visualizar como debería comportarse tu aplicación. En esta documentación aprenderemos cuales son los elementos semánticos que utiliza Lungo y como se puede crear una aplicación unicamente con HTML. Así que no le demos mas vueltas y comencemos! + +Estructura +---------- +Estas son las dependencias de tu aplicación Lungo, como mínimo deberia contener las siguientes: + + html + + + + + + + +`
` es el contenedor principal de la interfaz de usuario en tu app y `
` se debe colocar dentro de tu section,cada section y article deberían tener un ID único. +``` html +
+
+ Your content +
+
+``` + +Recuerda:La función JavaScript para inicializar el entorno de Lungo: +``` javascript +Lungo.init({}); +``` + +#### Carga de los recursos síncronos al inicializar Lungo +Para que te sea mas sencillo crear y modificar tu app puedes crear las secciones en ficheros htmls separados y cargarlos de manerá síncrona, dejando tu fichero html principal mucho mas limpio y organizando mejor tu código. +``` javascript +//Cargar recurso al inicio +Lungo.init({ + name: 'example', + resources: ['section_to_load.html'] +}); +``` + +#### Carga de los recursos asíncronos mediante enlance +Solo existe una manera de cargar los recursos de manera asíncrona, simplemente añade a la etiqueta `` el atributo data-async con el enlace a tu sección. +``` html +
+ +
+``` + + +Elementos básicos +----------------- +Lungo utiliza el lenguaje semántico introducido en HMTL5, así que puedes añadir estos elementos utilizando las etiquetas semánticas. + +### Section y Article +Una `
` es una vista donde se desplegará el contenido y existen muchos subelementos como `
`, `