observatorio-jekyll-theme 0.1.2

data/_sass/helpers.scss

@@ -0,0 +1,379 @@
+////
+/// @group Utilidades
+////
+
+/// Direcciones posibles
+$directions: (top, right, bottom, left);
+
+/// Crea una propiedad con prefijos de navegador, cuando no es
+/// soportada por estándares, por ejemplo el guionado de texto.
+@mixin vendor-prefix($property, $definition...) {
+  @each $prefix in $vendor-prefixes {
+    #{$prefix}$property: $definition;
+  }
+}
+
+@each $breakpoint in map-keys($grid-breakpoints) {
+  @include media-breakpoint-up($breakpoint) {
+/// Obtiene el sufijo para cada clase responsive usando mixins de
+/// Bootstrap.  Valores posibles:
+/// `""` (nada, aplica a todas las resoluciones), `-xs`, `-sm`,
+/// `-md`, `-lg`, `-xl`.
+    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);
+
+/// Grilla en CSS, soporta armar una cantidad de columnas, indicar las
+/// columnas que ocupan los elementos descendientes e incluso
+/// solapamiento.
+///
+/// @example html
+///   <div class="d-grid grid-cols-5">
+///     <div class="grid-row-1 grid-col-1-to-2"></div>
+///     <div class="grid-row-2 grid-col-2-to-3"></div>
+///   </div>
+    .d#{$infix}-grid {
+      display: grid !important;
+
+      @each $spacer, $_ in $spacers {
+        &.grid-cols#{$infix}-#{$spacer} {
+          grid-template-columns: repeat($spacer, 1fr) !important;
+        }
+
+        & > .grid-row#{$infix}-#{$spacer} {
+          grid-row: $spacer !important;
+        }
+
+        & > .grid-col#{$infix}-#{$spacer} {
+          grid-column: $spacer !important;
+        }
+
+        @each $spacer_to, $_ in $spacers {
+          & > .grid-col#{$infix}-#{$spacer}-to-#{$spacer_to} {
+            grid-column: #{$spacer} / #{$spacer_to} !important;
+          }
+        }
+      }
+    }
+
+/// Ocultar la barra de scroll, útil para sliders horizontales.
+///
+/// @example html
+///   <div class="no-scrollbar-md"></div>
+    .no-scrollbar#{$infix} {
+      scrollbar-width: none;
+      -webkit-overflow-scrolling: touch;
+
+      &::-webkit-scrollbar { display: none; }
+    }
+
+    :enabled {
+      .show-when-disabled#{$infix} {
+        display: none !important;
+      }
+    }
+
+    :disabled {
+      .hide-when-disabled#{$infix} {
+        display: none !important;
+      }
+    }
+
+/// Cursores
+    $cursors: (pointer, none);
+    @each $cursor in $cursors {
+/// El elemento va a tener un cursor
+///
+/// @example html
+///   <div class="cursor-pointer"></div>
+      .cursor#{$infix}-#{$cursor} {
+        cursor: $cursor;
+      }
+    }
+
+/// Eventos del cursor
+    $events: (none, auto);
+    @each $event in $events {
+/// Habilita o deshabilita recibir eventos al tocar o clickear.
+///
+/// @example html
+///   <div class="pointer-event-none"></div>
+      .pointer-event#{$infix}-#{$event} {
+        pointer-events: $event;
+      }
+    }
+
+/// Agrega una transición a cualquier modificación de atributos
+    .transition#{$infix} {
+      @include transition($transition-base);
+    }
+
+/// Valores posibles para la propiedad `object-fit`
+    $objects: (contain, cover, fill, none, scale-down);
+    @each $object in $objects {
+/// Ajustes de imagen y video con respecto al contenedor
+///
+/// @example html
+///   <img class="object-cover object-lg-contain"/>
+      .fit#{$infix}-#{$object} {
+        object-fit: #{$object};
+      }
+    }
+
+/// _Overflow_, qué hacer cuando el contenido sobrepasa los límites del
+/// contenedor.
+    $overflows: (auto, hidden, scroll);
+/// También puede ser solo dentro de un eje
+    $overflow-axis: (x, y);
+    @each $overflow in $overflows {
+/// Manejar el contenido sobre cualquier eje
+///
+/// @example html
+///   <div class="overflow-hidden overflow-scroll-md"></div>
+      .overflow#{$infix}-#{$overflow} {
+        overflow: $overflow !important;
+      }
+
+      @each $axis in $overflow-axis {
+/// Manejar el contenido sobre un eje particular
+///
+/// @example html
+///   <div class="overflow-hidden-y overflow-scroll-x"></div>
+        .overflow-#{$axis}#{$infix}-#{$overflow} {
+          overflow-#{$axis}: $overflow !important;
+        }
+      }
+    }
+
+    @each $spacer, $length in $spacers {
+/// Poder aumentar o disminuir el alto de la tipografía.  Los
+/// `spacers` están definidos en Bootstrap y pueden ser extendidos
+/// desde styles.scss
+///
+/// @link assets/css/styles.scss
+/// @example html
+///   <h1 class="f-3"></h1>
+      .f#{$infix}-#{$spacer} {
+        font-size: $length !important;
+      }
+
+/// Columnas de texto
+///
+/// @example html
+///   <div class="text-column-1 text-column-md-3"></div>
+      .text-column#{$infix}-#{$spacer} {
+        column-count: $spacer;
+      }
+
+/// Limitar la cantidad de líneas de un bloque de texto,
+/// reemplazando el sobrante por puntos suspensivos.  Es útil cuando
+/// el diseño solo pide una cantidad de líneas pero no sabemos cuál
+/// va a ser el largo.
+///
+/// @example html
+///   <h1 class="line-clamp-1"></h1>
+      .line-clamp#{$infix}-#{$spacer} {
+        overflow: hidden;
+        display: -webkit-box;
+        -webkit-line-clamp: $spacer;
+        -webkit-box-orient: vertical;
+      }
+
+      @each $direction in $directions {
+/// Ubicación absoluta, usar con position-*
+///
+/// @example html
+///   <div class="position-absolute top-0 left-3"></div>
+        .#{$direction}#{$infix}-#{$spacer} {
+          #{$direction}: $length
+        }
+      }
+    }
+
+    /// Anchos y altos en base a `$sizes` definido por Bootstrap.  Para
+    /// personalizar los tamaños, modificarlos o agregarlos en `styles.scss`
+    ///
+    /// @link assets/css/styles.scss
+    @each $prop, $abbrev in (width: w, height: h) {
+      @each $size, $length in $sizes {
+        .#{$abbrev}#{$infix}-#{$size} { #{$prop}: $length !important; }
+        .#{$abbrev}#{$infix}-#{$size} { #{$prop}: $length !important; }
+        .min-#{$abbrev}#{$infix}-#{$size} { min-#{$prop}: $length !important; }
+        .max-#{$abbrev}#{$infix}-#{$size} { max-#{$prop}: $length !important; }
+      }
+    }
+
+/// Tipos de _scroll_ posible
+    $scrolls: (auto, smooth);
+    @each $scroll in $scrolls {
+/// Poder modificar el tipo de _scroll_ de forma _responsive_
+///
+/// @example html
+///   <div class="scroll-auto scroll-md-smooth"></div>
+      .scroll#{$infix}-#{$scroll} {
+        scroll-behavior: #{$scroll};
+      }
+    }
+
+/// Bordes.  Bootstrap no define bordes _responsive_
+///
+/// @link node_modules/bootstrap/scss/utilities/_borders.scss
+/// @example html
+///   <div class="border border-md-top-0"></div>
+    .border#{$infix}   { border: $border-width solid $border-color !important; }
+    .border#{$infix}-0 { border: 0 !important; }
+
+    @each $direction in $directions {
+      .border#{$infix}-#{$direction}   { border-#{$direction}: $border-width solid $border-color !important; }
+      .border#{$infix}-#{$direction}-0 { border-#{$direction}: 0 !important; }
+    }
+
+    $aligns: (left,center,right);
+    @each $align in $aligns {
+/// Alineación _responsive_
+///
+/// @example html
+///   <div class="text-center text-md-right"></div>
+      .text#{$infix}-#{$align} { text-align: $align !important; }
+    }
+
+    @each $position in $positions {
+/// Posicionamiento
+///
+/// @example html
+///   <div class="position-relative position-md-absolute"></div>
+      .position#{$infix}-#{$position} { position: $position !important; }
+    }
+
+    @each $color, $rgb in $colors {
+/// Colores de fondo.  Es raro que usemos versiones _responsive_, pero
+/// no está de más tenerlas.
+///
+/// @link assets/css/styles.scss
+/// @example html
+///   <div class="background-red"></div>
+      .background#{$infix}-#{$color} {
+        background-color: var(--#{$color});
+
+        &:focus {
+          background-color: var(--#{$color});
+        }
+      }
+
+      @each $opacity, $degree in $opacities {
+/// Color de fondo con transparencia (opacidad)
+///
+/// @example html
+///   <div class="background-red-t2"></div>
+        .background#{$infix}-#{$color}-t#{$opacity} {
+          background-color: scale-color($rgb, $alpha: $degree);
+        }
+      }
+
+/// Atributos de SVG
+      $svg-attributes: (stroke, fill);
+      @each $attr in $svg-attributes {
+/// Poder cambiar el relleno o la línea de un SVG
+///
+/// @example html
+///   <div class="stroke-black fill-red">
+///     <svg/>
+///   </div>
+        .#{$attr}#{$infix}-#{$color} {
+          svg {
+            * {
+              #{$attr}: var(--#{$color});
+            }
+          }
+        }
+      }
+
+/// Barras de _scroll_ de colores
+///
+/// @example html
+///   <div class="scrollbar-green"></div>
+      .scrollbar#{$infix}-#{$color} {
+        scrollbar-color: var(--#{$color}) transparent;
+        scrollbar-width: thin;
+
+        &::-webkit-scrollbar {
+          width: 5px;
+          height: 8px;
+          background-color: transparent;
+        }
+
+        &::-webkit-scrollbar-thumb {
+          background: var(--#{$color});
+        }
+      }
+
+/// Bordes de color
+///
+/// @example html
+///   <div class="border-red"></div>
+      .border#{$infix}-#{$color} {
+        border-color: var(--#{$color}) !important;
+      }
+
+/// Cambiar el fondo al pasar por encima o hacer foco
+///
+/// @example html
+///   <div class="background-black background-hover-red"></div>
+      .background-hover#{$infix}-#{$color} {
+        &:hover,
+        &:focus-within {
+          background-color: var(--#{$color});
+        }
+      }
+
+/// Cambiar el color al pasar por encima o hacer foco
+///
+/// @example html
+///   <div class="black hover-red"></div>
+      .hover-#{$color} {
+        &:hover,
+        &:focus-within {
+          color: var(--#{$color}) !important;
+        }
+      }
+
+/// Cambiar el color, también aplica a la selección de texto.
+///
+/// @example html
+///   <div class="black hover-red"></div>
+      .#{$color}#{$infix} {
+        color: var(--#{$color});
+
+        &:focus {
+          color: var(--#{$color});
+        }
+
+/// Invertir el color en la selección, con el mismo color de fondo y
+/// texto en blanco.
+        ::-moz-selection,
+        ::selection {
+          background: var(--#{$color});
+          color: white;
+        }
+
+/// Si el contenedor tiene un color, también aplica a los bordes de los
+/// elementos de un formulario.
+///
+/// @todo Evaluar si es realmente necesario hacerlo así, porque no
+/// aplica a las sombras.
+        .form-control {
+          border-color: var(--#{$color});
+          color: var(--#{$color});
+        }
+
+/// Los `<hr/>` también cambian de color.
+///
+/// @example html
+///   <div class="red">
+///     <hr/>
+///   </div>
+        hr {
+          border-color: var(--#{$color});
+        }
+      }
+    }
+  }
+}

data/_sass/menu.scss

@@ -0,0 +1,36 @@
+/// El menú hamburguesa se expande cuando obtiene el foco y se oculta
+/// cuando lo pierde.  Esto nos permite tener un menú dinámico sin
+/// necesidad de JS.
+/// 
+/// @group Menú
+/// @link _includes/menu.html
+/// @todo En realidad el evento del foco está puesto en toda la navbar
+/// en lugar de solo en el ícono de hamburguesa.
+/// @example html
+///   <nav class="navbar">
+///     <button class="navbar-toggler">
+///       <span class="navbar-toggler-icon"></span>
+///     </button>
+///   
+///     <div class="collapse navbar-collapse" id="menu"></div>
+///   </nav>
+.navbar {
+  &:focus-within {
+    .navbar-collapse {
+      @extend .d-block;
+    }
+  }
+
+  .dropdown {
+    .dropdown-menu {
+      @extend .d-none;
+    }
+
+    &:hover,
+    &:focus-within {
+      .dropdown-menu {
+        @extend .d-block;
+      }
+    }
+  }
+}

data/_sass/share_box.scss

@@ -0,0 +1,26 @@
+input[type="checkbox"].toggler {
+  &:focus + label {
+    outline: none;
+  }
+}
+
+.share-box {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100vw;
+  height: 100vh;
+  background-color: rgba(0,0,0,.5);
+
+  @include vendor-prefix(transition, all 0.2s $bezier);
+
+  a {
+    border: $border-width solid transparent;
+
+    &:focus,
+    &:hover {
+      text-decoration: none;
+      border: $border-width solid $border-color;
+    }
+  }
+}

data/_sass/slider.scss

@@ -0,0 +1,29 @@
+.slider {
+  & > .inside {
+    overflow-x: scroll;
+    scroll-behavior: smooth;
+  }
+
+  .controls {
+    a {
+      &.active,
+      &:hover,
+      &:focus,
+      &:active {
+        text-decoration: none;
+
+        i {
+          @extend .fa-circle;
+        }
+      }
+    }
+  }
+
+  .decoration {
+    font-size: $h2-font-size;
+  }
+
+  .content {
+    @extend .lead;
+  }
+}

data/_sass/snap.scss

@@ -0,0 +1,60 @@
+////
+/// @group Snap
+////
+
+/// _Snap_ es una forma de hacer que los elementos se alineen
+/// automáticamente a partes de su contenedor durante el _scroll_.  Si le
+/// usuarie _scrollea_ hasta la mitad, el navegador continua el _scroll_
+/// hasta que se alinee.  Es útil para presentaciones de diapositivas
+/// (como el sitio de Sutty) o _banners_ con navegación horizontal
+/// (_sliders_).
+///
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Scroll_Snap
+$snap-types: (none, mandatory, proximity);
+/// Ejes
+$snap-directions: (y, x);
+/// Puntos de alineación
+$snap-points: (start, end, center, none);
+
+@each $breakpoint in map-keys($grid-breakpoints) {
+  @include media-breakpoint-up($breakpoint) {
+/// Obtiene el sufijo para cada clase responsive usando mixins de
+/// Bootstrap.  Valores posibles:
+/// `""` (nada, aplica a todas las resoluciones), `-xs`, `-sm`,
+/// `-md`, `-lg`, `-xl`.
+    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);
+
+    @each $snap-type in $snap-types {
+      @each $snap-direction in $snap-directions {
+/// El contenedor indica la dirección y obligatoriedad del snap
+///
+/// @example html
+///   <div class="snap-mandatory-y snap-proximity-md-y"></div>
+        .snap-#{$snap-type}#{$infix}-#{$snap-direction} {
+          scroll-snap-points-#{$snap-direction}: repeat(100%);
+          scroll-snap-destination: 0 0;
+
+          @each $prefix in $vendor-prefixes {
+            #{$prefix}scroll-snap-type: #{$snap-direction} #{$snap-type};
+            #{$prefix}scroll-snap-type: #{$snap-type};
+          }
+
+          @each $snap-point in $snap-points {
+/// Los elementos que son descendientes directos se alinean a
+/// su contenedor
+///
+/// @example html
+///   <div class="snap-mandatory-y snap-proximity-md-y">
+///     <div class="snap-start"></div>
+///     <div class="snap-center"></div>
+///     <div class="snap-end"></div>
+///   </div>
+            & > .snap-#{$snap-point} {
+              scroll-snap-align: #{$snap-point};
+            }
+          }
+        }
+      }
+    }
+  }
+}

