您在 Linux 中编程并在 Windows 中编写文档吗?

发布于 2024-09-14 07:32:45 字数 1431 浏览 4 评论 0原文

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(4

自控 2024-09-21 07:32:45

我也会在 Linux 中编写文档。 MS Office 可以使用一些 Wine 衍生物来运行(或者我是这么被告知的),但我宁愿使用 OpenOffice.org< /a> 用于此类文件。

如果您绝对必须使用 Windows,您可以启动虚拟机(使用例如 VirtualBox)并执行脏操作工作的同时仍然可以访问您喜欢的环境。

I would just do the documentation in Linux too. MS Office can be run using some Wine derivative (or so I'm told), but I would rather use OpenOffice.org for such documents.

If you absolutely have to use Windows, you can boot a virtual machine (using e.g. VirtualBox) and do the dirty work while still having access to your preferred environment.

一曲爱恨情仇 2024-09-21 07:32:45

我所在的团队总是在 Linux 中编写文档。 POD 使得编写外观还算可以的手册页变得非常容易,并且可以使用简单的工具 (HTML)、中等复杂的工具 (markdown) 或非常复杂的工具 (LaTeX) 来完成更高级别(“光泽”)的文档。

每个人都有自己的想法,但我会像臭鼬一样避免使用 Office 和 OpenOffice 工具,因为它们与 git、svn、cvs 等的配合非常糟糕。(diffblamemerge 等,只是不适用于大量二进制数据。)

The teams I've been with always write documentation in Linux. POD makes it very easy to write tolerable-looking man pages, and higher-level ("glossy") documentation can be done with simple tools (HTML), moderate-complexity tools (markdown) or with very complex tools (LaTeX).

To each their own, but I'd avoid the Office and OpenOffice tools like a skunk, because they play so poorly with git, svn, cvs, etc. (diff, blame, merge, etc., just don't work with a big binary pile of data.)

上课铃就是安魂曲 2024-09-21 07:32:45

我见过使用过两种选项。

(1) 使用基于网络的文档。示例包括 Google 文档或 wiki。只要您有网络浏览器,就可以查看和编辑文档。

(2)使用跨平台办公套件。我在 Linux 上安装了 OpenOffice.org,它可以打开 Microsoft Office 文件格式,包括新的 .*X 格式。您唯一需要做的就是确保稍后在 Microsoft 产品中打开它,以确保格式仍然良好。

但我个人工作过的每个地方都进行了跨平台开发。在这些情况下,开发计算机通常是 Windows 机器,开发人员要么运行 Linux VM,要么通过 SSH 连接到 Linux 服务器来测试他们在部署环境中的工作。

There are two options that I've seen used.

(1) Use web-based documentation. Examples include Google Docs or a wiki. As long as you have a web browser, you can view and edit the documentation.

(2) Use a cross-platform office suite. I have OpenOffice.org installed on Linux and it can open Microsoft Office file formats, including the new .*X format. The only thing that you need to do is to make sure that you open it in a Microsoft product later to make sure the formatting is still good.

But everyplace that I've personally worked performed cross-platform development. In these cases, the development machines were typically Windows boxes and the developers either ran Linux VMs or SSH'ed into a Linux server to test their work on the deployment environment.

自由如风 2024-09-21 07:32:45

Steve Streeting 写了一篇有趣的 博客文章关于他的技术文档工具链有以下要求:

  • 让作者专注于内容而不是风格
  • 从一个来源生成多种格式(HTML、PDF、手册页、HTML 帮助等)
  • 为您处理所有繁琐的工作,例如目录、交叉引用、源代码突出显示、脚注
  • 对源代码控制系统友好总体差异
  • 足够标准,您可以根据需要将内容提交给发布商
  • 最好是跨平台、基于标准且不面向任何特定语言或技术

Steve Streeting wrote an interesting blog post about his technical documentation tool chain with the following requirements:

  • Lets the author concentrate on content rather than style
  • Generates multiple formats from one source (HTML, PDF, man pages, HTML Help etc)
  • Does all the tedious work for you such as TOCs, cross-references, source code highlighting, footnotes
  • Is friendly to source control systems & diffs in general
  • Standard enough that you could submit the content to a publisher if you wanted to
  • Preferably cross-platform, standards-based and not oriented to any particular language or technology
~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文