MS Word 轨道更改和 RMarkDown [英] MS Word track changes and RMarkDown

问题描述

我尝试使用 R Markdown 编写所有数据分析报告，因为我可以有一个可复制的文档，可以以多种输出格式(Pdf、html 和 MS Word)共享.

I try to write all data analysis reports using R Markdown, because I can have a reproducible document that I can share in several output formats (Pdf, html and MS Word).

然而，我的大多数同事都使用 MS Word，他们对 R、Markdown 等一无所知.

However, most of my colleagues use MS Word and they have no idea about R, Markdown, etc.

使用 R Markdown 的一个优势是我可以在 MS Word 中生成我的报告并直接与我的同事分享.

One advantage of using R Markdown is that I can generate my report in MS Word and directly share it with my colleagues.

缺点是协作对我来说变得很麻烦，因为我也会收到有关 MS Word 的反馈(通常使用跟踪更改)，而且我必须手动将这些更改重新引入 .rmd 文件.

The disadvantage is that collaboration becomes cumbersome for me, because I receive feedback on MS Word as well (typically using track changes) and I have to manually introduce those changes back into the .rmd file.

所以，我的问题是:如何简化将 MS Word 文档中的更改放入 .Rmd 的过程(即尽可能自动化)?

So, my question is: how can I simplify the process (i.e. make it as automatic as possible) of getting the changes in the MS Word document into the .Rmd?

有什么工具可以帮助我吗?

Are there any tools out there that can help me out?

P.s.让我的同事成为 R-literate 不是一种选择:(

P.s.getting my colleagues to become R-literate is not an option :(

推荐答案

我还没有尝试我提出的方案，但这是我计划如何处理这个问题，因为我有完全相同的需求.首先，有两种不同的情况:

I haven't yet tried what I'm proposing, but here is how I plan to handle this, since I have exactly the same need. First, there are two distinct scenarios:

1. 我是主要作者，或者我负责统计分析:我将要求所有合作者学习和使用 Markdown(不是 R Markdown，只是通用 Markdown)，我会指导他们不要接触任何 R 代码.我相信 Markdown 很容易，任何有能力通过数据分析合作撰写文章的人都更有能力学习 Markdown.为了教授他们，熟悉使用 Microsoft Word 和跟踪更改的人员的主要功能如下:
   • 基本降价参考:我会给他们核心的 R Markdown 参考，即他们的 Pandoc Markdown 文档及其R Markdown 备忘单.
   • 跟踪更改:协作者只需以纯文本形式编辑降价并提交编辑后的版本.要查看和协调差异，我会简单地使用差异工具；我会找到一个好的在线工具来教我的合作者如何区分更改.
   • 作者之间的评论:我会选择降价评论选项之一a> 并教我的合作者在需要时使用它.修改后的 HTML 注释(<!--- Pandoc-enhanced HTML 注释 -->)是我可能会使用的.
   • 参考管理:我使用 Zotero，所以我会使用 用于 Zotero 的更好的 BibTeX 来处理引用.这样做的好处是，虽然我必须自己处理引用，但协作者可以直接添加对 Zotero 组库的引用.事实上，使用引用键，协作者应该很容易学会如何将引用自己插入到 Markdown 文本中.

1. I am the lead author, or I am responsible for the statistical analysis: I will require all collaborators to learn and use markdown (not R Markdown, just generic markdown) and I'll instruct them not to touch any R code. I believe markdown is easy enough that anyone who is competent enough to collaborate on an article with data analysis is more than competent to learn markdown. For teaching them, the key features for people familiar with working with Microsoft Word and track changes are the following:
   • Basic markdown references: I would give them the core R Markdown references, which are their Pandoc Markdown documentation and their R Markdown cheat sheet.
   • Track changes: Collaborators would simply edit the markdown in plain text and submit their edited version. To view and reconcile differences, I would simply use a diff tool; I would find a good online one to teach my collaborators how to diff changes.
   • Comments between authors: I would select one of the options for markdown comments and teach my collaborators to use that when needed. The modified HTML comment (<!--- Pandoc-enhanced HTML comment -->) is the one I would probably use.
   • Reference management: I use Zotero, so I would use Better BibTeX for Zotero to handle references. The nice thing about this is that although I would have to handle the references myself, collaborators can directly add references to the Zotero group library. In fact, using citation keys, it should be simple for collaborators to learn how to insert references themselves into the markdown text.

我想指出，似乎唯一不那么容易的部分(与 Microsoft Word 的正常工作功能相比)是用 diff 替换轨道更改.我不知道有什么工具可以让合并 diff 文件像 Word 协调更改一样简单，但如果存在这样的工具，那么这个过程应该更加无缝.

I want to note that it seems that the only part that seems to be not so easy (compared to Microsoft Word normal working features) is replacing track changes with diff. I'm not aware of a tool that makes incorporating diff files as easy as how Word reconciles changes, but if such a tool exists, then the process should be more seamless.

这篇关于MS Word 轨道更改和 RMarkDown的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！