Os arquivos de origem estão em /src
e o site é criado para /_site
.
Para configurar, a partir do diretório raiz: npm run build
para testar: npm run start
O JavaScript é 100% opcional. O CSS também é opcional, mas sem ele tudo será feio.
A navegação e a estrutura da URL correspondem a mais de perto como é razoável.
Os URLs de "página estática" são "bonitos" e terminam com /
.
Os arquivos de origem "conteúdo datado" (por exemplo, postagens e notas) são nomeados {iso-date}-{slug}.html
. A organização em pastas como anos é arbitrária e apenas para gerenciamento de facilidade. Seus URLs são renderizados no estilo da velha escola como /YYYY/MM/DD/slug.html
porque muitos deles são URLs antigos e legais não mudam.
Se o fizerem, um redirecionamento 301 é implementado no URL antigo.
As citações são renderizadas por Markdown-It-Attribution, que renderiza HTML como elementos <figure>
, à ala.
/weeks
contém entradas de diário que serão incluídas nos URLs semanais de arquivo.
/writing
contém postagens que incluem um título e data de publicação. Eles são publicados para URLs datados. Muitas vezes, eles são pesos (manualmente).
/notes
contém notas curtas que são identificadas principalmente por tempo de publicação. Eles são publicados para URLs datados. Eles geralmente são tweets, mas não há limites formais para o conteúdo deles. Eles geralmente são publicados via SiteWriter. Eles são poss para micro.blog e Twitter (através de um feed RSS).
/media
contém anexos ao conteúdo datado (postagens e notas), geralmente enviado via site sitewriter.
Quase todo o resto é uma página destinada a ser permanente e em forma em algum tipo de hierarquia de tópicos.
Inspirado em https://jkc.codes/blog/creating-drafts-in-eleventy/ Os arquivos de dados dinâmicos em/escrita e/notas causam um draft
valor para excluir páginas de coleções