Tag: markdown

如何使您的存储库自述文件看起来不错!

存储库自述文件对我总是很满意。 它们都有不同的风格,包括图像,GIF,徽章,链接等。它们不仅可以看上去,而且可以传达有关该项目进行中的大量信息,并且可以吸引人们的注意力。 可悲的是,我们大多数人,至少在项目开始时,没有浪费时间使我们的回购自述文件大放异彩。 今天,我将向大家展示适合您的回购交易的简便程度,使其看起来比以往更加专业。 免责声明:**这 如果圣诞节和新年前夕之间的一周内上线,则发布。 因此,尽管我可以做一些需要更少时间的事情,但仍然很重要。 继续阅读以了解如何使您的仓库回升。 在..之前很伤心.. =( 您可以在屏幕快照中看到我的Marvels App博客文章存储库的外观。 没有真正的吸引力。 对我而言,这仅是在提醒人们机会不足。 分享有关我的项目和目标的更多信息的机会。 **如果您尚未查看marvel的应用博客文章系列,则可以在这里进行。 您会发现许多有趣的内容,内容涉及如何使用许多不同的pod和工具从头开始创建应用程序,从而使您的生活更轻松。 给我看看更好的.. !! 本自述文件中有几件事正在进行,因此让我介绍一下: 现在它具有徽章,在顶部显示相关信息 它具有锚点导航,允许读者跳至特定部分。 它有一个屏幕截图,显示了应用程序流程以及用户对项目的期望。 它有一个动机部分,回答一些问题,例如: 这是什么? 我为什么要在乎呢? 它与他人有何不同? 这个存储库的目标是什么 ? 它具有发布链接,将链接带到页面。 它具有安装和测试部分,提供有关如何运行这些步骤的说明。 最后但并非最不重要的一个许可证部分,显示代码的可用性 。 这可以像您认为的那样广泛。 您可以使用一些您喜欢的开源项目作为自己存储库的灵感源。 *您可以在这里查看 github上的页面。 自述文件的资源.. 在下面,您可以找到一些资源,这些资源可以在上面提到的仓库转换过程中提供帮助。 去看一下! shields.io是一个了不起的工具。 它允许您粘贴存储库URL,并可以根据您的回购文件推荐徽章。 Shields.io:开源项目的质量元数据徽章 我们提供快速且可扩展的信息图像,作为GitHub,Travis CI,Jenkins,WordPress等的徽章。 Codecov和工作服可以将您的代码覆盖率百分比显示为自定义徽章。 太棒了!! 连续代码覆盖率 连续代码覆盖率。 托管覆盖率报告与GitHub,Bitbucket和GitLab高度集成。 浏览器… codecov.io 工作服 修改说明 coveralls.zendesk.com […]

使用AcceptanceMark自动生成Xcode测试

自动生成测试? 是的,请。 这篇文章展示了如何使用Markdown表为您的软件/应用程序编写业务逻辑 ,以及如何使用名为AcceptanceMark的命令行工具为Xcode 自动生成测试 。 但是首先,一些背景 。 您的代码可能具有以下测试形式: 单元测试 整合测试 验收测试 UI测试 阅读此处 可以很好地了解它们之间的区别。 此外,您可能有一个专门的质量检查小组,并定期手动运行您的应用程序以验证其正确性。 虽然编写好的测试对于构建高质量的软件是必不可少的,但这也需要花费很多时间。 我将向您展示如何更快地测试代码 ,以便您可以将时间花在更重要的事情上! 测试,Xcode方式 在Xcode中,可以通过子类XCTestCase编写单元测试或UI测试 。 假设您的被测系统(SUT)是一种日期格式化程序,需要使用各种可能的语言/输入日期才能正常工作。 测试类可能如下所示: 并将其自动转换为Xcode测试类吗? 好吧, 我已经编写了一个名为AcceptanceMark的工具来 完成该任务 。 只需在终端上运行此命令: amtool -i DateFormattingSimple.md 该工具将生成如下所示的Swift测试文件: 一些观察: 年 , 月 , 日 , 小时 , 分钟 , 第二列被注释为Int 。 AcceptanceMark还不支持将日期作为内置类型使用,但是可以在此处使用单独的组件,以便日期输入与格式无关。 语言列是语言环境标识符字符串。 dateStyle列是一个字符串。 dateStyle和localizedDate之间有一个空列。 这称为分隔符列 。 AcceptanceMark将其前面的所有列均视为输入,并将其之后的所有列均视为输出。 AcceptanceMark始终需要分隔符列 […]

在Swift中记录

我们没有任何借口:记录我们的代码从未如此简单。 Swift工程师做了出色的工作,为我们提供了一种众所周知的简单方式来保持我们的代码记录:标记语言。 我制作了一个信息图,为您提供实现此目的最有用的技巧。 以下是简要概述。 我们需要知道的所有内容可以通过两件事进行综合:如何格式化以及Swift如何组织和显示文档。 如何格式化 我们几乎可以使用任何markdown语法在Swift代码中格式化我们的文档:预定义的标题,强,斜体,项目符号列表,编号列表,链接,嵌入式代码等。 Swift如何组织和显示您的文档 Swift使用以下部分按此顺序组织方法的文档(我们只需要使用正确的关键字来激活可选的关键字即可): 说明(默认):在这里我们可以指定很多东西:作者,版权,警告,注释,版本等。 参数(可选) 退货(可选) 抛出(可选) 例如: 然后,在Option上单击我们的方法或在实用工具栏中选择询问标记时,将显示格式化的文档: 我们还可以使用一些注释标签来分隔代码: //标记: // 去做: // 整我: 例如: 这将显示在我们代码上方的栏中: 我们可以使用Jazzy以精美的方式呈现文档。 坦白地说,为了我们的团队成员或将来的自己,每个人都应该这样做,因为从现在开始的几个月内,他们将与我们自己的代码取得联系。

从plistparsing文本到NSAttributedString

我正在从plist中加载文本,并在我的应用程序中显示它。 理想情况下,我希望能够指定更复杂的格式,例如斜体,粗体和上标文本,并将其显示在自定义标签(如TTTAttributedLabel)中 。 有没有可用的库来parsing给定格式的string(最好是简单的文本格式,如Markdown或Textile)到NSAttributedString中? 我知道解决scheme可用于parsingRTF和HTML,但这是我的需要矫枉过正 – 再加上我希望文本很容易手写。 编辑:这是iOS / UIKit

Markdown NSAttributedString库吗?

既然NSAttributedString在iOS 6中完全受支持,那么是否有一个库将使用降价的NSString并将其转换为NSAttributedString?