Merge branch 'master' into a11y-nav

README.md

@@ -298,7 +298,7 @@ If you are using `config.yaml` or `config.json`, consult the [configuration mark
 
 ## Versioning
 
-This theme follows a simple incremental versioning. e.g. `v1`, `v2` and so on. There might be breaking changes between versions.
+This theme follows a simple incremental versioning. e.g. `v1.0.0`, `v2.0.0` and so on. Releases will happen on breaking changes.
 
 If you want lower maintenance, use one of the released versions. If you want to live on the bleeding edge of changes, you can use the `master` branch and update your website when needed.
 

assets/_main.scss

@@ -2,6 +2,7 @@ html {
   font-size: $font-size-base;
   scroll-behavior: smooth;
   touch-action: manipulation;
+  scrollbar-gutter: stable;
 }
 
 body {
@@ -48,11 +49,11 @@ aside nav ul {
   list-style: none;
 
   li {
-    margin: 0;
     position: relative;
   }
 
-  a {
+  a, span {
+    padding: .5em 0;
     display: block;
     line-height: 2;
   }
@@ -140,10 +141,12 @@ a .book-icon {
 
   input.toggle + label::after {
     content: "▸";
+    align-self: center;
   }
 
   input.toggle:checked + label::after {
     content: "▾";
+    align-self: center;
   }
 }
 
@@ -159,7 +162,7 @@ body[dir="rtl"] .book-menu {
 }
 
 .book-section-flat {
-  margin: $padding-16 * 2 0;
+  margin: $padding-16 0;
 
   > a,
   > span,
@@ -214,7 +217,7 @@ body[dir="rtl"] .book-menu {
 
 .book-search {
   position: relative;
-  margin: $padding-16 0;
+  margin: $padding-8 0;
   border-bottom: 1px solid transparent;
 
   input {
@@ -248,6 +251,10 @@ body[dir="rtl"] .book-menu {
     @include spin(1s);
   }
 
+  ul a {
+    padding-bottom: 0;
+  }
+
   small {
     opacity: 0.5;
   }
@@ -280,7 +287,7 @@ body[dir="rtl"] .book-menu {
 }
 
 .book-languages {
-  margin-block-end: $padding-16 * 2;
+  margin-bottom: $padding-16;
 
   ul {
     padding-inline-start: 1.5em;

exampleSite/content.en/docs/shortcodes/tabs.md

@@ -3,16 +3,16 @@
 Tabs let you organize content by context, for example installation instructions for each supported platform.
 
 ```tpl
-{{%/* tabs "id" */%}}
+{{</* tabs "id" */>}}
 {{%/* tab "MacOS" */%}} # MacOS Content {{%/* /tab */%}}
 {{%/* tab "Linux" */%}} # Linux Content {{%/* /tab */%}}
 {{%/* tab "Windows" */%}} # Windows Content {{%/* /tab */%}}
-{{%/* /tabs */%}}
+{{</* /tabs */>}}
 ```
 
 ## Example
 
-{{% tabs %}}
+{{< tabs >}}
 
 {{% tab "MacOS" %}}
 # MacOS
@@ -47,4 +47,4 @@ protulit, sed sed aere valvis inhaesuro Pallas animam: qui _quid_, ignes.
 Miseratus fonte Ditis conubia.
 {{% /tab %}}
 
-{{% /tabs %}}
+{{< /tabs >}}

exampleSite/resources/_gen/assets/book.scss_b807c86e8030af4cdc30edccea379f5f.json

@@ -1 +0,0 @@
-{"Target":"book.min.6c8b9d2a1fc95075ed7da46ca81060b39add8fff6741ac51259f768929281e2c.css","MediaType":"text/css","Data":{"Integrity":"sha256-bIudKh/JUHXtfaRsqBBgs5rdj/9nQaxRJZ92iSkoHiw="}}

i18n/he.yaml

@@ -0,0 +1,14 @@
+- id: Search
+  translation: חיפוש
+
+- id: Edit this page
+  translation: ערוך דף זה
+
+- id: Last modified by
+  translation: נערך לאחרונה על ידי
+
+- id: Expand
+  translation: הרחב
+
+- id: bookSearchConfig
+  translation: '{ cache: true }'

i18n/pl.yaml

@@ -0,0 +1,14 @@
+- id: Search
+  translation: Szukaj
+
+- id: Edit this page
+  translation: Edytuj stronę
+
+- id: Last modified by
+  translation: Ostatnia modyfikacja
+
+- id: Expand
+  translation: Rozwiń
+
+- id: bookSearchConfig
+  translation: '{ cache: true }'

i18n/pt-BR.yaml

@@ -0,0 +1,14 @@
+- id: Search
+  translation: Buscar
+
+- id: Edit this page
+  translation: Editar página
+
+- id: Last modified by
+  translation: Última modificação por
+
+- id: Expand
+  translation: Expandir
+
+- id: bookSearchConfig
+  translation: '{ cache: true }'

i18n/pt.yaml

@@ -1,5 +1,5 @@
 - id: Search
-  translation: Buscar
+  translation: Pesquisar
 
 - id: Edit this page
   translation: Editar página

layouts/_default/_markup/render-link.html

@@ -7,7 +7,8 @@
 {{- define "portable-link" -}}
   {{- $destination := .Destination }}
   {{- $isRemote := or (in .Destination ":") (strings.HasPrefix .Destination "//") }}
-  {{- if not $isRemote }}
+  {{- $isFragment := strings.HasPrefix .Destination "#" }}
+  {{- if and (not $isRemote) (not $isFragment) }}
     {{- $url := urls.Parse .Destination }}
     {{- $path := strings.TrimSuffix "/_index.md" $url.Path }}
     {{- $path = strings.TrimSuffix "/_index" $path }}

layouts/partials/docs/languages.html

@@ -13,8 +13,8 @@
 <ul class="book-languages">
   <li>
     <input type="checkbox" id="languages" class="toggle" />
-    <label for="languages" class="flex justify-between">
-      <a role="button" class="flex align-center">
+    <label for="languages" class="flex">
+      <a role="button" class="flex flex-auto">
         <img src="{{ "svg/translate.svg" | relURL }}" class="book-icon" alt="Languages" />
         {{ $.Site.Language.LanguageName }}
       </a>

layouts/partials/docs/menu-filetree.html

@@ -30,8 +30,8 @@
 
   {{ if .Page.Params.BookCollapseSection }}
     <input type="checkbox" id="section-{{ md5 .Page }}" class="toggle" {{ if or $current $ancestor }}checked{{ end }} />
-    <label for="section-{{ md5 .Page }}" class="flex justify-between">
-      <a {{ if .Page.Content }}href="{{ .Page.RelPermalink }}"{{ else }}role="button"{{ end }} class="{{ if $current }}active{{ end }}">
+    <label for="section-{{ md5 .Page }}" class="flex">
+      <a {{ if .Page.Content }}href="{{ .Page.RelPermalink }}"{{ else }}role="button"{{ end }} class="flex-auto {{ if $current }}active{{ end }}">
         {{- partial "docs/title" .Page -}}
       </a>
     </label>

layouts/posts/single.html

@@ -1,8 +1,8 @@
 {{ define "main" }}
 <article class="markdown book-post">
-  <h2>
+  <h1>
     {{ partial "docs/title.html" . }}
-  </h2>
+  </h1>
   {{ partial "docs/post-meta" . }}
   <div class="book-post-content">
     {{- .Content -}}

layouts/shortcodes/hint.html

@@ -1,3 +1,3 @@
 <blockquote class="book-hint {{ .Get 0 }}">
-  {{ .InnerDeindent | safeHTML }}
+  {{ .Inner | safeHTML }}
 </blockquote>