2020国产成人精品视频,性做久久久久久久久,亚洲国产成人久久综合一区,亚洲影院天堂中文av色

分享

學(xué)術(shù)論文寫作新武器:Markdown-上篇

 liyu_sun 2021-04-23

?? 連享會主頁:lianxh.cn

?? 論文班·精講8篇論文
?? 2021 年 5.2-4 日
?? 主講:梁平漢(中山大學(xué));張川川 (浙江大學(xué));連玉君 (中山大學(xué))
?? 課程主頁https:///lianxh/paper

New! lianxh 命令發(fā)布了:   GIF 動圖介紹
隨時搜索 Stata 推文、教程、手冊、論壇,安裝命令如下:
? . ssc install lianxh

圖片

作者:初虹 (公眾號「虹鵠山莊」創(chuàng)辦人)
E-mail:20170237402@mail.sdufe.edu.cn

本文源自 「學(xué)術(shù)論文寫作新武器:Markdown」 系列專欄:

  • 學(xué)術(shù)論文寫作新武器:Markdown-上篇
  • 學(xué)術(shù)論文寫作新武器:Markdown-中篇
  • 學(xué)術(shù)論文寫作新武器:Markdown-下篇
圖片

目錄

  • 1. 寫在前面

  • 2. 什么是 Markdown

  • 3. 為什么選擇 Markdown

  • 4. Markdown 編輯器 —— VScode

  • 5. 格式轉(zhuǎn)換的「瑞士軍刀」:Pandoc

    • 5.1 Pandoc 是什么

    • 5.2 下載安裝

    • 5.3 基本使用

  • 6. 參考資料

  • 7. 相關(guān)推文


溫馨提示: 文中鏈接在微信中無法生效。請點擊底部「閱讀原文」?;蛑苯娱L按/掃描如下二維碼,直達(dá)原文:

1. 寫在前面

學(xué)術(shù)論文的寫作工具,除了 Microsoft Word,還有其他的選擇嗎?我在這期文章 還在用 Word 做筆記?Markdown 開啟你更高效工作的第一步! 中推薦了使用 Markdown 作為個人知識體系的書寫載體。作為大多數(shù)人眼中極輕量的排版工具 —— Markdown 也能實現(xiàn)像 Word 那樣豐富的樣式效果嗎?學(xué)術(shù)論文的寫作也可以使用 Markdown 來完成嗎?
?
答案是 —— 能!???? ?

對于搞學(xué)術(shù)的人來說,「寫論文」是吃飯的本事。一般來說,大家(人文社科領(lǐng)域)都會有自己的寫作模板,這個模板通常是 Word 格式,除了論文的基本套路之外,里面還包含了各個標(biāo)題、摘要、圖表等的樣式信息。不少經(jīng)濟學(xué)實證研究者的論文寫作流程是這樣的:先通過 Stata 等計量工具以圖、表的形式輸出結(jié)果,粘貼到模板(DOCX)文件中,完成實證部分;再在模板文件的基礎(chǔ)上「增刪改查」,完成論文其余部分的撰寫。內(nèi)容寫完之后,就是對各種樣式的「無限」調(diào)整了。下一篇論文同樣復(fù)制上面的流程,一遍又一遍。

論文的寫作過程已經(jīng)著實令人頭疼,一篇篇文章格式的調(diào)整更是無比麻煩(好吧,一篇都沒寫出來過????)。論文寫作我們不能自動化,格式調(diào)整的自動化還做不到嗎?

接下來就要請出今天的主角 —— Markdown + Pandoc 。二者配合「食用」助你實現(xiàn) Markdown 寫文、Pandoc 一行命令批量格式轉(zhuǎn)換的效果,這回再有一百篇 Markdown 文章也能同一個樣式轉(zhuǎn)成 Word 或 PDF 了。

一篇學(xué)術(shù)論文的格式通常涉及標(biāo)題、摘要、作者信息、正文、圖片(圖注和編號)、表格(表注和編號)、腳注、數(shù)學(xué)公式、參考文獻(xiàn)、畢業(yè)論文還會有目錄、附錄等。為做演示,我七拼八湊了一篇、力求長相似經(jīng)濟學(xué)實證論文的 Markdown 文章(內(nèi)容莫深究)????

文末提供所有文件的下載鏈接~~

