Quien se descargue el millennia archive se preguntará cómo funciona (principalmente porque al ver la ayuda -h no muestra todas las opciones que debería, porque me olvidé de agregarle eso). La respuesta es simple, y en este mini-tutorial les voy a mostrar un caso de uso.
Explicándolo brevemente, Millennia Archive es un sistema de administración de datos al estilo repositorios/administrador de paquetes.
Un repositorio puede estar alojado en cualquier servidor http, que contiene un archivo .xml que guarda los links a cada ítem (puede ser un libro, un gráfico, un video o un archivo de música) y una interfaz web en php para poder editar dicho xml, es decir, agregar/modificar/quitar ítems.
Por el lado del cliente, hasta el momento sólo estoy desarrollando una versión en python para consola. La misma lo que hace es conectarse al/a los repositorio/s configurado/s en el archivo sources.conf (que en futuras versiones se llamará millennia.conf) para buscar/descargar un ítem deseado. Este archivo descargado se guarda en un directorio que también se parametriza desde ese archivo de configuración.
<strong>Configuración:</strong>
1. Editar con cualquier editor de textos el archivo sources.conf.
2. Modificar la opción books_dir=/home/alex/Books/ , ingresando el directorio <strong>ya existente</strong> en el que deseamos se descarguen los libros. En caso de Windows debería ser algo así como “C:\millennia\Books\”.
<strong>Ejemplo de uso:</strong>
1. Quiero descargar el libro The Flayed Hand de Guy de Maupassant.
2. Ejecuto Millennia Archive con el parámetro -s para buscar: python millennia.py -s Guy
3. Millennia Archive me imprime un mensaje con el resultado de la búsqueda del libro en todos los repositorios, asignándole a cada uno un “Millennia ID”, es decir, un número identificador del resultado de dicha búsqueda.
4. Ejecuto Millennia Archive con el parámetro -S para descargar añadiendo el ID: python millennia.py -S Guy 00.
5. Disfruto de mi libro en HTML con el visor/navegador de mi preferencia.
Así de sencillo. Hay que tener en cuenta que el número de identificación se corresponde con resultado de búsqueda, por eso se debe ingresar exactamente la misma cadena de texto que se utilizó en la búsqueda al descargar.
Es case-sensitive (diferencia mayúsculas y minúsculas), y busca por el título de los libros, que incluye autor y título separados por un guión. La búsqueda en el paso 2 podría haberse hecho con “Flayed” en lugar de “Guy” y hubiera encontrado el mismo resultado.
Se aceptan sugerencias para mejorar tanto el sistema en sí, como el cliente de consola. Saludos!
Quien se descargue el millennia archive se preguntará cómo funciona (principalmente porque al ver la ayuda -h no muestra todas las opciones que debería, porque me olvidé de agregarle eso). La respuesta es simple, y en este mini-tutorial les voy a mostrar un caso de uso.
Explicándolo brevemente, Millennia Archive es un sistema de administración de datos al estilo repositorios/administrador de paquetes.
Un repositorio puede estar alojado en cualquier servidor http, que contiene un archivo .xml que guarda los links a cada ítem (puede ser un libro, un gráfico, un video o un archivo de música) y una interfaz web en php para poder editar dicho xml, es decir, agregar/modificar/quitar ítems.
Por el lado del cliente, hasta el momento sólo estoy desarrollando una versión en python para consola. La misma lo que hace es conectarse al/a los repositorio/s configurado/s en el archivo sources.conf (que en futuras versiones se llamará millennia.conf) para buscar/descargar un ítem deseado. Este archivo descargado se guarda en un directorio que también se parametriza desde ese archivo de configuración.
Configuración:
1. Editar con cualquier editor de textos el archivo sources.conf.
2. Modificar la opción books_dir=/home/alex/Books/ , ingresando el directorio ya existente en el que deseamos se descarguen los libros. En caso de Windows debería ser algo así como “C:\millennia\Books\”.
Ejemplo de uso:
1. Quiero descargar el libro The Flayed Hand de Guy de Maupassant.
2. Ejecuto Millennia Archive con el parámetro -s para buscar: python millennia.py -s Guy
3. Millennia Archive me imprime un mensaje con el resultado de la búsqueda del libro en todos los repositorios, asignándole a cada uno un “Millennia ID”, es decir, un número identificador del resultado de dicha búsqueda.
4. Ejecuto Millennia Archive con el parámetro -S para descargar añadiendo el ID: python millennia.py -S Guy 00.
5. Disfruto de mi libro en HTML con el visor/navegador de mi preferencia.
Así de sencillo. Hay que tener en cuenta que el número de identificación se corresponde con resultado de búsqueda, por eso se debe ingresar exactamente la misma cadena de texto que se utilizó en la búsqueda al descargar.
Es case-sensitive (diferencia mayúsculas y minúsculas), y busca por el título de los libros, que incluye autor y título separados por un guión. La búsqueda en el paso 2 podría haberse hecho con “Flayed” en lugar de “Guy” y hubiera encontrado el mismo resultado.
Se aceptan sugerencias para mejorar tanto el sistema en sí, como el cliente de consola. Saludos!