将源代码示例插入Microsoft Word文档的最佳方法是什么？

Question

我必须编写一些包含源代码示例的文档.一些示例将从IDE编写,其他示例将在适当的位置编写.我的例子主要是Java.

作为习惯于LaTeX的人,在Word中这样做是非常痛苦的.但是,我必须为此而使用Word.我见过的唯一选择是:

1. 写入或复制到文档中,然后使用固定类型的字体,安排格式化,并希望Word没有为您提供大写字母.不用说,这看起来像垃圾.
2. 从IDE复制并粘贴源代码的屏幕截图.至少我保持颜色.但是,如果我改变字体大小,我就搞砸了.我也在页面边界上搞砸了.让我们承认,Word在管理文档上的多个图像方面并不出色.
3. 写HTML(这里不是一个选项)

有没有更好的(和理想的便携式)方法来做到这一点？是否至少有某种类似于LaTeX环境的逐字风格？至少有一些漂亮的打印机可以复制并粘贴为RTF吗？

Answer 1

我绝对讨厌并且鄙视为微软免费工作,考虑到他们仍然没有在他们该死的网站上截获这些数据之类的数十亿美元.

无论如何,这里是Word 2010中的快速指南,使用Notepad ++进行语法着色,以及可以标题为的TextBox:

1. 选择"插入/文本框/简单文本框"
   
2. 将插入默认文本框
   
3. 切换到NPP,选择代码语法着色的语言,转到插件/ NPPExport /复制RTF到剪贴板
   
4. 切换回单词,并粘贴到文本框中 - 它可能太小了......
   
5. ...所以你可能不得不改变它的大小
   
6. 选择文本框后,右键单击它,然后选择"插入标题..."
   
7. 在标题菜单中,如果您还没有,请单击新标签,并将新标签设置为"代码",单击确定...
   
8. ...然后在Caption对话框中,将标签切换为Code,然后单击OK
   
9. 最后,在新创建的标题框中键入标题
   

Answer 2

您需要在Word文档中定义样式并将其用于源代码.我通常有一种称为"代码"的样式,它具有小点大小的等宽字体,固定大小的标签,单行间距,没有前/后段间距等.您只需要定义一次这种样式然后重复使用它.您粘贴源代码并将"代码"样式应用于它.

请注意,在应用程序之间复制/粘贴时,某些编辑器(例如Mac上的Xcode)会将RTF和文本添加到剪贴板 - Word识别RTF并有助于保留格式,语法着色等.

Xcode中的源代码:

复制并粘贴到Word:

(注意:在Word中的"代码"样式中禁用拼写检查是个好主意.)

Answer 3

我最近遇到过这篇文章并发现了一些有用的提示.但是,我最终使用了一种完全不同的方法来满足我的需求.我正在分享我为什么选择这种方法的方法和理由.帖子比我想要的要长,但我相信截图总是有用的.希望答案对某人有用.

我的要求如下:

1. 将代码片段添加到word文档,使用语法突出显示,以便更轻松地查看代码和其他文本.
2. 代码段应与其他文本内联.
3. 代码段应无需任何额外的努力即可顺利打破页面.
4. 代码片段应具有良好的边框.
5. 代码段应禁用拼写检查.

我的方法如下:

1. 使用外部工具实现上面的语法突出显示要求1.如上所述,可以使用记事本加上加号.但是,我使用此处提供的工具 - http://www.planetb.ca/syntax-highlight-word.这使我可以选择使用行号,以及非常好的语法高亮.下面列出了实现语法突出显示的步骤:
   • 在chrome中打开上面提供的网站,然后在文本区域中复制代码段.我将使用示例XML来演示这一点(此处的XML示例 - http://www.service-architecture.com/articles/object-oriented-databases/xml_file_for_complex_data.html).
   • 从下拉菜单中选择语言.
   • 单击"显示突出显示"按钮.它将打开一个新选项卡,其中包含语法突出显示的代码片段,在本例中是我们选择的XML示例.例如,见下图.
   • 要关闭行号,请检查chrome中的页面.然后,在样式下,取消选择".dp-highlighter ol"中的"margin"属性,如下图所示.如果要保留行号,请转到下一步.
   • 选择突出显示语法的代码并单击"复制".现在您的代码已准备好粘贴到Microsoft Word中. 感谢此博客提供此信息 - http://idratherbewriting.com/2013/04/04/adding-syntax-highlighting-to-code-examples-online-and-in-microsoft-word/.

2. 要实现上面的要求2,3和4,请使用Microsoft Word中的表格来插入代码段.步骤如下:

   • 插入包含单列的表格.
   • 在表列中粘贴步骤1中的复制文本.我保留了行号以显示这与Microsoft Word的效果如何.
   • 根据需要应用边框.我用过1pt的尺寸.将显示生成的Microsoft单词代码段,如下面的屏幕截图所示.请注意它在整个页面中的破坏程度 - 管理它不需要额外的工作,如果插入"OpenDocument Text"对象或使用"Simple TextBox",您将面临这种情况.

3. 要达到要求5,请按照以下步骤操作:

   • 选择整个表格或文本.
   • 转到"审核"选项卡.在语言下,选择"校对语言".将会出现一个新的弹出窗口.
   • 选择"不检查拼写或语法".然后,单击"确定".
   • 生成的文本已禁用拼写检查.最终结果如下图所示,符合所有要求.

如果您有任何反馈或改进或遇到任何问题,请提供.

Answer 4

这有点取决于IDE.例如,Visual Studio和Eclipse都允许您复制为RTF并粘贴到Word中,保留所有格式.

Notepad ++有一个名为"NppExport"的插件(预安装)允许你复制到RTF,虽然我不太关心Notepad ++的语法高亮(虽然它肯定是可以通过的).它所做的是支持几十种语言,而上述IDE仅限于少数语言(没有其他插件).

Answer 5

与 Web 插件解决方案相比，这些答案看起来已经过时且相当乏味；自 Office 2013 起可用于产品。

我正在使用Easy Code Formatter，它允许您就地编码文本。它还为您提供行编号选项、突出显示、不同的样式，并且样式在此处开源： https: //github.com/armhil/easy-code-formatter-styles，以便您可以自己扩展样式。要安装 - 打开 Microsoft Word，转到“插入”选项卡/单击“获取加载项”并搜索“Easy Code Formatter”

Answer 6

使用这个 - http://hilite.me/

hilite.me 将您的代码片段转换为印刷精美的 HTML 格式，可轻松嵌入到博客文章、电子邮件和网站中。

如何： 只需将源代码复制到左侧窗格，选择语言和配色方案，然后单击“突出显示！”。现在可以将右侧窗格中的 HTML 粘贴到您的博客或电子邮件中，不需要外部 CSS 或 Javascript 文件。

对于 Microsoft Word 文档：从“预览”部分复制内容并粘贴到您的 Microsoft Word 文档中。

3 个部分：源代码、HTML 和预览