Confusion.com.mx » documentación http://www.confusion.com.mx/blog Un punto de vista personal Fri, 06 Aug 2010 16:53:00 +0000 en hourly 1 http://wordpress.org/?v=3.0.1 WikiUnix: un sitio de referencia para operativos basados en Unix http://www.confusion.com.mx/blog/2010/06/wikiunix-un-sitio-de-referencia-para-operativos-basados-en-unix/ http://www.confusion.com.mx/blog/2010/06/wikiunix-un-sitio-de-referencia-para-operativos-basados-en-unix/#comments Mon, 07 Jun 2010 16:28:23 +0000 antonio http://www.confusion.com.mx/blog/?p=420 Esta mañana me encuentro con una buena noticia, existe un proyecto de documentación de sistemas operativos tipo Unix basado en un wiki: WikiUnix.

Este sitio, cuyo idioma nativo es el Español, pretende ser un referente para ayudar al principiante, al iniciado, al habitual y al profesional, explicando los tópicos comúnes a estos niveles.

Cuenta tambien con una operativo virtualizado, el cual puedes descargar, para poner en práctica los conocimientos adquiridos en sus páginas digitales. Y si visitas esta web podras encontrar documentos en pdf para descargar y leer cuando mejor gustes :P

Es necesario dejar claro que tambien puedes ayudar con este tipo de proyectos, si sabes algo de unix puedes completar págianas y si no eres experto, siempre puedes ayudar con el trabajo pesado de poner el estilo a las páginas.

Espero que esto les sirva sin importar el nivel que tengan, siempre es bueno volver a leer lo básico, así no se olvida :)

]]> http://www.confusion.com.mx/blog/2010/06/wikiunix-un-sitio-de-referencia-para-operativos-basados-en-unix/feed/ 0 TiddlyWiki: Una libreta digital de anotaciones http://www.confusion.com.mx/blog/2009/09/tiddlywiki-una-libreta-digital-de-anotaciones/ http://www.confusion.com.mx/blog/2009/09/tiddlywiki-una-libreta-digital-de-anotaciones/#comments Fri, 18 Sep 2009 14:56:07 +0000 antonio http://www.confusion.com.mx/blog/?p=169 Esta vez quiero platicarles sobre una de esas herramientas poco conocidas, muy pequeñas en tamaño, pero de gran valor por lo que resuelven.

TiddlyWiki es un archivo HTML con CSS y JavaScript que permite editar su propio contenido, es decir, tiene la habilidad de poder sobreescribir su propio archivo a petición del usuario.

Como podrán darse cuenta por su nombre, esta aplicación esta basada en el concepto Wiki. Se compone de tiddlers, los cuales son pequeñas entradas de texto. Para crear o editar un tiddler, tan solo hay que hacer doble click sobre él o presionar el boton editar.

Dada la naturaleza caotica del wiki y gracias a que los tiddlers se hacen visibles o invisibles según se vayan utilizando o descartando, es muy sencillo navegar sobre toda la información contenida en el archivo de manera muy rápida y directa, no hay que estar abriendo montones de páginas o regresando… simplemente abres un par de tiddlers, si ocupas, abres otro y puedes cerrar solamente uno y los demas siguen disponibles en el orden en que se abrieron.

Llevo cerca de un año usando el TiddlyWiki para la documentación de un proyecto en l trabajo, es impresionante la facilidad y la elegancia con la que se deja el trabajo final, pero he de advertirles, es mucha labor usar esta herramienta, y mantener la información contenida puede llegar a ser un fastidio.

Esta herramienta ha sido popular en algunos sectores que existen varias versiones hechas por usuarios, por ejemplo, hacerla capaza de trabajar con bases de datos para trabajar bajo el modelo cliente-servidor. Hay muchisimos plug-ins que permiten potenciar la capacidad de esta libreta virtual, uso algunos de ellos y me han parecido facinantes.

Tan solo me resta decir que TiddlyWiki es una opcion más si quieren llevar un diario digital o acceder a documentación de manera no lineal.

Enlaces

Sitio del autor http://www.tiddlywiki.com/
Guía para novatos: Tiddler Toddler http://tiddlertoddler.tiddlyspot.com/
Hoja de códigos http://www.linuxbeacon.com/doku.php/cheatsheets

]]> http://www.confusion.com.mx/blog/2009/09/tiddlywiki-una-libreta-digital-de-anotaciones/feed/ 1 Impresión de libros en casa: Parte 2 http://www.confusion.com.mx/blog/2009/06/impresion-de-libros-en-casa-parte-2/ http://www.confusion.com.mx/blog/2009/06/impresion-de-libros-en-casa-parte-2/#comments Tue, 30 Jun 2009 17:55:35 +0000 antonio http://confusion.com.mx/blog/?p=66 Bueno, ahora nos salimos un poco de la tecnología digital veamos un arte que no pasa de moda.

El proceso de encuadernación es realmente muy sencillo aunque algo laborioso, así que depende de cada quien si desea hacerlo o pagar $100 MXN para tener el libro de buena calidad.

A los que decidan hacerlo por su cuenta, les dejo unos recursos que encontré.

Video sobre encuadernación (español):

