jazzy 0.9.3 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. checksums.yaml +5 -5
  2. data/.circleci/config.yml +3 -3
  3. data/CHANGELOG.md +169 -0
  4. data/CONTRIBUTING.md +1 -1
  5. data/Gemfile.lock +67 -70
  6. data/README.md +71 -15
  7. data/Rakefile +7 -6
  8. data/bin/sourcekitten +0 -0
  9. data/jazzy.gemspec +4 -4
  10. data/lib/jazzy/config.rb +46 -8
  11. data/lib/jazzy/doc.rb +19 -2
  12. data/lib/jazzy/doc_builder.rb +22 -24
  13. data/lib/jazzy/docset_builder.rb +1 -1
  14. data/lib/jazzy/documentation_generator.rb +0 -7
  15. data/lib/jazzy/gem_version.rb +1 -1
  16. data/lib/jazzy/jazzy_markdown.rb +1 -1
  17. data/lib/jazzy/podspec_documenter.rb +36 -9
  18. data/lib/jazzy/source_declaration.rb +19 -4
  19. data/lib/jazzy/source_declaration/access_control_level.rb +10 -3
  20. data/lib/jazzy/source_declaration/type.rb +11 -1
  21. data/lib/jazzy/source_document.rb +21 -4
  22. data/lib/jazzy/sourcekitten.rb +73 -38
  23. data/lib/jazzy/themes/apple/assets/css/jazzy.css.scss +13 -5
  24. data/lib/jazzy/themes/apple/assets/js/jazzy.js +33 -20
  25. data/lib/jazzy/themes/apple/assets/js/jquery.min.js +2 -4
  26. data/lib/jazzy/themes/apple/templates/deprecation.mustache +12 -0
  27. data/lib/jazzy/themes/apple/templates/doc.mustache +1 -0
  28. data/lib/jazzy/themes/apple/templates/header.mustache +1 -1
  29. data/lib/jazzy/themes/apple/templates/task.mustache +12 -0
  30. data/lib/jazzy/themes/fullwidth/assets/css/jazzy.css.scss +10 -4
  31. data/lib/jazzy/themes/fullwidth/assets/js/jazzy.js +33 -17
  32. data/lib/jazzy/themes/fullwidth/assets/js/jazzy.search.js +17 -9
  33. data/lib/jazzy/themes/fullwidth/assets/js/jquery.min.js +2 -4
  34. data/lib/jazzy/themes/fullwidth/assets/js/lunr.min.js +1 -6
  35. data/lib/jazzy/themes/fullwidth/assets/js/typeahead.jquery.js +182 -46
  36. data/lib/jazzy/themes/fullwidth/templates/deprecation.mustache +12 -0
  37. data/lib/jazzy/themes/fullwidth/templates/doc.mustache +1 -0
  38. data/lib/jazzy/themes/fullwidth/templates/header.mustache +1 -1
  39. data/lib/jazzy/themes/fullwidth/templates/task.mustache +12 -0
  40. data/lib/jazzy/themes/jony/assets/css/jazzy.css.scss +9 -2
  41. data/lib/jazzy/themes/jony/assets/js/jazzy.js +33 -21
  42. data/lib/jazzy/themes/jony/assets/js/jquery.min.js +2 -4
  43. data/lib/jazzy/themes/jony/templates/deprecation.mustache +12 -0
  44. data/lib/jazzy/themes/jony/templates/doc.mustache +1 -0
  45. data/lib/jazzy/themes/jony/templates/header.mustache +1 -1
  46. data/lib/jazzy/themes/jony/templates/task.mustache +12 -0
  47. data/spec/integration_spec.rb +7 -12
  48. metadata +15 -14
  49. data/lib/jazzy/readme_generator.rb +0 -61
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
- SHA1:
3
- metadata.gz: accd6c9ed649bd4be1a4bbc78ad1d0bce7c426de
4
- data.tar.gz: 7b3d85bc26cef54041f0b9536e9273f283e952d6
2
+ SHA256:
3
+ metadata.gz: 6439cb8dc035d69bb0243f06e3b7140b079dd6892840b49e015be636efa7ff64
4
+ data.tar.gz: fc97247251923d0f385637721405435e2a3211110c14369876767e2572a25175
5
5
  SHA512:
