Date
Nov. 21st, 2024
 
2024年 10月 21日

Post: AppleDoc: Docset Generator

AppleDoc: Docset Generator

Published 12:12 Dec 29, 2015.

Created by @ezra. Categorized in #Programming, and tagged as #iOS.

Source format: Markdown

Table of Content

Appledoc 是一个命令行工具,用来生成 .docset 文件。

  • 文档风格默认与苹果保持一致的。

  • 开源

  • 生成 docset 并自动集成到 Xcode

  • 没有特殊的注释要求,可以用 /** */ 的格式,也兼容 /*! */ 格式

Installnation

直接使用 brew 即可: brew install appledoc

Usage

常用的指令是这样的:

appledoc 项目路径 -o 输出路径 -p 项目名 -c 公司名

命令执行完毕后会在给定的输出目录生成 docset-installed.txt 文件,其中标明了文档所在位置,默认集成到 ~/Library/Developer/Shared/Documentation/DocSets/ 路径下。

现在,打开 Xcode 并在菜单中选择 Window - Documentation and API Reference 打开文档浏览器即可看到刚才生成的文档了。

Pinned Message
HOTODOGO
The Founder and CEO of Infeca Technology.
Developer, Designer, Blogger.
Big fan of Apple, Love of colour.
Feel free to contact me.
反曲点科技创始人和首席执行官。
开发、设计与写作皆为所长。
热爱苹果、钟情色彩。
随时恭候 垂询