Differences between revisions 1 and 11 (spanning 10 versions)
Revision 1 as of 2013-10-19 01:33:30
Size: 5668
Editor: 0v0x
Comment:
Revision 11 as of 2015-04-01 23:00:57
Size: 8624
Editor: vlax
Comment: actualizado v0.3 - indexado de directoruo
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
----
 * Traducción. Texto original : https://github.com/dyne/WebNomad/blob/master/README.txt
= WebNomad =
== creador de sitios web y galerías de imagen animadas ==

- Webnomad es software nómada

- Simple de modificar desde su archivos fuente: todo es un script ;^)

- Está diseñado para permanecer nomádico y fuera de la nube

'''Descarga''' : https://files.dyne.org/webnomad
Line 5: Line 13:
==== LEEME.txt ====

---- /!\ '''Edit conflict - other version:''' ----
 * Traducción. Texto original : https://github.com/dyne/webnomad/blob/master/README.md

---- /!\ '''Edit conflict - your version:''' ----
 * Traducción. Texto original : https://github.com/dyne/webnomad/blob/master/README.md

---- /!\ '''End of edit conflict''' ----
Line 12: Line 29:
  Un astuto publicador de sitios web estáticos v 0.2
---- /!\ '''Edit conflict - other version:''' ----
  Un astuto publicador de sitios web estáticos v 0.3

---- /!\ '''Edit conflict - your version:''' ----
  Un astuto publicador de sitios web estáticos v 0.3

---- /!\ '''End of edit conflict''' ----
Line 18: Line 42:
 WebNomad es un conjunto de scripts que permiten generar sitios web y galerías de imágenes con optimización para mostrarse en tamaño escritorio y también para navegación con tabletas o móbiles. Puede ser operado en cualquier dispositivo con consolas Zshell; los temas están basados en Bootstrap CSS; las páginas pueden ser escritas en syntaxis Markdown insertada dentro de HTML; el pase de imágenes (slideshow) utiliza JQuery y BlueImp, retomando todos los archivos que encuentran dentro de un directorio.  WebNomad es un conjunto de scripts que permiten generar sitios web y galerías de imágenes con optimización para mostrarse en tamaño escritorio y también para navegación con tabletas o móbiles. Puede ser operado en cualquier dispositivo con consolas Zshell; los temas están basados en Bootstrap CSS; las páginas pueden ser escritas en syntaxis Markdown insertada dentro de HTML; el pase de imágenes (slideshow) utiliza JQuery y BlueImp, retomando todos los archivos que encuentran dentro de un directorio.
Line 23: Line 47:
 Por ahora, WebNomad se opera desde una Terminal.
 En el futuro, y si las donaciones lo permiten, se podría construir una interfaz simple.
 Por ahora, WebNomad se opera desde una Terminal.
 En el futuro, y si las donaciones lo permiten, se podría construir una interfaz simple.
Line 28: Line 52:
  Primero crea un directorio para tu sitio web y coloca dentro el folder de webnomad, por ejemplo, aquel que descargaste del archivo fuente o del repositorio git.  Primero crea un directorio para tu sitio web y coloca dentro el folder de webnomad, por ejemplo, aquel que descargaste del archivo fuente o del repositorio git.
Line 30: Line 54:
  Desde una terminal, colocate dentro del directorio (cd) de tu nuevo sitio web y ejecuta lo siguiente:  Desde una terminal, colocate dentro del directorio (cd) de tu nuevo sitio web y ejecuta lo siguiente:
Line 34: Line 58:
  con esto, el esqueleto de tu nuevo sitio web es creado dentro del directorio:  con esto, el esqueleto de tu nuevo sitio web es creado dentro del directorio:
