Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
162 changes: 77 additions & 85 deletions source/_static/css/custom.css
Original file line number Diff line number Diff line change
Expand Up @@ -6,18 +6,17 @@ body {
font-style: normal;
font-weight: 300;
font-size: 18px;
background-color: #363636;
color: #D5D5D5;
color: #1F2121;
letter-spacing: 0px;
}

a, a:visited {
color: #00ACF1;
color: #02B388;
text-decoration: none;
}
a:hover,
a:focus {
color: #0088be;
color: #016454;
text-decoration: none;
}

Expand All @@ -27,8 +26,9 @@ a:focus {

img.logo {
width: 232px !important;
height: 82px !important;
height: 57px !important;
padding: 0px !important;
margin-bottom: 10px !important;
}

.wy-side-nav-search, .wy-side-nav-search>a:hover {
Expand All @@ -49,7 +49,7 @@ h1 {
font-style: normal;
font-weight: 300;
font-size: 36pt;
color: #D5D5D5;
color: #1F2121;
padding-bottom: 60px;
padding-top: 5px;
line-height: 48px;
Expand All @@ -62,27 +62,27 @@ h2 {
line-height: 1.1;
padding-top: 5px;
padding-bottom: 10px;
border-bottom: 1px solid #5f5f5f;
border-bottom: 1px solid #eaeaea;
margin-bottom: 20px;
}

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

After reviewing the changes on ReadtheDocs, it looks like the color of h3 elements will need to be updated from white to something darker. Right now there are a few h3 headers that cannot be read because they are white on white.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for catching that, will take a look and fix

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Resolved in 549fcf5

h3 {
font-family: 'Open Sans';
font-style: normal;
color: white;
color: #1F2121;
font-size: 18pt;
font-weight: 500;
padding: 10px 10px 10px 0;
}

hr {
border-top: 1px solid #5f5f5f;
border-top: 1px solid #eaeaea;
margin-bottom: 10px;
margin-top: 0;
}

.document {
color: #D5D5D5;
color: #1F2121;
}

div.section h1 {
Expand Down Expand Up @@ -159,22 +159,26 @@ tr:nth-child(odd) {
}

code.docutils {
background: #3F3F3F;
border: none;
}

code.docutils.literal {
background-color: #3F3F3F;
padding: 0px !important;
padding: 2px;
border-radius: 4px;
background-color: #F5F5F5;
font-size: .7em;
color: #555555;
margin: 0 0 10px;
word-break: break-all;
word-wrap: break-word;
font-family: Menlo, Monaco, Consolas, "Courier New", monospace;
white-space: pre-wrap;
}

/* applied to <span> for one-liner preformatted text */
.pre {
font-family: Consolas, monospace;
word-break: break-all;
word-wrap: break-word !important;
color: #FFFFFF;
background-color: #2CBF58;
color: #1F2121;
background-color: #CCF0E7;
border-radius: 4px;
padding: 6px 4px 4px 4px !important;
font-size: 14px !important;
Expand All @@ -187,8 +191,8 @@ pre {

/* applied to <pre> for multi-line preformatted text */
.literal-block {
color: #FFFFFF;
background-color: #2CBF58 !important;
color: #000000;
background-color: #CCF0E7 !important;
font-family: Consolas, monospace;
font-size: 14px !important;
border: none !important;
Expand All @@ -207,15 +211,15 @@ pre {
}

cite {
color: #FFFFFF;
background-color: #2CBF58 !important;
color: #000000;
background-color: #eeeeee !important;
font-family: Consolas, monospace;
font-size: 14px !important;
border: none !important;
border-radius: 4px;
overflow-x: auto;
display: inline;
padding: 0px 2px 2px 2px !important;
padding: 2px 4px !important;
word-break: break-all;
word-wrap: break-word;
white-space: pre-wrap; /* css-3 */
Expand All @@ -226,11 +230,6 @@ cite {
line-height: 25px;
}

/* applied to body, almost everyone lives in here! */
.wy-body-for-nav {
background: #363636 none repeat scroll 0 0;
}

/*********************LEFT HAND NAV************************/
/* search box */
.wy-side-nav-search {
Expand All @@ -256,9 +255,9 @@ cite {

/* nav menu side bar */
.wy-nav-side {
background: #333 none repeat scroll 0 0;
height: 100%;
padding-bottom: 0;
background: #fff;
}

/* menu scroll bar */
Expand All @@ -267,7 +266,6 @@ cite {
overflow-x: hidden;
overflow-y: scroll;
position: relative;
background-color: #333;
}

.wy-menu-vertical {
Expand All @@ -276,33 +274,33 @@ cite {
}

.wy-menu-vertical a {
color: #2CBF58;
color: #02B388;
}

.wy-menu-vertical a:hover {
color: #2CBF58;
color: #016454;
background: #fff;
}

.wy-menu-vertical li.current,
.wy-menu-vertical li.toctree-l2.current > a,
.wy-menu-vertical li.toctree-l2.current li.toctree-l3 > a {
background: #fff;
}

.wy-menu-vertical li.current a:hover {
color: #2CBF58;
color: #02B388 !important;
background: #fff;
}

/* make nav links green */
.wy-menu-vertical li.current > a {
color: #2CBF58;
background-color: rgb(48, 48, 48);
}

.wy-menu-vertical li.current {
background: #333 none repeat scroll 0 0;
color: #016454;
}

.wy-menu-vertical li.current a {
border: 0px;
}

.wy-menu.wy-menu-vertical a {
background-color: #333 !important;
padding-right: 0px;
}

.wy-menu-vertical .toctree-l1 {
Expand All @@ -312,21 +310,16 @@ cite {
.wy-menu-vertical .toctree-l1 > a {
font-weight: 500;
font-size: 110%;
color: #9B9B9B !important;
color: #3B3B3B;
margin: 10px 0;
}

.wy-menu-vertical .toctree-l1.current > a {
color: white !important;
}

.wy-menu-vertical .toctree-l1 > a:hover {
color: white !important;
color: #02B388;
}

.wy-menu-vertical .toctree-l1 > a .toctree-expand {
position: relative;
left: -34px;
.wy-menu-vertical a .toctree-expand {
display: none
}

.wy-menu-vertical .toctree-l1 > a:before {
Expand All @@ -352,13 +345,12 @@ cite {
/*********************RIGHT HAND CONTENT************************/
/* wraps up .wy-nav-content and its subordinates */
.wy-nav-content-wrap {
background-color: #3F3F3F !important;
font-size: 12pt;
background: #fafafa;
}

/* Content in middle (lives inside .wy-nav-content-wrap) */
.wy-nav-content {
background-color: #3F3F3F;
max-width: 1200px;
}

Expand All @@ -371,21 +363,6 @@ cite {
background-color: #EBB336;
}

.rst-content code {
width: 80%;
padding: 2px;
border: 0px;
background-color: #F5F5F5;
font-size: .7em;
color: #555555;
margin: 0 0 10px;
word-break: break-all;
word-wrap: break-word;
border-radius: 4px;
font-family: Menlo, Monaco, Consolas, "Courier New", monospace;
white-space: pre-wrap;
}

.rst-content .section ol li p:last-child {
margin-bottom: 12px;
}
Expand All @@ -394,10 +371,10 @@ cite {
.endpoint-list a {
display: block;
border-radius: 4px;
color: white;
color: #1F2121;
font-weight: 500;
font-size: 14px;
background-color: #6A6A6A;
background-color: rgba(0, 0, 0, 0.03);
padding: 14px;
margin: 5px 0 0 0;
}
Expand All @@ -410,17 +387,17 @@ cite {

.endpoint-list a div.GET {
width: 10%;
color: #1DF0D0;
color: #02B388;
}

.endpoint-list a div.action {
width: 10%;
color: #1DF0D0;
color: #02B388;
}

.endpoint-list a div.POST {
width: 10%;
color: #15DBF6;
color: #02B388;
}

.toctree-l3 ul {
Expand Down Expand Up @@ -458,8 +435,7 @@ cite {
.endpoint-long-description {
cursor: text;
padding: 25px;
background-color: #efefef;
color: #4A4A4A;
background-color: #fff;
border-top-right-radius: 0px;
border-top-left-radius: 0px;
border-bottom-right-radius: 4px;
Expand Down Expand Up @@ -526,16 +502,17 @@ div[role=navigation][aria-label~=breadcrumbs] {
.highlight-json .kc, .kd, .kn, .kp, .kr, .kt, .mf, .mh, .mi, .mo {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This may be out of scope, but while we're here, I wonder if there's anyway we could tweak the json highlighting for the Swagger UI to be in-line with the other API pages?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was noticing the Swagger UI code blocks were hard to read (mainly the yellow JSON strings), but did confirm they were that way before as well and thus hadn't gotten worse -- so, I didn't pull on that thread. I'll see if there is anything quick

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have a vague recollection from when I first implemented this that it was something of a hassle to adjust the highlighting, which probably explains why I left it as the default colors... You may have better luck than me though.

Copy link
Contributor Author

@nburwell nburwell May 29, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Short answer is no.. not without more research and likely updating the swagger JS.

They only support 7 themes, and you configure it in JS and that changes the colors per language and per element
https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/

I switched themes and cleaned up a few overrides, so it's more inline with our styling, but not matching the other blocks and not as readable still as I'd like. Unless we go with a dark background for the textareas, this was the best I could find:
image

color: #445588;
}
table.parameters, table.multiline-table {
border: 0 !important;
}

.wy-table-responsive table td {
white-space: normal !important;
}

.rst-content table.docutils {
border-top-color: #016454;
}

table.parameters th {
background-color: #6A6A6A;
background-color: #016454;
color: #E4E4E4;
}

Expand Down Expand Up @@ -606,14 +583,29 @@ div.endpoint-list div.panel-body .container {
margin-bottom: 0;
}

.panel-body {
padding: 0;
}

.swagger-ui .response-col_description__inner,
.swagger-ui .response-control-media-type,
.swagger-ui .response-col_links
{
display: none;
}
/*********************FOR BOOTSTRAP INTERACTIONS************************/

/******** RTD Versions panel ******/
.rst-versions {
color: #1F2121;
background: #eee;
border-top: solid 10px #aaa;
}

.rst-versions .rst-current-version {
background-color: #ddd;
}

.rst-versions .rst-other-versions dd a {
color: #02B388;
}

.rst-versions .rst-current-version .fa {
color: #1F2121;
padding-top: 5px;
}
Loading