index.scss

// Override bootstrap variables
$spacer: 1rem;

$container-max-widths: (
  sm: 540px,
  md: 720px,
  lg: 960px,
  xl: 1400px,
);

$grid-breakpoints: (
  xs: 0,
  sm: 540px,
  md: 720px,
  lg: 960px,
  xl: 1200px,
);

// Import Bootstrap core
@import "~bootstrap/scss/bootstrap";

@import "./color";
@import "./base";
@import "./navbar";
@import "./admonitions";
@import "./api";
@import "./markdown";
@import "./versionmodified";
@import "./ethical-ads";

// Custom css, TODO: to be refactored in different partials
// GitHub blockquote style
blockquote {
  padding: 0 1em;
  color: var(--pst-color-deactivate);
  border-left: 0.25em solid var(--pst-color-blockquote-border);
}

// For consistency, add bracket around footnotes/citations which are
// cited more than once. E.g. [Newton](1,2) instead of Newton(1,2)
dt.label > span.brackets:not(:only-child):before {
  content: "[";
}

dt.label > span.brackets:not(:only-child):after {
  content: "]";
}

// Make footnote as a supercript
a.footnote-reference {
  vertical-align: super;
  font-size: small;
}

.topic {
  background-color: var(--pst-color-background-up);
  border-color: var(--pst-color-border);
}

aside.sidebar {
  background-color: var(--pst-color-background-up-up);
  border-color: var(--pst-color-border);
}

.seealso dd {
  margin-top: 0;
  margin-bottom: 0;
}

.viewcode-back {
  font-family: var(--pst-font-family-base);
}

.viewcode-block:target {
  background-color: #f4debf;
  border-top: 1px solid #ac9;
  border-bottom: 1px solid #ac9;
}

span.guilabel {
  border: 1px solid var(--pst-color-guilabel-border);
  background: var(--pst-color-guilabel-background);
  color: var(--pst-color-guilabel-text);
  font-size: 80%;
  font-weight: 700;
  border-radius: 4px;
  padding: 2.4px 6px;
  margin: auto 2px;
}

/**
 * Footer
 */

footer {
  width: 100%;
  border-top: 1px solid var(--pst-color-footer-border);
  padding: 10px;

  .footer-item p {
    margin-bottom: 0;
  }
}

/* -------------------------------------------------------------------------- */

.bd-search {
  position: relative;
  padding: 1rem 15px;
  margin-right: -15px;
  margin-left: -15px;

  .icon {
    position: absolute;
    color: var(--pst-color-search);
    left: 25px;
  }

  input {
    background-color: var(--pst-color-search-background);
    border-style: none none solid none;
    border-color: var(--pst-color-search-border);
    border-width: 1px;
    border-radius: 0px;
    padding-left: 35px;
    color: var(--pst-color-text-base);

    // Inner-text of the search bar
    &::placeholder {
      color: var(--pst-color-search);
    }

    // Background should always be same color regardless of active or nor
    &:active,
    &:focus {
      background-color: var(--pst-color-search-background);
      color: var(--pst-color-search);
    }
  }
}

/* minimal copy paste from bootstrap docs css to get sidebars working */

.bd-toc {
  -ms-flex-order: 2;
  order: 2;

  height: calc(100vh - 2rem);
  overflow-y: auto;

  @supports (position: -webkit-sticky) or (position: sticky) {
    position: -webkit-sticky;
    position: sticky;
    top: var(--pst-header-height);
    height: calc(100vh - 5rem);
    overflow-y: auto;
  }

  .onthispage {
    color: var(--pst-color-text-base);
  }
}

.section-nav {
  padding-left: 0;
  border-left: 1px solid var(--pst-color-toc-border);
  border-bottom: none;

  ul {
    padding-left: 1rem;
  }
}

.toc-entry {
  display: block;

  a {
    display: block;
    padding: 0.125rem 1.5rem;
    color: var(--pst-color-toc-link);

    @include media-breakpoint-up(xl) {
      padding-right: 0;
    }

    &:hover {
      color: var(--pst-color-toc-link-hover);
      text-decoration: none;
    }
  }
}

