我需要在 MS-Word 2007 中编写一个包含大量 VB.NET 和 C# 代码示例的文档。
让代码在文档中看起来合理的最佳方法是什么?
人们使用什么风格等等?
(我没有时间手动编辑/格式化代码,如果它看起来与开发工作室中的一样,我会很高兴)
在其他作品中,编写编程书籍的人做了什么,必须有一个很好的自动化解决方案......
我想要一种使用 word 样式表来控制代码的外观的方法,但不希望必须“选择”每个关键字等来设置其样式。
答案1
您可以使用源突出显示服务并复制/粘贴到 Word 文档。我认为这是最快的方法(更新。从 VS 进行简单的复制粘贴也可以)。
第二种方法是创建代码块的样式,保存并应用到所有代码块。
答案2
Word 本身不支持语法高亮或其他代码格式。因此,最好在其他程序(Visual Studio、Eclipse、Notepad++ 或这网站(可支持 14 种语言且无需安装)。
但是,直接在 Word 文档中粘贴文本可能会导致拼写和语法下划线等令人头痛的问题。
要解决此问题,请使用以下方法,而不是直接复制粘贴插入->目的->开放文档文本。这将打开一个新文档。在此处粘贴文本,然后关闭窗口。您的代码现在将显示为一个对象,其中包含上一个窗口中显示的所有格式,但不显示拼写或语法检查。
虽然可以使用样式来格式化代码,但没有内置样式可以做到这一点,而且样式的真正用途也不在于此。如果您想使用样式来格式化代码,只需在您创建的所有对象中使用此样式即可。
更新:如果您想使用代码样式来做到这一点,这里有一些想法。
- 使用等宽字体的段落样式
- 浅色背景(灰色效果很好)
- 拼写检查已关闭
- 确保行距符合您的要求
如果您想增加一点复杂性,您可以在段落样式之上分层添加字符样式,以创建类似于 stackoverflow 上的代码预览的内容,并使用类名、实例名等的不同格式和/或颜色。
设置这样的样式需要一些工作,但是与使用 notepad++ 或 Visual Studio 的语法突出显示相比,您可以获得更加可定制的结果。
为了在使用样式格式化代码时加速,首先在其中一个程序中执行语法突出显示,然后使用 Word 的“查找”实用程序搜索与颜色或其他字体样式匹配的文本,可能会有所帮助,这样您不必手动识别代码中的类名(它位于查找提示中的 more->format 下)。
答案3
我喜欢使用 Notepad++。在 NP++ 中,选择正确的语法,右键单击所选代码,选择“插件命令”,单击“复制带语法高亮的文本”。将其粘贴到 Word 中,您就会得到非常漂亮的代码。