Bypass 是一个可以将 markdown 直接渲染为具有样式的文本的 UIView 上的库。它具有样式文本、可点击的链接以及在不同设备方向间平滑切换表示的功能。

此库还有一个 Android 版本，与 相同的内核。

要求

Bypass 需要 iOS 6.0 或更高版本。

用法

选择将 Bypass 集成到项目中：CocoaPods 包含或 git submodule 包含。

参考

• CocoaPods：集成项目
• CocoaPods：Podfile

Git Submodules

您可以在此处找到一个使用 Git submodules 集成 Bypass 的 示例项目。

• 创建 Xcode 项目并 初始化您的 git 仓库。
• 假设您有一个名为 Libraries 的目录，执行以下命令 git submodule add [email protected]:Uncodin/bypass-ios.git Libraries/Bypass
• 执行命令 git submodule update --init --recursive
• 打开您的 Xcode 项目，将 Libraries/Bypass/Bypass.xcodeproj 拖到您的项目中，通过将其拖到 Project Navigator 。
• 导航到您的项目build设置
  • 将 -ObjC 添加到 Other Linker Flags 中
• 导航到您的项目 build 阶段
  • 将 Bypass 添加为目标依赖项
  • 在同一选项卡中，将 QuartzCore.framework、CoreText.framework 和 libBypass.a 添加到要链接的库列表中。

参考

• Git 工具 - Submodules
• Git Submodule Man 页面

用法

Bypass 非常易于使用。以下是一个例子

CGRect markdownRect = CGRectMake(0.f, 0.f, 100.f, 100.f);
BPMarkdownView *markdownView = [[BPMarkdownView alloc] initWithFrame:markdownRect];

NSString *markdown = @"# Hello, world!"
                      ""
                      "This is my text body. There are many like it,     "
                      "but this one is mine.";

[markdownView setMarkdown:markdown];
[[self view] addSubview:markdownView];

您可以直接在 Nib 或 Storyboard 中嵌入一个 BPMarkdownView，但在这样做之前，请确保您已将 Other Linker Flags 配置为包含 -ObjC。