1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
|
/*
This source file is part of the Swift.org open source project
Copyright (c) 2021 Apple Inc. and the Swift project authors
Licensed under Apache License v2.0 with Runtime Library Exception
See https://swift.org/LICENSE.txt for license information
See https://swift.org/CONTRIBUTORS.txt for Swift project authors
*/
import Markdown
/// A generic section that contains groups of links.
public protocol GroupedSection: Section {
var taskGroups: [TaskGroup] { get }
}
extension GroupedSection {
/// This section's content split into groups by third-level headings.
public var taskGroups: [TaskGroup] {
// Get the child indices of any level-3 headings
var h3Indices = content.indices.compactMap { index -> Int? in
guard let heading = content[index] as? Heading,
heading.level == 3 else {
return nil
}
return index
}
// An index to support topics that aren't organized in topic groups.
let phantomH3Index = -1
// If there's no level 3 heading at the beginning of the Topics section to demarcate a topic group, insert
// a phantom heading at the start.
if !((content.first as? Heading)?.level == 3) {
h3Indices.insert(phantomH3Index, at: h3Indices.startIndex)
}
// Get the ranges of each task group in terms of child indices of the containing document.
let ranges = zip(h3Indices, Array(h3Indices[1...]) + [content.endIndex]).map { pair in
return (pair.0)..<pair.1
}
// Create a `TaskGroup` for each range. If a task group doesn't have any content underneath it, drop it.
return ranges.compactMap { range in
let heading: Heading?
let content: ArraySlice<Markup>
if range.startIndex == phantomH3Index {
// If we're processing a range of topic links that isn't preceded by a topic group heading, create
// an anonymous task group.
heading = nil
content = self.content[..<range.endIndex]
} else {
heading = self.content[range.startIndex] as? Heading
content = self.content[range.dropFirst()]
}
guard !content.isEmpty else {
return nil
}
return TaskGroup(heading: heading, content: Array(content))
}
}
}
|
