Bibliografia e índices: síntese e desafios

Resumo

Esta aula encerra a sexta unidade do curso, dedicada à bibliografia e aos índices. Reconstrói a cadeia de princípios e mecanismos que vai da entrada bibliográfica ao glossário, indicando em cada elo que princípio se usa e em que aula ele se estabelece; situa o que foi alcançado em relação ao plano do curso e precisa que questões, apenas antecipadas, ficam para a unidade seguinte; repete em sua avaliação de saída as habilidades da avaliação de entrada; e termina com seis desafios, de dificuldade superior à dos problemas das aulas, que exigem combinar várias delas para passar um artigo de um estilo de citação a outro, diagnosticar uma lista de referências que compila sem aviso com quatro defeitos, prever as notas de um ensaio sobre Platão, compor um índice onomástico que concorde com a bibliografia, reconstruir o ciclo de compilação de uma tese e preparar uma base que sirva ao mesmo tempo ao bibtex e ao biber.

Objetivos de aprendizagem

Reconstruir a ordem dos mecanismos da unidade, identificando o princípio em que cada um se apoia.
Explicar por que os defeitos de uma base bibliográfica, de uma citação ou de um índice compilam quase sempre sem aviso, e onde buscar sua marca: no resultado, na saída do biber, no relatório do makeindex ou no registro.
Distinguir o que a unidade estabeleceu do que apenas antecipou e que a unidade seguinte desenvolverá.
Prever o que imprimem uma base, um estilo e uma sequência de citações, de entradas de índice e de siglas, e corrigir o código-fonte para que imprima o que se queria.
Ordenar os programas que intervêm na compilação de um documento com bibliografia, índice e glossário, e saber quais se executam sozinhos.

O que a unidade alcançou

A unidade propôs-se a que as fontes de um trabalho sejam citadas a partir de uma base de dados, de modo que as citações e a lista se componham sozinhas no estilo de cada disciplina, e a que o documento tenha os índices e os glossários que permitem consultá-lo. O propósito foi cumprido apoiando-se no que a introdução declarou como sabido das unidades anteriores: as passagens, nas quais o motor escreve numa compilação o que lê na seguinte; a marcação lógica, que diz o que cada coisa é e deixa sua forma a uma decisão tomada em outro lugar; e as notas e as aspas da segunda unidade. Com isso, o caminho percorrido pode ser lido como uma única cadeia em quatro trechos.

A base bibliográfica

A aula sobre a base bibliográfica separou os dados de uma obra do estilo com que é citada, e aplicou às referências o princípio da marcação lógica: o arquivo .bib diz o que cada obra é, e o estilo decide como se escreve. Descreveu as entradas, seus tipos, suas chaves, que devem ser únicas e dedutíveis, e seus campos; mostrou que o biber entende os nomes de campo do biblatex e os clássicos, enquanto o bibtex só os clássicos; estabeleceu as regras mecânicas com que o biber divide os nomes, and entre pessoas, a vírgula entre sobrenome e prenome, a partícula em minúscula e as chaves duplas das instituições, cujo erro só se vê no resultado; protegeu com chaves as maiúsculas que um estilo clássico mudaria; explicou por que o bibtex ordena as letras acentuadas depois do zê e o biber segundo o idioma; apresentou a exportação a partir do Zotero; e ensinou a buscar os erros da base na saída do biber, não no registro do documento.

Citar com o biblatex

A aula sobre citar com o biblatex carregou o pacote com backend=biber, a base com \addbibresource e sua extensão, e o csquotes, que o biblatex pede junto ao babel. Precisou o ciclo: o motor anota as chaves no .bcf, o biber as busca e escreve o .bbl, e a passagem seguinte o compõe; sem o biber, as citações ficam como chaves em negrito, e o botão de bibliografia do Texmaker executa o bibtex por padrão. Escolheu o comando de citação por sua função na oração, \textcite para a narrativa, \parencite para a parentética e \autocite para a que o estilo decide, com notas prévias e posteriores; comparou os estilos autor-data, numérico, numérico compacto e alfabético, nos quais os números seguem a ordem da lista e não a das citações, salvo com sorting=none; e compôs a lista com seu título, seu cabeçalho e seus filtros.