圖片
七拼八湊的、貌似「學(xué)術(shù)論文」的文章
pandoc -F pandoc-crossref --citeproc `
--bibliography=ref.bib `
--csl=china-national-standard-gb-t-7714-2015-numeric.csl `
--reference-doc=ref.docx `
-M reference-section-title='參考文獻(xiàn)' -M link-citations=true `
ref.yaml `
test_paper.md -o test_paper.docx

注:這里的反點號起到折行的作用,可不寫,那樣就會呈現(xiàn)在同一行上。

上面的 Pandoc 語法是本文轉(zhuǎn)換流程的完整命令。這能實現(xiàn)何種效果呢?往下看????

圖片

怎么樣?還不錯是嘛。這行命令具體啥意思、還需要哪些準(zhǔn)備工作?別急,我們一步步來????!

2. 什么是 Markdown

又到了這個老生常談的問題了。自從遇到了 Markdown,感覺寫作明顯輕快了不少,也常常安利,奈何號召力有限,身邊真正去用的還真不多????。既然要用 Markdown 寫學(xué)術(shù)論文,首先你得先弄明白什么是 Markdown。

計算機常見的文件格式主要分為兩種:純文本文件(Plain Text)和二進(jìn)制文件(Binary File)。

最直觀來看,純文本文件可以直接用「記事本」打開,如常見的代碼文件(.c/.py等)、文本文件 .txt 和接下來要介紹的 Markdown .md文件等。純文本文件不保存任何格式設(shè)置、僅顯示字符內(nèi)容,因此無法展示樣式信息。格式分明、樣式豐富的二進(jìn)制文件往往需要專業(yè)的軟件來編寫、瀏覽和維護(hù),內(nèi)存空間占用更大。常見的格式有多媒體文件(圖片、音視頻)、可執(zhí)行程序 .exe 等;值得注意的是,我們?nèi)粘R姷米疃嗟?Word 文檔也屬于二進(jìn)制文件。

不過,對純文本文件(如 MD)進(jìn)行「版本控制」要比二進(jìn)制文件(如 DOCX)容易的多。版本控制是一種記錄一個或若干文件內(nèi)容變化,以便將來查閱特定版本修訂情況的系統(tǒng)。進(jìn)行版本控制不僅有利于「版本回退」、更會讓你了解內(nèi)容發(fā)生了什么樣的變化,同時在文件備份、團隊協(xié)同方面的作用更明顯。

除此之外,也正是由于純文本文件僅顯示字符的特性,使其具有占用內(nèi)存小、打開速度快等優(yōu)點,在計算機世界被廣泛使用。也因此出現(xiàn)了各種各樣的 標(biāo)記語言(Mark-Up Language),以使純文本文件更加易讀。

Markdown 便是眾多標(biāo)記語言中的一員。它允許人們使用易讀易寫的 「純文本格式」 編寫文檔,然后轉(zhuǎn)換成有效的 HTML 格式。由于 Markdown 輕量化、易讀寫的特性,以及對于圖片、圖表、數(shù)學(xué)公式的良好支持,目前 Markdown 已被廣泛應(yīng)用于各大網(wǎng)站和幫助文檔的撰寫中。其基本語法相當(dāng)簡單,十分鐘即可快速上手,不了解的童鞋建議直接看看下面的介紹????

  • Markdown 中文文檔
  • Markdown 指南中文版
  • Markdown 菜鳥教程

?? 2021 效率分析專題
?? 2021 年 5.15-16;5.21-22
?? 主講:龔斌磊(浙江大學(xué));連玉君(中山大學(xué));張寧(暨南大學(xué))
?? 課程主頁https:///lianxh/TE

3. 為什么選擇 Markdown

除了上面介紹的語法簡單、容易上手、可進(jìn)行版本控制等優(yōu)點之外,我們在思考「為什么選擇 Markdown」時,更應(yīng)該想想「為什么不」選擇其他編輯器?比如,Word、LaTeX。

從剛接觸電腦那會兒,我們便與 Microsoft Word 「不期而遇」。憑借其廣泛的流行性,Word 毫無疑問成為大多數(shù)人日常學(xué)習(xí)工作中使用頻率最高的軟件之一。那為什么不選擇 Word 呢?

「流行不代表好用」。即使使用頻率高,我們也深受其苦。Word 的「內(nèi)容和格式分離」設(shè)計使得我們很容易不自覺地調(diào)整文章格式、打斷寫作的連貫性?;蛟S用 Word 寫幾頁的文檔或許還能忍受,但是幾十、上百頁的畢業(yè)論文都用 Word 完成,不是我們先受不了,恐怕 Word 也會先「罷工」。

