This repository provides a comprehensive guide and toolset for writing academic papers in Chinese, such as the localization and sorting of Chinese citations and bibliographies, conversion of Chinese quotation marks, and correcting spaces between Chinese and English characters. With the help of these templates and scripts, you can write your academic papers in Markdown, and convert them into various formats like Word, HTML, LaTeX, PDF, and ePub via Quarto.
- Render Multiple Formats: Render DOCX, HTML, PDF, ePub, and Reveal.js slides at once with the same source file, and PDF can be customized for print or with watermark.
- Localize Chinese Bibliographies: Change
et al.to等and other English localization strings to Chinese in citations and references, both author-date and numeric styles are supported. - Sort Chinese Bibliographies: Sort Chinese bibliographies by Pinyin, and can be customized to sort Chinese entries first or last.
- Correct Chinese Quotes: Tweak Chinese quotes for sophisticated typesetting.
- Correct Spaces: Improve copywriting, correct spaces, words, and punctuations between CJK.
- Extract Bibliographies: Extract all bibliographies cited in the document as a BibTeX/BibLaTeX file.
- Generate Backlinks: Generate backlinks for bibliography entries to the corresponding citations.
- Remove DOI Hyperlinks: Remove DOI hyperlinks formatted by
citeprocif they are not needed in the bibliography.
- Quarto, with Pandoc included, and
you can install TinyTeX via
quarto install tinytex --update-path. - Python, and the following packages:
- R, and the following packages:
Note
Currently Lua filters cannot be run after citeproc in Quarto.
As a workaround, some extensions are run on the command line in the Makefile. This can be improved in the future.
This project uses a Makefile to manage the build process. Here are the available commands:
makeormake all: Render DOCX, HTML, PDF, ePub and Reveal.js slides at once.make docx: Render DOCX.make html: Render HTML.make pdf: Render PDF.make epub: Render ePub.make slides: Render Reveal.js slides.make print: Render PDF for print.make watermark: Render PDF with watermark.make citebib: Extract all bibliographies cited as BibLaTeX filecitebib.bib.make clean: Remove auxiliary and output files.
Tip
These tools can also be used individually in your Pandoc or Quarto project.
- auto-correct: Improve copywriting, correct spaces, words, and punctuations between CJK and English with AutoCorrect.
- citation-backlinks: Generate backlinks for bibliography entries to the corresponding citations.
- confetti: Send some 🎊 in Reveal.js slides.
- cnbib-quotes: Process quotes for Chinese bibliographies in HTML and ePub outputs.
- docx-quotes: Convert straight angle quotation marks to curly quotation marks in DOCX.
- format-md: Preprocess Markdown files for conversion with Quarto.
- get-bib: Extract all bibliographies cited in the document as a BibLaTeX file.
- ignore-softbreaks: Emulate Pandoc’s extension
east_asian_line_breaksin Quarto. - latex-quotes: Replaces straight quotes with German quotes for intermediate in LaTeX output, and specific processing for headers to avoid issues in PDF bookmarks.
- links-to-citations: Remove local links but keep the link text as normal citations.
- localize-cnbib: Localize Chinese bibliographies, change
et al.to等and other English localization strings to Chinese. - remove-doi-hyperlinks: Remove DOI hyperlinks formatted by
citeprocin the bibliography. Disabled by default. To enable it, add-L _extensions/remove-doi-hyperlinks.luato theFILTERSvariable in the Makefile, and remove<text variable="DOI" prefix="DOI: "/>in the CSL file. - remove-spaces: Remove spaces before or after Chinese characters in DOCX.
- sort-cnbib: Sort Chinese bibliographies by Pinyin, and can be customized to sort Chinese entries first or last.
This project is licensed under the MIT License, see the LICENSE file for details.