Style fixes (#144)

* change "title__thicc" classname to "title--thicc" to reflect BEM naming convention

* fix indentation in index.njk

* add vertical spacing between homepage sections

* convert ".help" class to ".box__list" class

CSS classes generally shouldn't be related to content

* remove duplicate code for .page

* change auto-grid class to "auto-fit", from "auto-fill"

This reduces unused negative space on screens between 800-1200px wide

* use proper BEM practice - block, then modifier class

* refactor .flag styles to be more BEM

* add BEM block-level class to h1

* refactor box__list to simply "list"

* It will be its own component rather than element of the "box" block

* Remove duplicate (older) thicc styles from _header.scss

* rename .title--thicc to .thicc-headline to be more consistent with other "headline" heading classes

* rename another .title--thicc -> .thicc-headline

* refactor CSS selector from adjacent to class

* refactor the whole header to separate grid layout and typography

* remove unneeded grid style

* it's not a grid item

* remove sub-headline typography from _header.scss and add it to _typography.scss

* remove horizontal margin from box below tablet size

* noticed that the .box class, which is already squished on 320px wide screens, is more squished because of its margins.

* allow headings to wrap if necessary

noticed that headings (e.g. "development and build") were blowing out the grid on small screens and causing horizontal scroll

* rename subtitle to "sub-headline"

* convert <section> to <header>

makes more semantic sense for a screen-reader, since this really is the header of the document.

* discard heading wrapper element in favour of having just the heading element

Co-authored-by: Oscar <ovlb@users.noreply.github.com>

11ty/_includes/components/table-of-content-item.njk

@@ -4,12 +4,12 @@
     definition.data.flag and
     definition.data.flag.text and
     (definition.data.flag.level == 'avoid') -%}
-    <span class="flag__red">{{ definition.data.flag.text }}</span>
+    <span class="flag flag--red">{{ definition.data.flag.text }}</span>
   {%- elseif
     definition.data.flag and
     definition.data.flag.text and
     (definition.data.flag.level == 'warning') -%}
-    <span class="flag__yellow">{{ definition.data.flag.text }}</span>
+    <span class="flag flag--yellow">{{ definition.data.flag.text }}</span>
   {% endif %}
   {%- if definition.data.sub_terms -%}
     <ul class="sub-terms" role="list" aria-label="{{definition.data.title}}">

11ty/_includes/components/table-of-content.njk

@@ -1,4 +1,4 @@
-<section>
+<section class="homepage-section homepage-section--toc">
   <h2 id="terms-heading" class="visually-hidden">Terms</h2>
   <nav class="" aria-labelledby="terms-heading">
     <ol class="multi-column u-no-padding-left list">

11ty/_includes/layouts/documentation.njk

@@ -14,7 +14,7 @@
           <a href={{ parent.href }}>{{ parent.title }}</a>
         </div>
       {% endif %}
-      <h1 class="title__thicc" >{{ title }}</h1>
+      <h1 class="thicc-headline" >{{ title }}</h1>
       {{ content | safe }}
     </main>
   {% endblock %}

11ty/index.njk

@@ -2,23 +2,25 @@
 layout: layouts/index.njk
 ---
 
