ItemValor
NomeSOURCE (BIND SOURCE do documento de especificação)
TAG ID0x0C0L
Codec ID0x00000C00
Documento de especificação0x00000000/codecs/0x00000C00/ (alvo do DECLARE 0C00)
Seção6 0110 (Edge de fundamento), deslocamento C = 0 dentro da seção
KindEdge · família: fundamento
TAG WORD0000 1100 0000 LLLL (000K KKKC CCCC LLLL)
Descrição de índiceLiga um registro ou o documento inteiro à sua origem. Target (Edge Id do BODY; no HEAD, 0 = documento inteiro), Origin (Reference, ABSENT ou UNKNOWN-VALUE). A natureza da origem é um TRIPLE que tem a origem como Subject; a natureza da citação (data de consulta, posição, hash do original) é um QUALIFIER anexado ao SOURCE. O SOURCE do documento inteiro e seu QUALIFIER ficam no HEAD
Lado Hugoedge/source.md

Campos (documento de especificação)

A ordem dos FIELD no documento é a ordem dos campos do Payload (documento de especificação do Codec). O Edge Id de um Edge não é declarado como FIELD.

OrdemCampo (BIND)FIELDLarguraFormato aceito (CODEC)ENUM
1target#2registro0050 LOCAL
2origin#3registro000F seção 0 inteira (curinga, Reference), 020F seção 1 inteira (curinga, Reference), 040F seção 2 inteira (curinga, Reference), 0010 UNKNOWN-VALUE, 0000 ABSENT (campo opcional)

SOURCE é o Edge de fundamento que liga um registro (o alvo) ou o documento inteiro à origem de onde ele veio. Codec 0x0C0L. É o único código direto da família de fundamento (01).

Uma reference do Wikidata (grupo de proveniência) corresponde a um SOURCE. Se um registro tem várias proveniências, há vários SOURCE.

Layout

TAG WORD          0000 1100 0000 LLLL
[TAG estendida de Length]
Edge Id           registro LOCAL Reference
Target            registro LOCAL Reference (no BODY, o Edge Id do Edge ao qual se anexa o fundamento; no HEAD, 0 = documento inteiro)
Origin            registro Reference, ou marcador de posição 0x0000 ABSENT·0x0010 UNKNOWN-VALUE
  • Origin aponta para a origem. Se existe uma Reference adequada à origem, usa-se ela (WIKIDATA-QID, DOC-POINTER e EXTERNAL-ISSUER de um documento GEUL etc.); se não, usa-se um nó LOCAL deste documento.
  • Se a proveniência não descreve a origem (por exemplo, uma proveniência que só tem “imported from” (P143) do Wikidata e a data de consulta), Origin é ABSENT (não escrito). Quem escreve apenas não registrou a origem; não afirma nada sobre ela. O restante da proveniência permanece nos QUALIFIER.
  • UNKNOWN-VALUE só é usado quando quem escreve afirma que “há uma origem, mas não se sabe qual” (por exemplo, registros escritos por pessoas). Um conversor que transcreve de um material de origem não afirma o que a origem não disse, e por isso usa ABSENT.
  • Cada ocorrência de Origin ABSENT ou UNKNOWN-VALUE é independente. Não se lê a origem de dois SOURCE como a mesma.

Duas camadas

A informação sobre proveniência divide-se em duas. Não se misturam.

CamadaO quêComo escreverExemplo
OrigemNatureza da própria origem. É a mesma, quem quer que a citeTRIPLE que tem a origem como Subject (rank normal)URL (P854), título (P1476), autor (P50·P2093), data de publicação (P577), veículo de publicação (P1433), editora (P123), idioma (P407)
CitaçãoNatureza do ato de este registro citar a origemQUALIFIER que tem o Edge Id do SOURCE como Targetdata de consulta (P813), posição dentro da origem (página P304, seção P958, identificador externo P227·P1417), de onde foi importado (P143), método de inferência (P887), hash do original (P4092)
  • O significado de um SOURCE é o conjunto de todos os QUALIFIER que apontam para o seu Edge Id. Duas proveniências que consultaram a mesma origem em dias diferentes têm a mesma origem e QUALIFIER diferentes.
  • Um TRIPLE de origem é uma afirmação sobre a origem. Uma propriedade cuja camada não se pode decidir fica do lado da citação (QUALIFIER). É mais seguro não afirmar nada sobre a origem.
  • Dentro de um documento, a mesma origem é declarada uma só vez como um LOCAL, e vários SOURCE apontam para ele.
  • Uma origem descrita apenas por uma URL é definida com REFERENCE-NODE (LOCAL → URI), do mesmo modo que a página de documento de um sitelink.