Citar nas humanidades

A aula sobre citar nas humanidades automatizou a regra de economia da citação por notas: a primeira citação é completa, as seguintes breves, e as abreviaturas latinas, ibid., op. cit. e loc. cit., são calculadas pelo estilo, de modo que não se tornam falsas ao mover uma citação. Percorreu a família verbose; devolveu a chamada ao lugar que lhe dão as normas de língua portuguesa, antes da pontuação, com \DeclareAutoCiteCommand; citou os clássicos por sua referência canônica na nota posterior, que o biblatex imprime sem “p.” quando não é um número, e com \nopp quando o parece; introduziu as siglas de shorthand e sua lista; registrou as traduções e seu original por meio de uma entrada relacionada, porque os estilos padrão não imprimem origdate; e separou as fontes da bibliografia secundária com palavras-chave.

Índices e glossários

A aula sobre os índices e os glossários transpôs o mesmo ciclo a outro programa: o motor escreve as entradas no .idx, o makeindex as ordena no .ind, e o imakeidx o executa por conta própria, salvo com nonewpage ou noautomatic. Ensinou as subentradas com !, a chave de ordenação com @, as remissões e os formatos com |, e os intervalos; mostrou que o makeindex compara bytes e leva para o fim as palavras que começam com letra acentuada, e que o upmendex ordena segundo o idioma; manteve vários índices com nome; e compôs com o glossaries os termos e as siglas, que se desenvolvem em sua primeira menção, com o makeglossaries entre as passagens.

A figura seguinte reúne os quatro trechos numa única cadeia. Cada nó da coluna é um mecanismo ou uma regra, numerado segundo a ordem em que uns se apoiam nos outros e unido por um arco aos elos anteriores que usa; ao redor flutuam os apoios, isto é, os princípios aos quais a cadeia recorre uma e outra vez, cada um unido por um traço firme aos elos que se apoiam nele e por um pontilhado ao elo onde se estabelece, exceto os que se estabeleceram em unidades anteriores, que se desenham como anéis. Ao clicar num apoio destacam-se todos os elos que o usam, e cada elo remete à aula em que é estudado.

Apoios da cadeia

APassagens. O motor anota nos arquivos auxiliares o que calcula numa passagem, e o usa na seguinte. Estabelece-se na primeira unidade e precisa-se na terceira. Admitido sem demonstração nesta unidade.
BO que é, não como se vê. A marcação lógica diz o que cada elemento é e deixa sua forma a uma decisão tomada em outro lugar. Estabelece-se na segunda unidade. Admitido sem demonstração nesta unidade.
CDecidir uma vez. O que se decide num só lugar (um estilo, uma opção do preâmbulo, um comando próprio, uma entrada) muda em todo o documento ao mudá-lo ali; o que se copia à mão deixa de concordar. Estabelece-se nas unidades anteriores. Admitido sem demonstração nesta unidade.
DO que o babel põe. O idioma do babel fixa as palavras que o documento escreve por conta própria: títulos, conjunções, abreviaturas e rótulos. Estabelece-se na segunda unidade. Admitido sem demonstração nesta unidade.
EO válido não avisa. O motor e seus programas só avisam do que não podem processar; um código válido que não diz o que o autor queria compila sem aviso, e o defeito só se vê no resultado. Estabelece-se na unidade anterior. Admitido sem demonstração nesta unidade.
FOrdenar bytes ou letras. O bibtex e o makeindex comparam os códigos dos caracteres e levam as letras acentuadas para depois do zê; o biber e o upmendex ordenam segundo as regras do idioma. Estabelecido em: 3. Campos, chaves e acentos.
GMarcar, ordenar, compor. O autor marca no texto o que se cita ou se indexa; um programa externo o ordena entre duas passagens do motor; a passagem seguinte o compõe. Estabelecido em: 6. O ciclo com o biber.

