Skip to content

Commit 4c9b297

Browse files
tengqmk8s-ci-robot
authored andcommitted
Reworked API reference doc (#9536)
This PR contains API reference docs generated from the reworked generator (see: kubernetes-sigs/reference-docs#53). The main purpose is to rework the way how examples are shown. When we are happy with the revised version, we can move the CSS and fonts file to the static directory. We only need to change the HTML and the `navData.js` file in the future. Related Issues: #9271, #4015
1 parent 08d06e0 commit 4c9b297

16 files changed

+48119
-115303
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,228 @@
1+
/*
2+
Kubernetes colors
3+
4+
kubernetes blue - rgb(50, 109, 230)
5+
dark blue - rgb(51, 113, 227)
6+
dark grey - rgb(48, 48, 48)
7+
light grey - rgb(161, 160, 158)
8+
*/
9+
10+
/* User agent CSS overrides */
11+
#sidebar-wrapper ul, #sidebar-wrapper li {
12+
margin-left: 10px;
13+
padding-left: 0;
14+
}
15+
16+
.body-content hr {
17+
margin: 2em 0;
18+
border-top: 2px solid dimgrey;
19+
border-bottom: 2px solid antiquewhite;
20+
}
21+
22+
.body-content table {
23+
margin-bottom: 1em;
24+
width: 100%;
25+
overflow: auto;
26+
}
27+
28+
.body-content table th, .body-content table td {
29+
text-align: left;
30+
vertical-align: top;
31+
line-height: 1.5;
32+
}
33+
34+
.body-content table th {
35+
padding: 15px 20px;
36+
border-bottom: 1px solid lightsteelblue;
37+
vertical-align: bottom;
38+
}
39+
40+
.body-content table td {
41+
padding: 10px;
42+
}
43+
44+
.body-content table tr:last-child {
45+
border-bottom: 1px solid lightsteelblue;
46+
}
47+
48+
.body-content table tr:nth-child(odd) > td {
49+
background-color: WhiteSmoke;
50+
}
51+
52+
.body-content table tr:nth-child(even) > td {
53+
background-color: Gainsboro;
54+
}
55+
56+
.body-content dt {
57+
font-weight: bold;
58+
}
59+
60+
.body-content dd {
61+
margin-left: 15px;
62+
}
63+
64+
.body-content p, .body-content li, .body-content dt, .body-content dd {
65+
line-height: 1.6;
66+
margin-top: 0;
67+
}
68+
69+
/* Brodoc CSS */
70+
71+
body > #wrapper {
72+
display: block;
73+
padding-bottom: 500px;
74+
}
75+
76+
#sidebar-wrapper {
77+
display: block;
78+
height: 100%;
79+
width: 20%;
80+
position: fixed;
81+
z-index: 1;
82+
top: 0;
83+
left: 0;
84+
background-color: whitesmoke;
85+
border-right: 2px solid slategrey;
86+
overflow-x: hidden;
87+
padding-top: 60px;
88+
}
89+
90+
#sidebar-wrapper a {
91+
text-decoration: none;
92+
white-space: nowrap;
93+
overflow: hidden;
94+
text-overflow: ellipsis;
95+
padding: 0 5px;
96+
}
97+
98+
#sidebar-wrapper ul {
99+
list-style: none;
100+
}
101+
102+
#sidebar-wrapper a.selected {
103+
font-style: bold;
104+
color: whitesmoke;
105+
border: 1px solid rgb(161, 160, 158);
106+
background-color: rgb(51, 113, 227);
107+
border-radius: 5px;
108+
}
109+
110+
#sidebar-wrapper .strong-nav {
111+
font-family: monospace;
112+
font-weight: bold;
113+
}
114+
115+
#sidebar-wrapper .nav-level-1.strong-nav {
116+
margin-top: 25px;
117+
}
118+
119+
#sidebar-wrapper .copyright {
120+
padding-left: 10px;
121+
padding-top: 50px;
122+
padding-bottom: 50px;
123+
text-decoration: underline;
124+
}
125+
126+
#page-content-wrapper {
127+
margin-left: 20%;
128+
padding-top: 60px;
129+
}
130+
131+
.body-content h1, .body-content h2 {
132+
clear: both;
133+
border-bottom: 3px solid lightslategrey;
134+
padding-top: 20px;
135+
}
136+
137+
.body-content > h3, .body-content > h4, .body-content > h5, .body-content > h6, .body-content > p, .body-content > aside, .body-content > ul > li, .body-content > ul > li {
138+
padding-top: 20px;
139+
}
140+
141+
.body-content table tr td:not(:first-child) {
142+
overflow-wrap: break-word;
143+
word-wrap: break-word;
144+
}
145+
146+
.body-content table tr td a {
147+
word-break: break-word;
148+
}
149+
150+
.body-content p code {
151+
text-overflow: ellipsis;
152+
color: #802060;
153+
display: inline-block;
154+
font-size: smaller;
155+
word-break: break-word;
156+
}
157+
158+
.body-content blockquote {
159+
border-left: 0;
160+
border-radius: 5px;
161+
}
162+
163+
.body-content pre.code-block {
164+
margin-top: 5px;
165+
margin-bottom: 5px;
166+
}
167+
168+
.body-content blockquote p, .body-content pre {
169+
color: black;
170+
font-size: 13px;
171+
}
172+
173+
.body-content blockquote.code-block {
174+
background: Wheat;
175+
}
176+
177+
.body-content pre.code-block code {
178+
word-wrap: normal;
179+
white-space: pre;
180+
}
181+
182+
.body-content code {
183+
color: Brown !important;
184+
}
185+
186+
.code-block {
187+
display: none;
188+
width: 60%;
189+
float: left;
190+
clear: right;
191+
}
192+
193+
.code-block.active {
194+
display: initial;
195+
}
196+
197+
#code-tabs-wrapper {
198+
width: 55%;
199+
height: 60px;
200+
/* position: fixed; */
201+
top: 0;
202+
right: 0;
203+
}
204+
205+
#code-tabs-wrapper .code-tab-list {
206+
float: right;
207+
margin-top: 0;
208+
padding: 0 10px;
209+
}
210+
211+
#code-tabs-wrapper .code-tab {
212+
color: white;
213+
/* display: inline-block; */
214+
padding: 0 30px;
215+
background: rgb(48, 48, 48);
216+
border: 1px solid rgb(161, 160, 158);
217+
border-radius: 5px;
218+
}
219+
220+
#code-tabs-wrapper .tab-selected {
221+
background: rgb(51, 113, 227);
222+
font-style: bold;
223+
border-radius: 5px;
224+
}
225+
226+
.side-nav a {
227+
color: black;
228+
}

static/docs/reference/generated/kubernetes-api/v1.11/index.html

+47,890-112,855
Large diffs are not rendered by default.

static/docs/reference/generated/kubernetes-api/v1.11/navData.js

+1-1
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)