Markdown、.bib、LaTeX + Typora、Pandoc 管理论文参考文献

谁践踏了优雅 2023-01-05 05:30 151阅读 0赞

### 文章目录 ###

*  Markdown、.bib、LaTeX + Typora、Pandoc 管理论文参考文献
 *   *  一、为什么选择这样管理参考文献
     *  二、基本使用方式
     *   *  1. 安装 Pandoc
         *  2. 编辑 .bib 文件
         *  3. 编辑源文件 .md
         *  4. 输出目标文件
     *  三、导出目标文件的格式选取
     *  四、导出不同的目标文件格式
     *   *  1.导出为 PDF
         *  2.导出为 HTML
     *  五、BibTex 参数说明
     *   *  1. 条目类型
         *  2. 参数类型
     *  参考文献

# Markdown、.bib、LaTeX + Typora、Pandoc 管理论文参考文献 #

## 一、为什么选择这样管理参考文献 ##

1.  Markdown 排版方便，适合经常码字做笔记，常见的打开工具也很快捷
2.  Typora 跨平台的 Markdown 编辑工具，所写即所得
3.  BibTex1 是用于格式化管理论文的参考文献，一般搭配 LaTeX 使用
4.  可以使用单独的 .bib 文件管理论文的所有参考文献，便于参考文献整理
5.  不用自行调整论文参考文献的格式，可以自动生成
6.  Pandoc 号称为文本格式转换的瑞士军刀，可以将 LaTeX 渲染成不同格式的文本

## 二、基本使用方式 ##

### 1. 安装 Pandoc ###

参考官网安装方式：[Pandoc - Installing pandoc][]

Windows 直接下载点击下一步即可

### 2. 编辑 .bib 文件 ###

在谷歌学术等常见的论文检索平台中直接点击引用格式，选择 **BibTex** 字样的引用格式

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center]

然后就可以得到 .bib 引用格式

![在这里插入图片描述][20210111214713960.png_pic_center]

新建文档 **myRefe.bib**，保留需要用到的所有参考文献

myRefe.bib

@article{deng2014deep,
      title={Deep learning: methods and applications},
      author={Deng, Li and Yu, Dong},
      journal={Foundations and trends in signal processing},
      volume={7},
      number={3--4},
      pages={197--387},
      year={2014},
      publisher={Now Publishers Inc. Hanover, MA, USA}
    }
    
    @article{carrio2017review,
      title={A review of deep learning methods and applications for unmanned aerial vehicles},
      author={Carrio, Adrian and Sampedro, Carlos and Rodriguez-Ramos, Alejandro and Campoy, Pascual},
      journal={Journal of Sensors},
      volume={2017},
      year={2017},
      publisher={Hindawi}
    }
    
    @article{张宾2020探究人工智能时代背景下自然语言处理技术的发展应用,
      title={探究人工智能时代背景下自然语言处理技术的发展应用},
      author={张宾 and 武斌 and 周晶 and 李慧超 and 王帅},
      journal={科技风},
      volume={23},
      year={2020}
    }
    
    @inproceedings{pan2020security,
      title={Security of satellite-based cv-qkd under realistic assumptions},
      author={Pan, Ziwen and Djordjevic, Ivan B},
      booktitle={2020 22nd International Conference on Transparent Optical Networks (ICTON)},
      pages={1--4},
      year={2020},
      organization={IEEE}
    }

### 3. 编辑源文件 .md ###

新建 demo.md

demo.md

# demo
    
    引用第一篇文献[@deng2014deep]
    
    引用第二篇文献[@carrio2017review]
    
    引用第三篇文献[@张宾2020探究人工智能时代背景下自然语言处理技术的发展应用]
    
    引用第四篇文献[@pan2020security]

在 Markdown 文件中使用 `[@参考文献id]` 进行引用对应的参考文献，参考文献id 就是 .bib 文件中的 **大括号的第一个参数**

### 4. 输出目标文件 ###

myRefe.bib 和 demo.md 放到同一目录下，然后在该目录下打开命令行，输入如下命令

pandoc --cite --bibliography=myRefe.bib demo.md -o demo-citation.docx

然后就可以目标文件 demo-citation.docx

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 1]

**注**：这是最简单的导出方式，默认没有格式

## 三、导出目标文件的格式选取 ##

因为一般导出的目标文件的参考文献格式肯定不能是原始那么简单，所有在导出命令中可以加入样式文件

在导出命令中添加参数 `--csl=xxxx.csl`，外部样式文件选取库：[citation-style-language/styles: Official repository for Citation Style Language (CSL) citation styles.][citation-style-language_styles_ Official repository for Citation Style Language _CSL_ citation styles.]

根据期刊选择：[Zotero Style Repository][]、[citation-style-language/journals: Tools and journal metadata for generating dependent CSL styles][citation-style-language_journals_ Tools and journal metadata for generating dependent CSL styles]

例如选择 chinese-gb7714-2005-numeric.csl

pandoc --cite --csl=chinese-gb7714-2005-numeric.csl --bibliography=myRefe.bib demo.md -o demo-citation.docx

