ZeideI survived only to tell
Browse the Archives

16 · Os Arquivos — definição e implementação (v4)

16 · Os Arquivos — definição e implementação (v4)

This notebook is in Portuguese, as written during the research. Translation follows in stages, after the first published version.

File
site/docs/16-arquivos.md
Updated
2026-09-02
Terms of use
Written by the family with AI assistance, August–September 2026. The site's source of truth.

Proposta discutida e decidida em 02/09/2026 (decisão 40 em 03-decisoes-abertas.md). A ideia é do Flavio: renomear "Arquivo" → "Arquivos", publicar os .md da pesquisa na íntegra e trocar a grade de cards por um navegador à esquerda + um visualizador à direita (markdown bem renderizado, fotos e PDFs abertos no lugar). Este documento registra o que foi decidido e como foi construído. Implementação: build/arquivos.mjs · build/data/arquivos.mjs · build/lib/md.mjs · build/gera-arquivos.mjs · src/css/arquivos.css · src/js/arquivos.js.


1 · O que a seção é#

A "vitrine" das 20 peças do catálogo (só as que têm imagem) é a home de /arquivos/; à esquerda, um único inventário com três lentes; à direita, o visualizador de cada item:

GrupoO que entraPágina
Vitrine: as peçasD01D20 do catálogo (data/secoes.mjs), cada uma com todos os arquivos ligados a ela no visor, a descrição PT/EN, a fonte, a voz dele, "os arquivos desta peça", "aparece em" e o link para a ficha completa no catálogo/arquivos/pecas/d02/
Fotografiasas fotos da família (extraídas da apresentação do bisneto) + a foto do Yad Vashem + o still da USC, por data/arquivos/fotos/<id>/
Documentosos scans e PDFs de pesquisa/docs/ e os papéis da família, por data; PDFs pré-renderizados página a página; a apresentação escolar do bisneto (13 de 14 slides)/arquivos/documentos/<id>/
Cadernos da pesquisaos .md na íntegra, em cinco subgrupos: Comece por aqui (leia-me, catálogo, achados, próximos passos, pendências, pedidos prontos) · Cronologia · Fontes e proveniência · O mundo em volta (contexto 00–17) · Bastidores do site (briefing + site/docs/00–16)/arquivos/cadernos/<id>/
A entrevistao vídeo, as duas transcrições (links para /entrevista/), "como ler" e o índice temático
A voz deleos 12 clipes curados (A01–A12) com o verbatim e o minuto/arquivos/voz/a01/

Fora do site (decisão 40b e direitos): o roteiro das entrevistas com as filhas, o slide 14 (a árvore com os vivos), o HTML do Yizkor (© JewishGen — só o link), os JSONs da passada dirigida, o WMV.

2 · O navegador (esquerda)#

  • Três lentes sobre o mesmo inventário — por tipo (padrão, renderizada no build; funciona sem JS), por origem (um nó por fundo: acervo da família, AP Kalisz, Arolsen, JDC, Yad Vashem, Museu da Imigração, USC, Majdanek, publicações polonesas, fontes brasileiras, bibliografia, os cadernos) e por tempo (décadas). As duas últimas são remontadas pelo JS a partir dos data-* de cada item; a lente vai na URL (?ver=origem) e em localStorage.
  • <details>/<summary> nativos (acessíveis, sem JS); grupos abertos lembrados; o item corrente destacado e o seu grupo aberto; filtro local por nome; teclado ↑↓←→.
  • Mobile: o navegador vai para baixo do conteúdo; um botão "Navegar nos Arquivos" no topo salta até ele (sem dois painéis espremidos).

