feat: improve SEO and indexing on all pages (#577)

cal-itp · Aug 25, 2024 · 1cb9b36 · 1cb9b36
2 parents ccc0044 + 7815e65
commit 1cb9b36
Show file tree

Hide file tree

Showing 15 changed files with 86 additions and 17 deletions.
diff --git a/Gemfile b/Gemfile
@@ -3,3 +3,5 @@ source "https://rubygems.org"
 gem "jekyll", "~> 4.3.3"
 gem "rubyzip", "~> 2.3"
 gem "jekyll-sass-converter", "2.2.0"
+gem "jekyll-seo-tag", "~> 2.8.0"
+gem "jekyll-sitemap", "~> 1.4.0"
diff --git a/Gemfile.lock b/Gemfile.lock
@@ -32,6 +32,10 @@ GEM
       webrick (~> 1.7)
     jekyll-sass-converter (2.2.0)
       sassc (> 2.0.1, < 3.0)
+    jekyll-seo-tag (2.8.0)
+      jekyll (>= 3.8, < 5.0)
+    jekyll-sitemap (1.4.0)
+      jekyll (>= 3.7, < 5.0)
     jekyll-watch (2.2.1)
       listen (~> 3.0)
     kramdown (2.4.0)
@@ -70,6 +74,8 @@ PLATFORMS
 DEPENDENCIES
   jekyll (~> 4.3.3)
   jekyll-sass-converter (= 2.2.0)
+  jekyll-seo-tag (~> 2.8.0)
+  jekyll-sitemap (~> 1.4.0)
   rubyzip (~> 2.3)
 
 BUNDLED WITH

diff --git a/_config.yml b/_config.yml
@@ -55,3 +55,6 @@ title: California Mobility Marketplace
 theme_color: "#ffffff"
 theme_color_background: "#ffffff"
 url: "https://www.camobilitymarketplace.org" # the base hostname & protocol for your site, e.g. http://example.com
+plugins:
+  - jekyll-seo-tag
+  - jekyll-sitemap
diff --git a/src/_layouts/default.html b/src/_layouts/default.html
@@ -1,23 +1,16 @@
 <!DOCTYPE html>
 <html lang="en">
   <head>
-    {%- capture title -%} {% assign this_title = page.title | default: post.title %} {% if this_title %}{{ this_title }} | {%
-    endif %}{{ site.title }} {%- endcapture %}
     <meta charset="utf-8" />
-    <title>{{ title }}</title>
-    <meta name="description" content="{{site.description}}" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <meta property="og:title" content="{{title}}" />
-    <meta property="og:type" content="website" />
-    <meta property="og:url" content="{{site.url}}/" />
-    <meta property="og:image" content="{{site.url}}/uploads/open-graph.png" />
-    <meta name="twitter:card" content="summary_large_image" />
-    <meta property="twitter:domain" content="{{site.domain}}" />
-    <meta property="twitter:url" content="{{site.url}}/" />
-    <meta name="twitter:title" content="{{title}}" />
-    <meta name="twitter:description" content="{{site.description}}" />
-    <meta name="twitter:image" content="{{site.url}}/uploads/open-graph.png" />
+    {%- capture title -%}
+      {% assign this_title = page.title | default: post.title %}
+      {% if this_title %}{{ this_title }} | {% endif %}{{ site.title }}
+    {%- endcapture %}
+    {% assign description = page.description | default: site.description %}
+
+    {% seo title=title description=description %}
 
     <link rel="manifest" href="/site.webmanifest" />
     <link rel="apple-touch-icon" href="/uploads/icon.png" />
@@ -34,7 +27,6 @@
 
     <link href="https://fonts.googleapis.com/css2?{{site.fonts}}&display=swap" rel="stylesheet" />
     <link rel="stylesheet" href="/styles/styles.css" />
-    <link rel="canonical" href="{{ page.url | absolute_url }}" />
 
     <meta name="theme-color" content="{{site.theme_color}}" />
   </head>

diff --git a/src/_pages/about.md b/src/_pages/about.md
@@ -1,6 +1,11 @@
 ---
 layout: skinny
+
 title: About us
+description: >
+  Managed by Cal-ITP, this website seeks to make the transition to contactless
+  fare collection and GTFS Realtime compliance as easy and cost-effective as
+  possible.
 ---
 Welcome to the California Mobility Marketplace!
 

diff --git a/src/_pages/contactless-payment-methods.md b/src/_pages/contactless-payment-methods.md
@@ -1,14 +1,19 @@
 ---
 layout: skinny
+
 title: Contactless payment methods
+description: >
+  By supporting contactless payment methods, riders can use their contactless
+  bank cards, prepaid cards, and smart devices to pay for public transit as they
+  would for everyday purchases.
 ---
 Contactless fare collection allows riders to pay for public transit using the same payment methods they use for other everyday purchases. This page explains the different methods that riders will soon be able to use to tap to pay for transit across California at participating transit operators.
 
 ## Contactless bank cards
 
 A **contactless bank card** is a credit, debit, or reloadable prepaid card that riders can tap on a fare validator to pay. Contactless cards use near-field communication (NFC) technology, which lets the card communicate with a terminal to quickly complete transactions without having to insert or swipe.
 
-Not sure if a card is contactless? Look for the <img src="/assets/uploads/contactless-symbol-small.png" width="12px"> symbol on either the front or the back of the card. If you see it, you’re ready to tap to pay today! If not, you can contact your bank or financial institution to request a contactless replacement card free of charge.
+Not sure if a card is contactless? Look for the <img src="/uploads/contactless-symbol-small.png" width="12px"> symbol on either the front or the back of the card. If you see it, you’re ready to tap to pay today! If not, you can contact your bank or financial institution to request a contactless replacement card free of charge.
 
 ## Prepaid cards
 

diff --git a/src/_pages/glossary-of-key-terms.md b/src/_pages/glossary-of-key-terms.md
@@ -1,7 +1,12 @@
 ---
 layout: skinny
+
 title: Glossary of Key Terms
+description: >
+  Thorough list of terminology and definitions used through the Mobility
+  Marketplace website.
 ---
+
 **Americans with Disabilities Act (ADA)**: 1990 federal legislation that prohibits discrimination based on disability status. Title II requires providers of fixed-route transit to offer paratransit services for people with disabilities.  <br/><br/>
 
 **Arrival predictions**: Real-time transit vehicle locations that estimate arrival times either through platform monitors or web-based applications. <br/><br/>

diff --git a/src/contact.html b/src/contact.html
@@ -1,5 +1,12 @@
 ---
 layout: default
+
+title: Contact us
+description: >
+  Get in touch! If you represent a public Transit Provider based in California
+  or elsewhere in the U.S., Cal-ITP can provide materials and support to help
+  modernize your fleet. If you are a vendor, we’d love to hear about your
+  company’s products and/or services.
 ---
 
 <div class="bg-blue-lightest">

diff --git a/src/contracts/index.html b/src/contracts/index.html
@@ -1,6 +1,14 @@
 ---
 layout: skinny
+
 title: California’s Contracts—for U.S. transit agencies
+description: >
+  California has Master Service Agreements (MSA) available to help you modernize
+  your transit system, most of which are available to public transportation
+  providers. The Mobility Marketplace serves as Cal-ITP’s online catalog where
+  transit providers can browse available goods and services to build a system
+  that suits their needs best.
+
 show_newsletter: true
 newsletter_background: bg-dark-tan
 class_name: no-banner

diff --git a/src/contracts/view.html b/src/contracts/view.html
@@ -1,6 +1,12 @@
 ---
 layout: default
+
 title: State of California Contracts
+description: >
+  A list of Master Service Agreements (MSAs) available to help you modernize
+  transit systems. Browse a listing of contracts, their associated vendors, and
+  requirements for implementation.
+
 show_newsletter: true
 newsletter_background: bg-dark-tan
 class_name: no-banner

diff --git a/src/for-vendors.html b/src/for-vendors.html
@@ -1,5 +1,12 @@
 ---
 layout: default
+
+title: Information for vendors
+description: >
+  The California Integrated Travel Project (Cal-ITP) is a statewide initiative
+  to unify transit in California with a common fare payment system, real-time
+  data standard, and seamless verification of reduced-fare eligibility.
+
 show_newsletter: true
 newsletter_background: bg-white
 ---

diff --git a/src/go-contactless.html b/src/go-contactless.html
@@ -1,6 +1,12 @@
 ---
 layout: default
+
 title: Go Contactless
+description: >
+  Riding transit should be as easy as buying a cup of coffee: Regardless of what
+  customers order or where the coffee shop is, they know they can instantly pay
+  by tapping their contactless bank card or smart device.
+
 show_newsletter: true
 newsletter_background: bg-white
 ---

diff --git a/src/how-to/get-connected.md b/src/how-to/get-connected.md
@@ -1,6 +1,13 @@
 ---
 layout: sidebar-toc
+
 title: "How To: Get Connected"
+description: >
+  Enabling contactless payments makes things easy for the rider but as a transit
+  provider, there is some setup required. The California Department of General
+  Services (DGS) has taken care of all the negotiations with service providers
+  and these contracts are now available for providers to use.
+
 class_name: no-footer how-to-go-contactless
 content_class: go-contactless-section go-contactless--how-to
 show_newsletter: false

diff --git a/src/index.html b/src/index.html
@@ -1,5 +1,10 @@
 ---
 layout: default
+
+# Allow the default _config.yml to set these values
+# title: ~
+# description: ~
+
 show_newsletter: true
 newsletter_background: bg-white
 ---

diff --git a/src/provider-map.html b/src/provider-map.html
@@ -1,7 +1,12 @@
 ---
 layout: default
-title: Provider Map
 class_name: provider-map no-banner
+
+title: Provider Map
+description: >
+  The Cal-ITP team has compiled a list of California’s transit providers, including funding information, fleet size,
+  GTFS information, serviced counties, and websites. Explore the data with an interactive map and filterable table or
+  download the full dataset.
 ---
 
 <script>