Trecho 1 A base bibliográfica
- Escrever entradas corretas, com seu tipo, sua chave e seus campos.
- Escrever os nomes de modo que se dividam como convém.
- Preparar uma base para o biber ou para o bibtex.
- Diagnosticar uma base pela saída do biber.
1. Dados e estilo. Cada obra se descreve uma vez numa entrada .bib, com seu tipo, uma chave única que não se imprime e seus campos; o estilo decide a forma, e a lista contém exatamente as obras citadas.
  Apoia-se em: B (O que é, não como se vê), C (Decidir uma vez). Demonstrado em: A base bibliográfica.
2. Os nomes. and separa pessoas e a vírgula separa o sobrenome do prenome; sem vírgula, o sobrenome é a última palavra; as minúsculas iniciais são partícula; as chaves duplas impedem dividir o nome de uma instituição. Nenhum erro dá aviso.
  Usa: 1. Dados e estilo. Apoia-se em: E (O válido não avisa). Demonstrado em: A base bibliográfica.
3. Campos, chaves e acentos. O biber entende journal, address e year e seus nomes novos; o bibtex só os clássicos, e com os novos perde a revista e o ano; as chaves protegem as maiúsculas; o bibtex ordena os acentos depois do zê, e o biber segundo o idioma.
  Usa: 1. Dados e estilo. Apoia-se em: F (Ordenar bytes ou letras). Demonstrado em: A base bibliográfica.
4. Diagnosticar a base. Uma vírgula que falta detém o biber e esvazia toda a lista; uma chave repetida é ignorada com uma advertência; um & sem escapar dá um erro do LuaLaTeX na linha do documento que compõe a lista.
  Usa: 2. Os nomes, 3. Campos, chaves e acentos. Apoia-se em: E (O válido não avisa). Demonstrado em: A base bibliográfica.
Trecho 2 Citar com o biblatex
- Carregar o biblatex com o biber e o csquotes.
- Compilar o ciclo com o biber, à mão, com o latexmk ou com o Texmaker.
- Escolher o comando de citação segundo a oração.
- Prever o que imprime cada estilo e compor a lista com seus filtros.
1. Carregar o biblatex. backend=biber e style nas opções; \addbibresource com a extensão do arquivo; o csquotes depois do babel, que o biblatex recomenda com uma advertência.
  Usa: 1. Dados e estilo. Apoia-se em: D (O que o babel põe). Demonstrado em: Citar com o BibLaTeX.
2. O ciclo com o biber. O motor escreve as chaves no .bcf, o biber escreve o .bbl e o motor o compõe; antes, as citações são chaves em negrito; o latexmk executa o biber sozinho, e o botão do Texmaker executa o bibtex se não for mudado.
  Usa: 5. Carregar o biblatex. Apoia-se em: A (Passagens), G (Marcar, ordenar, compor). Demonstrado em: Citar com o BibLaTeX.
3. A citação segundo a oração. \textcite para o autor que é parte da oração, \parencite para o parêntese, \autocite para a citação que o estilo decide; uma nota posterior numérica recebe “p.” por si só, e \citeauthor não remete à lista.
  Usa: 6. O ciclo com o biber. Apoia-se em: D (O que o babel põe), C (Decidir uma vez). Demonstrado em: Citar com o BibLaTeX.
4. O estilo decide. authoryear, numeric, numeric-comp e alphabetic mudam todas as citações e a lista com uma opção; os números seguem a ordem da lista, alfabética por padrão, e sorting=none os põe na ordem das citações.
  Usa: 7. A citação segundo a oração, 2. Os nomes. Apoia-se em: B (O que é, não como se vê), C (Decidir uma vez). Demonstrado em: Citar com o BibLaTeX.
5. A lista e seus filtros. \printbibliography fixa título e cabeçalho; keyword e notkeyword dividem a lista sem perder obras; \nocite acrescenta as não citadas; uma lista sem obras não se imprime, com a advertência “Empty bibliography”.
  Usa: 8. O estilo decide. Apoia-se em: E (O válido não avisa). Demonstrado em: Citar com o BibLaTeX.