Otro video en español:

Muy buen video de encuadernado (ingles):

]]> http://www.confusion.com.mx/blog/2009/06/impresion-de-libros-en-casa-parte-2/feed/ 0 Impresión de libros en casa: Parte 1 http://www.confusion.com.mx/blog/2009/06/impresion-de-libros-en-casa-parte-1/ http://www.confusion.com.mx/blog/2009/06/impresion-de-libros-en-casa-parte-1/#comments Wed, 17 Jun 2009 16:27:05 +0000 antonio http://confusion.com.mx/blog/?p=55 Encontré un par de manuales muy útiles para la creación de diagramas (llamense mecánicos, eléctricos, electrónicos, hidráulicos, etc.) y como no tenia algo mejor que hacer, decidí hacer libros caseros con esos, les comento los pasos que seguí.

Paso 0: Investigar lo que tenia que hacer, materiales y algunas técnicas, sobre todo para saber costos.

Paso 1: Encontre un par de herramientas interesantes para trabajar con archivos PDF y PS (PostScript), asi que le damos las palabras magicas de instalar:

$sudo apt-get install psutils pdftk

Les recomiendo que si tienen algo que editar de sus documentos, como voltear, añadir o quitar hojas, lo hagan ahorita, despues es una batalla.

Paso 2: Una vez que tenemos nuestro archivo PDF listo para impresión, debemos convertirlo a PostScript para trabajar con el. Muy simple comando:

$pdf2ps original.pdf resultado.ps

Paso 3: Hay que reordenar las páginas electrónicas si queremos que nuestro libro esté impreso por ambos lados de la hoja:

$psbook resultado.ps ordenado.ps

Listo, ahora tienen todo hecho si quieren imprimir su libro.

Paso 4: Ya que me gusta economizar y no quiero tener un par de manuales estorbosos en tamaño carta, le voy a hacer un nuevo cambio para que me imprima 2 hojas electrónicas por página, reduciendo así el consumo de hojas a la mitad :P

$psnup -2 -l -pletter ordenado.ps final.ps

Paso 5: Imprimir y cortar por la mitad. Queda todo listo para encuadernar, pero eso lo dejamos para la segunda parte :)

Enlaces de interes:

PStools: Working with PostScript files

PSUtils http://www.tardis.ed.ac.uk/~ajcd/psutils/

PDFtk http://www.accesspdf.com/pdftk/

DOE-HDBK-1016/1-93 DOE Fundamentals Handbook, Engineering Symbology, Prints, and Drawings, Volume 1 of 2

DOE-HDBK-1016/2-93 DOE Fundamentals Handbook, Engineering Symbology, Prints, and Drawings, Volume 1 of 2

http://www.hss.doe.gov/nuclearsafety/ns/techstds/standard/hdbk1016/h1016v1.pdf
]]> http://www.confusion.com.mx/blog/2009/06/impresion-de-libros-en-casa-parte-1/feed/ 1 Doxygen: documentando código http://www.confusion.com.mx/blog/2009/03/doxygen-documentando-codigo/ http://www.confusion.com.mx/blog/2009/03/doxygen-documentando-codigo/#comments Thu, 19 Mar 2009 15:26:36 +0000 antonio http://confusion.com.mx/blog/?p=22 Logo Doxygen

Hace unos dias estaba buscando una herramienta que me ayudara a documentar mi código, comenze de 0, pero no dio buenos resultados, asi que opté por algo que habia visto alguna vez: doxygen.

La idea es simple: hacer la documentación EN el archivo fuente. Esto da una gran ventaja a la hora de evolucionar un programa, mucho más cuando los requerimientos no están del todo claro :P

Puedo decir que doxygen cumple las espectativas, la creación del paquete de documentación en HTML es rapida, sencilla y parece que puede ser muy poderosa (recuerda que solo llevo un par de dias usandolo!).

Los “comandos” para documentar son simples y estéticos, y lo mejor de todo, puedes documentar el código… digamos que por separado, esto es, escribes lo que contendrá el HTML/PDF/etc como si fuese un ente aparte, mientras sigues poniendo comentarios del tipo:

/* Ponemos este contador en lo que se me ocurre algo más */
int cont = 0;

Curioso, no? Veamos algo un poquitín elaborado:

/** @fn int RellenaCirculo (int color, int centro_x, int centro_y, int radio);
    @brief Rellena con el color indicado un círculo trigonométrico.
    @param[in]    color        El color a usar basado la lista de colores
    @param[in]    centro_x     Coordenada del punto centro del círculo en el eje X
    @param[in]    centro_y     Coordenada del punto centro del círculo en el eje Y
    @param[in]    radio        Radio geométrico para representar el circulo
    @return        verdadero en caso de exito, falso si hubo error.
    @todo Hacer la función!!!
    @author Antonio
*/

Se ve muy bien para ser la primera impresión… amor a primera vista? Uno nunca sabe :)

Enlaces de interés:

  1. Página de un maestro costarricense, muy interesante
  2. Página principal del proyecto
  3. El manual mas nuevo (al momento de escribir la nota)
]]> http://www.confusion.com.mx/blog/2009/03/doxygen-documentando-codigo/feed/ 0