6
- metadata.gz: f738c74fb08575c110f13407de425ad988b582f56798fa09899a8e87735c62d966faf4e519eeae349a97393ee69b6c8ece48b1a2df3c2fc9623976dc4d1289d1
7
- data.tar.gz: 77fd0c7d2d0ca3af3c284c04c1789747bff4e1dee6c7dfa567092bd3539ee3a1f9e67bf2438bda43f96aa572c4374ac21534006fb17b2df72f54984eaa171dfb
6
+ metadata.gz: 4049263b20f10ed92f23f23971df8d2fd57a58d95f0312fd34c5c36f1be170b6889ea82a31f3a972505025d69e4ce3f0b55343b17794ccff06bde3a46d87db3c
7
+ data.tar.gz: 10ac755d262c1a19c451b8dce5969924bd95f1f5601ae5f76c2fb748ac6f74d92b3bc6240334a185da3a6a8987a29ea3cc27c138b666d6e95ed0ed9ea930d833
data/.circleci/config.yml CHANGED
@@ -23,7 +23,7 @@ jobs:
23
23
 
24
24
  swift:
25
25
  macos:
26
- xcode: "9.3.0"
26
+ xcode: "10.2.0"
27
27
  environment: *bundler-environment
28
28
  # Used to invoke chruby
29
29
  shell: *shell
@@ -38,7 +38,7 @@ jobs:
38
38
 
39
39
  objc:
40
40
  macos:
41
- xcode: "9.3.0"
41
+ xcode: "10.2.0"
42
42
  environment: *bundler-environment
43
43
  # Used to invoke chruby
44
44
  shell: *shell
@@ -53,7 +53,7 @@ jobs:
53
53
 
54
54
  cocoapods:
55
55
  macos:
56
- xcode: "9.3.0"
56
+ xcode: "10.2.0"
57
57
  environment: *bundler-environment
58
58
  # Used to invoke chruby
59
59
  shell: *shell
