Zotero no Quarto

Arquivos Bibliográficos

O Quarto suporta arquivos bibliográficos em uma grande variedade de formatos, incluindo BibLaTeX e CSL. Adicione uma bibliografia ao seu documento usando o campo de metadados da bibliografia YAML. Por exemplo:

---
title: "My Document"
bibliography: references.bib
---

O Quarto utilizará Pandoc para gerar automaticamente citações e uma bibliografia em vários estilos. Para usar esse recurso, você precisará:

Um documento quarto formatado com citações (ver Citation Markdown).
Uma fonte de dados bibliográficos, por exemplo, um arquivo BibLaTeX (.bib) ou BibTeX (.bibtex).
Opcionalmente, um arquivo CSL que especifica a formatação a ser usada na geração das citações e bibliografia. Baixe o arquivo CSL de interesse no repositório do Zotero ou em outra fonte de arquivos CSL confiável. Usando o Better Biblatex ou o Bibtex, o formato da citação e da lista de referências já é exportado na gereção do arquivo de referências.

Você pode fornecer mais de um arquivo bibliográfico, se desejar, definindo o valor do campo bibliográfico para uma matriz YAML.

Sintaxe de Citação

O Quarto utiliza a representação padrão Pandoc markdown para citações (por exemplo [@citação]) - as citações vão dentro de colchetes e são separadas por ponto-e-vírgula. Cada citação deve ter uma chave, composta de ‘@’ + o identificador da citação do banco de dados. A chave de citação deve começar com uma letra, dígito, ou _, e pode conter alfanuméricos, _, e caracteres de pontuação interna (:.#$%&-+?<>~~/). Aqui estão alguns exemplos:

Formato Markdown	Citação por nome dos autores	Citação em formato numérico
`Blah Blah [see @knuth1984, pp. 33-35; also @wickham2015, chap. 1]`	Blah Blah (see Knuth 1984, 33–35; also Wickham 2015, chap. 1)	Blah Blah see [1], pp. 33-35; also [1], chap. 1
`Blah Blah [@knuth1984, pp. 33-35, 38-39 and passim]`	Blah Blah (Knuth 1984, 33–35, 38–39 and passim)	Blah Blah [1], pp. 33-35, 38-39 and passim
`Blah Blah [@wickham2015; @knuth1984].`	Blah Blah (Wickham 2015; Knuth 1984).	Blah Blah [1, 2].
`Wickham says blah [-@wickham2015]`	Wickham says blah (2015)	Wickham says blah [1]

ou também pode escrever citações em texto, como se segue:

Formato markdown	Citação por nome dos autores	Citação em formato numérico
`@knuth1984 says blah.`	Knuth (1984) says blah.	[1] says blah.
`@knuth1984 [p. 33] says blah.`	Knuth (1984, 33) says blah.	[1] [p. 33] says blah.

Consulte a documentação da Pandoc Citations para obter informações adicionais sobre a sintaxe da citação.

Estilo de citação

O Quarto utiliza Pandoc para formatar citações e bibliografias. Por padrão, a Pandoc usará o formato Chicago Manual of Style author-date, mas você pode especificar uma formatação personalizada usando CSL (Citation Style Language). Para fornecer o estilo de citação personalizada, forneça um caminho para um arquivo CSL usando o campo de metadados csl em seu documento, por exemplo:

---
title: "My Document"
bibliography: references.bib
csl: nature.csl
---

You pode encontrar arquivos CSL ou aprender mais sobre o uso de estilos no CSL Project. Você pode consultar a lista de mais de 8.500 definições Creative Commons de CSL no Projeto CSL central repository ou utilizar o style repository do Zotero.

Citação a partir do DOI

Para acrescentar uma citação, digamos de um DOI,

- Ir para Inserir > Citação
- Escolha DOI no menu à esquerda
- Cole o DOI do artigo ou livro que você deseja citar na caixa de busca e clique em search
- Uma vez localizado o trabalho que você deseja citar, clique em Inserir

É isso aí, você inseriu sua primeira citação! Isto criará automaticamente um arquivo .bib em seu diretório de trabalho, ou se você já tiver um, acrescentará a ele. Ele também adicionará um campo bibliográfico ao YAML de seu documento, que inserirá automaticamente suas referências no final.

Se você estiver usando a sintaxe markdown, você também pode colar um DOI após o [@ e ele será pesquisado:

Mais algumas dicas sobre citações e referências:

Se você quiser que suas referências estejam em uma nova seção, acrescente o cabeçalho dessa seção ao final de seu documento e suas referências serão colocadas após o mesmo.

Este método funciona com documentos da Quarto independentemente do formato, assim você pode inserir citações da mesma forma em um artigo de periódico e em uma apresentação. Com apresentações, você provavelmente desejará suas referências no último slide. Adicionando um título de nível H2 como “Referências” as colocará em um novo slide.

Para inserir uma citação no texto, marque a caixa “Usar citação no texto”.

O mesmo menu pode ser usado para inserir citações de várias fontes, incluindo sua biblioteca Zotero.

Citações de Zotero

Zotero é um popular gestor de referências gratuito e de código aberto. Se você usa Zotero, você também pode inserir citações diretamente de suas bibliotecas Zotero. Se você tiver o Zotero instalado localmente, sua localização será detectada automaticamente e citações de sua biblioteca principal (Minha biblioteca) estarão disponíveis:

As referências Zotero também aparecerão automaticamente nos complementos:

Os itens do Zotero aparecerão ao lado de itens de sua bibliografia com um pequeno logotipo “Z” justaposto sobre eles. Se você inserir uma citação de Zotero que ainda não esteja em sua bibliografia, ela será automaticamente acrescentada à bibliografia.

Bibliotecas do Grupo

Os Grupos Zotero proporcionam uma maneira poderosa de compartilhar coleções com uma classe ou trabalhar de perto com colegas em um projeto. Por padrão, as Bibliotecas do Grupo Zotero não estão incluídas no diálogo de Inserir Citação ou de Completar Citação. Entretanto, há opções disponíveis para usar bibliotecas de grupo em nível global, por projeto ou por documento.

Por exemplo, aqui especificamos uma opção de nível de projeto para usar a biblioteca de grupo Série de Pesquisa Reproduzível (Ano 1):

Você também pode especificar uma ou mais bibliotecas dentro da YAML. Por exemplo, uma ou mais bibliotecas dentro da YAML:

---
title: "Reproducible Research"
zotero: "Reproducible Research Series (Year 1)"
---

--- title: "Zotero no Quarto" format: html: code-fold: true code-tools: true bibliography: references.bib --- ## Zotero no Quarto ### Arquivos Bibliográficos O Quarto suporta arquivos bibliográficos em uma grande variedade de formatos, incluindo BibLaTeX e CSL. Adicione uma bibliografia ao seu documento usando o campo de metadados da bibliografia YAML. Por exemplo: ``` --- title: "My Document" bibliography: references.bib --- ``` O Quarto utilizará `Pandoc` para gerar automaticamente citações e uma bibliografia em vários estilos. Para usar esse recurso, você precisará: - Um documento quarto formatado com citações (ver Citation Markdown). - Uma fonte de dados bibliográficos, por exemplo, um arquivo BibLaTeX (.bib) ou BibTeX (.bibtex). - Opcionalmente, um arquivo CSL que especifica a formatação a ser usada na geração das citações e bibliografia. Baixe o arquivo CSL de interesse no [repositório do Zotero](https://www.zotero.org/styles) ou em outra fonte de arquivos CSL confiável. Usando o Better Biblatex ou o Bibtex, o formato da citação e da lista de referências já é exportado na gereção do arquivo de referências. Você pode fornecer mais de um arquivo bibliográfico, se desejar, definindo o valor do campo bibliográfico para uma matriz YAML. ### Sintaxe de Citação O Quarto utiliza a representação padrão `Pandoc` markdown para citações (por exemplo \[\@citação\]) - as citações vão dentro de colchetes e são separadas por ponto-e-vírgula. Cada citação deve ter uma chave, composta de '\@' + o identificador da citação do banco de dados. A chave de citação deve começar com uma letra, dígito, ou \_, e pode conter alfanuméricos, \_, e caracteres de pontuação interna (:.#\$%&-+?\<\>\~\~/). Aqui estão alguns exemplos: +---------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------+ | Formato Markdown | Citação por nome dos autores | Citação em formato numérico | +=======================================+==================================================================================================================================================================================================================================+=====================================================+ | ``` | Blah Blah (see [Knuth 1984, 33--35](https://quarto.org/docs/authoring/footnotes-and-citations.html#ref-knuth1984); also [Wickham 2015, chap. 1](https://quarto.org/docs/authoring/footnotes-and-citations.html#ref-wickham2015)) | Blah Blah see \[1\], pp. 33-35; also \[1\], chap. 1 | | Blah Blah [see @knuth1984, pp. 33-35; | | | | also @wickham2015, chap. 1] | | | | ``` | | | +---------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------+ | ``` | Blah Blah ([Knuth 1984, 33--35, 38--39](https://quarto.org/docs/authoring/footnotes-and-citations.html#ref-knuth1984) and passim) | Blah Blah \[1\], pp. 33-35, 38-39 and passim | | Blah Blah [@knuth1984, pp. 33-35, | | | | 38-39 and passim] | | | | ``` | | | +---------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------+ | ``` | Blah Blah ([Wickham 2015](https://quarto.org/docs/authoring/footnotes-and-citations.html#ref-wickham2015); [Knuth 1984](https://quarto.org/docs/authoring/footnotes-and-citations.html#ref-knuth1984)). | Blah Blah \[1, 2\]. | | Blah Blah [@wickham2015; @knuth1984]. | | | | ``` | | | +---------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------+ | ``` | Wickham says blah ([2015](https://quarto.org/docs/authoring/footnotes-and-citations.html#ref-wickham2015)) | Wickham says blah \[1\] | | Wickham says blah [-@wickham2015] | | | | ``` | | | +---------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------+ ou também pode escrever citações em texto, como se segue: +-------------------------------+-------------------------------------------------------------------------------------------------------------+-----------------------------+ | Formato markdown | Citação por nome dos autores | Citação em formato numérico | +===============================+=============================================================================================================+=============================+ | ``` | Knuth ([1984](https://quarto.org/docs/authoring/footnotes-and-citations.html#ref-knuth1984)) says blah. | \[1\] says blah. | | @knuth1984 says blah. | | | | ``` | | | +-------------------------------+-------------------------------------------------------------------------------------------------------------+-----------------------------+ | ``` | Knuth ([1984, 33](https://quarto.org/docs/authoring/footnotes-and-citations.html#ref-knuth1984)) says blah. | \[1\] \[p. 33\] says blah. | | @knuth1984 [p. 33] says blah. | | | | ``` | | | +-------------------------------+-------------------------------------------------------------------------------------------------------------+-----------------------------+ Consulte a documentação da Pandoc Citations para obter informações adicionais sobre a sintaxe da citação. ### Estilo de citação O Quarto utiliza Pandoc para formatar citações e bibliografias. Por padrão, a Pandoc usará o formato **Chicago Manual of Style author-date**, mas você pode especificar uma formatação personalizada usando CSL (*Citation Style Language*). Para fornecer o estilo de citação personalizada, forneça um caminho para um arquivo CSL usando o campo de metadados csl em seu documento, por exemplo: ``` --- title: "My Document" bibliography: references.bib csl: nature.csl --- ``` You pode encontrar arquivos CSL ou aprender mais sobre o uso de estilos no [CSL Project](https://github.com/citation-style-language/styles). Você pode consultar a lista de mais de 8.500 definições Creative Commons de CSL no Projeto CSL [central repository](https://github.com/citation-style-language/styles) ou utilizar o [style repository](https://www.zotero.org/styles) do Zotero. ### Citação a partir do DOI Para acrescentar uma citação, digamos de um DOI,\ \ - Ir para Inserir \> Citação\ - Escolha DOI no menu à esquerda\ - Cole o DOI do artigo ou livro que você deseja citar na caixa de busca e clique em search\ - Uma vez localizado o trabalho que você deseja citar, clique em Inserir ![](https://quarto.org/docs/visual-editor/images/visual-editing-citation-insert-doi.png)\ É isso aí, você inseriu sua primeira citação! Isto criará automaticamente um arquivo `.bib` em seu diretório de trabalho, ou se você já tiver um, acrescentará a ele. Ele também adicionará um campo bibliográfico ao YAML de seu documento, que inserirá automaticamente suas referências no final. Se você estiver usando a sintaxe markdown, você também pode colar um DOI após o \[\@ e ele será pesquisado: ![](https://quarto.org/docs/visual-editor/images/visual-editing-citations-doi.png) > Mais algumas dicas sobre citações e referências: > > Se você quiser que suas referências estejam em uma nova seção, acrescente o cabeçalho dessa seção ao final de seu documento e suas referências serão colocadas após o mesmo. > > Este método funciona com documentos da Quarto independentemente do formato, assim você pode inserir citações da mesma forma em um artigo de periódico e em uma apresentação. Com apresentações, você provavelmente desejará suas referências no último slide. Adicionando um título de nível H2 como "Referências" as colocará em um novo slide. > > Para inserir uma citação no texto, marque a caixa "Usar citação no texto". > > O mesmo menu pode ser usado para inserir citações de várias fontes, incluindo sua biblioteca Zotero. ### Citações de Zotero [Zotero](https://zotero.org/) é um popular gestor de referências gratuito e de código aberto. Se você usa Zotero, você também pode inserir citações diretamente de suas bibliotecas Zotero. Se você tiver o Zotero instalado localmente, sua localização será detectada automaticamente e citações de sua biblioteca principal (Minha biblioteca) estarão disponíveis: ![](https://quarto.org/docs/visual-editor/images/visual-editing-citations-zotero-browse.png) As referências Zotero também aparecerão automaticamente nos complementos: ![](images/paste-F7B222B3.png) Os itens do Zotero aparecerão ao lado de itens de sua bibliografia com um pequeno logotipo "Z" justaposto sobre eles. Se você inserir uma citação de Zotero que ainda não esteja em sua bibliografia, ela será automaticamente acrescentada à bibliografia. #### Bibliotecas do Grupo Os Grupos Zotero proporcionam uma maneira poderosa de compartilhar coleções com uma classe ou trabalhar de perto com colegas em um projeto. Por padrão, as Bibliotecas do Grupo Zotero não estão incluídas no diálogo de Inserir Citação ou de Completar Citação. Entretanto, há opções disponíveis para usar bibliotecas de grupo em nível global, por projeto ou por documento. Por exemplo, aqui especificamos uma opção de nível de projeto para usar a biblioteca de grupo Série de Pesquisa Reproduzível (Ano 1): ![](images/paste-F2910613.png) Você também pode especificar uma ou mais bibliotecas dentro da YAML. Por exemplo, uma ou mais bibliotecas dentro da YAML: ``` --- title: "Reproducible Research" zotero: "Reproducible Research Series (Year 1)" --- ``` \