.bd-sidebar {
  padding-top: 1em;
  overflow-y: auto;
  display: flex;
  flex-direction: column;

  @include media-breakpoint-up(md) {
    border-right: 1px solid var(--pst-color-sidebar-border);

    @supports (position: -webkit-sticky) or (position: sticky) {
      position: -webkit-sticky;
      position: sticky;
      top: var(--pst-header-height);
      z-index: 1000;
      height: calc(100vh - var(--pst-header-height));
    }
  }

  &.no-sidebar {
    border-right: 0;
  }

  .sidebar-end-items {
    margin-top: auto;
    margin-bottom: 1em;
  }
}

.bd-links {
  padding-top: 1rem;
  padding-bottom: 1rem;
  margin-right: -15px;
  margin-left: -15px;

  @include media-breakpoint-up(md) {
    display: block;
  }
}

.bd-sidenav {
  display: none;
}

.bd-content {
  padding-top: 20px;

  .section {
    max-width: 100%;

    // make every overflowing elements in main content scrollable
    table {
      display: block;
      overflow: auto;
    }
  }
}

.bd-toc-link {
  display: block;
  padding: 0.25rem 1.5rem;
  font-weight: 600;
  color: rgba(0, 0, 0, 0.65);

  &:hover {
    color: rgba(0, 0, 0, 0.85);
    text-decoration: none;
  }
}

.bd-toc-item.active {
  margin-bottom: 1rem;

  &:not(:first-child) {
    margin-top: 1rem;
  }

  > {
    .bd-toc-link {
      color: rgba(0, 0, 0, 0.85);

      &:hover {
        background-color: transparent;
      }
    }

    .bd-sidenav {
      display: block;
    }
  }
}

nav.bd-links {
  p.caption {
    font-size: var(--pst-sidebar-caption-font-size);
    text-transform: uppercase;
    font-weight: bold;
    position: relative;
    margin-top: 1.25em;
    margin-bottom: 0.5em;
    padding: 0 1.5rem;
    color: var(--pst-color-sidebar-caption);
    &:first-child {
      margin-top: 0;
    }
  }
}

.bd-sidebar .nav {
  font-size: var(--pst-sidebar-font-size);

  ul {
    list-style: none;
    padding: 0 0 0 1.5rem;
  }

  li > a {
    display: block;
    padding: 0.25rem 1.5rem;
    color: var(--pst-color-sidebar-link);

    &:hover {
      color: var(--pst-color-sidebar-link-hover);
      text-decoration: none;
      background-color: transparent;
    }

    &.reference.external {
      &:after {
        font-family: "Font Awesome 5 Free";
        font-weight: 900;
        content: "\f35d";
        font-size: 0.75em;
        margin-left: 0.3em;
      }
    }
  }

  .active {
    > a,
    &:hover > a {
      font-weight: 600;
      color: var(--pst-color-sidebar-link-active);
    }
  }
}

/* adjust toc font sizes to improve overview */
.toc-h2 {
  font-size: 0.85rem;
}

.toc-h3 {
  font-size: 0.75rem;
}

.toc-h4 {
  font-size: 0.65rem;
}

.toc-entry > .nav-link.active {
  font-weight: 600;
  color: var(--pst-color-toc-link-active);
  background-color: transparent;
  border-left: 2px solid var(--pst-color-toc-link-active);
}

.nav-link:hover {
  border-style: none;
}

#navbar-main-elements li.nav-item i {
  font-size: 0.7rem;
  padding-left: 2px;
  vertical-align: middle;
}

/* Collapsing of the TOC sidebar while scrolling */

/* Nav: hide second level (shown on .active) */

.bd-toc .nav,
.list-caption {
  .nav {
    display: none;

    // So we can manually specify a level as visible in the config
    &.visible {
      display: block;
    }
  }

  > .active > ul {
    display: block;
  }
}

/* Previous / Next buttons */

.prev-next-area {
  margin: 20px 0px;

  p {
    margin: 0 0.3em;
    line-height: 1.3em;
  }

  i {
    font-size: 1.2em;
  }

  a {
    // So that buttons align with icons
    display: flex;
    align-items: center;
    border: none;
    padding: 10px;
    max-width: 45%;
    overflow-x: hidden;
    color: var(--pst-color-prev-next-btn);
    text-decoration: none;

    p.prev-next-title {
      color: var(--pst-color-prev-next);
      font-weight: 600;
      font-size: 1.1em;
    }

    &:hover p.prev-next-title {
      text-decoration: underline;
    }

    .prev-next-info {
      flex-direction: column;
      margin: 0 0.5em;

      .prev-next-subtitle {
        text-transform: capitalize;
      }
    }

    &.left-prev {
      float: left;
    }

    &.right-next {
      float: right;

      div.prev-next-info {
        text-align: right;
      }
    }
  }
}

