From d484d0f1b0e36fc489cbac154abe3079188bab70 Mon Sep 17 00:00:00 2001 From: garethbilaney Date: Fri, 6 Dec 2024 11:48:52 +0100 Subject: [PATCH] ... --- src/content/docs/pt/biblatex.mdx | 58 +++++++++++ src/content/docs/pt/natbib.mdx | 127 +++++++++++++++++++++++ src/content/docs/pt/overleaf.mdx | 167 ++++++++++++++++++++++++++++++ src/content/docs/pt/quarto.mdx | 64 ++++++++++++ src/content/docs/pt/rmarkdown.mdx | 66 ++++++++++++ src/content/docs/ru/quarto.mdx | 5 +- 6 files changed, 483 insertions(+), 4 deletions(-) create mode 100644 src/content/docs/pt/biblatex.mdx create mode 100644 src/content/docs/pt/natbib.mdx create mode 100644 src/content/docs/pt/overleaf.mdx create mode 100644 src/content/docs/pt/quarto.mdx create mode 100644 src/content/docs/pt/rmarkdown.mdx diff --git a/src/content/docs/pt/biblatex.mdx b/src/content/docs/pt/biblatex.mdx new file mode 100644 index 0000000000..91091a3037 --- /dev/null +++ b/src/content/docs/pt/biblatex.mdx @@ -0,0 +1,58 @@ +--- +title: "Começando com BibLaTeX: Um Guia Rápido" +sidebar: + label: Usando o BibLaTeX (Início rápido) +sidebar_position: 4 +--- + +import CiteDrive from '@components/CiteDrive.astro'; + +O seguinte guia ainda está em andamento, mas como o BibLaTeX é visto por muitos como o substituto do BibTeX (e não discordamos), achamos que seria útil dar um empurrão inicial. Lembre-se de que muitas opções e personalizações estão disponíveis no BibLaTeX, e vamos expandir gradualmente esta seção. + +1. Instalar o BibLaTeX: Antes de usar o BibLaTeX, você deve instalá-lo no seu computador. Isso geralmente é feito ao instalar uma distribuição LaTeX que inclua o BibLaTeX, como MikTeX ou TeX Live, ou ao usar o Overleaf, que, como muitas outras ferramentas, já inclui tudo, incluindo os estilos, pronto para uso. + +2. Adicionar o pacote BibLaTeX ao seu documento LaTeX: Para adicionar o BibLaTeX ao seu documento LaTeX, você precisa incluir o seguinte código no preâmbulo do seu documento: + + + +```latex +\usepackage[style=authoryear,backend=biber]{biblatex} +``` + +Esta linha instrui o LaTeX a usar o pacote BibLaTeX com o estilo "authoryear" e o backend "biber". Se isso fizer sentido para você, também é possível usar o BibTeX como backend. No entanto, muitos recursos estarão ausentes e devemos enfatizar que o uso do BibTeX não é recomendado — nem por motivos nostálgicos. + +3. Se você já está acostumado ao BibTeX, tudo permaneceu igual, exceto que o BibLaTeX agora suporta alguns tipos e campos adicionais. Você mantém suas referências em um banco de dados bibliográfico separado, um arquivo de texto com a extensão `.bib`. Aqui está um exemplo de um banco de dados simples, que podemos chamar de `bibliography.bib`: + +```latex +@book{key, + author = {Autor, A.}, + title = {O Título do Livro}, + year = {2021}, + publisher = + {Editora}, +} +``` + +4. Para incluir o arquivo bib (seu banco de dados de referências), use o seguinte comando no seu documento TeX: + +```latex +\addbibresource{bibliography.bib} +``` + +5. Para citar uma referência no seu documento, use a seguinte sintaxe: + +```latex +\autocite{key} +``` + +onde "key" é a chave da referência que você deseja citar. + +6. Para incluir a bibliografia ou lista de referências no seu documento, você precisa incluir o seguinte código no local onde deseja que a bibliografia apareça: + +```latex +\printbibliography +``` + +7. Por fim, use um compilador LaTeX, como `pdflatex` ou `xelatex`, para compilar seu documento. O BibLaTeX gerará automaticamente a bibliografia com base nas referências que você citou no seu trabalho quando você compilar o documento. + +É isso! Agora você deve ser capaz de usar o BibLaTeX para gerenciar suas referências e citações nos seus documentos LaTeX após seguir esses passos simples. Lembre-se de que o BibLaTeX é uma ferramenta altamente personalizável; como mencionado anteriormente, adicionaremos mais detalhes no futuro. Mas, por enquanto, você já pode começar imediatamente. \ No newline at end of file diff --git a/src/content/docs/pt/natbib.mdx b/src/content/docs/pt/natbib.mdx new file mode 100644 index 0000000000..78fbd472c4 --- /dev/null +++ b/src/content/docs/pt/natbib.mdx @@ -0,0 +1,127 @@ +--- +title: "Tutorial do Natbib: Dominando a Gestão de Referências no LaTeX com o BibTeX" +description: "Explore as capacidades do natbib para gerenciar referências bibliográficas no LaTeX. Este tutorial detalhado cobre os essenciais do natbib, desde citações no texto até integração com o BibTeX." +sidebar: + label: "Natbib (Tutorial Detalhado)" +sidebar_position: 3 +--- + +import CiteDrive from '@components/CiteDrive.astro'; + +Gerenciar referências bibliográficas no LaTeX se torna mais eficiente e simplificado com o pacote `natbib`. Seja usando o comando tradicional `\cite{*}` ou explorando métodos avançados de citação, este guia oferece insights fundamentais para começar. + + + +## Introdução ao `natbib` e seus Pontos Fortes + +O pacote natbib estende as capacidades do comando padrão `\cite{*}` no LaTeX. Ele se destaca especialmente nas citações no texto, oferecendo várias opções e personalizações, principalmente para esquemas de autor-ano e para exibir citações textuais e parentéticas quando integrado com o BibTeX. + +:::tip +Bom saber: o pacote funciona perfeitamente tanto com citações autor-ano quanto numéricas e suporta os arquivos de bibliografia padrão `*.bst`. +::: + +Vamos explorar os detalhes de como aproveitar o poder do natbib para formatar e citar suas fontes bibliográficas. + +## Iniciando sua Jornada: Citações Parentéticas e Textuais/Narrativas com o natbib + +Configurar o `natbib` requer uma estrutura semelhante à do LaTeX padrão. Comece carregando a biblioteca com `\usepackage{natbib}`. A biblioteca oferece várias opções de configuração via `\usepackage[opções]{natbib}`, discutidas em detalhes abaixo. Os principais comandos de citação no Natbib são `\citet{*}` para citações textuais/narrativas e `\citep{*}` para citações parentéticas. + +```latex +\documentclass{article} +\usepackage{natbib} +\bibliographystyle{apalike} +\title{Um Guia Completo para Gestão de Referências usando natbib com BibTeX} +\author{CiteDrive} +\date {Janeiro de 1988} + +\begin{document} + +\maketitle +\textbf{Citação narrativa:} \citet{Doe:1966} investigou os riscos de registros incorretos [...], o que resulta em distorções. +\textbf{Citação parentética:} Os riscos de registros incorretos de [...] podem levar à distorção \citep{Doe:1966}. + +\medskip + +\bibliography{sample} + +\end{document} +``` + +Ao usar `\bibliography{sample}`, você aponta para o arquivo `.bib` que contém entradas bibliográficas como: + +```bibtex +@article{Doe:1966, + title = {Estudo sobre os riscos de registros incorretos [...] e seus impactos em [...].}, + author = {John Doe}, + year = {1966}, + journal = {Publicação BibTeX}, + volume = 44, + number = 44, + pages = {123--456} +} +@article{smith2017, + title = {Um artigo interessante}, + author = {John Smith}, + year = {2017}, + journal = {Revista de Artigos Interessantes} +} +``` + +![Exemplo de saída de gestão de referências usando natbib com BibTeX](@assets/images/tutorial/output_example_bibtex_natbib.png)Exemplo de saída de gestão de referências usando natbib com BibTeX + +Para quem prefere estilos de citação numérica, veja como adaptar o natbib: + +```latex +\usepackage[square,numbers]{natbib} +\bibliographystyle{abbrvnat} +``` + +![Exemplo de saída de gestão de referências usando natbib com BibTeX no estilo numérico](@assets/images/tutorial/output_example_bibtex_natbib_numeric.png)Exemplo de saída de gestão de referências usando natbib com BibTeX no estilo numérico + +## Mergulhando Fundo: Explorando os Comandos `cite{*}` no natbib + +Entender a variedade de comandos `cite{*}` fornecidos pelo `natbib` permite citar fontes de forma eficiente. Esta tabela detalha suas saídas: + +| Comando (citação única) | Saída (autor-ano) | Saída (Numérica) | Comando (Múltiplas citações) | Saída (autor-ano) | Saída (Numérica) | +|------------------------|-------------------|------------------|-----------------------------|-------------------|------------------| +|`\citet{Doe:1966}`|Doe (1966) |Doe [1]|`\citet{Doe:1966,smith2017}`|Doe (1966); Smith (2017)|Doe [1], Smith [2]| +|`\citet[cap.~4]{Doe:1966}`|Doe (1966, cap. 4)|Doe [1, cap. 4]|`\citet[cap.~4]{Doe:1966,smith2017}`|Doe (1966); Smith (2017, cap. 4)|Doe [1], Smith [2, cap. 4]| +|`\citep{Doe:1966}`|(Doe, 1966)|[1]|`\citep{Doe:1966,smith2017}`|(Doe, 1966; Smith, 2017)|[1, 2]| +|`\citep[cap.~4]{Doe:1966}`|(Doe, 1966, cap. 4)|[1, cap. 4]|`\citep[cap.~4]{Doe:1966,smith2017}`|(Doe, 1966; Smith, 2017, cap. 4)|1, 2, cap. 4]| +|`\citep[ver][]{Doe:1966}`|(ver Doe, 1966)|[ver 1]|`\citep[ver][]{Doe:1966,smith2017}`|(ver Doe, 1966; Smith, 2017)|[ver 1, 2]| +|`\citep[ver][cap.~4]{Doe:1966}`|(ver Doe, 1966, cap. 4)|[ver 1, cap. 4]|`\citep[ver][cap.~4]{Doe:1966,smith2017}`|(ver Doe, 1966; Smith, 2017, cap. 4)|[ver 1, 2, cap. 4]| +|`\citet*{Doe:1966}`|Doe (1966)|Doe [1]|`\citet*{Doe:1966,smith2017}`|Doe (1966); Smith (2017)|Doe [1], Smith [2]| +|`\citep*{Doe:1966}`|(Doe, 1966)|[1]|`\citep*{Doe:1966,smith2017}`|(Doe, 1966; Smith, 2017)|[1, 2]| + +Outros comandos do `natbib`, como `\citealp` e `\citealt`, oferecem flexibilidade adicional suprimindo os colchetes. Descubra toda a gama de comandos na [Folha de Referência para o uso do natbib](https://gking.harvard.edu/files/natnotes2.pdf). + +## Apêndice: Dominando as Opções do `natbib` + +Ao trabalhar com o `natbib`, personalizar seu comportamento pode tornar seu fluxo de trabalho mais suave. Aqui está uma análise das opções disponíveis via `\usepackage[opções]{natbib}`: + +| Opção | Descrição | +|----------------------|----------| +|round|exibe parênteses redondos| +|square|exibe colchetes quadrados| +|curly|exibe chaves| +|angle|exibe colchetes angulares| +|semicolon|citações múltiplas separadas por ponto e vírgula| +|colon|mesma função do ponto e vírgula| +|comma|citações múltiplas separadas por vírgula| +|authoryear|exibe citações autor-ano| +|numbers|exibe citações numéricas| +|super|exibe números sobrescritos para citações numéricas| +|sort|classifica citações múltiplas na ordem em que aparecem na bibliografia| +|compress|classificação e compressão de citações numéricas múltiplas onde apropriado| +|sort&compress|compressão de citações numéricas múltiplas onde apropriado| +|longnamesfirst|o nome completo do autor aparece na primeira citação| +|sectionbib|redefine `\thebibliography` para gerar `\section` em vez de `\chapter`| +|nonamebreak|exibe todos os nomes de autores de uma citação em uma linha| + +### Leitura Adicional e Fontes + +- Explore mais sobre a gestão de bibliografia com o [Gerenciamento de Bibliografia com natbib](https://www.overleaf.com/learn/latex/Bibliography_management_with_natbib) no Overleaf. +- Familiarize-se com diferentes estilos de bibliografia em [Estilos de Bibliografia do Natbib](https://www.overleaf.com/learn/latex/Natbib_bibliography_styles) no Overleaf. +- Para uma folha de referência prática, confira a [Folha de Referência para o uso do natbib](https://gking + +.harvard.edu/files/natnotes2.pdf). \ No newline at end of file diff --git a/src/content/docs/pt/overleaf.mdx b/src/content/docs/pt/overleaf.mdx new file mode 100644 index 0000000000..0ab73e11c7 --- /dev/null +++ b/src/content/docs/pt/overleaf.mdx @@ -0,0 +1,167 @@ +--- +title: "Overleaf: Gerenciamento de Citações e Referências - Introdução às Bibliografias em LaTeX" +description: "Descubra como gerenciar citações, bibliografias e referências no Overleaf usando BibTeX, Natbib e BibLaTeX. Além disso, otimize seu fluxo de trabalho com o CiteDrive." +sidebar: + label: "Usando Overleaf (Início rápido)" +--- + +import CiteDrive from '@components/CiteDrive.astro'; + +**Overleaf.com**, o editor LaTeX baseado na nuvem, é a plataforma ideal para criação colaborativa e publicação de documentos acadêmicos. Nascido da fusão do **WriteLaTeX** com o **ShareLaTeX**, possui mais de 10 milhões de usuários em todo o mundo. O Overleaf oferece uma ampla variedade de ferramentas e templates pré-instalados, voltados para periódicos acadêmicos, tornando-se uma das principais escolhas para pesquisadores e acadêmicos. + +Com o Overleaf, você pode gerenciar facilmente citações e referências usando ferramentas poderosas como o **CiteDrive**. Esta integração simplifica seu fluxo de trabalho, tornando o gerenciamento de citações mais eficiente. + + + +## Gerenciamento de Bibliografia no Overleaf/LaTeX + +### Por que escolher o CiteDrive? + +**CiteDrive** é uma robusta ferramenta de gerenciamento de citações e referências que funciona perfeitamente com o Overleaf. Veja por que você deve considerar o uso do CiteDrive: + +- **Integração sem interrupções**: Funciona perfeitamente com o Overleaf e sistemas de referências populares como BibTeX, Natbib e BibLaTeX. +- **Maior Eficiência**: Automatiza a formatação de citações e gerencia referências com facilidade. +- **Fácil de usar**: Oferece uma interface intuitiva para organizar e citar referências. +- **Baseado na web e colaborativo**: Acesse e gerencie suas citações de qualquer lugar, com recursos de colaboração em tempo real. +[Saiba mais sobre as funcionalidades e benefícios do CiteDrive](https://www.citedrive.com). + +### BibTeX + +BibTeX é um sistema de gerenciamento de referências amplamente utilizado no LaTeX. Para usar o BibTeX no Overleaf: + +1. **Crie um arquivo de bibliografia**: Crie um arquivo chamado `references.bib` no seu projeto Overleaf. +2. **Adicione Referências**: Inclua referências neste formato: + + ```bibtex + @article{AuthorYear, + author = {Author, First and Author, Second}, + title = {Título do Artigo}, + journal = {Nome do Periódico}, + volume = {Número do Volume}, + number = {Número da Edição}, + pages = {Número das Páginas}, + year = {Ano de Publicação}, + publisher = {Nome da Editora} + } + ``` + +3. **Cite Referências**: No seu documento LaTeX, adicione: + + ```latex + \bibliography{references} + \bibliographystyle{plain} + ``` + + Use `\cite{AuthorYear}` para citar uma referência. + +4. **Otimize com CiteDrive**: Automatize e gerencie suas referências BibTeX de maneira mais eficiente com o CiteDrive. + +### Natbib + +Natbib oferece maior flexibilidade para a formatação de citações. Para usar o Natbib no Overleaf: + +1. **Adicione os Comandos**: Inclua no preâmbulo: + + ```latex + \usepackage{natbib} + \bibliographystyle{plainnat} + ``` + +2. **Cite Referências**: Use `\citep{AuthorYear}` para citações parentéticas ou `\citet{AuthorYear}` para citações no texto. + +3. **Bibliografia**: Adicione: + + ```latex + \bibliography{references} + ``` + +4. **Melhore com CiteDrive**: Simplifique o gerenciamento e formatação de citações com o CiteDrive. + +### BibLaTeX + +BibLaTeX oferece recursos avançados de citação. Para usar o BibLaTeX no Overleaf: + +1. **Adicione os Comandos**: Inclua no preâmbulo: + + ```latex + \usepackage[style=authoryear,backend=bibtex]{biblatex} + \bibliography{references} + ``` + +2. **Cite Referências**: Use `\parencite{AuthorYear}` para citações parentéticas ou `\textcite{Author}` para citações no texto. + +3. **Otimize com CiteDrive**: Aproveite o controle aprimorado e a flexibilidade com o suporte do CiteDrive para o BibLaTeX. + +## Noções Básicas de LaTeX + +Para iniciantes no LaTeX, aqui está uma visão geral rápida: + +```latex +\documentclass{article} +\usepackage{graphicx} +\usepackage{caption} +\usepackage{biblatex} + +\addbibresource{references.bib} % Substitua "references.bib" pelo seu arquivo de bibliografia + +\title{Meu Primeiro Documento em LaTeX} +\author{Seu Nome} + +\begin{document} + +\maketitle + +\section{Introdução} +Este é um documento de exemplo demonstrando o básico do LaTeX. + +\section{Formatação} +Você pode formatar o texto em \textbf{negrito}, \textit{itálico}, \underline{sublinhado} ou \texttt{monoespaçado}. + +\section{Listas} +Aqui está um exemplo de lista com marcadores: +\begin{itemize} + \item Primeiro item + \item Segundo item + \item Terceiro item +\end{itemize} + +\section{Matemática} +O LaTeX é excelente para digitar fórmulas matemáticas. Aqui está um exemplo de equação: +\begin{equation} + E = mc^2 +\end{equation} + +\section{Figuras e Tabelas} +Você pode incluir figuras e tabelas no seu documento. Aqui está um exemplo de figura: +\begin{figure}[ht] + \centering + \includegraphics[width=0.5\textwidth]{example-image} + \caption{Uma figura de exemplo} + \label{fig:example} +\end{figure} + +E aqui está um exemplo de tabela: +\begin{table}[ht] + \centering + \begin{tabular}{|c|c|} + \hline + \textbf{Item} & \textbf{Quantidade} \\ + \hline + Maçã & 3 \\ + Laranja & 5 \\ + \hline + \end{tabular} + \caption{Uma tabela de exemplo} + \label{tab:example} +\end{table} + +\section{Referências} +Você pode se referir a seções, equações, figuras e tabelas rotuladas. Por exemplo, veja a Figura~\ref{fig:example} e a Tabela~\ref{tab:example}. + +\section{Citações e Bibliografia} +Cite referências usando \cite{author2022}. Aqui está um exemplo de citação. + +\printbibliography + +\end{document} +``` diff --git a/src/content/docs/pt/quarto.mdx b/src/content/docs/pt/quarto.mdx new file mode 100644 index 0000000000..939dcff843 --- /dev/null +++ b/src/content/docs/pt/quarto.mdx @@ -0,0 +1,64 @@ +--- +title: "Gerenciamento de Referências com BibTeX, ao Usar o Quarto - Um Guia Rápido" +description: "Este tutorial rápido irá mostrar como gerenciar suas referências usando o BibTeX. O BibTeX é um software de gerenciamento de referências que permite armazenar e organizar suas referências de forma simples e fácil de usar." +sidebar: + label: "Usando Quarto (RStudio/Posit) (Início rápido)" +sidebar_position: 5 +--- + +import CiteDrive from '@components/CiteDrive.astro'; + +O Quarto é uma excelente ferramenta para a criação de relatórios, artigos e apresentações reproduzíveis, entre outras coisas. Uma das características que distingue o Quarto é sua capacidade de integrar com outras ferramentas e softwares. O BibTeX, um sistema de gerenciamento de referências para documentos LaTeX, é uma dessas ferramentas. O BibTeX facilita a citação de fontes e a criação de bibliografias em seu documento. + + + +## Passo 1: Criar um arquivo .bib e adicionar algumas entradas. + +Como na seção anterior, começamos criando um arquivo .bib chamado 'bibliography.bib', que é preenchido com entradas BibTeX. +As entradas BibTeX são construídas no seguinte formato e contêm informações suficientes para a citação e inclusão na bibliografia de cada fonte de literatura (livro, artigo, etc.). + +Usamos o exemplo da seção anterior e citamos o livro "O Velho e o Mar" de Ernest Hemingway. O resultado é o seguinte: + +```latex +@book{Hemingway1952, + title={O Velho e o Mar}, + author={Hemingway, Ernest}, + year={1952}, + publisher={Charles Scribner's Sons} +} +``` + +Novamente, vamos dissecar a "anatomia" desta entrada, focando em três componentes para entender como cada entrada BibTeX é definida: + +* **Tipo de Entrada**: com `@book` definimos o tipo de acordo com o esquema `@type` da referência. Possíveis tipos são `@article` para artigos científicos, entre outros. O BibTeX gosta de especificar quais campos são opcionais e quais são obrigatórios para indicá-los corretamente na literatura. +* **Campos da Entrada**: no caso do nosso exemplo de `@book`, esses campos são `title`, `author`, `year` e `publisher`. (Cf. [campos](./fields)) +* **Chave de Citação**: no nosso exemplo, é `Hemingway1952` e é usada para indicar uma citação no texto no LaTeX, ou seja, para referenciar a fonte. No Quarto fazemos isso com `[@Hemingway1952]`. A chave de citação pode ser qualquer string – frequentemente uma combinação do autor, ano e uma palavra do título. + +## Passo 2: Criar um documento Quarto e conectar + +É muito simples integrar o BibTeX com o Quarto. Basta especificar o arquivo bib com 'bibliography: bibliography.bib' no YAML e a citação com '[@Hemingway1952]' no local onde você deseja que a citação no texto apareça. + +```md +--- +title: "Referências BibTeX no Quarto" +author: "John Doe" +date: '2022-07-19' +bibliography: bibliography.bib +output: html_document +--- + + +## Referências BibTeX no Quarto + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. +Praesent enim urna, dapibus et bibendum vel, consectetur et turpis. +Cras a molestie nulla. [@Hemingway1952] +``` + +## Gerenciadores de Referências + +Formatar manualmente arquivos BibTeX pode ser demorado, por isso geralmente é recomendado usar um gerenciador de referências. Aqui estão alguns ideais para isso: + +* [CiteDrive](https://www.citedrive.com/) é uma ferramenta colaborativa e baseada na nuvem para gerenciamento de referências de projetos e equipes, alimentada por BibTeX. Ela oferece exportação com um clique para Overleaf ([*Cf. Post do Blog Overleaf - https://www.overleaf.com/blog/citedrive... | CiteDrive - Gestão Fácil de Referências para Overleaf*](https://www.overleaf.com/blog/citedrive-easy-reference-management-for-overleaf)) junto com Quarto ([*Cf. Post no Medium: Gestão de Bibliografia no Quarto com CiteDrive e RStudio*](https://citedrive.medium.com/bibliography-management-in-r-markdown-with-citedrive-and-rstudio-2585699dd619)), mantendo as citações sincronizadas. +* Zotero é uma ferramenta gratuita e de código aberto para gerenciamento de literatura, que gerencia dados bibliográficos e materiais de pesquisa relacionados (como arquivos PDF). O melhor desempenho para BibTeX no Zotero é alcançado com **[Better BibTeX For Zotero](https://retorque.re/zotero-better-bibtex/)** da retorque. +* O software gratuito e de código aberto JabRef é um gerenciador de referências que oferece suporte ao BibTeX e pode ser executado em Windows, Mac e Linux. Ele é baseado em Java e mantido pela JabRef e.V. diff --git a/src/content/docs/pt/rmarkdown.mdx b/src/content/docs/pt/rmarkdown.mdx new file mode 100644 index 0000000000..02b2fa2b69 --- /dev/null +++ b/src/content/docs/pt/rmarkdown.mdx @@ -0,0 +1,66 @@ +--- +title: "Gerenciamento de Referências com BibTeX, ao Usar o R Markdown - Um Guia Rápido" +description: "Este tutorial rápido irá mostrar como gerenciar suas referências usando o BibTeX. O BibTeX é um software de gerenciamento de referências que permite armazenar e organizar suas referências de forma simples e fácil de usar." +sidebar: + label: "Usando R Markdown (Início rápido)" +sidebar_position: 6 +--- +``` + +```markdown +import CiteDrive from '@components/CiteDrive.astro'; + +O R Markdown é uma ótima ferramenta para criar relatórios, artigos, apresentações e mais, de forma reproduzível. Uma das coisas que torna o R Markdown tão poderoso é sua capacidade de se integrar com outras ferramentas e softwares. Uma dessas ferramentas é o BibTeX, que é um sistema de gerenciamento de referências para documentos LaTeX. O BibTeX permite citar fontes facilmente em seu documento e criar uma bibliografia. + + + +## Passo 1: Criar um arquivo .bib e adicionar algumas entradas. + +Como na seção anterior, começamos gerando um arquivo .bib, como `bibliography.bib`, que é preenchido com entradas BibTeX. +As entradas BibTeX são construídas no seguinte formato e contêm informações suficientes para a citação e inclusão na bibliografia de cada fonte de literatura (livro, artigo, etc.). + +Usamos o exemplo da seção anterior e citamos o livro "O Velho e o Mar" de Ernest Hemingway. A entrada fica assim: + +```latex +@book{Hemingway1952, + title={O Velho e o Mar}, + author={Hemingway, Ernest}, + year={1952}, + publisher={Charles Scribner's Sons} +} +``` + +Novamente, vamos dissecar a "anatomia" desta entrada, observando três componentes para entender como cada entrada BibTeX é definida: + +* **Tipo de Entrada**: com `@book` definimos o tipo de acordo com o esquema `@type` da referência. Possíveis tipos incluem `@article` para artigos científicos, entre outros. O BibTeX gosta de especificar quais campos são opcionais e quais são obrigatórios para indicá-los corretamente na literatura. +* **Campos da Entrada**: no caso do nosso exemplo de `@book`, esses campos são `title`, `author`, `year` e `publisher`. (Cf. [campos](./fields)) +* **Chave de Citação**: no nosso exemplo, é `Hemingway1952` e é usada para indicar uma citação no texto no LaTeX, ou seja, para referenciar a fonte. No R Markdown fazemos isso com `[@Hemingway1952]`. A chave de citação pode ser qualquer string – frequentemente uma combinação do autor, ano e uma palavra do título. + +## Passo 2: Criar um documento R Markdown e conectar + +Integrar o BibTeX com o R Markdown é muito simples. Basta especificar o arquivo bib com `bibliography: bibliography.bib` no YAML e a citação com `[@Hemingway1952]` no local onde você deseja que a citação no texto apareça. + +```md +--- +title: "Referências BibTeX no R Markdown" +author: "John Doe" +date: '2022-07-19' +bibliography: bibliography.bib +output: html_document +--- + + +## Referências BibTeX no R Markdown + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. +Praesent enim urna, dapibus et bibendum vel, consectetur et turpis. +Cras a molestie nulla. [@Hemingway1952] +``` + +## Gerenciadores de Referências + +Formatar arquivos BibTeX manualmente pode ser tedioso, por isso é geralmente recomendado usar um gerenciador de referências. Aqui estão alguns bem adequados para isso: + +* [CiteDrive](https://www.citedrive.com/) é uma ferramenta colaborativa e baseada na nuvem, alimentada por BibTeX, para gerenciar suas referências e equipes em projetos. Ela oferece exportação com um clique para Overleaf ([*Cf. Post do Blog Overleaf - https://www.overleaf.com/blog/citedrive... | CiteDrive - Gestão Fácil de Referências para Overleaf*](https://www.overleaf.com/blog/citedrive-easy-reference-management-for-overleaf)) junto com R Markdown ([*Cf. Post no Medium: Gestão de Bibliografia no R Markdown com CiteDrive e RStudio*](https://citedrive.medium.com/bibliography-management-in-r-markdown-with-citedrive-and-rstudio-2585699dd619)), mantendo as citações sincronizadas. +* Zotero é uma ferramenta gratuita e de código aberto para gerenciamento de literatura, que gerencia dados bibliográficos e materiais de pesquisa relacionados (como arquivos PDF). O melhor desempenho para BibTeX no Zotero é alcançado com **[Better BibTeX For Zotero](https://retorque.re/zotero-better-bibtex/)** da retorque. +* O software gratuito e de código aberto JabRef é um gerenciador de referências que oferece suporte ao BibTeX e pode ser executado em Windows, Mac e Linux. Ele é baseado em Java e mantido pela JabRef e.V. diff --git a/src/content/docs/ru/quarto.mdx b/src/content/docs/ru/quarto.mdx index 08e95b2011..3e0c36fd14 100644 --- a/src/content/docs/ru/quarto.mdx +++ b/src/content/docs/ru/quarto.mdx @@ -1,13 +1,10 @@ -Here is the translation of your content into Russian: - --- - title: "Управление ссылками с использованием BibTeX в Quarto — Краткое руководство" description: "Этот быстрый учебник покажет вам, как управлять вашими ссылками с использованием BibTeX. BibTeX — это программное обеспечение для управления ссылками, которое позволяет хранить и организовывать ваши ссылки в простом, удобном формате." sidebar: label: "Использование Quarto (RStudio/Posit) (Быстрый старт)" sidebar_position: 5 ---- +--- import CiteDrive from '@components/CiteDrive.astro';