docs: facelift the docs (#20180)

* docs: facelift the docs * lint * license headers
2026-04-14 05:34:38 +00:00 · 2022-06-06 08:01:21 -07:00
parent c131f025f8
commit df00f0e7ab
8 changed files with 201 additions and 37 deletions
--- a/docs/src/styles/custom.css
+++ b/docs/src/styles/custom.css
@@ -0,0 +1,113 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Any CSS included here will be global. The classic template
+ * bundles Infima by default. Infima is a CSS framework designed to
+ * work well for content-centric websites.
+ */
+
+/* You can override the default Infima variables here. */
+@import url('https://fonts.googleapis.com/css2?family=Inter&display=swap');
+
+:root {
+  --ifm-color-primary: #20a7c9;
+  --ifm-color-primary-dark: #1985a0;
+  --ifm-color-primary-darker: #t;
+  --ifm-color-primary-darkest: #ffffff;
+  --ifm-color-primary-light: #79cade;
+  --ifm-color-primary-lighter: #a5dbe9;
+  --ifm-color-primary-lightest: #d2edf4;
+  --ifm-code-font-size: 95%;
+  --ifm-menu-link-padding-vertical: 12px;
+  --doc-sidebar-width: 350px !important;
+  --ifm-navbar-height: none;
+  --ifm-font-family-base: Inter;
+}
+body {
+  font-family: Inter !important;
+}
+.DocSearch-Button .DocSearch-Button-Key {
+  display: none;
+}
+.github-logo-container {
+  background-image: url('/img/github.png');
+  background-size: contain;
+  width: 30px;
+  height: 30px;
+}
+
+.theme-doc-toc-desktop {
+  position: fixed !important;
+}
+
+.docusaurus-highlight-code-line {
+  background-color: rgba(0, 0, 0, 0.1);
+  display: block;
+  margin: 0 calc(-1 * var(--ifm-pre-padding));
+  padding: 0 var(--ifm-pre-padding);
+}
+
+html[data-theme='dark'] .docusaurus-highlight-code-line {
+  background-color: rgba(0, 0, 0, 0.3);
+}
+
+.navbar__logo {
+  height: 40px;
+}
+
+.navbar-sidebar__brand {
+  padding-left: 0;
+}
+
+.menu,
+.navbar {
+  font-size: 14px;
+  font-weight: 400;
+}
+
+/* Hacks to disable Swagger UI's "try it out" interactive mode */
+.try-out,
+.auth-wrapper,
+.information-container {
+  display: none !important;
+}
+
+.swagger-ui table td,
+.swagger-ui table th,
+.swagger-ui table tr {
+  border: none;
+}
+
+.markdown h2:first-child {
+  margin-top: 0.5em;
+}
+
+@media only screen and (min-width: 800px) {
+  .navbar__logo {
+    height: 50px;
+  }
+
+  .navbar {
+    padding-left: 0;
+  }
+}
+a > span > svg {
+  display: none;
+}