iOS和macOS上将NSAttributedString转换为.docx Word文件

# DocX DocX是一个小型框架，用于在iOS和macOS上将NSAttributedString转换为.docx Word文件。 ## 动机 在iOS上，`NSAttributedString.DocumentType`仅支持HTML和富文本，而在macOS上可用的选项是.doc和.docx。即使在macOS上，.docx导出器也仅支持NSAttributedString的一部分属性。 该库用于[SimpleFurigana for macOS](https://itunes.apple.com/de/app/simple-furigana/id997615882?l=en&mt=12)和[SimpleFurigana for iOS](https://itunes.apple.com/de/app/simple-furigana/id924351286?l=en&mt=8)中，因此重点关注挂注（furigana）的导出。 ## 安装 在您的`Package.swift`文件的`dependencies`中添加： ``` swiftCopy code .package(name: "DocX", url: "https://github.com/shinjukunian/DocX.git", .branch("master")) ``` 这需要Swift 5.3，该版本随Xcode12一起发布。 或者，在Xcode中通过`File->Swift Packages->Add Package Dependency`添加`DocX`，粘贴`https://github.com/shinjukunian/DocX.git`作为URL，并指定`master`作为分支。 ## 用法 ``` swiftCopy code let string = NSAttributedString(string: "This is a string", attributes: [.font: UIFont.systemFont(ofSize: UIFont.systemFontSize), .backgroundColor: UIColor.blue]) let url = URL(fileURLWithPath:"myPath") try? string.writeDocX(to: url) ``` 您还可以使用`DocXOptions`指定元数据： ``` swiftCopy code let font = NSFont(name: "Helvetica", size: 13)! //on macOS let string = NSAttributedString(string: "The Foundation For Law and Government favours Helvetica.", attributes: [.font: font]) var options = DocXOptions() options.author = "Michael Knight" options.title = "Helvetica Document" let url = URL(fileURLWithPath:"myPath") try string.writeDocX(to: url, options:options) ``` 请参阅附带的示例项目（iOS和macOS）以了解用法和限制。 在iOS上，DocX还包括一个`UIActivityItemProvider`子类（`DocXActivityItemProvider`），用于通过`UIActivityViewController`导出.docx文件。 `NSAttributedString`没有分页的概念。对于手动分页，请使用： ``` swiftCopy code try DocXWriter.write(pages:[NSAttributedString], to url:URL) ``` 将每个`NSAttributedString`呈现为单独的页面。