Skip to content

Commit

Permalink
...
Browse files Browse the repository at this point in the history
  • Loading branch information
garethbilaney committed Dec 5, 2024
1 parent c21bcc6 commit 476d25a
Show file tree
Hide file tree
Showing 5 changed files with 484 additions and 0 deletions.
57 changes: 57 additions & 0 deletions src/content/docs/zh-cn/biblatex.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
---
title: "使用 BibLaTeX 入门:快速指南"
sidebar:
label: 使用 BibLaTeX(快速入门)
sidebar_position: 4
---

import CiteDrive from '@components/CiteDrive.astro';

以下指南仍在完善中,但由于 BibLaTeX 被许多人视为 BibTeX 的替代品(我们对此并不反对),我们认为为您提供一个快速入门会有所帮助。请记住,BibLaTeX 提供了许多选项和自定义功能,我们将逐步扩展此部分内容。

1. 安装 BibLaTeX:在使用 BibLaTeX 之前,您必须先在计算机上安装它。通常,您可以通过安装包含 BibLaTeX 的 LaTeX 发行版(如 MikTeX 或 TeX Live),或使用 Overleaf(它像许多其他软件包一样,开箱即用,包含了所有内容,包括样式)来完成此操作。

2. 将 BibLaTeX 包添加到 LaTeX 文档:要将 BibLaTeX 添加到 LaTeX 文档中,您需要在文档的前言部分包含以下代码:

<CiteDrive />

```latex
\usepackage[style=authoryear,backend=biber]{biblatex}
```

此行代码告诉 LaTeX 使用 BibLaTeX 包,采用 "authoryear" 样式和 "biber" 后端。如果您理解这一点,也可以使用 BibTeX 作为后端。不过,许多功能将会缺失,我们必须强调,即使出于怀旧原因,也不推荐使用 BibTeX。

3. 如果您习惯使用 BibTeX,那么除了 BibLaTeX 现在支持更多的类型和字段之外,其他一切保持不变。您将参考文献保存在一个单独的书目数据库中,这通常是一个扩展名为 `.bib` 的文本文件。以下是一个简单数据库的示例,我们可以称之为 `bibliography.bib`

```latex
@book{key,
author = {Author, A.},
title = {The Title of the Book},
year = {2021},
publisher = {Publisher},
}
```

4. 要在 TeX 文档中引用该 bib 文件(您的参考文献数据库),请使用以下命令:

```latex
\addbibresource{bibliography.bib}
```

5. 要在文档中引用参考文献,请使用以下语法:

```latex
\autocite{key}
```

其中 "key" 是您要引用的参考文献的键值。

6. 要在文档中插入书目或参考文献列表,您需要在文档中需要显示书目位置的地方包含以下代码:

```latex
\printbibliography
```

7. 最后,使用 LaTeX 编译器,如 `pdflatex``xelatex`,来编译您的文档。BibLaTeX 会在您编译文档时,自动根据您在文中引用的参考文献生成书目。

就这样!按照这些简单的步骤,您应该能够在 LaTeX 文档中使用 BibLaTeX 来管理您的参考文献和引文。请记住,BibLaTeX 是一个高度可自定义的工具;如前所述,我们将来会添加更多内容。但目前,您应该能够立即开始使用它。
131 changes: 131 additions & 0 deletions src/content/docs/zh-cn/natbib.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,131 @@
---
title: "Natbib 教程:使用 BibTeX 在 LaTeX 中掌握参考文献管理"
description: "探索 natbib 在 LaTeX 中管理文献引用的功能。本教程深入讲解 natbib 的基础知识,从文中引用到与 BibTeX 的集成。"
sidebar:
label: "Natbib(深入教程)"
sidebar_position: 3
---


import CiteDrive from '@components/CiteDrive.astro';


在 LaTeX 中管理文献引用变得更加简洁高效,得益于 `natbib` 包的使用。无论你是使用传统的 `\cite{*}` 命令,还是深入探索高级引用方法,本指南都将为你提供基础知识,帮助你顺利上手。

<CiteDrive />

## `natbib` 介绍及其优势