-<section id="introduction" class="auto-grid">
+<header class="auto-grid introduction">
-      <h1 class="title__thicc" id="title">Self-Defined</h1>
+  <h1 class="introduction__title thicc-headline" id="title">
-      <p>A modern dictionary about us.<br>We define our words, but they don't define us.</p>
+    Self-Defined
-      <div>
+  </h1>
-        <p class="summary">
+  <p class="introduction__body">A modern dictionary about us.<br>We define our words, but they don't define us.</p>
-          Self-Defined seeks to provide more inclusive, holistic, and fluid definitions to reflect the diverse perspectives of the modern world.
+  <div>
-        </p>
+    <p class="summary">
-        <p>
+      Self-Defined seeks to provide more inclusive, holistic, and fluid definitions to reflect the diverse perspectives of the modern world.
-          With the foundation of vocabulary, we can begin to understand lived experiences of people different than us. Words can provide us with a sense of identify and allow us to find kinship through common experiences.
+    </p>
-        </p>
+    <p>
-      </div>
+      With the foundation of vocabulary, we can begin to understand lived experiences of people different than us. Words can provide us with a sense of identify and allow us to find kinship through common experiences.
-      <div class="box">
+    </p>
-        <h2 class="subtitle">Ways to help</h2>
+  </div>
-        <ol class="help">
+  <div class="box">
-          <li>Submit words and definitions or contribute to our code base through <a href="https://github.com/tatianamac/selfdefined/pulls" rel="noreferral">pull requests</a> or <a href="https://github.com/tatianamac/selfdefined/issues" rel="noreferral">issues</a>. Start with our <a href="https://github.com/tatianamac/selfdefined/blob/master/CONTRIBUTING.md" rel="noreferral">contributing guidelines</a> and <a href="/documentation/">documentation</a>.</li>
+    <h2 class="sub-headline">Ways to help</h2>
-          <li>Sponsor this work through <a href="https://opencollective.com/selfdefined">Open Collective</a> or <a href="https://github.com/sponsors/tatianamac">GitHub Sponsors</a>.</li>
+    <ol class="list">
-          <li>Follow us on Twitter <a href="https://www.twitter.com/selfdefinedapp">@SelfDefinedApp</a>.</li>
+      <li>Submit words and definitions or contribute to our code base through <a href="https://github.com/tatianamac/selfdefined/pulls" rel="noreferral">pull requests</a> or <a href="https://github.com/tatianamac/selfdefined/issues" rel="noreferral">issues</a>. Start with our <a href="https://github.com/tatianamac/selfdefined/blob/master/CONTRIBUTING.md" rel="noreferral">contributing guidelines</a> and <a href="/documentation/">documentation</a>.</li>
-        </ol>
+      <li>Sponsor this work through <a href="https://opencollective.com/selfdefined">Open Collective</a> or <a href="https://github.com/sponsors/tatianamac">GitHub Sponsors</a>.</li>
-      </div>
+      <li>Follow us on Twitter <a href="https://www.twitter.com/selfdefinedapp">@SelfDefinedApp</a>.</li>
-      </section>
+    </ol>
+  </div>
+</header>

assets/css/base.scss

@@ -23,6 +23,7 @@
 
 // 6. Page-specific styles
 @import './layouts/pages';
+@import './layouts/homepage';
 
 // 7. Themes
 // @import

assets/css/base/_helpers.scss

@@ -10,13 +10,6 @@
   font-style: italic;
 }
 