Line 39: Line 63:
Ahora utiliza tu editor de HTML favorito para ajustar archivos que están dentro del directorio tmpl/ y luego haz lo mismo con los de views/ para crear tus páginas web; siempre es mejor comenzar editando index.html  Ahora utiliza tu editor de HTML favorito para ajustar archivos que están dentro del directorio tmpl/ y luego haz lo mismo con los de views/ para crear tus páginas web; siempre es mejor comenzar editando index.html
Line 41: Line 65:
Para ver los resultados, ejecuta:  Para ver los resultados, ejecuta:
Line 43: Line 67:
 ./webnomad/render     ./webnomad/render
Line 45: Line 69:
Tus páginas web seran creadas dentro de pub/ y tendrán todo el marcado establecido, incorporando el cabezal, la barra de navegación y el pie de página.  Tus páginas web seran creadas dentro de pub/ y tendrán todo el marcado establecido, incorporando el cabezal, la barra de navegación y el pie de página.
Line 47: Line 71:
Para ver la vista previa abre el archivo pub/index con un navegador web.  Para ver la vista previa abre el archivo pub/index con un navegador web.
Line 49: Line 73:
Para ver los temas disponibles, ejecuta:  Para ver los temas disponibles, ejecuta:
Line 51: Line 75:
 ./webnomad/theme     ./webnomad/theme
Line 53: Line 77:
Para elegir alguno de los temas, ejecuta:  Para elegir alguno de los temas, ejecuta:
Line 55: Line 79:
 ./webnomad/theme/cyborg     ./webnomad/theme/cyborg
