当前位置： 文江博客话题详情

Dave DeLong 将使用哪种 Doxygen 替代品？

发布于 2024-11-01 05:33:52 字数 494 浏览 0 评论 0原文

昨天，Dave DeLong回答了我的一个问题。这不是我正在寻找的答案，但在问题中他提到了另一种为 Objective-C 生成 doxygen 风格文档的方法。

在我真正研究它之前，有人（也许是戴夫本人）注意到答案与问题不太匹配并将其删除。 *噗*那个文档工具的链接消失了。

我不记得这个名字了，但我相当确定它不是 HeaderDoc 也不是 Doxygen 本身。

戴夫，你在外面吗？那个链接又是什么？

原文

Yesterday, Dave DeLong answered a question of mine. It wasn't the answer I was looking for, but in the question he mentioned an alternative way of generating doxygen-style documentation for Objective-C.

Before I could really look into it, someone (maybe Dave himself) noticed the answer didn't match the question that well and removed it. *poof* gone was the link to that documentation tool.

I can't remember the name, but I'm fairly certain it's neither HeaderDoc nor Doxygen itself.

Dave, you out there? What was that link again?

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

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

发布评论

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

评论（1）

虫児飞 2024-11-08 05:33:52

我显然不是 Dave DeLong，但我会使用 appledoc，它是太棒了！

开发者页面报价：

appledoc是命令行工具，帮助Objective-C开发者生成
类似Apple的源代码文档
来自特殊格式的源代码
评论。它的设计目的是作为
可读的源代码注释为
可以输入和使用
评论以及周围的来源
生成具有视觉吸引力的代码
HTML 形式的文档如下
以及完全索引和可浏览
Xcode 文档集。虽然
有几种工具可以
创建 HTML 文档
Objective-C，这些我都知道
未达到最低要求
目标如下所述。

人类可读的源代码 appledoc 旨在保留源代码
代码注释尽可能可读
即使在源代码编辑器中也是如此。

对对象和成员的交叉引用创建对
类、类别或协议是
简单且自动化
尽可能。

类似 Apple 的源代码 HTML 文档 生成吸引人的内容
具有相同风格的 HTML 文档
与苹果的一样。

Xcode 文档集创建生成并安装完全索引和
可浏览的 Xcode 文档集。
文档集也可以
自动安装到 Xcode。

从源代码到文档集的单一工具驱动生成的单一工具
从源码解析到
文档集安装

轻松定制输出 appledoc 为您提供了大量命令
线路开关，以便您可以参数化
输出。如果这还不够，你可以
更改任何或全部模板
文件以满足您的需求。

100% Objective-C 实现 整个 appledoc 是用
Objective-C，让你可以轻松改变
它使用熟悉的语言和工具。
这也使调试变得更加简单
并且有效。

I'm clearly not Dave DeLong, but I'd use appledoc, it's pretty darn awesome!

Developer Page quote:

appledoc is command line tool that helps Objective-C developers generate
Apple-like source code documentation
from specially formatted source code
comments. It's designed to take as
readable source code comments as
possible for the input and use
comments as well as surrounding source
code to generate visually appealing
documentation in the form of HTML as
well as fully indexed and browsable
Xcode documentation set. Although
there are several tools that can
create HTML documentation for
Objective-C, all of those know to me
fall short in meeting the minimum of
goals described below.

Human readable source code appledoc is designed to keep source
code comments as readable as possible
even within your source code editor.

Cross references to objects and members Creating cross references to
classes, categories or protocols is
straightforward and automated as much
as possible.

Apple-like source code HTML documentation Generate appealing
HTML documentation with the same style
as Apple's.

Xcode documentation set creation Generate and install fully indexed and
browsable Xcode documentation sets.
Documentation set can also be
automatically installed to Xcode.

Single tool from sorce code to doc set Single tool to drive generation
from source code parsing to
documentation set installation

Easily customizable output appledoc gives you a lot of command
line switches so you can parameterize
output. If this is not enough, you can
change any or all of the template
files to suit your needs.

100% Objective-C implementation The whole appledoc is written in
Objective-C, so you can easily change
it using familiar language and tools.
This also make debugging much simpler
and effective.

回复 原文
~没有更多了~

关于作者

℡寂寞咖啡

暂无简介

0 文章
0 评论
22 人气
发私信

相关话题

更多

热门标签

操作系统 程序设计 IT运维 Linux系统管理 JavaScript 服务器应用 solaris C/C++ PHP Shell BSD Vue.js aix Oracle Python HTML 系统管理 HTML5 CSS 前端
更多

推荐作者

烙印

文章 0 评论 0

singlesman

文章 0 评论 0

给自己一个微笑

文章 0 评论 0

独孤求败

文章 0 评论 0

晨钟暮鼓

文章 0 评论 0

我是自愿种绣球花的

文章 0 评论 0

更多

友情链接

文江博客
    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站，即表示您同意使用 Cookies 和您的相关数据。
    原文