d47bd0b5c3
Add infrastructure for switching production documentation to use the cleaner read_the_docs theme as noted in issue #6774. This change won't affect the current "daily" or "release" builds but will change local builds that previously also used the RTD theme, but now have the version selection capability added. This PR also adds the Zephyr logo and favicon to the RTD-themed docs, and moves the top level images into an images/ folder. Note that issue #9128 requires workaround.rst to force a reference to files needed for the build but not directly referened in a .rst file. (When #9128 is fixed, we can remove this workaround.rst.) Once merged and tested, we'll tweak the conf.py to use the RTD theme for all doc builds (e.g, when DOC_TAG=daily or release) in a subsequent PR. Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
136 lines
2.7 KiB
CSS
136 lines
2.7 KiB
CSS
/* -- Extra CSS styles for Zephyr content (RTD theme) ----------------------- */
|
|
|
|
/* make the page width fill the window */
|
|
.wy-nav-content {
|
|
max-width: none;
|
|
}
|
|
|
|
/* pygments tweak for white-on-black console */
|
|
/* hold off on this change for now
|
|
|
|
.highlight-console .highlight {
|
|
background-color: black;
|
|
}
|
|
.highlight-console .highlight .go, .highlight-console .highlight .gp {
|
|
color: white;
|
|
}
|
|
.highlight-console .highlight .hll {
|
|
background-color: white;
|
|
}
|
|
.highlight-console .highlight .hll .go, .highlight-console .highlight .hll .gp {
|
|
color: black;
|
|
font-weight: bold;
|
|
}
|
|
*/
|
|
|
|
/* tweak doc version selection
|
|
.rst-versions {
|
|
position: static;
|
|
border-top: none;
|
|
padding: 0px;
|
|
}
|
|
*/
|
|
|
|
.rst-versions .rst-current-version {
|
|
padding: 5px;
|
|
background-color: #2980B9;
|
|
color: #80FF80;
|
|
}
|
|
|
|
.rst-versions .rst-other-versions {
|
|
padding: 5px;
|
|
}
|
|
|
|
div.rst-other-versions dl {
|
|
margin-bottom: 0;
|
|
}
|
|
|
|
|
|
/* code block highlight color in rtd changed to lime green, no no no */
|
|
|
|
.rst-content tt.literal, .rst-content code.literal, .highlight {
|
|
background: #f0f0f0;
|
|
}
|
|
.rst-content tt.literal, .rst-content code.literal {
|
|
color: #000000;
|
|
}
|
|
|
|
/* Make the version number more visible */
|
|
.wy-side-nav-search>div.version {
|
|
color: rgba(255,255,255,1);
|
|
}
|
|
|
|
/* squish the space between a paragraph before a list */
|
|
div > p + ul, div > p + ol {
|
|
margin-top: -20px;
|
|
}
|
|
|
|
/* add some space before the figure caption */
|
|
p.caption {
|
|
# border-top: 1px solid;
|
|
margin-top: 1em;
|
|
}
|
|
|
|
/* decrease line leading a bit, 24px is too wide */
|
|
|
|
p {
|
|
line-height: 22px;
|
|
}
|
|
|
|
/* add a colon after the figure/table number (before the caption) */
|
|
span.caption-number::after {
|
|
content: ": ";
|
|
}
|
|
|
|
p.extrafooter {
|
|
text-align: right;
|
|
margin-top: -36px;
|
|
}
|
|
|
|
table.align-center {
|
|
display: table !important;
|
|
}
|
|
|
|
|
|
.code-block-caption {
|
|
color: #000;
|
|
font: italic 85%/1 arial,sans-serif;
|
|
padding: 1em 0;
|
|
text-align: center;
|
|
}
|
|
|
|
/* make .. hlist:: tables fill the page */
|
|
table.hlist {
|
|
width: 95% !important;
|
|
}
|
|
|
|
/* override rtd theme white-space no-wrap in table heading and content */
|
|
th,td {
|
|
white-space: normal !important;
|
|
}
|
|
|
|
/* dbk tweak for doxygen-generated API headings (for RTD theme) */
|
|
.rst-content dl.group>dt, .rst-content dl.group>dd>p {
|
|
display:none !important;
|
|
}
|
|
.rst-content dl.group {
|
|
margin: 0 0 12px 0px;
|
|
}
|
|
.rst-content dl.group>dd {
|
|
margin-left: 0 !important;
|
|
}
|
|
.rst-content p.breathe-sectiondef-title {
|
|
text-decoration: underline; /* dbk for API sub-headings */
|
|
font-size: 1.25rem;
|
|
font-weight: bold;
|
|
margin-bottom: 12px;
|
|
}
|
|
.rst-content div.breathe-sectiondef {
|
|
padding-left: 0 !important;
|
|
}
|
|
|
|
/* tweak display of option tables to make first column wider */
|
|
col.option {
|
|
width: 25%;
|
|
}
|