crear una manpage

Este pequeño post es para explicar una manera rápida y fácil para escribir paginas de manual (mas conocidas como manpage).

Para ello necesitamos:

• asciidoc
• xmlto (también se puede usar otros, como xsltproc)

Que en debian se pueden instalar fácilmente haciendo:

aptitude install asciidoc xmlto

Ahora abrimos un editor de texto cualquiera y escribimos la manpage, por ejemplo voy escribir esta pagina inventada (la voy a guardar con el nombre ejemplo.txt):

EJEMPLO(1)
=========
John Doe <johndoe@loquesea.com>

NAME
----
ejemplo - Un ejemplo de manpage

SYNOPSIS
--------
*ejemplo* ['OPCION']

DESCRIPCION
-----------
Este es un ejemplo de como escribir una manpage usando asciidoc,
por lo tanto este texto no tiene mucho sentido y solo sirve de
ejemplo.

BUGS
----
Si descubre bugs, intente avisarlos

AUTOR
-----
Escrito por John Doe, <johndoe@loquesea.com>


REFERENCIAS
-----------
Asciidoc: http://www.methods.co.nz/asciidoc/

xmlto: http://cyberelk.net/tim/xmlto/

COPYING
-------
Normalmente se colocar en este lugar una nota sobre la licencia
del programa, pero como es un ejemplo lo dejo a su inmaginacion

Como ven se trata de un simple texto plano, sin ninguna gran complicación, ahora la vamos a transformar a un xml (formato DocBook) para ello hacemos:

asciidoc -b docbook -d manpage ejemplo.txt

Con eso generamos el clásico xml (DocBook) que se usa para escribir manpages.

Finalmente creamos el archivo en formato manpage a partir del xml haciendo:

xmlto man ejemplo.xml

y listo tenemos nuestra manpage, podemos visualizarla haciendo

man -l ejemplo.1

Eso es todo, así de fácil.

Si quieren ver verdaderas manpages creadas con asciidoc pueden revisar la manpage del mismo asciidoc o la de fluxbox

Nota: Si quisiéramos tener la pagina creada en nuestro como parte del sistema como predeterminado, simplemente tendremos que moverla a la ubicación en donde están alojados todos los manpages disponibles, en mi sistema (que es una debian) los manuales/manpages están ubicados en /usr/share/man

Casi se me olvidaba, si alguien quiere usar xsltproc en vez de xmlto para generar el manpage, se hace de la siguiente manera

xsltproc --nonet /usr/share/xml/docbook/stylesheet/nwalsh/manpages/docbook.xsl ejemplo.xml

activar el escalado de frecuencia de cpu

Ahora voy a escribir un mini tutorial de como activar el escalado de frecuencia de CPU, en otras palabras que se ajuste la frecuencia de la CPU segun la carga que tenga el sistema. Al disminuir la velocidad de la CPU (y por consecuencia el voltaje que usa) se tienen dos ventajas: Por un lado al funcionar parte del tiempo bajo máxima capacidad del procesador el sistema no se calienta como si estuviera corriendo a toda velocidad durante todo el tiempo y la otra ventaja es que se consume menos energía ya que no se esta siempre al máximo (bastante importante si usamos bateria). Claro que al disminuir la velocidad del procesador se pierde un poco de rendimiento (aunque no siempre estamos usando toda la capacidad, así que es conveniente hacerlo cuando el sistema no esta tan cargado).

Como es costumbre lo probé en una debian (si la de mi laptop, que tiene etch) así que a continuación el mini-tutorial.

Descarga automática de los torrents usando RSS

Esto es algo bastante útil para los que seguimos series semana a semana (en mi caso principalmente anime). Normalmente hay que preocuparse de revisar las paginas y luego bajar el *.torrent para iniciar las descargas, así que pensé en hacerlo de una manera mas automática, o sea que mi PC revisara cada cierto tiempo los feeds rss que tiene los sitios y si hay nuevos torrent que los guardara e iniciara su descarga. Estarán pensando que tiene esto de novedoso si utorrent ya lo hace, la respuesta es simple yo lo quería hacer desde GNU/Linux y con mi cliente favorito (rtorrent, que por cierto es bastante bueno)

Para hacerlo voy a utilizar flexget (para revisar los feeds) y como programa para descargar rtorrent, aunque sirve cualquier otro cliente que revise un directorio en búsqueda de nuevos *.torrent. La explicación es un poco larga así que hagan click en continuar leyendo para ver la explicación

Pasar un midi a wav

Esta es una pequeña explicación de como transformar un midi a wav, lo primero que hay que señalar es que son formatos muy distintos. Un midi contiene la descripción de cómo hacer el sonido (algo así como una partitura que indica en que momento tiene que sonar una nota y que instrumento hay que utilizar para esa nota) y para que se produzca el sonido hay que utilizar un sintetizador que reproduzca el sonido (este sintetizador puede ser incluido en la tarjeta de sonido, como es el caso de las Sound Blaster o puede se por sofware, como el que incluye Microsoft en sus sistemas operativos) por lo cual en equipos diferentes un midi puede sonar de distinta manera, en contraste un wav es un formato de audio digital (algo así como una imagen o radiografía de la onda sonora), por lo que al reproducirlo en cualquier reproductor de WAVs debería sonar de la misma manera que del sonido original.

Ahora para pasar un midi a wav, hay que grabar digitalmente los sonidos que produce el sintetizador, cosa que podemos hacer por ejemplo con el Timidity++, que es el típico programa que se utiliza en GNU/Linux como sintetizador (para reproducir midis). Para ello en un terminal hacemos algo como esto:

$ timidity cancion.mid -Ow1S -s 44100 -o cancion.wav

Esto nos generara un un archivo wav a partir del midi, eso si el archivo no esta muy optimizado, así que pueden usar algún programa como el audacity para editarlo y si quieren guardarlo en otro formato.

Ahora hacer lo contrario (pasar un wav a midi) es mucho mas complicado, ya que un wav reúne información muy compleja sobre frecuencias, volúmenes, resolución, etc, y toda ella aparece mezclada y mientras mas instrumentos o voces contenga es mucho peor. Aunque existen programas que intentan separar e identificar los tonos de un wav y a partir de ellos, generan un archivo midi, los resultados de estos no siempre son de lo mejor. Algunos de estos programas son WaoN, fanr, etc. si quieren mas información sobre esto, en este blog hay un muy buen post que menciona a varios de ellos