/* Alert Styling */

.alert {
  /* Avoid too large empty space below alert boxes. */
  padding-bottom: 0;
}

.alert-info a {
  /* higher contrast for links in info boxes. */
  color: var(--pst-color-alert-link);
}

/* Icon Links */

#navbar-icon-links {
  i {
    &.fa,
    &.fab,
    &.far,
    &.fas {
      vertical-align: middle;
      font-style: normal;
      font-size: 1.5rem;
      line-height: 1.25;
    }

    /* Social media buttons */
    &.fa-twitter-square:before {
      color: #55acee;
    }

    &.fa-gitlab:before {
      color: #548;
    }

    &.fa-bitbucket:before {
      color: #0052cc;
    }
  }

  img.icon-link-image {
    height: 1.5em;
  }
}

/* TOC section headers */

.tocsection {
  padding-left: 10px;
  border-left: 1px solid var(--pst-color-toc-border);
  padding: 0.3rem 1.5rem;

  i {
    padding-right: 0.5rem;
  }
}

.editthispage {
  padding-top: 2rem;

  a {
    color: var(--pst-color-sidebar-link-active);
  }
}

/* Special-case over-rides */

// xarray output display in bootstrap
.xr-wrap[hidden] {
  display: block !important;
}

////////////////////////////////////////////////////////////////////////////////
// Togglable expand/collapse
////////////////////////////////////////////////////////////////////////////////

.toctree-checkbox {
  position: absolute;
  display: none;
}

.toctree-checkbox {
  ~ ul {
    display: none;
  }
  ~ label i {
    transform: rotate(0deg);
  }
}
.toctree-checkbox:checked {
  ~ ul {
    display: block;
  }
  ~ label i {
    transform: rotate(180deg);
  }
}

.bd-sidebar {
  padding-top: 1em;
  overflow-y: auto;
  display: flex;
  flex-direction: column;

  @include media-breakpoint-up(md) {
    border-right: 1px solid var(--pst-color-sidebar-border);

    @supports (position: -webkit-sticky) or (position: sticky) {
      position: -webkit-sticky;
      position: sticky;
      top: var(--pst-header-height);
      z-index: 1000;
      height: calc(100vh - var(--pst-header-height));
    }
  }

  &.no-sidebar {
    border-right: 0;
  }

  .sidebar-end-items {
    margin-top: auto;
    margin-bottom: 1em;
  }
  .list-caption {
    list-style: none;
    padding-left: 0px;
  }
  li {
    position: relative;
    // If it has children, add a bit more padding to wrap the content to avoid
    // overlapping with the <label>
    &.has-children {
      > .reference {
        padding-right: 30px;
      }
    }
  }
  label {
    position: absolute;
    top: 0;
    right: 0;
    // height: var(--sidebar-item-height);
    height: 30px;
    width: 30px;
    // width: var(--sidebar-expander-width);

    cursor: pointer;

    display: flex;
    justify-content: center;
    align-items: center;

    &:hover {
      background: var(--pst-color-sidebar-expander-background-hover);
    }

    i {
      display: inline-block;
      font-size: 0.75rem;
      text-align: center;
      &:hover {
        color: var(--pst-color-sidebar-link-hover);
      }
    }
  }
  .label-parts {
    width: 100%;
    height: 100%;
    &:hover {
      background: none;
    }
    i {
      width: 30px;
      position: absolute;
      top: 0.3em; // aligning chevron with text
      right: 0em; // aligning chevron to the right
    }
  }
}

// From https://stackoverflow.com/a/34372191
table.highlighttable td.linenos,
span.linenos,
div.doctest > div.highlight span.gp {
  /* gp: Generic.Prompt */
  user-select: none;
  -webkit-user-select: text; /* Safari fallback only */
  -webkit-user-select: none; /* Chrome/Safari */
  -moz-user-select: none; /* Firefox */
  -ms-user-select: none; /* IE10+ */
}

// Bootstrap adds margin to their general container class. However, sphinx/docutils
// can also generate output with the container class, but in those cases we should
// not add the margin from bootstrap.
.docutils.container {
  padding-left: unset;
  padding-right: unset;
}