Line 57: Line 81:
Carga tu sitio web al servidor usando SCP recursivo o Rsync, desde pub/*  Carga tu sitio web al servidor usando SCP recursivo o Rsync, desde pub/*
Line 61: Line 85:
 Para evitar la tediosa tarea de utilizar etiquetas HTML para todo, incluso para el formateo de texto simple, webnomad permite insertar secciones escritas en markdown dentro de una página HTML. Esto se logra simplemente abriendo y cerrando las etiquetas características de este lenguaje <markdown> ... </markdown>, lo cual puede ocurrir varias veces en el mismo documento.  Para evitar la tediosa tarea de utilizar etiquetas HTML para todo, incluso para el formateo de texto simple, webnomad permite insertar secciones escritas en markdown dentro de una página HTML. Esto se logra simplemente abriendo y cerrando las etiquetas características de este lenguaje <markdown> ... </markdown>, lo cual puede ocurrir varias veces en el mismo documento.
Line 63: Line 87:
 Esta solución simplifica el uso de este lenguaje de marcado ligero dentro de una página bootstrap, en la que normalmente puedes utilizar clases <div> directamente en el HTML para estilizar bootstrap. Pero además puedes formatear el contenido de estos bloques <div> con nuestro querido lenguaje de marcado - *coff* *coff* - markdown.  Esta solución simplifica el uso de este lenguaje de marcado ligero dentro de una página bootstrap, en la que normalmente puedes utilizar clases <div> directamente en el HTML para estilizar bootstrap. Pero además puedes formatear el contenido de estos bloques <div> con nuestro querido lenguaje de marcado - *coff* *coff* - markdown.
Line 67: Line 91:
 Para crear un pase de imágenes (slideshow) simplemente crea una página con la extensión .gallery y colocala dentro del directorio views/, por ejemplo se podría llamar views/paisajes_de_Oaxaca.gallery  Para crear un pase de imágenes (slideshow) simplemente crea una página con la extensión .gal y colocala dentro del directorio views/, por ejemplo se podría llamar views/paisajes_de_Oaxaca.gal
Line 69: Line 93:
 Y para agregarle las imágenes debes crear un directorio tipo -files dentro de views/, mucho mejor si pones este tipo como sufijo del nombre de la página de galería. Algo similar a esto: views/paisajes_de_Oaxaca-files  Y para agregarle las imágenes debes crear un directorio tipo -files dentro de views/, mucho mejor si nombras este directorio igual que el nombre de la galería pero incorporando el sufijo -files. Algo similar a esto: views/paisajes_de_Oaxaca-files
Line 71: Line 95:
 Copia tus imágenes dentro del directorio -files, redimensionalas al formato que quieras que aparezcan en el slideshow. Opcionalmente puedes usar el script webnomad/convert para ayudarte con las conversiones en bloque (Requiere ImageMagick).  Copia tus imágenes dentro del directorio -files, redimensionalas al formato que quieras que aparezcan en el slideshow. Opcionalmente puedes usar el script webnomad/convert para ayudarte con las conversiones en bloque (Requiere ImageMagick).
Line 73: Line 97:
 Ahora edita el archivo .gallery para colocar los nombres de cada una de las imágenes, una por línea, indicando su ruta relativa a views/  Ahora edita el archivo .gallery para colocar los nombres de cada una de las imágenes, una por línea, indicando su ruta relativa a views/
Line 75: Line 99:
 En nuestro ejemplo, el archivo views/paisajes_de_Oaxaca.gallery puede contener:
   views/paisajes_de_Oaxaca-files/Mitla.jpeg
  views/paisajes_de_Oaxaca-files/Mixteca_Nuyoo.jpeg
  views/paisajes_de_Oaxaca-files/Cuajimoloyas.jpeg
  views/paisajes_de_Oaxaca-files/Miahuatlan.jpeg
  views/paisajes_de_Oaxaca-files/Tehuantepec.jpeg
 En nuestro ejemplo, el archivo views/paisajes_de_Oaxaca.gal puede contener:
   views/paisajes_de_Oaxaca-files/Mitla.jpeg
    views/paisajes_de_Oaxaca-files/Mixteca_Nuyoo.jpeg
    views/paisajes_de_Oaxaca-files/Cuajimoloyas.jpeg
    views/paisajes_de_Oaxaca-files/Miahuatlan.jpeg
    views/paisajes_de_Oaxaca-files/Tehuantepec.jpeg
Line 83: Line 106:
 Finalmente ejecuta webnomad/render y el slideshow estará listo en la página en pub/ el cual en nuestro caso es pub/paisajes_de_Oaxaca  Finalmente ejecuta webnomad/render y el slideshow estará listo en la página en pub/ el cual en nuestro caso es pub/paisajes_de_Oaxaca
Line 85: Line 108:

* INDEXADO DE DIRECTORIO

Al usar Webnomad se puede también crear páginas web que muestre recursivamente un índice del contenido de cualquier directorio dentro del sistema de archivos.

Para lograr esto tienes que crear un archivo con la extensión .idx o .index, luego tienes que rellenarlo con las configuraciones necesarias. Por ejemplo, puedes colocar el archivo mi_directorio-de_paisajes.index el cual puede contener una línea (# indica un comentario)

# ruta a ser indexado url del subfolder tipo de indexado
/home/canek/fotos fotos short

Esto generará la url fotos/index.html la cual mostrará todos los archivos dentro de ese directorio con previsualización y ligas a los subfolders que son indexados de la misma manera.

En algunos casos puede ser útil poner a disposición las descargas desde algún lugar diferente al WEB_ROOT, lo que puede ser en otro servidor o un alias de apache. Para configurar esto se utiliza FILES_ROOT en config.zsh.

---- /!\ '''Edit conflict - other version:''' ----


* INDEXADO DE DIRECTORIO

Al usar Webnomad se puede también crear páginas web que muestre recursivamente un índice del contenido de cualquier directorio dentro del sistema de archivos.

Para lograr esto tienes que crear un archivo con la extensión .idx o .index, luego tienes que rellenarlo con las configuraciones necesarias. Por ejemplo, puedes colocar el archivo mi_directorio-de_paisajes.index el cual puede contener una línea (# indica un comentario)

# ruta a ser indexado url del subfolder tipo de indexado
/home/canek/fotos fotos short

Esto generará la url fotos/index.html la cual mostrará todos los archivos dentro de ese directorio con previsualización y ligas a los subfolders que son indexados de la misma manera.

En algunos casos puede ser útil poner a disposición las descargas desde algún lugar diferente al WEB_ROOT, lo que puede ser en otro servidor o un alias de apache. Para configurar esto se utiliza FILES_ROOT en config.zsh.

---- /!\ '''Edit conflict - your version:''' ----

---- /!\ '''End of edit conflict''' ----
Line 88: Line 144:
 Lo más actual está en GitHub https://github.com/dyne/webnomad  Lo más actual está en GitHub https://github.com/dyne/webnomad
Line 90: Line 146:
 Ven al canal IRC #dyne via https://irc.dyne.org para entrar en contacto  Ven al canal IRC #dyne via https://irc.dyne.org para entrar en contacto
Line 94: Line 150:
  Donaciones en dinero son muy bienvenidas y necesarias  Donaciones en dinero son muy bienvenidas y necesarias
Line 96: Line 152:
  https://www.dyne.org/donate  https://www.dyne.org/donate
Line 100: Line 156:
WebNomad es Copyright (C) 2012-2013 Denis Roio <jaromil@dyne.org>  WebNomad es Copyright (C) 2012-2013 Denis Roio <jaromil@dyne.org>
Line 102: Line 158:
Traducción al español de Vlax <vlax@dyne.org>  Traducción al español de Vlax <https://lab.dyne.org/vlax>
Line 104: Line 160:
Este programa es software libre: puedes redistribuirlo y/o modificarlo dentro de los términos de la Licencia Pública General GNU Affero como es publicada por la Free Software Foundation, tanto en su versión 3 de la licencia, o (a tu elección) en cualquier versión posterior.  Este programa es software libre: puedes redistribuirlo y/o modificarlo dentro de los términos de la Licencia Pública General GNU Affero como es publicada por la Free Software Foundation, tanto en su versión 3 de la licencia, o (a tu elección) en cualquier versión posterior.
Line 106: Line 162:
Este programa se distribuye con el ánimo de que sea útil pero SIN NINGUNA GARANTÍA; ni siquiera la garantía implícita de MERCANTIBILIDAD o ADAPTABILIDAD A CUALQUIER PROPÓSITO PARTICULAR. Ver la Licencia Pública General GNU Affero para más detalles.  Este programa se distribuye con el ánimo de que sea útil pero SIN NINGUNA GARANTÍA; ni siquiera la garantía implícita de MERCANTIBILIDAD o ADAPTABILIDAD A CUALQUIER PROPÓSITO PARTICULAR. Ver la Licencia Pública General GNU Affero para más detalles.
Line 108: Line 164:
Deberías recibir una copia de la Licencia Pública General GNU Affero junto con este programa. Si no es así, ver: http://www.gnu.org/licenses  Deberías recibir una copia de la Licencia Pública General GNU Affero junto con este programa. Si no es así, ver: http://www.gnu.org/licenses

WebNomad

creador de sitios web y galerías de imagen animadas

- Webnomad es software nómada

- Simple de modificar desde su archivos fuente: todo es un script ;^)

- Está diseñado para permanecer nomádico y fuera de la nube

Descarga : https://files.dyne.org/webnomad


LEEME.txt


/!\ Edit conflict - other version:



/!\ Edit conflict - your version:



/!\ End of edit conflict


 ...La factoría de software libre Dyne.org presenta...
                __                                  __ 
.--.--.--.-----|  |--.-----.-----.--------.---.-.--|  |
|  |  |  |  -__|  _  |     |  _  |        |  _  |  _  |
|________|_____|_____|__|__|_____|__|__|__|___._|_____|

---- /!\ '''Edit conflict - other version:''' ----
  Un astuto publicador de sitios web estáticos v 0.3

---- /!\ '''Edit conflict - your version:''' ----
  Un astuto publicador de sitios web estáticos v 0.3

---- /!\ '''End of edit conflict''' ----

       http://dyne.org/software/webnomad

* INTRODUCCCIÓN

 WebNomad es un conjunto de scripts que permiten generar sitios web y galerías de imágenes con optimización para mostrarse en tamaño escritorio y también para navegación con tabletas o móbiles. Puede ser operado en cualquier dispositivo con consolas Zshell; los temas están basados en Bootstrap CSS; las páginas pueden ser escritas en syntaxis Markdown insertada dentro de HTML; el pase de imágenes (slideshow) utiliza JQuery y BlueImp, retomando todos los archivos que encuentran dentro de un directorio.


* INSTRUCCIONES DE USO

 Por ahora, WebNomad se opera desde una Terminal.
 En el futuro, y si las donaciones lo permiten, se podría construir una interfaz simple.

** USO BÁSICO 

 Primero crea un directorio para tu sitio web y coloca dentro el folder de webnomad, por ejemplo, aquel que descargaste del archivo fuente o del repositorio git.

 Desde una terminal, colocate dentro del directorio (cd) de tu nuevo sitio web y ejecuta lo siguiente:
  
    ./webnomad/init 

 con esto, el esqueleto de tu nuevo sitio web es creado dentro del directorio:

    views/ -> contiene las páginas que quieras editar
    tmpl/ -> contiene plantillas como header (cabezal), footer (pie de página), y navbar (barra de navegación).

 Ahora utiliza tu editor de HTML favorito para ajustar archivos que están dentro del directorio tmpl/ y luego haz lo mismo con los de views/ para crear tus páginas web; siempre es mejor comenzar editando index.html

 Para ver los resultados, ejecuta:

    ./webnomad/render

 Tus páginas web seran creadas dentro de pub/ y tendrán todo el marcado establecido, incorporando el cabezal, la barra de navegación y el pie de página.

 Para ver la vista previa abre el archivo pub/index con un navegador web.

 Para ver los temas disponibles, ejecuta:

    ./webnomad/theme

 Para elegir alguno de los temas, ejecuta:

    ./webnomad/theme/cyborg

 Carga tu sitio web al servidor usando SCP recursivo o Rsync, desde pub/*

** UTILIZA MARKDOWN

 Para evitar la tediosa tarea de utilizar etiquetas HTML para todo, incluso para el formateo de texto simple, webnomad permite insertar secciones escritas en markdown dentro de una página HTML. Esto se logra simplemente abriendo y cerrando las etiquetas características de este lenguaje <markdown> ... </markdown>, lo cual puede ocurrir varias veces en el mismo documento.

 Esta solución simplifica el uso de este lenguaje de marcado ligero dentro de una página bootstrap, en la que normalmente puedes utilizar clases <div> directamente en el HTML para estilizar bootstrap. Pero además puedes formatear el contenido de estos bloques <div> con nuestro querido lenguaje de marcado - *coff* *coff* - markdown.

** PASE DE IMÁGENES 

 Para crear un pase de imágenes (slideshow) simplemente crea una página con la extensión .gal y colocala dentro del directorio views/, por ejemplo se podría llamar views/paisajes_de_Oaxaca.gal

 Y para agregarle las imágenes debes crear un directorio tipo -files dentro de views/, mucho mejor si nombras este directorio igual que el nombre de la galería pero incorporando el sufijo -files. Algo similar a esto: views/paisajes_de_Oaxaca-files

 Copia tus imágenes dentro del directorio -files, redimensionalas al formato que quieras que aparezcan en el slideshow. Opcionalmente puedes usar el script webnomad/convert para ayudarte con las conversiones en bloque (Requiere ImageMagick).

 Ahora edita el archivo .gallery para colocar los nombres de cada una de las imágenes, una por línea, indicando su ruta relativa a views/

 En nuestro ejemplo, el archivo views/paisajes_de_Oaxaca.gal puede contener:
    views/paisajes_de_Oaxaca-files/Mitla.jpeg
    views/paisajes_de_Oaxaca-files/Mixteca_Nuyoo.jpeg
    views/paisajes_de_Oaxaca-files/Cuajimoloyas.jpeg
    views/paisajes_de_Oaxaca-files/Miahuatlan.jpeg
    views/paisajes_de_Oaxaca-files/Tehuantepec.jpeg

 Finalmente ejecuta webnomad/render y el slideshow estará listo en la página en pub/ el cual en nuestro caso es pub/paisajes_de_Oaxaca


* INDEXADO DE DIRECTORIO

Al usar Webnomad se puede también crear páginas web que muestre recursivamente un índice del contenido de cualquier directorio dentro del sistema de archivos.

Para lograr esto tienes que crear un archivo con la extensión .idx o .index, luego tienes que rellenarlo con las configuraciones necesarias. Por ejemplo, puedes colocar el archivo mi_directorio-de_paisajes.index el cual puede contener una línea (# indica un comentario)

# ruta a ser indexado  url del subfolder    tipo de indexado
/home/canek/fotos      fotos             short

Esto generará la url fotos/index.html la cual mostrará todos los archivos dentro de ese directorio con previsualización y ligas a los subfolders que son indexados de la misma manera.

En algunos casos puede ser útil poner a disposición las descargas desde algún lugar diferente al WEB_ROOT, lo que puede ser en otro servidor o un alias de apache. Para configurar esto se utiliza FILES_ROOT en config.zsh.

---- /!\ '''Edit conflict - other version:''' ----


* INDEXADO DE DIRECTORIO

Al usar Webnomad se puede también crear páginas web que muestre recursivamente un índice del contenido de cualquier directorio dentro del sistema de archivos.

Para lograr esto tienes que crear un archivo con la extensión .idx o .index, luego tienes que rellenarlo con las configuraciones necesarias. Por ejemplo, puedes colocar el archivo mi_directorio-de_paisajes.index el cual puede contener una línea (# indica un comentario)

# ruta a ser indexado  url del subfolder    tipo de indexado
/home/canek/fotos      fotos             short

Esto generará la url fotos/index.html la cual mostrará todos los archivos dentro de ese directorio con previsualización y ligas a los subfolders que son indexados de la misma manera.

En algunos casos puede ser útil poner a disposición las descargas desde algún lugar diferente al WEB_ROOT, lo que puede ser en otro servidor o un alias de apache. Para configurar esto se utiliza FILES_ROOT en config.zsh.

---- /!\ '''Edit conflict - your version:''' ----

---- /!\ '''End of edit conflict''' ----
        
* DESARROLLO

 Lo más actual está en GitHub https://github.com/dyne/webnomad

 Ven al canal IRC #dyne via https://irc.dyne.org para entrar en contacto

* DONAR

 Donaciones en dinero son muy bienvenidas y necesarias 

 https://www.dyne.org/donate

* LICENCIA

 WebNomad es Copyright (C) 2012-2013 Denis Roio <jaromil@dyne.org>

 Traducción al español de Vlax <https://lab.dyne.org/vlax>

 Este programa es software libre: puedes redistribuirlo y/o modificarlo dentro de los términos de la Licencia Pública General GNU Affero como es publicada por la Free Software Foundation, tanto en su versión 3 de la licencia, o (a tu elección) en cualquier versión posterior.

 Este programa se distribuye con el ánimo de que sea útil pero SIN NINGUNA GARANTÍA; ni siquiera la garantía implícita de MERCANTIBILIDAD o ADAPTABILIDAD A CUALQUIER PROPÓSITO PARTICULAR. Ver la Licencia Pública General GNU Affero para más detalles.

 Deberías recibir una copia de la Licencia Pública General GNU Affero junto con este programa. Si no es así, ver: http://www.gnu.org/licenses

WebNomad.es (last edited 2016-12-01 06:00:11 by vlax)