appledoc 是一款用于生成 Objective-C 项目文档的开源工具，可以将代码的注释生成为漂亮的文档，支持 HTML、Docset、Markdown 等格式输出，同时还支持文档主题自定义等功能。
## 原理
appledoc 的原理是通过对 Objective-C 代码的注释进行解析，并根据注释生成文档。在 Objective-C 中，可以使用一种特殊的注释格式，在函数、属性、变量等定义之前使用 `///` 或 `/** */` 开头的注释，这种注释被称为 Doc Comments。appledoc 就是通过解析这些 Doc Comments 来生成文档的。
例如：
```
/**
* This is a sample class with a method.
*
* @discussion This sample class doesn't do much. It just prints a message
* when the `hello` method is called.
*/
@interface SampleClass : NSObject
/**
* Prints a greeting message to the console.
*
* @param name The name used in the greeting message. If `nil` is passed,
* the message is addressed to "world".
*
* @return The greeting message.
*/
- (NSString *)hello:(NSString *)name;
@end
```
在这个例子中，我们使用了 `/** */` 注释格式对类和方法进行了注释，每个注释前面都有一些特殊的标记，例如 `@discussion`、`@param`、`@return` 等，他们对应着每一个不同的信息。这些注释信息就是 appledoc 需要解析的内容，它通过解析这些注释信息，生成类、方法、属性等相关信息的文档。
## 功能
appledoc 提供了丰富的功能，可以满足不同的需求：
- 生成文档: appledoc 可以以 HTML、Docset、Markdown 等格式生成文档，同时支持网页主题和文档主题的自定义。
- 自动生成代码: appledoc 支持根据已有文档生成代码，这样可以方便的维护文档与代码的同步。
- 支持 Markdown: appledoc 支持以 Markdown 格式书写文档，这个功能可以让文档更加容易维护和编辑。
- 支持多种标记: appledoc 支持多种注释标记，包括 @param、@return、@discussion、@property、@ivar 等。
- 自动生成目录: appledoc 可以自动生成文档的目录结构，并且可以根据注释中的标记生成相应的章节。
- 支持多语言: appledoc 支持多国语言输出，可以方便地生成多语言文档。
## 使用
使用 appledoc 生成文档也非常简单，只需要按照以下步骤操作：
1. 下载并安装 appledoc 工具；
2. 排版注释：通过添加注释来解释您的代码。比如：
```
/*!
Some kind of class summary here
*/
@interface MyClass: SomeOtherClass
```
3. 生成文档：然后运行 `appledoc` 命令即可，在 Xcode 中打开 docSet 或使用你自己的文本编辑器。命令示例：
```
appledoc --project-name "MyProject" --project-company "My Company" --company-id com.mycompany.appname
--output "~/help/" --create-html --create-docset --install-docset --publish-docset
--docset-platform-family iphoneos --docset-atom-filename index.xml --docset-feed-url index.atom
--docset-package-url myPackage.tgz ~/Source
```
appledoc 是一个非常实用的工具，可以让我们轻松的生成漂亮的文档，并且可以根据自己的需要进行自定义，是 iOS 开发必备的工具之一。
