Add <meta> descriptions on most pages (#1768)

* Add <meta> descriptions on most page

* Typo

Co-authored-by: Marcel <MTRNord@users.noreply.github.com>

* Remove pause mention

* Don't mention m.org in Try Matrix's meta description

---------

Co-authored-by: Marcel <MTRNord@users.noreply.github.com>

content/about/index.md

@@ -1,6 +1,11 @@
 +++
 title = "About Matrix"
 aliases = ["/foundation/"]
+extra.meta_description = """
+The Matrix.org Foundation is overseen by its Guardians. The Spec Core Team works
+on maintaining the Matrix Specification in accordance with the Foundation rules
+and manifesto.
+"""
 +++
 
 ## Governance

content/blog/_index.md

@@ -4,4 +4,9 @@ template = "blog.html"
 page_template = "post.html"
 sort_by = "date"
 paginate_by = 10
+extra.meta_description = """
+The Matrix.org Foundation blod is where the Matrix Foundation and Community
+post updates on their activity. Every Friday evening they publish This Week In
+Matrix, a digest of the past week activity.
+"""
 +++

content/docs/chat_basics/matrix-for-im/_index.md

@@ -5,6 +5,10 @@ template = "docs/with_menu.html"
 aliases = ["/docs/", "/docs/chat_basics/"]
 [extra]
 updated = "2022-10-18T16:00:00Z"
+meta_description = """
+Matrix is an open protocol many apps can use for secure, decentralised
+communications. Your first steps with Matrix start here.
+"""
 +++
 
 ## What is it?

content/docs/chat_basics/private-group-chat/_index.md

@@ -6,6 +6,11 @@ template = "docs/with_menu.html"
 emoji = "🧑‍🤝‍🧑"
 tile = "I want to create a private group chat"
 updated = "2022-10-18T16:00:00Z"
+meta_description = """
+Matrix can be used to create small private group chats. It can be used to send
+messages, invite others, but it also has moderation features to keep the group
+safe.
+"""
 +++
 
 The simplest way to get started is to create a private group chat so you can

content/docs/chat_basics/public-rooms/_index.md

@@ -6,6 +6,11 @@ template = "docs/with_menu.html"
 emoji = "🌐"
 tile = "I want to join public conversations"
 updated = "2022-10-18T16:00:00Z"
+meta_description = """
+Matrix is often use for public online discussions. Being an interoperable
+protocol, it allows people using different providers to talk together online,
+safely.
+"""
 +++
 
 When you want to join larger public conversations, you have three major options

content/docs/communities/getting-started/_index.md

@@ -7,6 +7,10 @@ aliases = ["/docs/communities/"]
 emoji = "👪"
 tile = "Create a cozy place on Matrix for your community or organisation"
 updated = "2022-11-18T09:50:00Z"
+meta_description = """
+Everyone can start their community on Matrix by creating a Matrix Space.
+Community Managers can then tweak the Space to their needs.
+"""
 +++
 
 We strongly recommend getting familiar with Matrix as an individual. It's easy

content/docs/communities/moderation/_index.md

@@ -6,6 +6,11 @@ weight = 200
 emoji = "🛡️"
 tile = "I want to deploy moderation tools"
 updated = "2023-01-25T06:43:00Z"
+meta_description = """
+Matrix allows communities to stay safe thanks to moderation tools. Mjolnir is
+the recommended solution for community managers who want to fight abuse on
+Matrix.
+"""
 +++
 
 ## Power levels

content/docs/communities/switching-providers/_index.md

@@ -6,6 +6,11 @@ weight = 300
 emoji = "🏡"
 tile = "I want to get my own homeserver"
 updated = "2023-01-30T14:00:00Z"
+meta_description = """
+Even after creating a community on a provider, it's possible to switch to
+another one. This allows communities to get more sovereignty on their
+conversations, and to connect them to their own systems.
+"""
 +++
 
 ## Why switching providers?

content/docs/legacy/_index.md

@@ -7,6 +7,10 @@ weight = 900
 [extra]
 emoji = "🕸️"
 tile = "Legacy documentation"
+meta_description = """
+This section contains all the documentation previously published that is no
+longer relevant or maintained. It is kept online for archive purposes.
+"""
 +++
 
 This section contains all the outdated documentation from the former matrix.org

content/docs/matrix-concepts/elements-of-matrix/_index.md

@@ -5,6 +5,11 @@ template = "docs/with_menu.html"
 aliases = ["/docs/matrix-concepts", "/docs/technical/"]
 [extra]
 updated = "2023-02-08T08:00:00Z"
+meta_description = """
+Matrix relies on homeservers to connect clients together. Appservices are
+pieces of software that can bridge Matrix and third-party platforms together.
+The Matrix Specification defines the interactions between all those.
+"""
 +++
 
 Matrix works like email, but for instant messaging. People need to use a client

content/docs/matrix-concepts/rooms_and_events/_index.md

@@ -4,6 +4,11 @@ weight = 200
 template = "docs/with_menu.html"
 [extra]
 updated = "2023-02-23T08:00:00Z"
+meta_description = """
+Matrix relies on rooms to distribute events across servers and clients. Rooms
+have a hierarchy based on power levels. Each homeserver has its own copy of all
+the rooms all their users belong to.
+"""
 +++
 
 Users on a server can send *events* into *rooms*. An event is a particular json

content/ecosystem/hosting/index.md

@@ -2,6 +2,9 @@
 title = "Hosting"
 template = "ecosystem/hosting.html"
 weight = 4
+extra.summary = """
+Everyone can host their Matrix server, but not everybody wants. Those are the providers the Matrix Foundation knows about. 
+"""
 +++
 
 ## Why not matrix.org?

content/podcasts/index.md

@@ -2,5 +2,10 @@
 title = "Podcasts"
 template = "podcasts.html"
 aliases = ["/matrixlive/"]
+extra.meta_description = """
+Matrix Live is the weekly show produced by the Matrix Foundation to talk about
+the latest Matrix news. Open Tech Will Save Us was a show to talk about the
+importance of open standards and open source software for social good.
+"""
 +++
 

content/try-matrix.md

@@ -2,4 +2,8 @@
 title = "Try Matrix"
 template = "try-matrix.html"
 extra.summary = "Join the Matrix ecosystem!"
+extra.meta_description = """
+To try Matrix, pick a client, pick a server, register an account and start
+chatting!
+"""
 +++

templates/ecosystem/bridges.html

@@ -1,4 +1,7 @@
 {% extends "section.html" %}
+{% block head_extra %}
+<meta name="description" content="{{ section.extra.summary }}">
+{% endblock head_extra %}
 {% block content %}
 <div class="page-header">
     <div class="hero-block">
@@ -12,23 +15,23 @@
     {{ section.content | safe }}
 
     <div class="platforms-grid">
-    {% for subsection_path in section.subsections %}
-    {% set subsection = get_section(path=subsection_path) %}
-    {% set bridges_data = load_data(path=subsection.path~"bridges.toml") %}
+        {% for subsection_path in section.subsections %}
+        {% set subsection = get_section(path=subsection_path) %}
+        {% set bridges_data = load_data(path=subsection.path~"bridges.toml") %}
         <a href="{{ subsection.path }}" class="platform">
             <img src="{{ subsection.path }}logo.svg" />
             <div class="details">
                 <h2>{{ subsection.title }}</h2>
                 <p>
                     {% if bridges_data.bridges %}
-                        {{ bridges_data.bridges | length }} bridge{% if bridges_data.bridges | length > 1 %}s{% endif %}
+                    {{ bridges_data.bridges | length }} bridge{% if bridges_data.bridges | length > 1 %}s{% endif %}
                     {% else %}
-                        No bridge
+                    No bridge
                     {% endif %}
                 </p>
             </div>
         </a>
-    {% endfor %}
+        {% endfor %}
     </div>
 
 </div>

templates/ecosystem/client.html

@@ -1,5 +1,8 @@
 {% extends "page.html" %}
 {% import "macros/clients.html" as clients %}
+{% block head_extra %}
+<meta name="description" content="{{ page.content | replace(from="<p>", to="") | replace(from="</p>", to="") }}">
+{% endblock head_extra %}
 {% block content %}
 {% if page.extra.thumbnail %}
 {% set thumbnail = page.extra.thumbnail %}

templates/ecosystem/clients.html

@@ -2,6 +2,7 @@
 {% import "macros/clients.html" as clients %}
 {% import "macros/client_details.html" as client_details %}
 {% block head_extra %}
+<meta name="description" content="{{ section.extra.summary }}">
 <noscript>
     <link rel="stylesheet" href="/no-js.css" />
 </noscript>

templates/ecosystem/hosting.html

@@ -1,12 +1,12 @@
 {% extends "page.html" %}
+{% block head_extra %}
+<meta name="description" content="{{ page.extra.summary }}">
+{% endblock head_extra %}
 {% block content %}
 <div class="page-header">
     <div class="hero-block">
-        <h1>Hosting</h1>
-        <p>
-            Everyone can host their Matrix server, but not everybody wants.
-            Those are the providers the Matrix Foundation knows about.
-        </p>
+        <h1>{{ page.title }}</h1>
+        <p>{{ page.extra.summary }}</p>
     </div>
 </div>
 

templates/ecosystem/sdks.html

@@ -1,5 +1,6 @@
 {% extends "page.html" %}
 {% block head_extra %}
+<meta name="description" content="{{ page.extra.summary }}">
 <noscript>
     <link rel="stylesheet" href="/no-js.css" />
 </noscript>

templates/ecosystem/servers.html

@@ -1,5 +1,6 @@
 {% extends "page.html" %}
 {% block head_extra %}
+<meta name="description" content="{{ page.extra.summary }}">
 <noscript>
     <link rel="stylesheet" href="/no-js.css" />
 </noscript>

templates/index.html

@@ -1,5 +1,7 @@
 {% extends "skel.html" %}
 {% block head_extra %}
+<meta name="description"
+    content="The homepage of the matrix.org website. Chat securely with your family, friends, community, or build great apps with Matrix!">
 <link rel="alternate" type="application/rss+xml" title="RSS" href="{{ get_url(path='atom.xml', trailing_slash=false)}}">
 {% endblock head_extra %}
 {% block content %}

templates/page.html

@@ -1,5 +1,10 @@
 {% extends "skel.html" %}
 {% block html_title %}Matrix.org - {{ page.title }}{% endblock html_title %}
+{% block head_extra %}
+{% if page.extra.meta_description %}
+<meta name="description" content="{{ page.extra.meta_description }}">
+{% endif %}
+{% endblock head_extra %}
 {% block content %}
 <article class="content">
     <header>

templates/podcasts.html

@@ -1,4 +1,4 @@
-{% extends "index.html" %}
+{% extends "page.html" %}
 {% block content %}
 {% set matrix_live = load_data(path="partials/podcasts/matrix_live.md") %}
 {% set otwsu = load_data(path="partials/podcasts/otwsu.md") %}

templates/section.html

@@ -1,5 +1,10 @@
 {% extends "skel.html" %}
 {% block html_title %}Matrix.org - {{ section.title }}{% endblock html_title %}
+{% block head_extra %}
+{% if section.extra.meta_description %}
+<meta name="description" content="{{ section.extra.meta_description }}">
+{% endif %}
+{% endblock head_extea %}
 {% block content %}
 <div class="content">
     <header>