Interpretação e validade

  • Target e Origin são, cada um, exatamente um registro completo. O cursor que leu Origin deve coincidir com o fim do Edge.
  • Target é uma Reference LOCAL. O SOURCE do BODY aponta para um Edge Id do BODY do mesmo documento. 0 (documento inteiro) só é usado pelo SOURCE do HEAD (proveniência do documento inteiro). Um SOURCE com Target 0 no BODY é invalid. Para um registro de outro documento, o fundamento é anexado dentro desse documento.
  • Origin é uma Reference. Dos marcadores de posição, aceita apenas 0x0000 (ABSENT) e 0x0010 (UNKNOWN-VALUE). Não aceita NO-VALUE (0x0020) nem Value.
  • O documento de especificação geul.org 0x00000000/codecs/0x00000C00 (nome source) coloca em Target o CODEC LOCAL (0050) e em Origin os CODEC 000F·020F·040F (qualquer Reference), 0000 (ABSENT, opcional) e 0010 (UNKNOWN-VALUE).
  • A ordem entre SOURCE do mesmo Target não tem significado. A ordem dos itens dentro de uma proveniência também não (a ordem dos valores da mesma propriedade permanece como ordem do documento).
  • SOURCE não altera a verdade ou falsidade do alvo. Apenas registra de onde o alvo veio. O resultado do julgamento fica a cargo do VERDICT do TOULMIN.

Proveniência do documento inteiro

A origem do documento inteiro (dump original, edição, arquivo do texto original) é escrita como um SOURCE com Target 0 no HEAD. Os QUALIFIER que têm esse SOURCE como Target (hash do original P4092, hora de recebimento P813, intervalo do original etc.) também ficam no HEAD (documento).

  • Estes dois são os únicos Edge que podem ficar no HEAD. Os demais Edge ficam no BODY.
  • Os QUALIFIER do HEAD vêm depois do SOURCE do HEAD a que apontam. O decodificador lê desde o início e separa HEAD e BODY.
  • Um QUALIFIER que tem um SOURCE do HEAD como Target e fica no BODY é invalid. SOURCE e QUALIFIER do BODY não apontam para Edge do HEAD.
  • HEAD e BODY usam um único espaço de numeração de Edge Id. O Edge Id é único dentro do documento, é recebido de NEXT-LOCAL-ID como nos demais Edge, e, ao refazer o documento, o mesmo conteúdo herda o mesmo número. Mesmo numa versão sem um Edge do HEAD, esse número não é reutilizado.
  • Se Origin é um LOCAL, sua definição (REFERENCE-NODE, TRIPLE de origem) fica no BODY. O escopo de um LOCAL é o documento inteiro.
  • Como os Edge do HEAD não são Meta da classe de verificação, entram no hash de conteúdo. No diff, mudam em bloco junto com o HEAD (não se escrevem em DELTA-REMOVE).
  • Não há Meta específico para a proveniência do documento inteiro. O intervalo do original e o instante de obtenção escritos como Meta não permitem decidir a qual origem se referem quando há várias. O QUALIFIER anexado a um SOURCE decide isso pelo Target.

Exemplo: HEAD de um documento Q42 transcrito de um dump do Wikidata (os Edge Id são só para ilustração).

SPEC-VERSION  0x0001
DOC-ID        0x00000001/0x510000000000002A
TRANSFORMED-BY …
#1738 SOURCE     #0     #1735                                         edição (revision) da entidade
#1741 SOURCE     #0     #1740                                         arquivo de dump
#1742 QUALIFIER  P4092  #1741  SHA-256-DIGEST(0xA249…0774)            hash do arquivo
#1743 QUALIFIER  P813   #1741  POSIX-TIMESTAMP-SECONDS(1792996483)    hora de recebimento
BODY
#1736 TRIPLE     P577   #1735  POSIX-TIMESTAMP-SECONDS(1792210885) normal                      hora de gravação da edição
#1737 TRIPLE     P854   #1735  <https://www.wikidata.org/w/index.php?oldid=2557857485> normal  endereço permanente da edição
#1739 REFERENCE-NODE    #1740  <https://dumps.wikimedia.org/wikidatawiki/entities/20261019/wikidata-20261019-all.json.bz2>
…
  • A edição e o dump são origens diferentes, por isso há dois SOURCE. A edição é a origem do conteúdo (o mesmo conteúdo pode ser obtido de novo pelo endereço permanente), e o dump é o arquivo em que essa edição foi recebida. O hash do arquivo e a hora de recebimento são propriedades do lado da citação sobre o arquivo de dump, por isso se anexam ao SOURCE do dump.

Representação de outros fundamentos

