9.7 Mantenimiento de un diario o bitácora (o blog)

El módulo facilita la conservación y publicación de diarios. Cuando se publica en HTML, asume la forma de una bitácora o blog.

El formato de entrada para cada entrada de diario es como sigue.

     * 20040317: Título de la entrada
     
     texto de la entrada.
     
     <qotd>
     "El teatro es poesía que se sale del libro para hacerse humana." --
     Federico García Lorca
     </qotd>

La "qotd", o Cita del día, es completamente optativa. Cuando se genere en HTML, esta entrada se procesa como sigue.

     <div class="entry">
       <div class="entry-qotd">
         <h3>Frase del día:</h3>
         <p>"El teatro es poesía que se sale del libro para
             hacerse humana." -- Federico García Lorca
         </p>
       </div>
       <div class="entry-body">
         <div class="entry-head">
           <div class="entry-date">
             <span class="date">17 de Marzo de 2004</span>
           </div>
           <div class="entry-title">
             <h2>Título de la entrada</h2>
           </div>
         </div>
         <div class="entry-text">
           <p>Texto de la entrada.</p>
         </div>
       </div>
     </div>

La diversidad de etiquetas "div" posibilita mostrar las entradas en la forma que se desee, usando estilos CSS.

También se puede generar un fichero .RDF a partir del diario, mediante su publicación en estilo "rdf". Emplea las dos primeras frases del primer párrafo de cada entrada como su "descripción" y auto-genera las etiquetas para el enlazado a las distintas entradas.

consideraciones respecto a muse-project-alist

Si se desea publicar una canal RDF o RSS, es importante incluir el atributo :base-url en la entrada muse-project-alist para los proyectos personales de Bitácora. Sigue un ejemplo.

     (setq muse-project-alist
           '(("Diario" ("~/Diario/"
                         :default "diario")
             (:base "journal-rss"
                    :base-url "http://ejemplo.org/diario/"
                    :path "~/public_html/diario"))))

Estilos proporcionados para bitácoras

journal-html

Publica las entradas de diario como documento HTML.

journal-xhtml

Publica las entradas de diario como documento XHTML.

journal-latex

Publica las entradas de diario como documento LaTeX.

journal-pdf

Publica las entradas de diario como documento PDF.

journal-book-latex

Publica las entradas de diario como libro LaTeX.

journal-book-pdf

Publica las entradas de diario como libro PDF.

journal-rdf

Publica las entradas de diario como fichero RDF (RSS 1.0).

journal-rss

Publica las entradas de diario como fichero RSS (RSS 2.0).

journal-rss-entry

Usado internamente por journal-rss y journal-rdf para la publicación de entradas individuales.

Opciones proporcionadas para bitácoras

muse-journal-heading-regexp

Expresión regular que concuerde con la cabecera del diario.

El grupo 1 es la fecha ISO; el grupo 2 es la categoría optativa y el grupo 3 es la cabecera optativa para la entrada.

muse-journal-date-format

Formato de fecha para las entradas del diario.

muse-journal-html-heading-regexp

Expresión regular que concuerde con una cabecera de diario de un documento HTML.

El grupo 1 es la fecha ISO; el grupo 2 es la categoría optativa y el grupo 3 es la cabecera optativa para la entrada.

muse-journal-html-entry-template

Plantilla para la publicación de entradas individuales de diario en HTML.

Puede ser texto o un nombre de fichero.

muse-journal-latex-section

Plantilla para la publicación de una sección LaTeX.

muse-journal-latex-subsection

Plantilla para la publicación de una sub-sección LaTeX.

muse-journal-markup-tags

Lista de especificaciones de etiquetas, para el marcado especial de LaTeX.

See muse-publish-markup-tags, para más información.

Esto lo usan journal-latex y sus estilos relacionados, así como el estilo journal-rss-entry, empleado por journal-rdf y journal-rss.

muse-journal-rdf-extension

Extensión predeterminada de fichero para la publicación de ficheros RDF (RSS 1.0).

muse-journal-rdf-base-url

El URL base del sitio web referenciado por el fichero RDF.

muse-journal-rdf-header

Cabecera para la publicación de ficheros RDF (RSS 1.0).

Puede ser texto o un nombre de fichero.

muse-journal-rdf-footer

Pie para la publicación de ficheros RDF (RSS 1.0).

Puede ser texto o el nombre de un fichero.

muse-journal-rdf-date-format

Formato de fecha para las entradas RDF.

muse-journal-rdf-entry-template

Plantilla para publicar entradas individuales de diario como RDF.

Puede ser texto o un nombre de fichero.

muse-journal-rdf-summarize-entries

Si es no-nil, incluye sólo los sumarios en el fichero RDF, no los datos completos.

Lo predeterminado es nil, porque esto molesta a algunos suscriptores.

muse-journal-rss-heading-regexp

Expresión regular que concuerde con una cabecera de diario a partir de un documento HTML.

El grupo 1 es la fecha ISO, el 2 es la categoría optativa y el 3 es cabecera optativa para la entrada.

muse-journal-rss-extension

Extensión de fichero predeterminada para la publicación de ficheros RSS 2.0.

muse-journal-rss-base-url

El URL base del sitio web referenciado por el fichero RSS.

muse-journal-rss-header

Cabecera para la publicación de ficheros RSS 2.0.

Puede ser texto o un nombre de fichero.

muse-journal-rss-footer

Pie para la publicación de ficheros RSS 2.0.

Puede ser texto o un nombre de fichero.

muse-journal-rss-date-format

Formato de fecha para las entradas RSS 2.0.

muse-journal-rss-entry-template

Plantilla para publicar entradas individuales de diario como RSS 2.0.

Puede ser texto o un nombre de fichero.

muse-journal-rss-enclosure-types-alist

Tipos de ficheros que se aceptan como envoltorios RSS.

Se trata de una a-lista que mapea extensiones de ficheros a tipos de contenidos.

Útil para podcasting.

muse-journal-rss-summarize-entries

Si es no-nil, sólo incluye los sumarios en el fichero RSS, no los datos completos.

Lo predeterminado es nil, porque esto molesta a algunos suscriptores.

muse-journal-rss-markup-regexps

Lista de reglas de marcado para la publicación de páginas de diario Muse en RSS.

Para más información acerca de la estructura de esta lista, See muse-publish-markup-regexps.

muse-journal-rss-markup-functions

Una a-lista de tipos de estilo para personalizar funciones para ese tipo de texto.

Para más acerca de la estructura de esta lista, See muse-publish-markup-functions.