Skip to content

Commit 99c522e

Browse files
Artus-LHINDArtus-LHIND
authored
Merge pull request #1 from Artus-LHIND/develop
Develop
2 parents a025f54 + feaeece commit 99c522e

File tree

17 files changed

+569
-71
lines changed

17 files changed

+569
-71
lines changed

‎.gitignore

+2
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
11
/helm-docs
22
/cmd/helm-docs/helm-docs
33
dist
4+
.idea/
5+
*.iml

‎README.md

+27-5
Original file line numberDiff line numberDiff line change
@@ -85,16 +85,30 @@ The templates generated by the tool are shown below, and can be included in your
8585
| Name | Description |
8686
|------|-------------|
8787
| chart.header | The main heading of the generated markdown file |
88+
| chart.deprecationWarning | A deprecation warning which is displayed when the _deprecated_ field from the chart's `Chart.yaml` file is `true` |
8889
| chart.description | A description line containing the _description_ field from the chart's `Chart.yaml` file, or "" if that field is not set |
8990
| chart.version | The _version_ field from the chart's `Chart.yaml` file |
9091
| chart.versionLine | A text line stating the current version of the chart |
92+
| chart.versionBadge | A badge stating the current version of the chart |
9193
| chart.type | The _type_ field from the chart's `Chart.yaml` file |
9294
| chart.typeLine | A text line stating the current type of the chart |
93-
| chart.sourceLink | The _home_ link from the chart's `Chart.yaml` file, or "" if that field is not set |
94-
| chart.sourceLinkLine | A text line with the _home_ link from the chart's `Chart.yaml` file, or "" if that field is not set |
95+
| chart.typeBadge | A badge stating the current type of the chart |
96+
| chart.appVersion | The _appVersion_ field from the chart's `Chart.yaml` file |
97+
| chart.appVersionLine | A text line stating the current appVersion of the chart |
98+
| chart.appVersionBadge | A badge stating the current appVersion of the chart |
99+
| chart.homepage | The _home_ link from the chart's `Chart.yaml` file, or "" if that field is not set |
100+
| chart.homepageLine | A text line stating the current homepage of the chart |
101+
| chart.maintainersHeader | The heading for the chart maintainers section |
102+
| chart.maintainersTable | A table of the chart's maintainers |
103+
| chart.maintainersSection | A section headed by the maintainersHeader from above containing the maintainersTable from above or "" if there are no maintainers |
104+
| chart.sourcesHeader | The heading for the chart sources section |
105+
| chart.sourcesList | A list of the chart's sources |
106+
| chart.sourcesSection | A section headed by the sourcesHeader from above containing the sourcesList from above or "" if there are no sources |
107+
| chart.kubeVersion | The _kubeVersion_ field from the chart's `Chart.yaml` file |
108+
| chart.kubeVersionLine | A text line stating the required Kubernetes version for the chart |~~~~
95109
| chart.requirementsHeader | The heading for the chart requirements section |
96110
| chart.requirementsTable | A table of the chart's required sub-charts |
97-
| chart.requirementsSection | A section headed by the requirementsHeader from above containing the requirementsTable from above or "" if there are no requirements |
111+
| chart.requirementsSection | A section headed by the requirementsHeader from above containing the kubeVersionLine and/or the requirementsTable from above or "" if there are no requirements |
98112
| chart.valuesHeader | The heading for the chart values section |
99113
| chart.valuesTable | A table of the chart's values parsed from the `values.yaml` file (see below) |
100114
| chart.valuesSection | A section headed by the valuesHeader from above containing the valuesTable from above or "" if there are no values |
@@ -106,11 +120,19 @@ If there is no `README.md.gotmpl` (or other specified gotmpl file) present, the
106120
That template looks like so:
107121
```
108122
{{ template "chart.header" . }}
123+
{{ template "chart.deprecationWarning" . }}
124+
125+
{{ template "chart.versionBadge" . }}
126+
{{ template "chart.typeBadge" . }}
127+
{{ template "chart.appVersionBadge" . }}
128+
109129
{{ template "chart.description" . }}
110130
111-
{{ template "chart.versionLine" . }}
131+
{{ template "chart.homepageLine" . }}
132+
133+
{{ template "chart.maintainersSection" . }}
112134
113-
{{ template "chart.sourceLinkLine" . }}
135+
{{ template "chart.sourcesSection" . }}
114136
115137
{{ template "chart.requirementsSection" . }}
116138

‎example-charts/custom-template/README.md

+4-6
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,23 @@
1-
custom-template
2-
===============
1+
# custom-template
2+
33
Basically the same as the nginx-ingress chart, but using a custom template to include some other content
44

55
Current chart version is `0.2.0`
66

7-
Source code can be found [here](https://github.com/norwoodj/helm-docs/tree/master/example-charts/custom-template)
8-
97
## Additional Information
108
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore
119
et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut
1210
aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse
1311
cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in
1412
culpa qui officia deserunt mollit anim id est laborum.
1513

16-
## Chart Requirements
14+
## Requirements
1715

1816
| Repository | Name | Version |
1917
|------------|------|---------|
2018
| @stable | nginx-ingress | 0.22.1 |
2119

22-
## Chart Values
20+
## Values
2321

2422
| Key | Type | Default | Description |
2523
|-----|------|---------|-------------|

‎example-charts/custom-template/README.md.gotmpl

-2
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33

44
{{ template "chart.versionLine" . }}
55

6-
{{ template "chart.sourceLinkLine" . }}
7-
86
## Additional Information
97
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore
108
et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut

‎example-charts/full-template/Chart.yaml

+19
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
apiVersion: v2
2+
name: full-template
3+
deprecated: true
4+
version: "1.0.0"
5+
type: application
6+
appVersion: "13.0.0"
7+
description: A chart for showing every README-element
8+
home: "https://github.com/norwoodj/helm-docs/tree/master/example-charts/full-template"
9+
maintainers:
10+
- email: [email protected]
11+
name: John Norwood
12+
sources: ["https://github.com/norwoodj/helm-docs/tree/master/example-charts/full-template"]
13+
kubeVersion: "<=1.18"
14+
engine: gotpl
15+
16+
dependencies:
17+
- name: nginx-ingress
18+
version: "0.22.1"
19+
repository: "@stable"

‎example-charts/full-template/README.md

+154
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
1+
# full-template
2+
3+
## `chart.deprecationWarning`
4+
5+
> **:exclamation: This Helm Chart is deprecated!**
6+
7+
## `chart.description`
8+
9+
A chart for showing every README-element
10+
11+
## `chart.version`
12+
13+
1.0.0
14+
15+
## `chart.versionLine`
16+
17+
Current chart version is `1.0.0`
18+
19+
## `chart.versionBadge`
20+
21+
![Version: 1.0.0](https://img.shields.io/badge/Version-1.0.0-informational?style=flat-square)
22+
23+
## `chart.type`
24+
25+
application
26+
27+
## `chart.typeLine`
28+
29+
Current chart type is `application`
30+
31+
## `chart.typeBadge`
32+
33+
![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square)
34+
35+
## `chart.appVersion`
36+
37+
13.0.0
38+
39+
## `chart.appVersionLine`
40+
41+
Current chart appVersion is `13.0.0`
42+
43+
## `chart.appVersionBadge`
44+
45+
![AppVersion: 13.0.0](https://img.shields.io/badge/AppVersion-13.0.0-informational?style=flat-square)
46+
47+
## `chart.homepage`
48+
49+
https://github.com/norwoodj/helm-docs/tree/master/example-charts/full-template
50+
51+
## `chart.homepageLine`
52+
53+
**Homepage:** <https://github.com/norwoodj/helm-docs/tree/master/example-charts/full-template>
54+
55+
## `chart.maintainersHeader`
56+
57+
## Maintainers
58+
59+
## `chart.maintainersTable`
60+
61+
| Name | Email | Url |
62+
| ---- | ------ | --- |
63+
| John Norwood | [email protected] | |
64+
65+
## `chart.maintainersSection`
66+
67+
## Maintainers
68+
69+
| Name | Email | Url |
70+
| ---- | ------ | --- |
71+
| John Norwood | [email protected] | |
72+
73+
## `chart.sourcesHeader`
74+
75+
## Source Code
76+
77+
## `chart.sourcesList`
78+
79+
80+
* <https://github.com/norwoodj/helm-docs/tree/master/example-charts/full-template>
81+
82+
## `chart.sourcesSection`
83+
84+
## Source Code
85+
86+
* <https://github.com/norwoodj/helm-docs/tree/master/example-charts/full-template>
87+
88+
## `chart.kubeVersion`
89+
90+
<=1.18
91+
92+
## `chart.kubeVersionLine`
93+
94+
Kubernetes: `<=1.18`
95+
96+
## `chart.requirementsHeader`
97+
98+
## Requirements
99+
100+
## `chart.requirementsTable`
101+
102+
| Repository | Name | Version |
103+
|------------|------|---------|
104+
| @stable | nginx-ingress | 0.22.1 |
105+
106+
## `chart.requirementsSection`
107+
108+
## Requirements
109+
110+
Kubernetes: `<=1.18`
111+
112+
| Repository | Name | Version |
113+
|------------|------|---------|
114+
| @stable | nginx-ingress | 0.22.1 |
115+
116+
## `chart.valuesHeader`
117+
118+
## Values
119+
120+
## `chart.valuesTable`
121+
122+
| Key | Type | Default | Description |
123+
|-----|------|---------|-------------|
124+
| controller.extraVolumes[0].configMap.name | string | `"nginx-ingress-config"` | Uses the name of the configmap created by this chart |
125+
| controller.extraVolumes[0].name | string | `"config-volume"` | |
126+
| controller.image.repository | string | `"nginx-ingress-controller"` | |
127+
| controller.image.tag | string | `"18.0831"` | |
128+
| controller.ingressClass | string | `"nginx"` | Name of the ingress class to route through this controller |
129+
| controller.name | string | `"controller"` | |
130+
| controller.persistentVolumeClaims | list | the chart will construct this list internally unless specified | List of persistent volume claims to create. For very long comments, break them into multiple lines. |
131+
| controller.podLabels | object | `{}` | The labels to be applied to instances of the controller pod |
132+
| controller.publishService.enabled | bool | `false` | Whether to expose the ingress controller to the public world |
133+
| controller.replicas | int | `nil` | Number of nginx-ingress pods to load balance between |
134+
| controller.service.annotations."external-dns.alpha.kubernetes.io/hostname" | string | `"stupidchess.jmn23.com"` | Hostname to be assigned to the ELB for the service |
135+
| controller.service.type | string | `"LoadBalancer"` | |
136+
137+
## `chart.valuesSection`
138+
139+
## Values
140+
141+
| Key | Type | Default | Description |
142+
|-----|------|---------|-------------|
143+
| controller.extraVolumes[0].configMap.name | string | `"nginx-ingress-config"` | Uses the name of the configmap created by this chart |
144+
| controller.extraVolumes[0].name | string | `"config-volume"` | |
145+
| controller.image.repository | string | `"nginx-ingress-controller"` | |
146+
| controller.image.tag | string | `"18.0831"` | |
147+
| controller.ingressClass | string | `"nginx"` | Name of the ingress class to route through this controller |
148+
| controller.name | string | `"controller"` | |
149+
| controller.persistentVolumeClaims | list | the chart will construct this list internally unless specified | List of persistent volume claims to create. For very long comments, break them into multiple lines. |
150+
| controller.podLabels | object | `{}` | The labels to be applied to instances of the controller pod |
151+
| controller.publishService.enabled | bool | `false` | Whether to expose the ingress controller to the public world |
152+
| controller.replicas | int | `nil` | Number of nginx-ingress pods to load balance between |
153+
| controller.service.annotations."external-dns.alpha.kubernetes.io/hostname" | string | `"stupidchess.jmn23.com"` | Hostname to be assigned to the ELB for the service |
154+
| controller.service.type | string | `"LoadBalancer"` | |

‎example-charts/full-template/README.md.gotmpl

+108
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,108 @@
1+
{{ template "chart.header" . }}
2+
## `chart.deprecationWarning`
3+
4+
{{ template "chart.deprecationWarning" . }}
5+
6+
## `chart.description`
7+
8+
{{ template "chart.description" . }}
9+
10+
## `chart.version`
11+
12+
{{ template "chart.version" . }}
13+
14+
## `chart.versionLine`
15+
16+
{{ template "chart.versionLine" . }}
17+
18+
## `chart.versionBadge`
19+
20+
{{ template "chart.versionBadge" . }}
21+
22+
## `chart.type`
23+
24+
{{ template "chart.type" . }}
25+
26+
## `chart.typeLine`
27+
28+
{{ template "chart.typeLine" . }}
29+
30+
## `chart.typeBadge`
31+
32+
{{ template "chart.typeBadge" . }}
33+
34+
## `chart.appVersion`
35+
36+
{{ template "chart.appVersion" . }}
37+
38+
## `chart.appVersionLine`
39+
40+
{{ template "chart.appVersionLine" . }}
41+
42+
## `chart.appVersionBadge`
43+
44+
{{ template "chart.appVersionBadge" . }}
45+
46+
## `chart.homepage`
47+
48+
{{ template "chart.homepage" . }}
49+
50+
## `chart.homepageLine`
51+
52+
{{ template "chart.homepageLine" . }}
53+
54+
## `chart.maintainersHeader`
55+
56+
{{ template "chart.maintainersHeader" . }}
57+
58+
## `chart.maintainersTable`
59+
60+
{{ template "chart.maintainersTable" . }}
61+
62+
## `chart.maintainersSection`
63+
64+
{{ template "chart.maintainersSection" . }}
65+
66+
## `chart.sourcesHeader`
67+
68+
{{ template "chart.sourcesHeader" . }}
69+
70+
## `chart.sourcesList`
71+
72+
{{ template "chart.sourcesList" . }}
73+
74+
## `chart.sourcesSection`
75+
76+
{{ template "chart.sourcesSection" . }}
77+
78+
## `chart.kubeVersion`
79+
80+
{{ template "chart.kubeVersion" . }}
81+
82+
## `chart.kubeVersionLine`
83+
84+
{{ template "chart.kubeVersionLine" . }}
85+
86+
## `chart.requirementsHeader`
87+
88+
{{ template "chart.requirementsHeader" . }}
89+
90+
## `chart.requirementsTable`
91+
92+
{{ template "chart.requirementsTable" . }}
93+
94+
## `chart.requirementsSection`
95+
96+
{{ template "chart.requirementsSection" . }}
97+
98+
## `chart.valuesHeader`
99+
100+
{{ template "chart.valuesHeader" . }}
101+
102+
## `chart.valuesTable`
103+
104+
{{ template "chart.valuesTable" . }}
105+
106+
## `chart.valuesSection`
107+
108+
{{ template "chart.valuesSection" . }}

0 commit comments

Comments
 (0)