Constructor AsciiDoc sitio web es un programa escrito en Python que permite escribir una página web en un texto casi plano (es decir AsciiDoc), además de algunos archivos de configuración simples. Existe para resolver mi problema de no actualizar mi propia página web (que utiliza una gran cantidad de PHP) porque no podía recordar rápidamente improvisada todos los cambios y formato específico que necesitaba para añadir nuevas páginas.
Aquí están algunas características clave de "AsciiDoc Website Builder":
· Sistema de plantillas flexibles
· Blog generación
· Galería de imágenes generación
· Generación sitemap.xml
· Todas las características deliciosas de AsciiDoc
Empezando:
Para empezar a utilizar AWB usted debe configurar al menos una página web en su archivo de configuración AWB usuario. Esta se encuentra en ~ / .awb / awb.conf Podría ser algo como esto:
----
[Mywebsite]
siteroot: / home / me / mywebsite
baseurl: http: //my.web.site
Opciones AsciiDoc: Libro -d -b html4
----
Esto simplemente define un sitio web conocido en AWB como "mywebsite". Las opciones son:
siteroot ::
El directorio raíz del sitio Web AWB. La fuente AsciiDoc vive en + siteroot / src +, y la salida html va a + siteroot / html +.
baseurl ::
La url de la raíz del sitio web. Esto se utiliza para la generación de sitemap.xml.
Opciones AsciiDoc ::
Opciones que se pasarán al AsciiDoc. Lo utilizo para especificar un archivo html4.conf personalizada además de las opciones que se muestran en el ejemplo.
Una vez que haya configurado una página web y algunos archivos de código fuente escrito, simplemente ejecute el comando
----
% AWB mywebsite
----
AWB sólo se regenerará archivos HTML que se han quedado obsoletas. Si esto no funciona por alguna razón, el -r opción se puede utilizar para arreglarlo.
----
% AWB -r mywebsite
----
Esto se puede hacer desde cualquier lugar del sistema de archivos. AWB sabe de su archivo de configuración donde leer y escribir.
awbdir.conf
-----------
Cada directorio en el árbol de código fuente puede contener un archivo de configuración llamado awbdir.conf. Este archivo especifica opciones específicos de directorio para ser utilizados por AWB.
Sección [setup dir]
Tipo ::
puede ser una de "normal", "blog" o "galería". 'Normal' es el valor predeterminado. El significado de los tipos se explica a continuación.
Nombre ::
Un nombre descriptivo del directorio, como se muestra en la ruta de navegación.
sección awbdir.conf [Blog]
Esta sección define los ajustes utilizados si el tipo de directorio es el blog.
num principales mensajes ::
El número de puestos para mostrar en la página index.html del blog.
num últimos mensajes ::
El número de títulos de entradas a mostrar en la lista "Mensajes recientes", y también el número de títulos de revistas para mostrar en la lista de "revistas recientes".
Sección [usuario]
Aquí puede definir cualquier opción que quiera. Se puede hacer referencia a la plantilla. Esto es útil cuando se desea utilizar la misma plantilla a través del sitio, pero cambia pequeñas partes de él (por ejemplo. Una imagen).
Opciones awbdir.conf cascada desde un directorio para sus hijos. Esto es muy conveniente, ya que los directorios niños sólo necesitan anulan las opciones para los padres que no se aplican. La única excepción es el nombre del directorio, que no hace cascada
¿Qué es nuevo en esta versión:.
- corrige esta actualización un problema expuesto por la liberación de Python recientes que causaron AWB a fallar al determinar la ubicación de su directorio de configuración.
- La reparación introduce un nuevo depenendency, python-xdg.
¿Qué hay de nuevo en la versión 0.3.1:
- La opción -l se añadió a la lista de todos los sitios .
- poste formato Blog se fijó para usar fecha, no mtime.
- Un problema en sitemap marca de tiempo se fijó.
- La cadena uso se ha actualizado.
- meta descripciones vacías no se insertan.
- Crashing se evita al obtener el título de un archivo vacío.
- El manual fue trasladada a un lugar separado.
- Se añadió el comando.
- docstring limpieza estaba hecho.
¿Cuál es nuevo en la versión 0.3:.
- Este comunicado es el producto final de un gran refactorización
- La serie 0.3 será la ruta de acceso a una versión estable 1.0.
Comentarios que no se encuentran