Guia Livros e Anotações

Anotações, resumos e citações de livros com método de leitura ativa.

Descricao

Site estatico em Zola (pt-BR) com conteudo sobre Anotações, resumos e citações de livros com método de leitura ativa. Estrutura reorganizada no padrão de 4 seções taxonômicas (Enciclopédia / Tutoriais / Exemplos / Recursos), com shortcodes customizados para citação acadêmica ({{ cite(id="...") }} + {{ bib() }}).

URL Publica

https://pages.singularjourney.org/devjonatas/guia-livros-anotacoes/

A URL é no formato path-style canônico desta stack (ver sites/README.md): pages.singularjourney.org/<usuario>/<repo>/.

Como Usar

Pré-requisito: Zola v0.22+

Instalação do Zola (Linux/macOS):

curl -L https://github.com/getzola/zola/releases/download/v0.22.1/zola-v0.22.1-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv zola /usr/local/bin/

Comandos principais:

zola serve    # Servidor dev em http://127.0.0.1:1111
zola build    # Build do site estatico em public/
zola check    # Verificar links e estrutura

Arquivo de configuração: zola.toml (Zola só lê um — não há config.toml). O backup legado config.toml.bak está preservado apenas para referência histórica.

Estrutura de Conteúdo

O site é organizado em 4 seções taxonômicas:

content/
├── enciclopedia/
│   ├── _index.md            # Índice da enciclopédia
│   └── conceitos/           # Conceitos fundamentais (Atomic Notes)
│       ├── _index.md
│       ├── leitura-ativa.md
│       ├── metodo-cornell.md
│       └── ...
├── tutoriais/
│   ├── _index.md            # Índice dos tutoriais
│   ├── iniciante/           # Tutoriais nível iniciante
│   │   ├── _index.md
│   │   ├── por-que-ler.md
│   │   └── ...
│   ├── intermediario/       # Tutoriais nível intermediário
│   │   ├── _index.md
│   │   └── ...
│   └── avancado/            # Tutoriais nível avançado
│       ├── _index.md
│       └── ...
├── exemplos/
│   ├── _index.md            # Índice de exemplos
│   └── projetos/
│       ├── _index.md
│       └── workflow-completo.md
└── recursos/
    ├── _index.md            # Índice de recursos
    ├── glossario.md         # Glossário de termos
    ├── referencias-bibliograficas.md  # Lista de referências formatada
    └── shortcodes.md        # Documentação dos shortcodes

Shortcodes customizados (em templates/shortcodes/):

• {{ cite(id="...") }} — citação inline (renderiza como link numerado para data/references.yaml)
• {{ bib() }} — bibliografia completa (renderiza referências formatadas de data/references.yaml)
• {{ figure(...) }} — figura com legenda

Estrutura do Repositório

.
├── zola.toml                # Configuração principal (única lida por Zola)
├── config.toml.bak          # Backup legado (não é lido)
├── content/
│   └── (4 seções: enciclopedia/, tutoriais/, exemplos/, recursos/)
├── templates/
│   ├── base.html
│   ├── shortcodes/          # cite.html, bib.html, figure.html
│   └── ...
├── themes/
│   └── zola-easydocs-theme/ # Tema clonado (copiado de calibre-koreader/kdenlive)
├── data/
│   └── references.yaml      # 22 citações acadêmicas
├── static/                  # Arquivos estáticos (CSS, JS, imagens)
├── public/                  # Saída do build (gerado por zola build, gitignored)
└── docs/
    └── deploy.md            # Instruções de deploy

Licença

Consulte o arquivo LICENSE na raiz do projeto para mais detalhes sobre os termos de uso, redistribuição e direitos autorais aplicaveis a este projeto.

Contribuindo

Contribuições são bem-vindas. Acesse o repositorio no Forgejo:

https://forgejo.singularjourney.org/devjonatas/guia-livros-anotacoes/

Abra issues para reportar problemas ou sugerir melhorias, e pull requests para propor mudanças diretamente.