Esta es la crónica de comandos que se puede ejecutar en el proveedor de alojamiento gratuito de OnWorks utilizando una de nuestras múltiples estaciones de trabajo en línea gratuitas, como Ubuntu Online, Fedora Online, emulador en línea de Windows o emulador en línea de MAC OS.
PROGRAMA:
NOMBRE
crónica: un simple compilador de blogs.
SINOPSIS
crónica [opciones]
Opciones de ruta:
--comments Especifica la ruta al directorio de comentarios opcional.
--config Especifica un archivo de configuración para leer.
--input Especifica el directorio de entrada que se utilizará.
--output Especifica el directorio en el que escribir la salida.
--theme-dir Especifica la ruta a las plantillas de temas.
--theme Especifica el tema que se utilizará.
--pattern Especifica el patrón de archivos con los que trabajar.
--url-prefix Especifica el prefijo del blog en vivo.
--sitemap-prefix Especifica el prefijo para el mapa del sitio.
Opciones de entrada de blog:
--format Especifique el formato de sus entradas, HTML / textil / markdown.
Comandos previos y posteriores a la construcción:
--pre-build Especifica un comando para ejecutar antes de construir el blog.
--post-build Especifica un comando para ejecutar una vez que se ha creado el blog.
--pre-filter Un comando para filtrar cada entrada de blog antes de la conversión HTML.
--post-filter Un comando para filtrar cada entrada de blog después de la conversión HTML.
Opciones de clasificación:
--reciente-fechas-primero Muestra las entradas recientes primero en la vista de archivo.
--recent-tags-first Muestra las entradas recientes primero en la vista de etiquetas.
Opciones de conteo:
--entry-count = N Número de publicaciones para mostrar en el índice.
--rss-count = N Número de publicaciones para incluir en la fuente de índice RSS.
Características opcionales:
--autor Especifique la dirección de correo electrónico del autor.
--comment-days Especifica la antigüedad máxima de publicaciones para aceptar comentarios.
--date-archive-path Incluye la fecha en el archivo.
--force Fuerza la copia de archivos estáticos del tema del blog.
--lang Especifica el idioma que se utilizará para dar formato a las fechas.
--lower-case En minúsculas todos los nombres de archivo que se generan.
--no-archive No crea una página de archivo.
--no-cache No utilice las funciones opcionales de memcached, incluso si están disponibles.
--no-calendar No utilice el calendario opcional en el índice.
--no-comments No permite que se publiquen comentarios.
--no-sitemap No genera un mapa del sitio.
--no-tags No produce páginas de etiquetas.
--no-xrefs No produce referencias cruzadas.
Opciones de ayuda:
--help Muestra la información de ayuda para este script.
--manual Lea el manual de este script.
--verbose Muestra información útil de depuración.
--version Muestra el número de versión y sale.
SOBRE NOSOTROS
Chronicle es una herramienta sencilla para convertir una colección de archivos de texto,
ubicado dentro de un solo directorio, en un blog que consta de estática
Archivos HTML.
Admite solo las características mínimas que se requieren
ser útil:
* Soporte de etiquetado.
* Soporte RSS.
* Soporte de archivo.
Las deficiencias obvias son:
* Falta de soporte para comentarios instantáneos.
* Falta de soporte pingback / trackback.
Dicho esto, es un sistema robusto, estable y útil.
BLOG FORMATO
El formato de los archivos de texto que procesamos es fundamental para la salida
páginas. Cada entrada debería verse así:
Título: este es el título de la publicación del blog.
Fecha: 2 de marzo de 2007
Etiquetas: uno, dos, tres, etiqueta larga
El texto de su entrada va aquí.
NOTA: El encabezado DEBE estar separado del cuerpo de la entrada por al menos un
una sola línea vacía.
En este ejemplo podemos ver que la entrada en sí ha sido precedida
con un pequeño encabezado. Un encabezado de entrada contiene tres líneas opcionales,
si estos no están presentes, entonces hay valores predeterminados sensibles como se describe
abajo.
El formato de las fechas de salida se puede cambiar mediante el uso de la
B <--lang> opción de línea de comando (o la opción correspondiente "lang = french" en el
archivo de configuración), pero la fecha de la entrada en sí debe especificarse en
Inglés.
Título: describe el título de la publicación. Si no está presente, se utiliza el nombre de archivo de la entrada.
en lugar de. También se puede utilizar "Asunto:".
Asunto: es un sinónimo de 'Título:'.
Fecha: la fecha en que se escribió la publicación. Si no está presente, se utiliza la hora de creación del archivo.
.
Publicar: este encabezado se elimina de todas las entradas y lo usa el administrador de trabajos de cola de crónicas.
guión.
Etiquetas: cualquier etiqueta que deba asociarse con la entrada, separada por comas.
Se supone que el formato de la entrada es HTML, sin embargo, hay soporte
para escribir sus entradas en formatos textiles y de rebajas.
El formato de las entradas se especifica mediante el argumento B <--format>, o
a través de una configuración de "formato: foo" en su archivo chronlerc.
Se supone que el formato de las entradas es global; esas son todas tus entradas
se supondrá que tiene el mismo formato. Sin embargo, puede agregar un
"formato: foo" pseudo encabezado a entradas específicas si desea escribir
entradas específicas en un formato diferente.
Para permitir flexibilidad en el manejo de las entradas, cada entrada del blog
pasar a través del script de filtro B
lo que le permite modificar este manejo en una única ubicación. Esta
El script permite que las entradas se actualicen a través de filtros antes y después.
la conversión a HTML. Para obtener más detalles, consulte la página de manual de
ese guión.
CONFIGURACIÓN
La configuración del software es mínima y generalmente se realiza
a través de los argumentos de la línea de comandos. Sin embargo, es posible guardar la configuración
ya sea en el archivo global / etc / chronlerc o por usuario ~ / .chroniclerc
.
Si lo desea, puede pasar el nombre de otro archivo de configuración a
el script con el indicador B <--config>. Esto se leerá después de la
dos archivos anteriores, y puede anular cualquier configuración que esté presente.
El archivo de configuración contiene líneas como estas:
input = / home / me / blog
salida = / var / www / blog
formato = rebaja
Las claves desconocidas se ignoran.
OPCIONAL ALMACENAMIENTO EN CACHE
Para acelerar la reconstrucción de un blog grande, el compilador puede usar un local
Demonio Memcached, si está instalado y disponible.
Para instalar esto, en un sistema Debian GNU / Linux, ejecute:
apt-get update
apt-get instalar memcached libcache-memcached-perl
Puede deshabilitar este comportamiento de almacenamiento en caché con --no-cache y ver la
efecto con --verbose.
OPCIONAL CALENDARIO
Si el módulo 'HTML :: CalendarMonthSimple' está disponible, cada blog
contienen una vista mensual simple del mes actual en el índice.
Para deshabilitar esto, invoque el programa con '--no-calendar'.
OPCIONAL COMENTAR
Incluido con el código de la crónica, debe encontrar el archivo
cgi-bin / comments.cgi.
Este archivo está diseñado para escribir comentarios enviados al local
sistema de archivos de su servidor web. Si lo instala y edita el
ruta al comienzo del script, debería poder incluir
comentarios en tu blog.
En resumen, hay tres cosas que debe hacer:
Instale el script CGI y edite la ruta al principio.
Copie los comentarios de salida en la fuente de su blog local.
Ejecute este script nuevamente con --comments =. / Path / to / comments
Esto debería incluir los comentarios en la salida estática. Más
se proporcionan instrucciones explícitas dentro del archivo 'COMENTARIOS'
incluido dentro de la distribución.
Utilice la crónica en línea utilizando los servicios de onworks.net
