34 lines
3.7 KiB
Markdown
34 lines
3.7 KiB
Markdown
# BaGu Thesis
|
||
|
||
BaGu Thesis是一个专精于将LaTeX论文转换到DOCX格式转换的工具。它凭借Pandoc的文档转换能力，以及一系列附加脚本，来实现高质量的格式转换，特别适用于必须需要提交DOCX格式论文的场景。
|
||
|
||
## 简介和项目创建缘由
|
||
|
||
本项目旨在解决在中国国内高校中普遍存在的一个问题：大多数学校只提供DOCX格式的论文模板，且提交时也只能接受DOCX格式的论文。学校并不认可LaTeX编写的文章，也大多不愿意接受由LaTeX编译来的PDF格式的文档。此外，许多教师也只接受DOCX格式的文档。他们美其名曰"规范化"和"方便给你们添加评价"，实则是他们自己除了DOCX格式的文档以外，就不知道如何在其它文档格式（例如PDF）里添加注释。他们把一个本应专注于学术内容的评审过程，变成了迂腐的格式检查任务。本项目旨在帮助能够使用LaTeX编写论文的学生无痛地将他们的论文转换为DOCX格式，以应付这些无谓的要求。如果你所在的学校或导师接受LaTeX或PDF格式的论文，请优先使用这些格式（我知道的就有西安电子科技大学的XDUTS模板）。毕竟本项目只是为了应付现实而不得不做的妥协。
|
||
|
||
项目中的 **BaGu（八股）** 一词也来源于此现象：在中国，许多对于论文的审查都浪费在格式检查这一隔靴搔痒的事情上。论文格式要严格按照学校规定：页边距多少厘米、字号多少磅、行距多少倍、标题格式如何等等。这些琐碎的格式要求就像八股文一样。说到底，这都是因为论文本身的内容实际上没什么好看的，大家能写出来什么东西大家自己都心知肚明。无非是东拼西凑、复制粘贴、文献堆砌。审查的人们也心知肚明，但他们必须假装认真地审阅论文，于是格式就成了最好的挑刺对象。
|
||
|
||
本项目的存在，就是为了让你能够用LaTeX专注于内容创作，然后用最短的时间生成一个符合格式要求的DOCX文件，把时间浪费在更有意义的事情上：比如思考论文是否真的有意义，或者干脆出去玩一会儿。
|
||
|
||
## 使用方法
|
||
|
||
本项目由两部分组成，它们分别位于`pandoc`和`winword`文件夹中。
|
||
|
||
一般来说，使用`pandoc`中的内容就足以将你的LaTeX文档转换成较为标准的DOCX文档了。但有时候，你的上级会给你发所谓的DOCX模板，这时候你就需要使用`winword`文件夹中提供的方法来将生成的DOCX文档套用到你的DOCX模板之上了。
|
||
|
||
有关如何使用这两部分，请分别查看`pandoc`和`winword`的README文件。
|
||
|
||
## 未来规划
|
||
|
||
该项目未来计划编写专用的格式转换器，该转换器通过中间格式XThesis（基于XML）实现高质量的格式转换，而非依赖于Pandoc。这主要是因为Pandoc生成的DOCX在交叉引用上存在诸多问题，如图片编号、表格编号、公式编号、参考文献引用等。这些在Pandoc转换后往往不符合**纯粹**使用DOCX格式制作论文的规范。例如参考文献的引用，通常是通过交叉引用列表项来实现的，而Pandoc并不能做到这一点，尽管Pandoc生成的引用仍然可以被点击并转到正确引用源。如果一定要做到这一点，则需要编写大量的Pandoc Filter来实现，而我不熟悉Pandoc的API，也不知道这些任务能不能使用Pandoc Filter完成。
|
||
|
||
该计划的进度可在`xthesis`分支中进行浏览，但其远远达不到可供使用的地步。
|
||
|
||
## 许可证
|
||
|
||
本项目采用MIT许可证。
|
||
|
||
## 贡献
|
||
|
||
如果你在使用过程中遇到任何问题，或者有改进建议，欢迎提交Issue和Pull Request。
|