Clean up styleguide content, fix MD issues

mtrythall · mtrythall · commit 0789e28e1fa2 · 2024-08-25T16:26:54.000-04:00
diff --git a/ROBOTS.txt b/ROBOTS.txt
@@ -0,0 +1,4 @@
+Sitemap: /sitemap.xml
+
+User-agent: *
+Disallow:
diff --git a/eleventy.config.js b/eleventy.config.js
@@ -30,6 +30,8 @@ module.exports = (config) => {
     "src/_content/places/*.{png,jpg,jpeg,webp,svg}": "venue/",
   });
   config.addPassthroughCopy("CNAME");
+  config.addPassthroughCopy("ROBOTS.txt");
+
 
   /*
     Setup watch targets
diff --git a/src/404.html b/src/404.html
@@ -2,7 +2,7 @@
 layout: default
 
 title: Page Not Found
-description: >
+description: |
   The page you're looking for doesn't exist.
 
 permalink: /404.html
diff --git a/src/_content/styleguide/badges.html b/src/_content/styleguide/badges.html
@@ -1,6 +1,6 @@
 ---
 title: Badges
-description: >
+description: |
   Badges are used to indicate status, denote a count, or to draw attention to an element. Badges are created by applying `.badge` to an element. Colors may be changed by applying a background color utility class, e.g. `bg-blue` to create a blue badge.
 ---
 
diff --git a/src/_content/styleguide/blocks-grids.html b/src/_content/styleguide/blocks-grids.html
@@ -1,7 +1,7 @@
 ---
 title: "Blocks & Grids"
 
-description: >
+description: |
   Blocks and grids are the building blocks of the website. They help to organize content and create a visual hierarchy.
 
   There are a few key classes to use when shaping blocks:
diff --git a/src/_content/styleguide/buttons.html b/src/_content/styleguide/buttons.html
@@ -1,6 +1,6 @@
 ---
 title: Buttons
-description: >
+description: |
   Buttons are created by applying `.button` to an element. The button class is a utility class that applies padding, border, and background color.
 
   The button class can be combined with other utility classes to create different button styles. Changing button colors requires changing the background color, e.g. `bg-blue` to create a blue button.
diff --git a/src/_content/styleguide/colors.html b/src/_content/styleguide/colors.html
@@ -1,6 +1,6 @@
 ---
 title: Colors
-description: >
+description: |
   The full color palette is configured in `tailwind.config.js`. The following is a full list of all defined colors and their shades. Note that Tailwind does not provide all of these classes unless used in _source_ files (not compiled output).
 ---
 
diff --git a/src/_content/styleguide/icons.html b/src/_content/styleguide/icons.html
@@ -0,0 +1,41 @@
+---
+title: Icons
+
+description: |
+  Icons are used to visually communicate an action or idea. The `.icon` class can be applied to give them a consistent width and height. Additional height and width classes can be applied to change their sizing, e.g. `w-12 h-12`.
+
+icons:
+  - /assets/img/theme/icons/Bag.svg
+  - /assets/img/theme/icons/Bull.svg
+  - /assets/img/theme/icons/Checklist.svg
+  - /assets/img/theme/icons/Compass.svg
+  - /assets/img/theme/icons/Document.svg
+  - /assets/img/theme/icons/Globe.svg
+  - /assets/img/theme/icons/Hands.svg
+  - /assets/img/theme/icons/Hat.svg
+  - /assets/img/theme/icons/Heart.svg
+  - /assets/img/theme/icons/Megaphone.svg
+  - /assets/img/theme/icons/Money.svg
+  - /assets/img/theme/icons/People.svg
+  - /assets/img/theme/icons/Prompt.svg
+  - /assets/img/theme/icons/Star.svg
+  - /assets/img/theme/icons/Triangle.svg
+---
+
+<table>
+  <thead>
+    <tr>
+      <th>Icon</th>
+      <th>Path</th>
+    </tr>
+  </thead>
+  <tbody>
+    {% for icon in icons %}
+      <tr>
+        <td><img src="{{ icon }}" alt="" class="icon" /></td>
+        <td><code>{{ icon }}</code></td>
+      </tr>
+    {% endfor %}
+  </tbody>
+</table>
+</ul>
diff --git a/src/_content/styleguide/logo-files.html b/src/_content/styleguide/logo-files.html
@@ -1,7 +1,7 @@
 ---
 title: Logo files
 
-description: >
+description: |
   Logos are stored on GitHub in the [resources repository](https://github.com/djangocon/resources).
 
 fullLogoFolder: https://raw.githubusercontent.com/djangocon/resources/main/us-2024/logos/full-logo/
diff --git a/src/_content/styleguide/people.html b/src/_content/styleguide/people.html
diff --git a/src/_content/styleguide/schedule.html b/src/_content/styleguide/schedule.html
diff --git a/src/_content/styleguide/social-links.html b/src/_content/styleguide/social-links.html
@@ -1,3 +1,39 @@
 ---
 title: Social links
+
+description: |
+  Social links are used to direct users to your social media profiles. They are typically displayed in the footer of the website or with contact information for individuals.
+
+  You can include `social-links.html` and pass in the variable `social` to render a full list of icons. Social icons are added to the page via `svg-social-icons.html`.
+
+  Conference specific social share links are stored `conf-social-share.html` and may have some styling differences.
+
+  Colors for social networks are defined in `tailwind.config.js`.
 ---
+
+{% assign social = site.social %}
+
+{%- capture code -%}
+<ul class="flex flex-wrap gap-4 mt-auto">
+  <li>
+    <a class="hover:text-social-twitter" href="{{ social.twitter }}">
+      <svg class="w-8 h-8 icon">
+        <title>X (Formerly Twitter)</title>
+        <use xlink:href="#twitter-icon"></use>
+      </svg>
+    </a>
+  </li>
+  <li>
+    <a class="hover:text-social-github" href="{{ social.github }}">
+      <svg class="w-8 h-8 icon">
+        <title>Github</title>
+        <use xlink:href="#github-icon"></use>
+      </svg>
+    </a>
+  </li>
+</ul>
+{%- endcapture -%}
+
+<div>
+  {% include "code-snippet.html", code:code, lang:'html' %}
+</div>
diff --git a/src/_content/styleguide/sponsor-list.html b/src/_content/styleguide/sponsor-list.html
@@ -1,3 +1,5 @@
 ---
 title: Sponsor list
 ---
+
+{% include "sponsor-listing.html" %}
diff --git a/src/_content/styleguide/typography.html b/src/_content/styleguide/typography.html
@@ -1,6 +1,6 @@
 ---
 title: Typography
-description: >
+description: |
   The default font stack is defined in `tailwind.config.js`. Long form text uses `prose`, and all other sizing is done with utility classes, specific to its use case. There are a few key sizing helper classes.
 
   Typography is based on [Poppins](https://fonts.google.com/specimen/Poppins).
diff --git a/src/_includes/session-card.html b/src/_includes/session-card.html
@@ -16,7 +16,7 @@
 
       <h4 class="order-2 font-semibold leading-tight lg:text-lg">
         {% if session.permalink %}
-          <a href="{{ session.permalink }}" class="cover group-hover:underline">{{ session.title }}</a>
+          <a href="{{ session.permalink }}" class="no-underline cover group-hover:underline">{{ session.title }}</a>
         {% else %}
           {{ session.title }}
         {% endif %}
diff --git a/src/_layouts/presenter.html b/src/_layouts/presenter.html
@@ -1,5 +1,5 @@
 ---
-layout: social/default_social.html
+layout: social/default-social.html
 ---
 
 {{ content }}
diff --git a/src/_layouts/social/default-social.html b/src/_layouts/social/default-social.html
diff --git a/src/_layouts/social/presenter.html b/src/_layouts/social/presenter.html
@@ -1,5 +1,5 @@
 ---
-layout: social/default_social.html
+layout: social/default-social.html
 ---
 
 <div class="session-social-template">
diff --git a/src/_layouts/social/session.html b/src/_layouts/social/session.html
@@ -1,5 +1,5 @@
 ---
-layout: social/default_social.html
+layout: social/default-social.html
 ---
 
 {% assign presenter_count = talk.data.presenter_slugs | size %}
diff --git a/src/about/conduct.html b/src/about/conduct.html
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Code of Conduct
-description: >
+description: |
   DjangoCon US is dedicated to providing a fun harassment-free conference experience for everyone, regardless of gender, gender identity, sexual orientation, disability, physical appearance, body size, race, or religion.
 
 permalink: /conduct/
@@ -108,7 +108,7 @@ <h2>Local authorities</h2>
 
 If you believe someone has violated the Code of Conduct, we encourage you to report it.
 
-If you are unsure whether the incident is a violation, or whether the space where it happened is covered by the Code of Conduct, we encourage you to still report it. 
+If you are unsure whether the incident is a violation, or whether the space where it happened is covered by the Code of Conduct, we encourage you to still report it.
 
 We are fine with receiving reports where we decide to take no action for the sake of creating a safer space.
 
diff --git a/src/about/faq.html b/src/about/faq.html
@@ -2,7 +2,7 @@
 layout: default
 
 title: Frequently Asked Questions
-description: >
+description: |
   Common questions and answers about DjangoCon US.
 
 permalink: /faq/
diff --git a/src/about/hackathon.html b/src/about/hackathon.html
@@ -2,7 +2,7 @@
 layout: default
 
 title: Hackathon
-description: >
+description: |
   We're thrilled to announce the first edition of the DjangoCon US Hackathon, happening this year.
   This is your chance to learn new skills, collaborate with friendly Django developers,
   and showcase your creativity.
diff --git a/src/about/index.html b/src/about/index.html
@@ -2,7 +2,7 @@
 layout: default
 
 title: About DjangoCon US
-description: >
+description: |
   DjangoCon US is dedicated to providing a fun harassment-free conference experience for everyone, regardless of gender, gender identity, sexual orientation, disability, physical appearance, body size, race, or religion.
 ---
 
diff --git a/src/about/opportunity-grants.html b/src/about/opportunity-grants.html
@@ -2,7 +2,7 @@
 layout: default
 
 title: Opportunity Grants
-description: >
+description: |
   As part of our commitment to diversity, we are thrilled to announce that we will be supporting individuals who need opportunity grants to attend DjangoCon US.
 
 permalink: /opportunity-grants/
diff --git a/src/about/public-health.html b/src/about/public-health.html
@@ -2,7 +2,7 @@
 layout: default
 
 title: Public Health Policy
-description: >
+description: |
   DjangoCon US 2024's public health policy includes required testing and a mask recommendation.
 
 permalink: /public-health/
diff --git a/src/about/tickets.html b/src/about/tickets.html
@@ -3,7 +3,7 @@
 
 title: DjangoCon US Tickets
 
-description: >
+description: |
   Information about buying tickets to DjangoCon US
 
 permalink: /tickets/
diff --git a/src/about/visas.html b/src/about/visas.html
@@ -2,7 +2,7 @@
 layout: default
 
 title: Visa Support at DjangoCon US
-description: >
+description: |
   Information about obtaining a Visa to visit DjangoCon US
 
 permalink: /visas/
diff --git a/src/schedule.html b/src/schedule.html
@@ -1,7 +1,7 @@
 ---
 title: Full Conference Schedule
 layout: default
-description: >
+description: |
   The schedule for DjangoCon US 2024.
 
 sitemap: false
@@ -54,7 +54,7 @@ <h2 class="mb-1 font-bold uppercase sr-only">Jump to day</h2>
           <h2
             class="sticky z-20 w-full pt-3 text-lg bg-white lg:top-0 top-20 md:text-2xl lg:py-1lg:bg-white md:pl-56 lg:pl-64"
             id="Day-{{ forloop.index }}">
-              <a href="#Day-{{ forloop.index }}">
+              <a href="#Day-{{ forloop.index }}" class="reverse-link">
                 <span class="font-medium">{{ days[forloop.index0].heading }}</span> /
                 <time datetime="{{ day[0] | formatDateTime: 'yyyy-MM-dd' }}">{{ day[0] | formatDateTime: "EEEE, LLL d" }}</time>
               </a>
diff --git a/src/speaking/index.html b/src/speaking/index.html
@@ -2,7 +2,7 @@
 layout: default
 
 title: Speaking at DjangoCon US
-description: >
+description: |
   Information about submitting a proposal to speak at DjangoCon US
 ---
 
diff --git a/src/speaking/speaker-resources.html b/src/speaking/speaker-resources.html
@@ -2,7 +2,7 @@
 layout: default
 
 title: Speaker Resources
-description: >
+description: |
   Resources to support DjangoCon US 2024 speakers
 ---
 
diff --git a/src/visa-invitation.html b/src/visa-invitation.html
@@ -1,7 +1,7 @@
 ---
 layout: default
 
-description: >
+description: |
   Request your visa invitation letter for DjangoCon US 2024 here.
 
 title: Visa Invitation Letter
