Blip utiliza una estructura de directorio específica para plantillas y organización del sitio. Consulte el directorio example-site/
para ver una demostración o siga leyendo para obtener una descripción completa.
Las plantillas son guías de diseño para el índice de sus sitios y las páginas de publicaciones. Lo siguiente se encuentra en config/templates/
:
index_template.html
: las páginas de índice principales de su sitio.
index_post_template.html
: el diseño de la vista previa de la publicación en las páginas de índice.
post_template.html
: el diseño de la página de publicación individual.
Blip utiliza algunos "tokens" personalizados para tareas comunes y reemplazos de texto. Utilice Config.swift
para personalizar las cadenas de reemplazo.
Rebajas (Publicaciones):
[[MORE]]
: divide la publicación en este punto en las páginas index*.html
e inserta un enlace Read More
a la publicación completa.Plantillas:
$(COPYRIGHT)
: inserta una cadena de copyright personalizada en una plantilla de índice.
$(POSTS)
: inserta una lista de fragmentos de publicaciones en una plantilla de índice.
$(POSTS_OLDER)
: inserta un enlace de "Publicaciones anteriores" en una plantilla de índice.
$(POSTS_NEWER)
: inserta un enlace "Publicaciones más recientes" en una plantilla de índice.
$(POST_TITLE)
: Inserta el título de la publicación en una plantilla de publicación o índice.
$(POST_TIMESTAMP)
: inserta la marca de tiempo de la publicación en una plantilla de publicación o índice.
$(POST_BODY)
: inserta el cuerpo de la publicación en una publicación o plantilla de índice (la plantilla de índice mostrará hasta cualquier token [[MORE]]
].
$(POST_PERMALINK)
: inserta un enlace permanente de publicación en una plantilla de publicación o índice.
Las publicaciones deben estar en formato Markdown y deben seguir la convención de nomenclatura YYYYMMDD.md
(también se admite la extensión de archivo .markdown
).
El directorio posts/
debe contener al menos dos subdirectorios:
drafts
: aquí es donde debe colocar sus archivos Markdown (.md) para publicarlos.
published
: Blip generará index*.html
y publicará páginas en este directorio. Debe utilizar el contenido de este directorio para su sitio web.
Las publicaciones publicadas están organizadas según la fecha de su nombre de archivo. Entonces, por ejemplo, una publicación con el nombre de archivo 20171220.md
se publicará en la siguiente ruta: posts/published/2017/12/20.md
. Actualmente, Blip solo admite una publicación por día, principalmente porque no escribo blogs con mucha frecuencia...
published/stylesheets/
: Las plantillas predeterminadas utilizan el index.css
incluido como hoja de estilo. Puede colocar otros archivos CSS aquí y hacer referencia a sus plantillas, si es necesario.
published/images/
: Coloque sus imágenes aquí y podrá hacer referencia a ellas en Markdown de la siguiente manera: 
Escriba su publicación en Markdown, con la convención de nombre de archivo correcta ( YYYYMMDD.md
), luego colóquela en el directorio drafts/
.
Luego ejecute el siguiente comando:
./blip /path/to/your/blog/ -r
-r
Reconstruye todo el sitio publicando todos los archivos Markdown en el directorio drafts/
.
-w
Observa su directorio drafts/
en busca de nuevos archivos Markdown y los publica automáticamente.
-i
Solo reconstruye las páginas index*.html
del sitio.
-h
Muestra ayuda.
Un observador del sistema de archivos sencillo y fácil de usar/ampliar utilizando Swift.
Representación de Markdown ultrarrápida en Swift, basada en cmak.
Visite mi sitio personal para ver un ejemplo de Blip en uso.