Skip to content

Allow specifying rtl in both page and layout #5460

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
neveler wants to merge 5 commits into
base: master
Choose a base branch
from
+6 −6
Open

Allow specifying rtl in both page and layout #5460

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
8e3a2a8
Allow specifying `rtl` in both `page` and `layout`
neveler Mar 21, 2026
23b23d9
Update default.html
neveler Mar 21, 2026
717af33
Update default.html
neveler Mar 21, 2026
0610f33
Update _config.yml
neveler Mar 21, 2026
e505ec8
Update 05-configuration.md
neveler Mar 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion _config.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +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
direction : # "ltr" (default), "rtl" # set the direction of the page
title : "Site Title"
title_separator : "-"
subtitle : # site tagline that appears below site title in masthead
Expand Down
4 changes: 2 additions & 2 deletions _layouts/default.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,13 @@

<!doctype html>
{% include copyright.html %}
<html lang="{{ locale | replace: "_", "-" | default: "en" }}" class="no-js">
<html lang="{{ locale | replace: '_', '-' | default: 'en' }}" class="no-js" dir="{{ page.direction | default: layout.direction | default: site.direction | default: 'ltr' }}">
<head>
{% include head.html locale=locale %}
{% 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 %}" dir="{% if site.rtl %}rtl{% else %}ltr{% endif %}">
<body class="layout--{{ page.layout | default: layout.layout }}{% if page.classes or layout.classes %}{{ page.classes | default: layout.classes | join: ' ' | prepend: ' ' }}{% endif %}">
{% include_cached skip-links.html locale=locale %}
{% include_cached masthead.html locale=locale %}

Expand Down
6 changes: 3 additions & 3 deletions docs/_docs/05-configuration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -218,11 +218,11 @@ 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 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)
`site.direction` is used to sets the direction of the page. 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`.
_Example:_ `direction: rtl` sets the direction of the page to right to left. By default this option is `direction: ltr`.

### Breadcrumb navigation (beta)

Expand Down