datalog-theme 0.8.0 → 0.9.0

data/_sass/_print.scss

@@ -0,0 +1,291 @@
+@use 'sass:map';
+
+@use 'variables' as *;
+@use 'mixins' as *;
+
+// Reading mode and print (_includes/components/reading-mode-toggle.html).
+//
+// Reading mode hides the site's chrome and the panels around an article and
+// leaves the article, its metadata and its table of contents. Print does the
+// same on paper: black on white whatever the theme, the addresses of links,
+// no interactive controls, and no figure, table, code block or equation cut
+// across pages where the browser can help it.
+
+// ---------------------------------------------------------------------------
+// The control
+// ---------------------------------------------------------------------------
+.reading-mode-bar {
+  display: flex;
+  justify-content: flex-end;
+}
+
+// Shared by the reading-mode control and the reading-state buttons (_reading-state.scss).
+.post-tool {
+  display: inline-flex;
+  align-items: center;
+  gap: map.get($spacing, 2);
+  padding: 0.35rem 0.75rem;
+  border: 1px solid rgba($color-neutral-200, 0.9);
+  border-radius: map.get($radius, md);
+  background: $color-surface-50;
+  color: $color-ink-700;
+  font: inherit;
+  font-size: map.get($font-size-scale, sm);
+  font-weight: 600;
+  cursor: pointer;
+
+  &:hover,
+  &:focus-visible {
+    border-color: $color-accent-primary;
+    color: $color-accent-primary-text;
+  }
+
+  &[aria-pressed='true'] {
+    border-color: $color-accent-primary;
+    background: $color-accent-primary;
+    color: #fff;
+  }
+
+  svg {
+    flex: none;
+  }
+}
+
+body.dark-mode .post-tool {
+  border-color: rgba($dark-ink-500, 0.35);
+  background: $dark-surface-300;
+  color: $dark-ink-700;
+
+  &:hover,
+  &:focus-visible {
+    border-color: $dark-accent-primary;
+    color: $dark-accent-primary;
+  }
+
+  &[aria-pressed='true'] {
+    border-color: $dark-accent-primary;
+    background: $dark-accent-primary;
+    color: $dark-surface-100;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Reading mode: the article alone, and the way back
+// ---------------------------------------------------------------------------
+body.reading-mode {
+  .site-header,
+  .site-footer,
+  .breadcrumbs,
+  .social-share,
+  .post-interactive,
+  .post-comments,
+  .citation-tools,
+  .open-science-badges,
+  .author-bio,
+  .post-related,
+  .post-pagination,
+  .back-to-top,
+  [data-back-to-top] {
+    display: none !important;
+  }
+
+  .site-main {
+    padding-top: map.get($spacing, 4);
+  }
+
+  // The tools stay in reach while the article scrolls.
+  .post-tools {
+    position: sticky;
+    top: map.get($spacing, 3);
+    z-index: 5;
+  }
+
+  .post-content {
+    font-size: 1.0625rem;
+    line-height: 1.7;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Print
+// ---------------------------------------------------------------------------
+.print-only {
+  display: none;
+}
+
+@media print {
+  @page {
+    margin: 2cm;
+  }
+
+  body,
+  body.dark-mode {
+    background: #fff !important;
+    color: #000 !important;
+    font-size: 11pt;
+  }
+
+  // The chrome and the controls that only work on a screen
+  .site-header,
+  .site-footer,
+  .skip-link,
+  .breadcrumbs,
+  .social-share,
+  .post-interactive,
+  .post-comments,
+  .post-slides,
+  .open-science-badges,
+  .author-bio,
+  .post-related,
+  .post-pagination,
+  .post-tools,
+  .reading-mode-bar,
+  .back-to-top,
+  [data-back-to-top],
+  .code-copy,
+  .citation-tools__exports,
+  .viz-table-toggle,
+  [aria-live] {
+    display: none !important;
+  }
+
+  .print-only {
+    display: block !important;
+  }
+
+  .site-main {
+    max-width: none;
+    padding: 0;
+  }
+
+  .post-body-wrapper {
+    display: block;
+  }
+
+  // Black on white, whatever the theme
+  body.dark-mode :where(h1, h2, h3, h4, h5, h6, p, li, dt, dd, td, th, figcaption, blockquote, code, pre, span, a,
+    strong, em, time, small, summary, label, caption, kbd) {
+    color: #000 !important;
+  }
+
+  body.dark-mode :where(section, aside, div, nav, article, figure, p, li, ul, ol, dl, dt, dd, blockquote, pre, code,
+    table, th, td, kbd) {
+    background: transparent !important;
+    border-color: #999 !important;
+  }
+
+  blockquote {
+    background: none !important;
+  }
+
+  a {
+    color: #000 !important;
+    text-decoration: underline;
+  }
+
+  .datalog-statement,
+  .datalog-proof,
+  .revision-notice,
+  .series-nav,
+  .reproduce,
+  .content-provenance,
+  .content-license,
+  .citation-tools,
+  .enhanced-toc {
+    background: none !important;
+    border-color: #000;
+    box-shadow: none;
+  }
+
+  // Links keep their addresses, other than anchors within the page
+  .post-content a[href^='http']::after {
+    content: ' (' attr(href) ')';
+    font-size: 0.85em;
+    word-break: break-all;
+  }
+
+  // Page breaks
+  h1,
+  h2,
+  h3,
+  h4 {
+    break-after: avoid;
+    page-break-after: avoid;
+  }
+
+  p,
+  li {
+    orphans: 3;
+    widows: 3;
+  }
+
+  pre,
+  figure,
+  table,
+  tr,
+  blockquote,
+  img,
+  svg,
+  .code-block-wrapper,
+  .highlight,
+  .datalog-statement,
+  .datalog-proof,
+  mjx-container[display='true'],
+  .katex-display {
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+
+  img,
+  svg,
+  mjx-container,
+  .katex-display {
+    max-width: 100% !important;
+    overflow: visible !important;
+  }
+
+  // Code without a dark background, wrapped to the page
+  pre,
+  pre.highlight,
+  .highlight pre,
+  pre[class*='language-'],
+  .code-block-wrapper {
+    background: #fff !important;
+    color: #000 !important;
+    border: 1px solid #999;
+    box-shadow: none;
+  }
+
+  pre {
+    white-space: pre-wrap !important;
+    word-break: break-word;
+    overflow: visible !important;
+  }
+
+  body.dark-mode .highlight span {
+    color: #000 !important;
+    background: none !important;
+  }
+
+  // Interactive embeds become a note; a visualization's table fallback is shown
+  iframe,
+  canvas,
+  video,
+  [data-viz-type] > *,
+  .interactive-embed > * {
+    display: none !important;
+  }
+
+  [data-viz-type]::before,
+  .interactive-embed::before {
+    content: 'Interactive content, available in the online article.';
+    display: block;
+    padding: map.get($spacing, 3);
+    border: 1px dashed #999;
+    font-style: italic;
+  }
+
+  .viz-table-wrapper[hidden] {
+    display: block !important;
+  }
+}

data/_sass/_reactions.scss

@@ -0,0 +1,89 @@
+@use 'sass:map';
+
+@use 'variables' as *;
+
+// "Was this useful?" (components/reactions.html, assets/js/reactions/widget.js):
+// a quiet strip after the article, not a competitor to it.
+
+.reactions {
+  max-width: $max-width-reading;
+  margin-top: map.get($spacing, 5);
+  padding-top: map.get($spacing, 3);
+  border-top: 1px solid rgba($color-neutral-500, 0.25);
+  font-size: map.get($font-size-scale, sm);
+}
+
+.reactions__prompt {
+  margin: 0 0 map.get($spacing, 2);
+  font-weight: 600;
+  color: $color-ink-700;
+}
+
+.reactions__choices {
+  display: flex;
+  flex-wrap: wrap;
+  gap: map.get($spacing, 2);
+}
+
+.reactions__choice {
+  display: inline-flex;
+  align-items: baseline;
+  gap: map.get($spacing, 1);
+
+  &[aria-pressed='true'] {
+    background: $color-accent-primary;
+    border-color: $color-accent-primary;
+    color: $color-surface-50;
+  }
+}
+
+// The count inherits the button's colour at full strength: dimmed, it fell
+// below 4.5:1 on the pressed button.
+.reactions__count {
+  font-variant-numeric: tabular-nums;
+
+  &::before {
+    content: '·';
+    margin-right: map.get($spacing, 1);
+  }
+}
+
+.reactions__status {
+  margin: map.get($spacing, 2) 0 0;
+  color: $color-ink-500;
+
+  .reactions[data-state='disabled'] & {
+    color: $color-ink-500;
+  }
+}
+
+// A missing service leaves the strip usable but without counts; nothing else changes.
+.reactions[data-state='disabled'] .reactions__choices {
+  opacity: 0.6;
+}
+
+body.dark-mode {
+  .reactions {
+    border-top-color: rgba($dark-ink-500, 0.35);
+  }
+
+  .reactions__prompt {
+    color: $dark-ink-700;
+  }
+
+  .reactions__status {
+    color: $dark-ink-500;
+  }
+
+  .reactions__choice[aria-pressed='true'] {
+    background: $dark-accent-primary;
+    border-color: $dark-accent-primary;
+    color: $dark-surface-100;
+  }
+}
+
+@media print {
+  .reactions {
+    display: none !important;
+  }
+}

data/_sass/_reading-state.scss

@@ -0,0 +1,290 @@
+@use 'sass:map';
+
+@use 'variables' as *;
+@use 'mixins' as *;
+
+// Local reading state (assets/js/reading-state): the tools bar above a post,
+// the resume prompt, the toolbar over a selection, the highlights and the
+// panel of private notes, and the list of saved articles on a page. The
+// buttons share .post-tool with the reading-mode control (_print.scss).
+
+.post-tools {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: flex-end;
+  gap: map.get($spacing, 2);
+}
+
+.post-tool--link {
+  text-decoration: none;
+}
+
+.bookmark-toggle[aria-pressed='true'] svg {
+  fill: currentColor;
+}
+
+// display: flex would override the `hidden` attribute's display: none.
+.reading-resume[hidden],
+.reading-toolbar[hidden] {
+  display: none;
+}
+
+// The resume prompt
+.reading-resume {
+  @include callout($color-accent-secondary);
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: space-between;
+  gap: map.get($spacing, 2) map.get($spacing, 4);
+  margin-top: map.get($spacing, 4);
+  font-size: map.get($font-size-scale, sm);
+  max-width: $max-width-reading;
+
+  p {
+    margin: 0;
+  }
+}
+
+.reading-resume__actions {
+  display: flex;
+  gap: map.get($spacing, 2);
+}
+
+// The toolbar over a selection
+.reading-toolbar {
+  position: absolute;
+  z-index: 20;
+  display: flex;
+  gap: 2px;
+  padding: 4px;
+  border-radius: map.get($radius, md);
+  background: $color-ink-900;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.25);
+
+  button {
+    padding: 0.35rem 0.6rem;
+    border: 0;
+    border-radius: map.get($radius, sm);
+    background: transparent;
+    color: #fff;
+    font: inherit;
+    font-size: map.get($font-size-scale, sm);
+    cursor: pointer;
+
+    &:hover,
+    &:focus-visible {
+      background: rgba(255, 255, 255, 0.18);
+    }
+  }
+}
+
+// The highlights themselves: the Custom Highlight API where the browser has
+// it, marks elsewhere.
+::highlight(datalog-annotation) {
+  background-color: rgba(250, 204, 21, 0.45);
+  color: inherit;
+}
+
+mark.reading-highlight {
+  background-color: rgba(250, 204, 21, 0.45);
+  color: inherit;
+}
+
+body.dark-mode ::highlight(datalog-annotation),
+body.dark-mode mark.reading-highlight {
+  background-color: rgba(250, 204, 21, 0.3);
+}
+
+// The panel of private highlights and the data controls
+.reading-notes {
+  @include callout($color-accent-tertiary);
+  margin-top: map.get($spacing, 5);
+  font-size: map.get($font-size-scale, sm);
+  max-width: $max-width-reading;
+
+  a {
+    color: $color-accent-primary-text;
+  }
+}
+
+.reading-notes__heading {
+  margin: 0 0 map.get($spacing, 1);
+  font-size: map.get($font-size-scale, base);
+}
+
+.reading-notes__intro,
+.reading-notes__empty,
+.reading-notes__unavailable,
+.reading-list__empty {
+  margin: 0 0 map.get($spacing, 3);
+  color: $color-ink-500;
+}
+
+.reading-notes__list {
+  display: grid;
+  gap: map.get($spacing, 3);
+  margin: 0 0 map.get($spacing, 3);
+  padding: 0;
+  list-style: none;
+}
+
+.reading-note {
+  padding-top: map.get($spacing, 2);
+  border-top: 1px solid rgba($color-neutral-200, 0.7);
+}
+
+.reading-note__quote {
+  margin: 0 0 map.get($spacing, 1);
+  padding: 0 0 0 map.get($spacing, 3);
+  border-left: 3px solid rgba(250, 204, 21, 0.9);
+  background: none;
+  font-style: italic;
+}
+
+.reading-note__meta {
+  margin: 0 0 map.get($spacing, 1);
+  font-size: map.get($font-size-scale, xs);
+  color: $color-ink-500;
+}
+
+.reading-note__lost {
+  font-weight: 600;
+  color: $color-warning-text;
+}
+
+.reading-note__label {
+  display: grid;
+  gap: 2px;
+
+  span {
+    font-size: map.get($font-size-scale, xs);
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 0.04em;
+    color: $color-ink-500;
+  }
+
+  textarea {
+    width: 100%;
+    padding: 0.35rem 0.5rem;
+    border: 1px solid rgba($color-neutral-200, 0.9);
+    border-radius: map.get($radius, sm);
+    background: $color-surface-50;
+    color: $color-ink-700;
+    font: inherit;
+    font-size: map.get($font-size-scale, sm);
+  }
+}
+
+.reading-note__actions,
+.reading-data__actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: map.get($spacing, 2);
+  margin-top: map.get($spacing, 2);
+}
+
+.reading-data {
+  margin-top: map.get($spacing, 3);
+
+  summary {
+    cursor: pointer;
+    font-weight: 600;
+  }
+}
+
+.reading-data__import {
+  position: relative;
+  overflow: hidden;
+
+  input {
+    position: absolute;
+    inset: 0;
+    width: 100%;
+    opacity: 0;
+    cursor: pointer;
+  }
+}
+
+.reading-data__status {
+  margin: map.get($spacing, 2) 0 0;
+  color: $color-ink-500;
+}
+
+// The saved articles on a page
+.reading-list__items {
+  display: grid;
+  gap: map.get($spacing, 3);
+  margin: 0 0 map.get($spacing, 4);
+  padding: 0;
+  list-style: none;
+}
+
+.reading-list__item {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: baseline;
+  gap: map.get($spacing, 1) map.get($spacing, 3);
+
+  a {
+    font-weight: 600;
+  }
+}
+
+.reading-list__meta {
+  font-size: map.get($font-size-scale, sm);
+  color: $color-ink-500;
+}
+
+body.dark-mode {
+  .reading-resume {
+    border-left-color: $dark-accent-secondary;
+  }
+
+  .reading-notes {
+    border-left-color: $dark-accent-tertiary;
+  }
+
+  .reading-notes__intro,
+  .reading-notes__empty,
+  .reading-notes__unavailable,
+  .reading-list__empty,
+  .reading-note__meta,
+  .reading-note__label span,
+  .reading-data__status,
+  .reading-list__meta {
+    color: $dark-ink-500;
+  }
+
+  .reading-note {
+    border-top-color: rgba($dark-ink-500, 0.25);
+  }
+
+  .reading-note__lost {
+    color: $dark-warning;
+  }
+
+  .reading-note__label textarea {
+    border-color: rgba($dark-ink-500, 0.35);
+    background: $dark-surface-300;
+    color: $dark-ink-700;
+  }
+}
+
+@media print {
+  .reading-resume,
+  .reading-toolbar,
+  .reading-note__actions,
+  .reading-data,
+  .reading-notes__empty,
+  .reading-notes__unavailable {
+    display: none !important;
+  }
+
+  .reading-notes {
+    border-left-color: currentColor;
+    background: none;
+  }
+}