crear una manpage

9 comentarios

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:

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

Anuncios

activar el escalado de frecuencia de cpu

2 comentarios

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.

Más

Descarga automática de los torrents usando RSS

4 comentarios

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

Más

Pasar un midi a wav

Deja un comentario

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

Ponerle linux a un compaq presario f706la

20 comentarios

Esto es una explicación de como ponerle GNU/linux a un Compaq presario C706LA (o F706LA que es el mismo), que tiene las siguientes caracteristicas:

CPU: AMD Turion 64 MK-38 (2,2 ghz)
RAM: 1024 Mb 667MHz (Ampliable)
Disco: 120 gb, 5400 rpm SATA
Video: Nvidia geforce go 6100 (memoria compartida, yo la tengo en 64 Mb pero se le puede asignar más)
Wifi: Broadcom Corporation Dell Wireless 1390 WLAN Mini-PCI Card (rev 02) (esto lo averigüe después)

Principalmente lo escogi por el procesador, la targeta de video (nvidia tiene drivers para varios sistemas, incluyendo GNU/linux) y porque tenia un buen precio.

Entre las características los leds del botón de encendido, el touchpad, los indicadores de actividad y de la wireless son de un azules brillante y cuando algo está desactivados cambian a naranjo. ahora lo malo es que con suerte la batería dura con suerte unas 2 hrs.

También están las hotkeys, o sea al apretar la tecla “fn” junto con otras se puede cambiar el brillo, controlar el reproductor (poner pausa, adelantar o atrasar la pista…), suspender el equipo, activar/desactivar el sonido, etc.

Ahora manos a la obra:
Más

configurar un router con vtr

11 comentarios

Voy a darles una pequeña explicación de como configurar un router para usarlo con una conexión de VTR, lo primero que tengo que señalar es que el problema que se da en este caso es que vtr registra la dirección “mac” de la tarjeta de red del equipo en donde instalaron la red originalmente (la mac es un numero hexadecimal único que identifica a cada tarjeta). Por ello si conectas un router al modem para compartir internet, no va a funcionar porque tiene una mac distinta a la que registraron los de vtr. Para resolver esto existen dos soluciones que son llamar a la compañía y decirles que cambiaste el equipo o la otra alternativa es clonar la mac de tu tarjeta de red en el router para que tenga acceso a internet y así poder compartirla, yo voy a explicar brevemente como es hace esta ultima.

Lo primero es averiguar la mac del equipo que tenia el equipo que en un principio tenia internet, para ello si estas en windows te vas a INICIO > EJECUTAR > escribes “cmd” > ACEPTAR …se te abre la ventana de DOS y escribes: ipconfig /all

Te va a salir la descripción completa de servidores, ip, etc. entre toda esa información esta una que dice dirección física, esa es la mac así que la anotas en un papel para usarla mas adelante

En caso que que usen GNU/Linux es igual de facil, solo abres un terminal y escribe: ifconfig también aparecerá la información de la red y entre ella hay una que dice HWaddr, esa es la dirección mac, así que la anotas.

Luego de obtener la mac de la tarjeta desconectas el cable de red que viene al modem y conectas al modem con el router. Luego con otro cable conectas la tarjeta de red de tu pc con el puerto LAN 1 del router.

Después de eso abres la pagina de configuración del router en el navegador, para ello hay que poner una dirección en el navegador web (normalmente es http://192.168.0.1 aunque dependiendo del router puede se otra) y en la ventana que te sale escribes el usuario y contraseña correspondiente (búscalas en el manual del router). Entras a la configuración del router y buscas la opción de mac address clone o algo similar e ingresa la direccion mac obtenida anteriormente y guardas la nueva configuración (les dejo una imagen de referencia).

Mac address clone

Listo, ya cambiaste la dirección mac del router, para terminar de configurar la conexión solo usa el asistente del router o configuralo como indica le manual de este.

Aceleración 3D de una Ati Radeon 7000 en debian

2 comentarios

Les voy a explicar como obtener la aceleración 3D para una Ati Radeon 7000/VE (la tarjeta de mi equipo de escritorio) mediante un driver libre (es la única opción ya que ati se olvido que hay personas que aun usamos esta tarjeta y sus drivers propietarios comienzan desde la serie 8500)

Tal como dice el titulo la explicación es para el sistema que estoy usando en este momento que es debian lenny (también conocido como testing) y fue lo que me funciono a mi, por lo que no es seguro que le funcione a otras personas y/o distribuciones, pero no se pierde nada con intentarlo.

Así que manos a la obra….
Más

Older Entries