Blip usa uma estrutura de diretório específica para modelos e organização de sites. Veja o diretório example-site/
para uma demonstração ou continue lendo para obter uma descrição completa.
Os modelos são guias de layout para as páginas de índice e postagens do seu site. Os itens a seguir estão localizados em config/templates/
:
index_template.html
: as principais páginas de índice do seu site.
index_post_template.html
: o layout da visualização da postagem nas páginas de índice.
post_template.html
: o layout da página de postagem individual.
O Blip usa alguns “tokens” personalizados para tarefas comuns e substituições de texto. Use Config.swift
para personalizar as strings de substituição.
Markdown (Postagens):
[[MORE]]
: quebra a postagem neste ponto nas páginas index*.html
e insere um link Read More
para a postagem completa.Modelos:
$(COPYRIGHT)
: Insere uma string de direitos autorais personalizada em um modelo de índice.
$(POSTS)
: Insere uma lista de trechos de postagem em um modelo de índice.
$(POSTS_OLDER)
: Insere um link "Postagens mais antigas" em um modelo de índice.
$(POSTS_NEWER)
: Insere um link "Postagens mais recentes" em um modelo de índice.
$(POST_TITLE)
: Insere o título do post em um post ou modelo de índice.
$(POST_TIMESTAMP)
: Insere o carimbo de data/hora da postagem em uma postagem ou modelo de índice.
$(POST_BODY)
: Insere o corpo da postagem em uma postagem ou modelo de índice (o modelo de índice exibirá até qualquer token [[MORE]]
).
$(POST_PERMALINK)
: Insere um link permanente de postagem em uma postagem ou modelo de índice.
As postagens devem estar no formato Markdown e seguir uma convenção de nomenclatura YYYYMMDD.md
(a extensão de arquivo .markdown
também é suportada).
O diretório posts/
deve conter pelo menos dois subdiretórios:
drafts
: é aqui que você deve colocar seus arquivos Markdown (.md) para publicação.
published
: Blip irá gerar HTML index*.html
e postar páginas neste diretório. Você deve usar o conteúdo deste diretório para o seu site.
As postagens publicadas são organizadas de acordo com a data no nome do arquivo. Por exemplo, uma postagem com nome de arquivo 20171220.md
será publicada no seguinte caminho: posts/published/2017/12/20.md
. Atualmente, o Blip suporta apenas um post por dia, principalmente porque eu não blog com muita frequência...
published/stylesheets/
: os modelos padrão usam o index.css
incluído como folha de estilo. Você pode inserir outros arquivos CSS aqui e fazer referência em seus modelos, se necessário,
published/images/
: coloque suas imagens aqui e você poderá referenciá-las no Markdown da seguinte maneira: ![image](/images/someimage.jpg)
Escreva sua postagem no Markdown, com a convenção de nome de arquivo correta ( YYYYMMDD.md
) e coloque-a no diretório drafts/
.
Em seguida, execute o seguinte comando:
./blip /path/to/your/blog/ -r
-r
Reconstrói o site inteiro, publicando todos os arquivos Markdown no diretório drafts/
.
-w
Observa seu diretório drafts/
em busca de novos arquivos Markdown e os publica automaticamente.
-i
Apenas reconstrua as páginas index*.html
do site.
-h
Exibe ajuda.
Um observador de sistema de arquivos simples e fácil de usar / estender usando Swift.
Renderização de Markdown extremamente rápida em Swift, baseada em cmark.
Visite meu site pessoal para ver um exemplo de Blip em uso.