data/_sass/toggler.scss

@@ -0,0 +1,62 @@
+////
+/// @group Toggler
+////
+
+/// Desplegar menúes sin javascript!
+///
+/// Comenzamos con un `<input type="checkbox"/>` con la clase
+/// `.toggler`.
+///
+/// @todo ¿Deprecar?  Según el validador de HTML los `<label>` no pueden
+/// contener elementos de bloques, como `<div>`.
+/// @link https://dev.to/cydstumpel/creating-a-fold-out-navigation-with-css-only-4g9k
+///
+/// @example html
+///   <div>
+///     <input type="checkbox" class="toggler" id="toggler" />
+///     <label for="toggler">
+///        Esta es la parte visible, puede contener un ícono.  Los
+///        atributos id y for son importantes para que el label se
+///        asocie con el input invisible.
+///        <div class="toggled">
+///          Esta es la parte solo visible cuando el label es tocado.
+///        </div>
+///     </label>
+///   </div>
+input[type="checkbox"].toggler {
+/// Por defecto está oculto pero todavía queremos que se le pueda dar
+/// foco con el / teclado
+///
+/// @todo ¿Usar `@extend .sr-only`?
+  opacity: 0;
+  position: absolute;
+
+/// El `<label>` inmediatamente posterior al `<input>` (`+`) contiene
+/// descendientes con la clase `.toggled` que cambian la visibilidad según
+/// el estado del `<input>`.
+  & + label {
+    .toggled {
+      z-index: 10;
+      visibility: hidden;
+    }
+  }
+
+/// Al tocar el `<input>`, mostramos el elemento oculto.
+  &:checked + label {
+    .toggled {
+      visibility: visible;
+    }
+  }
+
+  & + label {
+    border: none;
+    outline: none;
+    z-index: 11;
+  }
+
+/// Dar una guía visual de que estamos enfocando el `<input>`,
+/// trasladando el mismo estilo a su `<label>`
+  &:focus + label {
+    outline: 1px dotted grey ;
+  }
+}