Aplicaciones Híbridas con Ionic 2 Framework

Hoy vamos a conocer un poco acerca de un framework de desarrollo que ando probando (pero que tiene algo de tiempo ya). Ionic Framework es una herramienta gratuita para el desarrollo de aplicaciones híbridas basadas en HTML5 y JS, el cual esta construido bajo Saas y optimizado al máximo con AngularJS. Cuenta con una documentación muy completa (docs) y con una comunidad amplia, así que recursos y personas dispuestas a ayudarte no te van a faltar.

El proceso de instalación es muy sencillo, debes tener instalado, si no lo tienes o no sabes hacerlo, te dejo una guía npm una vez instalado simplemente ejecutas

npm install -g cordova ionic

Ya con eso tienes instalado ionic 2, vamos a crear un primer proyecto en blanco (se pueden usar templates de proyectos creados), para crearlo usamos el comando

ionic start ionictestblog blank

ionic es el comando que ejecutas para decirle al CLI que debe hacer, en este caso start que es para iniciar un proyecto ionictestblog no es mas que el nombre del proyecto, en mi caso le coloque así por que es lo que haremos un blog, que consuma vía API los posts y que permita enviar posts usando la misma API, para el backend de este blog usaremos mi framework favorito Django y para crear el API, usaremos Django-Rest-Framework, que también lo explicare en posts siguientes. y por ultimo el comando blank le indica al CLI que debe ejecutar un proyecto en blanco, es decir, con las configuraciones básicas del framework.

Una vez creado el proyecto podemos comenzar con la magia de la programación, yo voy a comenzar a hacer una serie de posts sobre una app que ando creando y que usare como ejemplo para facilitarles el camino en la creación de las suyas. Para compilar el proyecto, dependiendo de la plataforma en la que estés puedes usar uno u otro comando es de destacar que puedes compilar para IOS y Android

Android
ionic platform add android
ionic build android
ionic run android

he creado el repositorio en github para que tengas todo el codigo de la app que realizaremos en este mini howTo https://github.com/rootweiller/ionictestblog

Happy Hacking 🙂

Documentación Técnica con Sphinx

Saludos, vamos a hablar y a crear una documentación técnica usando sphinx, lo primero que debemos hacer es instalarlo en nuestra distro, si usas pip te será mucho más fácil hacer la instalación, ejecutando el comando pip install sphinx si, por desgracia usas Windows, no te preocupes también funciona ahí, te dejo este enlace para que veas el proceso de instalación http://sphinx-doc.org/latest/install.html

Una vez instalado debemos ejecutar el siguiente comando para crear el proyecto en el cual vamos a trabajar sphinx-quickstart


> Root path for the documentation [.]:
> Separate source and build directories (y/n) [n]:
> Name prefix for templates and static dir [_]:
> Project name:
> Author name(s):
> Project version:
> Project release [1]:
> Project language [en]:
> Source file suffix [.rst]:
> Name of your master document (without suffix) [index]:
> Do you want to use the epub builder (y/n) [n]:
> autodoc: automatically insert docstrings from modules (y/n) [n]:
> doctest: automatically test code snippets in doctest blocks (y/n) [n]:
> sphinx: link between Sphinx documentation of different projects (y/n):
> todo: write "todo" entries that can be shown or hidden on build (y/n) [n]:
> coverage: checks for documentation coverage (y/n) [n]:
> pngmath: include math, rendered as PNG images (y/n) [n]:
> mathjax: include math, rendered in the browser by MathJax (y/n) [n]:
> config: conditional inclusion of content based on config values (y/n):
> include links to the source code of documented Python objects (y/n):
> Create Makefile? (y/n) [y]:
> Create Windows command file? (y/n) [y]:
You should now populate your master file ./index.rst and create other documentation
source files. Use the Makefile to build the docs, like so:
make builder
where "builder" is one of the supported builders, e.g. html, latex or linkcheck.

Debes responder esa serie de preguntas referentes a tu proyecto, una vez hecho esto se te crearán las carpetas del mismo y quedará de la siguiente forma

prueba
├── _build
├── conf.py
├── index.rst
├── make.bat
├── Makefile
├── _static
└── _templates

En el index.rst está la definición de nuestro proyecto, ahí colocaremos los archivos .rst para crear la documentación


.. prueba documentation master file, created by
sphinx-quickstart on Tue Jun 2 09:58:20 2015.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.

Welcome to prueba's documentation!
==================================

Contents:

.. toctree::
:maxdepth: 2

intro

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

En la sección “Contents:” van los archivos .rst de nuestro proyecto.

creamos el archivo intro.rst y le damos el siguiente formato:

Introducción
================================
Una breve introducción a nuestro proyecto.

Agregamos el intro al Contents: del archivo index.rst y desde la consola ejecutamos make html, dentro de la carpeta _build quedarán los .html que hemos definido para nuestro proyecto.

Con eso tenemos la forma básica de crear documentación técnica, se puede modificar los temas de nuestro proyecto para darle mayor y mejor apariencia, los por defecto de sphinx están alojados aquí, tu también puedes crear los tuyos siguiendo la guía.

hasta pronto, espero les sea útil y cualquier comentario, duda y/o sugerencia ya saben donde dejarla.

Restaurando el Sony Xperia Mini X-10

Saludos, en esta oportunidad les dejaré un vídeo de como restaurar el sony xperia x-10 mini, esto para cuando estén instalando alguna ROM y el aparato no pase del logo de sony ericsson, como me ocurrió (por 2da vez a mi :D), es muy simple, por desgracia lo debes hacer desde winbugs, pero ese no es problema para muchos, por desgracia 😥

El vídeo en cuestión es realizado por el “tocayo” Juan Matus, excelente aporte del pana.