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
|
/*
This source file is part of the Swift.org open source project
Copyright (c) 2021-2023 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 Foundation
import Markdown
/**
An introductory section for instructional pages.
*/
public final class Intro: Semantic, AutomaticDirectiveConvertible {
public static let introducedVersion = "5.5"
public let originalMarkup: BlockDirective
/// The title of the containing ``Tutorial``.
@DirectiveArgumentWrapped
public private(set) var title: String
/// An optional video, displayed as a modal.
@ChildDirective
public private(set) var video: VideoMedia? = nil
/// An optional standout image.
@ChildDirective
public private(set) var image: ImageMedia? = nil
/// The child markup content.
@ChildMarkup(numberOfParagraphs: .zeroOrMore)
public private(set) var content: MarkupContainer
static var keyPaths: [String : AnyKeyPath] = [
"title" : \Intro._title,
"video" : \Intro._video,
"image" : \Intro._image,
"content" : \Intro._content
]
override var children: [Semantic] {
return [content, image, video].compactMap { $0 }
}
init(originalMarkup: BlockDirective, title: String, image: ImageMedia?, video: VideoMedia?, content: MarkupContainer) {
self.originalMarkup = originalMarkup
super.init()
self.content = content
self.title = title
self.image = image
self.video = video
}
public override func accept<V: SemanticVisitor>(_ visitor: inout V) -> V.Result {
return visitor.visitIntro(self)
}
@available(*, deprecated, message: "Do not call directly. Required for 'AutomaticDirectiveConvertible'.")
init(originalMarkup: BlockDirective) {
self.originalMarkup = originalMarkup
}
}
|