Trecho 3 Citar nas humanidades
- Escolher um estilo de notas e prever suas abreviaturas.
- Pôr a chamada antes da pontuação, como pedem as normas de língua portuguesa.
- Citar os clássicos por sua referência canônica.
- Registrar traduções e separar fontes de estudos.
1. Completa e depois breve. A família verbose dá a referência completa na primeira citação e a breve depois; o verbose-ibid escreve “Ibid.” se repete a nota anterior na mesma página; os esquemas tradicionais acrescentam op. cit. e loc. cit.
  Usa: 8. O estilo decide. Apoia-se em: C (Decidir uma vez). Demonstrado em: Citar nas humanidades.
2. A chamada antes da pontuação. Em modo de nota, \autocite passa o sinal de pontuação para antes da chamada; \DeclareAutoCiteCommand com [r] o deixa depois, e um espaço antes de \autocite serve aos dois sistemas.
  Usa: 10. Completa e depois breve, 7. A citação segundo a oração. Apoia-se em: D (O que o babel põe). Demonstrado em: Citar nas humanidades.
3. Referências canônicas. A nota posterior que não é um número, como 514a ou 980a21, imprime-se sem “p.”; a que o parece pede \nopp; shorthand dá uma sigla, que prevalece sobre ibid., e \printbiblist{shorthand} imprime sua lista.
  Usa: 7. A citação segundo a oração, 10. Completa e depois breve. Apoia-se em: E (O válido não avisa). Demonstrado em: Citar nas humanidades.
4. Traduções e fontes. translator e origlanguage nomeiam o tradutor e a língua; os estilos padrão não imprimem origdate, e o original se declara como entrada relacionada; keywords separa as fontes da bibliografia secundária.
  Usa: 12. Referências canônicas, 9. A lista e seus filtros. Apoia-se em: E (O válido não avisa). Demonstrado em: Citar nas humanidades.
Trecho 4 Índices e glossários
- Marcar entradas e compilar o índice com o makeindex.
- Ordenar bem as palavras acentuadas e escrever remissões e intervalos.
- Manter uma forma única para cada entrada e vários índices.
- Definir termos e siglas e prever cada menção.
1. O índice com o imakeidx. \index escreve no .idx, o makeindex ordena no .ind e \printindex o compõe; o imakeidx executa o makeindex por conta própria, salvo com nonewpage ou noautomatic.
  Usa: 6. O ciclo com o biber. Apoia-se em: A (Passagens), G (Marcar, ordenar, compor). Demonstrado em: Índices e glossários.
2. Subentradas, chaves e remissões. ! separa níveis, @ separa a chave de ordenação da forma impressa, |see remete sem página e |( abre um intervalo; sem chave, as palavras com acento inicial vão para o fim.
  Usa: 14. O índice com o imakeidx. Apoia-se em: F (Ordenar bytes ou letras), E (O válido não avisa). Demonstrado em: Índices e glossários.
3. Uma forma, vários índices. O makeindex compara caractere por caractere, e duas grafias de um termo são duas entradas; uma convenção aplicada com um comando próprio o evita; name abre índices à parte, e um nome mal escrito perde a entrada.
  Usa: 15. Subentradas, chaves e remissões, 2. Os nomes. Apoia-se em: C (Decidir uma vez). Demonstrado em: Índices e glossários.
4. Glossários e siglas. O glossaries define cada termo uma vez e \gls desenvolve uma sigla em sua primeira menção; o makeglossaries ordena entre as passagens; um termo com acento inicial precisa de sort, ou o motor se detém.
  Usa: 15. Subentradas, chaves e remissões. Apoia-se em: G (Marcar, ordenar, compor), F (Ordenar bytes ou letras). Demonstrado em: Índices e glossários.

Rumo a outros documentos. A cadeia se detém onde o trabalho acadêmico está completo: texto, estrutura, fórmulas, tabelas, figuras, fontes e índices, cada um calculado a partir de sua declaração. A unidade seguinte leva a mesma base e os mesmos mecanismos às apresentações, aos pôsteres e ao trabalho compartilhado.