up

Author: Yuriy Bondarenko

.markdownlint.json

@@ -1,9 +1,19 @@
 {
+	"MD007": {
+		"indent": 4
+	},
 	"MD010": false,
 	"MD013": false,
 	"MD022": false,
 	"MD025": false,
 	"MD026": false,
+	"MD030": {
+		"ol_single": 2,
+		"ul_single": 3,
+		"ol_multi": 2,
+		"ul_multi": 3,
+		"list"
+	},
 	"MD033": false,
 	"MD036": false,
 	"MD040": false,

.prettierrc.json

@@ -11,7 +11,7 @@
 			"options": {
 				"parser": "markdown",
 				"useTabs": false,
-				"tabWidth": 2
+				"tabWidth": 4
 			}
 		},
 		{

docs/.pages

@@ -1,8 +1,7 @@
 nav:
-    - index.md
+    - 🏠: index.md
     - xslt
     - xpath
     - exslt
     - recipes
-    - tr.md
     - Спасибо: https://boosty.to/bndby

docs/index.md

@@ -5,22 +5,43 @@ hide:
   - toc # Hide table of contents
 ---
 
-# Справочники
+# ![XSLT](xslt.svg){: style="height:42px;width:42px;vertical-align:middle;"} Справочник XSLT
 
-[XSLT](/xslt/)
-: Справочник по элементам XSLT 1.0 на русском языке.
+**XSLT** — языка преобразований XML документов в другие XML документы.
 
-[XPath](/xpath/)
-: Справочник по функциям XPath 1.0 на русском языке
+<div class="grid cards" style="margin-top: 1.6em" markdown>
 
-[Спецификация](/tr/)
-: Перевод рекомендации W3C на русский язык
+-   :material-xml:{ .lg .middle } **XSLT**
 
-[EXSLT](/exslt/)
-: Общественная инициатива по созданию расширений для XSLT, придающих бо́льшую функциональность языку трансформаций
+    ***
 
-[Рецепты](/recipes/)
-: Сборник рецептов XSLT
+    Документация по XSLT
+
+    **[:octicons-arrow-right-24: XSLT](/xslt/)** <small>1.0</small>
+
+    [:octicons-arrow-right-24: Спецификация XSLT](/tr/) <small>1.0</small>
+
+	[:octicons-arrow-right-24: EXSLT](/exslt/) &mdash; <small>расширение XSLT</small>
+
+-   :octicons-rel-file-path-24:{ .lg .middle } **XPath**
+
+	***
+
+	Справочник по функциям XPath
+
+	[:octicons-arrow-right-24: XPath](/xpath/) <small>1.0</small>
+
+-   :material-file-document-outline:{ .lg .middle } **Гайды**
+
+	***
+
+	Сборник рецептов XSLT
+
+	[:octicons-arrow-right-24: Рецепты](/recipes/)
+
+</div>
+
+***
 
 !!!abstract "Справочники"
 

mkdocs.yml

@@ -29,28 +29,39 @@ theme:
     features:
         - navigation.tabs
         - navigation.tracking
-        - navigation.instant
         - navigation.top
+        - navigation.footer
+        - navigation.indexes
         - content.action.edit
+        - content.code.copy
     favicon: xslt.svg
     logo: xslt.svg
 
 markdown_extensions:
     - admonition
-    - codehilite:
-          guess_lang: false
-          linenums: false
     - toc:
           permalink: true
     - pymdownx.extra
+    - pymdownx.critic
+    - pymdownx.caret
+    - pymdownx.keys
+    - pymdownx.mark
+    - pymdownx.tilde
     - pymdownx.details
     - pymdownx.emoji:
           emoji_index: !!python/name:materialx.emoji.twemoji
           emoji_generator: !!python/name:materialx.emoji.to_svg
-    - pymdownx.tabbed
+    - pymdownx.tabbed:
+          alternate_style: true
+    - pymdownx.highlight:
+          pygments_lang_class: true
+          linenums: true
+    - pymdownx.inlinehilite
+    - pymdownx.snippets
     - pymdownx.superfences
-    - attr_list
-    - md_in_html
+    - pymdownx.arithmatex:
+          generic: true
+    - pymdownx.smartsymbols
 
 plugins:
     - search:
@@ -60,7 +71,6 @@ plugins:
               - ru
               - en
     - awesome-pages
-    - section-index
     - social
 
 extra:
@@ -89,4 +99,4 @@ extra:
           name: XSLT docs
 
 extra_css:
-    - '/assets/stylesheets/styles.css?3'
+    - '/assets/stylesheets/styles.css?4'

netlify.toml

@@ -166,3 +166,101 @@ h3 {
 	background: url('/heart.svg') left center / 16px 16px
 		no-repeat;
 }
+
+/* mkdocs cards*/
+.md-typeset .grid {
+	grid-gap: 0.8rem;
+	display: grid;
+	grid-template-columns: repeat(
+		auto-fit,
+		minmax(16rem, 1fr)
+	);
+	margin: 1em 0;
+}
+.md-typeset .grid.cards > ol,
+.md-typeset .grid.cards > ul {
+	display: contents;
+}
+.md-typeset .grid.cards > ol > li,
+.md-typeset .grid.cards > ul > li,
+.md-typeset .grid > .card {
+	border: 0.05rem solid
+		var(--md-default-fg-color--lightest);
+	border-radius: 0.1rem;
+	display: block;
+	margin: 0;
+	padding: 0.8rem;
+	transition: border 0.25s, box-shadow 0.25s;
+	box-shadow: var(--md-shadow-z1);
+}
+.md-typeset .grid.cards > ol > li:focus-within,
+.md-typeset .grid.cards > ol > li:hover,
+.md-typeset .grid.cards > ul > li:focus-within,
+.md-typeset .grid.cards > ul > li:hover,
+.md-typeset .grid > .card:focus-within,
+.md-typeset .grid > .card:hover {
+	border-color: #0000;
+	box-shadow: var(--md-shadow-z2);
+}
+.md-typeset .grid.cards > ol > li > hr,
+.md-typeset .grid.cards > ul > li > hr,
+.md-typeset .grid > .card > hr {
+	margin-bottom: 1em;
+	margin-top: 1em;
+}
+.md-typeset .grid.cards > ol > li > :first-child,
+.md-typeset .grid.cards > ul > li > :first-child,
+.md-typeset .grid > .card > :first-child {
+	margin-top: 0;
+}
+.md-typeset .grid.cards > ol > li > :last-child,
+.md-typeset .grid.cards > ul > li > :last-child,
+.md-typeset .grid > .card > :last-child {
+	margin-bottom: 0;
+}
+.md-typeset .grid > *,
+.md-typeset .grid > .admonition,
+.md-typeset .grid > .highlight > *,
+.md-typeset .grid > .highlighttable,
+.md-typeset .grid > .md-typeset details,
+.md-typeset .grid > details,
+.md-typeset .grid > pre {
+	margin-bottom: 0;
+	margin-top: 0;
+}
+.md-typeset .grid > .highlight > pre:only-child,
+.md-typeset .grid > .highlight > pre > code,
+.md-typeset .grid > .highlighttable,
+.md-typeset .grid > .highlighttable > tbody,
+.md-typeset .grid > .highlighttable > tbody > tr,
+.md-typeset .grid > .highlighttable > tbody > tr > .code,
+.md-typeset
+	.grid
+	> .highlighttable
+	> tbody
+	> tr
+	> .code
+	> .highlight,
+.md-typeset
+	.grid
+	> .highlighttable
+	> tbody
+	> tr
+	> .code
+	> .highlight
+	> pre,
+.md-typeset
+	.grid
+	> .highlighttable
+	> tbody
+	> tr
+	> .code
+	> .highlight
+	> pre
+	> code {
+	height: 100%;
+}
+.md-typeset .grid > .tabbed-set {
+	margin-bottom: 0;
+	margin-top: 0;
+}

overrides/assets/stylesheets/styles.css

@@ -10,7 +10,7 @@
   "scripts": {
     "build": "mkdocs build",
     "serve": "mkdocs serve --dirtyreload",
-	"upgrade": "pip3 install --upgrade -r ./requirements.txt"
+    "upgrade": "pip3 install --upgrade -r ./requirements.txt"
   },
   "repository": {
     "type": "git",