「易分心」和「易崩潰」的雙重疊加足以促使我「不得不」選擇新工具。

LaTeX 作為極專業(yè)的排版軟件,為什么不選擇它呢?

原因也正在于它「引以為傲」的優(yōu)點 ——— 過于專業(yè)、學(xué)習(xí)曲線太陡峭。當(dāng)然,除了 LaTeX 上手難度高的因素外,目前國內(nèi)人文社科領(lǐng)域尚未形成使用 LaTeX 的氛圍是更重要的原因。當(dāng)下該領(lǐng)域絕大多數(shù)期刊對審稿稿件的格式要求以 Word 和 PDF 為主,提供 LaTeX 模板的期刊極少。在個人寫作中,優(yōu)雅的 LaTeX 帶給自己「沉浸」的體驗;不過一旦放到團隊協(xié)作的模式中,怕是會用 LaTeX 的也沒幾個,交流成本將大幅提高。

您也可以掃碼查看連享會 Markdown 倉庫,獲取更多資源:

https:///arlionn/md

4. 編輯器 —— VScode

確定了語法,還需要一個寫作載體——編輯器。我在這期 推文 中介紹了 馬克飛象、StackEdit、Editor 等幾個在線 Markdown 編輯器和兩個本地編輯器(均可全平臺使用)—— TyporaVisual Studio code

如果你沒有插入?yún)⒖嘉墨I(xiàn)的需求,Typora 應(yīng)該是極佳的選擇。但對于學(xué)術(shù)研究者而言,使用文獻(xiàn)管理軟件(這里僅以 Zotero 為例)插入引文是常事,那更推薦能與 Zotero 聯(lián)動的 VScode 來解決這一學(xué)術(shù)論文寫作的棘手問題。不過如果你使用的是 macOS 系統(tǒng),Typora(或其他 Markdown 編輯器)也不錯,因為搭配 ZotHero(一個 Alfred Workflow)可實現(xiàn)全局搜索 Zotero 數(shù)據(jù)庫并快速復(fù)制引文。考慮到全平臺性,本文僅以 VScode 為例。

關(guān)于 VScode,可以在其 官網(wǎng) 下載;或使用「包管理器」一鍵安裝 choco install vscode 。關(guān)于「包管理器」的具體使用,可以參閱我的個人公眾號推文????虹鵠山莊 |「一行代碼」打通軟件的安裝的所有需求:Windows 系統(tǒng)缺失的包管理器 Chocolatey (備用地址 | 少數(shù)派)

軟件初始界面默認(rèn)語言為英文,需要的話,可以在擴展市場搜索安裝 中文漢化擴展。除此之外,雖然 VScode 原生支持 Markdown,但是想要獲得更地道的體驗,還是得安裝幾個 Markdown 插件,實現(xiàn)實時預(yù)覽、快捷操作等更優(yōu)質(zhì)的體驗。

  • Markdown Preview Enhanced
  • Markdown All in One
圖片

5. 格式轉(zhuǎn)換:Pandoc

到這里,Markdown 部分就介紹差不多了,其準(zhǔn)備工作也基本完成了?;蛟S你也對簡單易用的 Markdown 感興趣了。那么問題來了。我們寫好的論文需要傳給不使用 Markdown 的老師同學(xué)們查看、批閱或者交給期刊編輯們審閱,那 .md 格式就不好用了,有解決之道嗎?

Markdown 格式的文件轉(zhuǎn)換為 Word 或 PDF 格式就輪到另一員大將出馬了,它就是 —— Pandoc,專為各種文本文件「換馬甲」。

5.1 Pandoc 是什么

Pandoc 是加州大學(xué)伯克利分校哲學(xué)系教授 John MacFarlane 于 2006 年使用 Haskell 語言編寫的一款跨平臺、自由開源及命令行界面的標(biāo)記語言轉(zhuǎn)換工具。由于支持的格式眾多,Pandoc 也被譽為文本轉(zhuǎn)換界的「瑞士軍刀」。點擊 這里 你將會看到那張著名 Pandoc 支持的文件格式圖。

5.2 下載安裝

