大綱

• 學術論文撰寫工具
• Pandoc
  • Pandoc 使用方式
  • Pandoc 與語言學
  • Pandoc 的工具
• Pandoc 的優缺點

關於我

• 清大語言所博士候選人
• 用 Linux 已有十幾年
• 學過 Python 和 Haskell

文書處理器 vs LaTeX

語言學文章的需求

• 嵌入參考文獻
• Syntax trees / Optimality Theory tableaux
• Interlinear glossing
• Cross-referencing
• Unicode （中文、國際音標）

科學家為何要用自由軟體？

• 資料以開放的格式儲存
  • 易匯出、分享
• 價錢
• 個人化

文科：
只有肥宅才會用LaTeX吧！

• 以 Markdown 代 LaTeX！

什麼是 Markdown？

• Markdown 不是程式，
  是文字格式化的方式
• 需要編譯
• 原始檔可以直接看

Markdown 語法

*italic*

**bold**

| foo | bar  |
|-----|------|
| baz | quux |

Markdown 不只一種！

• Pandoc Markdown
• Commonmark
• Github-flavoured Markdown

什麼是 Pandoc？

• 格式轉換神器
• 柏克萊大學教授 John MacFarlane 所創
• 支援 LaTeX 與 Markdown
• 可輸出 PDF、docx、HTML 等等
• 這份簡報：Markdown 轉 reveal.js

Pandoc Markdown 的特色

• YAML metadata blocks
• 參考文獻：透過Bib(La)TeX
• Cross-referencing
• Inline LaTeX: 需要時，可用LaTeX的力量

YAML metadata block

---
title:  'This is the title: it contains a colon'
author:
- Author One
- Author Two
keywords: [nothing, nothingness]
abstract: |
  This is the abstract.

  It consists of two paragraphs.
...

Bibliography with Pandoc

(需要用 pandoc-citeproc 過濾器）

@book{prince2004,
  address = { Malden, MA },
  author = { Prince, Alan and Smolensky, Paul },
  isbn = { 978-1-4051-1932-0 978-1-4051-1933-7 },
  publisher = { Blackwell Pub },
  title = { Optimality Theory: Constraint Interaction in Generative Grammar },
  year = { 2004 },
}

---
bibliography: bibliography.bib
...

Constraints choose an optimal
candidate [@prince2004].

Cross-referencing

(需要用 pandoc-crossref 過濾器）

: Example table {#tbl:foo}

| foo | bar  |
|-----|------|
| baz | quux |

As seen in @tbl:foo, ...

Syntax trees

header-includes: |
  \usepackage{qtree}

\Tree [.S [.NP LaTeX ]
      [.VP [.V is ] [.NP fun ] ] ]

Glossing

header-includes: |
  \usepackage{gb4e}

\begin{exe}
\ex
\gll baru' lah diri' muih munuh ià\\
     then EMPH 1PL.INCL N.allowed N.kill 3\\
\trans `Now we are allowed to kill him.'
\end{exe}

工具一覽

• 文字編輯器
• PDF 輸出：LaTeX + Pandoc

文字編輯器

• Emacs
• Vim
• Notepad++
• Atom
• VS Code

Pandoc

• 命令列介面 (CLI)
• 可另外裝圖形介面

優缺點

如何開始用 Pandoc?

前往 https://pandoc.org/getting-started.html

閱讀說明書 https://pandoc.org/MANUAL.html