`natbib` 包扩展了标准 `\cite{*}` 命令在 LaTeX 中的功能。它在文本内引用方面尤为突出,提供了多种选项和自定义,特别是支持作者-年份格式,并且与 BibTeX 集成后,可以显示文本型和圆括号型的引用。

:::tip
值得注意:该包无缝支持作者-年份和数字型引用,并支持标准的 `*.bst` 参考文献样式文件。
:::

让我们深入了解如何利用 `natbib` 来格式化和引用文献。

## 启动你的旅程:使用 natbib 进行圆括号型和文本型/叙述型文内引用

设置 `natbib` 包的方式与标准的 LaTeX 设置相似。首先,通过 `\usepackage{natbib}` 加载该包。你还可以通过 `\usepackage[options]{natbib}` 来选择不同的配置选项,具体细节如下。`natbib` 的主要引用命令是 `\citet{*}` 用于叙述型引用,`\citep{*}` 用于圆括号型引用。

```latex
\documentclass{article}
\usepackage{natbib}
\bibliographystyle{apalike}
\title{使用 natbib 和 BibTeX 进行参考文献管理的全面指南}
\author{CiteDrive}
\date {1988 年 1 月}
\begin{document}
\maketitle
\textbf{叙述型引用:} \citet{Doe:1966} 研究了记录不当的风险,导致了失真。
\textbf{圆括号型引用:} 记录错误的风险可能导致失真 \citep{Doe:1966}。
\medskip
\bibliography{sample}
\end{document}
```

通过使用 `\bibliography{sample}`,你指向了包含参考文献条目的 `.bib` 文件,如下所示:

```bibtex
@article{Doe:1966,
title = {研究记录错误的风险及其对 [...] 的影响},
author = {John Doe},
year = 1966,
journal = {BibTeX 出版},
volume = 44,
number = 44,
pages = {123--456}
}
@article{smith2017,
title = {一篇有趣的文章},
author = {John Smith},
year = {2017},
journal = {有趣文章期刊}
}
```

![使用 natbib 和 BibTeX 的参考文献管理输出示例](@assets/images/tutorial/output_example_bibtex_natbib.png) 使用 natbib 和 BibTeX 的参考文献管理输出示例

对于喜欢数字引用样式的人,这里是如何将 natbib 设置为数字引用样式:

```latex
\usepackage[square,numbers]{natbib}
\bibliographystyle{abbrvnat}
```

![使用 natbib 和 BibTeX 的数字样式参考文献管理输出示例](@assets/images/tutorial/output_example_bibtex_natbib_numeric.png) 使用 natbib 和 BibTeX 的数字样式参考文献管理输出示例

## 深入探讨:`cite{*}` 命令在 natbib 中的使用

了解 `natbib` 提供的各种 `cite{*}` 命令可以帮助你更高效地引用文献。下表展示了这些命令的输出:

| 命令(单个引用) | 输出(作者-年份) | 输出(数字) | 命令(多个引用) | 输出(作者-年份) | 输出(数字) |
|------------------|-------------------|---------------|------------------|-------------------|--------------|
|`\citet{Doe:1966}`|Doe (1966) |Doe [1]|`\citet{Doe:1966,smith2017}`|Doe (1966); Smith (2017)|Doe [1], Smith [2]|
|`\citet[chap.~4]{Doe:1966}`|Doe (1966, 第4章)|Doe [1, 第4章]|`\citet[chap.~4]{Doe:1966,smith2017}`|Doe (1966); Smith (2017, 第4章)|Doe [1], Smith [2, 第4章]|
|`\citep{Doe:1966}`|(Doe, 1966)|[1]|`\citep{Doe:1966,smith2017}`|(Doe, 1966; Smith, 2017)|[1, 2]|
|`\citep[chap.~4]{Doe:1966}`|(Doe, 1966, 第4章)|[1, 第4章]|`\citep[chap.~4]{Doe:1966,smith2017}`|(Doe, 1966; Smith, 2017, 第4章)|[1, 2, 第4章]|
|`\citep[see][]{Doe:1966}`|(参见 Doe, 1966)|[参见 1]|`\citep[see][]{Doe:1966,smith2017}`|(参见 Doe, 1966; Smith, 2017)|[参见 1, 2]|
|`\citep[see][chap.~4]{Doe:1966}`|(参见 Doe, 1966, 第4章)|[参见 1, 第4章]|`\citep[see][chap.~4]{Doe:1966,smith2017}`|(参见 Doe, 1966; Smith, 2017, 第4章)|[参见 1, 2, 第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]|

