Docs updates, small tweaks

3 files changed, 782 insertions, 0 deletions

diff --git a/src/scss/mixins.scss b/src/scss/mixins.scss
new file mode 100644
index 00000000..b4bfca6a
--- /dev/null
+++ b/src/scss/mixins.scss
@@ -0,0 +1,29 @@
+// ==========================================================================
+// Plyr mixins
+// https://github.com/selz/plyr
+// ==========================================================================
+
+// <input type="range"> styling
+@mixin plyr-range-track() {
+    height: $plyr-range-track-height;
+    background: transparent;
+    border: 0;
+    border-radius: ($plyr-range-track-height / 2);
+    user-select: none;
+}
+@mixin plyr-range-thumb() {
+    position: relative;
+    height: $plyr-range-thumb-height;
+    width: $plyr-range-thumb-width;
+    background: $plyr-range-thumb-bg;
+    border: $plyr-range-thumb-border;
+    border-radius: 100%;
+    transition: background .2s ease, border .2s ease, transform .2s ease;
+    box-shadow: $plyr-range-thumb-shadow;
+    box-sizing: border-box;
+}
+@mixin plyr-range-thumb-active() {
+    background: $plyr-range-thumb-active-bg;
+    border-color: $plyr-range-thumb-active-border-color;
+    transform: scale($plyr-range-thumb-active-scale);
+}
\ No newline at end of file
diff --git a/src/scss/plyr.scss b/src/scss/plyr.scss
new file mode 100644
index 00000000..d7976b39
--- /dev/null
+++ b/src/scss/plyr.scss
@@ -0,0 +1,686 @@
+// ==========================================================================
+// Plyr styles
+// https://github.com/selz/plyr
+// ==========================================================================
+
+@import "variables";
+@import "mixins";
+
+// Animation
+// ---------------------------------------
+@keyframes plyr-progress {
+    to { background-position: $plyr-progress-loading-size 0; }
+}
+
+// Styles
+// -------------------------------
+// Base
+.plyr {
+    position: relative;
+    max-width: 100%;
+    min-width: 200px;
+    font-family: Avenir, "Avenir Next", "Helvetica Neue", "Segoe UI", Helvetica, Arial, sans-serif;
+
+    // border-box everything
+    // http://paulirish.com/2012/box-sizing-border-box-ftw/
+    &,
+    *,
+    *::after,
+    *::before {
+        box-sizing: border-box;
+    }
+
+    // Fix 300ms delay
+    a, button, input, label {
+        touch-action: manipulation;
+    }
+
+    // Media elements
+    video,
+    audio {
+        width: 100%;
+        height: auto;
+        vertical-align: middle;
+        border-radius: inherit;
+    }
+
+    // Range inputs
+    // Specificity is for bootstrap compatibility
+    input[type='range'] {
+        display: block;
+        height: ($plyr-range-thumb-height * $plyr-range-thumb-active-scale);
+        width: 100%;
+        margin: 0;
+        padding: 0; 
+        vertical-align: middle;
+        
+        appearance: none;
+        cursor: pointer;
+        border: none;
+        background: transparent;
+        
+        // WebKit
+        &::-webkit-slider-runnable-track {
+            @include plyr-range-track();
+        }
+        &::-webkit-slider-thumb {
+            -webkit-appearance: none;
+            margin-top: -(($plyr-range-thumb-height - $plyr-range-track-height) / 2);
+            @include plyr-range-thumb();
+        }
+
+        // Mozilla
+        &::-moz-range-track {
+            @include plyr-range-track();
+        }
+        &::-moz-range-thumb {
+            @include plyr-range-thumb();
+        }
+        &::-moz-focus-outer {
+            border: 0;
+        }
+        
+        // Microsoft
+        &::-ms-track {
+            height: $plyr-range-track-height;
+            background: transparent;
+            border: 0;
+            color: transparent;
+        }
+        &::-ms-fill-upper {
+            @include plyr-range-track();
+        }
+        &::-ms-fill-lower {
+            @include plyr-range-track();
+            background: $plyr-range-selected-bg;
+        }
+        &::-ms-thumb {
+            @include plyr-range-thumb();
+            // For some reason, Edge uses the -webkit margin above
+            margin-top: 0; 
+        }
+        &::-ms-tooltip {
+            display: none;
+        }
+
+        // Focus styles
+        &:focus {
+            outline: 0;
+        }
+        &::-moz-focus-outer {
+            border: 0;
+        }        
+        &.tab-focus:focus {
+            outline-offset: 3px;
+        }
+        
+        // Pressed styles
+        &:active {
+            &::-webkit-slider-thumb {
+                @include plyr-range-thumb-active();
+            }
+            &::-moz-range-thumb {
+                @include plyr-range-thumb-active();
+            }
+            &::-ms-thumb {
+                @include plyr-range-thumb-active();
+            }
+        }
+    }
+}
+
+// Video range inputs
+.plyr--video input[type='range'].tab-focus:focus {
+    outline: 1px dotted transparentize($plyr-video-control-color, .5);
+}
+
+// Audio range inputs
+.plyr--audio input[type='range'].tab-focus:focus {
+    outline: 1px dotted transparentize($plyr-audio-control-color, .5);
+}
+
+// Screen reader only elements
+.plyr__sr-only {
+    position: absolute !important;
+    clip: rect(1px, 1px, 1px, 1px);
+    padding: 0 !important;
+    border: 0 !important;
+    height: 1px !important;
+    width: 1px !important;
+    overflow: hidden;
+}
+
+// Video
+.plyr__video-wrapper {
+    position: relative;
+    background: #000;
+    border-radius: inherit;
+
+    // Cleaner radius, also forces iframe radius
+    -webkit-mask-image: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAA5JREFUeNpiYGBgAAgwAAAEAAGbA+oJAAAAAElFTkSuQmCC);
+}
+
+// Container for embeds
+.plyr__video-embed {
+    padding-bottom: 56.25%; /* 16:9 */
+    height: 0;
+    overflow: hidden;
+    border-radius: inherit;
+
+    iframe {
+        position: absolute;
+        top: 0;
+        left: 0;
+        width: 100%;
+        height: 100%;
+        border: 0;
+        user-select: none;
+    }
+
+    // Vimeo hack
+    > div {
+        position: relative;
+        padding-bottom: 200%;
+        transform: translateY(-35.95%);
+    }
+}
+// To allow mouse events to be captured if full support
+.plyr .plyr__video-embed iframe {
+    pointer-events: none;
+}
+
+// Captions
+// --------------------------------------------------------------
+// Hide default captions
+.plyr video::-webkit-media-text-track-container {
+    display: none;
+}
+.plyr__captions {
+    display: none;
+    position: absolute;
+    bottom: 0;
+    left: 0;
+    width: 100%;
+    padding: ($plyr-control-spacing * 2) ($plyr-control-spacing * 2) ($plyr-control-spacing * 8);
+    color: #fff;
+    font-size: $plyr-font-size-captions-base;
+    text-align: center;
+    font-weight: 400;
+    -webkit-font-smoothing: subpixel-antialiased;
+
+    span {
+        border-radius: 2px;
+        padding: floor($plyr-control-spacing / 3) $plyr-control-spacing;
+        background: transparentize(#000, .15);
+    }
+    span:empty {
+        display: none;
+    }
+
+    @media (min-width: $plyr-bp-screen-md) {
+        font-size: $plyr-font-size-captions-medium;
+    }
+}
+.plyr--captions-active .plyr__captions {
+    display: block;
+}
+.plyr--fullscreen-active .plyr__captions {
+    font-size: $plyr-font-size-captions-large;
+}
+
+// Controls
+// --------------------------------------------------------------
+// Playback controls
+.plyr__controls {
+    display: flex;
+    align-items: center; 
+
+    line-height: 1;
+    text-align: center;
+
+    transition: opacity .3s ease;
+
+    // Spacing
+    > button,
+    .plyr__progress,
+    .plyr__time {
+        margin-left: ($plyr-control-spacing / 2);
+
+        &:first-child {
+            margin-left: 0;
+        }
+    }
+    .plyr__volume {
+        margin-left: ($plyr-control-spacing / 2);
+    }
+    [data-plyr="pause"] {
+        margin-left: 0;
+    }
+
+    // Buttons
+    button {
+        position: relative;
+        display: inline-block;
+        flex-shrink: 0;
+        vertical-align: middle;
+        padding: ($plyr-control-spacing / 2);
+        border: 0;
+        background: transparent;
+        border-radius: 3px;
+        cursor: pointer;
+        transition: background .3s ease, color .3s ease, opacity .3s ease;
+        color: inherit;
+
+        svg {
+            width: 18px;
+            height: 18px;
+            display: block;
+            fill: currentColor;
+        }
+
+        // Default focus
+        &:focus {
+            outline: 0;
+        }
+    }
+
+    // Hide toggle icons by default
+    .icon--exit-fullscreen,
+    .icon--muted,
+    .icon--captions-on {
+        display: none;
+    }
+
+    @media (min-width: $plyr-bp-screen-sm) {
+        > button,
+        .plyr__progress,
+        .plyr__time {
+            margin-left: $plyr-control-spacing;
+        }
+        button {
+            padding: ($plyr-control-spacing / 2) $plyr-control-spacing;
+        }
+    }
+}
+// Hide controls 
+.plyr--hide-controls .plyr__controls {
+    opacity: 0;
+}
+
+// Video controls
+.plyr--video .plyr__controls {
+    position: absolute;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    padding: ($plyr-control-spacing * 5) $plyr-control-spacing $plyr-control-spacing;
+    background: linear-gradient(transparentize($plyr-video-controls-bg, 1), transparentize($plyr-video-controls-bg, .5));
+    border-bottom-left-radius: inherit;
+    border-bottom-right-radius: inherit;
+    color: $plyr-video-control-color;
+
+    button {
+        // Hover and tab focus
+        &.tab-focus:focus,
+        &:hover {
+            background: $plyr-video-control-bg-hover;
+            color: $plyr-video-control-color-hover;
+        }
+    }
+
+    @media (min-width: $plyr-bp-screen-sm) {
+        padding-left: ($plyr-control-spacing * 1.5);
+        padding-right: ($plyr-control-spacing * 1.5);
+    }
+}
+
+// Audio controls
+.plyr--audio .plyr__controls {
+    padding: $plyr-control-spacing;
+    border-radius: inherit;
+    background: $plyr-audio-controls-bg;
+    border: $plyr-audio-controls-border;
+    box-shadow: $plyr-audio-controls-box-shadow;
+    color: $plyr-audio-control-color;
+
+    button {
+        // Hover and tab focus
+        &.tab-focus:focus,
+        &:hover {
+            background: $plyr-audio-control-bg-hover;
+            color: $plyr-audio-control-color-hover;
+        }
+    }
+}
+
+// Large play button (video only)
+.plyr__play-large {
+    position: absolute;
+    top: 50%;
+    left: 50%;
+    transform: translate(-50%, -50%);
+    padding: $plyr-control-spacing;
+    background: $plyr-video-control-bg-hover;
+    border: 4px solid currentColor;
+    border-radius: 100%;
+    box-shadow: 0 1px 1px transparentize($plyr-video-controls-bg, .85);
+    color: $plyr-video-control-color;
+    transition: opacity .3s ease, visibility .3s ease;
+
+    svg {
+        position: relative;
+        left: 2px;
+        width: 20px;
+        height: 20px;
+        display: block;
+        fill: currentColor;
+    }
+
+    &:focus {
+        outline: 1px dotted transparentize($plyr-video-control-color, .5);
+    }
+}
+.plyr--audio .plyr__play-large {
+    display: none;
+}
+.plyr--playing .plyr__play-large {
+    opacity: 0;
+    visibility: hidden;
+}
+
+// States
+.plyr__controls [data-plyr='pause'],
+.plyr--playing .plyr__controls [data-plyr='play'] {
+    display: none;
+}
+.plyr--playing .plyr__controls [data-plyr='pause'] {
+    display: inline-block;
+}
+
+// Change icons on state change
+.plyr--fullscreen-active .icon--exit-fullscreen,
+.plyr--muted .plyr__controls .icon--muted,
+.plyr--captions-active .plyr__controls .icon--captions-on {
+    display: block;
+
+    & + svg {
+        display: none;
+    }
+}
+
+// Some options are hidden by default
+.plyr [data-plyr='captions'],
+.plyr [data-plyr='fullscreen'] {
+    display: none;
+}
+.plyr--captions-enabled [data-plyr='captions'],
+.plyr--fullscreen-enabled [data-plyr='fullscreen'] {
+    display: inline-block;
+}
+
+// Tooltips
+// --------------------------------------------------------------
+.plyr__tooltip {
+    visibility: hidden;
+    position: absolute;
+    z-index: 2;
+    bottom: 100%;
+    margin-bottom: ($plyr-tooltip-padding * 2);
+    padding: $plyr-tooltip-padding ($plyr-tooltip-padding * 1.5);
+    pointer-events: none;
+
+    opacity: 0;
+    background: $plyr-tooltip-bg;
+    box-shadow: $plyr-tooltip-shadow;
+    border-radius: $plyr-tooltip-radius;
+
+    color: $plyr-tooltip-color;
+    font-size: $plyr-font-size-small;
+    line-height: 1.3;
+    -webkit-font-smoothing: subpixel-antialiased;
+
+    transform: translate(-50%, 10px) scale(.8);
+    transform-origin: 50% 100%;
+    transition: transform .2s .1s ease, opacity .2s .1s ease, visibility .3s ease;
+
+    // Arrows
+    &::before {
+        content: '';
+        position: absolute;
+        width: 0;
+        height: 0;
+        left: 50%;
+        transform: translateX(-50%);
+    }
+    // The background triangle
+    &::before {
+        bottom: -$plyr-tooltip-arrow-size;
+        border-right: $plyr-tooltip-arrow-size solid transparent;
+        border-top: $plyr-tooltip-arrow-size solid $plyr-tooltip-bg;
+        border-left: $plyr-tooltip-arrow-size solid transparent;
+        z-index: 2;
+    }
+}
+.plyr button:hover .plyr__tooltip,
+.plyr button.tab-focus:focus .plyr__tooltip,
+.plyr__tooltip--visible {
+    visibility: visible;
+    opacity: 1;
+    transform: translate(-50%, 0) scale(1);
+}
+.plyr button:hover .plyr__tooltip {
+    z-index: 3;
+}
+
+// Playback progress
+// --------------------------------------------------------------
+// <progress> element
+.plyr__progress {
+    position: relative;
+    flex: 1;
+
+    input[type="range"] {
+        position: relative;
+        z-index: 2;
+
+        &::-webkit-slider-runnable-track {
+            background: transparent;
+        }
+        &::-moz-range-track {
+            background: transparent;
+        }
+        &::-ms-fill-upper {
+            background: transparent;
+        }
+    }
+
+    // Seek tooltip to show time
+    .plyr__tooltip {
+        left: 0;
+    }
+}
+
+.plyr__progress--buffer[value],
+.plyr__progress--played[value],
+.plyr__volume--display[value] {
+    position: absolute;
+    left: 0;
+    top: 50%;
+    width: 100%;
+    height: $plyr-range-track-height;
+    margin: -($plyr-range-track-height / 2) 0 0;
+    padding: 0;
+    vertical-align: top;
+    appearance: none;
+    border: none;
+    border-radius: 100px;
+
+    &::-webkit-progress-bar {
+        background: transparent;
+    }
+    &::-webkit-progress-value {
+        background: currentColor;
+        border-radius: 100px;
+        min-width: $plyr-range-track-height;
+    }
+    &::-moz-progress-bar {
+        background: currentColor;
+        border-radius: 100px;
+        min-width: $plyr-range-track-height;
+    }
+    &::-ms-fill {
+        border-radius: 100px;
+    }
+}
+.plyr__progress--played[value],
+.plyr__volume--display[value] {
+    z-index: 1;
+    color: $plyr-range-selected-bg;
+    background: transparent;
+    transition: none;
+
+    &::-webkit-progress-value {
+        min-width: $plyr-range-track-height;
+        max-width: 99%;
+        border-top-right-radius: 0;
+        border-bottom-right-radius: 0;
+    }
+    &::-moz-progress-bar {
+        min-width: $plyr-range-track-height;
+        max-width: 99%;
+        border-top-right-radius: 0;
+        border-bottom-right-radius: 0;
+    }
+    &::-ms-fill {
+        display: none;
+    }
+}
+.plyr__progress--buffer[value] {
+    &::-webkit-progress-value {
+        transition: width .2s ease;
+    }
+    &::-moz-progress-bar {
+        transition: width .2s ease;
+    }    
+    &::-ms-fill {
+        transition: width .2s ease;
+    }            
+}
+.plyr--video .plyr__progress--buffer[value],
+.plyr--video .plyr__volume--display[value] {
+    background: $plyr-video-range-track-bg;
+}
+.plyr--video .plyr__progress--buffer[value] { 
+    color: $plyr-video-progress-buffered-bg;
+}
+.plyr--audio .plyr__progress--buffer[value],
+.plyr--audio .plyr__volume--display[value] {
+    background: $plyr-audio-range-track-bg;
+}
+.plyr--audio .plyr__progress--buffer[value] {
+    color: $plyr-audio-progress-buffered-bg;
+}
+
+// Loading state
+.plyr--loading .plyr__progress--buffer {
+    animation: plyr-progress 1s linear infinite;
+    background-size: $plyr-progress-loading-size $plyr-progress-loading-size;
+    background-repeat: repeat-x;
+    background-image: linear-gradient(
+        -45deg,
+        $plyr-progress-loading-bg 25%,
+        transparent 25%,
+        transparent 50%,
+        $plyr-progress-loading-bg 50%,
+        $plyr-progress-loading-bg 75%,
+        transparent 75%,
+        transparent);
+    color: transparent;
+}
+.plyr--video.plyr--loading .plyr__progress--buffer {
+    background-color: $plyr-video-progress-buffered-bg;
+}
+.plyr--audio.plyr--loading .plyr__progress--buffer {
+    background-color: $plyr-audio-progress-buffered-bg;
+}
+
+// Time
+// --------------------------------------------------------------
+.plyr__time {
+    display: inline-block;
+    vertical-align: middle;
+    font-size: $plyr-font-size-small;
+    line-height: .95;
+    -webkit-font-smoothing: subpixel-antialiased;
+}
+// Media duration hidden on small screens
+.plyr__time + .plyr__time {
+    display: none;
+
+    @media (min-width: $plyr-bp-screen-md) {
+        display: inline-block;
+    }
+
+    // Add a slash in before
+    &::before {
+        content: '\2044';
+        margin-right: $plyr-control-spacing;
+    }
+}
+
+// Volume
+// --------------------------------------------------------------
+.plyr .plyr__volume { 
+    display: none;
+    position: relative;
+
+    input[type="range"] {
+        position: relative;
+        z-index: 2;
+    }
+    @media (min-width: $plyr-bp-screen-sm) {
+        display: block;
+        max-width: 60px;
+    }
+    @media (min-width: $plyr-bp-screen-md) {
+        max-width: 100px;
+    }
+}
+
+// Hide sound controls on iOS
+// It's not supported to change volume using JavaScript:
+// https://developer.apple.com/library/safari/documentation/AudioVideo/Conceptual/Using_HTML5_Audio_Video/Device-SpecificConsiderations/Device-SpecificConsiderations.html
+.plyr--is-ios .plyr__volume,
+.plyr--is-ios [data-plyr='mute'] {
+    display: none !important;
+}
+
+// Fullscreen
+// --------------------------------------------------------------
+.plyr--fullscreen,
+.plyr--fullscreen-active {
+    position: fixed;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    height: 100%;
+    width: 100%;
+    z-index: 10000000;
+    background: #000;
+    border-radius: 0;
+
+    video {
+        height: 100%;
+    }
+    .plyr__video-wrapper {
+        height: 100%;
+        width: 100%;
+    }
+    .plyr__controls {
+        position: absolute;
+        bottom: 0;
+        left: 0;
+        right: 0;
+    }
+}
diff --git a/src/scss/variables.scss b/src/scss/variables.scss
new file mode 100644
index 00000000..baf47e25
--- /dev/null
+++ b/src/scss/variables.scss
@@ -0,0 +1,67 @@
+// ==========================================================================
+// Plyr variables
+// https://github.com/selz/plyr
+// https://robots.thoughtbot.com/sass-default
+// ==========================================================================
+
+// Colors
+$plyr-color-main:                       #3498db !default;
+
+// Font sizes
+$plyr-font-size-small:                  14px !default;
+$plyr-font-size-base:                   16px !default;
+
+// Captions
+$plyr-font-size-captions-base:          ceil($plyr-font-size-base * 1.25) !default;
+$plyr-font-size-captions-medium:        ceil($plyr-font-size-base * 1.5) !default;
+$plyr-font-size-captions-large:         ($plyr-font-size-base * 2) !default;
+
+// Controls
+$plyr-control-spacing:                  10px !default;
+$plyr-video-controls-bg:                #000 !default;
+$plyr-video-control-color:              #fff !default;
+$plyr-video-control-color-hover:        #fff !default;
+$plyr-video-control-bg-hover:           $plyr-color-main !default;
+$plyr-audio-controls-bg:                #fff !default;
+$plyr-audio-controls-border:            1px solid #dbe3e8 !default;
+$plyr-audio-controls-box-shadow:        0 1px 1px transparentize(#000, .95) !default;
+$plyr-audio-control-color:              #565D64 !default;
+$plyr-audio-control-color-hover:        #fff !default;
+$plyr-audio-control-bg-hover:           $plyr-color-main;
+
+// Tooltips
+$plyr-tooltip-bg:                       $plyr-video-controls-bg !default;
+$plyr-tooltip-border-color:             transparentize(darken($plyr-video-controls-bg, 75%), .9) !default;
+$plyr-tooltip-arrow-border-color:       transparentize(darken($plyr-video-controls-bg, 75%), .8) !default;
+$plyr-tooltip-border-width:             1px !default;
+$plyr-tooltip-shadow:                   0 0 5px $plyr-tooltip-border-color, 0 0 0 $plyr-tooltip-border-width $plyr-tooltip-border-color !default;
+$plyr-tooltip-color:                    $plyr-video-control-color !default;
+$plyr-tooltip-padding:                  ($plyr-control-spacing / 2) !default;
+$plyr-tooltip-arrow-size:               4px !default;
+$plyr-tooltip-radius:                   3px !default;
+
+// Progress
+$plyr-progress-loading-size:            25px !default;
+$plyr-progress-loading-bg:              transparentize(#000, .85) !default;
+$plyr-video-progress-bg:                transparentize(#fff, .75) !default;
+$plyr-video-progress-buffered-bg:       $plyr-video-progress-bg !default;
+$plyr-audio-progress-bg:                transparentize(#C6D6DB, .33) !default;
+$plyr-audio-progress-buffered-bg:       $plyr-audio-progress-bg !default;
+
+// Range sliders
+$plyr-range-track-height:               8px !default;
+$plyr-range-thumb-height:               floor($plyr-range-track-height * 2) !default;
+$plyr-range-thumb-width:                floor($plyr-range-track-height * 2) !default;
+$plyr-range-thumb-bg:                   #fff !default;
+$plyr-range-thumb-border:               2px solid transparent !default;
+$plyr-range-thumb-shadow:               0 1px 1px transparentize($plyr-video-controls-bg, .85), 0 0 0 1px transparentize(#000, .85) !default;
+$plyr-range-thumb-active-border-color:  #fff !default;
+$plyr-range-thumb-active-bg:            $plyr-video-control-bg-hover !default;
+$plyr-range-thumb-active-scale:         1.25 !default;
+$plyr-video-range-track-bg:             $plyr-video-progress-buffered-bg !default;
+$plyr-audio-range-track-bg:             $plyr-audio-progress-buffered-bg !default;
+$plyr-range-selected-bg: 				$plyr-color-main !default;
+
+// Breakpoints
+$plyr-bp-screen-sm:                     480px !default;
+$plyr-bp-screen-md:                     768px !default;
\ No newline at end of file