用 Pandoc 生成一篇調研論文 | Linux 中國

第一行的 @inproceedings{wrigstad2017mastery, 表明瞭出版物 的型別（inproceedings），以及用來指向那篇論文的標簽（wrigstad2017mastery）。

取用這篇題為 “Mastery Learning-Like Teaching with Achievements” 的論文, 輸入：

the achievement-driven learning methodology [@wrigstad2017mastery]

Pandoc 將會輸出：

the achievement- driven learning methodology [30]

這篇論文將會產生像下麵這樣被標號的參考書目：

取用文章的集合也很容易：只要取用使用分號 ; 分隔開被標記的參考文獻就可以了。如果一個取用有兩個標簽 —— 例如： SEABORN201514 和 gamification-leaderboard-benefits—— 像下麵這樣把它們放在一起取用：

Thus, the most important benefit is its potential to increase students' motivation
and engagement [@SEABORN201514;@gamification-leaderboard-benefits].

Pandoc 將會產生：

Thus, the most important benefit is its potential to increase students’ motivation
and engagement [26, 28]

問題案例

一個常見的問題是所需專案與頁面不匹配。不匹配的部分會自動移動到它們認為合適的地方，即便這些位置並不是讀者期望看到的位置。因此在影象或者表格接近於它們被提及的地方時，我們需要調節一下那些元素放置的位置，使得它們更加易於閱讀。為了達到這個效果，我建議使用 figure 這個 LaTeX 環境引數，它可以讓使用者控製影象的位置。

我們看一個上面提到的影象的例子：

![Scatterplot matrix](data/scatterplots/RScatterplotMatrix2.png){#fig:scatter-matrix}

然後使用 LaTeX 重寫：

\begin{figure}[t]
\includegraphics{data/scatterplots/RScatterplotMatrix2.png}
\caption{\label{fig:matrix}Scatterplot matrix}
\end{figure}

在 LaTeX 中，figure 環境引數中的 [t] 選項表示這張圖用該位於該頁的最頂部。有關更多選項，參閱 LaTex/Floats, Figures, and Captions[7] 這篇 Wikibooks 的文章。

產生一篇論文

到目前為止，我們講瞭如何新增和取用（子）章節、影象和參考書目，現在讓我們重溫一下如何生成一篇 PDF 格式的論文。要生成 PDF，我們將使用 Pandoc 生成一篇可以被構建成最終 PDF 的 LaTeX 檔案。我們還會討論如何以 LaTeX，使用一套自定義的模板和元資訊檔案生成一篇調研論文，以及如何將 LaTeX 檔案編譯為最終的 PDF 格式。

很多會議都提供了一個 .cls 檔案或者一套論文應有樣式的模板；例如，它們是否應該使用兩列的格式以及其它的設計風格。在我們的例子中，會議提供了一個名為 acmart.cls 的檔案。

作者通常想要在他們的論文中包含他們所屬的機構，然而，這個選項並沒有包含在預設的 Pandoc 的 LaTeX 模板（註意，可以透過輸入 pandoc -D latex 來檢視 Pandoc 模板）當中。要包含這個內容，找一個 Pandoc 預設的 LaTeX 模板，並新增一些新的內容。將這個模板像下麵這樣複製進一個名為 mytemplate.tex 的檔案中：

pandoc -D latex > mytemplate.tex

預設的模板包含以下程式碼：

$if(author)$
\author{$for(author)$$author$$sep$ \and $endfor$}
$endif$
$if(institute)$
\providecommand{\institute}[1]{}
\institute{$for(institute)$$institute$$sep$ \and $endfor$}
$endif$

因為這個模板應該包含作者的聯絡方式和電子郵件地址，在其他一些選項之間，我們更新這個模板以新增以下內容（我們還做了一些其他的更改，但是因為檔案的長度，就沒有包含在此處）：

latex
$for(author)$
    $if(author.name)$
        \author{$author.name$}
        $if(author.affiliation)$
            \affiliation{\institution{$author.affiliation$}}
        $endif$
        $if(author.email)$
            \email{$author.email$}
        $endif$
    $else$
        $author$
    $endif$
$endfor$

要讓這些更改起作用，我們還應該有下麵的檔案：

讓我們新增論文的元資訊到一個 meta.yaml 檔案：

---
template: 'mytemplate.tex'
documentclass: acmart
classoption: sigconf
title: The impact of opt-in gamification on `\\`{=latex} students' grades in a software design course
author:
- name: Kiko Fernandez-Reyes
  affiliation: Uppsala University
  email: kiko.fernandez@it.uu.se
- name: Dave Clarke
  affiliation: Uppsala University
  email: dave.clarke@it.uu.se
- name: Janina Hornbach
  affiliation: Uppsala University
  email: janina.hornbach@fek.uu.se
bibliography: biblio.bib
abstract: |
  An achievement-driven methodology strives to give students more control over their learning with enough flexibility to engage them in deeper learning. (more stuff continues)
include-before: |
      \` ``{=latex}
      \copyrightyear{2018}
      \acmYear{2018}
      \setcopyright{acmlicensed}
      \acmConference[MODELS '18 Companion]{ACM/IEEE 21th International Conference on Model Driven Engineering Languages and Systems}{October 14--19, 2018}{Copenhagen, Denmark}
      \acmBooktitle{ACM/IEEE 21th International Conference on Model Driven Engineering Languages and Systems (MODELS '18 Companion), October 14--19, 2018, Copenhagen, Denmark}
      \acmPrice{XX.XX}
      \acmDOI{10.1145/3270112.3270118}
      \acmISBN{978-1-4503-5965-8/18/10}
      \begin{CCSXML}
      
      
      10010405.10010489
      Applied computing~Education
      500