Na família de fundamento só existe o SOURCE. Os outros fundamentos são escritos com QUALIFIER.

FundamentoComo escreverProperty
Intervalo dentro do originalQUALIFIER no SOURCE. Um SOURCE por intervalopágina P304, seção P958, citação P1683. Intervalo de caracteres: termo GEUL (indefinido)
Instante de recebimento do material de origemQUALIFIER no SOURCEdata de consulta P813
Hash dos bytes do original (fixa a edição)QUALIFIER no SOURCEchecksum P4092, valor SHA-256-DIGEST etc.
Agente que produziu (pessoa, modelo, motor de regras)QUALIFIER no SOURCE (o agente que produziu a citação) ou no alvotermo GEUL (indefinido)
Grau de confiançaQUALIFIER no alvotermo GEUL (indefinido), valor de 0 a 1 como o Meta CONFIDENCE
Período de vigência por artigoQUALIFIER no alvoinício P580, fim P582
Registro antigo antes de mover, dividir ou fundirQUALIFIER no alvo, valor é o Edge Id antigo (LOCAL)P1365 (replaces)
Versão em que entrou pela primeira veznão se armazena. Calcula-se a partir do histórico de versões (git blame)

Exemplo (não normativo)

Q42 P19 (local de nascimento) Q350, TRIPLE alvo #178. No dump do Wikidata de 2026-10-19, esta proposição tem cinco proveniências, das quais três são mostradas. ③ o artigo do Telegraph (#1358 a #1367) tem a mesma forma que ②, e ⑤ Store norske leksikon (Q746368) a mesma que ①, por isso foram omitidos.

SOURCE     #1347  #178   Q5375741                     ① Britannica: apenas P248, sem descrição da origem
QUALIFIER  #1348  P1417  #1347  "biography/Douglas-Adams"

TRIPLE     #1350  P50    #1349  Q18145749  normal     ② artigo do Guardian #1349
TRIPLE     #1351  P407   #1349  Q1860      normal
TRIPLE     #1352  P577   #1349  GREGORIAN-DATE(2001-05-15)  normal
TRIPLE     #1353  P854   #1349  <http://www.theguardian.com/news/2001/may/15/guardianobituaries.books>  normal
TRIPLE     #1354  P1433  #1349  Q5614018   normal
TRIPLE     #1355  P1476  #1349  "Obituary: Douglas Adams"@en  normal
SOURCE     #1356  #178   #1349
QUALIFIER  #1357  P813   #1356  GREGORIAN-DATE(2013-12-07)

SOURCE     #1368  #178   #1158                        ④ GND: LOCAL #1158 declarado antes (P248 Q36578, P407 Q188)
QUALIFIER  #1369  P227   #1368  "119033364"
QUALIFIER  #1370  P813   #1368  GREGORIAN-DATE(2022-10-09)
  • ① não tem descrição da origem e P248 é único, então a origem é esse item. #1347 ocupa TAG 1 + Edge Id 2 + Target 2 + Q5375741 3 = 8 WORD, TAG 0C07.
0C07 0051 0543 0051 00B2 0142 0052 06FD
  • Proveniência só com uma URL: REFERENCE-NODE #1383 #1384 <http://www.eskimo.com/~rkj/weekly/aa051701a.htm>, SOURCE #1385 #180 #1384.
  • Proveniência só com “imported from” da Wikipédia em inglês: SOURCE #n #t ABSENT, QUALIFIER P143 #n Q328. Origin 0x0000 ocupa 1 WORD.

Problemas em aberto

  • Termos GEUL para intervalo de caracteres, agente que produziu e grau de confiança (documento de definição de termo e ID).
  • Quando a descrição da origem não identifica a origem (proveniência só com idioma etc.), compartilhar a mesma descrição em um único LOCAL levaria a afirmar que origens diferentes são a mesma.
  • Lista de propriedades de origem e de citação para proveniências fora do Wikidata (leis, citações da web).
  • Proveniência da proveniência (cadeia): se se deve anexar outro SOURCE ao LOCAL da origem.

Páginas relacionadas

Texto original do documento de especificação

É o documento de especificação 0x00000000/codecs/0x00000C00/latest.geul lido com geul show (hexadecimais em maiúsculas).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000C0000000000
BODY
#1 DECLARE 0x0C00
#2 FIELD #1 record
#3 FIELD #1 record
#4 BIND #1 "SOURCE"
#5 BIND #2 "target"
#6 BIND #3 "origin"
#7 CODEC #2 0x0050
#8 CODEC #3 0x000F
#11 CODEC #3 0x020F
#12 CODEC #3 0x040F
#9 CODEC #3 0x0010
#10 CODEC #3 0x0000