-.help {
-  margin: 1rem 0;
-  li {
-    margin: 0.75rem 0;
-  }
-}
-
 .visually-hidden {
   clip: rect(0 0 0 0);
   clip-path: inset(100%);

assets/css/base/_typography.scss

@@ -9,6 +9,7 @@ h3,
 h4 {
   margin-bottom: 0.5em;
   margin-top: 1em;
+  word-break: break-word;
 }
 
 p {
@@ -17,42 +18,31 @@ p {
   margin: 0.75rem 0;
 }
 
-.title__thicc {
+.thicc-headline {
   // a sensible base font size
   font-size: 3rem;
   line-height: 0.75;
   margin: 0.5rem 0rem;
   padding: 0;
-  // transform: rotateZ(90deg);
-  // margin: 13rem -7rem;
 }
 
 @media (min-width: 51rem) and (min-height: 400px) {
   // a dramatic font size
-  .title__thicc {
+  .thicc-headline {
     font-size: 12vh;
   }
 }
 
 @media (min-width: 51rem) and (min-height: 850px) {
-  // cap the max-height of the title
+  // cap the maximum font size of the title
   // at the same size that 12vh computes to
   // when the viewport is 850px high
-  .title__thicc {
+  // One day we can use CSS clamp https://caniuse.com/#feat=mdn-css_types_clamp
+  .thicc-headline {
     font-size: 6.75rem;
   }
 }
 
-@media (min-width: 800px) {
-  .title__thicc {
-    grid-column: 1 / 3;
-  }
-
-  .title__thicc + p {
-    grid-column: 1 / 2;
-  }
-}
-
 .main-headline {
   font-family: orpheuspro, Palatino, Times, serif;
   font-size: 3.5rem;
@@ -60,11 +50,15 @@ p {
   margin: 0;
 }
 
-.subtitle {
+.sub-headline {
+  font-size: 1.25rem;
+  font-weight: bold;
+}
+
+.sub-headline {
   font-family: $ext-sans;
   font-size: 1.25rem;
   font-weight: $regular;
-  grid-column: span 2;
   letter-spacing: 0.1;
   margin: .75rem 0;
 }

assets/css/components/_flag.scss

@@ -1,5 +1,4 @@
-.flag__red {
+.flag {
-  background-color:$lt-background-color;
   border-radius: 1rem;
   display: inline-block;
   font-size: 0.9rem;
@@ -7,25 +6,19 @@
   margin: 0.5rem 0.75rem 0.25rem 0;
   padding: 0.45rem 0.65rem;
   text-transform: lowercase;
-
+  &--red {
-  &:before {
+    background-color:$lt-background-color;
-    @include icon__avoid();
+    &:before {
-    @include icon__embed();
+      @include icon__avoid();
+      @include icon__embed();
+    }
   }
-}
+  &--yellow {
-
+    background-color: $lt-background-color-warning;
-.flag__yellow {
+  
-  background-color: $lt-background-color-warning;
+    &:before {
-  border-radius: 1rem;
+      @include icon__warning();
-  display: inline-block;
+      @include icon__embed();
-  font-size: 0.9rem;
+    }
-  font-weight: bold;
-  margin: 0.5rem 0.75rem 0.25rem 0;
-  padding: 0.45rem 0.65rem;
-  text-transform: lowercase;
-
-  &:before {
-    @include icon__warning();
-    @include icon__embed();
   }
-}
+}

assets/css/layouts/_homepage.scss

@@ -0,0 +1,7 @@
+.homepage-section {
+  margin-top: calc(var(--l-gap) * 2);
+
+  @media (min-width: 800px) {
+    margin-top: calc(var(--l-gap) * 4);
+  }
+}

assets/css/structures/_grid.scss

@@ -10,7 +10,7 @@
   display: grid;
   grid-gap: var(--l-gap);
   grid-template-columns: repeat(
-    auto-fill,
+    auto-fit,
     minmax(var(--auto-grid-min-size), 1fr)
   );
 }
@@ -51,23 +51,16 @@
   grid-template-columns: 1fr 4fr;
 }
 
-.page {
-  align-items: start;
-  display: grid;
-  grid-template-columns: 1fr;
-
-  & > * {
-    grid-column: 1;
-  }
-}
-
 .box {
   background: black;
   color: white;
   grid-column: span 2;
   height: auto;
-  margin: 1rem 0.5rem;
+  margin: 1rem 0;
   padding: 1rem;
+  @media (min-width: #{pxToRem(768)}) {
+    margin: 1rem 0.5rem;
+  }
 
   a {
     color: white;
@@ -78,3 +71,13 @@
     }
   }
 }
+
+.list {
+  margin: 1rem 0;
+  li {
+    margin: 0.75rem 0;
+  }
+  a {
+    word-break: break-word;
+  }
+}

assets/css/structures/_header.scss

@@ -1,44 +1,15 @@
-.title__thicc {
-  // a sensible base font size
-  font-size: 3rem;
-  line-height: 0.75;
-  margin: 0.5rem 0rem;
-  padding: 0;
-  // transform: rotateZ(90deg);
-  // margin: 13rem -7rem;
-}
-
-@media (min-width: 51rem) and (min-height: #{pxToRem(400)}) {
-  // a dramatic font size
-  .title__thicc {
-    font-size: 12vh;
-  }
-}
-
-@media (min-width: 51rem) and (min-height: #{pxToRem(850)}) {
-  // cap the max-height of the title
-  // at the same size that 12vh computes to
-  // when the viewport is 850px high
-  .title__thicc {
-    font-size: 6.75rem;
-  }
-}
-
-@media (min-width: #{pxToRem(800)}) {
-  .title__thicc {
-    grid-column: 1 / 3;
-  }
-
-  .title__thicc + p {
-    grid-column: 1 / 2;
-  }
-}
-
-.sub-headline {
-  font-size: 1.25rem;
-  font-weight: bold;
-}
-
 .summary {
   grid-column: span 2;
 }
+
+
+@media (min-width: 800px) {
+  .introduction {
+    &__title {
+      grid-column: 1 / 3;
+    }
+    &__body {
+      grid-column: 1 / 2;
+    }
+  }
+}