2013-01-24T10:30:53-08:00 http://andresmoschini.github.com Andres Moschini andresmoschini@gmail.com 2013-01-24T00:00:00-08:00 http://andresmoschini.github.com/2013/01/24/my-menu-instructivo <p>Al entrar a la página principal <strong><em><code>1</code></em></strong>, se muestra el plato y lugar seleccionado para el día actual <strong><em><code>2</code></em></strong>.</p> <p><img src='/img/posts/2013-01-24-my-menu-instructivo/01.jpg' alt='Pantalla principal' /></p> <h3 id='configuracin'>Configuración</h3> <p>En la solapa de <strong>Configuración</strong> definir el <strong>lugar por defecto</strong> <strong><em><code>3</code></em></strong> donde se espera el almuerzo.</p> <p><img src='/img/posts/2013-01-24-my-menu-instructivo/02.jpg' alt='Menú semanal' /></p> <p>En las solapas de las semanas (<strong>Semana 1</strong>, <strong>Semana 2</strong>, <strong>Semana 3</strong>, <strong>Semana 4</strong>, <strong>Semana 5</strong>) seleccionar el plato deseado para cada día <strong><em><code>4</code></em></strong>. También puede modificarse el lugar <strong><em><code>5</code></em></strong>.</p> <p>La fecha <strong><em><code>6</code></em></strong> está a modo de referencia e indica la fecha más cercana en que corresponde ese menú. Por ejemplo, en la imagen vemos que yo seleccioné <em>&#8220;Milanesa de Zapallitos&#8230;&#8221;</em>: esa será mi comida el día <em>11 de febrero</em> y, a menos que algo cambie, también lo será el <em>día 18 de marzo</em> (cinco semanas después).</p> <p><img src='/img/posts/2013-01-24-my-menu-instructivo/03.jpg' alt='Días específicos' /></p> <p>En la solapa <strong>Días específicos</strong> puede agregarse días en que se modifica la selección semanal. Se debe ingresar la fecha <strong><em><code>7</code></em></strong> y un comentario <strong><em><code>8</code></em></strong>. Se puede cancelar totalmente la comida <strong><em><code>9</code></em></strong>, cambiar el plato <strong><em><code>10</code></em></strong> o indicar que se espera la comida en otra oficina <strong><em><code>11</code></em></strong>.</p> <p><strong>ATENCION</strong>: Recordar guardar los cambios <strong><em><code>12</code></em></strong>.</p> <h3 id='hora_lmite'>Hora límite</h3> <p>A las 9:30 AM de cada día se genera el pedido correspondiente, por lo que cualquier cambio realizado luego de esa hora no se verá reflejado.</p> <p><img src='/img/posts/2013-01-24-my-menu-instructivo/04.jpg' alt='Pedido no realizado' /></p> <p>Es fácil saber si el pedido ya se ha realizado observando la barra indicativa verde o naranja <strong><em><code>13</code></em></strong>.</p> <p><img src='/img/posts/2013-01-24-my-menu-instructivo/05.jpg' alt='Pedido ya realizado' /></p> <p>Como se ve en la captura anterior, luego de realizado el pedido los cambios para el día no se aplican.</p> <h3 id='disclaimer'>Disclaimer</h3> <p>Recordar que <a href='http://commonjobs.makingsense.com/documentation'>CommonJobs</a> y MyMenu son desarrollos OpenSource realizados en ratos libres. Cualquier mejora es bienvenida, descargá el <a href='https://github.com/CommonJobs/CommonJobs'>código fuente de GitHub</a> y hacé tu <em>Pull Request</em>.</p> 2013-01-22T00:00:00-08:00 http://andresmoschini.github.com/2013/01/22/a-blogging-framework-for-hackers-continuacion <p>Luego de desahogarme en un <a href='http://makingsensers.wordpress.com/2012/12/27/a-blogging-framework-for-hackers/'>post anterior</a>, continué investigando y probando opciones de blogs basados en <a href='http://jekyllrb.com/'>jekyll</a> y GitHub.</p> <p><a href='http://tom.preston-werner.com/2008/11/17/blogging-like-a-hacker.html'>La idea</a> es interesante: preparamos los fuentes jekyll del sitio y los post, luego GitHub se encarga de generar el sitio HTML. Los fuentes de posts son archivos HTML con Liquid o Markdown y tenemos total libertad en cuanto a la estructura del sitio y el contenido. Además, no tenemos que lidiar con esos editores de texto online pseudo WYSIWYG ya que trabajamos con archivos de texto y la publicación la realizamos con nuestro sistema de control de versiones preferido: <strong>Git</strong>.</p> <h3 id='intento_1__preparar_un_sitio_desde_cero'>Intento 1 - Preparar un sitio desde cero</h3> <p>En principio intenté preparar un sitio desde cero, o copiando otros como el de <a href='http://erjjones.github.com/'>Eric Jones</a>. Dado mi escaso conocimiento de <em>Ruby</em>, <em>Jekyll</em> y <em>Liquid</em>, creo que no fue una buena elección ya que la estructura no resultó la mejor y algunos literales como la URL base del sitio quedaron repartidos por todo el código. De cualquier manera, rescaté la experiencia y unos snippets de código que utilicé luego.</p> <h3 id='intento_2__octopress'>Intento 2 - Octopress</h3> <p><a href='http://octopress.org/'>Octopress</a> está muy bien, es muy completo y tiene buena terminación.</p> <p>Pero, el sitio no es generado por GitHub sino que cuenta con unos scripts para generarlo localmente. Para un blog personal no me parece una mala opción, pero si son muchos los editores, creo que se vuelve un poco más incomodo. Además, perdemos la posibilidad de postear directamente desde GitHub con la <a href='https://github.com/blog/1327-creating-files-on-github'>feature de crear archivos</a>.</p> <p>Como en el caso anterior, Octopress será una buena <em>cantera</em> para extraer ejemplos, snippets e ideas para utilizar.</p> <h3 id='intento_3__jekyllbootstrap'>Intento 3 - Jekyll-Bootstrap</h3> <p><a href='http://jekyllbootstrap.com/'>Jekyll-Bootstrap</a> resultó ser la opción elegida. Tiene un diseño modular, con templates y helpers. No está tan pulido como Octopress, pero es un buen punto de partida para comenzar a personalizar el sitio.</p> <h3 id='mi_prueba_de_concepto'>Mi prueba de concepto</h3> <p>El objetivo era que las mejoras en estilos, templates y layout no se mezclen con la instancia del sitio, de manera de que se puedan utilizar en otros blogs.</p> <p>Preparé un repositorio <a href='https://github.com/makingsense/jekyll-bootstrap-ms'>Jekyll-Bootstrap-MS</a>, basado en Jekyll-Bootstrap, con algunas modificaciones y adaptaciones. Es aquí donde se deberían realizar las mejoras y personalizaciones de estilos, templates y layout que puedan reutilizarse.</p> <p>Por otro lado, creé otro <a href='https://github.com/andresmoschini/andresmoschini.github.com'>repositorio</a> para mi <a href='http://andresmoschini.github.com'>blog personal</a> basado en el anterior. Aquí publicaré mis posts, realizaré cambios puntuales en el layout e ire mergeando las mejoras realizadas en Jekyll-Bootstrap-MS.</p> <h3 id='para_probar_jekyllbootstrapms_desde_github'>Para probar Jekyll-Bootstrap-MS desde GitHub</h3> <p>El <a href='https://github.com/makingsense/jekyll-bootstrap-ms/tree/gh-pages'>branch gh-pages de Jekyll-Bootstrap-MS</a> está publicado en <a href='http://makingsense.github.com/jekyll-bootstrap-ms'>http://makingsense.github.com/jekyll-bootstrap-ms</a>. Es posible realizar un <a href='https://github.com/MakingSense/jekyll-bootstrap-ms/fork_select'>Fork de este repositorio</a> y probarlo con la propia cuenta de GitHub, sin necesidad de descargar nada, utilizando las herramientas provistas por GitHub.</p> <h3 id='para_probar_jekyllbootstrapms_localmente_en_windows'>Para probar Jekyll-Bootstrap-MS localmente en Windows</h3> <h4 id='requistos'>Requistos</h4> <h5 id='cliente_git'>Cliente Git</h5> <p>Yo utilizó <a href='https://code.google.com/p/gitextensions/'>Git Extensions</a> que ya incluye MINGW y Git Bash.</p> <h5 id='instalar_de_ruby'>Instalar de Ruby</h5> <ol> <li>Desde <a href='http://rubyinstaller.org/downloads/'>Ruby Installer</a> descargar e instalar la última versión de Ruby.</li> <li>Verificar que Ruby esté en el Path o agregarlo.</li> <li>También desde <a href='http://rubyinstaller.org/downloads/'>Ruby Installer</a> descargar el Development Kit, descomprimirlo.</li> <li>Desde <em>Git bash</em> ejecutar:</li> </ol> <div class='highlight'><pre><code class='bash'><span class='nv'>$ </span><span class='nb'>cd </span>C:/RubyDevKit <span class='nv'>$ </span>ruby dk.rb init <span class='nv'>$ </span>ruby dk.rb install </code></pre></div> <h5 id='instalar_python_requerido_si_hay_pginas_con_resaltado_de_sintaxis'>Instalar Python (requerido si hay páginas con resaltado de sintaxis)</h5> <ol> <li><a href='http://www.python.org/getit/'>Descargar Python 2.7</a> e instalar</li> <li>Verificar que Python esté en el Path o agregarlo.</li> </ol> <h5 id='instalar_jekyll'>Instalar Jekyll</h5> <p>Desde <em>Git bash</em> instalar Jekyll:</p> <div class='highlight'><pre><code class='bash'><span class='nv'>$ </span>gem install jekyll </code></pre></div> <h4 id='descargar_jekyllbootstrapms'>Descargar Jekyll-Bootstrap-MS</h4> <p>Desde <em>Git bash</em>:</p> <div class='highlight'><pre><code class='bash'><span class='nv'>$ </span>git clone https://github.com/MakingSense/jekyll-bootstrap-ms.git </code></pre></div> <h4 id='ejecutar_jekyll'>Ejecutar Jekyll</h4> <div class='highlight'><pre><code class='bash'><span class='nv'>$ </span><span class='nb'>cd </span>jekyll-bootstrap-ms <span class='nv'>$ </span>jekyll --server </code></pre></div> <p>Abrir <a href='http://localhost:4000'>http://localhost:4000</a> en el navegador</p> <h3 id='pendiente'>Pendiente</h3> <p>Algunas posibles mejoras (ver <a href='https://trello.com/board/jekyll-bootstrap-ms/50fd498b591dbec63d0081d1'>board en trello</a>):</p> <ul> <li>Estaría bien agregar los números de línea en los snippets de código</li> <li>Definir mejor la estructura por defecto del sitio. Por ejemplo, en lugar de un listado de posts en la página de indice, se podrían mostrar los últimos posts completos y la posibilidad de ver los anteriores.</li> <li>Link a la página de GitHub de la cuenta asociada al blog.</li> <li>Link al source en GitHub del post o página actual.</li> <li>Mejorar la utilización de Twitter Bootstrap, por ejemplo utilizando <code>fluid rows</code></li> <li>Personalizar Twitter Bootstrap y los estilos.</li> </ul> <h3 id='invitacin'>Invitación</h3> <p>Creo que este es el motor ideal para un blog de desarrolladores de software. Espero su feedback, críticas, refutaciones, consultas o <em>pull requests</em> en <a href='https://github.com/makingsense/jekyll-bootstrap-ms'>Jekyll-Bootstrap-MS</a>.</p> 2013-01-21T00:00:00-08:00 http://andresmoschini.github.com/2013/01/21/my-menu-invitacion <p>Trabajamos en una empresa de soft, desarrollamos software y somos buenos haciendoló. Por eso, creo que es bueno que participemos en el desarrollo y mejoras de las aplicaciones que utilizamos día a día. Ese es el caso del sistema de selección de las comidas diarias: nosotros deberíamos arreglarlo, mejorarlo, optimizarlo y, llegado el caso, reemplazarlo completamente.</p> <p><em>My Menu</em> (sistema que presenté en un <a href='http://makingsensers.wordpress.com/2012/12/26/self-training-my-menu/'>post anterior</a>) fue creado con el objetivo principal de probar y conocer algunas tecnologías, sé que el código y diseño no es el mejor. Tampoco está en producción actualmente.</p> <p>Igualmente, creo que tiene algunas características interesantes y que puede ser una buena base para continuar juntos el desarrollo de una herramienta que utilizamos todos los días. Por eso me decidí a invitar a que visiten el código fuente y a que propongan cambios y mejoras.</p> <p><em>My Menu</em> forma parte de <em><a href='http://commonjobs.makingsense.com/documentation'>CommonJobs</a></em>, un sistema de uso interno del área de recursos humanos de la empresa, y utiliza su base de datos y servidores.</p> <p>En el assembly <a href='https://github.com/CommonJobs/CommonJobs/tree/master/source/CommonJobs/CommonJobs.Domain.MyMenu'>CommonJobs.Domain.MyMenu</a> se describe el dominio; en <a href='https://github.com/CommonJobs/CommonJobs/tree/master/source/CommonJobs/CommonJobs.Application.MyMenu'>CommonJobs.Application.MyMenu</a> se utiliza la infraestructura de <em>CommonJobs</em> para persistencia, y tareas recurrentes; y el grueso del código está en el proyecto <a href='https://github.com/CommonJobs/CommonJobs/tree/master/source/CommonJobs/CommonJobs.Mvc.UI'>CommonJobs.Mvc.UI</a> donde están los <em>ViewModels</em> y los <em>templates</em> de las páginas:</p> <ul> <li><a href='https://github.com/CommonJobs/CommonJobs/blob/master/source/CommonJobs/CommonJobs.Mvc.UI/Scripts/my-menu.ts'>my-menu.ts</a></li> <li><a href='https://github.com/CommonJobs/CommonJobs/blob/master/source/CommonJobs/CommonJobs.Mvc.UI/Scripts/my-menu-pages.ts'>my-menu-pages.ts</a></li> <li><a href='https://github.com/CommonJobs/CommonJobs/blob/master/source/CommonJobs/CommonJobs.Mvc.UI/Scripts/my-menu-admin-page.ts'>my-menu-admin-page.ts</a></li> <li><a href='https://github.com/CommonJobs/CommonJobs/blob/master/source/CommonJobs/CommonJobs.Mvc.UI/Scripts/my-menu-order-page.ts'>my-menu-order-page.ts</a></li> <li><a href='https://github.com/CommonJobs/CommonJobs/tree/master/source/CommonJobs/CommonJobs.Mvc.UI/Areas/MyMenu'>CommonJobs.Mvc.UI.Areas.MyMenu</a></li> </ul> <p>Espero en futuros posts ir más en detalle sobre los puntos o tecnologías interesantes. Mientras tanto, ¡espero pull requests en GitHub!</p> <h3 id='bonus_track'>Bonus Track</h3> <p>Dado que no encontré ningún <em>datepicker</em> con las características deseadas y que se integrara correctamente con <em>TypeScript</em>, <em>Bootstrap</em>, <em>Knockout</em> y <em>Moment.js</em>, preparé <a href='http://makingsense.github.com/moment-datepicker/'>moment-datepicker</a> basado en bootstrap-datepicker de Stefan Petre. Es simple, fácil de usar y tiene su <a href='https://nuget.org/packages/MomentDatepicker'>paquete de nuget</a> listo para utilizar en Visual Studio.</p>