data/CHANGELOG.md CHANGED
@@ -1,3 +1,172 @@
1
+ ## 0.11.0
2
+
3
+ ##### Breaking
4
+
5
+ * None.
6
+
7
+ ##### Enhancements
8
+
9
+ * Sass support now provided by `libsass` via `sassc` instead of the
10
+ deprecated Ruby Sass gem.
11
+ [John Fairhurst](https://github.com/johnfairh)
12
+
13
+ * Update bundled jQuery to 3.4.1 (all themes).
14
+ [Paul Idstein](https://github.com/idstein)
15
+
16
+ * Support Xcode 11 Swift projects that pass a response file to the Swift
17
+ compiler.
18
+ [John Fairhurst](https://github.com/johnfairh)
19
+ [#1087](https://github.com/realm/jazzy/issues/1087)
20
+
21
+ * Generate Swift docs from a Swift Package Manager package without
22
+ requiring an Xcode project file. Add `--swift-build-tool` to choose
23
+ the build method if both `.xcodeproj` and `Package.swift` files are
24
+ present. Add `--build-tool-flags` as a preferred alias for
25
+ `--xcodebuild-flags`.
26
+ [John Fairhurst](https://github.com/johnfairh)
27
+ [#487](https://github.com/realm/jazzy/issues/487)
28
+
29
+ ##### Bug Fixes
30
+
31
+ * Preserve non-latin characters in guide filenames and heading IDs.
32
+ [John Fairhurst](https://github.com/johnfairh)
33
+ [#1091](https://github.com/realm/jazzy/issues/1091)
34
+
35
+ * Generate correct html for custom categories containing special
36
+ characters.
37
+ [John Fairhurst](https://github.com/johnfairh)
38
+ [#945](https://github.com/realm/jazzy/issues/945)
39
+
40
+ * Fix crash on files with misplaced documentation comments.
41
+ [John Fairhurst](https://github.com/johnfairh)
42
+ [#1083](https://github.com/realm/jazzy/issues/1083)
43
+
44
+ ## 0.10.0
45
+
46
+ ##### Breaking
47
+
48
+ * The included `sourcekitten` binary is built with Xcode 10.2. This means
49
+ it does not run on macOS earlier than 10.14.4 without the *Swift 5 Runtime
50
+ Support for Command Line Tools* being installed.
51
+ [John Fairhurst](https://github.com/johnfairh)
52
+
53
+ ##### Enhancements
54
+
55
+ * Support CocoaPods 1.6+. Use the `swift_version[s]` dsl in `--podspec` mode
56
+ to set the Swift language version.
57
+ [John Fairhurst](https://github.com/johnfairh)
58
+
59
+ * Show the extension declaration when documenting Swift extensions.
60
+ [John Fairhurst](https://github.com/johnfairh)
61
+
62
+ * Allow docs title customization. Include `--module-version` when it is set
63
+ and support `--title` to fully customize the title. Pass `{{module_version}}`
64
+ and `{{docs_title}}` to templates.
65
+ [Maximilian Alexander](https://github.com/mbalex99)
66
+ [John Fairhurst](https://github.com/johnfairh)
67
+ [#666](https://github.com/realm/jazzy/issues/666)
68
+ [#411](https://github.com/realm/jazzy/issues/411)
69
+
70
+ ##### Bug Fixes
71
+
72
+ * Unfold member documentation when linked to from current web page.
73
+ [John Fairhurst](https://github.com/johnfairh)
74
+ [#788](https://github.com/realm/jazzy/issues/788)
75
+
76
+ * Generate docs when there are unusual characters in source pathnames.
77
+ [John Fairhurst](https://github.com/johnfairh)
78
+ [#1049](https://github.com/realm/jazzy/issues/1049)
79
+
80
+ * Generate docs for signed modules with Xcode 10.2.
81
+ [John Fairhurst](https://github.com/johnfairh)
82
+ [#1057](https://github.com/realm/jazzy/issues/1057)
83
+
84
+ * Use correct module name when only target name is supplied.
85
+ [Chris Zielinski](https://github.com/chriszielinski)
86
+ [#422](https://github.com/realm/jazzy/issues/422)
87
+
88
+ ## 0.9.6
89
+
90
+ This is (probably) the last release to support Ruby earlier than 2.3.
91
+ This is due to a change in a dependency.
92
+
93
+ This is (probably) the last release to support macOS earlier than 10.14.4
94
+ without the *Swift 5 Runtime Support for Command Line Tools* package installed.
95
+ This is a consequence of Swift 5 ABI stability.
96
+
97
+ ##### Breaking
98
+
99
+ * None.
100
+
101
+ ##### Enhancements
102
+
103
+ * Swift 5 support: suppress unwanted newlines and `deinit` declarations.
104
+ [John Fairhurst](https://github.com/johnfairh)
105
+
106
+ * Update JavaScript libraries: jQuery 3.3.1 (all themes), Lunr 2.3.5,
107
+ typeahead.js 1.2.1 (`fullwidth` theme only).
108
+ [John Fairhurst](https://github.com/johnfairh)
109
+ [#901](https://github.com/realm/jazzy/issues/901)
110
+
111
+ * Avoid `clean build` when using the new Xcode build system.
112
+ [Norio Nomura](https://github.com/norio-nomura)
113
+
114
+ ##### Bug Fixes
115
+
116
+ * None.
117
+
118
+ ## 0.9.5
119
+
120
+ ##### Breaking
121
+
122
+ * None.
123
+
124
+ ##### Enhancements
125
+
126
+ * Link to documentation pages from contents pages.
127
+ [John Fairhurst](https://github.com/johnfairh)
128
+ [#730](https://github.com/realm/jazzy/issues/730)
129
+
130
+ * Call out unavailable and deprecated Objective-C declarations.
131
+ [Stefan Kieleithner](https://github.com/steviki)
132
+ [John Fairhurst](https://github.com/johnfairh)
133
+ [#843](https://github.com/realm/jazzy/issues/843)
134
+
135
+ ##### Bug Fixes
136
+
137
+ * Support Swift 4.2 with `--podspec`.
138
+ [John Fairhurst](https://github.com/johnfairh)
139
+ [#1015](https://github.com/realm/jazzy/issues/1015)
140
+
141
+ * Fix multiline copyright for `apple` theme.
142
+ [Fabien Lydoire](https://github.com/fabienlydoire)
143
+ [John Fairhurst](https://github.com/johnfairh)
144
+ [#1016](https://github.com/realm/jazzy/issues/1016)
145
+
146
+ ## 0.9.4
147
+
148
+ ##### Breaking
149
+
150
+ * None.
151
+
152
+ ##### Enhancements
153
+
154
+ * None.
155
+
156
+ ##### Bug Fixes
157
+
158
+ * Fix crash with pre-existing `Docs` directory.
159
+ [John Fairhurst](https://github.com/johnfairh)
160
+ [#965](https://github.com/realm/jazzy/issues/965)
161
+
162
+ * Fix crash with unicode scalars in string literals.
163
+ [John Fairhurst](https://github.com/johnfairh)
164
+ [#972](https://github.com/realm/jazzy/issues/972)
165
+
166
+ * Fix error compiling a Swift podspec in Xcode 10.
167
+ [Minh Nguyễn](https://github.com/1ec5)
168
+ [#970](https://github.com/realm/jazzy/issues/970)
169
+
1
170
  ## 0.9.3
2
171
 
3
172
  ##### 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 9.3 installed to build the integration specs.
52
+ You must have Xcode 10.2 installed to build the integration specs.
53
53
 
54
54
  ## Making changes to SourceKitten
55
55
 
data/Gemfile.lock CHANGED
@@ -1,29 +1,29 @@
1
1
  PATH
2
2
  remote: .
3
3
  specs:
4
- jazzy (0.9.3)
5
- cocoapods (~> 1.0)
6
- mustache (~> 0.99)
4
+ jazzy (0.11.0)
5
+ cocoapods (~> 1.5)
6
+ mustache (~> 1.1)
7
7
  open4
8
- redcarpet (~> 3.2)
8
+ redcarpet (~> 3.4)
9
9
  rouge (>= 2.0.6, < 4.0)
10
- sass (~> 3.4)
10
+ sassc (~> 2.1)
11
11
  sqlite3 (~> 1.3)
12
12
  xcinvoke (~> 0.3.0)
13
13
 
14
14
  GEM
15
15
  remote: https://rubygems.org/
16
16
  specs:
17
- CFPropertyList (3.0.0)
18
- activesupport (4.2.10)
17
+ CFPropertyList (3.0.1)
18
+ activesupport (4.2.11.1)
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
- addressable (2.5.2)
23
+ addressable (2.6.0)
24
24
  public_suffix (>= 2.0.2, < 4.0)
25
25
  ast (2.4.0)
26
- atomos (0.1.2)
26
+ atomos (0.1.3)
27
27
  bacon (1.2.0)
28
28
  claide (1.0.2)
29
29
  claide-plugins (0.9.2)
@@ -33,105 +33,105 @@ GEM
33
33
  clintegracon (0.7.0)
34
34
  colored (~> 1.2)
35
35
  diffy
36
- cocoapods (1.5.0)
36
+ cocoapods (1.7.5)
37
37
  activesupport (>= 4.0.2, < 5)
38
38
  claide (>= 1.0.2, < 2.0)
39
- cocoapods-core (= 1.5.0)
40
- cocoapods-deintegrate (>= 1.0.2, < 2.0)
41
- cocoapods-downloader (>= 1.2.0, < 2.0)
39
+ cocoapods-core (= 1.7.5)
40
+ cocoapods-deintegrate (>= 1.0.3, < 2.0)
41
+ cocoapods-downloader (>= 1.2.2, < 2.0)
42
42
  cocoapods-plugins (>= 1.0.0, < 2.0)
43
43
  cocoapods-search (>= 1.0.0, < 2.0)
44
44
  cocoapods-stats (>= 1.0.0, < 2.0)
45
- cocoapods-trunk (>= 1.3.0, < 2.0)
45
+ cocoapods-trunk (>= 1.3.1, < 2.0)
46
46
  cocoapods-try (>= 1.1.0, < 2.0)
47
47
  colored2 (~> 3.1)
48
48
  escape (~> 0.0.4)
49
- fourflusher (~> 2.0.1)
49
+ fourflusher (>= 2.3.0, < 3.0)
50
50
  gh_inspector (~> 1.0)
51
- molinillo (~> 0.6.5)
51
+ molinillo (~> 0.6.6)
52
52
  nap (~> 1.0)
53
- ruby-macho (~> 1.1)
54
- xcodeproj (>= 1.5.7, < 2.0)
55
- cocoapods-core (1.5.0)
53
+ ruby-macho (~> 1.4)
54
+ xcodeproj (>= 1.10.0, < 2.0)
55
+ cocoapods-core (1.7.5)
56
56
  activesupport (>= 4.0.2, < 6)
57
57
  fuzzy_match (~> 2.0.4)
58
58
  nap (~> 1.0)
59
- cocoapods-deintegrate (1.0.2)
60
- cocoapods-downloader (1.2.0)
59
+ cocoapods-deintegrate (1.0.4)
60
+ cocoapods-downloader (1.2.2)
61
61
  cocoapods-plugins (1.0.0)
62
62
  nap
63
63
  cocoapods-search (1.0.0)
64
- cocoapods-stats (1.0.0)
65
- cocoapods-trunk (1.3.0)
64
+ cocoapods-stats (1.1.0)
65
+ cocoapods-trunk (1.4.0)
66
66
  nap (>= 0.8, < 2.0)
67
67
  netrc (~> 0.11)
68
68
  cocoapods-try (1.1.0)
69
69
  colored (1.2)
70
70
  colored2 (3.1.2)
71
- concurrent-ruby (1.0.5)
71
+ concurrent-ruby (1.1.5)
72
72
  cork (0.3.0)
73
73
  colored2 (~> 3.1)
74
74
  crack (0.4.3)
75
75
  safe_yaml (~> 1.0.0)
76
- danger (5.5.12)
76
+ danger (6.0.9)
77
77
  claide (~> 1.0)
78
78
  claide-plugins (>= 0.9.2)
79
79
  colored2 (~> 3.1)
80
80
  cork (~> 0.1)
81
81
  faraday (~> 0.9)
82
- faraday-http-cache (~> 1.0)
83
- git (~> 1)
84
- kramdown (~> 1.5)
82
+ faraday-http-cache (~> 2.0)
83
+ git (~> 1.5)
84
+ kramdown (~> 2.0)
85
+ kramdown-parser-gfm (~> 1.0)
85
86
  no_proxy_fix
86
87
  octokit (~> 4.7)
87
88
  terminal-table (~> 1)
88
- diffy (3.2.0)
89
+ diffy (3.3.0)
89
90
  escape (0.0.4)
90
- faraday (0.15.0)
91
+ faraday (0.15.4)
91
92
  multipart-post (>= 1.2, < 3)
92
- faraday-http-cache (1.3.1)
93
+ faraday-http-cache (2.0.0)
93
94
  faraday (~> 0.8)
94
- ffi (1.9.23)
95
- fourflusher (2.0.1)
95
+ ffi (1.11.1)
96
+ fourflusher (2.3.1)
96
97
  fuzzy_match (2.0.4)
97
98
  gh_inspector (1.1.3)
98
- git (1.3.0)
99
- hashdiff (0.3.7)
99
+ git (1.5.0)
100
+ hashdiff (0.4.0)
100
101
  i18n (0.9.5)
101
102
  concurrent-ruby (~> 1.0)
102
- kramdown (1.16.2)
103
+ kramdown (2.1.0)
104
+ kramdown-parser-gfm (1.1.0)
105
+ kramdown (~> 2.0)
103
106
  liferaft (0.0.6)
104
107
  metaclass (0.0.4)
105
108
  minitest (5.11.3)
106
- mocha (1.5.0)
109
+ mocha (1.9.0)
107
110
  metaclass (~> 0.0.1)
108
111
  mocha-on-bacon (0.2.3)
109
112
  mocha (>= 0.13.0)
110
- molinillo (0.6.5)
111
- multipart-post (2.0.0)
112
- mustache (0.99.8)
113
- nanaimo (0.2.5)
113
+ molinillo (0.6.6)
114
+ multipart-post (2.1.1)
115
+ mustache (1.1.0)
116
+ nanaimo (0.2.6)
114
117
  nap (1.1.0)
115
118
  netrc (0.11.0)
116
119
  no_proxy_fix (0.1.2)
117
- octokit (4.8.0)
120
+ octokit (4.14.0)
118
121
  sawyer (~> 0.8.0, >= 0.5.3)
119
122
  open4 (1.3.4)
120
- parallel (1.12.1)
121
- parser (2.5.1.0)
123
+ parallel (1.17.0)
124
+ parser (2.6.3.0)
122
125
  ast (~> 2.4.0)
123
- powerpack (0.1.1)
126
+ powerpack (0.1.2)
124
127
  prettybacon (0.0.2)
125
128
  bacon (~> 1.2)
126
- public_suffix (3.0.2)
129
+ public_suffix (3.1.0)
127
130
  rainbow (2.2.2)
128
131
  rake
129
132
  rake (10.5.0)
130
- rb-fsevent (0.10.3)
131
- rb-inotify (0.9.10)
132
- ffi (>= 0.5.0, < 2)
133
- redcarpet (3.4.0)
134
- rouge (3.1.1)
133
+ redcarpet (3.5.0)
134
+ rouge (3.10.0)
135
135
  rubocop (0.49.0)
136
136
  parallel (~> 1.10)
137
137
  parser (>= 2.3.3.1, < 3.0)
@@ -139,36 +139,33 @@ GEM
139
139
  rainbow (>= 1.99.1, < 3.0)
140
140
  ruby-progressbar (~> 1.7)
141
141
  unicode-display_width (~> 1.0, >= 1.0.1)
142
- ruby-macho (1.1.0)
143
- ruby-progressbar (1.9.0)
144
- safe_yaml (1.0.4)
145
- sass (3.5.6)
146
- sass-listen (~> 4.0.0)
147
- sass-listen (4.0.0)
148
- rb-fsevent (~> 0.9, >= 0.9.4)
149
- rb-inotify (~> 0.9, >= 0.9.7)
150
- sawyer (0.8.1)
151
- addressable (>= 2.3.5, < 2.6)
152
- faraday (~> 0.8, < 1.0)
153
- sqlite3 (1.3.13)
142
+ ruby-macho (1.4.0)
143
+ ruby-progressbar (1.10.1)
144
+ safe_yaml (1.0.5)
145
+ sassc (2.2.0)
146
+ ffi (~> 1.9)
147
+ sawyer (0.8.2)
148
+ addressable (>= 2.3.5)
149
+ faraday (> 0.8, < 2.0)
150
+ sqlite3 (1.4.1)
154
151
  terminal-table (1.8.0)
155
152
  unicode-display_width (~> 1.1, >= 1.1.1)
156
153
  thread_safe (0.3.6)
157
154
  tzinfo (1.2.5)
158
155
  thread_safe (~> 0.1)
159
- unicode-display_width (1.3.2)
160
- webmock (3.3.0)
156
+ unicode-display_width (1.6.0)
157
+ webmock (3.6.0)
161
158
  addressable (>= 2.3.6)
162
159
  crack (>= 0.3.2)
163
- hashdiff
160
+ hashdiff (>= 0.4.0, < 2.0.0)
164
161
  xcinvoke (0.3.0)
165
162
  liferaft (~> 0.0.6)
166
- xcodeproj (1.5.7)
163
+ xcodeproj (1.12.0)
167
164
  CFPropertyList (>= 2.3.3, < 4.0)
168
- atomos (~> 0.1.2)
165
+ atomos (~> 0.1.3)
169
166
  claide (>= 1.0.2, < 2.0)
170
167
  colored2 (~> 3.1)
171
- nanaimo (~> 0.2.4)
168
+ nanaimo (~> 0.2.6)
172
169
 
173
170
  PLATFORMS
174
171
  ruby
@@ -188,4 +185,4 @@ DEPENDENCIES
188
185
  webmock
189
186
 
190
187
  BUNDLED WITH
191
- 1.16.0
188
+ 1.17.3