Appledoc 和自定义链接描述答案

【问题标题】：Appledoc and custom link descriptionAppledoc 和自定义链接描述
【发布时间】：2012-12-14 22:38:04
【问题描述】：

如果我做了一些愚蠢的事情，我很抱歉。但我无法识别我的错误。

这里是代码（头文件）：

#import <Foundation/Foundation.h>

/**
 Represents a cover image. It can be a game cover, a trophy image or even a player avatar.

 It has three properties:

 - **NSMutableString uri**: the link that points to the image.
  - E.g.: [A Skyrim trophy image URI] (http://bit.ly/skyrimTrophyImageUri ).

 - **UIImage img**: the actual image. That is, the bitmap.
  - E.g.: 1A9A3826FB6B42C1B08824655A740620BC8E75F9.PNG

 - **ResolutionType resolution**: the image resolution, which comes from an enumeration of this class called __"ResolutionType"__.
  - E.g: SEN_75x41

*/

@interface NHOCCover : NSObject

结果：

I'm following these instructions (at "Custom link descriptions" section).

我也试过了：

[A Skyrim 奖杯图片 URI] (http://bit.ly/skyrimTrophyImageUri)（不含空格）
[天际奖杯图像 URI] (http://bit.ly/skyrimTrophyImageUri)（带空格）

也许 Xcode 弄乱了文件？关于第二个相关问题，您知道是否有办法阻止 Xcode 在其编辑器中自动创建链接？（我的意思是将字体颜色更改为蓝色并加下划线）。

提前致谢。

【问题讨论】：

标签： ios xcode markdown appledoc

【解决方案1】：

已经在 github 上回答了你，在这里也为来到这个页面的人添加了答案：这是 v2 的已知问题，将在 3.0 中修复。见https://github.com/tomaz/appledoc/issues/180

【讨论】：

【解决方案2】：

/**
 Represents a cover image. It can be a game cover, a trophy image or even a player avatar.

 It has three properties:

 - **NSMutableString uri**: the link that points to the image.
  - E.g.: [A Skyrim trophy image URI] (http://bit.ly/skyrimTrophyImageUri ).

 - **UIImage img**: the actual image. That is, the bitmap.
  - E.g.: 1A9A3826FB6B42C1B08824655A740620BC8E75F9.PNG

 - **ResolutionType resolution**: the image resolution, which comes from an enumeration of this class called __"ResolutionType"__.
  - E.g: SEN_75x41

*/

在您的代码中，[A Skyrim trophy image URI] 和 (http://bit.ly/skyrimTrophyImageUri) 之间有一个空格，我猜是这个空格导致了问题。

正确的格式是

[A Skyrim trophy image URI](http://bit.ly/skyrimTrophyImageUri )

我希望这可以解决您的问题。我知道已经 9 个月了，你问这个，但这可能会帮助其他有类似问题的人。

【讨论】：