terminal hugo theme

terminal-hugo-tema

Um tema para Hugo feito usando a biblioteca CSS tailwind e a família de fontes mono

Demonstração ao vivo

https://nayanseth.com

Configurar

1. Este tema usa CSS tailwind
2. [Opcional] Como usar o Tailwind
   1. Por padrão, o arquivo tailwind.css existente será usado no tema, mas se você quiser brincar com o tailwind, siga as etapas mencionadas abaixo
   2. Existem dois arquivos de configuração para tailwind localizados no diretório assets/csss/tailwind
      1. Para dev run npm run dev -> Isso gera todas as classes CSS possíveis do tailwind. Alguns ainda podem ficar de fora
      2. Para prod run npm run prod -> Isso gera apenas as classes CSS do tailwind que você está usando no tema
3. hugo new site <SITE_NAME>
4. cd <SITE_NAME>
5. git submodule add [email protected]:techbarrack/terminal-hugo-theme.git themes/terminal
6. Substitua o conteúdo de <SITE_NAME>/hugo.yaml por <SITE_NAME>/themes/terminal/hugo.yaml
7. No diretório raiz do site hugo, crie o diretório: mkdir -p layouts/partials/third_party_js . Este diretório serve para armazenar qualquer tipo de javascript de terceiros, como google analytics, disqus, etc.
8. Execute o site hugo server --buildDrafts --disableFastRender --gc --ignoreCache --noHTTPCache --forceSyncStatic --verbose -w

Modificando o conteúdo

1. Remova o comentário do atributo ignoreFiles em <SITE_NAME>/hugo.yaml
2. Comece a adicionar os arquivos em <SITE_NAME>/content replicando o que está presente em <SITE_NAME>/themes/terminal/content
3. Atualize o metaconteúdo em head.html

JS de terceiros

1. Crie parciais em <SITE_NAME>/layouts/partials/third_party_js/<FILE>.html
2. Todos os arquivos na pasta third_party_js serão incluídos antes da tag </body>

Códigos de acesso

• {{< svg logo="blah" >}} -> Use o código a seguir para adicionar svg em arquivos markdown
  1. Adicione svg como arquivo .html em layouts/content/svg
• HTML bruto

 {{< rawhtml >}}
  <div>This is raw HTML content</div>
{{< /rawhtml >}}

Referências

Alguns links de referência para informações adicionais sobre como fazer as coisas no Hugo:

• https://gohugo.io/methods/page/
• https://gohugo.io/methods/pages/groupbydate/
• https://gohugo.io/content-management/taxonomias/
• https://gohugo.io/templates/taxonomy-templates/
• https://gohugo.io/templates/taxonomy-templates/#example-list-tags-in-a-single-page-template
• https://gohugo.io/templates/taxonomy-templates/#example-list-tags-in-a-single-page-template
• https://gohugo.io/methods/page/scratch/
• https://gohugo.io/functions/collections/dictionary/
• https://gohugo.io/methods/page/paginate/
• https://discourse.gohugo.io/t/better-term-listing/10261
• https://gohugo.io/templates/partials/
• https://mertbakir.gitlab.io/hugo/pass-arguments-in-partials-hugo/
• Ícones SVG