3 · O visualizador (direita)#

  • Ficha de proveniência em toda página: tipo · data · origem (com link para o arquivo de origem) · cota · grau (selo do DS) · peça do catálogo · arquivo no repositório (o ID perene) · atualizado em (último commit que tocou o arquivo, lido do git no build) · termos de uso do fundo.
  • Imagens e PDFs: visor com zoom/pan (roda, pinça, duplo-clique, botões, teclado), páginas (frente/verso, zooms, páginas de PDF) com tira de miniaturas; derivadas 320/1200/2400 px geradas no build (gera-arquivos.mjs: ffmpeg + pdftoppm, cache por mtime, em public/media/arq/, fora do git); nenhuma "restauração" (10 §C1). z-cw antes dos documentos de morte.
  • Descrições vêm das tabelas de proveniência (pesquisa/docs/README.md, fontes/fotos/README.md), lidas no build — os READMEs continuam a fonte da verdade.
  • "Aparece em" (backlinks): as seções dos cadernos que citam o arquivo pelo nome ou a peça pelo código; nas peças, também os cartões de Pessoas que a referenciam.
  • Cadernos: renderizados no build por lib/md.mjs (zero deps): títulos com âncora, tabelas largas rolando no próprio container, citações, listas aninhadas, código; [mm:ss] → Entrevista; D##/P##/H##/C## → ficha do catálogo; caminhos de arquivo → item; links relativos entre .md → rotas; emojis de convenção ( …) → ícones do DS; sumário lateral com scroll-spy; CSS de impressão. Conteúdo em português (nota na trilha EN; tradução por etapas, catálogo primeiro).
  • Áudio: <audio> nativo com o verbatim, o minuto e a tela do Memorial.
  • Anterior/próximo dentro do grupo; breadcrumb; a busca global ⌘K ganha o grupo "Nos Arquivos" (itens, peças e cada seção dos cadernos).

4 · Privacidade (decisão 40b) e direitos#

  • Ninguém nascido depois de 1950 na área pública — foco na história do Zeide. Mecanismo: cercas nos .md (<!-- família --> … <!-- /família --> para blocos; <!--f:substituto-->texto<!--/f--> inline), removidas pelo renderizador; nos itens de texto, linhas com nomes viram "[trecho reservado…]"; lista de nomes-sentinela (SENTINELAS em build/arquivos.mjs) verificada em todas as páginas exceto a Entrevista (o verbatim é intocável) — o build falha se vazar. Exceção consciente: Flavio Pripas (contato do site). A regra foi aplicada também à Jornada (eventos "filhos" e "netos").
  • Termos por fundo (FUNDOS[*].termos) na ficha; "ver no arquivo de origem" onde há URL; sem download (decisão 40f). O Yizkor não é reproduzido.

5 · Rotas e build#

/arquivos/ · índices por grupo /arquivos/{pecas,fotos,documentos,cadernos,voz}/ · itens /arquivos/{grupo}/<id>/ · páginas de fundo /arquivos/origem/<fundo>/ (breadcrumbs e selos de origem clicáveis) · EN /en/archives/{pieces,photos,documents,notebooks,voice,origin}/…. Item "Vitrine" fixo no topo do navegador em todas as lentes; visualizador e cadernos ocupam toda a largura do centro; links externos abrem em nova aba (também no resto do site, via comum.js). Todas no sitemap, com hreflang cruzado; a chave urls.arquivo aponta para a nova raiz; os cards de Pessoas ligam às peças. Build: derivadas → cadernos (PT/EN) → backlinks → páginas → índice de busca → verificações (emoji, sentinelas, orçamento de JS por página). Página antiga /arquivo/ removida (site ainda não em produção).

6 · Ajustes de UX (02/09/2026, segunda rodada)#

Item "Vitrine" fixo no topo do navegador · largura total no centro · pan corrigido (arrasto nativo da imagem desativado) · breadcrumbs clicáveis via índices por grupo e páginas por fundo · links externos em nova aba · roda do mouse só zooma quando a imagem já está ampliada (ou com Ctrl/⌘), para não sequestrar a rolagem · no celular a página rola sobre a imagem ajustada (touch-action: pan-y) · descrição antes da ficha · atalho para a página do fundo nas lentes "por origem" · sumário dos cadernos com altura limitada em telas estreitas · transição visual card → visor da peça · rótulo "Nos Arquivos" na busca global. Em Pessoas, o painel ganhou "O nome nos documentos": cada grafia com a fonte e o link (peça, minuto ou ficha do catálogo) — dados em secoes.mjs (nomes).