Skip to content

Commit

Permalink
...
Browse files Browse the repository at this point in the history
  • Loading branch information
garethbilaney committed Dec 6, 2024
1 parent a639fa1 commit d484d0f
Show file tree
Hide file tree
Showing 6 changed files with 483 additions and 4 deletions.
58 changes: 58 additions & 0 deletions src/content/docs/pt/biblatex.mdx
Original file line number Diff line number Diff line change
@@ -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:

<CiteDrive />

```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.
127 changes: 127 additions & 0 deletions src/content/docs/pt/natbib.mdx
Original file line number Diff line number Diff line change
@@ -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.

<CiteDrive />

## 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).
167 changes: 167 additions & 0 deletions src/content/docs/pt/overleaf.mdx
Original file line number Diff line number Diff line change
@@ -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.

<CiteDrive />

## 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}
```
Loading

0 comments on commit d484d0f

Please sign in to comment.