@skyux/docs-tools 5.0.0-beta.10 → 5.0.0-beta.13
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.
- package/README.md +8 -0
- package/bundles/skyux-docs-tools.umd.js +347 -345
- package/documentation.json +310 -310
- package/esm2015/docs-tools.module.js +3 -3
- package/esm2015/modules/anatomy/anatomy-item.component.js +3 -3
- package/esm2015/modules/anatomy/anatomy.component.js +4 -4
- package/esm2015/modules/anatomy/anatomy.module.js +6 -24
- package/esm2015/modules/code-examples/code-example-theme.js +1 -1
- package/esm2015/modules/code-examples/code-example.component.js +4 -4
- package/esm2015/modules/code-examples/code-example.js +1 -1
- package/esm2015/modules/code-examples/code-examples-editor.service.js +24 -19
- package/esm2015/modules/code-examples/code-examples.component.js +5 -5
- package/esm2015/modules/code-examples/code-examples.module.js +7 -15
- package/esm2015/modules/demo/demo-control-panel-checkbox.component.js +4 -4
- package/esm2015/modules/demo/demo-control-panel-radio-choice.js +1 -1
- package/esm2015/modules/demo/demo-control-panel-radio-group.component.js +5 -5
- package/esm2015/modules/demo/demo-control-panel-section.component.js +3 -3
- package/esm2015/modules/demo/demo-control-panel.component.js +11 -7
- package/esm2015/modules/demo/demo.component.js +6 -6
- package/esm2015/modules/demo/demo.module.js +4 -4
- package/esm2015/modules/demo-page/demo-page-dom-adapter.service.js +2 -2
- package/esm2015/modules/demo-page/demo-page-module-info.component.js +2 -2
- package/esm2015/modules/demo-page/demo-page-section.component.js +5 -4
- package/esm2015/modules/demo-page/demo-page-summary.component.js +2 -2
- package/esm2015/modules/demo-page/demo-page-title.service.js +2 -2
- package/esm2015/modules/demo-page/demo-page-type-definitions.component.js +4 -4
- package/esm2015/modules/demo-page/demo-page.component.js +14 -16
- package/esm2015/modules/demo-page/demo-page.module.js +8 -8
- package/esm2015/modules/design-guidelines/design-guideline-thumbnail.component.js +2 -2
- package/esm2015/modules/design-guidelines/design-guideline.component.js +4 -4
- package/esm2015/modules/design-guidelines/design-guidelines.component.js +2 -2
- package/esm2015/modules/design-guidelines/design-guidelines.module.js +7 -17
- package/esm2015/modules/heading-anchor/heading-anchor.component.js +3 -3
- package/esm2015/modules/heading-anchor/heading-anchor.module.js +6 -20
- package/esm2015/modules/markdown/markdown.module.js +5 -13
- package/esm2015/modules/markdown/markdown.pipe.js +2 -2
- package/esm2015/modules/module-info/module-info.component.js +8 -8
- package/esm2015/modules/module-info/module-info.module.js +5 -9
- package/esm2015/modules/safe-html/safe-html.component.js +3 -3
- package/esm2015/modules/safe-html/safe-html.module.js +5 -13
- package/esm2015/modules/shared/docs-tools-options.js +1 -1
- package/esm2015/modules/shared/docs-tools-supportal.service.js +2 -2
- package/esm2015/modules/shared/sky-docs-tools-resources.module.js +21 -9
- package/esm2015/modules/source-code/source-code-file.js +1 -1
- package/esm2015/modules/source-code/source-code-provider.js +2 -2
- package/esm2015/modules/source-code/source-code.service.js +4 -4
- package/esm2015/modules/thumbnail/thumbnail.component.js +3 -3
- package/esm2015/modules/thumbnail/thumbnail.module.js +6 -17
- package/esm2015/modules/type-definitions/anchor-link.service.js +15 -7
- package/esm2015/modules/type-definitions/call-signature-definition.component.js +5 -5
- package/esm2015/modules/type-definitions/call-signature-definition.js +1 -1
- package/esm2015/modules/type-definitions/class-definition.component.js +3 -3
- package/esm2015/modules/type-definitions/class-definition.js +1 -1
- package/esm2015/modules/type-definitions/comment-tags.js +1 -1
- package/esm2015/modules/type-definitions/directive-definition.component.js +3 -3
- package/esm2015/modules/type-definitions/directive-definition.js +1 -1
- package/esm2015/modules/type-definitions/entry-child-definition.js +1 -1
- package/esm2015/modules/type-definitions/entry-definition.js +1 -1
- package/esm2015/modules/type-definitions/enumeration-definition.component.js +3 -3
- package/esm2015/modules/type-definitions/enumeration-definition.js +1 -1
- package/esm2015/modules/type-definitions/enumeration-member-definition.js +1 -1
- package/esm2015/modules/type-definitions/index-signature-definition.js +1 -1
- package/esm2015/modules/type-definitions/interface-definition.component.js +6 -4
- package/esm2015/modules/type-definitions/interface-definition.js +1 -1
- package/esm2015/modules/type-definitions/interface-property-definition.js +1 -1
- package/esm2015/modules/type-definitions/method-definition.js +1 -1
- package/esm2015/modules/type-definitions/method-definitions.component.js +7 -7
- package/esm2015/modules/type-definitions/parameter-definition.js +1 -1
- package/esm2015/modules/type-definitions/pipe-definition.component.js +3 -3
- package/esm2015/modules/type-definitions/pipe-definition.js +1 -1
- package/esm2015/modules/type-definitions/property-decorator.js +1 -1
- package/esm2015/modules/type-definitions/property-definition.js +1 -1
- package/esm2015/modules/type-definitions/property-definitions.component.js +7 -7
- package/esm2015/modules/type-definitions/type-alias-definition.component.js +6 -4
- package/esm2015/modules/type-definitions/type-alias-definition.js +1 -1
- package/esm2015/modules/type-definitions/type-anchor-links.pipe.js +3 -3
- package/esm2015/modules/type-definitions/type-definition.js +1 -1
- package/esm2015/modules/type-definitions/type-definitions-format.service.js +21 -19
- package/esm2015/modules/type-definitions/type-definitions-provider.js +1 -1
- package/esm2015/modules/type-definitions/type-definitions.js +1 -1
- package/esm2015/modules/type-definitions/type-definitions.module.js +7 -7
- package/esm2015/modules/type-definitions/type-definitions.service.js +6 -6
- package/esm2015/modules/type-definitions/type-parameter-definition.js +1 -1
- package/esm2015/modules/type-definitions/typedoc-adapter.service.js +110 -61
- package/esm2015/modules/type-definitions/typedoc-types.js +1 -1
- package/esm2015/public-api.js +1 -1
- package/fesm2015/skyux-docs-tools.js +351 -349
- package/fesm2015/skyux-docs-tools.js.map +1 -1
- package/modules/type-definitions/typedoc-types.d.ts +5 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -11,6 +11,7 @@
|
|
|
11
11
|
- Run `npm i -ED @skyux-sdk/builder-plugin-skyux`.
|
|
12
12
|
|
|
13
13
|
- Remove any custom styles that are hiding the Omnibar. Instead, create a **skyuxconfig.e2e.json** file with the following contents:
|
|
14
|
+
|
|
14
15
|
```
|
|
15
16
|
{
|
|
16
17
|
"omnibar": false
|
|
@@ -18,6 +19,7 @@
|
|
|
18
19
|
```
|
|
19
20
|
|
|
20
21
|
- Open **skyuxconfig.json** and add the following:
|
|
22
|
+
|
|
21
23
|
```
|
|
22
24
|
{
|
|
23
25
|
// ...
|
|
@@ -67,11 +69,13 @@ export class AppExtrasModule { }
|
|
|
67
69
|
```
|
|
68
70
|
|
|
69
71
|
- Create the following files (as you would normally when creating a new SPA route):
|
|
72
|
+
|
|
70
73
|
- **./src/app/docs/[module-name]/index.html**
|
|
71
74
|
- **./src/app/docs/[module-name]/[module-name]-docs.component.html**
|
|
72
75
|
- **./src/app/docs/[module-name]/[module-name]-docs.component.ts**
|
|
73
76
|
|
|
74
77
|
- Add the following contents to the component's HTML file:
|
|
78
|
+
|
|
75
79
|
```
|
|
76
80
|
<sky-docs-demo-page
|
|
77
81
|
moduleName="SkySampleModule"
|
|
@@ -97,6 +101,7 @@ export class AppExtrasModule { }
|
|
|
97
101
|
```
|
|
98
102
|
|
|
99
103
|
- Add package dependencies for demos
|
|
104
|
+
|
|
100
105
|
```
|
|
101
106
|
<sky-docs-code-examples
|
|
102
107
|
[packageDependencies]="{
|
|
@@ -109,10 +114,12 @@ export class AppExtrasModule { }
|
|
|
109
114
|
## JSDoc comments
|
|
110
115
|
|
|
111
116
|
### Features:
|
|
117
|
+
|
|
112
118
|
- Accepts markdown.
|
|
113
119
|
- Links to internal types are automatically added.
|
|
114
120
|
|
|
115
121
|
### Tags:
|
|
122
|
+
|
|
116
123
|
- `@example` Specifies an inline code example.
|
|
117
124
|
- `@internal` Hides the property or type from documentation.
|
|
118
125
|
- `@default` Deliberately specifies a default value if one isn't obvious from the source code (for example, when a getter/setter is used).
|
|
@@ -121,6 +128,7 @@ export class AppExtrasModule { }
|
|
|
121
128
|
- `@param` Provides a description for a specific parameter in a method or function.
|
|
122
129
|
|
|
123
130
|
## Code Examples
|
|
131
|
+
|
|
124
132
|
- Code examples are automatically generated from source code added to `./src/app/public/plugin-resources/code-examples`.
|
|
125
133
|
- Each code example should be self-contained (in its own folder) and have its own module. The module will dictate its own exports, imports, providers, or entry components.
|
|
126
134
|
- Code examples are not instrumented for code coverage and are not included in any build results.
|