其他 `natbib` 命令,如 `\citealp``\citealt`,通过抑制括号提供更多灵活性。你可以查阅 [natbib 使用参考表](https://gking.harvard.edu/files/natnotes2.pdf) 以了解所有命令。

## 附录:掌握 `natbib` 的选项

在使用 `natbib` 时,自定义其行为可以让你的工作流程更加顺畅。以下是通过 `\usepackage[options]{natbib}` 可用的选项说明:

| 选项 | 描述 |
|------|------|
|round|显示圆括号|
|square|显示方括号|
|curly|显示花括号|
|angle|显示尖括号|
|semicolon|多个引用之间用分号分隔|
|colon|与分号相同|
|comma|多个引用之间用逗号分隔|
|authoryear|显示作者-年份引用|
|numbers|显示数字引用|
|super|以上标形式显示数字引用|
|sort|按参考文献顺序排序多个引用|
|compress|排序和多个数字引用在适当情况下进行压缩|
|sort&compress|多个数字引用在适当情况下进行压缩|
|longnamesfirst|在第一次引用时显示作者的全名|
|sectionbib|重新定义 `\thebibliography`,将其输出为 `\section` 而不是 `\chapter`|
|nonamebreak|在一行中显示引用的所有作者名称|

### 进一步阅读与资源

- 深入了解文献管理,请阅读 [使用 natbib 进行文献管理](https://www.overleaf.com/learn/latex/Bibliography_management_with_natbib)(Overleaf)。
- 了解不同的文献样式,请访问 [Natbib 文献样式](https://www.overleaf.com/learn/latex/Natbib_bibliography_styles)(Overleaf)。
- 查阅方便的速查表:[natbib 使用参考表](https://gking.harvard.edu/files/natnotes2.pdf)

## 总结

结合 BibTeX 使用 `natbib` 简化了 LaTeX 中的参考文献管理。本指南从基础设置到复杂引用样式进行了全面讲
167 changes: 167 additions & 0 deletions src/content/docs/zh-cn/overleaf.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,167 @@
---
title: "Overleaf:引用与参考文献管理 - LaTeX 参考文献简介"
description: "了解如何在 Overleaf 中使用 BibTeX、Natbib 和 BibLaTeX 管理引用、参考文献和文献目录。并通过 CiteDrive 简化您的工作流程。"
sidebar:
label: 使用 Overleaf(快速入门)
---

import CiteDrive from '@components/CiteDrive.astro';

**Overleaf.com**,这个基于云的 LaTeX 编辑器,是学术文档协作创建和发布的首选平台。它源自 **WriteLaTeX****ShareLaTeX** 的合并,全球拥有超过 1000 万用户。Overleaf 提供了多种预安装的工具和模板,专为学术期刊设计,使其成为研究人员和学者的首选平台。

使用 Overleaf,您可以轻松地通过强大的工具如 **CiteDrive** 来管理引用和参考文献。这一集成简化了您的工作流程,使引用管理变得更加高效。

<CiteDrive />

## 在 Overleaf/LaTeX 中管理参考文献

### 为什么选择 CiteDrive?

**CiteDrive** 是一个强大的引用和参考文献管理工具,与 Overleaf 完美配合。以下是您应该考虑使用 CiteDrive 的原因:

- **无缝集成**:与 Overleaf 以及 BibTeX、Natbib 和 BibLaTeX 等常用参考文献系统完美兼容。
- **提高效率**:自动格式化引用并轻松管理参考文献。
- **用户友好**:提供直观的界面,方便组织和引用参考文献。
- **基于 Web 和协作性强**:随时随地访问和管理您的引用,支持实时协作功能。
[了解更多 CiteDrive 的功能和优势](https://www.citedrive.com)

### BibTeX

BibTeX 是 LaTeX 中广泛使用的参考文献管理系统。要在 Overleaf 中使用 BibTeX:

1. **创建参考文献文件**:在 Overleaf 项目中创建一个名为 `references.bib` 的文件。
2. **添加参考文献**:按以下格式添加参考文献:

```bibtex
@article{AuthorYear,
author = {Author, First and Author, Second},
title = {Title of the Article},
journal = {Journal Name},
volume = {Volume Number},
number = {Issue Number},
pages = {Page Numbers},
year = {Year Published},
publisher = {Publisher Name}
}
```

3. **引用参考文献**:在 LaTeX 文档中添加:

```latex
\bibliography{references}
\bibliographystyle{plain}
```

使用 `\cite{AuthorYear}` 来引用参考文献。

4. **使用 CiteDrive 简化**:通过 CiteDrive 更高效地自动化和管理您的 BibTeX 参考文献。

### Natbib

Natbib 提供了更大的引用格式灵活性。在 Overleaf 中使用 Natbib:

1. **添加命令**:在前言中添加:

```latex
\usepackage{natbib}
\bibliographystyle{plainnat}
```

2. **引用参考文献**:使用 `\citep{AuthorYear}` 进行括号内引用,或使用 `\citet{AuthorYear}` 进行文本内引用。

3. **参考文献**:添加:

```latex
\bibliography{references}
```

4. **使用 CiteDrive 增强**:通过 CiteDrive 简化引用管理和格式化。

### BibLaTeX

BibLaTeX 提供了先进的引用功能。在 Overleaf 中使用 BibLaTeX:

1. **添加命令**:在前言中添加:

```latex
\usepackage[style=authoryear,backend=bibtex]{biblatex}
\bibliography{references}
```

2. **引用参考文献**:使用 `\parencite{AuthorYear}` 进行括号内引用,或使用 `\textcite{Author}` 进行文中引用。

3. **使用 CiteDrive 优化**:通过 CiteDrive 提供的 BibLaTeX 支持,享受更多控制和灵活性。

## LaTeX 基础

对于 LaTeX 新手,以下是一个简短的概述:

```latex
\documentclass{article}
\usepackage{graphicx}
\usepackage{caption}
\usepackage{biblatex}
\addbibresource{references.bib} % 将 "references.bib" 替换为您的参考文献文件
\title{我的第一篇 LaTeX 文档}
\author{您的姓名}
\begin{document}
\maketitle
\section{引言}
这是一个演示 LaTeX 基础的示例文档。
\section{格式化}
您可以将文本格式化为 \textbf{粗体}、\textit{斜体}、\underline{下划线} 或 \texttt{等宽字体}。
\section{列表}
以下是一个项目符号列表的示例:
\begin{itemize}
\item 第一个项目
\item 第二个项目
\item 第三个项目
\end{itemize}
\section{数学公式}
LaTeX 是排版数学公式的好工具。以下是一个公式示例:
\begin{equation}
E = mc^2
\end{equation}
\section{图形与表格}
您可以在文档中插入图形和表格。以下是一个图形示例:
\begin{figure}[ht]
\centering
\includegraphics[width=0.5\textwidth]{example-image}
\caption{一个示例图形}
\label{fig:example}
\end{figure}
以下是一个表格示例:
\begin{table}[ht]
\centering
\begin{tabular}{|c|c|}
\hline
\textbf{项目} & \textbf{数量} \\
\hline
苹果 & 3 \\
橙子 & 5 \\
\hline
\end{tabular}
\caption{一个示例表格}
\label{tab:example}
\end{table}
\section{参考文献}
您可以引用标记过的章节、公式、图形和表格。例如,见图~\ref{fig:example} 和表~\ref{tab:example}。
\section{引用与参考文献}
使用 \cite{author2022} 来引用参考文献。以下是一个引用示例。
\printbibliography
\end{document}
```
Loading

0 comments on commit 476d25a

Please sign in to comment.