jazzy 0.12.0 → 0.13.4
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.circleci/config.yml +3 -3
- data/.gitignore +1 -0
- data/CHANGELOG.md +159 -0
- data/CONTRIBUTING.md +1 -1
- data/Gemfile.lock +50 -41
- data/README.md +23 -0
- data/Rakefile +25 -0
- data/bin/sourcekitten +0 -0
- data/images/math.png +0 -0
- data/jazzy.gemspec +3 -3
- data/js/package-lock.json +39 -0
- data/js/package.json +17 -0
- data/lib/jazzy/config.rb +34 -3
- data/lib/jazzy/doc.rb +4 -0
- data/lib/jazzy/doc_builder.rb +44 -19
- data/lib/jazzy/docset_builder.rb +2 -0
- data/lib/jazzy/docset_builder/info_plist.mustache +8 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_AMS-Regular.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_AMS-Regular.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_AMS-Regular.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Caligraphic-Bold.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Caligraphic-Bold.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Caligraphic-Bold.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Caligraphic-Regular.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Caligraphic-Regular.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Caligraphic-Regular.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Fraktur-Bold.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Fraktur-Bold.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Fraktur-Bold.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Fraktur-Regular.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Fraktur-Regular.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Fraktur-Regular.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Main-Bold.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Main-Bold.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Main-Bold.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Main-BoldItalic.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Main-BoldItalic.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Main-BoldItalic.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Main-Italic.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Main-Italic.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Main-Italic.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Main-Regular.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Main-Regular.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Main-Regular.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Math-BoldItalic.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Math-BoldItalic.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Math-BoldItalic.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Math-Italic.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Math-Italic.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Math-Italic.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_SansSerif-Bold.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_SansSerif-Bold.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_SansSerif-Bold.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_SansSerif-Italic.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_SansSerif-Italic.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_SansSerif-Italic.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_SansSerif-Regular.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_SansSerif-Regular.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_SansSerif-Regular.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Script-Regular.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Script-Regular.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Script-Regular.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Size1-Regular.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Size1-Regular.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Size1-Regular.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Size2-Regular.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Size2-Regular.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Size2-Regular.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Size3-Regular.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Size3-Regular.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Size3-Regular.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Size4-Regular.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Size4-Regular.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Size4-Regular.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Typewriter-Regular.ttf +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Typewriter-Regular.woff +0 -0
- data/lib/jazzy/extensions/katex/css/fonts/KaTeX_Typewriter-Regular.woff2 +0 -0
- data/lib/jazzy/extensions/katex/css/katex.min.css +1 -0
- data/lib/jazzy/extensions/katex/js/katex.min.js +1 -0
- data/lib/jazzy/gem_version.rb +1 -1
- data/lib/jazzy/jazzy_markdown.rb +20 -4
- data/lib/jazzy/podspec_documenter.rb +15 -3
- data/lib/jazzy/source_declaration.rb +32 -0
- data/lib/jazzy/source_declaration/access_control_level.rb +1 -1
- data/lib/jazzy/source_declaration/type.rb +8 -0
- data/lib/jazzy/source_mark.rb +11 -0
- data/lib/jazzy/source_module.rb +2 -1
- data/lib/jazzy/sourcekitten.rb +222 -80
- data/lib/jazzy/stats.rb +4 -0
- data/lib/jazzy/themes/apple/assets/css/jazzy.css.scss +40 -4
- data/lib/jazzy/themes/apple/assets/js/jazzy.js +12 -1
- data/lib/jazzy/themes/apple/assets/js/jquery.min.js +2 -2
- data/lib/jazzy/themes/apple/templates/doc.mustache +6 -0
- data/lib/jazzy/themes/apple/templates/task.mustache +6 -5
- data/lib/jazzy/themes/fullwidth/assets/css/jazzy.css.scss +38 -8
- data/lib/jazzy/themes/fullwidth/assets/js/jazzy.js +12 -1
- data/lib/jazzy/themes/fullwidth/assets/js/jquery.min.js +2 -2
- data/lib/jazzy/themes/fullwidth/assets/js/lunr.min.js +6 -1
- data/lib/jazzy/themes/fullwidth/assets/js/typeahead.jquery.js +34 -14
- data/lib/jazzy/themes/fullwidth/templates/doc.mustache +7 -1
- data/lib/jazzy/themes/fullwidth/templates/task.mustache +6 -5
- data/lib/jazzy/themes/jony/assets/css/jazzy.css.scss +39 -4
- data/lib/jazzy/themes/jony/assets/js/jazzy.js +12 -1
- data/lib/jazzy/themes/jony/assets/js/jquery.min.js +2 -2
- data/lib/jazzy/themes/jony/templates/doc.mustache +6 -0
- data/lib/jazzy/themes/jony/templates/task.mustache +6 -5
- metadata +71 -5
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: e6614bb5a4465f50a9f0188ec56ad872d82963245f790c1815b650452be8d652
|
4
|
+
data.tar.gz: d807b40f914ca121eeaf8ff72016300f9da340f54aeeab310319a40c1bb90d3b
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: cedba7374e64a603835c5270b1dcd57d79b79536fd9bc434995e35c223f55c6b100628296233e7370c7b8ebf4fba545475c7aac2f51510d8437dcb8a86aa3230
|
7
|
+
data.tar.gz: 6260815f7523b409fc6af6e4ce15a543f101e8bb85cf196a5dc4c0e6125efc77241e422de8a44f5925d587b83d825e076eb209d24fea04311f57b120b218ef89
|
data/.circleci/config.yml
CHANGED
@@ -17,7 +17,7 @@ jobs:
|
|
17
17
|
|
18
18
|
swift:
|
19
19
|
macos:
|
20
|
-
xcode: "11.
|
20
|
+
xcode: "11.4.0"
|
21
21
|
environment: *bundler-environment
|
22
22
|
steps:
|
23
23
|
- checkout
|
@@ -29,7 +29,7 @@ jobs:
|
|
29
29
|
|
30
30
|
objc:
|
31
31
|
macos:
|
32
|
-
xcode: "11.
|
32
|
+
xcode: "11.4.0"
|
33
33
|
environment: *bundler-environment
|
34
34
|
steps:
|
35
35
|
- checkout
|
@@ -41,7 +41,7 @@ jobs:
|
|
41
41
|
|
42
42
|
cocoapods:
|
43
43
|
macos:
|
44
|
-
xcode: "11.
|
44
|
+
xcode: "11.4.0"
|
45
45
|
environment: *bundler-environment
|
46
46
|
steps:
|
47
47
|
- checkout
|
data/.gitignore
CHANGED
data/CHANGELOG.md
CHANGED
@@ -1,3 +1,162 @@
|
|
1
|
+
## 0.13.4
|
2
|
+
|
3
|
+
##### Breaking
|
4
|
+
|
5
|
+
* None.
|
6
|
+
|
7
|
+
##### Enhancements
|
8
|
+
|
9
|
+
* Update JavaScript libraries: jQuery 3.5.1 (all themes), Lunr 2.3.8,
|
10
|
+
typeahead.js 1.3.1 (`fullwidth` theme only).
|
11
|
+
[John Fairhurst](https://github.com/johnfairh)
|
12
|
+
|
13
|
+
##### Bug Fixes
|
14
|
+
|
15
|
+
* Fix warnings from Ruby 2.7.
|
16
|
+
[John Fairhurst](https://github.com/johnfairh)
|
17
|
+
[#1185](https://github.com/realm/jazzy/issues/1185)
|
18
|
+
|
19
|
+
* Accept `root_url` without trailing slash.
|
20
|
+
[John Fairhurst](https://github.com/johnfairh)
|
21
|
+
[#1188](https://github.com/realm/jazzy/issues/1188)
|
22
|
+
|
23
|
+
## 0.13.3
|
24
|
+
|
25
|
+
##### Breaking
|
26
|
+
|
27
|
+
* None.
|
28
|
+
|
29
|
+
##### Enhancements
|
30
|
+
|
31
|
+
* Added a config option to provide sources of privately hosted pod
|
32
|
+
dependencies when using the `--podspec` option.
|
33
|
+
`--pod-sources url1,url2,…urlN`.
|
34
|
+
[Jonathan Bailey](https://github.com/jon889)
|
35
|
+
[#650](https://github.com/realm/jazzy/issues/650)
|
36
|
+
|
37
|
+
* Improve Dash docset support: support online redirection when
|
38
|
+
`--root-url` is set, and provide `--docset-playground-url` to
|
39
|
+
support docset playground links.
|
40
|
+
[John Fairhurst](https://github.com/johnfairh)
|
41
|
+
|
42
|
+
##### Bug Fixes
|
43
|
+
|
44
|
+
* Fix module version not being used from podspec.
|
45
|
+
[Jonathan Bailey](https://github.com/jon889)
|
46
|
+
|
47
|
+
* Autolink Swift custom attributes/property wrappers.
|
48
|
+
[John Fairhurst](https://github.com/johnfairh)
|
49
|
+
|
50
|
+
## 0.13.2
|
51
|
+
|
52
|
+
##### Breaking
|
53
|
+
|
54
|
+
* None.
|
55
|
+
|
56
|
+
##### Enhancements
|
57
|
+
|
58
|
+
* Support Xcode 11.4. Default Objective-C property attributes are now
|
59
|
+
stripped from declarations: turn this off with
|
60
|
+
`--keep-default-property-attributes`.
|
61
|
+
[John Fairhurst](https://github.com/johnfairh)
|
62
|
+
[#829](https://github.com/realm/jazzy/issues/829)
|
63
|
+
|
64
|
+
* Render LaTeX expressions written using `$equation$` or `$$equation$$`
|
65
|
+
syntax.
|
66
|
+
[Arthur Guiot](https://github.com/arguiot)
|
67
|
+
[John Fairhurst](https://github.com/johnfairh)
|
68
|
+
[#1156](https://github.com/realm/jazzy/issues/1156)
|
69
|
+
|
70
|
+
* Wrap long method names on category pages. Use `name_html` in custom
|
71
|
+
mustache templates to take advantage of this.
|
72
|
+
[John Fairhurst](https://github.com/johnfairh)
|
73
|
+
[#995](https://github.com/realm/jazzy/issues/995)
|
74
|
+
|
75
|
+
* Support Dash-style `apple_ref` links to specific API items, for more
|
76
|
+
stable and human-readable links from external docs.
|
77
|
+
[Paul Cantrell](https://github.com/pcantrell)
|
78
|
+
|
79
|
+
##### Bug Fixes
|
80
|
+
|
81
|
+
* Don't generate documentation if the `xcodebuild` command fails.
|
82
|
+
[John Fairhurst](https://github.com/johnfairh)
|
83
|
+
[jpsim/SourceKitten#643](https://github.com/jpsim/SourceKitten/issues/643)
|
84
|
+
|
85
|
+
* Use multi-line parsed declarations in more places including protocol
|
86
|
+
methods and typealiases.
|
87
|
+
[John Fairhurst](https://github.com/johnfairh)
|
88
|
+
[#896](https://github.com/realm/jazzy/issues/896)
|
89
|
+
|
90
|
+
## 0.13.1
|
91
|
+
|
92
|
+
##### Breaking
|
93
|
+
|
94
|
+
* None.
|
95
|
+
|
96
|
+
##### Enhancements
|
97
|
+
|
98
|
+
* Allow inline html tags in ObjC doc comments.
|
99
|
+
[Chris Williams](https://github.com/ultramiraculous)
|
100
|
+
[#976](https://github.com/realm/jazzy/issues/976)
|
101
|
+
|
102
|
+
* Support code formatting in ObjC doc comments with `@c`, `@code` and
|
103
|
+
`@endcode`.
|
104
|
+
[Bryce Pauken](https://github.com/brycepauken)
|
105
|
+
[jpsim/SourceKitten#631](https://github.com/jpsim/SourceKitten/issues/631)
|
106
|
+
|
107
|
+
* Add `custom_categories_unlisted_prefix` configuration setting. This
|
108
|
+
is the prefix for navigation section names that aren't explicitly
|
109
|
+
listed in `custom_categories`. Defaults to 'Other '.
|
110
|
+
[JP Simard](https://github.com/jpsim)
|
111
|
+
|
112
|
+
* Add `hide_unlisted_documentation` configuration setting. Setting this
|
113
|
+
to `true` hides documentation entries in the sidebar from the
|
114
|
+
`documentation` config value that aren't explicitly listed in
|
115
|
+
`custom_categories`.
|
116
|
+
[JP Simard](https://github.com/jpsim)
|
117
|
+
|
118
|
+
##### Bug Fixes
|
119
|
+
|
120
|
+
* Fix crash when SourceKit returns out of bounds string byte offsets.
|
121
|
+
[JP Simard](https://github.com/jpsim)
|
122
|
+
|
123
|
+
* Pick the right version of declarations with type attributes.
|
124
|
+
[John Fairhurst](https://github.com/johnfairh)
|
125
|
+
[#1148](https://github.com/realm/jazzy/issues/1148)
|
126
|
+
|
127
|
+
## 0.13.0
|
128
|
+
|
129
|
+
##### Breaking
|
130
|
+
|
131
|
+
* None.
|
132
|
+
|
133
|
+
##### Enhancements
|
134
|
+
|
135
|
+
* Add section headings for members added by Swift conditional conformances.
|
136
|
+
[John Fairhurst](https://github.com/johnfairh)
|
137
|
+
[#717](https://github.com/realm/jazzy/issues/717)
|
138
|
+
|
139
|
+
* Parse markdown in MARK comments, make the html available to themes via
|
140
|
+
`name_html` mustache tag key for section headings.
|
141
|
+
[John Fairhurst](https://github.com/johnfairh)
|
142
|
+
|
143
|
+
* Include protocol conformances added by extensions in Swift docs.
|
144
|
+
[John Fairhurst](https://github.com/johnfairh)
|
145
|
+
|
146
|
+
##### Bug Fixes
|
147
|
+
|
148
|
+
* Render bullet lists correctly when followed by a callout.
|
149
|
+
[John Fairhurst](https://github.com/johnfairh)
|
150
|
+
[#785](https://github.com/realm/jazzy/issues/785)
|
151
|
+
|
152
|
+
* Render markup of text inside double quotes.
|
153
|
+
[John Fairhurst](https://github.com/johnfairh)
|
154
|
+
[#992](https://github.com/realm/jazzy/issues/992)
|
155
|
+
|
156
|
+
* Fix `sourcekitten_sourcefile` used from config file.
|
157
|
+
[John Fairhurst](https://github.com/johnfairh)
|
158
|
+
[#1137](https://github.com/realm/jazzy/issues/1137)
|
159
|
+
|
1
160
|
## 0.12.0
|
2
161
|
|
3
162
|
##### Breaking
|
data/CONTRIBUTING.md
CHANGED
@@ -49,7 +49,7 @@ git push
|
|
49
49
|
You'll need push access to the integration specs repo to do this. You can
|
50
50
|
request access from one of the maintainers when filing your PR.
|
51
51
|
|
52
|
-
You must have Xcode 11.
|
52
|
+
You must have Xcode 11.4 installed to build the integration specs.
|
53
53
|
|
54
54
|
## Making changes to SourceKitten
|
55
55
|
|
data/Gemfile.lock
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
PATH
|
2
2
|
remote: .
|
3
3
|
specs:
|
4
|
-
jazzy (0.
|
4
|
+
jazzy (0.13.4)
|
5
5
|
cocoapods (~> 1.5)
|
6
6
|
mustache (~> 1.1)
|
7
7
|
open4
|
@@ -14,15 +14,15 @@ PATH
|
|
14
14
|
GEM
|
15
15
|
remote: https://rubygems.org/
|
16
16
|
specs:
|
17
|
-
CFPropertyList (3.0.
|
18
|
-
activesupport (4.2.11.
|
17
|
+
CFPropertyList (3.0.2)
|
18
|
+
activesupport (4.2.11.3)
|
19
19
|
i18n (~> 0.7)
|
20
20
|
minitest (~> 5.1)
|
21
21
|
thread_safe (~> 0.3, >= 0.3.4)
|
22
22
|
tzinfo (~> 1.1)
|
23
23
|
addressable (2.7.0)
|
24
24
|
public_suffix (>= 2.0.2, < 5.0)
|
25
|
-
algoliasearch (1.27.
|
25
|
+
algoliasearch (1.27.2)
|
26
26
|
httpclient (~> 2.8, >= 2.8.3)
|
27
27
|
json (>= 1.5.1)
|
28
28
|
ast (2.4.0)
|
@@ -36,10 +36,10 @@ GEM
|
|
36
36
|
clintegracon (0.7.0)
|
37
37
|
colored (~> 1.2)
|
38
38
|
diffy
|
39
|
-
cocoapods (1.
|
39
|
+
cocoapods (1.9.3)
|
40
40
|
activesupport (>= 4.0.2, < 5)
|
41
41
|
claide (>= 1.0.2, < 2.0)
|
42
|
-
cocoapods-core (= 1.
|
42
|
+
cocoapods-core (= 1.9.3)
|
43
43
|
cocoapods-deintegrate (>= 1.0.3, < 2.0)
|
44
44
|
cocoapods-downloader (>= 1.2.2, < 2.0)
|
45
45
|
cocoapods-plugins (>= 1.0.0, < 2.0)
|
@@ -54,38 +54,40 @@ GEM
|
|
54
54
|
molinillo (~> 0.6.6)
|
55
55
|
nap (~> 1.0)
|
56
56
|
ruby-macho (~> 1.4)
|
57
|
-
xcodeproj (>= 1.
|
58
|
-
cocoapods-core (1.
|
57
|
+
xcodeproj (>= 1.14.0, < 2.0)
|
58
|
+
cocoapods-core (1.9.3)
|
59
59
|
activesupport (>= 4.0.2, < 6)
|
60
60
|
algoliasearch (~> 1.0)
|
61
61
|
concurrent-ruby (~> 1.1)
|
62
62
|
fuzzy_match (~> 2.0.4)
|
63
63
|
nap (~> 1.0)
|
64
|
+
netrc (~> 0.11)
|
65
|
+
typhoeus (~> 1.0)
|
64
66
|
cocoapods-deintegrate (1.0.4)
|
65
|
-
cocoapods-downloader (1.
|
67
|
+
cocoapods-downloader (1.3.0)
|
66
68
|
cocoapods-plugins (1.0.0)
|
67
69
|
nap
|
68
70
|
cocoapods-search (1.0.0)
|
69
71
|
cocoapods-stats (1.1.0)
|
70
|
-
cocoapods-trunk (1.
|
72
|
+
cocoapods-trunk (1.5.0)
|
71
73
|
nap (>= 0.8, < 2.0)
|
72
74
|
netrc (~> 0.11)
|
73
|
-
cocoapods-try (1.
|
75
|
+
cocoapods-try (1.2.0)
|
74
76
|
colored (1.2)
|
75
77
|
colored2 (3.1.2)
|
76
|
-
concurrent-ruby (1.1.
|
78
|
+
concurrent-ruby (1.1.6)
|
77
79
|
cork (0.3.0)
|
78
80
|
colored2 (~> 3.1)
|
79
81
|
crack (0.4.3)
|
80
82
|
safe_yaml (~> 1.0.0)
|
81
|
-
danger (
|
83
|
+
danger (8.0.0)
|
82
84
|
claide (~> 1.0)
|
83
85
|
claide-plugins (>= 0.9.2)
|
84
86
|
colored2 (~> 3.1)
|
85
87
|
cork (~> 0.1)
|
86
|
-
faraday (
|
88
|
+
faraday (>= 0.9.0, < 2.0)
|
87
89
|
faraday-http-cache (~> 2.0)
|
88
|
-
git (~> 1.
|
90
|
+
git (~> 1.7)
|
89
91
|
kramdown (~> 2.0)
|
90
92
|
kramdown-parser-gfm (~> 1.0)
|
91
93
|
no_proxy_fix
|
@@ -93,52 +95,57 @@ GEM
|
|
93
95
|
terminal-table (~> 1)
|
94
96
|
diffy (3.3.0)
|
95
97
|
escape (0.0.4)
|
96
|
-
|
98
|
+
ethon (0.12.0)
|
99
|
+
ffi (>= 1.3.0)
|
100
|
+
faraday (1.0.1)
|
97
101
|
multipart-post (>= 1.2, < 3)
|
98
|
-
faraday-http-cache (2.
|
99
|
-
faraday (
|
100
|
-
ffi (1.
|
102
|
+
faraday-http-cache (2.2.0)
|
103
|
+
faraday (>= 0.8)
|
104
|
+
ffi (1.12.2)
|
101
105
|
fourflusher (2.3.1)
|
102
106
|
fuzzy_match (2.0.4)
|
103
107
|
gh_inspector (1.1.3)
|
104
|
-
git (1.
|
105
|
-
|
108
|
+
git (1.7.0)
|
109
|
+
rchardet (~> 1.8)
|
110
|
+
hashdiff (1.0.1)
|
106
111
|
httpclient (2.8.3)
|
107
112
|
i18n (0.9.5)
|
108
113
|
concurrent-ruby (~> 1.0)
|
109
|
-
json (2.
|
110
|
-
kramdown (2.1
|
114
|
+
json (2.3.0)
|
115
|
+
kramdown (2.2.1)
|
116
|
+
rexml
|
111
117
|
kramdown-parser-gfm (1.1.0)
|
112
118
|
kramdown (~> 2.0)
|
113
119
|
liferaft (0.0.6)
|
114
|
-
|
115
|
-
|
116
|
-
mocha (1.9.0)
|
117
|
-
metaclass (~> 0.0.1)
|
120
|
+
minitest (5.14.1)
|
121
|
+
mocha (1.11.2)
|
118
122
|
mocha-on-bacon (0.2.3)
|
119
123
|
mocha (>= 0.13.0)
|
120
124
|
molinillo (0.6.6)
|
121
125
|
multipart-post (2.1.1)
|
122
|
-
mustache (1.1.
|
126
|
+
mustache (1.1.1)
|
123
127
|
nanaimo (0.2.6)
|
124
128
|
nap (1.1.0)
|
125
129
|
netrc (0.11.0)
|
126
130
|
no_proxy_fix (0.1.2)
|
127
|
-
octokit (4.
|
131
|
+
octokit (4.18.0)
|
132
|
+
faraday (>= 0.9)
|
128
133
|
sawyer (~> 0.8.0, >= 0.5.3)
|
129
134
|
open4 (1.3.4)
|
130
|
-
parallel (1.
|
131
|
-
parser (2.
|
135
|
+
parallel (1.19.1)
|
136
|
+
parser (2.7.1.3)
|
132
137
|
ast (~> 2.4.0)
|
133
138
|
powerpack (0.1.2)
|
134
139
|
prettybacon (0.0.2)
|
135
140
|
bacon (~> 1.2)
|
136
|
-
public_suffix (4.0.
|
141
|
+
public_suffix (4.0.5)
|
137
142
|
rainbow (2.2.2)
|
138
143
|
rake
|
139
|
-
rake (
|
144
|
+
rake (13.0.1)
|
145
|
+
rchardet (1.8.0)
|
140
146
|
redcarpet (3.5.0)
|
141
|
-
|
147
|
+
rexml (3.2.4)
|
148
|
+
rouge (3.19.0)
|
142
149
|
rubocop (0.49.0)
|
143
150
|
parallel (~> 1.10)
|
144
151
|
parser (>= 2.3.3.1, < 3.0)
|
@@ -149,25 +156,27 @@ GEM
|
|
149
156
|
ruby-macho (1.4.0)
|
150
157
|
ruby-progressbar (1.10.1)
|
151
158
|
safe_yaml (1.0.5)
|
152
|
-
sassc (2.
|
159
|
+
sassc (2.3.0)
|
153
160
|
ffi (~> 1.9)
|
154
161
|
sawyer (0.8.2)
|
155
162
|
addressable (>= 2.3.5)
|
156
163
|
faraday (> 0.8, < 2.0)
|
157
|
-
sqlite3 (1.4.
|
164
|
+
sqlite3 (1.4.2)
|
158
165
|
terminal-table (1.8.0)
|
159
166
|
unicode-display_width (~> 1.1, >= 1.1.1)
|
160
167
|
thread_safe (0.3.6)
|
161
|
-
|
168
|
+
typhoeus (1.4.0)
|
169
|
+
ethon (>= 0.9.0)
|
170
|
+
tzinfo (1.2.7)
|
162
171
|
thread_safe (~> 0.1)
|
163
|
-
unicode-display_width (1.
|
164
|
-
webmock (3.
|
172
|
+
unicode-display_width (1.7.0)
|
173
|
+
webmock (3.8.3)
|
165
174
|
addressable (>= 2.3.6)
|
166
175
|
crack (>= 0.3.2)
|
167
176
|
hashdiff (>= 0.4.0, < 2.0.0)
|
168
177
|
xcinvoke (0.3.0)
|
169
178
|
liferaft (~> 0.0.6)
|
170
|
-
xcodeproj (1.
|
179
|
+
xcodeproj (1.16.0)
|
171
180
|
CFPropertyList (>= 2.3.3, < 4.0)
|
172
181
|
atomos (~> 0.1.3)
|
173
182
|
claide (>= 1.0.2, < 2.0)
|
@@ -187,7 +196,7 @@ DEPENDENCIES
|
|
187
196
|
mocha
|
188
197
|
mocha-on-bacon
|
189
198
|
prettybacon
|
190
|
-
rake (~>
|
199
|
+
rake (~> 13.0)
|
191
200
|
rubocop (= 0.49.0)
|
192
201
|
webmock
|
193
202
|
|
data/README.md
CHANGED
@@ -47,6 +47,10 @@ If your Swift module is the first thing to build, and it builds fine when runnin
|
|
47
47
|
just running `jazzy` (without any arguments) from the root of your project should
|
48
48
|
succeed too!
|
49
49
|
|
50
|
+
If Jazzy generates docs for the wrong module then use `--module` to tell it which
|
51
|
+
one you'd prefer. If this doesn't help, and you're using Xcode, then try passing
|
52
|
+
extra arguments to `xcodebuild`, for example `jazzy --build-tool-arguments -target,MyTarget`.
|
53
|
+
|
50
54
|
You can set options for your project’s documentation in a configuration file,
|
51
55
|
`.jazzy.yaml` by default. For a detailed explanation and an exhaustive list of
|
52
56
|
all available options, run `jazzy --help config`.
|
@@ -70,6 +74,25 @@ backticks generates a link, for example:
|
|
70
74
|
* \`[MyClass method1]\` - a link to an Objective-C method.
|
71
75
|
* \`-[MyClass method2:param1]\` - a link to another Objective-C method.
|
72
76
|
|
77
|
+
### Math
|
78
|
+
|
79
|
+
Jazzy can render math equations written in LaTeX embedded in your markdown:
|
80
|
+
* `` `$equation$` `` renders the equation in an inline style.
|
81
|
+
* `` `$$equation$$` `` renders the equation in a display style, centered on a
|
82
|
+
line of its own.
|
83
|
+
|
84
|
+
For example, the markdown:
|
85
|
+
```markdown
|
86
|
+
Inline: `$ax^2+bx+c=0$`
|
87
|
+
|
88
|
+
Block: `$$x={\frac {-b\pm {\sqrt {b^{2}-4ac}}}{2a}}$$`
|
89
|
+
```
|
90
|
+
..renders as:
|
91
|
+
|
92
|
+
![math](images/math.png)
|
93
|
+
|
94
|
+
Math support is provided by [KaTeX](https://katex.org).
|
95
|
+
|
73
96
|
### Swift
|
74
97
|
|
75
98
|
Swift documentation is generated by default.
|