jazzy 0.13.0 → 0.13.5
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 +153 -0
- data/CONTRIBUTING.md +1 -1
- data/Gemfile.lock +49 -38
- data/README.md +30 -0
- data/Rakefile +30 -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 +40 -2
- data/lib/jazzy/doc.rb +4 -0
- data/lib/jazzy/doc_builder.rb +47 -17
- 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 +17 -0
- data/lib/jazzy/podspec_documenter.rb +15 -3
- data/lib/jazzy/source_declaration.rb +15 -2
- data/lib/jazzy/source_declaration/access_control_level.rb +1 -1
- data/lib/jazzy/source_declaration/type.rb +34 -0
- data/lib/jazzy/source_module.rb +2 -1
- data/lib/jazzy/sourcekitten.rb +52 -22
- data/lib/jazzy/themes/apple/assets/css/jazzy.css.scss +79 -4
- data/lib/jazzy/themes/apple/assets/img/spinner.gif +0 -0
- data/lib/jazzy/themes/apple/assets/js/jazzy.js +12 -1
- data/lib/jazzy/themes/apple/assets/js/jazzy.search.js +70 -0
- data/lib/jazzy/themes/apple/assets/js/jquery.min.js +2 -2
- data/lib/jazzy/themes/apple/assets/js/lunr.min.js +6 -0
- data/lib/jazzy/themes/apple/assets/js/typeahead.jquery.js +1694 -0
- data/lib/jazzy/themes/apple/templates/doc.mustache +41 -0
- data/lib/jazzy/themes/apple/templates/header.mustache +7 -0
- data/lib/jazzy/themes/apple/templates/task.mustache +3 -3
- data/lib/jazzy/themes/fullwidth/assets/css/jazzy.css.scss +3 -1
- 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 +36 -0
- data/lib/jazzy/themes/fullwidth/templates/task.mustache +3 -3
- data/lib/jazzy/themes/jony/assets/css/jazzy.css.scss +12 -2
- 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 +36 -0
- data/lib/jazzy/themes/jony/templates/task.mustache +3 -3
- metadata +75 -5
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 9b896e2cc19ed17de08bbaf77655ce4cc28ba3b086c4b324c6f3c15d3f61c5c2
|
4
|
+
data.tar.gz: 6dda6fa99cc9c4282f3818f405f218b23d22e57b6869be208082e36b25873dd0
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 7d3a45bc3b94976166452b9ddf2c411dff01acedd555ba7b124f5eb66c078f5cdab652958a83017e1a253384b874316bf25e523a6eb6f814eb8c04b282063ee5
|
7
|
+
data.tar.gz: e7816087c597af5c4811f7c1155160242268b6beb25c610d93f571e749bc2c92edc7633712eed492d882d23f9576af98637ef46e8857ed4f547608ede6387439
|
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,156 @@
|
|
1
|
+
## 0.13.5
|
2
|
+
|
3
|
+
##### Breaking
|
4
|
+
|
5
|
+
* None.
|
6
|
+
|
7
|
+
##### Enhancements
|
8
|
+
|
9
|
+
* Add search function to `apple` theme.
|
10
|
+
[Giles Payne](https://github.com/komakai)
|
11
|
+
[#726](https://github.com/realm/jazzy/issues/726)
|
12
|
+
|
13
|
+
* Add option `--[no-]separate-global-declarations` to always create separate
|
14
|
+
documentation pages for top-level declarations as well as classes,
|
15
|
+
structures, enums etc. even if they don't have members. As part of this,
|
16
|
+
improve the main page declaration in all modes.
|
17
|
+
[Nikolay Volosatov](https://github.com/bamx23)
|
18
|
+
[John Fairhurst](https://github.com/johnfairh)
|
19
|
+
|
20
|
+
##### Bug Fixes
|
21
|
+
|
22
|
+
* Style fixes for `apple` and `jony` themes to codeblocks inside lists and
|
23
|
+
links.
|
24
|
+
[John Fairhurst](https://github.com/johnfairh)
|
25
|
+
[#818](https://github.com/realm/jazzy/issues/818)
|
26
|
+
[#1177](https://github.com/realm/jazzy/issues/1177)
|
27
|
+
|
28
|
+
## 0.13.4
|
29
|
+
|
30
|
+
##### Breaking
|
31
|
+
|
32
|
+
* None.
|
33
|
+
|
34
|
+
##### Enhancements
|
35
|
+
|
36
|
+
* Update JavaScript libraries: jQuery 3.5.1 (all themes), Lunr 2.3.8,
|
37
|
+
typeahead.js 1.3.1 (`fullwidth` theme only).
|
38
|
+
[John Fairhurst](https://github.com/johnfairh)
|
39
|
+
|
40
|
+
##### Bug Fixes
|
41
|
+
|
42
|
+
* Fix warnings from Ruby 2.7.
|
43
|
+
[John Fairhurst](https://github.com/johnfairh)
|
44
|
+
[#1185](https://github.com/realm/jazzy/issues/1185)
|
45
|
+
|
46
|
+
* Accept `root_url` without trailing slash.
|
47
|
+
[John Fairhurst](https://github.com/johnfairh)
|
48
|
+
[#1188](https://github.com/realm/jazzy/issues/1188)
|
49
|
+
|
50
|
+
## 0.13.3
|
51
|
+
|
52
|
+
##### Breaking
|
53
|
+
|
54
|
+
* None.
|
55
|
+
|
56
|
+
##### Enhancements
|
57
|
+
|
58
|
+
* Added a config option to provide sources of privately hosted pod
|
59
|
+
dependencies when using the `--podspec` option.
|
60
|
+
`--pod-sources url1,url2,…urlN`.
|
61
|
+
[Jonathan Bailey](https://github.com/jon889)
|
62
|
+
[#650](https://github.com/realm/jazzy/issues/650)
|
63
|
+
|
64
|
+
* Improve Dash docset support: support online redirection when
|
65
|
+
`--root-url` is set, and provide `--docset-playground-url` to
|
66
|
+
support docset playground links.
|
67
|
+
[John Fairhurst](https://github.com/johnfairh)
|
68
|
+
|
69
|
+
##### Bug Fixes
|
70
|
+
|
71
|
+
* Fix module version not being used from podspec.
|
72
|
+
[Jonathan Bailey](https://github.com/jon889)
|
73
|
+
|
74
|
+
* Autolink Swift custom attributes/property wrappers.
|
75
|
+
[John Fairhurst](https://github.com/johnfairh)
|
76
|
+
|
77
|
+
## 0.13.2
|
78
|
+
|
79
|
+
##### Breaking
|
80
|
+
|
81
|
+
* None.
|
82
|
+
|
83
|
+
##### Enhancements
|
84
|
+
|
85
|
+
* Support Xcode 11.4. Default Objective-C property attributes are now
|
86
|
+
stripped from declarations: turn this off with
|
87
|
+
`--keep-default-property-attributes`.
|
88
|
+
[John Fairhurst](https://github.com/johnfairh)
|
89
|
+
[#829](https://github.com/realm/jazzy/issues/829)
|
90
|
+
|
91
|
+
* Render LaTeX expressions written using `$equation$` or `$$equation$$`
|
92
|
+
syntax.
|
93
|
+
[Arthur Guiot](https://github.com/arguiot)
|
94
|
+
[John Fairhurst](https://github.com/johnfairh)
|
95
|
+
[#1156](https://github.com/realm/jazzy/issues/1156)
|
96
|
+
|
97
|
+
* Wrap long method names on category pages. Use `name_html` in custom
|
98
|
+
mustache templates to take advantage of this.
|
99
|
+
[John Fairhurst](https://github.com/johnfairh)
|
100
|
+
[#995](https://github.com/realm/jazzy/issues/995)
|
101
|
+
|
102
|
+
* Support Dash-style `apple_ref` links to specific API items, for more
|
103
|
+
stable and human-readable links from external docs.
|
104
|
+
[Paul Cantrell](https://github.com/pcantrell)
|
105
|
+
|
106
|
+
##### Bug Fixes
|
107
|
+
|
108
|
+
* Don't generate documentation if the `xcodebuild` command fails.
|
109
|
+
[John Fairhurst](https://github.com/johnfairh)
|
110
|
+
[jpsim/SourceKitten#643](https://github.com/jpsim/SourceKitten/issues/643)
|
111
|
+
|
112
|
+
* Use multi-line parsed declarations in more places including protocol
|
113
|
+
methods and typealiases.
|
114
|
+
[John Fairhurst](https://github.com/johnfairh)
|
115
|
+
[#896](https://github.com/realm/jazzy/issues/896)
|
116
|
+
|
117
|
+
## 0.13.1
|
118
|
+
|
119
|
+
##### Breaking
|
120
|
+
|
121
|
+
* None.
|
122
|
+
|
123
|
+
##### Enhancements
|
124
|
+
|
125
|
+
* Allow inline html tags in ObjC doc comments.
|
126
|
+
[Chris Williams](https://github.com/ultramiraculous)
|
127
|
+
[#976](https://github.com/realm/jazzy/issues/976)
|
128
|
+
|
129
|
+
* Support code formatting in ObjC doc comments with `@c`, `@code` and
|
130
|
+
`@endcode`.
|
131
|
+
[Bryce Pauken](https://github.com/brycepauken)
|
132
|
+
[jpsim/SourceKitten#631](https://github.com/jpsim/SourceKitten/issues/631)
|
133
|
+
|
134
|
+
* Add `custom_categories_unlisted_prefix` configuration setting. This
|
135
|
+
is the prefix for navigation section names that aren't explicitly
|
136
|
+
listed in `custom_categories`. Defaults to 'Other '.
|
137
|
+
[JP Simard](https://github.com/jpsim)
|
138
|
+
|
139
|
+
* Add `hide_unlisted_documentation` configuration setting. Setting this
|
140
|
+
to `true` hides documentation entries in the sidebar from the
|
141
|
+
`documentation` config value that aren't explicitly listed in
|
142
|
+
`custom_categories`.
|
143
|
+
[JP Simard](https://github.com/jpsim)
|
144
|
+
|
145
|
+
##### Bug Fixes
|
146
|
+
|
147
|
+
* Fix crash when SourceKit returns out of bounds string byte offsets.
|
148
|
+
[JP Simard](https://github.com/jpsim)
|
149
|
+
|
150
|
+
* Pick the right version of declarations with type attributes.
|
151
|
+
[John Fairhurst](https://github.com/johnfairh)
|
152
|
+
[#1148](https://github.com/realm/jazzy/issues/1148)
|
153
|
+
|
1
154
|
## 0.13.0
|
2
155
|
|
3
156
|
##### 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.13.
|
4
|
+
jazzy (0.13.5)
|
5
5
|
cocoapods (~> 1.5)
|
6
6
|
mustache (~> 1.1)
|
7
7
|
open4
|
@@ -15,17 +15,17 @@ GEM
|
|
15
15
|
remote: https://rubygems.org/
|
16
16
|
specs:
|
17
17
|
CFPropertyList (3.0.2)
|
18
|
-
activesupport (4.2.11.
|
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.3)
|
26
26
|
httpclient (~> 2.8, >= 2.8.3)
|
27
27
|
json (>= 1.5.1)
|
28
|
-
ast (2.4.
|
28
|
+
ast (2.4.1)
|
29
29
|
atomos (0.1.3)
|
30
30
|
bacon (1.2.0)
|
31
31
|
claide (1.0.3)
|
@@ -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
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.2)
|
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,26 +95,30 @@ 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.13.1)
|
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.
|
114
|
+
json (2.3.1)
|
115
|
+
kramdown (2.3.0)
|
116
|
+
rexml
|
111
117
|
kramdown-parser-gfm (1.1.0)
|
112
118
|
kramdown (~> 2.0)
|
113
119
|
liferaft (0.0.6)
|
114
|
-
minitest (5.
|
115
|
-
mocha (1.
|
120
|
+
minitest (5.14.1)
|
121
|
+
mocha (1.11.2)
|
116
122
|
mocha-on-bacon (0.2.3)
|
117
123
|
mocha (>= 0.13.0)
|
118
124
|
molinillo (0.6.6)
|
@@ -122,21 +128,24 @@ GEM
|
|
122
128
|
nap (1.1.0)
|
123
129
|
netrc (0.11.0)
|
124
130
|
no_proxy_fix (0.1.2)
|
125
|
-
octokit (4.
|
131
|
+
octokit (4.18.0)
|
132
|
+
faraday (>= 0.9)
|
126
133
|
sawyer (~> 0.8.0, >= 0.5.3)
|
127
134
|
open4 (1.3.4)
|
128
|
-
parallel (1.19.
|
129
|
-
parser (2.
|
130
|
-
ast (~> 2.4.
|
135
|
+
parallel (1.19.2)
|
136
|
+
parser (2.7.1.4)
|
137
|
+
ast (~> 2.4.1)
|
131
138
|
powerpack (0.1.2)
|
132
139
|
prettybacon (0.0.2)
|
133
140
|
bacon (~> 1.2)
|
134
|
-
public_suffix (4.0.
|
141
|
+
public_suffix (4.0.5)
|
135
142
|
rainbow (2.2.2)
|
136
143
|
rake
|
137
|
-
rake (
|
144
|
+
rake (13.0.1)
|
145
|
+
rchardet (1.8.0)
|
138
146
|
redcarpet (3.5.0)
|
139
|
-
|
147
|
+
rexml (3.2.4)
|
148
|
+
rouge (3.20.0)
|
140
149
|
rubocop (0.49.0)
|
141
150
|
parallel (~> 1.10)
|
142
151
|
parser (>= 2.3.3.1, < 3.0)
|
@@ -147,25 +156,27 @@ GEM
|
|
147
156
|
ruby-macho (1.4.0)
|
148
157
|
ruby-progressbar (1.10.1)
|
149
158
|
safe_yaml (1.0.5)
|
150
|
-
sassc (2.
|
159
|
+
sassc (2.4.0)
|
151
160
|
ffi (~> 1.9)
|
152
161
|
sawyer (0.8.2)
|
153
162
|
addressable (>= 2.3.5)
|
154
163
|
faraday (> 0.8, < 2.0)
|
155
|
-
sqlite3 (1.4.
|
164
|
+
sqlite3 (1.4.2)
|
156
165
|
terminal-table (1.8.0)
|
157
166
|
unicode-display_width (~> 1.1, >= 1.1.1)
|
158
167
|
thread_safe (0.3.6)
|
159
|
-
|
168
|
+
typhoeus (1.4.0)
|
169
|
+
ethon (>= 0.9.0)
|
170
|
+
tzinfo (1.2.7)
|
160
171
|
thread_safe (~> 0.1)
|
161
|
-
unicode-display_width (1.
|
162
|
-
webmock (3.
|
172
|
+
unicode-display_width (1.7.0)
|
173
|
+
webmock (3.8.3)
|
163
174
|
addressable (>= 2.3.6)
|
164
175
|
crack (>= 0.3.2)
|
165
176
|
hashdiff (>= 0.4.0, < 2.0.0)
|
166
177
|
xcinvoke (0.3.0)
|
167
178
|
liferaft (~> 0.0.6)
|
168
|
-
xcodeproj (1.
|
179
|
+
xcodeproj (1.17.0)
|
169
180
|
CFPropertyList (>= 2.3.3, < 4.0)
|
170
181
|
atomos (~> 0.1.3)
|
171
182
|
claide (>= 1.0.2, < 2.0)
|
@@ -185,7 +196,7 @@ DEPENDENCIES
|
|
185
196
|
mocha
|
186
197
|
mocha-on-bacon
|
187
198
|
prettybacon
|
188
|
-
rake (~>
|
199
|
+
rake (~> 13.0)
|
189
200
|
rubocop (= 0.49.0)
|
190
201
|
webmock
|
191
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.
|
@@ -258,6 +281,13 @@ Note that the `--include` option is applied before the `--exclude` option. For e
|
|
258
281
|
Declarations with a documentation comment containing `:nodoc:` are excluded from the
|
259
282
|
documentation.
|
260
283
|
|
284
|
+
### Documentation structure
|
285
|
+
|
286
|
+
By default Jazzy does not create separate web pages for declarations that do
|
287
|
+
not have any members: instead they are nested into some parent page. Use the
|
288
|
+
`--separate-global-declarations` flag to change this and always create pages
|
289
|
+
for declarations that can be directly accessed from client code.
|
290
|
+
|
261
291
|
### Choosing the Swift language version
|
262
292
|
|
263
293
|
Jazzy normally uses the Swift compiler from the Xcode currently configured by
|