進(jìn)入 Pandoc 官網(wǎng),按需選擇對應(yīng)的版本,點擊下載安裝即可。除了下載安裝包的形式外,更推薦使用「包管理器」一鍵安裝。

  • Windows 系統(tǒng):choco install pandoc / scoop install pandoc / winget install pandoc
  • macOS 系統(tǒng):brew install pandoc
圖片

安裝成功后,可在 ** CMD 或 PowerShell 等命令行窗口** 輸入 pandoc -v 查看版本信息,檢驗是否正確安裝。

圖片

之后我們使用 Pandoc 的所有操作都基于命令行進(jìn)行。

5.3 基本使用

好了,我們先和這個「百變魔王」簡單過下招兒。

  • 查看幫助文檔:pandoc --help、pandoc -h
  • 查看支持的輸入格式:pandoc --list-input-formats
  • 查看支持的輸出格式:pandoc --list-output-formats
  • 基礎(chǔ)使用:
pandoc -f 輸入格式 -t 輸出格式 輸入文件名 -o 輸出文件名

# 比如將當(dāng)前目錄下 Markdown 文件轉(zhuǎn)換為 DOCX 文件
# pandoc -f markdown -t docx test.md -o test.docx

Pandoc 可自動根據(jù)文件名后綴判斷文件類型,所以上述命令可簡化為:

pandoc 輸入文件名 -o 輸出文件名

# Markdown → DOCX:pandoc test.md -o test.docx
# DOCX → PDF:pandoc test.docx -o test.pdf
# IPYNB → HTML:pandoc test.ipynb -o test.html

看到了嗎?「一行代碼」便能實現(xiàn)巨多種文件格式的快速轉(zhuǎn)換,這僅是 Pandoc 的基本功能,若想實現(xiàn)更炫酷的玩法,還得接著往下看~~來個實際場景試試:轉(zhuǎn)換下我文章開頭說的「七拼八湊」的學(xué)術(shù)論文~

pandoc test_paper.md -o test_paper.docx

這是最簡單的、不加任何修飾的 Markdown 轉(zhuǎn) Word,效果怎樣呢?

圖片

嗯,還可、不過并不美觀。最需要調(diào)整應(yīng)該是各個標(biāo)題的顏色、顯示位置、大?。ó?dāng)然,表注、交叉引用編號、參考文獻(xiàn)等進(jìn)階樣式需要特殊語法)。如果僅是格式轉(zhuǎn)換,到這兒或許可以了。但是想要符合學(xué)術(shù)論文寫作的需求,還得再做進(jìn)一步修改。

到這里,或許你即將被勸退????,說好的用 Markdown 寫論文,到這里還僅在準(zhǔn)備階段?!莫慌,為了讓大家對整個流程有更深的理解,我用不少篇幅介紹了背景知識,相信我,接著看下期,好戲來了!你會發(fā)現(xiàn)有 Pandoc 加持的 Markdown,戰(zhàn)斗力早不可同日而語。

下載地址:FavourHong藍(lán)奏云 | https://honghujun./iiDBLo6mp7e

6. 參考資料

  • 如何在 Markdown 中雙語寫作,輸出英文或中文文件?
  • Markdown 寫作,Pandoc 轉(zhuǎn)換:我的純文本學(xué)術(shù)寫作流程
  • pandocmarkdown
  • 王樹義老師 Markdwon2Word - B 站
  • pandoc-crossref
  • 用 Pandoc 生成一篇調(diào)研論文
  • Pandoc 筆記 —— 轉(zhuǎn)化 Markdown 為 PDF
  • Windows 系統(tǒng)缺失的包管理器:Chocolatey、WinGet 和 Scoop
  • 圖床搭配 PicGo:打造高效的圖片處理工作流

7. 相關(guān)推文

Note:產(chǎn)生如下推文列表的 Stata 命令為:
? lianxh Markdown
安裝最新版 lianxh 命令:
? ssc install lianxh, replace

    本站是提供個人知識管理的網(wǎng)絡(luò)存儲空間,所有內(nèi)容均由用戶發(fā)布,不代表本站觀點。請注意甄別內(nèi)容中的聯(lián)系方式、誘導(dǎo)購買等信息,謹(jǐn)防詐騙。如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容,請點擊一鍵舉報。
    轉(zhuǎn)藏 分享 獻(xiàn)花(0

    0條評論

    發(fā)表

    請遵守用戶 評論公約

    類似文章 更多