生成的目标文件：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 2]

\*\*问题1：\*\*引出的英文文献过多作者写的是 **等** 而不是 **et al** ？？？

修改默认样式文件的参数 `default_locale` 的值修改为 `en` ，再重新导出，然后……你会发现中文的 **等** 又变成了 **et al**

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 3]

这个我目前也没找到合适的解决方法，只能通过 替换 解决了。

## 四、导出不同的目标文件格式 ##

### 1.导出为 PDF ###

导出为 PDF 需要安装 LaTeX引擎，有 pdflatex`，`lualatex`，`xelatex`，`latexmk`，`tectonic`，`wkhtmltopdf`，`weasyprint`，`prince`，`context`，和`pdfroff\`，默认一般用 pdflatex234

pdflatex 是 Tex 的一部分4，所以实际上安装的是 Tex

下载链接：[MiKTeX Page][]、[TeX Live][]

TeX Live安装要很久很久，还是推荐 MiKTeX

我安装的确实是 MiKTeX，然后命令显示 `Try running pandoc with --pdf-engine=xelatex.`，运行如下命令：

pandoc --cite --csl=chinese-gb7714-2005-numeric.csl --bibliography=myRefe.bib demo.md -o demo-citation.pdf --pdf-engine=xelatex

生成的结果如是：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 4]

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 5]

中文文字全部不见了，然后参考了 【5】[使用pandoc转换md为PDF并添加中文支持 - 简书][pandoc_md_PDF_ -]，5结果还是报错

pandoc.exe: Cannot decode byte '\xff': Data.Text.Internal.Encoding.decodeUtf8: Invalid UTF-8 stream

最后参考【6】[使用pandoc xelatex转换md文档为pdf\_Anteoy的博客-CSDN博客][pandoc xelatex_md_pdf_Anteoy_-CSDN]，6验证应该是 xelatex 默认没有中文字体？添加参数 \`-V CJKmainfont=‘Microsoft Yahei UI’，就是设定电脑已有的中文字体，具体可以自行在系统 个性化 中查看

pandoc --cite --csl=chinese-gb7714-2005-numeric.csl --bibliography=myRefe.bib demo.md -o demo-citation.pdf --pdf-engine=xelatex -V CJKmainfont='Microsoft Yahei UI'

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 6]

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 7]

### 2.导出为 HTML ###

直接修改导出文件格式即可

pandoc --cite --csl=chinese-gb7714-2005-numeric.csl --bibliography=myRefe.bib demo.md -o demo-citation.html

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 8]

## 五、BibTex 参数说明 ##

每个条目都包含一个键（Bibtexkey），用于引用或交叉引用该条目。该key是BibTeX条目中的第一项，不属于任何字段。（就是大括号的第一个参数，本示例中的 deng2014deep）

### 1. 条目类型 ###

@后面为该参考文献的类型

**article**

期刊或杂志上的文章。  
必填字段： author, title, journal, year, volume  
可选字段：number, pages, month, doi, note, key

**book**

一本带有明确出版商的书。  
必填字段：author/editor, title, publisher, year  
可选字段：volume/number, series, address, edition, month, note, key, url

**booklet**

印刷和装订的作品，但没有指定的出版商或赞助机构。  
必填字段：title  
可选字段：author, howpublished, address, month, year, note, key

**conference**

同`inproceedings`

**inbook**

书的一部分，通常是无标题的 可能是一章（或小节等）和/或一系列页面。  
必填字段：author/editor, title, chapter/pages, publisher, year  
可选字段：volume/number, series, type, address, edition, month, note, key

**incollection**

书的一部分，具有自己的标题。  
必填字段：author, title, booktitle, publisher, year  
可选字段：editor, volume/number, series, type, chapter, pages, address, edition, month, note, key

**inproceedings**

会议录中的一篇文章。  
必填字段：author, title, booktitle, year  
可选字段：editor, volume/number, series, pages, address, month, organization, publisher, note, key

**manual**

技术文档。  
必填字段：title  
可选字段：author, organization, address, edition, month, year, note, key

**mastersthesis**

一个硕士论文。  
必填字段：author, title, school, year  
可选字段：type, address, month, note, key

**misc**

在没有其他适合的条件下使用。  
必填字段：none  
可选字段：author, title, howpublished, month, year, note, key

**phdthesis**

一个博士学位论文。  
必填字段：author, title, school, year  
可选字段：type, address, month, note, key

**proceedings**

会议记录。  
必填字段：title, year  
可选字段：editor, volume/number, series, address, month, publisher, organization, note, key

**techreport**

由学校或其他机构发布的报告，通常在系列中编号。  
必填字段：author, title, institution, year  
可选字段：type, number, address, month, note, key

**unpublished**

具有作者和标题但未正式发布的文档。  
必填字段：author, title, note  
可选字段：month, year, key

### 2. 参数类型 ###

**address**

发布者的地址（通常只是城市，但可以是鲜为人知的发布者的完整地址）

**annote**

带注释书目样式的注释（非典型）

**author**

作者的姓名（如果一位以上的作者，以分隔`and`）

**booktitle**

书名（如果仅引用其中一部分）

**Email**

作者的电子邮件

**chapter**

章节编号

**crossref**

交叉引用条目的关键字

**doi**

数字对象标识符

**edition**

一本书的版本，长格式（例如“第一”或“第二”）

**editor**

编辑者的姓名

**howpublished**

如果发布方法不规范，则如何发布

**institution**

参与发布的机构，但不一定是发布者

**journal**

作品发表于的杂志或杂志

**key**

一个用于指定或覆盖条目的字母顺序的隐藏字段（缺少“作者”和“编辑”字段时）。请注意，这与用于引用或交叉引用条目的键（在此列表后面刚刚提到）非常不同。

**month**

发布月份（如果未发布，则创建日期）

**note**

其他杂项信息

**number**

期刊，杂志或技术报告的“（发行）编号”（如果适用）。请注意，这不是某些期刊分配的“文章编号”。

**organization**

会议赞助商

**pages**

页号，以逗号或双连字符分隔。

**publishe**

发布者的名字

**school**

撰写论文的学校

**series**

本书出版的系列书籍（例如“ [Hardy Boys][] ”或“[计算机科学讲义][Link 1]”）

**title**

作品名称

**type**

覆盖默认发布类型的字段（例如，针对技术报告的“研究说明”，针对博士论文的“ \{PhD\}学位论文”，针对书本/馆藏的“部分”）

**volume**

期刊或多册书籍的数量

**year**

出版年份（如果未发布，则创建年份）

## 参考文献 ##

--------------------

1.  [BibTeX-维基百科][BibTeX-] ↩︎
2.  [神器Pandoc的安装与使用 · Flyaway’s Blog][Pandoc_ _ Flyaway_s Blog] ↩︎
3.  [Pandoc - Pandoc User’s Guide][Pandoc - Pandoc User_s Guide] ↩︎
4.  [pdftex - Where to download pdflatex.exe? - TeX - LaTeX Stack Exchange][pdftex - Where to download pdflatex.exe_ - TeX - LaTeX Stack Exchange] ↩︎ ↩︎
5.  [使用pandoc转换md为PDF并添加中文支持 - 简书][pandoc_md_PDF_ -] ↩︎
6.  [使用pandoc xelatex转换md文档为pdf\_Anteoy的博客-CSDN博客][pandoc xelatex_md_pdf_Anteoy_-CSDN] ↩︎

[Pandoc - Installing pandoc]: https://www.pandoc.org/installing.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center]: /images/20221119/ba1feb047a84406da308d9e8305e1aca.png
[20210111214713960.png_pic_center]: /images/20221119/e0227a6f68ad497385d4db5a75c9408d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221119/73f1b50a5f8a4e5d8c70e3eb3a230aba.png
[citation-style-language_styles_ Official repository for Citation Style Language _CSL_ citation styles.]: https://github.com/citation-style-language/styles
[Zotero Style Repository]: https://www.zotero.org/styles
[citation-style-language_journals_ Tools and journal metadata for generating dependent CSL styles]: https://github.com/citation-style-language/journals
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 2]: https://img-blog.csdnimg.cn/20210111214753440.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 3]: https://img-blog.csdnimg.cn/20210111214810179.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1,size_16,color_FFFFFF,t_70#pic_center
[MiKTeX Page]: https://miktex.org/
[TeX Live]: https://www.tug.org/texlive/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 4]: https://img-blog.csdnimg.cn/20210111214830990.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 5]: https://img-blog.csdnimg.cn/20210111214840886.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1,size_16,color_FFFFFF,t_70#pic_center
[pandoc_md_PDF_ -]: https://www.jianshu.com/p/7f9a9ff053bb?utm_campaign=maleskine&utm_content=note&utm_medium=seo_notes&utm_source=recommendation
[pandoc xelatex_md_pdf_Anteoy_-CSDN]: https://blog.csdn.net/yan_chou/article/details/79331407
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 6]: https://img-blog.csdnimg.cn/20210111214900493.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 7]: https://img-blog.csdnimg.cn/20210111214912925.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1_size_16_color_FFFFFF_t_70_pic_center 8]: https://img-blog.csdnimg.cn/20210111214949850.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NTY0NTU1,size_16,color_FFFFFF,t_70#pic_center
[Hardy Boys]: https://en.wikipedia.org/wiki/The_Hardy_Boys
[Link 1]: https://en.wikipedia.org/wiki/Lecture_Notes_in_Computer_Science
[BibTeX-]: https://en.wikipedia.org/wiki/BibTeX
[Pandoc_ _ Flyaway_s Blog]: http://zhouyichu.com/misc/Pandoc/
[Pandoc - Pandoc User_s Guide]: https://pandoc.org/MANUAL.html
[pdftex - Where to download pdflatex.exe_ - TeX - LaTeX Stack Exchange]: https://tex.stackexchange.com/questions/49569/where-to-download-pdflatex-exe