Release 4.27.0 💎

- Vendor CSS's are excluded for now
- Removed <IE7 asterisk prefix items

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,68 +0,0 @@
----
-name: "Bug Report"
-about: "Is something not working as expected?"
----
-
-<!--
-  Before opening a new issue please:
-  
-  - Verify you have the latest versions of Jekyll and Minimal Mistakes 
-    installed by running `bundle update`.
-  - Thoroughly read the theme's documentation at
-    https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/
-  - Search all issues at https://github.com/mmistakes/minimal-mistakes/issues 
-    for solutions and to avoid duplication.
-  - Ask for help at http://talk.jekyllrb.com/
-  
-  If none of the above solved your problem, you can continue below.
--->
-
-## Environment
-
-<!--
-  Please include theme version, Jekyll version, public git repository, whether 
-  you are hosting with GitHub Pages, and the operating system you tested with.
-
-  Issues without a link to a public repository or ZIP file will likely go ignored.
-  Being able to see your actual files is necessary to troubleshoot, as most 
-  issues stem from invalid/missing YAML Front Matter, a mis-configured _config.yml 
-  file, or problematic site content. 
--->
-
-- Minimal Mistakes version:
-- Ruby gem or remote theme version:
-- Jekyll version:
-- Git repository URL:
-- Hosted on GitHub Pages (if yes provide URL to site):
-- Operating system:
-
-## Expected behavior
-
-<!--
-  What is it you expected to happen? This should be a description of how the
-  functionality you tried to use is supposed to work.
--->
-
-## Steps to reproduce the behavior
-
-<!--
-  Describe the steps you took for this problem to come up. Such as: you installed
-  the theme, customized _config.yml, added your own posts, and started up a 
-  Jekyll server locally.
-
-  If an error occurred on GitHub Pages when pushing, please test a local version
-  following these setup instructions: 
-  https://help.github.com/articles/setting-up-your-github-pages-site-locally-with-jekyll/
-
-  Then provide a complete log by running `bundle exec jekyll build --trace --verbose` 
-  and include this output in the filed issue.
-
-  Screenshots can also be included if they help illustrate a behavior.
--->
-
-## Other
-
-<!--
-  NOTE: Please provide a code repository, gist, code snippet, sample files, 
-  screenshots, or anything else you think will aid in reproducing the issue.
--->

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -19,7 +19,7 @@ body:
   - type: textarea
     id: environment
     attributes:
-      label: What happened?
+      label: Theme version and system environment
       description: |
         Please include theme version, Jekyll version, public git repository, whether
         you are hosting with GitHub Pages, and the operating system you tested with.
@@ -33,8 +33,21 @@ body:
         - Ruby gem or remote theme version:
         - Jekyll version:
         - Git repository URL:
-        - Hosted on GitHub Pages (if yes provide URL to site):
+        - URL to the page with the problem:
         - Operating system:
+        - Browser version:
+    validations:
+      required: true
+
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: |
+        Describe the problem **in detail**. For example:
+
+        - What is missing?
+        - What error do you see? Attach the error log if available.
     validations:
       required: true
 
@@ -78,4 +91,4 @@ body:
         Please provide a code repository, gist, code snippet, sample files,
         screenshots, or anything else you think will aid in reproducing the issue.
     validations:
-      required: false
+      required: false

.github/ISSUE_TEMPLATE/documentation.md

@@ -1,16 +0,0 @@
----
-name: "Documentation"
-about: "Found a typo or something that needs clarification?"
----
-
-<!-- Thanks for taking the time to open an issue and help make the docs better -->
-
-## Motivation
-
-<!-- Why should we update our docs? -->
-
-<!-- What should we do instead? -->
-
-## Suggestion
-
-<!-- What should we do instead? -->

.github/workflows/bad-pr.yml

@@ -17,6 +17,9 @@ jobs:
       - uses: actions-ecosystem/action-add-labels@v1
         with:
           labels: 'Type: Invalid'
+      - uses: actions-ecosystem/action-add-labels@v1
+        with:
+          labels: 'Type: Spam'
       - uses: superbrothers/close-pull-request@v3
         with:
           # Optional. Post an issue comment just before closing a pull request.

.github/workflows/build.yml

@@ -0,0 +1,47 @@
+name: build
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch: {}
+  repository_dispatch: {}
+
+jobs:
+  build:
+    if: github.repository == 'mmistakes/minimal-mistakes'
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: '3.2'
+    - name: Setup cache for Bundler
+      id: cache
+      uses: actions/cache@v4
+      with:
+        path: |
+          docs/Gemfile.lock
+          docs/vendor/bundle
+        key: ${{ runner.os }}-bundler-${{ hashFiles('docs/Gemfile') }}
+        restore-keys: |
+          ${{ runner.os }}-bundler-
+
+    - name: Install - Bundler
+      env:
+        MAKE: make -j2
+      working-directory: docs/
+      run: |
+        bundle config set path vendor/bundle
+        bundle install --jobs=4 --retry=3
+        bundle clean
+
+    - name: Update Algolia index
+      working-directory: docs/
+      run: bundle exec jekyll algolia push
+      env:
+        ALGOLIA_API_KEY: ${{ secrets.ALGOLIA_API_KEY }}
+      continue-on-error: true

CHANGELOG.md

@@ -2,6 +2,49 @@
 
 ## Unreleased
 
