SwiftyMarkdown 项目教程

1. 项目的目录结构及介绍

SwiftyMarkdown 项目的目录结构如下：

SwiftyMarkdown/
├── Example/
│   └── SwiftyMarkdown.playground
├── Resources/
│   ├── SwiftyMarkdown.xcodeproj
│   └── ...
├── Sources/
│   └── SwiftyMarkdown/
│       ├── SwiftyMarkdown.swift
│       └── ...
├── Tests/
│   └── ...
├── fastlane/
│   ├── Fastfile
│   └── ...
├── .gitignore
├── Gemfile
├── Gemfile.lock
├── LICENSE
├── Package.swift
├── README.md
└── SwiftyMarkdown.podspec

目录结构介绍

• Example/: 包含示例项目，展示了如何使用 SwiftyMarkdown 库。
• Resources/: 包含项目的主要资源文件，如 Xcode 项目文件。
• Sources/: 包含 SwiftyMarkdown 库的核心源代码。
• Tests/: 包含项目的测试代码。
• fastlane/: 包含自动化构建和发布相关的配置文件。
• .gitignore: Git 忽略文件配置。
• Gemfile: 用于管理项目依赖的 Ruby 文件。
• Gemfile.lock: 锁定 Gemfile 中依赖的版本。
• LICENSE: 项目的开源许可证文件。
• Package.swift: Swift Package Manager 的配置文件。
• README.md: 项目的说明文档。
• SwiftyMarkdown.podspec: CocoaPods 的配置文件。

2. 项目的启动文件介绍

SwiftyMarkdown 项目的启动文件是 Sources/SwiftyMarkdown/SwiftyMarkdown.swift。这个文件是库的核心入口，包含了主要的 Markdown 解析和转换逻辑。

启动文件介绍

• SwiftyMarkdown.swift: 这个文件定义了 SwiftyMarkdown 类，负责将 Markdown 字符串或文件转换为 NSAttributedString。它包含了各种 Markdown 语法的解析规则和样式设置。

3. 项目的配置文件介绍

SwiftyMarkdown 项目的主要配置文件包括 Package.swift 和 SwiftyMarkdown.podspec。

配置文件介绍

• Package.swift: 这是 Swift Package Manager 的配置文件，定义了项目的依赖关系和构建配置。

  // swift-tools-version:5.3
  import PackageDescription
  
  let package = Package(
      name: "SwiftyMarkdown",
      platforms: [
          .iOS(.v11),
          .macOS(.v10_13),
          .tvOS(.v11),
          .watchOS(.v4)
      ],
      products: [
          .library(
              name: "SwiftyMarkdown",
              targets: ["SwiftyMarkdown"]),
      ],
      dependencies: [],
      targets: [
          .target(
              name: "SwiftyMarkdown",
              dependencies: []),
          .testTarget(
              name: "SwiftyMarkdownTests",
              dependencies: ["SwiftyMarkdown"]),
      ]
  )
  

• SwiftyMarkdown.podspec: 这是 CocoaPods 的配置文件，定义了项目的依赖关系和发布配置。

  Pod::Spec.new do |s|
    s.name             = 'SwiftyMarkdown'
    s.version          = '1.0.0'
    s.summary          = 'Converts Markdown files and strings into NSAttributedStrings with lots of customisation options.'
    s.description      = <<-DESC
  SwiftyMarkdown converts Markdown files and strings into NSAttributedStrings using sensible defaults and a Swift-style syntax.
                         DESC
    s.homepage         = 'https://github.com/SimonFairbairn/SwiftyMarkdown'
    s.license          = { :type => 'MIT', :file => 'LICENSE' }
    s.author           = { 'Simon Fairbairn' => '[e-mail]' }
    s.source           = { :git => 'https://github.com/SimonFairbairn/SwiftyMarkdown.git', :tag => s.version.to_s }
    s.ios.deployment_target = '11.0'
    s.source_files = 'Sources/SwiftyMarkdown/**/*'
  end
  

通过这些配置文件，开发者可以轻松地使用 Swift Package Manager 或 CocoaPods 集成 SwiftyMarkdown 库到他们的项目中。