como mandar um texto

Contribuir com um texto

Qualquer pessoa pode preparar um texto para o Pedra Angular: uma edição de domínio público, uma transcrição, uma tradução própria. O que o acervo pede é um formato só, igual para todas as obras, para que cada uma seja legível por gente e por máquina daqui a cem anos.

Esta página é a norma do formato, inteira para quem escreve. A régua que a máquina executa é o esquema frontmatter.schema.json, mais as regras do texto, logo abaixo, em Texto.

Confira o seu arquivo aqui

Arraste o .md para a caixa abaixo, escolha o arquivo, ou cole o texto. O conferidor usa exatamente a mesma regra do portão que guarda o acervo: o que sair daqui com ✓ entra sem ser barrado. O arquivo é lido no seu próprio aparelho e não é enviado a lugar nenhum.

O conferidor precisa de JavaScript. Sem ele, confira o arquivo pela tabela e pela lista abaixo.

O arquivo

Um .md em UTF-8 com duas partes: o front matter (os dados da obra, entre duas linhas ---) e o texto.

Front matter

Campos e valores em inglês. Exemplo:

---
id: platao-sophist-grc-john-burnet-1905
type: primary_text
title: Σοφιστής
author: Plato
language: grc
base_edition: "Burnet, Oxford: Clarendon Press, 1905"
publication_year: 1905
tags: [platonism, dialogue]
status: draft
project: pedra_angular
urn_work: urn:cts:greekLit:tlg0059.tlg007
urn: urn:cts:greekLit:tlg0059.tlg007.perseus-grc2
license: CC-BY-SA-4.0
source: "Plato. Sophist. Ed. John Burnet. Oxford: Clarendon Press, 1905. Perseus Digital Library."
---

Três regras que valem para todo campo:

• Campo desconhecido fica de fora. Apague a linha. Nunca escreva null, nunca deixe "".
• Só o que está na fonte. Não invente nem deduza data, editor ou tradutor.
• Nada de campo novo. Um campo que não está na tabela barra o arquivo.

Texto

Só esta sintaxe, e nada além:

• #, ##, ###… para títulos, sem limite de profundidade;
• parágrafo: linhas de texto, separadas por uma linha em branco;
• marcador canônico entre colchetes, um por ponto: [216a], [1094a1], [1.1] — nunca [216] [216a] no mesmo lugar. O marcador é copiado da edição como ela o escreve, sem reformatar: é um endereço;
• âncora no fim da linha: texto ^gn-1-1;
• etiqueta de idioma no fim da linha, quando a detecção não basta: ^por, ^grc, ^eng, ^lat, ^heb, ^rus;
• nota: [^1] no texto e [^1]: texto da nota no fim do arquivo. Nota do editor ou do tradutor nunca fica colada no texto corrido;
• verso ou poema: dentro de um bloco `verso … ` , onde cada linha fica uma linha;
• interlinear: dentro de `interlinear … ` ;
• imagem: {{img:id}} sozinha na linha, ou ![descrição](…). Toda imagem tem descrição, para quem não a vê;
• citação, assinatura ou linha de interlinear: > no começo da linha (aparece com um risco vertical ao lado). Linhas seguidas dentro do mesmo > se juntam num parágrafo; para verso, use o bloco `verso ;
• contrabarra antes de um sinal, para ele aparecer como sinal e não fazer o que faria (o escape do CommonMark): \[582] é uma data, não um marcador; \* é um asterisco, não itálico; \< é um sinal de menor, não uma etiqueta;
• ligação a um personagem ou a outra obra: [[Nome]] (wikilink);
• marca de página, quando o texto vem de um livro digitalizado: <!-- pa:pagina 28 --> no ponto exato em que a página vira — sozinha na linha, entre duas palavras, ou colada no meio da palavra que a página cortou (pala<!-- pa:pagina 28 -->vra). O número é o da página do PDF, contando da capa: a capa é a 1. Não é o número impresso no alto da folha.

Não entra no texto: tabela, ==realce==, qualquer outra tag ou comentário HTML/XML, e a palavra null.

O formato é um só para todo o Pedra Angular. Se alguma parte do ecossistema ainda não desenha uma sintaxe da lista, ela a mostra como texto, sem quebrar: use a lista inteira sem receio.

Licença

Só entra texto que pode circular livremente: domínio público ou licença aberta (Creative Commons). Tradução ou transcrição sua entra com a licença que você escolher entre as da lista, e com o seu nome como tradutor. Se o texto foi cedido por outra pessoa, guarde a cessão por escrito.

Se você está pedindo a uma IA para preparar o texto

Mande o endereço desta página junto com o pedido: https://pedraangular.app.br/portico/contribuir.md. É o que impede cada conversa de inventar um formato próprio — foi assim que o acervo chegou a ter três.