+### Enhancements
+
+- Add RTL Support. [#4886](https://github.com/mmistakes/minimal-mistakes/pull/4886)
+- Add missing Polish translation. [#4890](https://github.com/mmistakes/minimal-mistakes/pull/4890)
+- Rewrite most directions with [CSS logical properties](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_logical_properties_and_values).
+- Remove unnecessary "type" attribute (#4956)
+- The "if" means the default is never used (#4955)
+- For pages without a title, show the site title only once (#4959)
+- Use `documents-collection.html` partial in `home` layout.
+- Add Bulgarian translation. [#5003](https://github.com/mmistakes/minimal-mistakes/pull/5003)
+- Add provider and comments info to `single.html` layout for non-production. (#5068)
+- Tweak contrast skin $primary-color to adhere to WCAG guidelines. (#5126)
+- Update social share buttons to reflect Twitter rebranding to X (#5210)
+
+### Bug Fixes
+
+- Replace a redirected link to MadeMistakes in footer. [#4882](https://github.com/mmistakes/minimal-mistakes/pull/4882)
+- Fix wrong float direction for `feature_row` with `type="right"`. [#4061](https://github.com/mmistakes/minimal-mistakes/issues/4061)
+- Fix reset stylesheet overruling `$doc-font-size`. [#4983](https://github.com/mmistakes/minimal-mistakes/issues/4983)
+- Fix JavaScript null error on home and splash layouts. [#4938](https://github.com/mmistakes/minimal-mistakes/issues/4938), [#4939](https://github.com/mmistakes/minimal-mistakes/pull/4939)
+- Fix bad <figure> HTML if "alt" contains quotes.
+- Fix extra newline generated in `_includes/post_pagination.html`.
+- Hide hidden links & remove the overlay when one is clicked. [#5042](https://github.com/mmistakes/minimal-mistakes/pull/5042)
+- Fix typo in "Configuration" (#5106)
+- bundle exec jekyll serve will fail if more than once (#5193)
+
+### Documentation & Maintenance
+
+- Automatically update Algolia search index with GitHub Actions.
+
+## [4.26.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.26.2)
+
+### Enhancements
+
+- Add Czech localization. [#4866](https://github.com/mmistakes/minimal-mistakes/pull/4866)
+- Allow overriding HTML `lang` attribute on a per-page basis. [#4862](https://github.com/mmistakes/minimal-mistakes/pull/4862)
+
+### Bug Fixes
+
+- Figure helper breaks when using code markup in caption with `popup=true`. [#4841](https://github.com/mmistakes/minimal-mistakes/issues/4841)
+
+## [4.26.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.26.1)
+
 ### Bug Fixes
 
 - Disable copy button on invalid syntax highlighting blocks to avoid positioning issues.

README.md

@@ -27,7 +27,7 @@ Minimal Mistakes is a flexible two-column Jekyll theme, perfect for building per
 - Optional [header images](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#headers), [custom sidebars](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#sidebars), [table of contents](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#table-of-contents), [galleries](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#gallery), related posts, [breadcrumb links](https://mmistakes.github.io/minimal-mistakes/docs/configuration/#breadcrumb-navigation-beta), [navigation lists](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#navigation-list), and more.
 - Commenting support (powered by [Disqus](https://disqus.com/), [Facebook](https://developers.facebook.com/docs/plugins/comments), Google+, [Discourse](https://www.discourse.org/), static-based via [Staticman](https://staticman.net/), [utterances](https://utteranc.es/), and [giscus](https://giscus.app/)).
 - [Google Analytics](https://www.google.com/analytics/) support.
-- UI localized text in English (default), Arabic (عربي), Brazilian Portuguese (Português brasileiro), Catalan, Chinese, Danish, Dutch, Finnish, French (Français), German (Deutsch), Greek, Hebrew, Hindi (हिंदी), Hungarian, Indonesian, Irish (Gaeilge), Italian (Italiano), Japanese, Kiswahili, Korean, Malayalam, Myanmar (Burmese), Nepali (Nepalese), Norwegian (Norsk), Persian (فارسی), Polish, Punjabi (ਪੰਜਾਬੀ), Romanian, Russian, Slovak, Spanish (Español), Swedish, Thai, Turkish (Türkçe), Ukrainian (Українська) and Vietnamese.
+- UI localized text in English (default), Arabic (عربي), Brazilian Portuguese (Português brasileiro), Bulgarian, Catalan, Chinese, Czech, Danish, Dutch, Finnish, French (Français), German (Deutsch), Greek, Hebrew, Hindi (हिंदी), Hungarian, Indonesian, Irish (Gaeilge), Italian (Italiano), Japanese, Kiswahili, Korean, Malayalam, Myanmar (Burmese), Nepali (Nepalese), Norwegian (Norsk), Persian (فارسی), Polish, Punjabi (ਪੰਜਾਬੀ), Romanian, Russian, Slovak, Spanish (Español), Swedish, Thai, Turkish (Türkçe), Ukrainian (Українська) and Vietnamese.
 
 ## Skins (color variations)
 
@@ -121,7 +121,7 @@ To install:
    bundle
    ```
 
-4. Add `remote_theme: "mmistakes/minimal-mistakes@4.26.1"` to your `_config.yml` file. Remove any other `theme:` or `remote_theme:` entry.
+4. Add `remote_theme: "mmistakes/minimal-mistakes@4.27.0"` to your `_config.yml` file. Remove any other `theme:` or `remote_theme:` entry.
 
 <!--
   Dev note: The version number is currently hard-coded in these files:

Rakefile

@@ -107,7 +107,10 @@ file "docs/_docs/18-history.md" => "CHANGELOG.md" do |t|
     f.puts ""
     f.puts "{% raw %}"
     # Remove H1
-    changelog = File.read(t.prerequisites.first).gsub(/^# [^\n]*$/m, "").strip
+    changelog = File.read(t.prerequisites.first)
+      .gsub(/^# [^\n]*$/m, "")
+      .gsub(/\(#(\d+)\)$/m, "[#\\1](https://github.com/mmistakes/minimal-mistakes/issues/\\1)")
+      .strip
     f.write changelog
     f.puts ""
     f.puts "{% endraw %}"

_config.yml

@@ -16,6 +16,7 @@ minimal_mistakes_skin    : "default" # "air", "aqua", "contrast", "dark", "dirt"
 
 # Site Settings
 locale                   : "en-US"
+rtl                      : # true, false (default) # turns direction of the page into right to left for RTL languages
 title                    : "Site Title"
 title_separator          : "-"
 subtitle                 : # site tagline that appears below site title in masthead
@@ -27,7 +28,7 @@ repository               : # GitHub username/repo-name e.g. "mmistakes/minimal-m
 teaser                   : # path of fallback teaser image, e.g. "/assets/images/500x300.png"
 logo                     : # path of logo image to display in the masthead, e.g. "/assets/images/88x88.png"
 masthead_title           : # overrides the website title displayed in the masthead, use " " for no title
-# breadcrumbs            : false # true, false (default)
+breadcrumbs              : # true, false (default)
 words_per_minute         : 200
 enable_copy_code_button  : # true, false (default)
 copyright                : # "copyright" name, defaults to site.title
@@ -104,7 +105,7 @@ social:
 
 # Analytics
 analytics:
-  provider               : false # false (default), "google", "google-universal", "google-gtag", "custom"
+  provider               : # false (default), "google", "google-universal", "google-gtag", "custom"
   google:
     tracking_id          :
     anonymize_ip         : # true, false (default)
@@ -183,6 +184,7 @@ exclude:
   - gulpfile.js
   - LICENSE
   - log
+  - minimal-mistakes-jekyll.gemspec
   - node_modules
   - package.json
   - package-lock.json

_data/ui-text.yml

@@ -1070,17 +1070,17 @@ da-DK:
 # Polish
 # ------
 pl: &DEFAULT_PL
-  skip_links                 :
+  skip_links                 : "Pomiń linki"
-  skip_primary_nav           :
+  skip_primary_nav           : "Przejdź do nawigacji"
-  skip_content               :
+  skip_content               : "Przejdź do treści"
-  skip_footer                :
+  skip_footer                : "Przejdź do stopki"
   page                       : "Strona"
   pagination_previous        : "Poprzednia"
   pagination_next            : "Następna"
   breadcrumb_home_label      : "Strona główna"
   breadcrumb_separator       : "/"
   menu_label                 : "Przełącz menu"
-  search_label               :
+  search_label               : "Przełącz wyszukiwanie"
   toc_label                  : "Spis treści"
   ext_link_label             : "Link bezpośredni"
   less_than                  : "mniej niż"
@@ -1101,7 +1101,7 @@ pl: &DEFAULT_PL
   email_label                : "Email"
   recent_posts               : "Najnowsze wpisy"
   undefined_wpm              : "Parametr words_per_minute nie został zdefiniowany w _config.yml."
-  comment_form_info          : "Twój adres email nie będzie udostępiony. Wymagane pola są oznaczone"
+  comment_form_info          : "Twój adres email nie będzie udostępiony. Wymagane pola są oznaczone."
   comment_form_comment_label : "Skomentuj"
   comment_form_md_info       : "Markdown jest wspierany"
   comment_form_name_label    : "Imię"
@@ -1400,7 +1400,7 @@ fa: &DEFAULT_FA
   toc_label                  : "در این صفحه"
   ext_link_label             : "لینک مستقیم"
   less_than                  : " "
-  minute_read                : "(طول مطالعه (دقیقه"
+  minute_read                : "دقیقه، طول مطالعه"
   share_on_label             : "اشتراک گذاری در"
   meta_label                 :
   tags_label                 : "تگ ها: "
@@ -1427,9 +1427,9 @@ fa: &DEFAULT_FA
   comment_btn_submitted      : "ارسال شد"
   comment_success_msg        : ".باتشکر از ارسال دیدگاه! پس از تأیید، این دیدگاه در سایت نشان داده خواهد شد"
   comment_error_msg          : ".متاسفانه در ارسال شما خطایی بود. لطفا مطمئن شوید تمام فیلدهای مورد نیاز تکمیل شده و دوباره امتحان کنید"
-  loading_label              : "...بارگذاری"
+  loading_label              : "بارگذاری..."
   search_label_text          :
-  search_placeholder_text    : "...عبارت جستجوی خود را وارد کنید"
+  search_placeholder_text    : "عبارت جستجوی خود را وارد کنید..."
   search_algolia_no_results  :
   results_found              : "نتایج"
   back_to_top                : "بازگشت به بالا"
@@ -2074,6 +2074,112 @@ uk: &DEFAULT_UK
 uk-UA:
   <<: *DEFAULT_UK
 
+# Czech / čeština
+# -----------------
+cs: &DEFAULT_CS
+  skip_links                 : "Rychlé odkazy"
+  skip_primary_nav           : "Přejít na hlavní navigace"
+  skip_content               : "Přejít na obsah"
+  skip_footer                : "Přejít na zápatí"
+  page                       : "Stránka"
+  pagination_previous        : "Předchozí"
+  pagination_next            : "Další"
+  breadcrumb_home_label      : "Domů"
+  breadcrumb_separator       : "/"
+  menu_label                 : "Přepnout zobrazení menu"
+  search_label               : "Přepnout zobrazení vyhledávání"
+  toc_label                  : "Na této stránce"
+  ext_link_label             : "Přímý odkaz"
+  less_than                  : "méně než"
+  minute_read                : "minut"
+  share_on_label             : "Sdílet"
+  meta_label                 :
+  tags_label                 : "Štítky:"
+  categories_label           : "Rubriky:"
+  date_label                 : "Aktualizováno:"
+  comments_label             : "Okomentovat"
+  comments_title             : "Komentáře"
+  more_label                 : "Zjistit více"
+  related_label              : "Může se vám také líbit"
+  follow_label               : "Sledovat:"
+  feed_label                 : "Zdroj"
+  powered_by                 : "Používáme"
+  website_label              : "Web"
+  email_label                : "E-mail"
+  recent_posts               : "Nejnovější příspěvky"
+  undefined_wpm              : "V souboru _config.yml chybí parametr words_per_minute"
+  comment_form_info          : "Vaše e-mailová adresa nebude zveřejněna. Povinná pole jsou označena"
+  comment_form_comment_label : "Komentář"
+  comment_form_md_info       : "Podporuje markdown."
+  comment_form_name_label    : "Jméno"
+  comment_form_email_label   : "E-mailová adresa"
+  comment_form_website_label : "Web (volitelné)"
+  comment_btn_submit         : "Odeslat komentář"
+  comment_btn_submitted      : "Odesláno"
+  comment_success_msg        : "Děkujeme za komentář. Na stránce se objeví jakmile projde schválením."
+  comment_error_msg          : "Odeslání se nezdařilo. Zkontrolujte, že jste vyplnili všechna povinná pole a zkuste to znovu."
+  loading_label              : "Načítání..."
+  search_label_text          : "Zadejte vyhledávání..."
+  search_placeholder_text    : "Zadejte vyhledávání..."
+  search_algolia_no_results  : "Žádné výsledky"
+  results_found              : "Nalezené výsledky"
+  back_to_top                : "Na začátek stránky"
+cs-CZ:
+  <<: *DEFAULT_CS
+
+# Bulgarian
+# -----------------
+bg: &DEFAULT_BG
+  skip_links                 : "Пропуснете връзките"
+  skip_primary_nav           : "Преминете към основната навигация"
+  skip_content               : "Преминете към съдържанието"
+  skip_footer                : "Преминете към долния колонтитул"
+  page                       : "Страница"
+  pagination_previous        : "Предишна"
+  pagination_next            : "Следваща"
+  breadcrumb_home_label      : "Начало"
+  breadcrumb_separator       : "/"
+  menu_label                 : "Превключване на меню"
+  search_label               : "Превключване на търсене"
+  toc_label                  : "На тази страница"
+  ext_link_label             : "Пряка връзка"
+  less_than                  : "по-малко от"
+  minute_read                : "минута четене"
+  share_on_label             : "Споделете"
+  meta_label                 :
+  tags_label                 : "Етикети:"
+  categories_label           : "Категории:"
+  date_label                 : "Обновено:"
+  comments_label             : "Оставете коментар"
+  comments_title             : "Коментари"
+  more_label                 : "Научете повече"
+  related_label              : "Може да са ви интересни"
+  follow_label               : "Последвайте:"
+  feed_label                 : "Емисия"
+  powered_by                 : "Осъществено чрез"
+  website_label              : "Уебсайт"
+  email_label                : "Е-поща"
+  recent_posts               : "Последни публикации"
+  undefined_wpm              : "Недефиниран параметър words_per_minute в _config.yml"
+  comment_form_info          : "Вашият адрес за е-поща няма да бъде публикуван. Задължителните полета са обозначени"
+  comment_form_comment_label : "Коментар"
+  comment_form_md_info       : "Поддържа се Маркдаун."
+  comment_form_name_label    : "Име"
+  comment_form_email_label   : "Адрес за е-поща"
+  comment_form_website_label : "Уебсайт (по желание)"
+  comment_btn_submit         : "Изпращане на коментар"
+  comment_btn_submitted      : "Изпратено"
+  comment_success_msg        : "Благодарности за коментара! Ще се покаже на сайта, след като бъде одобрен."
+  comment_error_msg          : "Съжаляваме, възникна грешка с изпращането. Моля, уверете се, че всички задължителни полета са попълнени и опитайте отново."
+  loading_label              : "Зареждане..."
+  search_label_text          : "Въведете термин за търсене..."
+  search_placeholder_text    : "Въведете термин за търсене..."
+  search_algolia_no_results  : "Няма резултати"
+  results_found              : "Намерени резултати"
+  back_to_top                : "Обратно към началото"
+bg-BG:
+  <<: *DEFAULT_BG
+
 # Another locale
 # --------------
 #

_includes/archive-single.html

@@ -11,7 +11,7 @@
 {% endif %}
 
 <div class="{{ include.type | default: 'list' }}__item">
-  <article class="archive__item" itemscope itemtype="https://schema.org/CreativeWork">
+  <article class="archive__item" itemscope itemtype="https://schema.org/CreativeWork"{% if post.locale %} lang="{{ post.locale }}"{% endif %}>
     {% if include.type == "grid" and teaser %}
       <div class="archive__item-teaser">
         <img src="{{ teaser | relative_url }}" alt="">

_includes/breadcrumbs.html

@@ -26,7 +26,7 @@
         <span class="sep">{{ site.data.ui-text[site.locale].breadcrumb_separator | default: "/" }}</span>
       {% endif %}
       {% if forloop.last %}
-        <li class="current">{{ page.title }}</li>
+        <li class="current"{% if page.locale %} lang="{{ page.locale }}"{% endif %}>{{ page.title }}</li>
       {% else %}
         {% assign i = i | plus: 1 %}
         <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">

_includes/copyright.html

@@ -1,6 +1,6 @@
 <!--
-  Minimal Mistakes Jekyll Theme 4.26.1 by Michael Rose
+  Minimal Mistakes Jekyll Theme 4.27.0 by Michael Rose
-  Copyright 2013-2024 Michael Rose - mademistakes.com | @mmistakes
+  Copyright 2013-2025 Michael Rose - mademistakes.com | @mmistakes
   Free for personal and commercial use under the MIT license
   https://github.com/mmistakes/minimal-mistakes/blob/master/LICENSE
 -->

_includes/copyright.js

@@ -1,6 +1,6 @@
 /*!
- * Minimal Mistakes Jekyll Theme 4.26.1 by Michael Rose
+ * Minimal Mistakes Jekyll Theme 4.27.0 by Michael Rose
- * Copyright 2013-2024 Michael Rose - mademistakes.com | @mmistakes
+ * Copyright 2013-2025 Michael Rose - mademistakes.com | @mmistakes
  * Free for personal and commercial use under the MIT license
  * https://github.com/mmistakes/minimal-mistakes/blob/master/LICENSE
  */

_includes/documents-collection.html

@@ -1,4 +1,4 @@
-{% assign entries = site[include.collection] | where_exp: "post", "post.hidden != true" %}
+{% assign entries = include.entries | default: site[include.collection] | where_exp: "post", "post.hidden != true" %}
 
 {% if include.sort_by %}
   {% assign entries = entries | sort: include.sort_by %}
@@ -9,5 +9,5 @@
 {% endif %}
 
 {%- for post in entries -%}
-  {% include archive-single.html %}
+  {% include archive-single.html type=include.type %}
 {%- endfor -%}

_includes/figure

@@ -1,7 +1,7 @@
 <figure class="{{ include.class }}">
-  {%- if include.popup -%}<a href="{{ include.image_path | relative_url }}" class="image-popup" title="{% if include.caption %}{{ include.caption | markdownify | remove: "<p>" | remove: "</p>" }}{% endif %}">{%- endif -%}
+  {%- if include.popup -%}<a href="{{ include.image_path | relative_url }}" class="image-popup"{% if include.caption %} title="{{ include.caption | markdownify | strip_html }}"{% endif %}>{%- endif -%}
   <img src="{{ include.image_path | relative_url }}"
-       alt="{% if include.alt %}{{ include.alt }}{% endif %}">
+       alt="{% if include.alt %}{{ include.alt | escape_once }}{% endif %}">
   {%- if include.popup -%}</a>{%- endif -%}
   {%- if include.caption -%}
     <figcaption>

_includes/footer.html

@@ -18,4 +18,4 @@
   </ul>
 </div>
 
-<div class="page__footer-copyright">&copy; {{ site.time | date: '%Y' }} <a href="{{ site.copyright_url | default: site.url }}">{{ site.copyright | default: site.title }}</a>. {{ site.data.ui-text[site.locale].powered_by | default: "Powered by" }} <a href="https://jekyllrb.com" rel="nofollow">Jekyll</a> &amp; <a href="https://mademistakes.com/work/minimal-mistakes-jekyll-theme/" rel="nofollow">Minimal Mistakes</a>.</div>
+<div class="page__footer-copyright">&copy; {{ site.time | date: '%Y' }} <a href="{{ site.copyright_url | default: site.url }}">{{ site.copyright | default: site.title }}</a>. {{ site.data.ui-text[site.locale].powered_by | default: "Powered by" }} <a href="https://jekyllrb.com" rel="nofollow">Jekyll</a> &amp; <a href="https://mademistakes.com/work/jekyll-themes/minimal-mistakes/" rel="nofollow">Minimal Mistakes</a>.</div>

_includes/head.html

@@ -9,7 +9,7 @@
 {%- comment %} https://docs.google.com/presentation/d/1rmxwWa9P6_xHqonmh5ONXRS-jPc5XKbnv99Rjkhe04s/present {% endcomment -%}
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-<script type="text/javascript">
+<script>
   document.documentElement.className = document.documentElement.className.replace(/\bno-js\b/g, '') + ' js ';
   {% if site.enable_copy_code_button -%}
     window.enable_copy_code_button = true;

_includes/post_pagination.html

@@ -1,14 +1,14 @@
 {% if page.previous or page.next %}
   <nav class="pagination">
     {% if page.previous %}
-      <a href="{{ page.previous.url | relative_url }}" class="pagination--pager" title="{{ page.previous.title | markdownify | strip_html }}">{{ site.data.ui-text[site.locale].pagination_previous | default: "Previous" }}</a>
+      <a href="{{ page.previous.url | relative_url }}" class="pagination--pager" title="{{ page.previous.title | markdownify | strip_html | strip}}">{{ site.data.ui-text[site.locale].pagination_previous | default: "Previous" }}</a>
     {% else %}
       <a href="#" class="pagination--pager disabled">{{ site.data.ui-text[site.locale].pagination_previous | default: "Previous" }}</a>
     {% endif %}
     {% if page.next %}
-      <a href="{{ page.next.url | relative_url }}" class="pagination--pager" title="{{ page.next.title | markdownify | strip_html }}">{{ site.data.ui-text[site.locale].pagination_next | default: "Next" }}</a>
+      <a href="{{ page.next.url | relative_url }}" class="pagination--pager" title="{{ page.next.title | markdownify | strip_html | strip}}">{{ site.data.ui-text[site.locale].pagination_next | default: "Next" }}</a>
     {% else %}
       <a href="#" class="pagination--pager disabled">{{ site.data.ui-text[site.locale].pagination_next | default: "Next" }}</a>
     {% endif %}
   </nav>
-{% endif %}
+{% endif %}

_includes/seo.html

@@ -2,7 +2,11 @@
 {%- assign title_separator = site.title_separator | default: '-' -%}
 
 {%- assign page_title = page.title | default: site.title | replace: '|', '|' -%}
-{%- assign seo_title = page_title | append: " " | append: title_separator | append: " " | append: site.title | replace: '|', '|' -%}
+{%- if page_title contains site.title -%}
+  {%- assign seo_title = page_title | replace: '|', '|' -%}
+{%- else -%}
+  {%- assign seo_title = page_title | append: " " | append: title_separator | append: " " | append: site.title | replace: '|', '|' -%}
+{%- endif -%}
 
 {%- assign page_title = page_title | markdownify | strip_html | strip_newlines | escape_once -%}
 {%- assign seo_title  = seo_title  | markdownify | strip_html | strip_newlines | escape_once -%}

_includes/social-share.html

@@ -1,11 +1,15 @@
 <section class="page__share">
-  {% if site.data.ui-text[site.locale].share_on_label %}
+  <h4 class="page__share-title">{{ site.data.ui-text[site.locale].share_on_label | default: "Share on" }}</h4>
-    <h4 class="page__share-title">{{ site.data.ui-text[site.locale].share_on_label | default: "Share on" }}</h4>
-  {% endif %}
 
-  <a href="https://twitter.com/intent/tweet?{% if site.twitter.username %}via={{ site.twitter.username | url_encode }}&{% endif %}text={{ page.title | url_encode }}%20{{ page.url | absolute_url | url_encode }}" class="btn btn--twitter" onclick="window.open(this.href, 'window', 'left=20,top=20,width=500,height=500,toolbar=1,resizable=0'); return false;" title="{{ site.data.ui-text[site.locale].share_on_label | default: 'Share on' }} Twitter"><i class="fab fa-fw fa-twitter" aria-hidden="true"></i><span> Twitter</span></a>
+  <a href="https://x.com/intent/tweet?{% if site.twitter.username %}via={{ site.twitter.username | url_encode }}&{% endif %}text={{ page.title | url_encode }}%20{{ page.url | absolute_url | url_encode }}" class="btn btn--x" aria-label="Share on X" onclick="window.open(this.href, 'window', 'left=20,top=20,width=500,height=500,toolbar=1,resizable=0'); return false;" title="{{ site.data.ui-text[site.locale].share_on_label | default: 'Share on' }} X">
+    <i class="fas fa-fw fa-share-alt" aria-hidden="true"></i><span> X</span>
+  </a>
 
-  <a href="https://www.facebook.com/sharer/sharer.php?u={{ page.url | absolute_url | url_encode }}" class="btn btn--facebook" onclick="window.open(this.href, 'window', 'left=20,top=20,width=500,height=500,toolbar=1,resizable=0'); return false;" title="{{ site.data.ui-text[site.locale].share_on_label | default: 'Share on' }} Facebook"><i class="fab fa-fw fa-facebook" aria-hidden="true"></i><span> Facebook</span></a>
+  <a href="https://www.facebook.com/sharer/sharer.php?u={{ page.url | absolute_url | url_encode }}" class="btn btn--facebook" aria-label="Share on Facebook" onclick="window.open(this.href, 'window', 'left=20,top=20,width=500,height=500,toolbar=1,resizable=0'); return false;" title="{{ site.data.ui-text[site.locale].share_on_label | default: 'Share on' }} Facebook">
+    <i class="fab fa-fw fa-facebook" aria-hidden="true"></i><span> Facebook</span>
+  </a>
 
-  <a href="https://www.linkedin.com/shareArticle?mini=true&url={{ page.url | absolute_url }}" class="btn btn--linkedin" onclick="window.open(this.href, 'window', 'left=20,top=20,width=500,height=500,toolbar=1,resizable=0'); return false;" title="{{ site.data.ui-text[site.locale].share_on_label | default: 'Share on' }} LinkedIn"><i class="fab fa-fw fa-linkedin" aria-hidden="true"></i><span> LinkedIn</span></a>
+  <a href="https://www.linkedin.com/shareArticle?mini=true&url={{ page.url | absolute_url }}" class="btn btn--linkedin" aria-label="Share on LinkedIn" onclick="window.open(this.href, 'window', 'left=20,top=20,width=500,height=500,toolbar=1,resizable=0'); return false;" title="{{ site.data.ui-text[site.locale].share_on_label | default: 'Share on' }} LinkedIn">
+    <i class="fab fa-fw fa-linkedin" aria-hidden="true"></i><span> LinkedIn</span>
+  </a>
 </section>

_layouts/archive-taxonomy.html

@@ -20,7 +20,7 @@ author_profile: false
 
   <div class="archive">
     {% unless page.header.overlay_color or page.header.overlay_image %}
-      <h1 id="page-title" class="page__title">{{ page.title }}</h1>
+      <h1 id="page-title" class="page__title"{% if page.locale %} lang="{{ page.locale }}"{% endif %}>{{ page.title }}</h1>
     {% endunless %}
     {% for post in page.posts %}
       {% include archive-single.html %}

_layouts/archive.html

@@ -19,7 +19,7 @@ layout: default
 
   <div class="archive">
     {% unless page.header.overlay_color or page.header.overlay_image %}
-      <h1 id="page-title" class="page__title">{{ page.title }}</h1>
+      <h1 id="page-title" class="page__title"{% if page.locale %} lang="{{ page.locale }}"{% endif %}>{{ page.title }}</h1>
     {% endunless %}
     {{ content }}
   </div>

_layouts/default.html

@@ -3,13 +3,13 @@
 
 <!doctype html>
 {% include copyright.html %}
-<html lang="{{ site.locale | slice: 0,2 | default: "en" }}" class="no-js">
+<html lang="{{ site.locale | replace: "_", "-" | default: "en" }}" class="no-js">
   <head>
     {% include head.html %}
     {% include head/custom.html %}
   </head>
 
-  <body class="layout--{{ page.layout | default: layout.layout }}{% if page.classes or layout.classes %}{{ page.classes | default: layout.classes | join: ' ' | prepend: ' ' }}{% endif %}">
+  <body class="layout--{{ page.layout | default: layout.layout }}{% if page.classes or layout.classes %}{{ page.classes | default: layout.classes | join: ' ' | prepend: ' ' }}{% endif %}" dir="{% if site.rtl %}rtl{% else %}ltr{% endif %}">
     {% include_cached skip-links.html %}
     {% include_cached masthead.html %}
 

_layouts/home.html

@@ -14,9 +14,7 @@ layout: archive
 
 {% assign entries_layout = page.entries_layout | default: 'list' %}
 <div class="entries-{{ entries_layout }}">
-  {% for post in posts %}
+  {% include documents-collection.html entries=posts type=entries_layout %}
-    {% include archive-single.html type=entries_layout %}
-  {% endfor %}
 </div>
 
 {% include paginator.html %}

_layouts/search.html

@@ -17,7 +17,7 @@ layout: default
 
   <div class="archive">
     {% unless page.header.overlay_color or page.header.overlay_image %}
-      <h1 id="page-title" class="page__title">{{ page.title }}</h1>
+      <h1 id="page-title" class="page__title"{% if page.locale %} lang="{{ page.locale }}"{% endif %}>{{ page.title }}</h1>
     {% endunless %}
 
     {{ content }}

_layouts/single.html

@@ -21,7 +21,7 @@ layout: default
 <div id="main" role="main">
   {% include sidebar.html %}
 
-  <article class="page" itemscope itemtype="https://schema.org/CreativeWork">
+  <article class="page" itemscope itemtype="https://schema.org/CreativeWork"{% if page.locale %} lang="{{ page.locale }}"{% endif %}>
     {% if page.title %}<meta itemprop="headline" content="{{ page.title | replace: '|', '&#124;' | markdownify | strip_html | strip_newlines | escape_once }}">{% endif %}
     {% if page.excerpt %}<meta itemprop="description" content="{{ page.excerpt | markdownify | strip_html | strip_newlines | escape_once }}">{% endif %}
     {% if page.date %}<meta itemprop="datePublished" content="{{ page.date | date_to_xmlschema }}">{% endif %}
@@ -65,8 +65,15 @@ layout: default
       {% include post_pagination.html %}
     </div>
 
-    {% if jekyll.environment == 'production' and site.comments.provider and page.comments %}
+    {% if site.comments.provider and page.comments %}
-      {% include comments.html %}
+      {% if jekyll.environment == 'production' %}
+        {% include comments.html %}
+      {% else %}
+        <p>
+          Comments are configured with provider: <strong>{{ site.comments.provider }}</strong>,
+          but are disabled in non-production environments.
+        </p>
+      {% endif %}
     {% endif %}
   </article>
 

_layouts/splash.html

@@ -9,7 +9,7 @@ layout: default
 {% endif %}
 
 <div id="main" role="main">
-  <article class="splash" itemscope itemtype="https://schema.org/CreativeWork">
+  <article class="splash" itemscope itemtype="https://schema.org/CreativeWork"{% if page.locale %} lang="{{ page.locale }}"{% endif %}>
     {% if page.title %}<meta itemprop="headline" content="{{ page.title | markdownify | strip_html | strip_newlines | escape_once }}">{% endif %}
     {% if page.excerpt %}<meta itemprop="description" content="{{ page.excerpt | markdownify | strip_html | strip_newlines | escape_once }}">{% endif %}
     {% if page.date %}<meta itemprop="datePublished" content="{{ page.date | date_to_xmlschema }}">{% endif %}

_sass/minimal-mistakes/_archive.scss

@@ -7,14 +7,14 @@
   margin-bottom: 2em;
 
   @include breakpoint($large) {
-    float: right;
+    float: inline-end;
     width: calc(100% - #{$right-sidebar-width-narrow});
-    padding-right: $right-sidebar-width-narrow;
+    padding-inline-end: $right-sidebar-width-narrow;
   }
 
   @include breakpoint($x-large) {
     width: calc(100% - #{$right-sidebar-width});
-    padding-right: $right-sidebar-width;
+    padding-inline-end: $right-sidebar-width;
   }
 }
 
@@ -53,10 +53,7 @@
   a[rel="permalink"]::before {
     content: '';
     position: absolute;
-    left: 0;
+    inset: 0;
-    top: 0;
-    right: 0;
-    bottom: 0;
   }
 
   a + a {
@@ -98,14 +95,14 @@
 .archive__item-caption {
   position: absolute;
   bottom: 0;
-  right: 0;
+  inset-inline-end: 0;
   margin: 0 auto;
   padding: 2px 5px;
   color: #fff;
   font-family: $caption-font-family;
   font-size: $type-size-8;
   background: #000;
-  text-align: right;
+  text-align: end;
   z-index: 5;
   opacity: 0.5;
   border-radius: $border-radius 0 0 0;
@@ -140,11 +137,11 @@
     /* extend grid elements to the right */
 
     @include breakpoint($large) {
-      margin-right: -1 * $right-sidebar-width-narrow;
+      margin-inline-end: -1 * $right-sidebar-width-narrow;
     }
 
     @include breakpoint($x-large) {
-      margin-right: -1 * $right-sidebar-width;
+      margin-inline-end: -1 * $right-sidebar-width;
     }
   }
 }
@@ -153,23 +150,22 @@
   margin-bottom: 2em;
 
   @include breakpoint($small) {
-    float: left;
+    float: inline-start;
     width: span(5 of 10);
 
     &:nth-child(2n + 1) {
       clear: both;
-      margin-left: 0;
+      margin-inline-start: 0;
     }
 
     &:nth-child(2n + 2) {
       clear: none;
-      margin-left: gutter(of 10);
+      margin-inline-start: gutter(of 10);
     }
   }
 
   @include breakpoint($medium) {
-    margin-left: 0; /* override margin*/
+    margin-inline: 0; /* override margin*/
-    margin-right: 0; /* override margin*/
     width: span(3 of 12);
 
     &:nth-child(2n + 1) {
@@ -182,17 +178,17 @@
 
     &:nth-child(4n + 2) {
       clear: none;
-      margin-left: gutter(1 of 12);
+      margin-inline-start: gutter(1 of 12);
     }
 
     &:nth-child(4n + 3) {
       clear: none;
-      margin-left: gutter(1 of 12);
+      margin-inline-start: gutter(1 of 12);
     }
 
     &:nth-child(4n + 4) {
       clear: none;
-      margin-left: gutter(1 of 12);
+      margin-inline-start: gutter(1 of 12);
     }
   }
 
@@ -254,23 +250,23 @@
   font-size: 1.125em;
 
   @include breakpoint($small) {
-    float: left;
+    float: inline-start;
     margin-bottom: 0;
     width: span(4 of 12);
 
     &:nth-child(3n + 1) {
       clear: both;
-      margin-left: 0;
+      margin-inline-start: 0;
     }
 
     &:nth-child(3n + 2) {
       clear: none;
-      margin-left: gutter(of 12);
+      margin-inline-start: gutter(of 12);
     }
 
     &:nth-child(3n + 3) {
       clear: none;
-      margin-left: gutter(of 12);
+      margin-inline-start: gutter(of 12);
     }
 
     .feature__item-teaser {
@@ -280,114 +276,89 @@
   }
 
   .archive__item-body {
-    padding-left: gutter(1 of 12);
+    padding-inline: gutter(1 of 12);
-    padding-right: gutter(1 of 12);
   }
 
   a.btn::before {
     content: '';
     position: absolute;
-    left: 0;
+    inset: 0;
-    top: 0;
-    right: 0;
-    bottom: 0;
   }
 
-  &--left {
+  &--left, &--right {
     position: relative;
-    float: left;
+    margin-inline: 0;
-    margin-left: 0;
-    margin-right: 0;
     width: 100%;
     clear: both;
     font-size: 1.125em;
 
-    .archive__item {
+    a.btn::before {
-      float: left;
+      content: '';
+      position: absolute;
+      inset: 0;
     }
 
     .archive__item-teaser {
       margin-bottom: 2em;
     }
+  }
 
-    a.btn::before {
+  &--left {
-      content: '';
+    float: inline-start;
-      position: absolute;
+
-      left: 0;
+    .archive__item {
-      top: 0;
+      float: inline-start;
-      right: 0;
-      bottom: 0;
     }
 
     @include breakpoint($small) {
       .archive__item-teaser {
-        float: left;
+        float: inline-start;
         width: span(5 of 12);
       }
 
       .archive__item-body {
-        float: right;
+        float: inline-end;
-        padding-left: gutter(0.5 of 12);
-        padding-right: gutter(1 of 12);
         width: span(7 of 12);
+        padding-inline-start: gutter(0.5 of 12);
+        padding-inline-end: gutter(1 of 12);
       }
     }
   }
 
   &--right {
-    position: relative;
+    float: inline-end;
-    float: left;
-    margin-left: 0;
-    margin-right: 0;
-    width: 100%;
-    clear: both;
-    font-size: 1.125em;
 
     .archive__item {
-      float: left;
+      float: inline-end;
-    }
-
-    .archive__item-teaser {
-      margin-bottom: 2em;
-    }
-
-    a.btn::before {
-      content: '';
-      position: absolute;
-      left: 0;
-      top: 0;
-      right: 0;
-      bottom: 0;
     }
 
     @include breakpoint($small) {
-      text-align: right;
+      text-align: end;
 
       .archive__item-teaser {
-        float: right;
+        float: inline-end;
         width: span(5 of 12);
       }
 
       .archive__item-body {
-        float: left;
+        float: inline-start;
         width: span(7 of 12);
-        padding-left: gutter(0.5 of 12);
+        padding-inline-start: gutter(1 of 12);
-        padding-right: gutter(1 of 12);
+        padding-inline-end: gutter(0.5 of 12);
       }
     }
   }
 
   &--center {
     position: relative;
-    float: left;
+    float: inline-start;
-    margin-left: 0;
+    margin-inline: 0;
-    margin-right: 0;
     width: 100%;
     clear: both;
     font-size: 1.125em;
 
     .archive__item {
-      float: left;
+      float: inline-start;
       width: 100%;
     }
 
@@ -398,10 +369,7 @@
     a.btn::before {
       content: '';
       position: absolute;
-      left: 0;
+      inset: 0;
-      top: 0;
-      right: 0;
-      bottom: 0;
     }
 
     @include breakpoint($small) {
@@ -442,14 +410,14 @@
    Wide Pages
    ========================================================================== */
 
-  .wide {
+.wide {
   .archive {
     @include breakpoint($large) {
-      padding-right: 0;
+      padding-inline-end: 0;
     }
 
     @include breakpoint($x-large) {
-      padding-right: 0;
+      padding-inline-end: 0;
     }
   }
 }

_sass/minimal-mistakes/_base.scss

@@ -107,18 +107,18 @@ abbr[data-original-title] {
 /* blockquotes */
 
 blockquote {
-  margin: 2em 1em 2em 0;
+  margin-block: 2em;
-  padding-left: 1em;
+  margin-inline-end: 1em;
-  padding-right: 1em;
+  padding-inline: 1em;
   font-style: italic;
-  border-left: 0.25em solid $primary-color;
+  border-inline-start: 0.25em solid $primary-color;
 
   cite {
     font-style: italic;
 
-    &:before {
+    &::before {
       content: "\2014";
-      padding-right: 5px;
+      padding-inline-end: 5px;
     }
   }
 }

_sass/minimal-mistakes/_buttons.scss

@@ -21,11 +21,11 @@
   cursor: pointer;
 
   .icon {
-    margin-right: 0.5em;
+    margin-inline-end: 0.5em;
   }
 
   .icon + .hidden {
-    margin-left: -0.5em; /* override for hidden text*/
+    margin-inline-start: -0.5em; /* override for hidden text*/
   }
 
   /* button colors */
@@ -39,7 +39,8 @@
   (info, $info-color),
   (facebook, $facebook-color),
   (twitter, $twitter-color),
-  (linkedin, $linkedin-color);
+  (linkedin, $linkedin-color),
+  (mastodon, $mastodon-color);
 
   @each $buttoncolor, $color in $buttoncolors {
     &--#{$buttoncolor} {
@@ -94,4 +95,4 @@
   &--small {
     font-size: $type-size-7;
   }
-}
+}

_sass/minimal-mistakes/_copyright.scss

@@ -1,6 +1,6 @@
 /*!
- * Minimal Mistakes Jekyll Theme 4.26.1 by Michael Rose
+ * Minimal Mistakes Jekyll Theme 4.27.0 by Michael Rose
- * Copyright 2013-2024 Michael Rose - mademistakes.com | @mmistakes
+ * Copyright 2013-2025 Michael Rose - mademistakes.com | @mmistakes
  * Free for personal and commercial use under the MIT license
  * https://github.com/mmistakes/minimal-mistakes/blob/master/LICENSE
  */

_sass/minimal-mistakes/_footer.scss

@@ -4,9 +4,8 @@
 
 .page__footer {
   @include clearfix;
-  float: left;
+  float: inline-start;
-  margin-left: 0;
+  margin-inline: 0;
-  margin-right: 0;
   width: 100%;
   margin-top: 3em;
   color: $muted-text-color;
@@ -18,8 +17,7 @@
 
   footer {
     @include clearfix;
-    margin-left: auto;
+    margin-inline: auto;
-    margin-right: auto;
     margin-top: 2em;
     max-width: 100%;
     padding: 0 1em 2em;
@@ -67,13 +65,13 @@
     text-transform: uppercase;
   }
 
-  li + li:before {
+  li + li::before {
     content: "";
-    padding-right: 5px;
+    padding-inline-end: 5px;
   }
 
   a {
-    padding-right: 10px;
+    padding-inline-end: 10px;
     font-weight: bold;
   }
 

_sass/minimal-mistakes/_forms.scss

@@ -3,7 +3,7 @@
    ========================================================================== */
 
 form {
-  margin: 0 0 5px 0;
+  margin-bottom: 5px;
   padding: 1em;
   background-color: $form-background-color;
 
@@ -17,7 +17,7 @@ form {
     display: block;
     width: 100%;
     margin-bottom: 5px * 2;
-    *margin-left: -7px;
+    margin-inline-start: -7px;
     padding: 0;
     color: $text-color;
     border: 0;
@@ -45,7 +45,6 @@ button,
 select,
 textarea {
   vertical-align: baseline;
-  *vertical-align: middle;
 }
 
 input,
@@ -102,7 +101,6 @@ input[type="radio"] {
   height: auto;
   padding: 0;
   margin: 3px 0;
-  *margin-top: 0;
   line-height: normal;
   cursor: pointer;
   border-radius: 0;
@@ -114,8 +112,6 @@ input[type="checkbox"],
 input[type="radio"] {
   box-sizing: border-box;
   padding: 0;
-  *width: 13px;
-  *height: 13px;
 }
 
 input[type="image"] {
@@ -138,12 +134,6 @@ input[type="submit"] {
   width: auto;
   height: auto;
   cursor: pointer;
-  *overflow: visible;
-}
-
-select,
-input[type="file"] {
-  *margin-top: 4px;
 }
 
 select {
@@ -173,14 +163,14 @@ input[type="hidden"] {
 
 .radio,
 .checkbox {
-  padding-left: 18px;
+  padding-inline-start: 18px;
   font-weight: normal;
 }
 
 .radio input[type="radio"],
 .checkbox input[type="checkbox"] {
-  float: left;
+  float: inline-start;
-  margin-left: -18px;
+  margin-inline-start: -18px;
 }
 
 .radio.inline,
@@ -193,7 +183,7 @@ input[type="hidden"] {
 
 .radio.inline + .radio.inline,
 .checkbox.inline + .checkbox.inline {
-  margin-left: 10px;
+  margin-inline-start: 10px;
 }
 
 /*
@@ -248,7 +238,7 @@ select:focus {
 .help-inline {
   display: inline-block;
   vertical-align: middle;
-  padding-left: 5px;
+  padding-inline-start: 5px;
 }
 
 /*
@@ -279,16 +269,16 @@ select:focus {
 .form-inline .radio,
 .form-inline .checkbox,
 .form-inline .radio {
-  padding-left: 0;
+  padding-inline-start: 0;
   margin-bottom: 0;
   vertical-align: middle;
 }
 
 .form-inline .radio input[type="radio"],
 .form-inline .checkbox input[type="checkbox"] {
-  float: left;
+  float: inline-start;
-  margin-left: 0;
+  margin-inline-start: 0;
-  margin-right: 3px;
+  margin-inline-end: 3px;
 }
 
 /*
@@ -303,8 +293,7 @@ select:focus {
 }
 
 .form-search .search-query {
-  padding-left: 14px;
+  padding-inline: 14px;
-  padding-right: 14px;
   margin-bottom: 0;
   border-radius: 14px;
 }
@@ -316,23 +305,23 @@ select:focus {
 .form-search .radio,
 .form-search .checkbox,
 .form-inline .radio {
-  padding-left: 0;
+  padding-inline-start: 0;
   margin-bottom: 0;
   vertical-align: middle;
 }
 
 .form-search .radio input[type="radio"],
 .form-search .checkbox input[type="checkbox"] {
-  float: left;
+  float: inline-start;
-  margin-left: 0;
+  margin-inline-start: 0;
-  margin-right: 3px;
+  margin-inline-end: 3px;
 }
 
 /*
      .form--loading
      ========================================================================== */
 
-.form--loading:before {
+.form--loading::before {
   content: "";
 }
 
@@ -340,10 +329,10 @@ select:focus {
   display: block;
 }
 
-.form:before {
+.form::before {
   position: absolute;
   top: 0;
-  left: 0;
+  inset-inline-start: 0;
   width: 100%;
   height: 100%;
   background-color: rgba(255, 255, 255, 0.7);
@@ -354,6 +343,6 @@ select:focus {
   display: none;
   position: absolute;
   top: 50%;
-  left: 50%;
+  inset-inline-start: 50%;
   z-index: 11;
 }

_sass/minimal-mistakes/_masthead.scss

@@ -13,8 +13,7 @@
 
   &__inner-wrap {
     @include clearfix;
-    margin-left: auto;
+    margin-inline: auto;
-    margin-right: auto;
     padding: 1em;
     max-width: 100%;
     display: -webkit-box;
@@ -59,17 +58,16 @@
 }
 
 .masthead__menu {
-  float: left;
+  float: inline-start;
-  margin-left: 0;
+  margin-inline: 0;
-  margin-right: 0;
   width: 100%;
   clear: both;
 
   .site-nav {
-    margin-left: 0;
+    margin-inline-start: 0;
 
     @include breakpoint($small) {
-      float: right;
+      float: inline-end;
     }
   }
 
@@ -87,7 +85,7 @@
   white-space: nowrap;
 
   &--lg {
-    padding-right: 2em;
+    padding-inline-end: 2em;
     font-weight: 700;
   }
 }

_sass/minimal-mistakes/_navigation.scss

@@ -10,8 +10,7 @@
   @include clearfix;
   margin: 0 auto;
   max-width: 100%;
-  padding-left: 1em;
+  padding-inline: 1em;
-  padding-right: 1em;
   font-family: $sans-serif;
   -webkit-animation: $intro-transition;
   animation: $intro-transition;
@@ -28,7 +27,7 @@
     font-size: $type-size-6;
 
     @include breakpoint($large) {
-      float: right;
+      float: inline-end;
       width: calc(100% - #{$right-sidebar-width-narrow});
     }
 
@@ -52,7 +51,7 @@
 
 .pagination {
   @include clearfix();
-  float: left;
+  float: inline-start;
   margin-top: 1em;
   padding-top: 1em;
   width: 100%;
@@ -66,8 +65,8 @@
 
   li {
     display: block;
-    float: left;
+    float: inline-start;
-    margin-left: -1px;
+    margin-inline-start: -1px;
 
     a {
       display: block;
@@ -101,18 +100,18 @@
     }
 
     &:first-child {
-      margin-left: 0;
+      margin-inline-start: 0;
 
       a {
-        border-top-left-radius: $border-radius;
+        border-start-start-radius: $border-radius;
-        border-bottom-left-radius: $border-radius;
+        border-end-start-radius: $border-radius;
       }
     }
 
     &:last-child {
       a {
-        border-top-right-radius: $border-radius;
+        border-start-end-radius: $border-radius;
-        border-bottom-right-radius: $border-radius;
+        border-end-end-radius: $border-radius;
       }
     }
   }
@@ -121,7 +120,7 @@
   &--pager {
     display: block;
     padding: 1em 2em;
-    float: left;
+    float: inline-start;
     width: 50%;
     font-family: $sans-serif;
     font-size: $type-size-5;
@@ -137,14 +136,14 @@
     }
 
     &:first-child {
-      border-top-right-radius: 0;
+      border-start-end-radius: 0;
-      border-bottom-right-radius: 0;
+      border-end-end-radius: 0;
     }
 
     &:last-child {
-      margin-left: -1px;
+      margin-inline-start: -1px;
-      border-top-left-radius: 0;
+      border-start-start-radius: 0;
-      border-bottom-left-radius: 0;
+      border-end-start-radius: 0;
     }
 
     &.disabled {
@@ -192,12 +191,12 @@
     }
 
     &.site-logo {
-      margin-left: 0;
+      margin-inline-start: 0;
-      margin-right: 0.5rem;
+      margin-inline-end: 0.5rem;
     }
 
     &.site-title {
-      margin-left: 0;
+      margin-inline-start: 0;
     }
   }
 
@@ -240,7 +239,7 @@
       &:before {
         content: "";
         position: absolute;
-        left: 0;
+        inset-inline-start: 0;
         bottom: 0;
         height: 4px;
         background: $primary-color;
@@ -262,7 +261,7 @@
   .hidden-links {
     position: absolute;
     top: 100%;
-    right: 0;
+    inset-inline-end: 0;
     margin-top: 15px;
     padding: 5px;
     border: 1px solid $border-color;
@@ -287,11 +286,11 @@
       }
     }
 
-    &:before {
+    &::before {
       content: "";
       position: absolute;
       top: -11px;
-      right: 10px;
+      inset-inline-end: 10px;
       width: 0;
       border-style: solid;
       border-width: 0 10px 10px;
@@ -300,11 +299,11 @@
       z-index: 0;
     }
 
-    &:after {
+    &::after {
       content: "";
       position: absolute;
       top: -10px;
-      right: 10px;
+      inset-inline-end: 10px;
       width: 0;
       border-style: solid;
       border-width: 0 10px 10px;
@@ -361,11 +360,11 @@
       transition: 0.2s ease-out;
       cursor: pointer;
 
-      &:before,
+      &::before,
-      &:after {
+      &::after {
         content: "";
         position: absolute;
-        right: 1em;
+        inset-inline-end: 1em;
         top: 1.25em;
         width: 0.75em;
         height: 0.125em;
@@ -446,9 +445,8 @@
   }
 
   .active {
-    margin-left: -0.5em;
+    margin-inline-start: -0.5em;
-    padding-left: 0.5em;
+    padding-inline: 0.5em;
-    padding-right: 0.5em;
     font-weight: bold;
   }
 
@@ -516,8 +514,8 @@
     color: #fff;
     font-size: $type-size-6;
     background: $primary-color;
-    border-top-left-radius: $border-radius;
+    border-start-start-radius: $border-radius;
-    border-top-right-radius: $border-radius;
+    border-start-end-radius: $border-radius;
   }
 
   // Scrollspy marks toc items as .active when they are in focus
@@ -551,23 +549,23 @@
   }
 
   li ul > li a {
-    padding-left: 1.25rem;
+    padding-inline-start: 1.25rem;
     font-weight: normal;
   }
 
   li ul li ul > li a {
-    padding-left: 1.75rem;
+    padding-inline-start: 1.75rem;
   }
 
   li ul li ul li ul > li a {
-    padding-left: 2.25rem;
+    padding-inline-start: 2.25rem;
   }
 
   li ul li ul li ul li ul > li a {
-    padding-left: 2.75rem;
+    padding-inline-start: 2.75rem;
   }
 
   li ul li ul li ul li ul li ul > li a {
-    padding-left: 3.25rem
+    padding-inline-start: 3.25rem;
   }
 }

_sass/minimal-mistakes/_notices.scss

@@ -54,7 +54,7 @@
   }
 
   @at-root #{selector-unify(&, "blockquote")} {
-    border-left-color: mix(#000, $notice-color, 10%);
+    border-inline-start-color: mix(#000, $notice-color, 10%);
   }
 
   code {

_sass/minimal-mistakes/_page.scss

@@ -4,10 +4,8 @@
 
 #main {
   @include clearfix;
-  margin-left: auto;
+  margin-inline: auto;
-  margin-right: auto;
+  padding-inline: 1em;
-  padding-left: 1em;
-  padding-right: 1em;
   -webkit-animation: $intro-transition;
   animation: $intro-transition;
   max-width: 100%;
@@ -37,21 +35,20 @@ body {
 
 .page {
   @include breakpoint($large) {
-    float: right;
+    float: inline-end;
     width: calc(100% - #{$right-sidebar-width-narrow});
-    padding-right: $right-sidebar-width-narrow;
+    padding-inline-end: $right-sidebar-width-narrow;
   }
 
   @include breakpoint($x-large) {
     width: calc(100% - #{$right-sidebar-width});
-    padding-right: $right-sidebar-width;
+    padding-inline-end: $right-sidebar-width;
   }
 
   .page__inner-wrap {
-    float: left;
+    float: inline-start;
     margin-top: 1em;
-    margin-left: 0;
+    margin-inline: 0;
-    margin-right: 0;
     width: 100%;
     clear: both;
 
@@ -59,9 +56,8 @@ body {
     .page__meta,
     .page__share {
       position: relative;
-      float: left;
+      float: inline-start;
-      margin-left: 0;
+      margin-inline: 0;
-      margin-right: 0;
       width: 100%;
       clear: both;
     }
@@ -96,7 +92,7 @@ body {
 	h1, h2, h3, h4, h5, h6 {
 		.header-link {
 			position: relative;
-			left: 0.5em;
+			inset-inline-start: 0.5em;
 			opacity: 0;
 			font-size: 0.8em;
 			-webkit-transition: opacity 0.2s ease-in-out 0.1s;
@@ -160,7 +156,7 @@ body {
   }
 
   dd {
-    margin-left: 1em;
+    margin-inline-start: 1em;
     font-family: $sans-serif;
     font-size: $type-size-6;
   }
@@ -172,7 +168,7 @@ body {
   /* blockquote citations */
   blockquote + .small {
     margin-top: -1.5em;
-    padding-left: 1.25rem;
+    padding-inline-start: 1.25rem;
   }
 }
 
@@ -203,8 +199,7 @@ body {
     }
 
     .wrapper {
-      padding-left: 1em;
+      padding-inline: 1em;
-      padding-right: 1em;
 
       @include breakpoint($x-large) {
         max-width: $x-large;
@@ -242,14 +237,14 @@ body {
 .page__hero-caption {
   position: absolute;
   bottom: 0;
-  right: 0;
+  inset-inline-end: 0;
   margin: 0 auto;
   padding: 2px 5px;
   color: #fff;
   font-family: $caption-font-family;
   font-size: $type-size-7;
   background: #000;
-  text-align: right;
+  text-align: end;
   z-index: 5;
   opacity: 0.5;
   border-radius: $border-radius 0 0 0;
@@ -320,8 +315,7 @@ body {
 
 .page__meta-sep::before {
   content: "\2022";
-  padding-left: 0.5em;
+  padding-inline: 0.5em;
-  padding-right: 0.5em;
 }
 
 /*
@@ -334,13 +328,13 @@ body {
   }
 
   strong {
-    margin-right: 10px;
+    margin-inline-end: 10px;
   }
 }
 
 .page__taxonomy-item {
   display: inline-block;
-  margin-right: 5px;
+  margin-inline-end: 5px;
   margin-bottom: 8px;
   padding: 5px 10px;
   text-decoration: none;
@@ -417,7 +411,7 @@ body {
   color: $muted-text-color;
   font-size: 0.6em;
   text-transform: uppercase;
-  text-align: right;
+  text-align: end;
   text-decoration: none;
 }
 
@@ -426,9 +420,8 @@ body {
    ========================================================================== */
 
 .page__comments {
-  float: left;
+  float: inline-start;
-  margin-left: 0;
+  margin-inline: 0;
-  margin-right: 0;
   width: 100%;
   clear: both;
 }
@@ -470,7 +463,7 @@ body {
 }
 
 .comment__avatar-wrapper {
-  float: left;
+  float: inline-start;
   width: 60px;
   height: 60px;
 
@@ -494,7 +487,7 @@ body {
 }
 
 .comment__content-wrapper {
-  float: right;
+  float: inline-end;
   width: calc(100% - 60px);
 
   @include breakpoint($large) {
@@ -525,13 +518,13 @@ body {
 
 .page__related {
   @include clearfix();
-  float: left;
+  float: inline-start;
   margin-top: 2em;
   padding-top: 1em;
   border-top: 1px solid $border-color;
 
   @include breakpoint($large) {
-    float: right;
+    float: inline-end;
     width: calc(100% - #{$right-sidebar-width-narrow});
   }
 
@@ -556,23 +549,13 @@ body {
    ========================================================================== */
 
 .wide {
-  .page {
+  .page, .page__related {
     @include breakpoint($large) {
-      padding-right: 0;
+      padding-inline-end: 0;
     }
 
     @include breakpoint($x-large) {
-      padding-right: 0;
+      padding-inline-end: 0;
-    }
-  }
-
-  .page__related {
-    @include breakpoint($large) {
-      padding-right: 0;
-    }
-
-    @include breakpoint($x-large) {
-      padding-right: 0;
     }
   }
 }

_sass/minimal-mistakes/_reset.scss

@@ -8,18 +8,18 @@ html {
   /* apply a natural box layout model to all elements */
   box-sizing: border-box;
   background-color: $background-color;
-  font-size: 16px;
+  font-size: $doc-font-size;
 
   @include breakpoint($medium) {
-    font-size: 18px;
+    font-size: $doc-font-size-medium;
   }
 
   @include breakpoint($large) {
-    font-size: 20px;
+    font-size: $doc-font-size-large;
   }
 
   @include breakpoint($x-large) {
-    font-size: 22px;
+    font-size: $doc-font-size-x-large;
   }
 
   -webkit-text-size-adjust: 100%;
@@ -64,8 +64,6 @@ audio,
 canvas,
 video {
   display: inline-block;
-  *display: inline;
-  *zoom: 1;
 }
 
 /* Prevents modern browsers from displaying 'audio' without controls */
@@ -142,7 +140,6 @@ textarea {
 
 button,
 input {
-  *overflow: visible; /* inner spacing ie IE6/7*/
   line-height: normal; /* FF3/4 have !important on line-height in UA stylesheet*/
 }
 
@@ -184,4 +181,4 @@ input[type="search"]::-webkit-search-cancel-button {
 textarea {
   overflow: auto; /* remove vertical scrollbar in IE6-9*/
   vertical-align: top; /* readability and alignment cross-browser*/
-}
+}

_sass/minimal-mistakes/_search.scss

@@ -9,8 +9,7 @@
 }
 
 .search__toggle {
-  margin-left: 1rem;
+  margin-inline: 1rem;
-  margin-right: 1rem;
   height: $nav-toggle-height;
   border: 0;
   outline: none;
@@ -38,10 +37,8 @@
 
   &__inner-wrap {
     width: 100%;
-    margin-left: auto;
+    margin-inline: auto;
-    margin-right: auto;
+    padding-inline: 1em;
-    padding-left: 1em;
-    padding-right: 1em;
     -webkit-animation: $intro-transition;
     animation: $intro-transition;
     -webkit-animation-delay: 0.15s;

_sass/minimal-mistakes/_sidebar.scss

@@ -17,7 +17,7 @@
   // }
 
   @include breakpoint($large) {
-    float: left;
+    float: inline-start;
     width: calc(#{$right-sidebar-width-narrow} - 1em);
     opacity: 0.75;
     -webkit-transition: opacity 0.2s ease-in-out;
@@ -77,10 +77,10 @@
   @include breakpoint($large) {
     position: absolute;
     top: 0;
-    right: 0;
+    inset-inline-end: 0;
     width: $right-sidebar-width-narrow;
-    margin-right: -1 * $right-sidebar-width-narrow;
+    margin-inline-end: -1 * $right-sidebar-width-narrow;
-    padding-left: 1em;
+    padding-inline-start: 1em;
     z-index: 10;
 
     &.sticky {
@@ -88,7 +88,7 @@
       position: -webkit-sticky;
       position: sticky;
       top: 2em;
-      float: right;
+      float: inline-end;
 
       .toc {
         .toc__menu {
@@ -101,19 +101,19 @@
 
   @include breakpoint($x-large) {
     width: $right-sidebar-width;
-    margin-right: -1 * $right-sidebar-width;
+    margin-inline-end: -1 * $right-sidebar-width;
   }
 }
 
 .splash .sidebar__right {
   @include breakpoint($large) {
     position: relative;
-    float: right;
+    float: inline-end;
-    margin-right: 0;
+    margin-inline-end: 0;
   }
 
   @include breakpoint($x-large) {
-    margin-right: 0;
+    margin-inline-end: 0;
   }
 }
 
@@ -147,15 +147,13 @@
 .author__content {
   display: table-cell;
   vertical-align: top;
-  padding-left: 15px;
+  padding-inline: 15px 25px;
-  padding-right: 25px;
   line-height: 1;
 
   @include breakpoint($large) {
     display: block;
     width: 100%;
-    padding-left: 0;
+    padding-inline: 0;
-    padding-right: 0;
   }
 
   a {
@@ -202,7 +200,7 @@
 
   .author__urls {
     span.label {
-      padding-left: 5px;
+      padding-inline-start: 5px;
     }
   }
 
@@ -219,7 +217,7 @@
         content: '';
         position: fixed;
         top: 0;
-        left: 0;
+        inset-inline-start: 0;
         width: 100%;
         height: 100%;
         pointer-events: none;
@@ -241,7 +239,7 @@
 .author__urls {
   display: none;
   position: absolute;
-  right: 0;
+  inset-inline-end: 0;
   margin-top: 15px;
   padding: 10px;
   list-style-type: none;
@@ -265,12 +263,12 @@
     box-shadow: none;
   }
 
-  &:before {
+  &::before {
     display: block;
     content: "";
     position: absolute;
     top: -11px;
-    left: calc(50% - 10px);
+    inset-inline-start: calc(50% - 10px);
     width: 0;
     border-style: solid;
     border-width: 0 10px 10px;
@@ -287,7 +285,7 @@
     content: "";
     position: absolute;
     top: -10px;
-    left: calc(50% - 10px);
+    inset-inline-start: calc(50% - 10px);
     width: 0;
     border-style: solid;
     border-width: 0 10px 10px;
@@ -311,9 +309,8 @@
   a {
     display: block;
     margin-bottom: 5px;
-    padding-right: 5px;
+    padding-block: 2px;
-    padding-top: 2px;
+    padding-inline-end: 5px;
-    padding-bottom: 2px;
     color: inherit;
     font-size: $type-size-5;
     text-decoration: none;
@@ -334,10 +331,10 @@
   @include breakpoint($large) {
     position: initial;
     top: initial;
-    right: initial;
+    inset-inline-end: initial;
     width: initial;
-    margin-right: initial;
+    margin-inline-end: initial;
-    padding-left: initial;
+    padding-inline-start: initial;
     z-index: initial;
 
     &.sticky {
@@ -347,7 +344,6 @@
 
   @include breakpoint($x-large) {
     width: initial;
-    margin-right: initial;
+    margin-inline-end: initial;
   }
 }
-

_sass/minimal-mistakes/_syntax.scss

@@ -13,6 +13,11 @@ figure.highlight {
   line-height: 1.8;
   border-radius: $border-radius;
 
+  [dir=rtl] & {
+    direction: ltr;
+    text-align: start;
+  }
+
   > pre,
   pre.highlight {
     margin: 0;
@@ -33,17 +38,17 @@ figure.highlight {
     /* line numbers*/
     &.gutter,
     &.rouge-gutter {
-      padding-right: 1em;
+      padding-inline-end: 1em;
       width: 1em;
       color: $base04;
-      border-right: 1px solid $base04;
+      border-inline-end: 1px solid $base04;
-      text-align: right;
+      text-align: end;
     }
 
     /* code */
     &.code,
     &.rouge-code {
-      padding-left: 1em;
+      padding-inline-start: 1em;
     }
   }
 
@@ -321,4 +326,4 @@ figure.highlight {
   th, td {
     border-bottom: 0;
   }
-}
+}

_sass/minimal-mistakes/_tables.scss

@@ -24,7 +24,7 @@ thead {
 th {
   padding: 0.5em;
   font-weight: bold;
-  text-align: left;
+  text-align: start;
 }
 
 td {
@@ -36,4 +36,4 @@ tr,
 td,
 th {
   vertical-align: middle;
-}
+}

_sass/minimal-mistakes/_utilities.scss

@@ -83,20 +83,11 @@ body:hover .visually-hidden button {
    Type
    ========================================================================== */
 
-.text-left {
+$text-alignments: left, right, start, end, center, justify;
-  text-align: left;
+@each $alignment in $text-alignments {
-}
+  .text-#{$alignment} {
-
+    text-align: $alignment;
-.text-center {
+  }
-  text-align: center;
-}
-
-.text-right {
-  text-align: right;
-}
-
-.text-justify {
-  text-align: justify;
 }
 
 .text-nowrap {
@@ -108,20 +99,20 @@ body:hover .visually-hidden button {
    ========================================================================== */
 
 .task-list {
-  padding:0;
+  padding: 0;
 
   li {
     list-style-type: none;
   }
 
   .task-list-item-checkbox {
-    margin-right: 0.5em;
+    margin-inline-end: 0.5em;
     opacity: 1;
   }
 }
 
 .task-list .task-list {
-  margin-left: 1em;
+  margin-inline-start: 1em;
 }
 
 /*
@@ -135,8 +126,7 @@ body:hover .visually-hidden button {
 }
 
 .wrapper {
-  margin-left: auto;
+  margin-inline: auto;
-  margin-right: auto;
   width: 100%;
 }
 
@@ -148,8 +138,7 @@ body:hover .visually-hidden button {
 
 .align-left {
   display: block;
-  margin-left: auto;
+  margin-inline: auto;
-  margin-right: auto;
 
   @include breakpoint($small) {
     float: left;
@@ -161,8 +150,7 @@ body:hover .visually-hidden button {
 
 .align-right {
   display: block;
-  margin-left: auto;
+  margin-inline: auto;
-  margin-right: auto;
 
   @include breakpoint($small) {
     float: right;
@@ -174,15 +162,14 @@ body:hover .visually-hidden button {
 
 .align-center {
   display: block;
-  margin-left: auto;
+  margin-inline: auto;
-  margin-right: auto;
 }
 
 /* file page content container */
 
 .full {
   @include breakpoint($large) {
-    margin-right: -1 * span(2.5 of 12) !important;
+    margin-inline-end: -1 * span(2.5 of 12) !important;
   }
 }
 
@@ -256,11 +243,11 @@ body:hover .visually-hidden button {
   -webkit-transition: 0.3s;
   transition: 0.3s;
 
-  &:before,
+  &::before,
-  &:after {
+  &::after {
     content: "";
     position: absolute;
-    left: 0;
+    inset-inline-start: 0;
     width: $navicon-width;
     height: $navicon-height;
     background: $primary-color;
@@ -308,7 +295,7 @@ body:hover .visually-hidden button {
       content: '';
       position: fixed;
       top: 0;
-      left: 0;
+      inset-inline-start: 0;
       width: 100%;
       height: 100%;
       opacity: 0;
@@ -382,11 +369,11 @@ body:hover .visually-hidden button {
   overflow: hidden;
   position: relative;
 
-  &:before {
+  &::before {
     position: absolute;
     content: "";
     top: 0;
-    left: 0;
+    inset-inline-start: 0;
     width: 100%;
     height: 100%;
     z-index: 999;
@@ -403,8 +390,8 @@ body:hover .visually-hidden button {
   position: fixed;
   width: 300px;
   top: 50%;
-  left: 50%;
+  inset-inline-start: 50%;
-  margin-left: -150px;
+  margin-inline-start: -150px;
   margin-top: -150px;
   min-height: 0;
   z-index: 9999;
@@ -495,7 +482,7 @@ a.reversefootnote {
   embed {
     position: absolute;
     top: 0;
-    left: 0;
+    inset-inline-start: 0;
     width: 100%;
     height: 100%;
   }
@@ -533,7 +520,7 @@ pre {
     display: block;
     position: absolute;
     top: 0.6em;
-    right: 0.5em;
+    inset-inline-end: 0.5em;
     width: 1.8em;
     height: 1.5em;
     z-index: 1;
@@ -548,17 +535,14 @@ pre {
     &::before {
       content: '';
       position: absolute;
-      top: 0;
+      inset: 0;
-      right: 0;
-      bottom: 0;
-      left: 0;
       z-index: 2;
     }
 
     i {
       position: absolute;
       top: 0.25em;
-      right: 0.25em;
+      inset-inline-end: 0.25em;
       &.copied {
         opacity: 0;
       }

_sass/minimal-mistakes/_variables.scss

@@ -6,7 +6,10 @@
    Typography
    ========================================================================== */
 
-$doc-font-size: 16 !default;
+$doc-font-size: 16px !default;
+$doc-font-size-medium: $doc-font-size * 1.125 !default;
+$doc-font-size-large: $doc-font-size * 1.25 !default;
+$doc-font-size-x-large: $doc-font-size * 1.375 !default;
 
 /* paragraph indention */
 $paragraph-indent: false !default; // true, false (default)

_sass/minimal-mistakes/skins/_contrast.scss

@@ -5,7 +5,7 @@
 /* Colors */
 $text-color: #000 !default;
 $muted-text-color: $text-color !default;
-$primary-color: #ff0000 !default;
+$primary-color: #b60000 !default;
 $border-color: mix(#fff, $text-color, 75%) !default;
 $footer-background-color: #000 !default;
 $link-color: #0000ff !default;

assets/css/main.scss

@@ -6,4 +6,4 @@ search: false
 @charset "utf-8";
 
 @import "minimal-mistakes/skins/{{ site.minimal_mistakes_skin | default: 'default' }}"; // skin
-@import "minimal-mistakes"; // main partials
+@import "minimal-mistakes"; // main partials

assets/js/_main.js

@@ -123,21 +123,25 @@ $(document).ready(function () {
   });
 
   // Add anchors for headings
-  document
+  (function () {
-    .querySelector(".page__content")
+    var pageContentElement = document.querySelector(".page__content");
-    .querySelectorAll("h1, h2, h3, h4, h5, h6")
+    if (!pageContentElement) return;
-    .forEach(function (element) {
+
-      var id = element.getAttribute("id");
+    pageContentElement
-      if (id) {
+      .querySelectorAll("h1, h2, h3, h4, h5, h6")
-        var anchor = document.createElement("a");
+      .forEach(function (element) {
-        anchor.className = "header-link";
+        var id = element.getAttribute("id");
-        anchor.href = "#" + id;
+        if (id) {
-        anchor.innerHTML =
+          var anchor = document.createElement("a");
-          '<span class="sr-only">Permalink</span><i class="fas fa-link"></i>';
+          anchor.className = "header-link";
-        anchor.title = "Permalink";
+          anchor.href = "#" + id;
-        element.appendChild(anchor);
+          anchor.innerHTML =
-      }
+            '<span class="sr-only">Permalink</span><i class="fas fa-link"></i>';
-    });
+          anchor.title = "Permalink";
+          element.appendChild(anchor);
+        }
+      });
+  })();
 
   // Add copy button for <pre> blocks
   var copyText = function (text) {

assets/js/plugins/jquery.greedy-navigation.js

@@ -103,7 +103,11 @@ $(function() {
     clearTimeout(timer);
   });
 
-  $hlinks.on('mouseleave', function() {
+  $hlinks.on("click", function () {
+    // Hide the hidden links & remove the overlay when one is clicked.
+    $hlinks.addClass("hidden");
+    $btn.removeClass("close");
+  }).on('mouseleave', function() {
     // Mouse has left, start the timer
     timer = setTimeout(function() {
       $hlinks.addClass('hidden');

docs/_data/theme.yml

@@ -1,3 +1,3 @@
 # for use with in-page templates
 ---
-version: 4.26.1
+version: 4.27.0

docs/_docs/05-configuration.md

@@ -215,6 +215,12 @@ By default your site title is used in the masthead. You can override this text b
 masthead_title: "My Custom Title"
 ```
 
+### Site RTL direction
+
+`site.rtl` is used to turn the direction of the page into right to left. This option can be used for RTL languages (like Arabic, Persian, etc)
+
+_Example:_ `rtl: true` sets the direction of the page to right to left. By default this option is `rtl: false`.
+
 ### Breadcrumb navigation (beta)
 
 Enable breadcrumb links to help visitors better navigate deep sites. Because of the fragile method of implementing them they don't always produce accurate links reliably. For best results:
@@ -1226,7 +1232,7 @@ If you care at all about performance (and really who doesn't) compressing the HT
 
 If you're hosting with GitHub Pages there aren't many options afforded to you for optimizing the HTML Jekyll generates. Thankfully there is some Liquid wizardry you can use to strip whitespace and comments to reduce file size.
 
-There's a variety of configurations and caveats to using the `compress` layout, so be sure to read through the [documentation](http://jch.penibelst.de/) if you decide to make change the defaults set in the theme's `_config.yml`.
+There's a variety of configurations and caveats to using the `compress` layout, so be sure to read through the [documentation](http://jch.penibelst.de/) if you decide to change the defaults set in the theme's `_config.yml`.
 
 ```yaml
 compress_html:

docs/_docs/08-ui-text.md

@@ -11,8 +11,10 @@ The English[^yaml-anchors] main keys in [`_data/ui-text.yml`](https://github.com
 
 - Arabic (عربي)
 - Brazilian Portuguese (Português brasileiro)
+- Bulgarian
 - Catalan
 - Chinese
+- Czech
 - Danish
 - Dutch
 - Finnish

docs/_docs/18-history.md

@@ -5,7 +5,7 @@ permalink: "/docs/history/"
 excerpt: Change log of enhancements and bug fixes made to the theme.
 sidebar:
   nav: docs
-last_modified_at: '2024-05-07T14:21:22+08:00'
+last_modified_at: '2025-04-18T10:52:16+08:00'
 toc: false
 ---
 
@@ -17,6 +17,49 @@ toc: false
 {% raw %}
 ## Unreleased
 
+### Enhancements
+
+- Add RTL Support. [#4886](https://github.com/mmistakes/minimal-mistakes/pull/4886)
+- Add missing Polish translation. [#4890](https://github.com/mmistakes/minimal-mistakes/pull/4890)
+- Rewrite most directions with [CSS logical properties](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_logical_properties_and_values).
+- Remove unnecessary "type" attribute [#4956](https://github.com/mmistakes/minimal-mistakes/issues/4956)
+- The "if" means the default is never used [#4955](https://github.com/mmistakes/minimal-mistakes/issues/4955)
+- For pages without a title, show the site title only once [#4959](https://github.com/mmistakes/minimal-mistakes/issues/4959)
+- Use `documents-collection.html` partial in `home` layout.
+- Add Bulgarian translation. [#5003](https://github.com/mmistakes/minimal-mistakes/pull/5003)
+- Add provider and comments info to `single.html` layout for non-production. [#5068](https://github.com/mmistakes/minimal-mistakes/issues/5068)
+- Tweak contrast skin $primary-color to adhere to WCAG guidelines. [#5126](https://github.com/mmistakes/minimal-mistakes/issues/5126)
+- Update social share buttons to reflect Twitter rebranding to X [#5210](https://github.com/mmistakes/minimal-mistakes/issues/5210)
+
+### Bug Fixes
+
+- Replace a redirected link to MadeMistakes in footer. [#4882](https://github.com/mmistakes/minimal-mistakes/pull/4882)
+- Fix wrong float direction for `feature_row` with `type="right"`. [#4061](https://github.com/mmistakes/minimal-mistakes/issues/4061)
+- Fix reset stylesheet overruling `$doc-font-size`. [#4983](https://github.com/mmistakes/minimal-mistakes/issues/4983)
+- Fix JavaScript null error on home and splash layouts. [#4938](https://github.com/mmistakes/minimal-mistakes/issues/4938), [#4939](https://github.com/mmistakes/minimal-mistakes/pull/4939)
+- Fix bad <figure> HTML if "alt" contains quotes.
+- Fix extra newline generated in `_includes/post_pagination.html`.
+- Hide hidden links & remove the overlay when one is clicked. [#5042](https://github.com/mmistakes/minimal-mistakes/pull/5042)
+- Fix typo in "Configuration" [#5106](https://github.com/mmistakes/minimal-mistakes/issues/5106)
+- bundle exec jekyll serve will fail if more than once [#5193](https://github.com/mmistakes/minimal-mistakes/issues/5193)
+
+### Documentation & Maintenance
+
+- Automatically update Algolia search index with GitHub Actions.
+
+## [4.26.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.26.2)
+
+### Enhancements
+
+- Add Czech localization. [#4866](https://github.com/mmistakes/minimal-mistakes/pull/4866)
+- Allow overriding HTML `lang` attribute on a per-page basis. [#4862](https://github.com/mmistakes/minimal-mistakes/pull/4862)
+
+### Bug Fixes
+
+- Figure helper breaks when using code markup in caption with `popup=true`. [#4841](https://github.com/mmistakes/minimal-mistakes/issues/4841)
+
+## [4.26.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.26.1)
+
 ### Bug Fixes
 
 - Disable copy button on invalid syntax highlighting blocks to avoid positioning issues.

docs/_pages/about.md

@@ -33,7 +33,7 @@ Minimal Mistakes is a flexible two-column Jekyll theme. Perfect for hosting your
 - Optional [header images](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#headers), [custom sidebars](https://mmistakes.github.io/minimal-mistakes/docs/layouts/#sidebars), [table of contents](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#table-of-contents), [galleries](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#gallery), related posts, [breadcrumb links](https://mmistakes.github.io/minimal-mistakes/docs/configuration/#breadcrumb-navigation-beta), [navigation lists](https://mmistakes.github.io/minimal-mistakes/docs/helpers/#navigation-list), and more.
 - Commenting support (powered by [Disqus](https://disqus.com/), [Facebook](https://developers.facebook.com/docs/plugins/comments), [Discourse](https://www.discourse.org/), [utterances](https://utteranc.es/), [giscus](https://giscus.app/), static-based via [Staticman v1 and v2](https://staticman.net/), and custom).
 - [Google Analytics](https://www.google.com/analytics/) support.
-- UI localized text in English (default), Arabic (عربي), Brazilian Portuguese (Português brasileiro), Catalan, Chinese, Danish, Dutch, Finnish, French (Français), German (Deutsch), Greek, Hebrew, Hindi (हिंदी), Hungarian, Indonesian, Irish (Gaeilge), Italian (Italiano), Japanese, Kiswahili, Korean, Malayalam, Myanmar (Burmese), Nepali (Nepalese), Norwegian (Norsk), Persian (فارسی), Polish, Punjabi (ਪੰਜਾਬੀ), Romanian, Russian, Slovak, Spanish (Español), Swedish, Thai, Turkish (Türkçe), and Vietnamese.
+- UI localized text in English (default), Arabic (عربي), Brazilian Portuguese (Português brasileiro), Bulgarian, Catalan, Chinese, Czech, Danish, Dutch, Finnish, French (Français), German (Deutsch), Greek, Hebrew, Hindi (हिंदी), Hungarian, Indonesian, Irish (Gaeilge), Italian (Italiano), Japanese, Kiswahili, Korean, Malayalam, Myanmar (Burmese), Nepali (Nepalese), Norwegian (Norsk), Persian (فارسی), Polish, Punjabi (ਪੰਜਾਬੀ), Romanian, Russian, Slovak, Spanish (Español), Swedish, Thai, Turkish (Türkçe), and Vietnamese.
 
 ## Demo Pages
 

docs/_pages/home.md

@@ -10,7 +10,7 @@ header:
       url: "/docs/quick-start-guide/"
 excerpt: >
   A flexible two-column Jekyll theme. Perfect for building personal sites, blogs, and portfolios.<br />
-  <small><a href="https://github.com/mmistakes/minimal-mistakes/releases/tag/4.26.1">Latest release v4.26.1</a></small>
+  <small><a href="https://github.com/mmistakes/minimal-mistakes/releases/tag/4.27.0">Latest release v4.27.0</a></small>
 feature_row:
   - image_path: /assets/images/mm-customizable-feature.png
     alt: "customizable"

package.json

@@ -1,7 +1,7 @@
 {
   "name": "minimal-mistakes",
   "private": true,
-  "version": "4.26.1",
+  "version": "4.27.0",
   "description": "Minimal Mistakes 2 column Jekyll theme.",
   "repository": {
     "type": "git",