Manual Editorial do LAC
Documento vivo que define os padrões editoriais do LAC: escrita, estrutura, artefatos, nomenclatura, revisão, versionamento, publicação e integração entre livro, PDF e aplicação web.
Problema resolvido: estabelecer regras mínimas para que os artefatos do LAC sejam coerentes, localizáveis, reutilizáveis e publicáveis.
Ideia-síntese: o manual editorial é a governança da forma publicada do conhecimento.
1. Princípios editoriais
O manual editorial do LAC orienta a produção de páginas, livros, capítulos, PDFs, catálogos, manuais, apresentações, cursos e knowgramas. Seu objetivo é preservar a coerência entre conhecimento, representação e publicação.
Começar pela demanda
Todo artefato deve responder a uma pergunta, problema, situação ou necessidade de aprendizagem.
Organizar o percurso
A estrutura deve mostrar de onde o leitor parte, por onde passa e que compreensão alcança.
Registrar origem
Todo artefato deve indicar origem, versão, estado, páginas relacionadas e vínculos com o LAC web.
Reduzir ruído
O texto deve explicar o essencial sem apagar a profundidade conceitual do LAC.
Produzir componentes
Capítulos, boxes, knowgramas, fichas e checklists devem ser reutilizáveis.
Publicar sem congelar
A edição física registra um marco; a versão web continua sendo o ambiente vivo.
2. Estrutura padrão dos artefatos
Cada artefato editorial deve possuir uma estrutura mínima para facilitar leitura, manutenção e integração.
| Elemento | Função | Uso recomendado |
|---|---|---|
| Título | Nome claro do artefato. | Deve indicar tema, domínio e relação com o LAC. |
| Problema resolvido | Explicita a necessidade que originou o artefato. | Obrigatório em páginas fundamentais, capítulos e manuais. |
| Ideia-síntese | Resume o entendimento principal. | Deve aparecer no início do artefato. |
| Desenvolvimento | Explica o conteúdo em camadas. | Organizar por seções curtas e hierarquia clara. |
| Artefato visual | Knowgrama, infograma, mapa, quadro ou grafo. | Usar quando ajuda a ver relações. |
| Páginas relacionadas | Conecta o artefato ao ecossistema. | Obrigatório nas páginas HTML do LAC. |
| Ficha editorial | Registra versão, estado, origem e autor. | Obrigatória para artefatos estáveis e publicados. |
3. Escrita e linguagem editorial
Tom
Claro, reflexivo, técnico quando necessário, mas sempre orientado à compreensão do leitor.
Sequência
Começar pela pergunta, seguir para a explicação, mostrar relações e terminar com uso ou próximos passos.
Conceitos
Termos centrais devem ser definidos antes de serem usados como base de raciocínio.
Redundância controlada
Repetir ideias estruturantes quando ajudam a orientar o leitor; evitar repetição apenas decorativa.
Regra de escrita
pergunta → contexto → conceito → relação → exemplo → uso → próximo passo
4. Projeto visual editorial
O projeto visual deve ser coerente com a identidade do LAC e com a função de cada artefato. A prioridade é legibilidade, hierarquia e leitura sistêmica.
Tipografia
Usar fonte sem serifa no digital. Em PDF/livro, combinar fonte legível para texto com hierarquia forte para títulos.
Cores
Usar azul como cor institucional, tons neutros para leitura e cores auxiliares apenas para estados ou alertas.
Boxes
Usar caixas para problema resolvido, ideia-síntese, notas, alertas, exemplos e critérios.
Knowgramas
Devem ter título, legenda, contexto de uso e análise textual associada.
Grid
Páginas digitais usam grid responsivo. Livros e PDFs usam margens amplas, hierarquia e espaço para anotações.
Navegação
HTML deve conter sumário, páginas relacionadas e botão voltar ao início.
5. Nomenclatura dos artefatos
A nomenclatura deve ser simples, previsível e compatível com a estrutura de pastas do LAC.
| Tipo | Padrão | Exemplo |
|---|---|---|
| Página editorial | tema_principal_lac.html |
arquitetura_editorial_lac.html |
| Catálogo | catalogo_tipo_lac.html |
catalogo_artefatos_editoriais_lac.html |
| Manual | manual_tema_lac.html |
manual_editorial_lac.html |
| Template | template_tipo_lac.html |
template_capitulo_lac.html |
| Knowgrama | knowgrama_tema_lac.png |
knowgrama_arquitetura_editorial_lac.png |
nome_documento_lac_vX_Y.pdf |
manual_editorial_lac_v0_1.pdf |
6. Fluxo editorial
Identificar pergunta, problema, experiência ou necessidade de publicação.
Produzir a página viva, o knowgrama, a análise e os vínculos conceituais.
Revisar coerência, remover redundâncias, organizar sequência e classificar o artefato.
Aplicar estrutura, nomenclatura, ficha editorial, links e padrões visuais.
Disponibilizar HTML, PDF, livro, catálogo ou outro formato planejado.
Atualizar mapa do site, catálogo, páginas relacionadas e estado editorial.
7. Revisão e critérios de qualidade
Checklist editorial
O artefato tem problema resolvido? Ideia-síntese? Estrutura clara? Páginas relacionadas? Estado editorial?
Checklist conceitual
Está alinhado ao LAC? Usa corretamente jornada, knowgrama, artefato, sistema, conhecimento e arquitetura?
Checklist técnico
Links funcionam? Caminhos relativos estão corretos? Imagens carregam? HTML é responsivo?
Checklist de publicação
Foi incluído no hub, mapa do site, catálogo correspondente e páginas relacionadas?
8. Integração com a arquitetura SPA
A arquitetura SPA é o ambiente natural para análise interativa, navegação por filtros e exploração viva. O manual editorial define quando um conteúdo deve permanecer como SPA, virar capítulo ou gerar PDF.
| Situação | Artefato recomendado | Critério |
|---|---|---|
| Objeto visual com filtros de análise | Página SPA | Precisa de interação e mudança de lente. |
| Conteúdo conceitual estabilizado | Capítulo ou livro | Precisa de leitura sequencial. |
| Resumo para circulação | Precisa ser compartilhado como documento fechado. | |
| Lista de itens reutilizáveis | Catálogo | Precisa de consulta e localização. |
9. Templates mínimos
O subsistema editorial deve possuir templates reutilizáveis. Eles reduzem retrabalho e aumentam coerência.
Template de capítulo
Título, problema resolvido, ideia-síntese, conceitos, desenvolvimento, exemplo, fechamento e referências.
Template de knowgrama
Título, imagem, legenda, lentes de análise, interpretação, relações e usos.
Template de ficha editorial
Nome, tipo, origem, versão, estado, autor, data, páginas relacionadas e próxima revisão.
Template de catálogo
Item, finalidade, quando usar, origem, formato, estado, template e relação com outros artefatos.
Template de estudo de caso
Contexto, problema, jornada, intervenção, artefatos gerados, aprendizagem e evolução.
Template de checklist
Critérios editoriais, conceituais, técnicos, visuais, links, versão e publicação.