From a4154d4bbdc8f9425d73257be81b9af37b75258b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 21 Apr 2023 23:26:47 +0200
Subject: [PATCH 01/39] Poetry(deps): bump mkdocs-material from 9.1.5 to 9.1.6
 (#19)

Bumps [mkdocs-material](https://github.com/squidfunk/mkdocs-material) from 9.1.5 to 9.1.6.
- [Release notes](https://github.com/squidfunk/mkdocs-material/releases)
- [Changelog](https://github.com/squidfunk/mkdocs-material/blob/master/CHANGELOG)
- [Commits](https://github.com/squidfunk/mkdocs-material/compare/9.1.5...9.1.6)

---
updated-dependencies:
- dependency-name: mkdocs-material
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 poetry.lock    | 8 ++++----
 pyproject.toml | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 36e4341..35ca7f0 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -360,14 +360,14 @@ min-versions = ["babel (==2.9.0)", "click (==7.0)", "colorama (==0.4)", "ghp-imp
 
 [[package]]
 name = "mkdocs-material"
-version = "9.1.5"
+version = "9.1.6"
 description = "Documentation that simply works"
 category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "mkdocs_material-9.1.5-py3-none-any.whl", hash = "sha256:981e1ef0250e2fbcc23610e9b20e5f242fe1f808079b9bcfbb6c49aa2999343c"},
-    {file = "mkdocs_material-9.1.5.tar.gz", hash = "sha256:744519bca52b1e8fe7c2e80e15ed59baf8948111ec763ae6ae629c409bd16d6e"},
+    {file = "mkdocs_material-9.1.6-py3-none-any.whl", hash = "sha256:f2eb1d40db89da9922944833c1387207408f8937e1c2b46ab86e0c8f170b71e0"},
+    {file = "mkdocs_material-9.1.6.tar.gz", hash = "sha256:2e555152f9771646bfa62dc78a86052876183eff69ce30db03a33e85702b21fc"},
 ]
 
 [package.dependencies]
@@ -847,4 +847,4 @@ files = [
 [metadata]
 lock-version = "2.0"
 python-versions = "^3.10"
-content-hash = "1fce871a3ec31243e878d1fd5417b4fe4fe0a32a84554872ea30b7b843a9b44a"
+content-hash = "dd8f727b4cce40956e1d06ae2bceffaf09beccfa41d0f74b191b5c28f1cfb457"
diff --git a/pyproject.toml b/pyproject.toml
index 9d1091c..bad67e3 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -8,7 +8,7 @@ license = "MIT"
 [tool.poetry.dependencies]
 python = "^3.10"
 mkdocs = "^1.4.2"
-mkdocs-material = "^9.1.5"
+mkdocs-material = "^9.1.6"
 pillow = "^9.5.0"
 cairosvg = "^2.7.0"
 

From 082c684b3e1772eacd27f2b81f122ac4aeba67be Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 15 May 2023 23:00:11 +0200
Subject: [PATCH 02/39] Poetry(deps): Bump pymdown-extensions from 9.10 to 10.0
 (#25)

Bumps [pymdown-extensions](https://github.com/facelessuser/pymdown-extensions) from 9.10 to 10.0.
- [Release notes](https://github.com/facelessuser/pymdown-extensions/releases)
- [Commits](https://github.com/facelessuser/pymdown-extensions/compare/9.10...10.0)

---
updated-dependencies:
- dependency-name: pymdown-extensions
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 poetry.lock | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 35ca7f0..3203c54 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -517,14 +517,14 @@ plugins = ["importlib-metadata"]
 
 [[package]]
 name = "pymdown-extensions"
-version = "9.10"
+version = "10.0"
 description = "Extension pack for Python Markdown."
 category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "pymdown_extensions-9.10-py3-none-any.whl", hash = "sha256:31eaa76ce6f96aabfcea98787c2fff2c5c0611b20a53a94213970cfbf05f02b8"},
-    {file = "pymdown_extensions-9.10.tar.gz", hash = "sha256:562c38eee4ce3f101ce631b804bfc2177a8a76c7e4dc908871fb6741a90257a7"},
+    {file = "pymdown_extensions-10.0-py3-none-any.whl", hash = "sha256:e6cbe8ace7d8feda30bc4fd6a21a073893a9a0e90c373e92d69ce5b653051f55"},
+    {file = "pymdown_extensions-10.0.tar.gz", hash = "sha256:9a77955e63528c2ee98073a1fb3207c1a45607bc74a34ef21acd098f46c3aa8a"},
 ]
 
 [package.dependencies]

From 9fa82794cf1bc555170c031ddeba555a35d0260e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 15 May 2023 23:03:14 +0200
Subject: [PATCH 03/39] Poetry(deps): Bump mkdocs from 1.4.2 to 1.4.3 (#22)

Bumps [mkdocs](https://github.com/mkdocs/mkdocs) from 1.4.2 to 1.4.3.
- [Release notes](https://github.com/mkdocs/mkdocs/releases)
- [Commits](https://github.com/mkdocs/mkdocs/compare/1.4.2...1.4.3)

---
updated-dependencies:
- dependency-name: mkdocs
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 poetry.lock    | 8 ++++----
 pyproject.toml | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 3203c54..3c74cee 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -332,14 +332,14 @@ files = [
 
 [[package]]
 name = "mkdocs"
-version = "1.4.2"
+version = "1.4.3"
 description = "Project documentation with Markdown."
 category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "mkdocs-1.4.2-py3-none-any.whl", hash = "sha256:c8856a832c1e56702577023cd64cc5f84948280c1c0fcc6af4cd39006ea6aa8c"},
-    {file = "mkdocs-1.4.2.tar.gz", hash = "sha256:8947af423a6d0facf41ea1195b8e1e8c85ad94ac95ae307fe11232e0424b11c5"},
+    {file = "mkdocs-1.4.3-py3-none-any.whl", hash = "sha256:6ee46d309bda331aac915cd24aab882c179a933bd9e77b80ce7d2eaaa3f689dd"},
+    {file = "mkdocs-1.4.3.tar.gz", hash = "sha256:5955093bbd4dd2e9403c5afaf57324ad8b04f16886512a3ee6ef828956481c57"},
 ]
 
 [package.dependencies]
@@ -847,4 +847,4 @@ files = [
 [metadata]
 lock-version = "2.0"
 python-versions = "^3.10"
-content-hash = "dd8f727b4cce40956e1d06ae2bceffaf09beccfa41d0f74b191b5c28f1cfb457"
+content-hash = "aa450c1796c0d1dd9998436d95361c924248563e0b154359af47f282519c1e4e"
diff --git a/pyproject.toml b/pyproject.toml
index bad67e3..c29ae61 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -7,7 +7,7 @@ license = "MIT"
 
 [tool.poetry.dependencies]
 python = "^3.10"
-mkdocs = "^1.4.2"
+mkdocs = "^1.4.3"
 mkdocs-material = "^9.1.6"
 pillow = "^9.5.0"
 cairosvg = "^2.7.0"

From c6fd793b2d91491d5d01b4d1dd13f547c6f08569 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 15 May 2023 23:08:20 +0200
Subject: [PATCH 04/39] Poetry(deps): Bump mkdocs-material from 9.1.6 to 9.1.12
 (#24)

Bumps [mkdocs-material](https://github.com/squidfunk/mkdocs-material) from 9.1.6 to 9.1.12.
- [Release notes](https://github.com/squidfunk/mkdocs-material/releases)
- [Changelog](https://github.com/squidfunk/mkdocs-material/blob/master/CHANGELOG)
- [Commits](https://github.com/squidfunk/mkdocs-material/compare/9.1.6...9.1.12)

---
updated-dependencies:
- dependency-name: mkdocs-material
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 poetry.lock    | 8 ++++----
 pyproject.toml | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 3c74cee..a40d552 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -360,14 +360,14 @@ min-versions = ["babel (==2.9.0)", "click (==7.0)", "colorama (==0.4)", "ghp-imp
 
 [[package]]
 name = "mkdocs-material"
-version = "9.1.6"
+version = "9.1.12"
 description = "Documentation that simply works"
 category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "mkdocs_material-9.1.6-py3-none-any.whl", hash = "sha256:f2eb1d40db89da9922944833c1387207408f8937e1c2b46ab86e0c8f170b71e0"},
-    {file = "mkdocs_material-9.1.6.tar.gz", hash = "sha256:2e555152f9771646bfa62dc78a86052876183eff69ce30db03a33e85702b21fc"},
+    {file = "mkdocs_material-9.1.12-py3-none-any.whl", hash = "sha256:68c57d95d10104179c8c3ce9a88ee9d2322a5145b3d0f1f38ff686253fb5ec98"},
+    {file = "mkdocs_material-9.1.12.tar.gz", hash = "sha256:d4ebe9b5031ce63a265c19fb5eab4d27ea4edadb05de206372e831b2b7570fb5"},
 ]
 
 [package.dependencies]
@@ -847,4 +847,4 @@ files = [
 [metadata]
 lock-version = "2.0"
 python-versions = "^3.10"
-content-hash = "aa450c1796c0d1dd9998436d95361c924248563e0b154359af47f282519c1e4e"
+content-hash = "8c4d980521673d37043e12a1460f740a985e440bcf884840497e151800fc310b"
diff --git a/pyproject.toml b/pyproject.toml
index c29ae61..a05f183 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -8,7 +8,7 @@ license = "MIT"
 [tool.poetry.dependencies]
 python = "^3.10"
 mkdocs = "^1.4.3"
-mkdocs-material = "^9.1.6"
+mkdocs-material = "^9.1.12"
 pillow = "^9.5.0"
 cairosvg = "^2.7.0"
 

From 3f7298d652adc57b841eb93de1c332477f855e2b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 20 Jun 2023 10:46:31 +0200
Subject: [PATCH 05/39] Poetry(deps): Bump mkdocs-material from 9.1.12 to
 9.1.16 (#29)

Bumps [mkdocs-material](https://github.com/squidfunk/mkdocs-material) from 9.1.12 to 9.1.16.
- [Release notes](https://github.com/squidfunk/mkdocs-material/releases)
- [Changelog](https://github.com/squidfunk/mkdocs-material/blob/master/CHANGELOG)
- [Commits](https://github.com/squidfunk/mkdocs-material/compare/9.1.12...9.1.16)

---
updated-dependencies:
- dependency-name: mkdocs-material
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 poetry.lock    | 44 +++++---------------------------------------
 pyproject.toml |  2 +-
 2 files changed, 6 insertions(+), 40 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index a40d552..43ac75c 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -1,10 +1,9 @@
-# This file is automatically @generated by Poetry and should not be changed by hand.
+# This file is automatically @generated by Poetry 1.5.1 and should not be changed by hand.
 
 [[package]]
 name = "cairocffi"
 version = "1.4.0"
 description = "cffi-based cairo bindings for Python"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -23,7 +22,6 @@ xcb = ["xcffib (>=0.3.2)"]
 name = "cairosvg"
 version = "2.7.0"
 description = "A Simple SVG Converter based on Cairo"
-category = "main"
 optional = false
 python-versions = ">=3.5"
 files = [
@@ -46,7 +44,6 @@ test = ["flake8", "isort", "pytest"]
 name = "certifi"
 version = "2022.12.7"
 description = "Python package for providing Mozilla's CA Bundle."
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -58,7 +55,6 @@ files = [
 name = "cffi"
 version = "1.15.1"
 description = "Foreign Function Interface for Python calling C code."
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -135,7 +131,6 @@ pycparser = "*"
 name = "charset-normalizer"
 version = "2.1.1"
 description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet."
-category = "main"
 optional = false
 python-versions = ">=3.6.0"
 files = [
@@ -150,7 +145,6 @@ unicode-backport = ["unicodedata2"]
 name = "click"
 version = "8.1.3"
 description = "Composable command line interface toolkit"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -165,7 +159,6 @@ colorama = {version = "*", markers = "platform_system == \"Windows\""}
 name = "colorama"
 version = "0.4.6"
 description = "Cross-platform colored terminal text."
-category = "main"
 optional = false
 python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7"
 files = [
@@ -177,7 +170,6 @@ files = [
 name = "cssselect2"
 version = "0.7.0"
 description = "CSS selectors for Python ElementTree"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -197,7 +189,6 @@ test = ["flake8", "isort", "pytest"]
 name = "defusedxml"
 version = "0.7.1"
 description = "XML bomb protection for Python stdlib modules"
-category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
 files = [
@@ -209,7 +200,6 @@ files = [
 name = "ghp-import"
 version = "2.1.0"
 description = "Copy your docs directly to the gh-pages branch."
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -227,7 +217,6 @@ dev = ["flake8", "markdown", "twine", "wheel"]
 name = "idna"
 version = "3.4"
 description = "Internationalized Domain Names in Applications (IDNA)"
-category = "main"
 optional = false
 python-versions = ">=3.5"
 files = [
@@ -239,7 +228,6 @@ files = [
 name = "Jinja2"
 version = "3.1.2"
 description = "A very fast and expressive template engine."
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -257,7 +245,6 @@ i18n = ["Babel (>=2.7)"]
 name = "Markdown"
 version = "3.3.7"
 description = "Python implementation of Markdown."
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -272,7 +259,6 @@ testing = ["coverage", "pyyaml"]
 name = "MarkupSafe"
 version = "2.1.1"
 description = "Safely add untrusted strings to HTML/XML markup."
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -322,7 +308,6 @@ files = [
 name = "mergedeep"
 version = "1.3.4"
 description = "A deep merge function for 🐍."
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -334,7 +319,6 @@ files = [
 name = "mkdocs"
 version = "1.4.3"
 description = "Project documentation with Markdown."
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -360,14 +344,13 @@ min-versions = ["babel (==2.9.0)", "click (==7.0)", "colorama (==0.4)", "ghp-imp
 
 [[package]]
 name = "mkdocs-material"
-version = "9.1.12"
+version = "9.1.16"
 description = "Documentation that simply works"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "mkdocs_material-9.1.12-py3-none-any.whl", hash = "sha256:68c57d95d10104179c8c3ce9a88ee9d2322a5145b3d0f1f38ff686253fb5ec98"},
-    {file = "mkdocs_material-9.1.12.tar.gz", hash = "sha256:d4ebe9b5031ce63a265c19fb5eab4d27ea4edadb05de206372e831b2b7570fb5"},
+    {file = "mkdocs_material-9.1.16-py3-none-any.whl", hash = "sha256:f9e62558a6b01ffac314423cbc223d970c25fbc78999860226245b64e64d6751"},
+    {file = "mkdocs_material-9.1.16.tar.gz", hash = "sha256:1021bfea20f00a9423530c8c2ae9be3c78b80f5a527b3f822e6de3d872e5ab79"},
 ]
 
 [package.dependencies]
@@ -385,7 +368,6 @@ requests = ">=2.26"
 name = "mkdocs-material-extensions"
 version = "1.1"
 description = "Extension pack for Python Markdown and MkDocs Material."
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -397,7 +379,6 @@ files = [
 name = "packaging"
 version = "21.3"
 description = "Core utilities for Python packages"
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -412,7 +393,6 @@ pyparsing = ">=2.0.2,<3.0.5 || >3.0.5"
 name = "pillow"
 version = "9.5.0"
 description = "Python Imaging Library (Fork)"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -492,7 +472,6 @@ tests = ["check-manifest", "coverage", "defusedxml", "markdown2", "olefile", "pa
 name = "pycparser"
 version = "2.21"
 description = "C parser in Python"
-category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 files = [
@@ -504,7 +483,6 @@ files = [
 name = "pygments"
 version = "2.14.0"
 description = "Pygments is a syntax highlighting package written in Python."
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -519,7 +497,6 @@ plugins = ["importlib-metadata"]
 name = "pymdown-extensions"
 version = "10.0"
 description = "Extension pack for Python Markdown."
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -535,7 +512,6 @@ pyyaml = "*"
 name = "pyparsing"
 version = "3.0.9"
 description = "pyparsing module - Classes and methods to define and execute parsing grammars"
-category = "main"
 optional = false
 python-versions = ">=3.6.8"
 files = [
@@ -550,7 +526,6 @@ diagrams = ["jinja2", "railroad-diagrams"]
 name = "python-dateutil"
 version = "2.8.2"
 description = "Extensions to the standard Python datetime module"
-category = "main"
 optional = false
 python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,>=2.7"
 files = [
@@ -565,7 +540,6 @@ six = ">=1.5"
 name = "PyYAML"
 version = "6.0"
 description = "YAML parser and emitter for Python"
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -615,7 +589,6 @@ files = [
 name = "pyyaml_env_tag"
 version = "0.1"
 description = "A custom YAML tag for referencing environment variables in YAML files. "
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -630,7 +603,6 @@ pyyaml = "*"
 name = "regex"
 version = "2022.10.31"
 description = "Alternative regular expression module, to replace re."
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -728,7 +700,6 @@ files = [
 name = "requests"
 version = "2.28.1"
 description = "Python HTTP for Humans."
-category = "main"
 optional = false
 python-versions = ">=3.7, <4"
 files = [
@@ -750,7 +721,6 @@ use-chardet-on-py3 = ["chardet (>=3.0.2,<6)"]
 name = "six"
 version = "1.16.0"
 description = "Python 2 and 3 compatibility utilities"
-category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*"
 files = [
@@ -762,7 +732,6 @@ files = [
 name = "tinycss2"
 version = "1.2.1"
 description = "A tiny CSS parser"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -781,7 +750,6 @@ test = ["flake8", "isort", "pytest"]
 name = "urllib3"
 version = "1.26.12"
 description = "HTTP library with thread-safe connection pooling, file post, and more."
-category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, <4"
 files = [
@@ -798,7 +766,6 @@ socks = ["PySocks (>=1.5.6,!=1.5.7,<2.0)"]
 name = "watchdog"
 version = "2.1.9"
 description = "Filesystem events monitoring"
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -836,7 +803,6 @@ watchmedo = ["PyYAML (>=3.10)"]
 name = "webencodings"
 version = "0.5.1"
 description = "Character encoding aliases for legacy web content"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -847,4 +813,4 @@ files = [
 [metadata]
 lock-version = "2.0"
 python-versions = "^3.10"
-content-hash = "8c4d980521673d37043e12a1460f740a985e440bcf884840497e151800fc310b"
+content-hash = "2fe777808e8c397c77e06bbf5b712ef9b23bfe03a13060ae2ab54a40cb4b4f1f"
diff --git a/pyproject.toml b/pyproject.toml
index a05f183..1943a08 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -8,7 +8,7 @@ license = "MIT"
 [tool.poetry.dependencies]
 python = "^3.10"
 mkdocs = "^1.4.3"
-mkdocs-material = "^9.1.12"
+mkdocs-material = "^9.1.16"
 pillow = "^9.5.0"
 cairosvg = "^2.7.0"
 

From 5a3c2c74601af303e3f243c456a7eac701bbc6d1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 20 Jun 2023 10:47:05 +0200
Subject: [PATCH 06/39] Poetry(deps): Bump requests from 2.28.1 to 2.31.0 (#27)

Bumps [requests](https://github.com/psf/requests) from 2.28.1 to 2.31.0.
- [Release notes](https://github.com/psf/requests/releases)
- [Changelog](https://github.com/psf/requests/blob/main/HISTORY.md)
- [Commits](https://github.com/psf/requests/compare/v2.28.1...v2.31.0)

---
updated-dependencies:
- dependency-name: requests
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 poetry.lock | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 43ac75c..ddecddf 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -698,20 +698,20 @@ files = [
 
 [[package]]
 name = "requests"
-version = "2.28.1"
+version = "2.31.0"
 description = "Python HTTP for Humans."
 optional = false
-python-versions = ">=3.7, <4"
+python-versions = ">=3.7"
 files = [
-    {file = "requests-2.28.1-py3-none-any.whl", hash = "sha256:8fefa2a1a1365bf5520aac41836fbee479da67864514bdb821f31ce07ce65349"},
-    {file = "requests-2.28.1.tar.gz", hash = "sha256:7c5599b102feddaa661c826c56ab4fee28bfd17f5abca1ebbe3e7f19d7c97983"},
+    {file = "requests-2.31.0-py3-none-any.whl", hash = "sha256:58cd2187c01e70e6e26505bca751777aa9f2ee0b7f4300988b709f44e013003f"},
+    {file = "requests-2.31.0.tar.gz", hash = "sha256:942c5a758f98d790eaed1a29cb6eefc7ffb0d1cf7af05c3d2791656dbd6ad1e1"},
 ]
 
 [package.dependencies]
 certifi = ">=2017.4.17"
-charset-normalizer = ">=2,<3"
+charset-normalizer = ">=2,<4"
 idna = ">=2.5,<4"
-urllib3 = ">=1.21.1,<1.27"
+urllib3 = ">=1.21.1,<3"
 
 [package.extras]
 socks = ["PySocks (>=1.5.6,!=1.5.7)"]

From 9cf06eea5e49f483feb3fa282dcfe3154904c2c2 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Tue, 20 Jun 2023 10:47:56 +0200
Subject: [PATCH 07/39] chore(dependabot): ignore patch updates

---
 .github/dependabot.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index d9c8d81..9ccfa63 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -7,3 +7,7 @@ updates:
     commit-message:
       prefix: "Poetry"
       include: "scope"
+    ignore:
+      # ignore patch updates
+      - dependency-name: "*"
+        update-types: ["version-update:semver-patch"]

From bcd9fcd591593807cf804ebcb8030058ff169718 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Thu, 22 Jun 2023 11:10:24 +0200
Subject: [PATCH 08/39] feat(rust): add concurrency notes

---
 docs/languages/rust/rust.md | 54 +++++++++++++++++++++++++++++++++++--
 1 file changed, 52 insertions(+), 2 deletions(-)

diff --git a/docs/languages/rust/rust.md b/docs/languages/rust/rust.md
index 797431f..2d328ae 100644
--- a/docs/languages/rust/rust.md
+++ b/docs/languages/rust/rust.md
@@ -1382,8 +1382,8 @@ impl<T> Drop for CustomSmartPointer<T> {
 }
 
 fn main() {
-    let var1 = CCustomSmartPointer(value);  // dropped when var1 goes out of scope
-    let var2 = CCustomSmartPointer(value);
+    let var1 = CustomSmartPointer(value);  // dropped when var1 goes out of scope
+    let var2 = CustomSmartPointer(value);
     drop(var2);  // dropped early by using std::mem::drop
 }
 ```
@@ -1450,6 +1450,56 @@ Rust's memory safety guarantees make it difficult, but not impossible, to accide
 Rust allows memory leaks by using `Rc<T>` and `RefCell<T>`: it's possible to create references where items refer to each other in a cycle.  
 This creates memory leaks because the reference count of each item in the cycle will never reach 0, and the values will never be dropped.
 
+## Concurrency
+
+### Creating Threads
+
+The `thread::spawn` function creates a new tread that will execute the passed closure. Any data captured by the closure is _moved_ to the capturing thread.  
+The thread's **handle** can be used to wait for completion and retieve the computation result or errors if any.
+
+```rs
+// if no data is captured the move keyword can be removed
+let handle = std::thread::spawn(move || { /* ... */ });
+
+handle.join().unwrap();
+```
+
+> **Note**: a thread's execution can be termiated early if it's not joined and the main process terminates before the thread had completed it's work.  
+> **Note**: if a thread panics the handle will return the panic message so that it can be handled.
+
+### Channnels
+
+To accomplish message-sending concurrently Rust's standard library provides an implementation of _channels_.  
+A **channel** is a general programming concept by which data is sent from one thread to another.
+
+```rs
+let (sender, receiver) = std::sync::mpsc::channel();  // the sender can be cloned to create multiple transmitters
+
+let sender_1 = sender.clone();
+std::thread::spawn(move || {
+    // send takes ownership of the message (moved to receiver scope)
+    sender_1.send("hello".to_owned()).unwrap();
+});
+
+let sender_2 = sender.clone();
+std::thread::spawn(move || {
+    sender_2.send("hello".to_owned()).unwrap();
+    sender_2.send("world".to_owned()).unwrap();
+    sender_2.send("from".to_owned()).unwrap();
+    sender_2.send("thread".to_owned()).unwrap();
+});
+
+let message = receiver.recv().unwrap();  // receive a single value
+// or
+for message in receiver { } // receive multiple values (iteration stops when channel closes)
+```
+
+### `Send` & `Sync`
+
+The `Send` marker trait indicates that ownership of values of the type implementing `Send` can be transferred between threads. Any type composed entirely of `Send` types is automatically marked as `Send`.  Almost all primitive types are `Send`, aside from raw pointers.
+
+The `Sync` marker trait indicates that it is safe for the type implementing `Sync` to be referenced from multiple threads. In other words, any type `T` is `Sync` if `&T` (an immutable reference to `T`) is `Send`, meaning the reference can be sent safely to another thread. Similar to `Send`, primitive types are `Sync`, and types composed entirely of types that are `Sync `are also `Sync`.
+
 ## Files
 
 ### Reading Files

From 5e6fe8cd9824b549d9d9777f4be104beaf106bd6 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Thu, 22 Jun 2023 13:53:20 +0200
Subject: [PATCH 09/39] feat(rust): add accosited types notes

---
 docs/languages/rust/rust.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/languages/rust/rust.md b/docs/languages/rust/rust.md
index 2d328ae..543b814 100644
--- a/docs/languages/rust/rust.md
+++ b/docs/languages/rust/rust.md
@@ -815,6 +815,29 @@ fn generic<T: Trait>() -> Type { }  // use generic constraint
 
 > **Note**: the calling code needs to import your new trait in addition to the external type
 
+### Associated Types
+
+_Associated types_ connect a type placeholder with a trait such that the trait method definitions can use these placeholder types in their signatures.  
+The implementor of a trait will specify the concrete type to be used instead of the placeholder type for the particular implementation.
+
+```rs
+trait Iterator {
+    type Item;
+
+    fn next(&mut self) -> Option<Self::Item>;
+}
+```
+
+The type `Item` is a placeholder, and the next method’s definition shows that it will return values of type `Option<Self::Item>`. Implementors of the `Iterator` trait will specify the concrete type for `Item`, and the next method will return an `Option` containing a value of that concrete type.
+
+### Generic Traits vs Associted Types
+
+The difference is that when a trait has a generic parameter, it can be implemented for a type multiple times, changing the concrete types of the generic type parameters each time.  
+With associated types, it's not possible to implement the trait multiple times so annotations are not needed.
+
+Associated types also become part of the trait’s contract: implementors of the trait must provide a type to stand in for the associated type placeholder.  
+Associated types often have a name that describes how the type will be used, and documenting the associated type in the API documentation is good practice.
+
 ### Trait Objects
 
 A *reference* to a trait is called a **Trait Object**. Like any other reference, a trait object points to some value, it has a lifetime, and it can be either mut or shared.  

From 97b9204c8c560d36dee5bfe8947993c6be172d2c Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Thu, 22 Jun 2023 14:03:19 +0200
Subject: [PATCH 10/39] feat(mkdocs): add search plugin

---
 mkdocs.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/mkdocs.yml b/mkdocs.yml
index bbcea4d..e4d1c36 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -19,8 +19,9 @@ extra:
       link: https://github.com/m-lamonaca
 
 plugins:
+  - search
   - social:
-      cards_font: JetBrains Mono
+     cards_font: JetBrains Mono
 
 
 theme:

From b38cee7091c90cf613ee5bbbb39d48decaa4807d Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Sat, 24 Jun 2023 23:53:21 +0200
Subject: [PATCH 11/39] feat(docker): add `Dockerfile`

---
 Dockerfile | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 Dockerfile

diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..ba96af8
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,29 @@
+FROM python:3.11-bookworm as pre-build
+
+ENV POETRY_HOME=/opt/poetry
+RUN curl -sSL https://install.python-poetry.org | python3 -
+
+FROM pre-build as build
+
+WORKDIR /app
+
+COPY ./pyproject.toml ./
+COPY ./poetry.lock ./
+
+RUN $POETRY_HOME/bin/poetry install
+
+COPY ./mkdocs.yml ./
+COPY ./docs ./docs
+COPY ./README.md ./docs/README.md
+
+RUN $POETRY_HOME/bin/poetry run mkdocs build
+
+
+FROM python:3.11-alpine as runtime
+
+WORKDIR /app
+
+COPY --from=build ./app/site ./
+
+ENTRYPOINT [ "python3" ]
+CMD [ "-m", "http.server", "8000" ]
\ No newline at end of file

From 8623a82b923327b3a29f5222ae95c9af5bd3632a Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Mon, 26 Jun 2023 11:38:33 +0200
Subject: [PATCH 12/39] feat(docker): add `exec` notes & rework `CMD` and
 `ENTRYPOINT` notes

---
 docs/containers/docker.md | 40 ++++++---------------------------------
 1 file changed, 6 insertions(+), 34 deletions(-)

diff --git a/docs/containers/docker.md b/docs/containers/docker.md
index 1b5b404..51b6258 100644
--- a/docs/containers/docker.md
+++ b/docs/containers/docker.md
@@ -86,12 +86,13 @@ docker container ls -a|--all  # list of all containers, running and exited
 docker container rm <container>  # remove one or more containers
 docker container prune  # remove stopped containers
 
-
 docker container inspect <container>  # full details about a container
 docker container logs <container>  # see container logs
 
 docker container stop <container>  # stop a running container
 docker container start <container>  # start a stopped container
+
+docker container exec <container> <command>  # exec a command inside a container
 ```
 
 ### [`docker image`](https://docs.docker.com/engine/reference/commandline/image/)
@@ -146,41 +147,12 @@ CMD <executable> <arg1> <arg2>
 ENTRYPOINT <executable> <arg1> <arg2>
 ```
 
-### `CMD`
+### `CMD` vs `ENTRYPOINT`
 
-Used to provide all the default scenarios which can be overridden.
+`CMD` is used to provide all the default scenarios which can be overridden. _Anything_ defined in CMD can be overridden by passing arguments in `docker run` command.
 
-#### Default executable
-
-This instructions is used to define a default executable for a container to execute.
-
-If you want to create a generic docker image, where users can pass any supported command to be executed on container invocation, then this instruction is the one to use.
-
-Entrypoint instruction should not be defined in Dockerfile for this use case.
-
-```docker
-CMD ["executable", "arg1", "arg2"]
-```
-
-#### Default arguments
-
-For this use case, we don’t specify executable in this instruction at all, but simply define some arguments which are used as default/additional
-arguments for executable defined in the entrypoint instruction.
-
-Thus, entrypoint instruction is required in dockerfile for this use case to define an executable.
-
-```docker
-ENTRYPOINT ["executable"]
-CMD ["arg1", "arg2"]
-```
-
-> **Note**: Anything defined in CMD can be overridden by passing arguments in `docker run` command.
-
-### `ENTRYPOINT`
-
-Used to define specific executable and arguments to be executed during container invocation which cannot be overridden.
-
-This is used to constraint the user to execute anything else. User can however define arguments to be passed in the executable by adding them in the `docker run` command.
+`ENTRYPOINT` is used to define a specific executable (and it's arguments) to be executed during container invocation which cannot be overridden.  
+The user can however define arguments to be passed in the executable by adding them in the `docker run` command.
 
 ## [Docker Multi-Stage Build](https://docs.docker.com/develop/develop-images/multistage-build/)
 

From 19cb7961f73f1a226f7f30ece18114a900a2b832 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Wed, 28 Jun 2023 11:51:24 +0200
Subject: [PATCH 13/39] chore(dotnet): rework asp.net notes

---
 .../dotnet/asp.net/app-configuration.md       | 244 -----------------
 docs/languages/dotnet/asp.net/blazor.md       | 210 +-------------
 docs/languages/dotnet/asp.net/filters.md      |  99 +++++--
 docs/languages/dotnet/asp.net/middleware.md   | 156 +++++------
 docs/languages/dotnet/asp.net/minimal-api.md  | 145 ++++++----
 docs/languages/dotnet/asp.net/mvc.md          | 259 ------------------
 docs/languages/dotnet/asp.net/razor-pages.md  | 236 ----------------
 docs/languages/dotnet/asp.net/rest-api.md     |  53 ----
 docs/languages/dotnet/asp.net/signalr.md      |  33 +--
 docs/languages/dotnet/asp.net/web-forms.md    |  22 +-
 mkdocs.yml                                    |   7 +-
 11 files changed, 249 insertions(+), 1215 deletions(-)
 delete mode 100644 docs/languages/dotnet/asp.net/app-configuration.md
 delete mode 100644 docs/languages/dotnet/asp.net/mvc.md
 delete mode 100644 docs/languages/dotnet/asp.net/razor-pages.md
 delete mode 100644 docs/languages/dotnet/asp.net/rest-api.md

diff --git a/docs/languages/dotnet/asp.net/app-configuration.md b/docs/languages/dotnet/asp.net/app-configuration.md
deleted file mode 100644
index 35672f9..0000000
--- a/docs/languages/dotnet/asp.net/app-configuration.md
+++ /dev/null
@@ -1,244 +0,0 @@
-# ASP.NET Configuration
-
-## `.csproj`
-
-```xml
-<PropertyGroup>
-  <!-- enable documentation comments (can be used for swagger) -->
-  <GenerateDocumentationFile>true</GenerateDocumentationFile>
-
-  <!-- do not warn public classes w/o documentation comments -->
-  <NoWarn>$(NoWarn);1591</NoWarn>
-</PropertyGroup>
-```
-
-## `Program.cs`
-
-```cs
-using Microsoft.AspNetCore.Hosting;
-using Microsoft.Extensions.Hosting;
-
-namespace App
-{
-    public class Program
-    {
-        public static void Main(string[] args)
-        {
-            CreateHostBuilder(args).Build().Run();  // start and config ASP.NET Core App
-
-            // or start Blazor WASM Single Page App
-            var builder = WebAssemblyHostBuilder.CreateDefault(args);
-            builder.RootComponents.Add<App>("#app");
-
-            builder.Services.AddScoped(sp => new HttpClient { BaseAddress = new Uri(builder.HostEnvironment.BaseAddress) });
-
-            await builder.Build().RunAsync();
-        }
-
-        // for MVC, Razor Pages and Blazor Server
-        public static IHostBuilder CreateHostBuilder(string[] args) =>
-            Host.CreateDefaultBuilder(args)
-                .ConfigureWebHostDefaults(webBuilder =>
-                {
-                    webBuilder.UseStartup<Startup>();  // config handled in Startup.cs
-                });
-    }
-}
-```
-
-## `Startup.cs`
-
-```cs
-using Microsoft.AspNetCore.Builder;
-using Microsoft.AspNetCore.Hosting;
-using Microsoft.AspNetCore.HttpsPolicy;
-using Microsoft.Extensions.Configuration;
-using Microsoft.Extensions.DependencyInjection;
-using Microsoft.Extensions.Hosting;
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Threading.Tasks;
-
-namespace App
-{
-    public class Startup
-    {
-        public Startup(IConfiguration configuration)
-        {
-            Configuration = configuration;
-        }
-
-        public IConfiguration Configuration { get; }
-
-        // This method gets called by the runtime. Use this method to add services to the DI container.
-        public void ConfigureServices(IServiceCollection services)
-        {
-            // set db context for the app using the connection string
-            services.AddDbContext<AppDbContext>(options => options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));
-
-            // Captures synchronous and asynchronous Exception instances from the pipeline and generates HTML error responses.
-            services.AddDatabaseDeveloperPageExceptionFilter();
-
-            // use Razor Pages, runtime compilation needs Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation pkg
-            services.AddRazorPages().AddRazorRuntimeCompilation();
-            // or
-            services.AddControllers();  // controllers w/o views
-            //or
-            services.AddControllersWithViews();  // MVC Controllers
-            //or
-            services.AddServerSideBlazor();  // needs Razor Pages
-
-            services.AddSignalR();
-
-            // set dependency injection lifetimes
-            services.AddSingleton<ITransientService, ServiceImplementation>();
-            services.AddScoped<ITransientService, ServiceImplementation>();
-            services.AddTransient<ITransientService, ServiceImplementation>();
-
-            // add swagger
-            services.AddSwaggerGen(options => {
-
-                // OPTIONAL: use xml comments for swagger documentation
-                var xmlFilename = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
-                options.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, xmlFilename));
-            });
-
-        }
-
-        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
-        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
-        {
-            if (env.IsDevelopment())
-            {
-                app.UseDeveloperExceptionPage();
-            }
-            else
-            {
-                app.UseExceptionHandler("/Home/Error");
-                // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
-                app.UseHsts();
-            }
-
-            app.UseHttpsRedirection();
-            app.UseStaticFiles();
-
-            app.UseRouting();
-
-            app.UseAuthorization();
-
-            app.UseSwagger();
-            app.UseSwaggerUI();
-
-            app.UseEndpoints(endpoints =>
-            {
-                // MVC routing
-                endpoints.MapControllerRoute(
-                    name: "default",
-                    pattern: "{controller=Home}/{action=Index}/{id?}"
-                );
-                // or
-                endpoints.MapControllers();  // map controllers w/o views
-                // or
-                endpoints.MapRazorPages();
-                // or
-                endpoints.MapBlazorHub();  // SignalR Hub for Blazor Server
-
-                endpoints.MapHub("/hub/endpoint");  // SignalR Hub
-                endpoints.MapFallbackToPage("/_Host");  // fallback for razor server
-            });
-        }
-    }
-}
-```
-
-## Application Settings
-
-App settings are loaded (in order) from:
-
-1. `appsettings.json`
-2. `appsettings.<Environment>.json`
-3. User Secrets
-
-The environment is controlled by the env var `ASPNETCORE_ENVIRONMENT`. If a setting is present in multiple locations, the last one is used and overrides the previous ones.
-
-### User Secrets
-
-User secrets are specific to each machine and can be initialized with `dotnet user-secrets init`. Each application is linked with it's settings by a guid.
-
-The settings are stored in:
-
-- `%APPDATA%\Microsoft\UserSecrets\<user_secrets_id>\secrets.json` (Windows)
-- `~/.microsoft/usersecrets/<user_secrets_id>/secrets.json` (Linux/macOS)
-
-Setting a value is done with `dotnet user-secrets set <key> <value>`, keys can be nested by separating each level with `:` or `__`.
-
-## Options Pattern
-
-The *options pattern* uses classes to provide strongly-typed access to groups of related settings.
-
-```json
-{
-    "SecretKey": "Secret key value",
-    "TransientFaultHandlingOptions": {
-        "Enabled": true,
-        "AutoRetryDelay": "00:00:07"
-    },
-    "Logging": {
-        "LogLevel": {
-            "Default": "Information",
-            "Microsoft": "Warning",
-            "Microsoft.Hosting.Lifetime": "Information"
-        }
-    }
-}
-```
-
-```cs
-// options model for binding
-public class TransientFaultHandlingOptions
-{
-    public bool Enabled { get; set; }
-    public TimeSpan AutoRetryDelay { get; set; }
-}
-```
-
-```cs
-// setup the options
-builder.Services.Configure<TransientFaultHandlingOptions>(builder.Configuration.GetSection<TransientFaultHandlingOptions>(nameof(Options)));
-builder.Services.Configure<TransientFaultHandlingOptions>(builder.Configuration.GetSection<TransientFaultHandlingOptions>(key));
-```
-
-```cs
-class DependsOnOptions
-{
-  private readonly IOptions<TransientFaultHandlingOptions> _options;
-
-  public DependsOnOptions(IOptions<TransientFaultHandlingOptions> options) => _options = options;
-}
-```
-
-### [Options interfaces](https://docs.microsoft.com/en-us/dotnet/core/extensions/options#options-interfaces)
-
-`IOptions<TOptions>`:
-
-- Does not support:
-  - Reading of configuration data after the app has started.
-  - Named options
-- Is registered as a Singleton and can be injected into any service lifetime.
-
-`IOptionsSnapshot<TOptions>`:
-
-- Is useful in scenarios where options should be recomputed on every injection resolution, in scoped or transient lifetimes.
-- Is registered as Scoped and therefore cannot be injected into a Singleton service.
-- Supports named options
-
-`IOptionsMonitor<TOptions>`:
-
-- Is used to retrieve options and manage options notifications for `TOptions` instances.
-- Is registered as a Singleton and can be injected into any service lifetime.
-- Supports:
-  - Change notifications
-  - Named options
-  - Reloadable configuration
-  - Selective options invalidation (`IOptionsMonitorCache<TOptions>`)
diff --git a/docs/languages/dotnet/asp.net/blazor.md b/docs/languages/dotnet/asp.net/blazor.md
index c2f1bb4..f12f55a 100644
--- a/docs/languages/dotnet/asp.net/blazor.md
+++ b/docs/languages/dotnet/asp.net/blazor.md
@@ -14,212 +14,6 @@ Components are .NET C# classes built into .NET assemblies that:
 
 The component class is usually written in the form of a Razor markup page with a `.razor` file extension. Components in Blazor are formally referred to as *Razor components*.
 
-## Project Structure & Important Files
-
-### Blazor Server Project Structure
-
-```txt
-Project
-|-Properties
-| |- launchSettings.json
-|
-|-wwwroot --> static files
-| |-css
-| | |- site.css
-| | |- bootstrap
-| |
-| |- favicon.ico
-|
-|-Pages
-| |- _Host.cshtml  --> fallback page
-| |- Component.razor
-| |- Index.razor
-| |- ...
-|
-|-Shared
-| |- MainLayout.razor
-| |- MainLayout.razor.css
-| |- ...
-|
-|- _Imports.razor --> @using imports
-|- App.razor --> component root of the app
-|
-|- appsettings.json --> application settings
-|- Program.cs --> App entry-point
-|- Startup.cs --> services and middleware configs
-```
-
-### Blazor WASM Project Structure
-
-```txt
-Project
-|-Properties
-| |- launchSettings.json
-|
-|-wwwroot --> static files
-| |-css
-| | |- site.css
-| | |- bootstrap
-| |
-| |- index.html
-| |- favicon.ico
-|
-|-Pages
-| |- Component.razor
-| |- Index.razor
-| |- ...
-|
-|-Shared
-| |- MainLayout.razor
-| |- MainLayout.razor.css
-| |- ...
-|
-|- _Imports.razor --> @using imports
-|- App.razor --> component root of the app
-|
-|- appsettings.json --> application settings
-|- Program.cs --> App entry-point
-```
-
-### Blazor PWA Project Structure
-
-```txt
-Project
-|-Properties
-| |- launchSettings.json
-|
-|-wwwroot --> static files
-| |-css
-| | |- site.css
-| | |- bootstrap
-| |
-| |- index.html
-| |- favicon.ico
-| |- manifest.json
-| |- service-worker.js
-| |- icon-512.png
-|
-|-Pages
-| |- Component.razor
-| |- Index.razor
-| |- ...
-|
-|-Shared
-| |- MainLayout.razor
-| |- MainLayout.razor.css
-| |- ...
-|
-|- _Imports.razor --> @using imports
-|- App.razor --> component root of the app
-|
-|- appsettings.json --> application settings
-|- Program.cs --> App entrypoint
-```
-
-### `manifest.json`, `service-worker.js` (Blazor PWA)
-
-[PWA](https://web.dev/progressive-web-apps/)  
-[PWA MDN Docs](https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps)  
-[PWA Manifest](https://developer.mozilla.org/en-US/docs/Web/Manifest)  
-[Service Worker API](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API)
-
-```json
-// manifest.json
-{
-  "name": "<App Name>",
-  "short_name": "<Short App Name>",
-  "start_url": "./",
-  "display": "standalone",
-  "background_color": "#ffffff",
-  "theme_color": "#03173d",
-  "icons": [
-    {
-      "src": "icon-512.png",
-      "type": "image/png",
-      "sizes": "512x512"
-    }
-  ]
-}
-```
-
-## Common Blazor Files
-
-### `App.razor`
-
-```cs
-<Router AppAssembly="@typeof(Program).Assembly" PreferExactMatches="@true">
-    <Found Context="routeData">
-        <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
-    </Found>
-    <NotFound>
-        <LayoutView Layout="@typeof(MainLayout)">
-            <p>Sorry, there's nothing at this address.</p>
-        </LayoutView>
-    </NotFound>
-</Router>
-```
-
-### `MainLayout.razor` (Blazor Server/WASM)
-
-```cs
-@inherits LayoutComponentBase
-
-<div class="page">
-    <div class="sidebar">
-        <NavMenu />  // NavMenu Component
-    </div>
-
-    <div class="main">
-        <div class="top-row px-4">
-        </div>
-
-        <div class="content px-4">
-            @Body
-        </div>
-    </div>
-</div>
-```
-
-### `_Host.cshtml` (Blazor Server)
-
-```html
-@page "/"
-@namespace BlazorServerDemo.Pages
-@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
-@{
-    Layout = null;
-}
-
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>BlazorServerDemo</title>
-    <base href="~/" />
-    <link rel="stylesheet" href="css/bootstrap/bootstrap.min.css" />
-    <link href="css/site.css" rel="stylesheet" />
-    <link href="BlazorServerDemo.styles.css" rel="stylesheet" />
-</head>
-<body>
-    <component type="typeof(App)" render-mode="ServerPrerendered" />
-
-    <div id="blazor-error-ui">
-        <environment include="Staging,Production">
-            An error has occurred. This application may no longer respond until reloaded.
-        </environment>
-        <environment include="Development">
-            An unhandled exception has occurred. See browser dev tools for details.
-        </environment>
-        <a href="" class="reload">Reload</a>
-        <a class="dismiss">🗙</a>
-    </div>
-
-    <script src="_framework/blazor.server.js"></script>
-</body>
-</html>
-```
-
 ## Components (`.razor`)
 
 [Blazor Components](https://docs.microsoft.com/en-us/aspnet/core/blazor/components/)
@@ -401,7 +195,7 @@ public class StateContainer
 [Call Javascript from .NET](https://docs.microsoft.com/en-us/aspnet/core/blazor/call-javascript-from-dotnet)  
 [Call .NET from Javascript](https://docs.microsoft.com/en-us/aspnet/core/blazor/call-dotnet-from-javascript)
 
-### Render Blazor components from JavaScript [C# 10]
+### Render Blazor components from JavaScript
 
 To render a Blazor component from JavaScript, first register it as a root component for JavaScript rendering and assign it an identifier:
 
@@ -423,7 +217,7 @@ let containerElement = document.getElementById('my-counter');
 await Blazor.rootComponents.add(containerElement, 'counter', { incrementAmount: 10 });
 ```
 
-### Blazor custom elements [C# 10]
+### Blazor custom elements
 
 Experimental support is also now available for building custom elements with Blazor using the Microsoft.AspNetCore.Components.CustomElements NuGet package.  
 Custom elements use standard HTML interfaces to implement custom HTML elements.
diff --git a/docs/languages/dotnet/asp.net/filters.md b/docs/languages/dotnet/asp.net/filters.md
index e327cea..f9af4fe 100644
--- a/docs/languages/dotnet/asp.net/filters.md
+++ b/docs/languages/dotnet/asp.net/filters.md
@@ -42,6 +42,33 @@ Asynchronous filters define an `On-Stage-ExecutionAsync` method, for example `On
 
 Interfaces for multiple filter stages can be implemented in a single class.
 
+```cs
+public class SampleActionFilter : IActionFilter
+{
+    public void OnActionExecuting(ActionExecutingContext context)
+    {
+        // Do something before the action executes.
+    }
+
+    public void OnActionExecuted(ActionExecutedContext context)
+    {
+        // Do something after the action executes.
+    }
+}
+
+
+public class SampleAsyncActionFilter : IAsyncActionFilter
+{
+    public async Task OnActionExecutionAsync(
+        ActionExecutingContext context, ActionExecutionDelegate next)
+    {
+        // Do something before the action executes.
+        await next();
+        // Do something after the action executes.
+    }
+}
+```
+
 ## **Built-in filter attributes**
 
 ASP.NET Core includes built-in _attribute-based_ filters that can be subclassed and customized.
@@ -63,38 +90,34 @@ A filter can be added to the pipeline at one of three *scopes*:
 - Using an attribute on a controller action. Filter attributes cannot be applied to Razor Pages handler methods.
 
 ```cs
-// services.AddScoped<CustomActionFilterAttribute>();
+services.AddScoped<CustomActionFilterAttribute>();
+
 [ServiceFilter(typeof(CustomActionFilterAttribute))]
-public IActionResult Index()
+public IActionResult Action()
 {
-    return Content("Header values by configuration.");
+    return Ok();
 }
 ```
 
 - Using an attribute on a controller or Razor Page.
 
 ```cs
-// services.AddControllersWithViews(options => { options.Filters.Add(new CustomResponseFilterAttribute(args)); });
+services.AddControllersWithViews(options => { 
+    options.Filters.Add(new CustomResponseFilterAttribute(args)); 
+});
+
+
 [CustomResponseFilterAttribute(args)]
 public class SampleController : Controller
-
-// or
-
-[CustomResponseFilterAttribute(args)]
-[ServiceFilter(typeof(CustomActionFilterAttribute))]
-public class IndexModel : PageModel
 ```
 
 - Globally for all controllers, actions, and Razor Pages.
 
 ```cs
-public void ConfigureServices(IServiceCollection services)
+builder.Services.AddControllersWithViews(options =>
 {
-    services.AddControllersWithViews(options =>
-   {
-        options.Filters.Add(typeof(CustomActionFilter));
-    });
-}
+    options.Filters.Add(typeof(CustomActionFilter));
+});
 ```
 
 ## Filter Order of Execution
@@ -130,3 +153,47 @@ public class ShortCircuitingResourceFilterAttribute : Attribute, IResourceFilter
     }
 }
 ```
+
+## Dependency Injection
+
+Filters can be added _by type_ or _by instance_. If an instance is added, that instance is used for every request. If a type is added, it's type-activated. 
+
+A type-activated filter means:
+
+- An instance is created for each request.
+- Any constructor dependencies are populated by dependency injection (DI).
+
+Filters that are implemented as attributes and added directly to controller classes or action methods cannot have constructor dependencies provided by dependency injection (DI). Constructor dependencies cannot be provided by DI because attributes must have their constructor parameters supplied where they're applied.
+
+The following filters support constructor dependencies provided from DI:
+
+- ServiceFilterAttribute
+- TypeFilterAttribute
+- IFilterFactory implemented on the attribute.
+
+### [`ServiceFilterAttribute`][service-filter-attribute]
+
+```cs
+builder.Services.AddScoped<CustomFilterFromDI>();
+
+public class CustomFilterFromDI : IResultFilter
+{
+    private readonly ILogger _logger;
+
+    public CustomFilterFromDI(ILogger logger) =>  _logger = logger;
+
+    public void OnResultExecuting(ResultExecutingContext context)
+    {
+    }
+
+    public void OnResultExecuted(ResultExecutedContext context)
+    {
+    }
+}
+
+[ServiceFilter(typeof(CustomFilterFromDI))]
+public IActionResult Action() => OK();
+```
+
+<!--links -->
+[service-filter-attribute]: https://learn.microsoft.com/en-us/aspnet/core/mvc/controllers/filters?view=aspnetcore-7.0#servicefilterattribute "ServiceFilterAttribute Docs"
diff --git a/docs/languages/dotnet/asp.net/middleware.md b/docs/languages/dotnet/asp.net/middleware.md
index cb127f3..9772fc1 100644
--- a/docs/languages/dotnet/asp.net/middleware.md
+++ b/docs/languages/dotnet/asp.net/middleware.md
@@ -34,42 +34,30 @@ Short-circuiting is often desirable because it avoids unnecessary work.
 It's possible to perform actions both *before* and *after* the next delegate:
 
 ```cs
-public class Startup
+// "inline" middleware, best if in own class
+app.Use(async (context, next) =>
 {
-    public void Configure(IApplicationBuilder app)
-    {
-        // "inline" middleware, best if in own class
-        app.Use(async (context, next) =>
-        {
-            // Do work that doesn't write to the Response.
-            await next.Invoke();
-            // Do logging or other work that doesn't write to the Response.
-        });
-    }
-}
+    // Do work that doesn't write to the Response.
+    await next.Invoke();
+    // Do logging or other work that doesn't write to the Response.
+});
 ```
 
 `Run` delegates don't receive a next parameter. The first `Run` delegate is always terminal and terminates the pipeline.
 
 ```cs
-public class Startup
+// "inline" middleware, best if in own class
+app.Use(async (context, next) =>
 {
-    public void Configure(IApplicationBuilder app)
-    {
-        // "inline" middleware, best if in own class
-        app.Use(async (context, next) =>
-        {
-            // Do work that doesn't write to the Response.
-            await next.Invoke();
-            // Do logging or other work that doesn't write to the Response.
-        });
+    // Do work that doesn't write to the Response.
+    await next.Invoke();
+    // Do logging or other work that doesn't write to the Response.
+});
 
-        app.Run(async context =>
-        {
-            // no invocation of next
-        });
-    }
-}
+app.Run(async context =>
+{
+    // no invocation of next
+});
 ```
 
 ## Middleware Order
@@ -82,41 +70,36 @@ The Endpoint middleware executes the filter pipeline for the corresponding app t
 The order that middleware components are added in the `Startup.Configure` method defines the order in which the middleware components are invoked on requests and the reverse order for the response. The order is **critical** for security, performance, and functionality.
 
 ```cs
-public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
+if (env.IsDevelopment())
 {
-    if (env.IsDevelopment())
-    {
-        app.UseDeveloperExceptionPage();
-        app.UseDatabaseErrorPage();
-    }
-    else
-    {
-        app.UseExceptionHandler("/Error");
-        app.UseHsts();
-    }
-
-    app.UseHttpsRedirection();
-    app.UseStaticFiles();
-    // app.UseCookiePolicy();
-
-    app.UseRouting();
-    // app.UseRequestLocalization();
-    // app.UseCors();
-
-    app.UseAuthentication();
-    app.UseAuthorization();
-    // app.UseSession();
-    // app.UseResponseCompression();
-    // app.UseResponseCaching();
-
-    app.UseEndpoints(endpoints =>
-    {
-        endpoints.MapRazorPages();
-        endpoints.MapControllerRoute(
-            name: "default",
-            pattern: "{controller=Home}/{action=Index}/{id?}");
-    });
+    app.UseDeveloperExceptionPage();
+    app.UseDatabaseErrorPage();
 }
+else
+{
+    app.UseExceptionHandler("/Error");
+    app.UseHsts();
+}
+
+app.UseHttpsRedirection();
+app.UseStaticFiles();
+app.UseCookiePolicy();
+
+app.UseRouting();
+app.UseRequestLocalization();
+app.UseCors();
+
+app.UseAuthentication();
+app.UseAuthorization();
+app.UseSession();
+app.UseResponseCompression();
+app.UseResponseCaching();
+
+app.UseEndpoints(endpoints =>
+{
+    endpoints.MapRazorPages();
+    endpoints.MapControllers();
+});
 ```
 
 [Built-in Middleware](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/middleware/#built-in-middleware)
@@ -139,27 +122,20 @@ Unlike with `MapWhen`, this branch is rejoined to the main pipeline if it doesn'
 Middleware is generally encapsulated in a class and exposed with an extension method.
 
 ```cs
-using Microsoft.AspNetCore.Http;
-using System.Globalization;
-using System.Threading.Tasks;
-
-namespace <App>
+public class CustomMiddleware
 {
-    public class CustomMiddleware
+    private readonly RequestDelegate _next;
+
+    public CustomMiddleware(RequestDelegate next)
     {
-        private readonly RequestDelegate _next;
+        _next = next;
+    }
 
-        public CustomMiddleware(RequestDelegate next)
-        {
-            _next = next;
-        }
-
-        public async Task InvokeAsync(HttpContext context)
-        {
-            // Do work that doesn't write to the Response.
-            await _next(context);  // Call the next delegate/middleware in the pipeline
-            // Do logging or other work that doesn't write to the Response.
-        }
+    public async Task InvokeAsync(HttpContext context)
+    {
+        // Do work that doesn't write to the Response.
+        await _next(context);  // Call the next delegate/middleware in the pipeline
+        // Do logging or other work that doesn't write to the Response.
     }
 }
 ```
@@ -179,29 +155,19 @@ The middleware class **must** include:
 ```cs
 using Microsoft.AspNetCore.Builder;
 
-namespace <App>
+public static class MiddlewareExtensions
 {
-    public static class MiddlewareExtensions
+    public static IApplicationBuilder UseCustom(this IApplicationBuilder builder)
     {
-        public static IApplicationBuilder UseCustom(this IApplicationBuilder builder)
-        {
-            return builder.UseMiddleware<CustomMiddleware>();
-        }
+        return builder.UseMiddleware<CustomMiddleware>();
     }
 }
 ```
 
 ```cs
-// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
-public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
-{
-    // other middlewares
+// other middlewares
 
-    app.UseCustom();  // add custom middleware in the pipeline
+app.UseCustom();  // add custom middleware in the pipeline
 
-    app.UseEndpoints(endpoints =>
-    {
-        endpoints.MapControllers();
-    });
-}
+app.UseEndpoints(endpoints => endpoints.MapControllers());
 ```
diff --git a/docs/languages/dotnet/asp.net/minimal-api.md b/docs/languages/dotnet/asp.net/minimal-api.md
index 8049393..434cd23 100644
--- a/docs/languages/dotnet/asp.net/minimal-api.md
+++ b/docs/languages/dotnet/asp.net/minimal-api.md
@@ -18,6 +18,28 @@ app.Run();
 app.RunAsync();
 ```
 
+
+## Application Settings
+
+App settings are loaded (in order) from:
+
+1. `appsettings.json`
+2. `appsettings.<Environment>.json`
+3. User Secrets
+
+The environment is controlled by the env var `ASPNETCORE_ENVIRONMENT`. If a setting is present in multiple locations, the last one is used and overrides the previous ones.
+
+### User Secrets
+
+User secrets are specific to each machine and can be initialized with `dotnet user-secrets init`. Each application is linked with it's settings by a guid.
+
+The settings are stored in:
+
+- `%APPDATA%\Microsoft\UserSecrets\<user_secrets_id>\secrets.json` (Windows)
+- `~/.microsoft/usersecrets/<user_secrets_id>/secrets.json` (Linux/macOS)
+
+Setting a value is done with `dotnet user-secrets set <key> <value>`, keys can be nested by separating each level with `:` or `__`.
+
 ## Swagger
 
 ```cs
@@ -63,6 +85,8 @@ app.UseRouting();
 
 app.UseAuthorization();
 
+app.MapControllers();
+// or
 app.MapControllerRoute(
     name: "default",
     pattern: "{controller=Home}/{action=Index}/{id?}");
@@ -325,63 +349,72 @@ class CustomCachePolicy : IOutputCachePolicy
 }
 ```
 
-## Output Caching
+## Options Pattern
 
-```cs
-builder.Services.AddOutputCaching();  // no special options
-builder.Services.AddOutputCaching(options => 
+The *options pattern* uses classes to provide strongly-typed access to groups of related settings.
+
+```json
 {
-    options => options.AddBasePolicy(x => x.NoCache())  // no cache policy
-
-    Func<OutputCacheContext, bool> predicate = /* discriminate requests */
-    options.AddBasePolicy(x => x.With(predicate).CachePolicy());
-    options.AddBasePolicy("<policy-name>", x => x.CachePolicy());  // named policy
-});
-
-// [...]
-
-app.UseOutputCaching();  // following middlewares can use output cache
-
-// [...]
-
-app.MapGet("/<route>", RouteHandler).CacheOutput();  // cache forever
-app.MapGet("/<route>", RouteHandler).CacheOutput().Expire(timespan);
-
-app.MapGet("/<route>", RouteHandler).CacheOutput(x => x.CachePolicy());
-app.MapGet("/<route>", RouteHandler).CacheOutput("<policy-name>");
-
-app.MapGet("/<route>", RouteHandler).CacheOutput(x => x.VaryByHeader(/* headers list */));
-app.MapGet("/<route>", RouteHandler).CacheOutput(x => x.VaryByQuery(/* query key */));
-app.MapGet("/<route>", RouteHandler).CacheOutput(x => x.VaryByValue());
-
-app.MapGet("/<route>", [OutputCache(/* options */)]RouteHandler);
-```
-
-### Cache Eviction
-
-```cs
-
-app.MapGet("/<route-one>", RouteHandler).CacheOutput(x => x.Tag("<tag>"));  // tag cache portion
-
-app.MapGet("/<route-two>", (IOutputCacheStore cache, CancellationToken token) => 
-{
-    await cache.EvictByTag("<tag>", token);  // invalidate a portion of the cache
-});
-```
-
-### Custom Cache Policy
-
-```cs
-app.MapGet("/<route-one>", RouteHandler).CacheOutput(x => x.AddCachePolicy<CustomCachePolicy>());
-```
-
-```cs
-class CustomCachePolicy : IOutputCachePolicy
-{
-    public ValueTask CacheRequestAsync(OutputCacheContext context, CancellationToken cancellationToken) { }
-
-    public ValueTask ServeFromCacheAsync(OutputCacheContext context, CancellationToken cancellationToken) { }
-
-    public ValueTask ServeResponseAsync(OutputCacheContext context, CancellationToken cancellationToken) { }
+    "SecretKey": "Secret key value",
+    "TransientFaultHandlingOptions": {
+        "Enabled": true,
+        "AutoRetryDelay": "00:00:07"
+    },
+    "Logging": {
+        "LogLevel": {
+            "Default": "Information",
+            "Microsoft": "Warning",
+            "Microsoft.Hosting.Lifetime": "Information"
+        }
+    }
 }
 ```
+
+```cs
+// options model for binding
+public class TransientFaultHandlingOptions
+{
+    public bool Enabled { get; set; }
+    public TimeSpan AutoRetryDelay { get; set; }
+}
+```
+
+```cs
+// setup the options
+builder.Services.Configure<TransientFaultHandlingOptions>(builder.Configuration.GetSection<TransientFaultHandlingOptions>(nameof(Options)));
+builder.Services.Configure<TransientFaultHandlingOptions>(builder.Configuration.GetSection<TransientFaultHandlingOptions>(key));
+```
+
+```cs
+class DependsOnOptions
+{
+  private readonly IOptions<TransientFaultHandlingOptions> _options;
+
+  public DependsOnOptions(IOptions<TransientFaultHandlingOptions> options) => _options = options;
+}
+```
+
+### [Options interfaces](https://docs.microsoft.com/en-us/dotnet/core/extensions/options#options-interfaces)
+
+`IOptions<TOptions>`:
+
+- Does not support:
+  - Reading of configuration data after the app has started.
+  - Named options
+- Is registered as a Singleton and can be injected into any service lifetime.
+
+`IOptionsSnapshot<TOptions>`:
+
+- Is useful in scenarios where options should be recomputed on every injection resolution, in scoped or transient lifetimes.
+- Is registered as Scoped and therefore cannot be injected into a Singleton service.
+- Supports named options
+
+`IOptionsMonitor<TOptions>`:
+
+- Is used to retrieve options and manage options notifications for `TOptions` instances.
+- Is registered as a Singleton and can be injected into any service lifetime.
+- Supports:
+  - Change notifications
+  - Named options
+  - Reloadable configuration
+  - Selective options invalidation (`IOptionsMonitorCache<TOptions>`)
diff --git a/docs/languages/dotnet/asp.net/mvc.md b/docs/languages/dotnet/asp.net/mvc.md
deleted file mode 100644
index 76ee930..0000000
--- a/docs/languages/dotnet/asp.net/mvc.md
+++ /dev/null
@@ -1,259 +0,0 @@
-# ASP.NET (Core) MVC Web App
-
-## Project Structure
-
-```txt
-Project
-|-Properties
-| |- launchSettings.json
-|
-|-wwwroot  --> location of static files
-| |-css
-| | |- site.css
-| |
-| |-js
-| | |- site.js
-| |
-| |-lib
-| | |- bootstrap
-| | |- jquery
-| | |- ...
-| |
-| |- favicon.ico
-|
-|-Model
-| |-ErrorViewModel.cs
-| |- Index.cs
-| |-...
-|
-|-Views
-| |-Home
-| | |- Index.cshtml
-| |
-| |-Shared
-| | |- _Layout.cshtml  --> reusable default page layout
-| | |- _ValidationScriptsPartial  --> jquery validation script imports
-| |
-| |- _ViewImports.cshtml  --> shared imports and tag helpers for all views
-| |- _ViewStart.cshtml  --> shared values for all views
-| |- ...
-|
-|-Controllers
-| |-HomeController.cs
-|
-|- appsettings.json
-|- Program.cs  --> App entry-point
-|- Startup.cs  --> App config
-```
-
-**Note**: `_` prefix indicates page to be imported.
-
-## Controllers
-
-```cs
-using Microsoft.AspNetCore.Mvc;
-using App.Models;
-using System.Collections.Generic;
-
-namespace App.Controllers
-{
-    public class CategoryController : Controller
-    {
-        private readonly AppDbContext _db;
-
-        // get db context through dependency injection
-        public CategoryController(AppDbContext db)
-        {
-            _db = db;
-        }
-
-        // GET /Controller/Index
-        public IActionResult Index()
-        {
-            IEnumerable<Entity> entities = _db.Entities;
-            return View(Entities);  // pass data to the @model
-        }
-
-        // GET /Controller/Create
-        public IActionResult Create()
-        {
-            return View();
-        }
-
-        // POST /Controller/Create
-        [HttpPost]
-        [ValidateAntiForgeryToken]
-        public IActionResult Create(Entity entity)  // receive data from the @model
-        {
-            _db.Entities.Add(entity);
-            _db.SaveChanges();
-            return RedirectToAction("Index");  // redirection
-        }
-
-        // GET - /Controller/Edit
-        public IActionResult Edit(int? id)
-        {
-            if(id == null || id == 0)
-            {
-                return NotFound();
-            }
-
-            Entity entity = _db.Entities.Find(id);
-            if (entity == null)
-            {
-                return NotFound();
-            }
-
-            return View(entity);  // return populated form for updating
-        }
-
-        // POST /Controller/Edit
-        [HttpPost]
-        [ValidateAntiForgeryToken]
-        public IActionResult Edit(Entity entity)
-        {
-            if (ModelState.IsValid)  // all rules in model have been met
-            {
-                _db.Entities.Update(entity);
-                _db.SaveChanges();
-                return RedirectToAction("Index");
-            }
-
-            return View(entity);
-        }
-
-        // GET /controller/Delete
-        public IActionResult Delete(int? id)
-        {
-            if (id == null || id == 0)
-            {
-                return NotFound();
-            }
-
-            Entity entity = _db.Entities.Find(id);
-            if (entity == null)
-            {
-                return NotFound();
-            }
-
-            return View(entity);  // return populated form for confirmation
-        }
-
-        // POST /Controller/Delete
-        [HttpPost]
-        [ValidateAntiForgeryToken]
-        public IActionResult Delete(Entity entity)
-        {
-            if (ModelState.IsValid)  // all rules in model have been met
-            {
-                _db.Entities.Remove(entity);
-                _db.SaveChanges();
-                return RedirectToAction("Index");
-            }
-
-            return View(entity);
-        }
-    }
-}
-```
-
-## Data Validation
-
-### Model Annotations
-
-In `Entity.cs`:
-
-```cs
-using System;
-using System.Collections.Generic;
-using System.ComponentModel;
-using System.ComponentModel.DataAnnotations;
-using System.Linq;
-
-namespace App.Models
-{
-    public class Entity
-    {
-        [DisplayName("Integer Number")]
-        [Required]
-        [Range(1, int.MaxValue, ErrorMessage = "Error Message")]
-        public int IntProp { get; set; }
-    }
-}
-```
-
-### Tag Helpers & Client Side Validation
-
-In `View.cshtml`;
-
-```cs
-<form method="post" asp-action="Create">
-    <div asp-validation-summary="ModelOnly" class="text-danger"></div>
-
-    <div class="form-group row">
-        <div class="col-4">
-            <label asp-for="IntProp"></label>
-        </div>
-
-        <div class="col-8">
-            <input asp-for="IntProp" class="form-control"/>
-            <span asp-validation-for="IntProp" class="text-danger"></span>  // error message displayed here
-        </div>
-    </div>
-</form>
-
-// client side validation
-@section Scripts{ 
-    @{ <partial name="_ValidationScriptsPartial" /> }
-}
-```
-
-### Server Side Validation
-
-```cs
-using Microsoft.AspNetCore.Mvc;
-using App.Models;
-using System.Collections.Generic;
-
-namespace App.Controllers
-{
-    public class CategoryController : Controller
-    {
-        private readonly AppDbContext _db;
-
-        // get db context through dependency injection
-        public CategoryController(AppDbContext db)
-        {
-            _db = db;
-        }
-
-        // GET /Controller/Index
-        public IActionResult Index()
-        {
-            IEnumerable<Entity> entities = _db.Entities;
-            return View(Entities);  // pass data to the @model
-        }
-
-        // GET /Controller/Create
-        public IActionResult Create()
-        {
-            return View();
-        }
-
-        // POST /Controller/Create
-        [HttpPost]
-        [ValidateAntiForgeryToken]
-        public IActionResult Create(Entity entity)  // receive data from the @model
-        {
-            if (ModelState.IsValid)  // all rules in model have been met
-            {
-                _db.Entities.Add(entity);
-                _db.SaveChanges();
-                return RedirectToAction("Index");
-            }
-
-            return View(entity);   // return model and display error messages
-        }
-    }
-}
-```
diff --git a/docs/languages/dotnet/asp.net/razor-pages.md b/docs/languages/dotnet/asp.net/razor-pages.md
deleted file mode 100644
index 16758de..0000000
--- a/docs/languages/dotnet/asp.net/razor-pages.md
+++ /dev/null
@@ -1,236 +0,0 @@
-# Razor Pages
-
-## Project Structure
-
-```txt
-Project
-|-Properties
-| |- launchSettings.json
-|
-|-wwwroot  --> static files
-| |-css
-| | |- site.css
-| |
-| |-js
-| | |- site.js
-| |
-| |-lib
-| | |- jquery
-| | |- bootstrap
-| | |- ...
-| |
-| |- favicon.ico
-|
-|-Pages
-| |-Shared
-| | |- _Layout.cshtml  --> reusable default page layout
-| | |- _ValidationScriptsPartial  --> jquery validation script imports
-| |
-| |- _ViewImports.cshtml  --> shared imports and tag helpers for all views
-| |- _ViewStart.cshtml  --> shared values for all views
-| |- Index.cshtml
-| |- Index.cshtml.cs
-| |- ...
-|
-|- appsettings.json --> application settings
-|- Program.cs  --> App entry-point
-|- Startup.cs
-```
-
-**Note**: `_` prefix indicates page to be imported
-
-Razor Pages components:
-
-- Razor Page (UI/View - `.cshtml`)
-- Page Model (Handlers - `.cshtml.cs`)
-
-in `Index.cshtml`:
-
-```cs
-@page  // mark as Razor Page
-@model IndexModel  // Link Page Model
-
-@{
-    ViewData["Title"] = "Page Title"  // same as <title>Page Title</title>
-}
-
-// body contents
-```
-
-in `Page.cshtml.cs`:
-
-```cs
-using Microsoft.AspNetCore.Mvc.RazorPages;
-using Microsoft.Extensions.Logging;
-
-namespace App.Pages
-{
-    public class IndexModel : PageModel
-    {
-        // HTTP Method
-        public void OnGet() { }
-
-        // HTTP Method
-        public void OnPost() { }
-    }
-}
-```
-
-## Razor Page
-
-```cs
-using Microsoft.AspNetCore.Mvc.RazorPages;
-using Microsoft.Extensions.Logging;
-
-namespace App.Pages
-{
-    public class IndexModel : PageModel
-    {
-        private readonly ApplicationDbContext _db; // EF DB Context
-
-        // Get DBContext through DI
-        public IndexModel(ApplicationDbContext db)
-        {
-            _db = db;
-        }
-
-        [BindProperty]  // assumed to be received on POST
-        public IEnumerable<Entity> Entities { get; set; }
-
-        // HTTP Method Handler
-        public async Task OnGet()
-        {   
-            // get data from DB (example operation)
-            Entities = await _db.Entities.ToListAsync();
-        }
-
-        // HTTP Method Handler
-        public async Task<IActionResult> OnPost()
-        {
-            if (ModelState.IsValid)
-            {
-                // save to DB (example operation)
-                await _db.Entities.AddAsync(Entity);
-                await _db.SaveChangesAsync();
-
-                return RedirectToPage("Index");
-            }
-            else
-            {
-                return Page();
-            }
-        }
-    }
-}
-```
-
-## Routing
-
-Rules:
-
-- URL maps to a physical file on disk
-- Razor paged needs a root folder (Default "Pages")
-- file extension not included in URL
-- `Index.cshtml` is entry-point and default document (missing file in URL redirects to index)
-
-| URL                    | Maps TO                                            |
-|------------------------|----------------------------------------------------|
-| www.domain.com         | /Pages/Index.cshtml                                |
-| www.domain.com/Index   | /Pages/Index.html                                  |
-| www.domain.com/Account | /Pages/Account.cshtml, /Pages/Account/Index.cshtml |
-
-## Data Validation
-
-### Model Annotations
-
-In `Entity.cs`:
-
-```cs
-using System;
-using System.Collections.Generic;
-using System.ComponentModel;
-using System.ComponentModel.DataAnnotations;
-using System.Linq;
-
-namespace App.Models
-{
-    public class Entity
-    {
-        [DisplayName("Integer Number")]
-        [Required]
-        [Range(1, int.MaxValue, ErrorMessage = "Error Message")]
-        public int IntProp { get; set; }
-    }
-}
-```
-
-### Tag Helpers & Client Side Validation
-
-In `View.cshtml`;
-
-```cs
-<form method="post" asp-action="Create">
-    <div asp-validation-summary="ModelOnly" class="text-danger"></div>
-
-    <div class="form-group row">
-        <div class="col-4">
-            <label asp-for="IntProp"></label>
-        </div>
-
-        <div class="col-8">
-            <input asp-for="IntProp" class="form-control"/>
-            <span asp-validation-for="IntProp" class="text-danger"></span>  // error message displayed here
-        </div>
-    </div>
-</form>
-
-// client side validation
-@section Scripts{ 
-    @{ <partial name="_ValidationScriptsPartial" /> }
-}
-```
-
-### Server Side Validation
-
-```cs
-using Microsoft.AspNetCore.Mvc;
-using App.Models;
-using System.Collections.Generic;
-
-namespace App.Controllers
-{
-    public class IndexModel : PageModel
-    {
-        private readonly ApplicationDbContext _db;
-
-        // get db context through dependency injection
-        public IndexModel(AppDbContext db)
-        {
-            _db = db;
-        }
-
-        [BindProperty]
-        public Entity Entity { get; set; }
-
-        public async Task OnGet(int id)
-        {
-            Entity = await _db.Entities.FindAsync(id);
-        }
-
-        public async Task<IActionResult> OnPost()
-        {
-            if (ModelState.IsValid)
-            {
-
-                await _db.SaveChangesAsync();
-
-                return RedirectToPage("Index");
-            }
-            else
-            {
-                return Page();
-            }
-        }
-    }
-}
-```
diff --git a/docs/languages/dotnet/asp.net/rest-api.md b/docs/languages/dotnet/asp.net/rest-api.md
deleted file mode 100644
index a10f534..0000000
--- a/docs/languages/dotnet/asp.net/rest-api.md
+++ /dev/null
@@ -1,53 +0,0 @@
-# ASP.NET REST API
-
-```cs
-[Route("api/endpoint")]
-[ApiController]
-public class EntitiesController : ControllerBase  // API controller
-{
-    private readonly IEntityService _service;
-
-    public EntitiesController(IEntityService service, IMapper mapper)  
-    {
-        _service = service;
-        _mapper = mapper
-    }
-
-    [HttpGet]  // GET api/endpoint
-    public ActionResult<IEnumerable<EntityDTO>> GetEntities()
-    {
-        IEnumerable<EntityDTO> results = /* ...  */
-        return Ok(results);
-    }
-
-    [HttpGet("{id}")]  // GET api/endpoint/{id}
-    public ActionResult<EntityDTO> GetEntityById(int id)
-    {
-        var result = /* .. */;
-
-        if(result != null)
-        {
-            return Ok(result);
-        }
-
-        return NotFound();
-    }
-
-    [HttpPost]  // POST api/endpoint
-    public ActionResult<EntityDTO> CreateEntity([FromBody] EntityDTO entity)
-    {
-        // persist the entity
-
-        var id = /* ID of the created entity */
-        return Created(id, entity);
-    }
-
-    [HttpPut]  // PUT api/endpoint
-    public ActionResult<EntityDTO> UpdateEntity([FromBody] EntityDTO entity)
-    {
-        // persist the updated entity
-
-        return Created(uri, entity);
-    }
-}
-```
diff --git a/docs/languages/dotnet/asp.net/signalr.md b/docs/languages/dotnet/asp.net/signalr.md
index c69679f..26c2a22 100644
--- a/docs/languages/dotnet/asp.net/signalr.md
+++ b/docs/languages/dotnet/asp.net/signalr.md
@@ -9,33 +9,14 @@ The SignalR Hubs API enables to call methods on connected clients from the serve
 In `Startup.cs`:
 
 ```cs
-namespace App
+builder.Services.AddSignalR();
+
+var app = builder.Build();
+
+app.UseEndpoints(endpoints =>
 {
-    public class Startup
-    {
-        public Startup(IConfiguration configuration)
-        {
-            Configuration = configuration;
-        }
-
-        public IConfiguration Configuration { get; }
-
-        // This method gets called by the runtime. Use this method to add services to the DI container.
-        public void ConfigureServices(IServiceCollection services)
-        {
-            services.AddSignalR();
-        }
-
-        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
-        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
-        {
-            app.UseEndpoints(endpoints =>
-            {
-                endpoints.MapHub("/hub/endpoint");
-            });
-        }
-    }
-}
+    endpoints.MapHub("/hub/endpoint");
+});
 ```
 
 ### Creating Hubs
diff --git a/docs/languages/dotnet/asp.net/web-forms.md b/docs/languages/dotnet/asp.net/web-forms.md
index a5737c8..1df75dd 100644
--- a/docs/languages/dotnet/asp.net/web-forms.md
+++ b/docs/languages/dotnet/asp.net/web-forms.md
@@ -60,26 +60,16 @@ The fist loaded page is `Default.aspx` and its underlying code.
 ## `Page.aspx.cs`
 
 ```cs
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Web;
-using System.Web.UI;
-using System.Web.UI.WebControls;
-
-namespace Project
+public partial class Default : System.Web.UI.Page
 {
-    public partial class Default : System.Web.UI.Page
+    protected void Page_Load(object sender, EventArgs e)
     {
-        protected void Page_Load(object sender, EventArgs e)
-        {
 
-        }
+    }
 
-        protected void Control_Event(object sender, EventArgs e)
-        {
-            // actions on event trigger
-        }
+    protected void Control_Event(object sender, EventArgs e)
+    {
+        // actions on event trigger
     }
 }
 ```
diff --git a/mkdocs.yml b/mkdocs.yml
index e4d1c36..14c7292 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -122,16 +122,11 @@ nav:
           - Async Programming: languages/dotnet/csharp/async-programming.md
           - Unit Tests: languages/dotnet/csharp/unit-tests.md
       - ASP.NET:
-          - App Configuration: languages/dotnet/asp.net/app-configuration.md
           - Minimal API: languages/dotnet/asp.net/minimal-api.md
-          - MVC: languages/dotnet/asp.net/mvc.md
           - FIlters: languages/dotnet/asp.net/filters.md
           - Middleware: languages/dotnet/asp.net/middleware.md
-          - Razor Pages: languages/dotnet/asp.net/razor-syntax.md
-          - Blazor: languages/dotnet/asp.net/blazor.md
-          - Razor Pages: languages/dotnet/asp.net/razor-pages.md
           - Razor Syntax: languages/dotnet/asp.net/razor-syntax.md
-          - REST API: languages/dotnet/asp.net/rest-api.md
+          - Blazor: languages/dotnet/asp.net/blazor.md
           - SignalR: languages/dotnet/asp.net/signalr.md
           - Web Forms: languages/dotnet/asp.net/web-forms.md
       - Database:

From 199fc23816c67ef8404a9c153221bee7c058099f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 5 Jul 2023 15:39:11 +0200
Subject: [PATCH 14/39] Poetry(deps): Bump pillow from 9.5.0 to 10.0.0 (#30)

Bumps [pillow](https://github.com/python-pillow/Pillow) from 9.5.0 to 10.0.0.
- [Release notes](https://github.com/python-pillow/Pillow/releases)
- [Changelog](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst)
- [Commits](https://github.com/python-pillow/Pillow/compare/9.5.0...10.0.0)

---
updated-dependencies:
- dependency-name: pillow
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 poetry.lock    | 126 ++++++++++++++++++++++---------------------------
 pyproject.toml |   2 +-
 2 files changed, 58 insertions(+), 70 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index ddecddf..6f2f219 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -391,77 +391,65 @@ pyparsing = ">=2.0.2,<3.0.5 || >3.0.5"
 
 [[package]]
 name = "pillow"
-version = "9.5.0"
+version = "10.0.0"
 description = "Python Imaging Library (Fork)"
 optional = false
-python-versions = ">=3.7"
+python-versions = ">=3.8"
 files = [
-    {file = "Pillow-9.5.0-cp310-cp310-macosx_10_10_x86_64.whl", hash = "sha256:ace6ca218308447b9077c14ea4ef381ba0b67ee78d64046b3f19cf4e1139ad16"},
-    {file = "Pillow-9.5.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:d3d403753c9d5adc04d4694d35cf0391f0f3d57c8e0030aac09d7678fa8030aa"},
-    {file = "Pillow-9.5.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5ba1b81ee69573fe7124881762bb4cd2e4b6ed9dd28c9c60a632902fe8db8b38"},
-    {file = "Pillow-9.5.0-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:fe7e1c262d3392afcf5071df9afa574544f28eac825284596ac6db56e6d11062"},
-    {file = "Pillow-9.5.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8f36397bf3f7d7c6a3abdea815ecf6fd14e7fcd4418ab24bae01008d8d8ca15e"},
-    {file = "Pillow-9.5.0-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:252a03f1bdddce077eff2354c3861bf437c892fb1832f75ce813ee94347aa9b5"},
-    {file = "Pillow-9.5.0-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:85ec677246533e27770b0de5cf0f9d6e4ec0c212a1f89dfc941b64b21226009d"},
-    {file = "Pillow-9.5.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:b416f03d37d27290cb93597335a2f85ed446731200705b22bb927405320de903"},
-    {file = "Pillow-9.5.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1781a624c229cb35a2ac31cc4a77e28cafc8900733a864870c49bfeedacd106a"},
-    {file = "Pillow-9.5.0-cp310-cp310-win32.whl", hash = "sha256:8507eda3cd0608a1f94f58c64817e83ec12fa93a9436938b191b80d9e4c0fc44"},
-    {file = "Pillow-9.5.0-cp310-cp310-win_amd64.whl", hash = "sha256:d3c6b54e304c60c4181da1c9dadf83e4a54fd266a99c70ba646a9baa626819eb"},
-    {file = "Pillow-9.5.0-cp311-cp311-macosx_10_10_x86_64.whl", hash = "sha256:7ec6f6ce99dab90b52da21cf0dc519e21095e332ff3b399a357c187b1a5eee32"},
-    {file = "Pillow-9.5.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:560737e70cb9c6255d6dcba3de6578a9e2ec4b573659943a5e7e4af13f298f5c"},
-    {file = "Pillow-9.5.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:96e88745a55b88a7c64fa49bceff363a1a27d9a64e04019c2281049444a571e3"},
-    {file = "Pillow-9.5.0-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d9c206c29b46cfd343ea7cdfe1232443072bbb270d6a46f59c259460db76779a"},
-    {file = "Pillow-9.5.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:cfcc2c53c06f2ccb8976fb5c71d448bdd0a07d26d8e07e321c103416444c7ad1"},
-    {file = "Pillow-9.5.0-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:a0f9bb6c80e6efcde93ffc51256d5cfb2155ff8f78292f074f60f9e70b942d99"},
-    {file = "Pillow-9.5.0-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:8d935f924bbab8f0a9a28404422da8af4904e36d5c33fc6f677e4c4485515625"},
-    {file = "Pillow-9.5.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:fed1e1cf6a42577953abbe8e6cf2fe2f566daebde7c34724ec8803c4c0cda579"},
-    {file = "Pillow-9.5.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:c1170d6b195555644f0616fd6ed929dfcf6333b8675fcca044ae5ab110ded296"},
-    {file = "Pillow-9.5.0-cp311-cp311-win32.whl", hash = "sha256:54f7102ad31a3de5666827526e248c3530b3a33539dbda27c6843d19d72644ec"},
-    {file = "Pillow-9.5.0-cp311-cp311-win_amd64.whl", hash = "sha256:cfa4561277f677ecf651e2b22dc43e8f5368b74a25a8f7d1d4a3a243e573f2d4"},
-    {file = "Pillow-9.5.0-cp311-cp311-win_arm64.whl", hash = "sha256:965e4a05ef364e7b973dd17fc765f42233415974d773e82144c9bbaaaea5d089"},
-    {file = "Pillow-9.5.0-cp312-cp312-win32.whl", hash = "sha256:22baf0c3cf0c7f26e82d6e1adf118027afb325e703922c8dfc1d5d0156bb2eeb"},
-    {file = "Pillow-9.5.0-cp312-cp312-win_amd64.whl", hash = "sha256:432b975c009cf649420615388561c0ce7cc31ce9b2e374db659ee4f7d57a1f8b"},
-    {file = "Pillow-9.5.0-cp37-cp37m-macosx_10_10_x86_64.whl", hash = "sha256:5d4ebf8e1db4441a55c509c4baa7a0587a0210f7cd25fcfe74dbbce7a4bd1906"},
-    {file = "Pillow-9.5.0-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:375f6e5ee9620a271acb6820b3d1e94ffa8e741c0601db4c0c4d3cb0a9c224bf"},
-    {file = "Pillow-9.5.0-cp37-cp37m-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:99eb6cafb6ba90e436684e08dad8be1637efb71c4f2180ee6b8f940739406e78"},
-    {file = "Pillow-9.5.0-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2dfaaf10b6172697b9bceb9a3bd7b951819d1ca339a5ef294d1f1ac6d7f63270"},
-    {file = "Pillow-9.5.0-cp37-cp37m-manylinux_2_28_aarch64.whl", hash = "sha256:763782b2e03e45e2c77d7779875f4432e25121ef002a41829d8868700d119392"},
-    {file = "Pillow-9.5.0-cp37-cp37m-manylinux_2_28_x86_64.whl", hash = "sha256:35f6e77122a0c0762268216315bf239cf52b88865bba522999dc38f1c52b9b47"},
-    {file = "Pillow-9.5.0-cp37-cp37m-win32.whl", hash = "sha256:aca1c196f407ec7cf04dcbb15d19a43c507a81f7ffc45b690899d6a76ac9fda7"},
-    {file = "Pillow-9.5.0-cp37-cp37m-win_amd64.whl", hash = "sha256:322724c0032af6692456cd6ed554bb85f8149214d97398bb80613b04e33769f6"},
-    {file = "Pillow-9.5.0-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:a0aa9417994d91301056f3d0038af1199eb7adc86e646a36b9e050b06f526597"},
-    {file = "Pillow-9.5.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:f8286396b351785801a976b1e85ea88e937712ee2c3ac653710a4a57a8da5d9c"},
-    {file = "Pillow-9.5.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c830a02caeb789633863b466b9de10c015bded434deb3ec87c768e53752ad22a"},
-    {file = "Pillow-9.5.0-cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:fbd359831c1657d69bb81f0db962905ee05e5e9451913b18b831febfe0519082"},
-    {file = "Pillow-9.5.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f8fc330c3370a81bbf3f88557097d1ea26cd8b019d6433aa59f71195f5ddebbf"},
-    {file = "Pillow-9.5.0-cp38-cp38-manylinux_2_28_aarch64.whl", hash = "sha256:7002d0797a3e4193c7cdee3198d7c14f92c0836d6b4a3f3046a64bd1ce8df2bf"},
-    {file = "Pillow-9.5.0-cp38-cp38-manylinux_2_28_x86_64.whl", hash = "sha256:229e2c79c00e85989a34b5981a2b67aa079fd08c903f0aaead522a1d68d79e51"},
-    {file = "Pillow-9.5.0-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:9adf58f5d64e474bed00d69bcd86ec4bcaa4123bfa70a65ce72e424bfb88ed96"},
-    {file = "Pillow-9.5.0-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:662da1f3f89a302cc22faa9f14a262c2e3951f9dbc9617609a47521c69dd9f8f"},
-    {file = "Pillow-9.5.0-cp38-cp38-win32.whl", hash = "sha256:6608ff3bf781eee0cd14d0901a2b9cc3d3834516532e3bd673a0a204dc8615fc"},
-    {file = "Pillow-9.5.0-cp38-cp38-win_amd64.whl", hash = "sha256:e49eb4e95ff6fd7c0c402508894b1ef0e01b99a44320ba7d8ecbabefddcc5569"},
-    {file = "Pillow-9.5.0-cp39-cp39-macosx_10_10_x86_64.whl", hash = "sha256:482877592e927fd263028c105b36272398e3e1be3269efda09f6ba21fd83ec66"},
-    {file = "Pillow-9.5.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:3ded42b9ad70e5f1754fb7c2e2d6465a9c842e41d178f262e08b8c85ed8a1d8e"},
-    {file = "Pillow-9.5.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c446d2245ba29820d405315083d55299a796695d747efceb5717a8b450324115"},
-    {file = "Pillow-9.5.0-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:8aca1152d93dcc27dc55395604dcfc55bed5f25ef4c98716a928bacba90d33a3"},
-    {file = "Pillow-9.5.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:608488bdcbdb4ba7837461442b90ea6f3079397ddc968c31265c1e056964f1ef"},
-    {file = "Pillow-9.5.0-cp39-cp39-manylinux_2_28_aarch64.whl", hash = "sha256:60037a8db8750e474af7ffc9faa9b5859e6c6d0a50e55c45576bf28be7419705"},
-    {file = "Pillow-9.5.0-cp39-cp39-manylinux_2_28_x86_64.whl", hash = "sha256:07999f5834bdc404c442146942a2ecadd1cb6292f5229f4ed3b31e0a108746b1"},
-    {file = "Pillow-9.5.0-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:a127ae76092974abfbfa38ca2d12cbeddcdeac0fb71f9627cc1135bedaf9d51a"},
-    {file = "Pillow-9.5.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:489f8389261e5ed43ac8ff7b453162af39c3e8abd730af8363587ba64bb2e865"},
-    {file = "Pillow-9.5.0-cp39-cp39-win32.whl", hash = "sha256:9b1af95c3a967bf1da94f253e56b6286b50af23392a886720f563c547e48e964"},
-    {file = "Pillow-9.5.0-cp39-cp39-win_amd64.whl", hash = "sha256:77165c4a5e7d5a284f10a6efaa39a0ae8ba839da344f20b111d62cc932fa4e5d"},
-    {file = "Pillow-9.5.0-pp38-pypy38_pp73-macosx_10_10_x86_64.whl", hash = "sha256:833b86a98e0ede388fa29363159c9b1a294b0905b5128baf01db683672f230f5"},
-    {file = "Pillow-9.5.0-pp38-pypy38_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:aaf305d6d40bd9632198c766fb64f0c1a83ca5b667f16c1e79e1661ab5060140"},
-    {file = "Pillow-9.5.0-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0852ddb76d85f127c135b6dd1f0bb88dbb9ee990d2cd9aa9e28526c93e794fba"},
-    {file = "Pillow-9.5.0-pp38-pypy38_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:91ec6fe47b5eb5a9968c79ad9ed78c342b1f97a091677ba0e012701add857829"},
-    {file = "Pillow-9.5.0-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:cb841572862f629b99725ebaec3287fc6d275be9b14443ea746c1dd325053cbd"},
-    {file = "Pillow-9.5.0-pp39-pypy39_pp73-macosx_10_10_x86_64.whl", hash = "sha256:c380b27d041209b849ed246b111b7c166ba36d7933ec6e41175fd15ab9eb1572"},
-    {file = "Pillow-9.5.0-pp39-pypy39_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7c9af5a3b406a50e313467e3565fc99929717f780164fe6fbb7704edba0cebbe"},
-    {file = "Pillow-9.5.0-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5671583eab84af046a397d6d0ba25343c00cd50bce03787948e0fff01d4fd9b1"},
-    {file = "Pillow-9.5.0-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:84a6f19ce086c1bf894644b43cd129702f781ba5751ca8572f08aa40ef0ab7b7"},
-    {file = "Pillow-9.5.0-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:1e7723bd90ef94eda669a3c2c19d549874dd5badaeefabefd26053304abe5799"},
-    {file = "Pillow-9.5.0.tar.gz", hash = "sha256:bf548479d336726d7a0eceb6e767e179fbde37833ae42794602631a070d630f1"},
+    {file = "Pillow-10.0.0-cp310-cp310-macosx_10_10_x86_64.whl", hash = "sha256:1f62406a884ae75fb2f818694469519fb685cc7eaff05d3451a9ebe55c646891"},
+    {file = "Pillow-10.0.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:d5db32e2a6ccbb3d34d87c87b432959e0db29755727afb37290e10f6e8e62614"},
+    {file = "Pillow-10.0.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:edf4392b77bdc81f36e92d3a07a5cd072f90253197f4a52a55a8cec48a12483b"},
+    {file = "Pillow-10.0.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:520f2a520dc040512699f20fa1c363eed506e94248d71f85412b625026f6142c"},
+    {file = "Pillow-10.0.0-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:8c11160913e3dd06c8ffdb5f233a4f254cb449f4dfc0f8f4549eda9e542c93d1"},
+    {file = "Pillow-10.0.0-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:a74ba0c356aaa3bb8e3eb79606a87669e7ec6444be352870623025d75a14a2bf"},
+    {file = "Pillow-10.0.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:d5d0dae4cfd56969d23d94dc8e89fb6a217be461c69090768227beb8ed28c0a3"},
+    {file = "Pillow-10.0.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:22c10cc517668d44b211717fd9775799ccec4124b9a7f7b3635fc5386e584992"},
+    {file = "Pillow-10.0.0-cp310-cp310-win_amd64.whl", hash = "sha256:dffe31a7f47b603318c609f378ebcd57f1554a3a6a8effbc59c3c69f804296de"},
+    {file = "Pillow-10.0.0-cp311-cp311-macosx_10_10_x86_64.whl", hash = "sha256:9fb218c8a12e51d7ead2a7c9e101a04982237d4855716af2e9499306728fb485"},
+    {file = "Pillow-10.0.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:d35e3c8d9b1268cbf5d3670285feb3528f6680420eafe35cccc686b73c1e330f"},
+    {file = "Pillow-10.0.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3ed64f9ca2f0a95411e88a4efbd7a29e5ce2cea36072c53dd9d26d9c76f753b3"},
+    {file = "Pillow-10.0.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b6eb5502f45a60a3f411c63187db83a3d3107887ad0d036c13ce836f8a36f1d"},
+    {file = "Pillow-10.0.0-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:c1fbe7621c167ecaa38ad29643d77a9ce7311583761abf7836e1510c580bf3dd"},
+    {file = "Pillow-10.0.0-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:cd25d2a9d2b36fcb318882481367956d2cf91329f6892fe5d385c346c0649629"},
+    {file = "Pillow-10.0.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:3b08d4cc24f471b2c8ca24ec060abf4bebc6b144cb89cba638c720546b1cf538"},
+    {file = "Pillow-10.0.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:d737a602fbd82afd892ca746392401b634e278cb65d55c4b7a8f48e9ef8d008d"},
+    {file = "Pillow-10.0.0-cp311-cp311-win_amd64.whl", hash = "sha256:3a82c40d706d9aa9734289740ce26460a11aeec2d9c79b7af87bb35f0073c12f"},
+    {file = "Pillow-10.0.0-cp312-cp312-macosx_10_10_x86_64.whl", hash = "sha256:d80cf684b541685fccdd84c485b31ce73fc5c9b5d7523bf1394ce134a60c6883"},
+    {file = "Pillow-10.0.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:76de421f9c326da8f43d690110f0e79fe3ad1e54be811545d7d91898b4c8493e"},
+    {file = "Pillow-10.0.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:81ff539a12457809666fef6624684c008e00ff6bf455b4b89fd00a140eecd640"},
+    {file = "Pillow-10.0.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ce543ed15570eedbb85df19b0a1a7314a9c8141a36ce089c0a894adbfccb4568"},
+    {file = "Pillow-10.0.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:685ac03cc4ed5ebc15ad5c23bc555d68a87777586d970c2c3e216619a5476223"},
+    {file = "Pillow-10.0.0-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:d72e2ecc68a942e8cf9739619b7f408cc7b272b279b56b2c83c6123fcfa5cdff"},
+    {file = "Pillow-10.0.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:d50b6aec14bc737742ca96e85d6d0a5f9bfbded018264b3b70ff9d8c33485551"},
+    {file = "Pillow-10.0.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:00e65f5e822decd501e374b0650146063fbb30a7264b4d2744bdd7b913e0cab5"},
+    {file = "Pillow-10.0.0-cp312-cp312-win_amd64.whl", hash = "sha256:f31f9fdbfecb042d046f9d91270a0ba28368a723302786c0009ee9b9f1f60199"},
+    {file = "Pillow-10.0.0-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:349930d6e9c685c089284b013478d6f76e3a534e36ddfa912cde493f235372f3"},
+    {file = "Pillow-10.0.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:3a684105f7c32488f7153905a4e3015a3b6c7182e106fe3c37fbb5ef3e6994c3"},
+    {file = "Pillow-10.0.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b4f69b3700201b80bb82c3a97d5e9254084f6dd5fb5b16fc1a7b974260f89f43"},
+    {file = "Pillow-10.0.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f07ea8d2f827d7d2a49ecf1639ec02d75ffd1b88dcc5b3a61bbb37a8759ad8d"},
+    {file = "Pillow-10.0.0-cp38-cp38-manylinux_2_28_aarch64.whl", hash = "sha256:040586f7d37b34547153fa383f7f9aed68b738992380ac911447bb78f2abe530"},
+    {file = "Pillow-10.0.0-cp38-cp38-manylinux_2_28_x86_64.whl", hash = "sha256:f88a0b92277de8e3ca715a0d79d68dc82807457dae3ab8699c758f07c20b3c51"},
+    {file = "Pillow-10.0.0-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:c7cf14a27b0d6adfaebb3ae4153f1e516df54e47e42dcc073d7b3d76111a8d86"},
+    {file = "Pillow-10.0.0-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:3400aae60685b06bb96f99a21e1ada7bc7a413d5f49bce739828ecd9391bb8f7"},
+    {file = "Pillow-10.0.0-cp38-cp38-win_amd64.whl", hash = "sha256:dbc02381779d412145331789b40cc7b11fdf449e5d94f6bc0b080db0a56ea3f0"},
+    {file = "Pillow-10.0.0-cp39-cp39-macosx_10_10_x86_64.whl", hash = "sha256:9211e7ad69d7c9401cfc0e23d49b69ca65ddd898976d660a2fa5904e3d7a9baa"},
+    {file = "Pillow-10.0.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:faaf07ea35355b01a35cb442dd950d8f1bb5b040a7787791a535de13db15ed90"},
+    {file = "Pillow-10.0.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c9f72a021fbb792ce98306ffb0c348b3c9cb967dce0f12a49aa4c3d3fdefa967"},
+    {file = "Pillow-10.0.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9f7c16705f44e0504a3a2a14197c1f0b32a95731d251777dcb060aa83022cb2d"},
+    {file = "Pillow-10.0.0-cp39-cp39-manylinux_2_28_aarch64.whl", hash = "sha256:76edb0a1fa2b4745fb0c99fb9fb98f8b180a1bbceb8be49b087e0b21867e77d3"},
+    {file = "Pillow-10.0.0-cp39-cp39-manylinux_2_28_x86_64.whl", hash = "sha256:368ab3dfb5f49e312231b6f27b8820c823652b7cd29cfbd34090565a015e99ba"},
+    {file = "Pillow-10.0.0-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:608bfdee0d57cf297d32bcbb3c728dc1da0907519d1784962c5f0c68bb93e5a3"},
+    {file = "Pillow-10.0.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:5c6e3df6bdd396749bafd45314871b3d0af81ff935b2d188385e970052091017"},
+    {file = "Pillow-10.0.0-cp39-cp39-win_amd64.whl", hash = "sha256:7be600823e4c8631b74e4a0d38384c73f680e6105a7d3c6824fcf226c178c7e6"},
+    {file = "Pillow-10.0.0-pp310-pypy310_pp73-macosx_10_10_x86_64.whl", hash = "sha256:92be919bbc9f7d09f7ae343c38f5bb21c973d2576c1d45600fce4b74bafa7ac0"},
+    {file = "Pillow-10.0.0-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8f8182b523b2289f7c415f589118228d30ac8c355baa2f3194ced084dac2dbba"},
+    {file = "Pillow-10.0.0-pp310-pypy310_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:38250a349b6b390ee6047a62c086d3817ac69022c127f8a5dc058c31ccef17f3"},
+    {file = "Pillow-10.0.0-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:88af2003543cc40c80f6fca01411892ec52b11021b3dc22ec3bc9d5afd1c5334"},
+    {file = "Pillow-10.0.0-pp39-pypy39_pp73-macosx_10_10_x86_64.whl", hash = "sha256:c189af0545965fa8d3b9613cfdb0cd37f9d71349e0f7750e1fd704648d475ed2"},
+    {file = "Pillow-10.0.0-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ce7b031a6fc11365970e6a5686d7ba8c63e4c1cf1ea143811acbb524295eabed"},
+    {file = "Pillow-10.0.0-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:db24668940f82321e746773a4bc617bfac06ec831e5c88b643f91f122a785684"},
+    {file = "Pillow-10.0.0-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:efe8c0681042536e0d06c11f48cebe759707c9e9abf880ee213541c5b46c5bf3"},
+    {file = "Pillow-10.0.0.tar.gz", hash = "sha256:9c82b5b3e043c7af0d95792d0d20ccf68f61a1fec6b3530e718b688422727396"},
 ]
 
 [package.extras]
@@ -813,4 +801,4 @@ files = [
 [metadata]
 lock-version = "2.0"
 python-versions = "^3.10"
-content-hash = "2fe777808e8c397c77e06bbf5b712ef9b23bfe03a13060ae2ab54a40cb4b4f1f"
+content-hash = "3c899a52668a042ce61da070b89557f2b288d1437b1180400dd996faa23ad383"
diff --git a/pyproject.toml b/pyproject.toml
index 1943a08..0d361a9 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -9,7 +9,7 @@ license = "MIT"
 python = "^3.10"
 mkdocs = "^1.4.3"
 mkdocs-material = "^9.1.16"
-pillow = "^9.5.0"
+pillow = "^10.0.0"
 cairosvg = "^2.7.0"
 
 [tool.poetry.dev-dependencies]

From c3c679e6cdc2d9d323e2924727e6d0c50454e770 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Wed, 5 Jul 2023 15:44:14 +0200
Subject: [PATCH 15/39] chore: use default font for social cards

---
 mkdocs.yml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/mkdocs.yml b/mkdocs.yml
index 14c7292..3f3966d 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -20,8 +20,7 @@ extra:
 
 plugins:
   - search
-  - social:
-     cards_font: JetBrains Mono
+  - social
 
 
 theme:

From 6f50690fe581f214f2a35d52a5a51a93b0be9f89 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Mon, 10 Jul 2023 11:37:55 +0200
Subject: [PATCH 16/39] feat(docker): add compose health checks notes

---
 docs/containers/docker.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/docs/containers/docker.md b/docs/containers/docker.md
index 51b6258..0f40f89 100644
--- a/docs/containers/docker.md
+++ b/docs/containers/docker.md
@@ -299,7 +299,7 @@ services:
       dockerfile: <*.Dockerfile>
       args:  # pass args to dockerfile
         ARG: <value>
-       - ARG=<value>
+        - ARG=<value>
     ports: 
       - <host_port>:<container_port>
     networks:  # attach container to one or more networks
@@ -310,10 +310,18 @@ services:
       ENV_VAR: <value>
       - ENV_VAR=<value>
     env_file:
-         - <path/to/env/file>  # reusable env file
+      - <path/to/env/file>  # reusable env file
     volumes:
       - "./<rel/path/to/volume>:<in/container/path/to/data>"  # service-dedicated volume
       - "<volume_name>:<in/container/path/to/data>"  # reuseable volume
+    healthcheck:
+      disable: <bool>  # set to true to disable
+      test: curl -f http://localhost  # set to ["NONE"] to disable
+      interval:  # interval between checks (default 30s)
+      timeout:  # check fail timeout (default 30s)
+      retries:  # num of retries before unhealty (default 3)
+      start_period:  # container init grace pediod (default 5s)
+      start_interval:  # check interval in start period
 
 # reusable volume definitions
 volumes:

From 964a1f47698bfc72146ee9bf54d76e8f7708904a Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Tue, 18 Jul 2023 15:43:40 +0200
Subject: [PATCH 17/39] feat: enable navigation pruning & navigation sections

---
 mkdocs.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/mkdocs.yml b/mkdocs.yml
index 3f3966d..1c58e26 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -52,7 +52,8 @@ theme:
     - navigation.instant
     - navigation.indexes
     - navigation.tracking
-    # - navigation.sections
+    - navigation.pruning
+    - navigation.sections
     - navigation.top
     - navigation.tabs
     - navigation.tabs.sticky

From 1cc08777d9764d0a6b78ad91a1b9082f3f9f3940 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Sat, 5 Aug 2023 10:54:34 +0200
Subject: [PATCH 18/39] fix(mongodb): remove ambiguity on `$graphLookup`
 connections

---
 docs/databases/mongo-db.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/databases/mongo-db.md b/docs/databases/mongo-db.md
index db214fc..d63a43d 100644
--- a/docs/databases/mongo-db.md
+++ b/docs/databases/mongo-db.md
@@ -722,7 +722,7 @@ db.<collection>.aggregate([
 
 Performs a recursive search on a collection, with options for restricting the search by recursion depth and query filter.
 
-The connection between documents follows `<from-collection>.<connectFromField>` => `<aggregated-collection>.<connectToField>`. The collection on which the aggregation is performed and the `from` collection can be the same (in-collection search) or different (cross-collection search)  
+The collection on which the aggregation is performed and the `from` collection can be the same (in-collection search) or different (cross-collection search)
 
 ```sh
 db.<collection>.aggregate([

From 56d98896cca43302d31f416816860b8683016208 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Tue, 29 Aug 2023 18:17:31 +0200
Subject: [PATCH 19/39] fix(mkdocs): bump deps versions to fic CVE-2023-37920

---
 poetry.lock | 867 ++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 600 insertions(+), 267 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 6f2f219..287f889 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -1,13 +1,43 @@
-# This file is automatically @generated by Poetry 1.5.1 and should not be changed by hand.
+# This file is automatically @generated by Poetry 1.6.1 and should not be changed by hand.
+
+[[package]]
+name = "babel"
+version = "2.12.1"
+description = "Internationalization utilities"
+optional = false
+python-versions = ">=3.7"
+files = [
+    {file = "Babel-2.12.1-py3-none-any.whl", hash = "sha256:b4246fb7677d3b98f501a39d43396d3cafdc8eadb045f4a31be01863f655c610"},
+    {file = "Babel-2.12.1.tar.gz", hash = "sha256:cc2d99999cd01d44420ae725a21c9e3711b3aadc7976d6147f622d8581963455"},
+]
+
+[[package]]
+name = "beautifulsoup4"
+version = "4.12.2"
+description = "Screen-scraping library"
+optional = false
+python-versions = ">=3.6.0"
+files = [
+    {file = "beautifulsoup4-4.12.2-py3-none-any.whl", hash = "sha256:bd2520ca0d9d7d12694a53d44ac482d181b4ec1888909b035a3dbf40d0f57d4a"},
+    {file = "beautifulsoup4-4.12.2.tar.gz", hash = "sha256:492bbc69dca35d12daac71c4db1bfff0c876c00ef4a2ffacce226d4638eb72da"},
+]
+
+[package.dependencies]
+soupsieve = ">1.2"
+
+[package.extras]
+html5lib = ["html5lib"]
+lxml = ["lxml"]
 
 [[package]]
 name = "cairocffi"
-version = "1.4.0"
+version = "1.6.1"
 description = "cffi-based cairo bindings for Python"
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "cairocffi-1.4.0.tar.gz", hash = "sha256:509339b32ccd8d7b00c2204c32736cde78db53a32e6a162d312478d25626cd9a"},
+    {file = "cairocffi-1.6.1-py3-none-any.whl", hash = "sha256:aa78ee52b9069d7475eeac457389b6275aa92111895d78fbaa2202a52dac112e"},
+    {file = "cairocffi-1.6.1.tar.gz", hash = "sha256:78e6bbe47357640c453d0be929fa49cd05cce2e1286f3d2a1ca9cbda7efdb8b7"},
 ]
 
 [package.dependencies]
@@ -16,17 +46,17 @@ cffi = ">=1.1.0"
 [package.extras]
 doc = ["sphinx", "sphinx_rtd_theme"]
 test = ["flake8", "isort", "numpy", "pikepdf", "pytest"]
-xcb = ["xcffib (>=0.3.2)"]
+xcb = ["xcffib (>=1.4.0)"]
 
 [[package]]
 name = "cairosvg"
-version = "2.7.0"
+version = "2.7.1"
 description = "A Simple SVG Converter based on Cairo"
 optional = false
 python-versions = ">=3.5"
 files = [
-    {file = "CairoSVG-2.7.0-py3-none-any.whl", hash = "sha256:17cb96423a896258848322a95c80160e714a58f1af3dd73b8e1750994519b9f9"},
-    {file = "CairoSVG-2.7.0.tar.gz", hash = "sha256:ac4dc7c1d38b3a15717db2633a3a383012e0be664c727c911637e6af6a49293c"},
+    {file = "CairoSVG-2.7.1-py3-none-any.whl", hash = "sha256:8a5222d4e6c3f86f1f7046b63246877a63b49923a1cd202184c3a634ef546b3b"},
+    {file = "CairoSVG-2.7.1.tar.gz", hash = "sha256:432531d72347291b9a9ebfb6777026b607563fd8719c46ee742db0aef7271ba0"},
 ]
 
 [package.dependencies]
@@ -42,13 +72,13 @@ test = ["flake8", "isort", "pytest"]
 
 [[package]]
 name = "certifi"
-version = "2022.12.7"
+version = "2023.7.22"
 description = "Python package for providing Mozilla's CA Bundle."
 optional = false
 python-versions = ">=3.6"
 files = [
-    {file = "certifi-2022.12.7-py3-none-any.whl", hash = "sha256:4ad3232f5e926d6718ec31cfc1fcadfde020920e278684144551c91769c7bc18"},
-    {file = "certifi-2022.12.7.tar.gz", hash = "sha256:35824b4c3a97115964b408844d64aa14db1cc518f6562e8d7261699d1350a9e3"},
+    {file = "certifi-2023.7.22-py3-none-any.whl", hash = "sha256:92d6037539857d8206b8f6ae472e8b77db8058fec5937a1ef3f54304089edbb9"},
+    {file = "certifi-2023.7.22.tar.gz", hash = "sha256:539cc1d13202e33ca466e88b2807e29f4c13049d6d87031a3c110744495cb082"},
 ]
 
 [[package]]
@@ -129,27 +159,97 @@ pycparser = "*"
 
 [[package]]
 name = "charset-normalizer"
-version = "2.1.1"
+version = "3.2.0"
 description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet."
 optional = false
-python-versions = ">=3.6.0"
+python-versions = ">=3.7.0"
 files = [
-    {file = "charset-normalizer-2.1.1.tar.gz", hash = "sha256:5a3d016c7c547f69d6f81fb0db9449ce888b418b5b9952cc5e6e66843e9dd845"},
-    {file = "charset_normalizer-2.1.1-py3-none-any.whl", hash = "sha256:83e9a75d1911279afd89352c68b45348559d1fc0506b054b346651b5e7fee29f"},
+    {file = "charset-normalizer-3.2.0.tar.gz", hash = "sha256:3bb3d25a8e6c0aedd251753a79ae98a093c7e7b471faa3aa9a93a81431987ace"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:0b87549028f680ca955556e3bd57013ab47474c3124dc069faa0b6545b6c9710"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:7c70087bfee18a42b4040bb9ec1ca15a08242cf5867c58726530bdf3945672ed"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:a103b3a7069b62f5d4890ae1b8f0597618f628b286b03d4bc9195230b154bfa9"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:94aea8eff76ee6d1cdacb07dd2123a68283cb5569e0250feab1240058f53b623"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:db901e2ac34c931d73054d9797383d0f8009991e723dab15109740a63e7f902a"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b0dac0ff919ba34d4df1b6131f59ce95b08b9065233446be7e459f95554c0dc8"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:193cbc708ea3aca45e7221ae58f0fd63f933753a9bfb498a3b474878f12caaad"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:09393e1b2a9461950b1c9a45d5fd251dc7c6f228acab64da1c9c0165d9c7765c"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:baacc6aee0b2ef6f3d308e197b5d7a81c0e70b06beae1f1fcacffdbd124fe0e3"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:bf420121d4c8dce6b889f0e8e4ec0ca34b7f40186203f06a946fa0276ba54029"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-musllinux_1_1_ppc64le.whl", hash = "sha256:c04a46716adde8d927adb9457bbe39cf473e1e2c2f5d0a16ceb837e5d841ad4f"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-musllinux_1_1_s390x.whl", hash = "sha256:aaf63899c94de41fe3cf934601b0f7ccb6b428c6e4eeb80da72c58eab077b19a"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:d62e51710986674142526ab9f78663ca2b0726066ae26b78b22e0f5e571238dd"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-win32.whl", hash = "sha256:04e57ab9fbf9607b77f7d057974694b4f6b142da9ed4a199859d9d4d5c63fe96"},
+    {file = "charset_normalizer-3.2.0-cp310-cp310-win_amd64.whl", hash = "sha256:48021783bdf96e3d6de03a6e39a1171ed5bd7e8bb93fc84cc649d11490f87cea"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:4957669ef390f0e6719db3613ab3a7631e68424604a7b448f079bee145da6e09"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:46fb8c61d794b78ec7134a715a3e564aafc8f6b5e338417cb19fe9f57a5a9bf2"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:f779d3ad205f108d14e99bb3859aa7dd8e9c68874617c72354d7ecaec2a054ac"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f25c229a6ba38a35ae6e25ca1264621cc25d4d38dca2942a7fce0b67a4efe918"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:2efb1bd13885392adfda4614c33d3b68dee4921fd0ac1d3988f8cbb7d589e72a"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:1f30b48dd7fa1474554b0b0f3fdfdd4c13b5c737a3c6284d3cdc424ec0ffff3a"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:246de67b99b6851627d945db38147d1b209a899311b1305dd84916f2b88526c6"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9bd9b3b31adcb054116447ea22caa61a285d92e94d710aa5ec97992ff5eb7cf3"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:8c2f5e83493748286002f9369f3e6607c565a6a90425a3a1fef5ae32a36d749d"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:3170c9399da12c9dc66366e9d14da8bf7147e1e9d9ea566067bbce7bb74bd9c2"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-musllinux_1_1_ppc64le.whl", hash = "sha256:7a4826ad2bd6b07ca615c74ab91f32f6c96d08f6fcc3902ceeedaec8cdc3bcd6"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-musllinux_1_1_s390x.whl", hash = "sha256:3b1613dd5aee995ec6d4c69f00378bbd07614702a315a2cf6c1d21461fe17c23"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:9e608aafdb55eb9f255034709e20d5a83b6d60c054df0802fa9c9883d0a937aa"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-win32.whl", hash = "sha256:f2a1d0fd4242bd8643ce6f98927cf9c04540af6efa92323e9d3124f57727bfc1"},
+    {file = "charset_normalizer-3.2.0-cp311-cp311-win_amd64.whl", hash = "sha256:681eb3d7e02e3c3655d1b16059fbfb605ac464c834a0c629048a30fad2b27489"},
+    {file = "charset_normalizer-3.2.0-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:c57921cda3a80d0f2b8aec7e25c8aa14479ea92b5b51b6876d975d925a2ea346"},
+    {file = "charset_normalizer-3.2.0-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:41b25eaa7d15909cf3ac4c96088c1f266a9a93ec44f87f1d13d4a0e86c81b982"},
+    {file = "charset_normalizer-3.2.0-cp37-cp37m-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f058f6963fd82eb143c692cecdc89e075fa0828db2e5b291070485390b2f1c9c"},
+    {file = "charset_normalizer-3.2.0-cp37-cp37m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a7647ebdfb9682b7bb97e2a5e7cb6ae735b1c25008a70b906aecca294ee96cf4"},
+    {file = "charset_normalizer-3.2.0-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eef9df1eefada2c09a5e7a40991b9fc6ac6ef20b1372abd48d2794a316dc0449"},
+    {file = "charset_normalizer-3.2.0-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:e03b8895a6990c9ab2cdcd0f2fe44088ca1c65ae592b8f795c3294af00a461c3"},
+    {file = "charset_normalizer-3.2.0-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:ee4006268ed33370957f55bf2e6f4d263eaf4dc3cfc473d1d90baff6ed36ce4a"},
+    {file = "charset_normalizer-3.2.0-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:c4983bf937209c57240cff65906b18bb35e64ae872da6a0db937d7b4af845dd7"},
+    {file = "charset_normalizer-3.2.0-cp37-cp37m-musllinux_1_1_ppc64le.whl", hash = "sha256:3bb7fda7260735efe66d5107fb7e6af6a7c04c7fce9b2514e04b7a74b06bf5dd"},
+    {file = "charset_normalizer-3.2.0-cp37-cp37m-musllinux_1_1_s390x.whl", hash = "sha256:72814c01533f51d68702802d74f77ea026b5ec52793c791e2da806a3844a46c3"},
+    {file = "charset_normalizer-3.2.0-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:70c610f6cbe4b9fce272c407dd9d07e33e6bf7b4aa1b7ffb6f6ded8e634e3592"},
+    {file = "charset_normalizer-3.2.0-cp37-cp37m-win32.whl", hash = "sha256:a401b4598e5d3f4a9a811f3daf42ee2291790c7f9d74b18d75d6e21dda98a1a1"},
+    {file = "charset_normalizer-3.2.0-cp37-cp37m-win_amd64.whl", hash = "sha256:c0b21078a4b56965e2b12f247467b234734491897e99c1d51cee628da9786959"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:95eb302ff792e12aba9a8b8f8474ab229a83c103d74a750ec0bd1c1eea32e669"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:1a100c6d595a7f316f1b6f01d20815d916e75ff98c27a01ae817439ea7726329"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:6339d047dab2780cc6220f46306628e04d9750f02f983ddb37439ca47ced7149"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e4b749b9cc6ee664a3300bb3a273c1ca8068c46be705b6c31cf5d276f8628a94"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a38856a971c602f98472050165cea2cdc97709240373041b69030be15047691f"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f87f746ee241d30d6ed93969de31e5ffd09a2961a051e60ae6bddde9ec3583aa"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:89f1b185a01fe560bc8ae5f619e924407efca2191b56ce749ec84982fc59a32a"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:e1c8a2f4c69e08e89632defbfabec2feb8a8d99edc9f89ce33c4b9e36ab63037"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:2f4ac36d8e2b4cc1aa71df3dd84ff8efbe3bfb97ac41242fbcfc053c67434f46"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:a386ebe437176aab38c041de1260cd3ea459c6ce5263594399880bbc398225b2"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-musllinux_1_1_ppc64le.whl", hash = "sha256:ccd16eb18a849fd8dcb23e23380e2f0a354e8daa0c984b8a732d9cfaba3a776d"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-musllinux_1_1_s390x.whl", hash = "sha256:e6a5bf2cba5ae1bb80b154ed68a3cfa2fa00fde979a7f50d6598d3e17d9ac20c"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:45de3f87179c1823e6d9e32156fb14c1927fcc9aba21433f088fdfb555b77c10"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-win32.whl", hash = "sha256:1000fba1057b92a65daec275aec30586c3de2401ccdcd41f8a5c1e2c87078706"},
+    {file = "charset_normalizer-3.2.0-cp38-cp38-win_amd64.whl", hash = "sha256:8b2c760cfc7042b27ebdb4a43a4453bd829a5742503599144d54a032c5dc7e9e"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:855eafa5d5a2034b4621c74925d89c5efef61418570e5ef9b37717d9c796419c"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:203f0c8871d5a7987be20c72442488a0b8cfd0f43b7973771640fc593f56321f"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:e857a2232ba53ae940d3456f7533ce6ca98b81917d47adc3c7fd55dad8fab858"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5e86d77b090dbddbe78867a0275cb4df08ea195e660f1f7f13435a4649e954e5"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:c4fb39a81950ec280984b3a44f5bd12819953dc5fa3a7e6fa7a80db5ee853952"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2dee8e57f052ef5353cf608e0b4c871aee320dd1b87d351c28764fc0ca55f9f4"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8700f06d0ce6f128de3ccdbc1acaea1ee264d2caa9ca05daaf492fde7c2a7200"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1920d4ff15ce893210c1f0c0e9d19bfbecb7983c76b33f046c13a8ffbd570252"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:c1c76a1743432b4b60ab3358c937a3fe1341c828ae6194108a94c69028247f22"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:f7560358a6811e52e9c4d142d497f1a6e10103d3a6881f18d04dbce3729c0e2c"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-musllinux_1_1_ppc64le.whl", hash = "sha256:c8063cf17b19661471ecbdb3df1c84f24ad2e389e326ccaf89e3fb2484d8dd7e"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-musllinux_1_1_s390x.whl", hash = "sha256:cd6dbe0238f7743d0efe563ab46294f54f9bc8f4b9bcf57c3c666cc5bc9d1299"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:1249cbbf3d3b04902ff081ffbb33ce3377fa6e4c7356f759f3cd076cc138d020"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-win32.whl", hash = "sha256:6c409c0deba34f147f77efaa67b8e4bb83d2f11c8806405f76397ae5b8c0d1c9"},
+    {file = "charset_normalizer-3.2.0-cp39-cp39-win_amd64.whl", hash = "sha256:7095f6fbfaa55defb6b733cfeb14efaae7a29f0b59d8cf213be4e7ca0b857b80"},
+    {file = "charset_normalizer-3.2.0-py3-none-any.whl", hash = "sha256:8e098148dd37b4ce3baca71fb394c81dc5d9c7728c95df695d2dca218edf40e6"},
 ]
 
-[package.extras]
-unicode-backport = ["unicodedata2"]
-
 [[package]]
 name = "click"
-version = "8.1.3"
+version = "8.1.7"
 description = "Composable command line interface toolkit"
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "click-8.1.3-py3-none-any.whl", hash = "sha256:bb4d8133cb15a609f44e8213d9b391b0809795062913b383c62be0ee95b1db48"},
-    {file = "click-8.1.3.tar.gz", hash = "sha256:7682dc8afb30297001674575ea00d1814d808d6a36af415a82bd481d37ba7b8e"},
+    {file = "click-8.1.7-py3-none-any.whl", hash = "sha256:ae74fb96c20a0277a1d615f1e4d73c8414f5a98db8b799a7931d1582f3390c28"},
+    {file = "click-8.1.7.tar.gz", hash = "sha256:ca9853ad459e787e2192211578cc907e7594e294c7ccc834310722b41b9ca6de"},
 ]
 
 [package.dependencies]
@@ -166,6 +266,17 @@ files = [
     {file = "colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44"},
 ]
 
+[[package]]
+name = "cssselect"
+version = "1.2.0"
+description = "cssselect parses CSS3 Selectors and translates them to XPath 1.0"
+optional = false
+python-versions = ">=3.7"
+files = [
+    {file = "cssselect-1.2.0-py2.py3-none-any.whl", hash = "sha256:da1885f0c10b60c03ed5eccbb6b68d6eff248d91976fcde348f395d54c9fd35e"},
+    {file = "cssselect-1.2.0.tar.gz", hash = "sha256:666b19839cfaddb9ce9d36bfe4c969132c647b92fc9088c4e23f786b30f1b3dc"},
+]
+
 [[package]]
 name = "cssselect2"
 version = "0.7.0"
@@ -225,7 +336,7 @@ files = [
 ]
 
 [[package]]
-name = "Jinja2"
+name = "jinja2"
 version = "3.1.2"
 description = "A very fast and expressive template engine."
 optional = false
@@ -242,66 +353,200 @@ MarkupSafe = ">=2.0"
 i18n = ["Babel (>=2.7)"]
 
 [[package]]
-name = "Markdown"
-version = "3.3.7"
-description = "Python implementation of Markdown."
+name = "lxml"
+version = "4.9.3"
+description = "Powerful and Pythonic XML processing library combining libxml2/libxslt with the ElementTree API."
 optional = false
-python-versions = ">=3.6"
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, != 3.4.*"
 files = [
-    {file = "Markdown-3.3.7-py3-none-any.whl", hash = "sha256:f5da449a6e1c989a4cea2631aa8ee67caa5a2ef855d551c88f9e309f4634c621"},
-    {file = "Markdown-3.3.7.tar.gz", hash = "sha256:cbb516f16218e643d8e0a95b309f77eb118cb138d39a4f27851e6a63581db874"},
+    {file = "lxml-4.9.3-cp27-cp27m-macosx_11_0_x86_64.whl", hash = "sha256:b0a545b46b526d418eb91754565ba5b63b1c0b12f9bd2f808c852d9b4b2f9b5c"},
+    {file = "lxml-4.9.3-cp27-cp27m-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:075b731ddd9e7f68ad24c635374211376aa05a281673ede86cbe1d1b3455279d"},
+    {file = "lxml-4.9.3-cp27-cp27m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:1e224d5755dba2f4a9498e150c43792392ac9b5380aa1b845f98a1618c94eeef"},
+    {file = "lxml-4.9.3-cp27-cp27m-win32.whl", hash = "sha256:2c74524e179f2ad6d2a4f7caf70e2d96639c0954c943ad601a9e146c76408ed7"},
+    {file = "lxml-4.9.3-cp27-cp27m-win_amd64.whl", hash = "sha256:4f1026bc732b6a7f96369f7bfe1a4f2290fb34dce00d8644bc3036fb351a4ca1"},
+    {file = "lxml-4.9.3-cp27-cp27mu-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c0781a98ff5e6586926293e59480b64ddd46282953203c76ae15dbbbf302e8bb"},
+    {file = "lxml-4.9.3-cp27-cp27mu-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:cef2502e7e8a96fe5ad686d60b49e1ab03e438bd9123987994528febd569868e"},
+    {file = "lxml-4.9.3-cp310-cp310-macosx_11_0_x86_64.whl", hash = "sha256:b86164d2cff4d3aaa1f04a14685cbc072efd0b4f99ca5708b2ad1b9b5988a991"},
+    {file = "lxml-4.9.3-cp310-cp310-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:42871176e7896d5d45138f6d28751053c711ed4d48d8e30b498da155af39aebd"},
+    {file = "lxml-4.9.3-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:ae8b9c6deb1e634ba4f1930eb67ef6e6bf6a44b6eb5ad605642b2d6d5ed9ce3c"},
+    {file = "lxml-4.9.3-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:411007c0d88188d9f621b11d252cce90c4a2d1a49db6c068e3c16422f306eab8"},
+    {file = "lxml-4.9.3-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:cd47b4a0d41d2afa3e58e5bf1f62069255aa2fd6ff5ee41604418ca925911d76"},
+    {file = "lxml-4.9.3-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:0e2cb47860da1f7e9a5256254b74ae331687b9672dfa780eed355c4c9c3dbd23"},
+    {file = "lxml-4.9.3-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1247694b26342a7bf47c02e513d32225ededd18045264d40758abeb3c838a51f"},
+    {file = "lxml-4.9.3-cp310-cp310-win32.whl", hash = "sha256:cdb650fc86227eba20de1a29d4b2c1bfe139dc75a0669270033cb2ea3d391b85"},
+    {file = "lxml-4.9.3-cp310-cp310-win_amd64.whl", hash = "sha256:97047f0d25cd4bcae81f9ec9dc290ca3e15927c192df17331b53bebe0e3ff96d"},
+    {file = "lxml-4.9.3-cp311-cp311-macosx_11_0_universal2.whl", hash = "sha256:1f447ea5429b54f9582d4b955f5f1985f278ce5cf169f72eea8afd9502973dd5"},
+    {file = "lxml-4.9.3-cp311-cp311-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:57d6ba0ca2b0c462f339640d22882acc711de224d769edf29962b09f77129cbf"},
+    {file = "lxml-4.9.3-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:9767e79108424fb6c3edf8f81e6730666a50feb01a328f4a016464a5893f835a"},
+    {file = "lxml-4.9.3-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:71c52db65e4b56b8ddc5bb89fb2e66c558ed9d1a74a45ceb7dcb20c191c3df2f"},
+    {file = "lxml-4.9.3-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:d73d8ecf8ecf10a3bd007f2192725a34bd62898e8da27eb9d32a58084f93962b"},
+    {file = "lxml-4.9.3-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:0a3d3487f07c1d7f150894c238299934a2a074ef590b583103a45002035be120"},
+    {file = "lxml-4.9.3-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:9e28c51fa0ce5674be9f560c6761c1b441631901993f76700b1b30ca6c8378d6"},
+    {file = "lxml-4.9.3-cp311-cp311-win32.whl", hash = "sha256:0bfd0767c5c1de2551a120673b72e5d4b628737cb05414f03c3277bf9bed3305"},
+    {file = "lxml-4.9.3-cp311-cp311-win_amd64.whl", hash = "sha256:25f32acefac14ef7bd53e4218fe93b804ef6f6b92ffdb4322bb6d49d94cad2bc"},
+    {file = "lxml-4.9.3-cp312-cp312-macosx_11_0_universal2.whl", hash = "sha256:d3ff32724f98fbbbfa9f49d82852b159e9784d6094983d9a8b7f2ddaebb063d4"},
+    {file = "lxml-4.9.3-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:48d6ed886b343d11493129e019da91d4039826794a3e3027321c56d9e71505be"},
+    {file = "lxml-4.9.3-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:9a92d3faef50658dd2c5470af249985782bf754c4e18e15afb67d3ab06233f13"},
+    {file = "lxml-4.9.3-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:b4e4bc18382088514ebde9328da057775055940a1f2e18f6ad2d78aa0f3ec5b9"},
+    {file = "lxml-4.9.3-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:fc9b106a1bf918db68619fdcd6d5ad4f972fdd19c01d19bdb6bf63f3589a9ec5"},
+    {file = "lxml-4.9.3-cp312-cp312-win_amd64.whl", hash = "sha256:d37017287a7adb6ab77e1c5bee9bcf9660f90ff445042b790402a654d2ad81d8"},
+    {file = "lxml-4.9.3-cp35-cp35m-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:56dc1f1ebccc656d1b3ed288f11e27172a01503fc016bcabdcbc0978b19352b7"},
+    {file = "lxml-4.9.3-cp35-cp35m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:578695735c5a3f51569810dfebd05dd6f888147a34f0f98d4bb27e92b76e05c2"},
+    {file = "lxml-4.9.3-cp35-cp35m-win32.whl", hash = "sha256:704f61ba8c1283c71b16135caf697557f5ecf3e74d9e453233e4771d68a1f42d"},
+    {file = "lxml-4.9.3-cp35-cp35m-win_amd64.whl", hash = "sha256:c41bfca0bd3532d53d16fd34d20806d5c2b1ace22a2f2e4c0008570bf2c58833"},
+    {file = "lxml-4.9.3-cp36-cp36m-macosx_11_0_x86_64.whl", hash = "sha256:64f479d719dc9f4c813ad9bb6b28f8390360660b73b2e4beb4cb0ae7104f1c12"},
+    {file = "lxml-4.9.3-cp36-cp36m-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:dd708cf4ee4408cf46a48b108fb9427bfa00b9b85812a9262b5c668af2533ea5"},
+    {file = "lxml-4.9.3-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5c31c7462abdf8f2ac0577d9f05279727e698f97ecbb02f17939ea99ae8daa98"},
+    {file = "lxml-4.9.3-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:e3cd95e10c2610c360154afdc2f1480aea394f4a4f1ea0a5eacce49640c9b190"},
+    {file = "lxml-4.9.3-cp36-cp36m-manylinux_2_28_x86_64.whl", hash = "sha256:4930be26af26ac545c3dffb662521d4e6268352866956672231887d18f0eaab2"},
+    {file = "lxml-4.9.3-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4aec80cde9197340bc353d2768e2a75f5f60bacda2bab72ab1dc499589b3878c"},
+    {file = "lxml-4.9.3-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:14e019fd83b831b2e61baed40cab76222139926b1fb5ed0e79225bc0cae14584"},
+    {file = "lxml-4.9.3-cp36-cp36m-musllinux_1_1_aarch64.whl", hash = "sha256:0c0850c8b02c298d3c7006b23e98249515ac57430e16a166873fc47a5d549287"},
+    {file = "lxml-4.9.3-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:aca086dc5f9ef98c512bac8efea4483eb84abbf926eaeedf7b91479feb092458"},
+    {file = "lxml-4.9.3-cp36-cp36m-win32.whl", hash = "sha256:50baa9c1c47efcaef189f31e3d00d697c6d4afda5c3cde0302d063492ff9b477"},
+    {file = "lxml-4.9.3-cp36-cp36m-win_amd64.whl", hash = "sha256:bef4e656f7d98aaa3486d2627e7d2df1157d7e88e7efd43a65aa5dd4714916cf"},
+    {file = "lxml-4.9.3-cp37-cp37m-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:46f409a2d60f634fe550f7133ed30ad5321ae2e6630f13657fb9479506b00601"},
+    {file = "lxml-4.9.3-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:4c28a9144688aef80d6ea666c809b4b0e50010a2aca784c97f5e6bf143d9f129"},
+    {file = "lxml-4.9.3-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:141f1d1a9b663c679dc524af3ea1773e618907e96075262726c7612c02b149a4"},
+    {file = "lxml-4.9.3-cp37-cp37m-manylinux_2_28_x86_64.whl", hash = "sha256:53ace1c1fd5a74ef662f844a0413446c0629d151055340e9893da958a374f70d"},
+    {file = "lxml-4.9.3-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:17a753023436a18e27dd7769e798ce302963c236bc4114ceee5b25c18c52c693"},
+    {file = "lxml-4.9.3-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:7d298a1bd60c067ea75d9f684f5f3992c9d6766fadbc0bcedd39750bf344c2f4"},
+    {file = "lxml-4.9.3-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:081d32421db5df44c41b7f08a334a090a545c54ba977e47fd7cc2deece78809a"},
+    {file = "lxml-4.9.3-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:23eed6d7b1a3336ad92d8e39d4bfe09073c31bfe502f20ca5116b2a334f8ec02"},
+    {file = "lxml-4.9.3-cp37-cp37m-win32.whl", hash = "sha256:1509dd12b773c02acd154582088820893109f6ca27ef7291b003d0e81666109f"},
+    {file = "lxml-4.9.3-cp37-cp37m-win_amd64.whl", hash = "sha256:120fa9349a24c7043854c53cae8cec227e1f79195a7493e09e0c12e29f918e52"},
+    {file = "lxml-4.9.3-cp38-cp38-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:4d2d1edbca80b510443f51afd8496be95529db04a509bc8faee49c7b0fb6d2cc"},
+    {file = "lxml-4.9.3-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:8d7e43bd40f65f7d97ad8ef5c9b1778943d02f04febef12def25f7583d19baac"},
+    {file = "lxml-4.9.3-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:71d66ee82e7417828af6ecd7db817913cb0cf9d4e61aa0ac1fde0583d84358db"},
+    {file = "lxml-4.9.3-cp38-cp38-manylinux_2_28_x86_64.whl", hash = "sha256:6fc3c450eaa0b56f815c7b62f2b7fba7266c4779adcf1cece9e6deb1de7305ce"},
+    {file = "lxml-4.9.3-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:65299ea57d82fb91c7f019300d24050c4ddeb7c5a190e076b5f48a2b43d19c42"},
+    {file = "lxml-4.9.3-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:eadfbbbfb41b44034a4c757fd5d70baccd43296fb894dba0295606a7cf3124aa"},
+    {file = "lxml-4.9.3-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:3e9bdd30efde2b9ccfa9cb5768ba04fe71b018a25ea093379c857c9dad262c40"},
+    {file = "lxml-4.9.3-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:fcdd00edfd0a3001e0181eab3e63bd5c74ad3e67152c84f93f13769a40e073a7"},
+    {file = "lxml-4.9.3-cp38-cp38-win32.whl", hash = "sha256:57aba1bbdf450b726d58b2aea5fe47c7875f5afb2c4a23784ed78f19a0462574"},
+    {file = "lxml-4.9.3-cp38-cp38-win_amd64.whl", hash = "sha256:92af161ecbdb2883c4593d5ed4815ea71b31fafd7fd05789b23100d081ecac96"},
+    {file = "lxml-4.9.3-cp39-cp39-macosx_11_0_x86_64.whl", hash = "sha256:9bb6ad405121241e99a86efff22d3ef469024ce22875a7ae045896ad23ba2340"},
+    {file = "lxml-4.9.3-cp39-cp39-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:8ed74706b26ad100433da4b9d807eae371efaa266ffc3e9191ea436087a9d6a7"},
+    {file = "lxml-4.9.3-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:fbf521479bcac1e25a663df882c46a641a9bff6b56dc8b0fafaebd2f66fb231b"},
+    {file = "lxml-4.9.3-cp39-cp39-manylinux_2_28_aarch64.whl", hash = "sha256:303bf1edce6ced16bf67a18a1cf8339d0db79577eec5d9a6d4a80f0fb10aa2da"},
+    {file = "lxml-4.9.3-cp39-cp39-manylinux_2_28_x86_64.whl", hash = "sha256:5515edd2a6d1a5a70bfcdee23b42ec33425e405c5b351478ab7dc9347228f96e"},
+    {file = "lxml-4.9.3-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:690dafd0b187ed38583a648076865d8c229661ed20e48f2335d68e2cf7dc829d"},
+    {file = "lxml-4.9.3-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:b6420a005548ad52154c8ceab4a1290ff78d757f9e5cbc68f8c77089acd3c432"},
+    {file = "lxml-4.9.3-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:bb3bb49c7a6ad9d981d734ef7c7193bc349ac338776a0360cc671eaee89bcf69"},
+    {file = "lxml-4.9.3-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:d27be7405547d1f958b60837dc4c1007da90b8b23f54ba1f8b728c78fdb19d50"},
+    {file = "lxml-4.9.3-cp39-cp39-win32.whl", hash = "sha256:8df133a2ea5e74eef5e8fc6f19b9e085f758768a16e9877a60aec455ed2609b2"},
+    {file = "lxml-4.9.3-cp39-cp39-win_amd64.whl", hash = "sha256:4dd9a263e845a72eacb60d12401e37c616438ea2e5442885f65082c276dfb2b2"},
+    {file = "lxml-4.9.3-pp310-pypy310_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:6689a3d7fd13dc687e9102a27e98ef33730ac4fe37795d5036d18b4d527abd35"},
+    {file = "lxml-4.9.3-pp37-pypy37_pp73-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:f6bdac493b949141b733c5345b6ba8f87a226029cbabc7e9e121a413e49441e0"},
+    {file = "lxml-4.9.3-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:05186a0f1346ae12553d66df1cfce6f251589fea3ad3da4f3ef4e34b2d58c6a3"},
+    {file = "lxml-4.9.3-pp37-pypy37_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:c2006f5c8d28dee289f7020f721354362fa304acbaaf9745751ac4006650254b"},
+    {file = "lxml-4.9.3-pp38-pypy38_pp73-macosx_11_0_x86_64.whl", hash = "sha256:5c245b783db29c4e4fbbbfc9c5a78be496c9fea25517f90606aa1f6b2b3d5f7b"},
+    {file = "lxml-4.9.3-pp38-pypy38_pp73-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:4fb960a632a49f2f089d522f70496640fdf1218f1243889da3822e0a9f5f3ba7"},
+    {file = "lxml-4.9.3-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:50670615eaf97227d5dc60de2dc99fb134a7130d310d783314e7724bf163f75d"},
+    {file = "lxml-4.9.3-pp38-pypy38_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:9719fe17307a9e814580af1f5c6e05ca593b12fb7e44fe62450a5384dbf61b4b"},
+    {file = "lxml-4.9.3-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:3331bece23c9ee066e0fb3f96c61322b9e0f54d775fccefff4c38ca488de283a"},
+    {file = "lxml-4.9.3-pp39-pypy39_pp73-macosx_11_0_x86_64.whl", hash = "sha256:ed667f49b11360951e201453fc3967344d0d0263aa415e1619e85ae7fd17b4e0"},
+    {file = "lxml-4.9.3-pp39-pypy39_pp73-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:8b77946fd508cbf0fccd8e400a7f71d4ac0e1595812e66025bac475a8e811694"},
+    {file = "lxml-4.9.3-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:e4da8ca0c0c0aea88fd46be8e44bd49716772358d648cce45fe387f7b92374a7"},
+    {file = "lxml-4.9.3-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:fe4bda6bd4340caa6e5cf95e73f8fea5c4bfc55763dd42f1b50a94c1b4a2fbd4"},
+    {file = "lxml-4.9.3-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:f3df3db1d336b9356dd3112eae5f5c2b8b377f3bc826848567f10bfddfee77e9"},
+    {file = "lxml-4.9.3.tar.gz", hash = "sha256:48628bd53a426c9eb9bc066a923acaa0878d1e86129fd5359aee99285f4eed9c"},
 ]
 
 [package.extras]
+cssselect = ["cssselect (>=0.7)"]
+html5 = ["html5lib"]
+htmlsoup = ["BeautifulSoup4"]
+source = ["Cython (>=0.29.35)"]
+
+[[package]]
+name = "markdown"
+version = "3.4.4"
+description = "Python implementation of John Gruber's Markdown."
+optional = false
+python-versions = ">=3.7"
+files = [
+    {file = "Markdown-3.4.4-py3-none-any.whl", hash = "sha256:a4c1b65c0957b4bd9e7d86ddc7b3c9868fb9670660f6f99f6d1bca8954d5a941"},
+    {file = "Markdown-3.4.4.tar.gz", hash = "sha256:225c6123522495d4119a90b3a3ba31a1e87a70369e03f14799ea9c0d7183a3d6"},
+]
+
+[package.extras]
+docs = ["mdx-gh-links (>=0.2)", "mkdocs (>=1.0)", "mkdocs-nature (>=0.4)"]
 testing = ["coverage", "pyyaml"]
 
 [[package]]
-name = "MarkupSafe"
-version = "2.1.1"
+name = "markdown2"
+version = "2.4.10"
+description = "A fast and complete Python implementation of Markdown"
+optional = false
+python-versions = ">=3.5, <4"
+files = [
+    {file = "markdown2-2.4.10-py2.py3-none-any.whl", hash = "sha256:e6105800483783831f5dc54f827aa5b44eb137ecef5a70293d8ecfbb4109ecc6"},
+    {file = "markdown2-2.4.10.tar.gz", hash = "sha256:cdba126d90dc3aef6f4070ac342f974d63f415678959329cc7909f96cc235d72"},
+]
+
+[package.extras]
+all = ["pygments (>=2.7.3)", "wavedrom"]
+code-syntax-highlighting = ["pygments (>=2.7.3)"]
+wavedrom = ["wavedrom"]
+
+[[package]]
+name = "markupsafe"
+version = "2.1.3"
 description = "Safely add untrusted strings to HTML/XML markup."
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "MarkupSafe-2.1.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:86b1f75c4e7c2ac2ccdaec2b9022845dbb81880ca318bb7a0a01fbf7813e3812"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:f121a1420d4e173a5d96e47e9a0c0dcff965afdf1626d28de1460815f7c4ee7a"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a49907dd8420c5685cfa064a1335b6754b74541bbb3706c259c02ed65b644b3e"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:10c1bfff05d95783da83491be968e8fe789263689c02724e0c691933c52994f5"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b7bd98b796e2b6553da7225aeb61f447f80a1ca64f41d83612e6139ca5213aa4"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:b09bf97215625a311f669476f44b8b318b075847b49316d3e28c08e41a7a573f"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:694deca8d702d5db21ec83983ce0bb4b26a578e71fbdbd4fdcd387daa90e4d5e"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:efc1913fd2ca4f334418481c7e595c00aad186563bbc1ec76067848c7ca0a933"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-win32.whl", hash = "sha256:4a33dea2b688b3190ee12bd7cfa29d39c9ed176bda40bfa11099a3ce5d3a7ac6"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:dda30ba7e87fbbb7eab1ec9f58678558fd9a6b8b853530e176eabd064da81417"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:671cd1187ed5e62818414afe79ed29da836dde67166a9fac6d435873c44fdd02"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3799351e2336dc91ea70b034983ee71cf2f9533cdff7c14c90ea126bfd95d65a"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e72591e9ecd94d7feb70c1cbd7be7b3ebea3f548870aa91e2732960fa4d57a37"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6fbf47b5d3728c6aea2abb0589b5d30459e369baa772e0f37a0320185e87c980"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:d5ee4f386140395a2c818d149221149c54849dfcfcb9f1debfe07a8b8bd63f9a"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:bcb3ed405ed3222f9904899563d6fc492ff75cce56cba05e32eff40e6acbeaa3"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:e1c0b87e09fa55a220f058d1d49d3fb8df88fbfab58558f1198e08c1e1de842a"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-win32.whl", hash = "sha256:8dc1c72a69aa7e082593c4a203dcf94ddb74bb5c8a731e4e1eb68d031e8498ff"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-win_amd64.whl", hash = "sha256:97a68e6ada378df82bc9f16b800ab77cbf4b2fada0081794318520138c088e4a"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:e8c843bbcda3a2f1e3c2ab25913c80a3c5376cd00c6e8c4a86a89a28c8dc5452"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:0212a68688482dc52b2d45013df70d169f542b7394fc744c02a57374a4207003"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8e576a51ad59e4bfaac456023a78f6b5e6e7651dcd383bcc3e18d06f9b55d6d1"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4b9fe39a2ccc108a4accc2676e77da025ce383c108593d65cc909add5c3bd601"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:96e37a3dc86e80bf81758c152fe66dbf60ed5eca3d26305edf01892257049925"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:6d0072fea50feec76a4c418096652f2c3238eaa014b2f94aeb1d56a66b41403f"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:089cf3dbf0cd6c100f02945abeb18484bd1ee57a079aefd52cffd17fba910b88"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:6a074d34ee7a5ce3effbc526b7083ec9731bb3cbf921bbe1d3005d4d2bdb3a63"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-win32.whl", hash = "sha256:421be9fbf0ffe9ffd7a378aafebbf6f4602d564d34be190fc19a193232fd12b1"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-win_amd64.whl", hash = "sha256:fc7b548b17d238737688817ab67deebb30e8073c95749d55538ed473130ec0c7"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:e04e26803c9c3851c931eac40c695602c6295b8d432cbe78609649ad9bd2da8a"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:b87db4360013327109564f0e591bd2a3b318547bcef31b468a92ee504d07ae4f"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:99a2a507ed3ac881b975a2976d59f38c19386d128e7a9a18b7df6fff1fd4c1d6"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:56442863ed2b06d19c37f94d999035e15ee982988920e12a5b4ba29b62ad1f77"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3ce11ee3f23f79dbd06fb3d63e2f6af7b12db1d46932fe7bd8afa259a5996603"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:33b74d289bd2f5e527beadcaa3f401e0df0a89927c1559c8566c066fa4248ab7"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:43093fb83d8343aac0b1baa75516da6092f58f41200907ef92448ecab8825135"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:8e3dcf21f367459434c18e71b2a9532d96547aef8a871872a5bd69a715c15f96"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-win32.whl", hash = "sha256:d4306c36ca495956b6d568d276ac11fdd9c30a36f1b6eb928070dc5360b22e1c"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-win_amd64.whl", hash = "sha256:46d00d6cfecdde84d40e572d63735ef81423ad31184100411e6e3388d405e247"},
-    {file = "MarkupSafe-2.1.1.tar.gz", hash = "sha256:7f91197cc9e48f989d12e4e6fbc46495c446636dfc81b9ccf50bb0ec74b91d4b"},
+    {file = "MarkupSafe-2.1.3-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:cd0f502fe016460680cd20aaa5a76d241d6f35a1c3350c474bac1273803893fa"},
+    {file = "MarkupSafe-2.1.3-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:e09031c87a1e51556fdcb46e5bd4f59dfb743061cf93c4d6831bf894f125eb57"},
+    {file = "MarkupSafe-2.1.3-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:68e78619a61ecf91e76aa3e6e8e33fc4894a2bebe93410754bd28fce0a8a4f9f"},
+    {file = "MarkupSafe-2.1.3-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:65c1a9bcdadc6c28eecee2c119465aebff8f7a584dd719facdd9e825ec61ab52"},
+    {file = "MarkupSafe-2.1.3-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:525808b8019e36eb524b8c68acdd63a37e75714eac50e988180b169d64480a00"},
+    {file = "MarkupSafe-2.1.3-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:962f82a3086483f5e5f64dbad880d31038b698494799b097bc59c2edf392fce6"},
+    {file = "MarkupSafe-2.1.3-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:aa7bd130efab1c280bed0f45501b7c8795f9fdbeb02e965371bbef3523627779"},
+    {file = "MarkupSafe-2.1.3-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:c9c804664ebe8f83a211cace637506669e7890fec1b4195b505c214e50dd4eb7"},
+    {file = "MarkupSafe-2.1.3-cp310-cp310-win32.whl", hash = "sha256:10bbfe99883db80bdbaff2dcf681dfc6533a614f700da1287707e8a5d78a8431"},
+    {file = "MarkupSafe-2.1.3-cp310-cp310-win_amd64.whl", hash = "sha256:1577735524cdad32f9f694208aa75e422adba74f1baee7551620e43a3141f559"},
+    {file = "MarkupSafe-2.1.3-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:ad9e82fb8f09ade1c3e1b996a6337afac2b8b9e365f926f5a61aacc71adc5b3c"},
+    {file = "MarkupSafe-2.1.3-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:3c0fae6c3be832a0a0473ac912810b2877c8cb9d76ca48de1ed31e1c68386575"},
+    {file = "MarkupSafe-2.1.3-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b076b6226fb84157e3f7c971a47ff3a679d837cf338547532ab866c57930dbee"},
+    {file = "MarkupSafe-2.1.3-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bfce63a9e7834b12b87c64d6b155fdd9b3b96191b6bd334bf37db7ff1fe457f2"},
+    {file = "MarkupSafe-2.1.3-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:338ae27d6b8745585f87218a3f23f1512dbf52c26c28e322dbe54bcede54ccb9"},
+    {file = "MarkupSafe-2.1.3-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:e4dd52d80b8c83fdce44e12478ad2e85c64ea965e75d66dbeafb0a3e77308fcc"},
+    {file = "MarkupSafe-2.1.3-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:df0be2b576a7abbf737b1575f048c23fb1d769f267ec4358296f31c2479db8f9"},
+    {file = "MarkupSafe-2.1.3-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:5bbe06f8eeafd38e5d0a4894ffec89378b6c6a625ff57e3028921f8ff59318ac"},
+    {file = "MarkupSafe-2.1.3-cp311-cp311-win32.whl", hash = "sha256:dd15ff04ffd7e05ffcb7fe79f1b98041b8ea30ae9234aed2a9168b5797c3effb"},
+    {file = "MarkupSafe-2.1.3-cp311-cp311-win_amd64.whl", hash = "sha256:134da1eca9ec0ae528110ccc9e48041e0828d79f24121a1a146161103c76e686"},
+    {file = "MarkupSafe-2.1.3-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:8e254ae696c88d98da6555f5ace2279cf7cd5b3f52be2b5cf97feafe883b58d2"},
+    {file = "MarkupSafe-2.1.3-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cb0932dc158471523c9637e807d9bfb93e06a95cbf010f1a38b98623b929ef2b"},
+    {file = "MarkupSafe-2.1.3-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9402b03f1a1b4dc4c19845e5c749e3ab82d5078d16a2a4c2cd2df62d57bb0707"},
+    {file = "MarkupSafe-2.1.3-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ca379055a47383d02a5400cb0d110cef0a776fc644cda797db0c5696cfd7e18e"},
+    {file = "MarkupSafe-2.1.3-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:b7ff0f54cb4ff66dd38bebd335a38e2c22c41a8ee45aa608efc890ac3e3931bc"},
+    {file = "MarkupSafe-2.1.3-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:c011a4149cfbcf9f03994ec2edffcb8b1dc2d2aede7ca243746df97a5d41ce48"},
+    {file = "MarkupSafe-2.1.3-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:56d9f2ecac662ca1611d183feb03a3fa4406469dafe241673d521dd5ae92a155"},
+    {file = "MarkupSafe-2.1.3-cp37-cp37m-win32.whl", hash = "sha256:8758846a7e80910096950b67071243da3e5a20ed2546e6392603c096778d48e0"},
+    {file = "MarkupSafe-2.1.3-cp37-cp37m-win_amd64.whl", hash = "sha256:787003c0ddb00500e49a10f2844fac87aa6ce977b90b0feaaf9de23c22508b24"},
+    {file = "MarkupSafe-2.1.3-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:2ef12179d3a291be237280175b542c07a36e7f60718296278d8593d21ca937d4"},
+    {file = "MarkupSafe-2.1.3-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:2c1b19b3aaacc6e57b7e25710ff571c24d6c3613a45e905b1fde04d691b98ee0"},
+    {file = "MarkupSafe-2.1.3-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8afafd99945ead6e075b973fefa56379c5b5c53fd8937dad92c662da5d8fd5ee"},
+    {file = "MarkupSafe-2.1.3-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c41976a29d078bb235fea9b2ecd3da465df42a562910f9022f1a03107bd02be"},
+    {file = "MarkupSafe-2.1.3-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d080e0a5eb2529460b30190fcfcc4199bd7f827663f858a226a81bc27beaa97e"},
+    {file = "MarkupSafe-2.1.3-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:69c0f17e9f5a7afdf2cc9fb2d1ce6aabdb3bafb7f38017c0b77862bcec2bbad8"},
+    {file = "MarkupSafe-2.1.3-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:504b320cd4b7eff6f968eddf81127112db685e81f7e36e75f9f84f0df46041c3"},
+    {file = "MarkupSafe-2.1.3-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:42de32b22b6b804f42c5d98be4f7e5e977ecdd9ee9b660fda1a3edf03b11792d"},
+    {file = "MarkupSafe-2.1.3-cp38-cp38-win32.whl", hash = "sha256:ceb01949af7121f9fc39f7d27f91be8546f3fb112c608bc4029aef0bab86a2a5"},
+    {file = "MarkupSafe-2.1.3-cp38-cp38-win_amd64.whl", hash = "sha256:1b40069d487e7edb2676d3fbdb2b0829ffa2cd63a2ec26c4938b2d34391b4ecc"},
+    {file = "MarkupSafe-2.1.3-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:8023faf4e01efadfa183e863fefde0046de576c6f14659e8782065bcece22198"},
+    {file = "MarkupSafe-2.1.3-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:6b2b56950d93e41f33b4223ead100ea0fe11f8e6ee5f641eb753ce4b77a7042b"},
+    {file = "MarkupSafe-2.1.3-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9dcdfd0eaf283af041973bff14a2e143b8bd64e069f4c383416ecd79a81aab58"},
+    {file = "MarkupSafe-2.1.3-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:05fb21170423db021895e1ea1e1f3ab3adb85d1c2333cbc2310f2a26bc77272e"},
+    {file = "MarkupSafe-2.1.3-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:282c2cb35b5b673bbcadb33a585408104df04f14b2d9b01d4c345a3b92861c2c"},
+    {file = "MarkupSafe-2.1.3-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:ab4a0df41e7c16a1392727727e7998a467472d0ad65f3ad5e6e765015df08636"},
+    {file = "MarkupSafe-2.1.3-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:7ef3cb2ebbf91e330e3bb937efada0edd9003683db6b57bb108c4001f37a02ea"},
+    {file = "MarkupSafe-2.1.3-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:0a4e4a1aff6c7ac4cd55792abf96c915634c2b97e3cc1c7129578aa68ebd754e"},
+    {file = "MarkupSafe-2.1.3-cp39-cp39-win32.whl", hash = "sha256:fec21693218efe39aa7f8599346e90c705afa52c5b31ae019b2e57e8f6542bb2"},
+    {file = "MarkupSafe-2.1.3-cp39-cp39-win_amd64.whl", hash = "sha256:3fd4abcb888d15a94f32b75d8fd18ee162ca0c064f35b11134be77050296d6ba"},
+    {file = "MarkupSafe-2.1.3.tar.gz", hash = "sha256:af598ed32d6ae86f1b747b82783958b1a4ab8f617b06fe68795c7f026abbdcad"},
 ]
 
 [[package]]
@@ -317,13 +562,13 @@ files = [
 
 [[package]]
 name = "mkdocs"
-version = "1.4.3"
+version = "1.5.2"
 description = "Project documentation with Markdown."
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "mkdocs-1.4.3-py3-none-any.whl", hash = "sha256:6ee46d309bda331aac915cd24aab882c179a933bd9e77b80ce7d2eaaa3f689dd"},
-    {file = "mkdocs-1.4.3.tar.gz", hash = "sha256:5955093bbd4dd2e9403c5afaf57324ad8b04f16886512a3ee6ef828956481c57"},
+    {file = "mkdocs-1.5.2-py3-none-any.whl", hash = "sha256:60a62538519c2e96fe8426654a67ee177350451616118a41596ae7c876bb7eac"},
+    {file = "mkdocs-1.5.2.tar.gz", hash = "sha256:70d0da09c26cff288852471be03c23f0f521fc15cf16ac89c7a3bfb9ae8d24f9"},
 ]
 
 [package.dependencies]
@@ -331,63 +576,88 @@ click = ">=7.0"
 colorama = {version = ">=0.4", markers = "platform_system == \"Windows\""}
 ghp-import = ">=1.0"
 jinja2 = ">=2.11.1"
-markdown = ">=3.2.1,<3.4"
+markdown = ">=3.2.1"
+markupsafe = ">=2.0.1"
 mergedeep = ">=1.3.4"
 packaging = ">=20.5"
+pathspec = ">=0.11.1"
+platformdirs = ">=2.2.0"
 pyyaml = ">=5.1"
 pyyaml-env-tag = ">=0.1"
 watchdog = ">=2.0"
 
 [package.extras]
 i18n = ["babel (>=2.9.0)"]
-min-versions = ["babel (==2.9.0)", "click (==7.0)", "colorama (==0.4)", "ghp-import (==1.0)", "importlib-metadata (==4.3)", "jinja2 (==2.11.1)", "markdown (==3.2.1)", "markupsafe (==2.0.1)", "mergedeep (==1.3.4)", "packaging (==20.5)", "pyyaml (==5.1)", "pyyaml-env-tag (==0.1)", "typing-extensions (==3.10)", "watchdog (==2.0)"]
+min-versions = ["babel (==2.9.0)", "click (==7.0)", "colorama (==0.4)", "ghp-import (==1.0)", "importlib-metadata (==4.3)", "jinja2 (==2.11.1)", "markdown (==3.2.1)", "markupsafe (==2.0.1)", "mergedeep (==1.3.4)", "packaging (==20.5)", "pathspec (==0.11.1)", "platformdirs (==2.2.0)", "pyyaml (==5.1)", "pyyaml-env-tag (==0.1)", "typing-extensions (==3.10)", "watchdog (==2.0)"]
 
 [[package]]
 name = "mkdocs-material"
-version = "9.1.16"
+version = "9.2.5"
 description = "Documentation that simply works"
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "mkdocs_material-9.1.16-py3-none-any.whl", hash = "sha256:f9e62558a6b01ffac314423cbc223d970c25fbc78999860226245b64e64d6751"},
-    {file = "mkdocs_material-9.1.16.tar.gz", hash = "sha256:1021bfea20f00a9423530c8c2ae9be3c78b80f5a527b3f822e6de3d872e5ab79"},
+    {file = "mkdocs_material-9.2.5-py3-none-any.whl", hash = "sha256:315a59725f0565bccfec7f9d1313beae7658bf874a176264b98f804a0cbc1298"},
+    {file = "mkdocs_material-9.2.5.tar.gz", hash = "sha256:02b4d1f662bc022e9497411e679323c30185e031a08a7004c763aa8d47ae9a29"},
 ]
 
 [package.dependencies]
+babel = ">=2.10.3"
 colorama = ">=0.4"
 jinja2 = ">=3.0"
+lxml = ">=4.6"
 markdown = ">=3.2"
-mkdocs = ">=1.4.2"
+mkdocs = ">=1.5.2"
 mkdocs-material-extensions = ">=1.1"
+paginate = ">=0.5.6"
 pygments = ">=2.14"
 pymdown-extensions = ">=9.9.1"
+readtime = ">=2.0"
 regex = ">=2022.4.24"
 requests = ">=2.26"
 
 [[package]]
 name = "mkdocs-material-extensions"
-version = "1.1"
+version = "1.1.1"
 description = "Extension pack for Python Markdown and MkDocs Material."
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "mkdocs_material_extensions-1.1-py3-none-any.whl", hash = "sha256:bcc2e5fc70c0ec50e59703ee6e639d87c7e664c0c441c014ea84461a90f1e902"},
-    {file = "mkdocs_material_extensions-1.1.tar.gz", hash = "sha256:96ca979dae66d65c2099eefe189b49d5ac62f76afb59c38e069ffc7cf3c131ec"},
+    {file = "mkdocs_material_extensions-1.1.1-py3-none-any.whl", hash = "sha256:e41d9f38e4798b6617ad98ca8f7f1157b1e4385ac1459ca1e4ea219b556df945"},
+    {file = "mkdocs_material_extensions-1.1.1.tar.gz", hash = "sha256:9c003da71e2cc2493d910237448c672e00cefc800d3d6ae93d2fc69979e3bd93"},
 ]
 
 [[package]]
 name = "packaging"
-version = "21.3"
+version = "23.1"
 description = "Core utilities for Python packages"
 optional = false
-python-versions = ">=3.6"
+python-versions = ">=3.7"
 files = [
-    {file = "packaging-21.3-py3-none-any.whl", hash = "sha256:ef103e05f519cdc783ae24ea4e2e0f508a9c99b2d4969652eed6a2e1ea5bd522"},
-    {file = "packaging-21.3.tar.gz", hash = "sha256:dd47c42927d89ab911e606518907cc2d3a1f38bbd026385970643f9c5b8ecfeb"},
+    {file = "packaging-23.1-py3-none-any.whl", hash = "sha256:994793af429502c4ea2ebf6bf664629d07c1a9fe974af92966e4b8d2df7edc61"},
+    {file = "packaging-23.1.tar.gz", hash = "sha256:a392980d2b6cffa644431898be54b0045151319d1e7ec34f0cfed48767dd334f"},
 ]
 
-[package.dependencies]
-pyparsing = ">=2.0.2,<3.0.5 || >3.0.5"
+[[package]]
+name = "paginate"
+version = "0.5.6"
+description = "Divides large result sets into pages for easier browsing"
+optional = false
+python-versions = "*"
+files = [
+    {file = "paginate-0.5.6.tar.gz", hash = "sha256:5e6007b6a9398177a7e1648d04fdd9f8c9766a1a945bceac82f1929e8c78af2d"},
+]
+
+[[package]]
+name = "pathspec"
+version = "0.11.2"
+description = "Utility library for gitignore style pattern matching of file paths."
+optional = false
+python-versions = ">=3.7"
+files = [
+    {file = "pathspec-0.11.2-py3-none-any.whl", hash = "sha256:1d6ed233af05e679efb96b1851550ea95bbb64b7c490b0f5aa52996c11e92a20"},
+    {file = "pathspec-0.11.2.tar.gz", hash = "sha256:e0d8d0ac2f12da61956eb2306b69f9469b42f4deb0f3cb6ed47b9cce9996ced3"},
+]
 
 [[package]]
 name = "pillow"
@@ -414,6 +684,7 @@ files = [
     {file = "Pillow-10.0.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:3b08d4cc24f471b2c8ca24ec060abf4bebc6b144cb89cba638c720546b1cf538"},
     {file = "Pillow-10.0.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:d737a602fbd82afd892ca746392401b634e278cb65d55c4b7a8f48e9ef8d008d"},
     {file = "Pillow-10.0.0-cp311-cp311-win_amd64.whl", hash = "sha256:3a82c40d706d9aa9734289740ce26460a11aeec2d9c79b7af87bb35f0073c12f"},
+    {file = "Pillow-10.0.0-cp311-cp311-win_arm64.whl", hash = "sha256:bc2ec7c7b5d66b8ec9ce9f720dbb5fa4bace0f545acd34870eff4a369b44bf37"},
     {file = "Pillow-10.0.0-cp312-cp312-macosx_10_10_x86_64.whl", hash = "sha256:d80cf684b541685fccdd84c485b31ce73fc5c9b5d7523bf1394ce134a60c6883"},
     {file = "Pillow-10.0.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:76de421f9c326da8f43d690110f0e79fe3ad1e54be811545d7d91898b4c8493e"},
     {file = "Pillow-10.0.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:81ff539a12457809666fef6624684c008e00ff6bf455b4b89fd00a140eecd640"},
@@ -423,6 +694,7 @@ files = [
     {file = "Pillow-10.0.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:d50b6aec14bc737742ca96e85d6d0a5f9bfbded018264b3b70ff9d8c33485551"},
     {file = "Pillow-10.0.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:00e65f5e822decd501e374b0650146063fbb30a7264b4d2744bdd7b913e0cab5"},
     {file = "Pillow-10.0.0-cp312-cp312-win_amd64.whl", hash = "sha256:f31f9fdbfecb042d046f9d91270a0ba28368a723302786c0009ee9b9f1f60199"},
+    {file = "Pillow-10.0.0-cp312-cp312-win_arm64.whl", hash = "sha256:1ce91b6ec08d866b14413d3f0bbdea7e24dfdc8e59f562bb77bc3fe60b6144ca"},
     {file = "Pillow-10.0.0-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:349930d6e9c685c089284b013478d6f76e3a534e36ddfa912cde493f235372f3"},
     {file = "Pillow-10.0.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:3a684105f7c32488f7153905a4e3015a3b6c7182e106fe3c37fbb5ef3e6994c3"},
     {file = "Pillow-10.0.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b4f69b3700201b80bb82c3a97d5e9254084f6dd5fb5b16fc1a7b974260f89f43"},
@@ -456,6 +728,21 @@ files = [
 docs = ["furo", "olefile", "sphinx (>=2.4)", "sphinx-copybutton", "sphinx-inline-tabs", "sphinx-removed-in", "sphinxext-opengraph"]
 tests = ["check-manifest", "coverage", "defusedxml", "markdown2", "olefile", "packaging", "pyroma", "pytest", "pytest-cov", "pytest-timeout"]
 
+[[package]]
+name = "platformdirs"
+version = "3.10.0"
+description = "A small Python package for determining appropriate platform-specific dirs, e.g. a \"user data dir\"."
+optional = false
+python-versions = ">=3.7"
+files = [
+    {file = "platformdirs-3.10.0-py3-none-any.whl", hash = "sha256:d7c24979f292f916dc9cbf8648319032f551ea8c49a4c9bf2fb556a02070ec1d"},
+    {file = "platformdirs-3.10.0.tar.gz", hash = "sha256:b45696dab2d7cc691a3226759c0d3b00c47c8b6e293d96f6436f733303f77f6d"},
+]
+
+[package.extras]
+docs = ["furo (>=2023.7.26)", "proselint (>=0.13)", "sphinx (>=7.1.1)", "sphinx-autodoc-typehints (>=1.24)"]
+test = ["appdirs (==1.4.4)", "covdefaults (>=2.3)", "pytest (>=7.4)", "pytest-cov (>=4.1)", "pytest-mock (>=3.11.1)"]
+
 [[package]]
 name = "pycparser"
 version = "2.21"
@@ -469,13 +756,13 @@ files = [
 
 [[package]]
 name = "pygments"
-version = "2.14.0"
+version = "2.16.1"
 description = "Pygments is a syntax highlighting package written in Python."
 optional = false
-python-versions = ">=3.6"
+python-versions = ">=3.7"
 files = [
-    {file = "Pygments-2.14.0-py3-none-any.whl", hash = "sha256:fa7bd7bd2771287c0de303af8bfdfc731f51bd2c6a47ab69d117138893b82717"},
-    {file = "Pygments-2.14.0.tar.gz", hash = "sha256:b3ed06a9e8ac9a9aae5a6f5dbe78a8a58655d17b43b93c078f094ddc476ae297"},
+    {file = "Pygments-2.16.1-py3-none-any.whl", hash = "sha256:13fc09fa63bc8d8671a6d247e1eb303c4b343eaee81d861f3404db2935653692"},
+    {file = "Pygments-2.16.1.tar.gz", hash = "sha256:1daff0494820c69bc8941e407aa20f577374ee88364ee10a98fdbe0aece96e29"},
 ]
 
 [package.extras]
@@ -483,32 +770,39 @@ plugins = ["importlib-metadata"]
 
 [[package]]
 name = "pymdown-extensions"
-version = "10.0"
+version = "10.2"
 description = "Extension pack for Python Markdown."
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "pymdown_extensions-10.0-py3-none-any.whl", hash = "sha256:e6cbe8ace7d8feda30bc4fd6a21a073893a9a0e90c373e92d69ce5b653051f55"},
-    {file = "pymdown_extensions-10.0.tar.gz", hash = "sha256:9a77955e63528c2ee98073a1fb3207c1a45607bc74a34ef21acd098f46c3aa8a"},
+    {file = "pymdown_extensions-10.2-py3-none-any.whl", hash = "sha256:fbb86243db9a681602e3b869deef000211c55d0261015a5cc41d6f34d2afc57f"},
+    {file = "pymdown_extensions-10.2.tar.gz", hash = "sha256:06042274876eb4267f12a389daf505eabaebc38bdca26725560c9afda5867549"},
 ]
 
 [package.dependencies]
 markdown = ">=3.2"
 pyyaml = "*"
 
+[package.extras]
+extra = ["pygments (>=2.12)"]
+
 [[package]]
-name = "pyparsing"
-version = "3.0.9"
-description = "pyparsing module - Classes and methods to define and execute parsing grammars"
+name = "pyquery"
+version = "2.0.0"
+description = "A jquery-like library for python"
 optional = false
-python-versions = ">=3.6.8"
+python-versions = "*"
 files = [
-    {file = "pyparsing-3.0.9-py3-none-any.whl", hash = "sha256:5026bae9a10eeaefb61dab2f09052b9f4307d44aee4eda64b309723d8d206bbc"},
-    {file = "pyparsing-3.0.9.tar.gz", hash = "sha256:2b020ecf7d21b687f219b71ecad3631f644a47f01403fa1d1036b0c6416d70fb"},
+    {file = "pyquery-2.0.0-py3-none-any.whl", hash = "sha256:8dfc9b4b7c5f877d619bbae74b1898d5743f6ca248cfd5d72b504dd614da312f"},
+    {file = "pyquery-2.0.0.tar.gz", hash = "sha256:963e8d4e90262ff6d8dec072ea97285dc374a2f69cad7776f4082abcf6a1d8ae"},
 ]
 
+[package.dependencies]
+cssselect = ">=1.2.0"
+lxml = ">=2.1"
+
 [package.extras]
-diagrams = ["jinja2", "railroad-diagrams"]
+test = ["pytest", "pytest-cov", "requests", "webob", "webtest"]
 
 [[package]]
 name = "python-dateutil"
@@ -525,56 +819,66 @@ files = [
 six = ">=1.5"
 
 [[package]]
-name = "PyYAML"
-version = "6.0"
+name = "pyyaml"
+version = "6.0.1"
 description = "YAML parser and emitter for Python"
 optional = false
 python-versions = ">=3.6"
 files = [
-    {file = "PyYAML-6.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:d4db7c7aef085872ef65a8fd7d6d09a14ae91f691dec3e87ee5ee0539d516f53"},
-    {file = "PyYAML-6.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:9df7ed3b3d2e0ecfe09e14741b857df43adb5a3ddadc919a2d94fbdf78fea53c"},
-    {file = "PyYAML-6.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77f396e6ef4c73fdc33a9157446466f1cff553d979bd00ecb64385760c6babdc"},
-    {file = "PyYAML-6.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a80a78046a72361de73f8f395f1f1e49f956c6be882eed58505a15f3e430962b"},
-    {file = "PyYAML-6.0-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:f84fbc98b019fef2ee9a1cb3ce93e3187a6df0b2538a651bfb890254ba9f90b5"},
-    {file = "PyYAML-6.0-cp310-cp310-win32.whl", hash = "sha256:2cd5df3de48857ed0544b34e2d40e9fac445930039f3cfe4bcc592a1f836d513"},
-    {file = "PyYAML-6.0-cp310-cp310-win_amd64.whl", hash = "sha256:daf496c58a8c52083df09b80c860005194014c3698698d1a57cbcfa182142a3a"},
-    {file = "PyYAML-6.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:d4b0ba9512519522b118090257be113b9468d804b19d63c71dbcf4a48fa32358"},
-    {file = "PyYAML-6.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:81957921f441d50af23654aa6c5e5eaf9b06aba7f0a19c18a538dc7ef291c5a1"},
-    {file = "PyYAML-6.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:afa17f5bc4d1b10afd4466fd3a44dc0e245382deca5b3c353d8b757f9e3ecb8d"},
-    {file = "PyYAML-6.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dbad0e9d368bb989f4515da330b88a057617d16b6a8245084f1b05400f24609f"},
-    {file = "PyYAML-6.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:432557aa2c09802be39460360ddffd48156e30721f5e8d917f01d31694216782"},
-    {file = "PyYAML-6.0-cp311-cp311-win32.whl", hash = "sha256:bfaef573a63ba8923503d27530362590ff4f576c626d86a9fed95822a8255fd7"},
-    {file = "PyYAML-6.0-cp311-cp311-win_amd64.whl", hash = "sha256:01b45c0191e6d66c470b6cf1b9531a771a83c1c4208272ead47a3ae4f2f603bf"},
-    {file = "PyYAML-6.0-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:897b80890765f037df3403d22bab41627ca8811ae55e9a722fd0392850ec4d86"},
-    {file = "PyYAML-6.0-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:50602afada6d6cbfad699b0c7bb50d5ccffa7e46a3d738092afddc1f9758427f"},
-    {file = "PyYAML-6.0-cp36-cp36m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:48c346915c114f5fdb3ead70312bd042a953a8ce5c7106d5bfb1a5254e47da92"},
-    {file = "PyYAML-6.0-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:98c4d36e99714e55cfbaaee6dd5badbc9a1ec339ebfc3b1f52e293aee6bb71a4"},
-    {file = "PyYAML-6.0-cp36-cp36m-win32.whl", hash = "sha256:0283c35a6a9fbf047493e3a0ce8d79ef5030852c51e9d911a27badfde0605293"},
-    {file = "PyYAML-6.0-cp36-cp36m-win_amd64.whl", hash = "sha256:07751360502caac1c067a8132d150cf3d61339af5691fe9e87803040dbc5db57"},
-    {file = "PyYAML-6.0-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:819b3830a1543db06c4d4b865e70ded25be52a2e0631ccd2f6a47a2822f2fd7c"},
-    {file = "PyYAML-6.0-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:473f9edb243cb1935ab5a084eb238d842fb8f404ed2193a915d1784b5a6b5fc0"},
-    {file = "PyYAML-6.0-cp37-cp37m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:0ce82d761c532fe4ec3f87fc45688bdd3a4c1dc5e0b4a19814b9009a29baefd4"},
-    {file = "PyYAML-6.0-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:231710d57adfd809ef5d34183b8ed1eeae3f76459c18fb4a0b373ad56bedcdd9"},
-    {file = "PyYAML-6.0-cp37-cp37m-win32.whl", hash = "sha256:c5687b8d43cf58545ade1fe3e055f70eac7a5a1a0bf42824308d868289a95737"},
-    {file = "PyYAML-6.0-cp37-cp37m-win_amd64.whl", hash = "sha256:d15a181d1ecd0d4270dc32edb46f7cb7733c7c508857278d3d378d14d606db2d"},
-    {file = "PyYAML-6.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:0b4624f379dab24d3725ffde76559cff63d9ec94e1736b556dacdfebe5ab6d4b"},
-    {file = "PyYAML-6.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:213c60cd50106436cc818accf5baa1aba61c0189ff610f64f4a3e8c6726218ba"},
-    {file = "PyYAML-6.0-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9fa600030013c4de8165339db93d182b9431076eb98eb40ee068700c9c813e34"},
-    {file = "PyYAML-6.0-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:277a0ef2981ca40581a47093e9e2d13b3f1fbbeffae064c1d21bfceba2030287"},
-    {file = "PyYAML-6.0-cp38-cp38-win32.whl", hash = "sha256:d4eccecf9adf6fbcc6861a38015c2a64f38b9d94838ac1810a9023a0609e1b78"},
-    {file = "PyYAML-6.0-cp38-cp38-win_amd64.whl", hash = "sha256:1e4747bc279b4f613a09eb64bba2ba602d8a6664c6ce6396a4d0cd413a50ce07"},
-    {file = "PyYAML-6.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:055d937d65826939cb044fc8c9b08889e8c743fdc6a32b33e2390f66013e449b"},
-    {file = "PyYAML-6.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:e61ceaab6f49fb8bdfaa0f92c4b57bcfbea54c09277b1b4f7ac376bfb7a7c174"},
-    {file = "PyYAML-6.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d67d839ede4ed1b28a4e8909735fc992a923cdb84e618544973d7dfc71540803"},
-    {file = "PyYAML-6.0-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:cba8c411ef271aa037d7357a2bc8f9ee8b58b9965831d9e51baf703280dc73d3"},
-    {file = "PyYAML-6.0-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:40527857252b61eacd1d9af500c3337ba8deb8fc298940291486c465c8b46ec0"},
-    {file = "PyYAML-6.0-cp39-cp39-win32.whl", hash = "sha256:b5b9eccad747aabaaffbc6064800670f0c297e52c12754eb1d976c57e4f74dcb"},
-    {file = "PyYAML-6.0-cp39-cp39-win_amd64.whl", hash = "sha256:b3d267842bf12586ba6c734f89d1f5b871df0273157918b0ccefa29deb05c21c"},
-    {file = "PyYAML-6.0.tar.gz", hash = "sha256:68fb519c14306fec9720a2a5b45bc9f0c8d1b9c72adf45c37baedfcd949c35a2"},
+    {file = "PyYAML-6.0.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:d858aa552c999bc8a8d57426ed01e40bef403cd8ccdd0fc5f6f04a00414cac2a"},
+    {file = "PyYAML-6.0.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:fd66fc5d0da6d9815ba2cebeb4205f95818ff4b79c3ebe268e75d961704af52f"},
+    {file = "PyYAML-6.0.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:69b023b2b4daa7548bcfbd4aa3da05b3a74b772db9e23b982788168117739938"},
+    {file = "PyYAML-6.0.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:81e0b275a9ecc9c0c0c07b4b90ba548307583c125f54d5b6946cfee6360c733d"},
+    {file = "PyYAML-6.0.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ba336e390cd8e4d1739f42dfe9bb83a3cc2e80f567d8805e11b46f4a943f5515"},
+    {file = "PyYAML-6.0.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:326c013efe8048858a6d312ddd31d56e468118ad4cdeda36c719bf5bb6192290"},
+    {file = "PyYAML-6.0.1-cp310-cp310-win32.whl", hash = "sha256:bd4af7373a854424dabd882decdc5579653d7868b8fb26dc7d0e99f823aa5924"},
+    {file = "PyYAML-6.0.1-cp310-cp310-win_amd64.whl", hash = "sha256:fd1592b3fdf65fff2ad0004b5e363300ef59ced41c2e6b3a99d4089fa8c5435d"},
+    {file = "PyYAML-6.0.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:6965a7bc3cf88e5a1c3bd2e0b5c22f8d677dc88a455344035f03399034eb3007"},
+    {file = "PyYAML-6.0.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:f003ed9ad21d6a4713f0a9b5a7a0a79e08dd0f221aff4525a2be4c346ee60aab"},
+    {file = "PyYAML-6.0.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:42f8152b8dbc4fe7d96729ec2b99c7097d656dc1213a3229ca5383f973a5ed6d"},
+    {file = "PyYAML-6.0.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:062582fca9fabdd2c8b54a3ef1c978d786e0f6b3a1510e0ac93ef59e0ddae2bc"},
+    {file = "PyYAML-6.0.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d2b04aac4d386b172d5b9692e2d2da8de7bfb6c387fa4f801fbf6fb2e6ba4673"},
+    {file = "PyYAML-6.0.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:e7d73685e87afe9f3b36c799222440d6cf362062f78be1013661b00c5c6f678b"},
+    {file = "PyYAML-6.0.1-cp311-cp311-win32.whl", hash = "sha256:1635fd110e8d85d55237ab316b5b011de701ea0f29d07611174a1b42f1444741"},
+    {file = "PyYAML-6.0.1-cp311-cp311-win_amd64.whl", hash = "sha256:bf07ee2fef7014951eeb99f56f39c9bb4af143d8aa3c21b1677805985307da34"},
+    {file = "PyYAML-6.0.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:855fb52b0dc35af121542a76b9a84f8d1cd886ea97c84703eaa6d88e37a2ad28"},
+    {file = "PyYAML-6.0.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:40df9b996c2b73138957fe23a16a4f0ba614f4c0efce1e9406a184b6d07fa3a9"},
+    {file = "PyYAML-6.0.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6c22bec3fbe2524cde73d7ada88f6566758a8f7227bfbf93a408a9d86bcc12a0"},
+    {file = "PyYAML-6.0.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:8d4e9c88387b0f5c7d5f281e55304de64cf7f9c0021a3525bd3b1c542da3b0e4"},
+    {file = "PyYAML-6.0.1-cp312-cp312-win32.whl", hash = "sha256:d483d2cdf104e7c9fa60c544d92981f12ad66a457afae824d146093b8c294c54"},
+    {file = "PyYAML-6.0.1-cp312-cp312-win_amd64.whl", hash = "sha256:0d3304d8c0adc42be59c5f8a4d9e3d7379e6955ad754aa9d6ab7a398b59dd1df"},
+    {file = "PyYAML-6.0.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:50550eb667afee136e9a77d6dc71ae76a44df8b3e51e41b77f6de2932bfe0f47"},
+    {file = "PyYAML-6.0.1-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1fe35611261b29bd1de0070f0b2f47cb6ff71fa6595c077e42bd0c419fa27b98"},
+    {file = "PyYAML-6.0.1-cp36-cp36m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:704219a11b772aea0d8ecd7058d0082713c3562b4e271b849ad7dc4a5c90c13c"},
+    {file = "PyYAML-6.0.1-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:afd7e57eddb1a54f0f1a974bc4391af8bcce0b444685d936840f125cf046d5bd"},
+    {file = "PyYAML-6.0.1-cp36-cp36m-win32.whl", hash = "sha256:fca0e3a251908a499833aa292323f32437106001d436eca0e6e7833256674585"},
+    {file = "PyYAML-6.0.1-cp36-cp36m-win_amd64.whl", hash = "sha256:f22ac1c3cac4dbc50079e965eba2c1058622631e526bd9afd45fedd49ba781fa"},
+    {file = "PyYAML-6.0.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:b1275ad35a5d18c62a7220633c913e1b42d44b46ee12554e5fd39c70a243d6a3"},
+    {file = "PyYAML-6.0.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:18aeb1bf9a78867dc38b259769503436b7c72f7a1f1f4c93ff9a17de54319b27"},
+    {file = "PyYAML-6.0.1-cp37-cp37m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:596106435fa6ad000c2991a98fa58eeb8656ef2325d7e158344fb33864ed87e3"},
+    {file = "PyYAML-6.0.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:baa90d3f661d43131ca170712d903e6295d1f7a0f595074f151c0aed377c9b9c"},
+    {file = "PyYAML-6.0.1-cp37-cp37m-win32.whl", hash = "sha256:9046c58c4395dff28dd494285c82ba00b546adfc7ef001486fbf0324bc174fba"},
+    {file = "PyYAML-6.0.1-cp37-cp37m-win_amd64.whl", hash = "sha256:4fb147e7a67ef577a588a0e2c17b6db51dda102c71de36f8549b6816a96e1867"},
+    {file = "PyYAML-6.0.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:1d4c7e777c441b20e32f52bd377e0c409713e8bb1386e1099c2415f26e479595"},
+    {file = "PyYAML-6.0.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a0cd17c15d3bb3fa06978b4e8958dcdc6e0174ccea823003a106c7d4d7899ac5"},
+    {file = "PyYAML-6.0.1-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:28c119d996beec18c05208a8bd78cbe4007878c6dd15091efb73a30e90539696"},
+    {file = "PyYAML-6.0.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7e07cbde391ba96ab58e532ff4803f79c4129397514e1413a7dc761ccd755735"},
+    {file = "PyYAML-6.0.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:49a183be227561de579b4a36efbb21b3eab9651dd81b1858589f796549873dd6"},
+    {file = "PyYAML-6.0.1-cp38-cp38-win32.whl", hash = "sha256:184c5108a2aca3c5b3d3bf9395d50893a7ab82a38004c8f61c258d4428e80206"},
+    {file = "PyYAML-6.0.1-cp38-cp38-win_amd64.whl", hash = "sha256:1e2722cc9fbb45d9b87631ac70924c11d3a401b2d7f410cc0e3bbf249f2dca62"},
+    {file = "PyYAML-6.0.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:9eb6caa9a297fc2c2fb8862bc5370d0303ddba53ba97e71f08023b6cd73d16a8"},
+    {file = "PyYAML-6.0.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:c8098ddcc2a85b61647b2590f825f3db38891662cfc2fc776415143f599bb859"},
+    {file = "PyYAML-6.0.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5773183b6446b2c99bb77e77595dd486303b4faab2b086e7b17bc6bef28865f6"},
+    {file = "PyYAML-6.0.1-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b786eecbdf8499b9ca1d697215862083bd6d2a99965554781d0d8d1ad31e13a0"},
+    {file = "PyYAML-6.0.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bc1bf2925a1ecd43da378f4db9e4f799775d6367bdb94671027b73b393a7c42c"},
+    {file = "PyYAML-6.0.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:04ac92ad1925b2cff1db0cfebffb6ffc43457495c9b3c39d3fcae417d7125dc5"},
+    {file = "PyYAML-6.0.1-cp39-cp39-win32.whl", hash = "sha256:faca3bdcf85b2fc05d06ff3fbc1f83e1391b3e724afa3feba7d13eeab355484c"},
+    {file = "PyYAML-6.0.1-cp39-cp39-win_amd64.whl", hash = "sha256:510c9deebc5c0225e8c96813043e62b680ba2f9c50a08d3724c7f28a747d1486"},
+    {file = "PyYAML-6.0.1.tar.gz", hash = "sha256:bfdf460b1736c775f2ba9f6a92bca30bc2095067b8a9d77876d1fad6cc3b4a43"},
 ]
 
 [[package]]
-name = "pyyaml_env_tag"
+name = "pyyaml-env-tag"
 version = "0.1"
 description = "A custom YAML tag for referencing environment variables in YAML files. "
 optional = false
@@ -587,101 +891,116 @@ files = [
 [package.dependencies]
 pyyaml = "*"
 
+[[package]]
+name = "readtime"
+version = "3.0.0"
+description = "Calculates the time some text takes the average human to read, based on Medium's read time forumula"
+optional = false
+python-versions = "*"
+files = [
+    {file = "readtime-3.0.0.tar.gz", hash = "sha256:76c5a0d773ad49858c53b42ba3a942f62fbe20cc8c6f07875797ac7dc30963a9"},
+]
+
+[package.dependencies]
+beautifulsoup4 = ">=4.0.1"
+markdown2 = ">=2.4.3"
+pyquery = ">=1.2"
+
 [[package]]
 name = "regex"
-version = "2022.10.31"
+version = "2023.8.8"
 description = "Alternative regular expression module, to replace re."
 optional = false
 python-versions = ">=3.6"
 files = [
-    {file = "regex-2022.10.31-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:a8ff454ef0bb061e37df03557afda9d785c905dab15584860f982e88be73015f"},
-    {file = "regex-2022.10.31-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:1eba476b1b242620c266edf6325b443a2e22b633217a9835a52d8da2b5c051f9"},
-    {file = "regex-2022.10.31-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d0e5af9a9effb88535a472e19169e09ce750c3d442fb222254a276d77808620b"},
-    {file = "regex-2022.10.31-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d03fe67b2325cb3f09be029fd5da8df9e6974f0cde2c2ac6a79d2634e791dd57"},
-    {file = "regex-2022.10.31-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a9d0b68ac1743964755ae2d89772c7e6fb0118acd4d0b7464eaf3921c6b49dd4"},
-    {file = "regex-2022.10.31-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8a45b6514861916c429e6059a55cf7db74670eaed2052a648e3e4d04f070e001"},
-    {file = "regex-2022.10.31-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:8b0886885f7323beea6f552c28bff62cbe0983b9fbb94126531693ea6c5ebb90"},
-    {file = "regex-2022.10.31-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:5aefb84a301327ad115e9d346c8e2760009131d9d4b4c6b213648d02e2abe144"},
-    {file = "regex-2022.10.31-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:702d8fc6f25bbf412ee706bd73019da5e44a8400861dfff7ff31eb5b4a1276dc"},
-    {file = "regex-2022.10.31-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:a3c1ebd4ed8e76e886507c9eddb1a891673686c813adf889b864a17fafcf6d66"},
-    {file = "regex-2022.10.31-cp310-cp310-musllinux_1_1_ppc64le.whl", hash = "sha256:50921c140561d3db2ab9f5b11c5184846cde686bb5a9dc64cae442926e86f3af"},
-    {file = "regex-2022.10.31-cp310-cp310-musllinux_1_1_s390x.whl", hash = "sha256:7db345956ecce0c99b97b042b4ca7326feeec6b75facd8390af73b18e2650ffc"},
-    {file = "regex-2022.10.31-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:763b64853b0a8f4f9cfb41a76a4a85a9bcda7fdda5cb057016e7706fde928e66"},
-    {file = "regex-2022.10.31-cp310-cp310-win32.whl", hash = "sha256:44136355e2f5e06bf6b23d337a75386371ba742ffa771440b85bed367c1318d1"},
-    {file = "regex-2022.10.31-cp310-cp310-win_amd64.whl", hash = "sha256:bfff48c7bd23c6e2aec6454aaf6edc44444b229e94743b34bdcdda2e35126cf5"},
-    {file = "regex-2022.10.31-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:4b4b1fe58cd102d75ef0552cf17242705ce0759f9695334a56644ad2d83903fe"},
-    {file = "regex-2022.10.31-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:542e3e306d1669b25936b64917285cdffcd4f5c6f0247636fec037187bd93542"},
-    {file = "regex-2022.10.31-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c27cc1e4b197092e50ddbf0118c788d9977f3f8f35bfbbd3e76c1846a3443df7"},
-    {file = "regex-2022.10.31-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b8e38472739028e5f2c3a4aded0ab7eadc447f0d84f310c7a8bb697ec417229e"},
-    {file = "regex-2022.10.31-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:76c598ca73ec73a2f568e2a72ba46c3b6c8690ad9a07092b18e48ceb936e9f0c"},
-    {file = "regex-2022.10.31-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c28d3309ebd6d6b2cf82969b5179bed5fefe6142c70f354ece94324fa11bf6a1"},
-    {file = "regex-2022.10.31-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9af69f6746120998cd9c355e9c3c6aec7dff70d47247188feb4f829502be8ab4"},
-    {file = "regex-2022.10.31-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:a5f9505efd574d1e5b4a76ac9dd92a12acb2b309551e9aa874c13c11caefbe4f"},
-    {file = "regex-2022.10.31-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:5ff525698de226c0ca743bfa71fc6b378cda2ddcf0d22d7c37b1cc925c9650a5"},
-    {file = "regex-2022.10.31-cp311-cp311-musllinux_1_1_ppc64le.whl", hash = "sha256:4fe7fda2fe7c8890d454f2cbc91d6c01baf206fbc96d89a80241a02985118c0c"},
-    {file = "regex-2022.10.31-cp311-cp311-musllinux_1_1_s390x.whl", hash = "sha256:2cdc55ca07b4e70dda898d2ab7150ecf17c990076d3acd7a5f3b25cb23a69f1c"},
-    {file = "regex-2022.10.31-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:44a6c2f6374e0033873e9ed577a54a3602b4f609867794c1a3ebba65e4c93ee7"},
-    {file = "regex-2022.10.31-cp311-cp311-win32.whl", hash = "sha256:d8716f82502997b3d0895d1c64c3b834181b1eaca28f3f6336a71777e437c2af"},
-    {file = "regex-2022.10.31-cp311-cp311-win_amd64.whl", hash = "sha256:61edbca89aa3f5ef7ecac8c23d975fe7261c12665f1d90a6b1af527bba86ce61"},
-    {file = "regex-2022.10.31-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:0a069c8483466806ab94ea9068c34b200b8bfc66b6762f45a831c4baaa9e8cdd"},
-    {file = "regex-2022.10.31-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d26166acf62f731f50bdd885b04b38828436d74e8e362bfcb8df221d868b5d9b"},
-    {file = "regex-2022.10.31-cp36-cp36m-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:ac741bf78b9bb432e2d314439275235f41656e189856b11fb4e774d9f7246d81"},
-    {file = "regex-2022.10.31-cp36-cp36m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:75f591b2055523fc02a4bbe598aa867df9e953255f0b7f7715d2a36a9c30065c"},
-    {file = "regex-2022.10.31-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6b30bddd61d2a3261f025ad0f9ee2586988c6a00c780a2fb0a92cea2aa702c54"},
-    {file = "regex-2022.10.31-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ef4163770525257876f10e8ece1cf25b71468316f61451ded1a6f44273eedeb5"},
-    {file = "regex-2022.10.31-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:7b280948d00bd3973c1998f92e22aa3ecb76682e3a4255f33e1020bd32adf443"},
-    {file = "regex-2022.10.31-cp36-cp36m-musllinux_1_1_aarch64.whl", hash = "sha256:d0213671691e341f6849bf33cd9fad21f7b1cb88b89e024f33370733fec58742"},
-    {file = "regex-2022.10.31-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:22e7ebc231d28393dfdc19b185d97e14a0f178bedd78e85aad660e93b646604e"},
-    {file = "regex-2022.10.31-cp36-cp36m-musllinux_1_1_ppc64le.whl", hash = "sha256:8ad241da7fac963d7573cc67a064c57c58766b62a9a20c452ca1f21050868dfa"},
-    {file = "regex-2022.10.31-cp36-cp36m-musllinux_1_1_s390x.whl", hash = "sha256:586b36ebda81e6c1a9c5a5d0bfdc236399ba6595e1397842fd4a45648c30f35e"},
-    {file = "regex-2022.10.31-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:0653d012b3bf45f194e5e6a41df9258811ac8fc395579fa82958a8b76286bea4"},
-    {file = "regex-2022.10.31-cp36-cp36m-win32.whl", hash = "sha256:144486e029793a733e43b2e37df16a16df4ceb62102636ff3db6033994711066"},
-    {file = "regex-2022.10.31-cp36-cp36m-win_amd64.whl", hash = "sha256:c14b63c9d7bab795d17392c7c1f9aaabbffd4cf4387725a0ac69109fb3b550c6"},
-    {file = "regex-2022.10.31-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:4cac3405d8dda8bc6ed499557625585544dd5cbf32072dcc72b5a176cb1271c8"},
-    {file = "regex-2022.10.31-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:23cbb932cc53a86ebde0fb72e7e645f9a5eec1a5af7aa9ce333e46286caef783"},
-    {file = "regex-2022.10.31-cp37-cp37m-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:74bcab50a13960f2a610cdcd066e25f1fd59e23b69637c92ad470784a51b1347"},
-    {file = "regex-2022.10.31-cp37-cp37m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:78d680ef3e4d405f36f0d6d1ea54e740366f061645930072d39bca16a10d8c93"},
-    {file = "regex-2022.10.31-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ce6910b56b700bea7be82c54ddf2e0ed792a577dfaa4a76b9af07d550af435c6"},
-    {file = "regex-2022.10.31-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:659175b2144d199560d99a8d13b2228b85e6019b6e09e556209dfb8c37b78a11"},
-    {file = "regex-2022.10.31-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:1ddf14031a3882f684b8642cb74eea3af93a2be68893901b2b387c5fd92a03ec"},
-    {file = "regex-2022.10.31-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:b683e5fd7f74fb66e89a1ed16076dbab3f8e9f34c18b1979ded614fe10cdc4d9"},
-    {file = "regex-2022.10.31-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:2bde29cc44fa81c0a0c8686992c3080b37c488df167a371500b2a43ce9f026d1"},
-    {file = "regex-2022.10.31-cp37-cp37m-musllinux_1_1_ppc64le.whl", hash = "sha256:4919899577ba37f505aaebdf6e7dc812d55e8f097331312db7f1aab18767cce8"},
-    {file = "regex-2022.10.31-cp37-cp37m-musllinux_1_1_s390x.whl", hash = "sha256:9c94f7cc91ab16b36ba5ce476f1904c91d6c92441f01cd61a8e2729442d6fcf5"},
-    {file = "regex-2022.10.31-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:ae1e96785696b543394a4e3f15f3f225d44f3c55dafe3f206493031419fedf95"},
-    {file = "regex-2022.10.31-cp37-cp37m-win32.whl", hash = "sha256:c670f4773f2f6f1957ff8a3962c7dd12e4be54d05839b216cb7fd70b5a1df394"},
-    {file = "regex-2022.10.31-cp37-cp37m-win_amd64.whl", hash = "sha256:8e0caeff18b96ea90fc0eb6e3bdb2b10ab5b01a95128dfeccb64a7238decf5f0"},
-    {file = "regex-2022.10.31-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:131d4be09bea7ce2577f9623e415cab287a3c8e0624f778c1d955ec7c281bd4d"},
-    {file = "regex-2022.10.31-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:e613a98ead2005c4ce037c7b061f2409a1a4e45099edb0ef3200ee26ed2a69a8"},
-    {file = "regex-2022.10.31-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:052b670fafbe30966bbe5d025e90b2a491f85dfe5b2583a163b5e60a85a321ad"},
-    {file = "regex-2022.10.31-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:aa62a07ac93b7cb6b7d0389d8ef57ffc321d78f60c037b19dfa78d6b17c928ee"},
-    {file = "regex-2022.10.31-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:5352bea8a8f84b89d45ccc503f390a6be77917932b1c98c4cdc3565137acc714"},
-    {file = "regex-2022.10.31-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:20f61c9944f0be2dc2b75689ba409938c14876c19d02f7585af4460b6a21403e"},
-    {file = "regex-2022.10.31-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:29c04741b9ae13d1e94cf93fca257730b97ce6ea64cfe1eba11cf9ac4e85afb6"},
-    {file = "regex-2022.10.31-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:543883e3496c8b6d58bd036c99486c3c8387c2fc01f7a342b760c1ea3158a318"},
-    {file = "regex-2022.10.31-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:b7a8b43ee64ca8f4befa2bea4083f7c52c92864d8518244bfa6e88c751fa8fff"},
-    {file = "regex-2022.10.31-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:6a9a19bea8495bb419dc5d38c4519567781cd8d571c72efc6aa959473d10221a"},
-    {file = "regex-2022.10.31-cp38-cp38-musllinux_1_1_ppc64le.whl", hash = "sha256:6ffd55b5aedc6f25fd8d9f905c9376ca44fcf768673ffb9d160dd6f409bfda73"},
-    {file = "regex-2022.10.31-cp38-cp38-musllinux_1_1_s390x.whl", hash = "sha256:4bdd56ee719a8f751cf5a593476a441c4e56c9b64dc1f0f30902858c4ef8771d"},
-    {file = "regex-2022.10.31-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:8ca88da1bd78990b536c4a7765f719803eb4f8f9971cc22d6ca965c10a7f2c4c"},
-    {file = "regex-2022.10.31-cp38-cp38-win32.whl", hash = "sha256:5a260758454580f11dd8743fa98319bb046037dfab4f7828008909d0aa5292bc"},
-    {file = "regex-2022.10.31-cp38-cp38-win_amd64.whl", hash = "sha256:5e6a5567078b3eaed93558842346c9d678e116ab0135e22eb72db8325e90b453"},
-    {file = "regex-2022.10.31-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:5217c25229b6a85049416a5c1e6451e9060a1edcf988641e309dbe3ab26d3e49"},
-    {file = "regex-2022.10.31-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:4bf41b8b0a80708f7e0384519795e80dcb44d7199a35d52c15cc674d10b3081b"},
-    {file = "regex-2022.10.31-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0cf0da36a212978be2c2e2e2d04bdff46f850108fccc1851332bcae51c8907cc"},
-    {file = "regex-2022.10.31-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d403d781b0e06d2922435ce3b8d2376579f0c217ae491e273bab8d092727d244"},
-    {file = "regex-2022.10.31-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a37d51fa9a00d265cf73f3de3930fa9c41548177ba4f0faf76e61d512c774690"},
-    {file = "regex-2022.10.31-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e4f781ffedd17b0b834c8731b75cce2639d5a8afe961c1e58ee7f1f20b3af185"},
-    {file = "regex-2022.10.31-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d243b36fbf3d73c25e48014961e83c19c9cc92530516ce3c43050ea6276a2ab7"},
-    {file = "regex-2022.10.31-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:370f6e97d02bf2dd20d7468ce4f38e173a124e769762d00beadec3bc2f4b3bc4"},
-    {file = "regex-2022.10.31-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:597f899f4ed42a38df7b0e46714880fb4e19a25c2f66e5c908805466721760f5"},
-    {file = "regex-2022.10.31-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:7dbdce0c534bbf52274b94768b3498abdf675a691fec5f751b6057b3030f34c1"},
-    {file = "regex-2022.10.31-cp39-cp39-musllinux_1_1_ppc64le.whl", hash = "sha256:22960019a842777a9fa5134c2364efaed5fbf9610ddc5c904bd3a400973b0eb8"},
-    {file = "regex-2022.10.31-cp39-cp39-musllinux_1_1_s390x.whl", hash = "sha256:7f5a3ffc731494f1a57bd91c47dc483a1e10048131ffb52d901bfe2beb6102e8"},
-    {file = "regex-2022.10.31-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:7ef6b5942e6bfc5706301a18a62300c60db9af7f6368042227ccb7eeb22d0892"},
-    {file = "regex-2022.10.31-cp39-cp39-win32.whl", hash = "sha256:395161bbdbd04a8333b9ff9763a05e9ceb4fe210e3c7690f5e68cedd3d65d8e1"},
-    {file = "regex-2022.10.31-cp39-cp39-win_amd64.whl", hash = "sha256:957403a978e10fb3ca42572a23e6f7badff39aa1ce2f4ade68ee452dc6807692"},
-    {file = "regex-2022.10.31.tar.gz", hash = "sha256:a3a98921da9a1bf8457aeee6a551948a83601689e5ecdd736894ea9bbec77e83"},
+    {file = "regex-2023.8.8-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:88900f521c645f784260a8d346e12a1590f79e96403971241e64c3a265c8ecdb"},
+    {file = "regex-2023.8.8-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:3611576aff55918af2697410ff0293d6071b7e00f4b09e005d614686ac4cd57c"},
+    {file = "regex-2023.8.8-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b8a0ccc8f2698f120e9e5742f4b38dc944c38744d4bdfc427616f3a163dd9de5"},
+    {file = "regex-2023.8.8-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:c662a4cbdd6280ee56f841f14620787215a171c4e2d1744c9528bed8f5816c96"},
+    {file = "regex-2023.8.8-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:cf0633e4a1b667bfe0bb10b5e53fe0d5f34a6243ea2530eb342491f1adf4f739"},
+    {file = "regex-2023.8.8-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:551ad543fa19e94943c5b2cebc54c73353ffff08228ee5f3376bd27b3d5b9800"},
+    {file = "regex-2023.8.8-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:54de2619f5ea58474f2ac211ceea6b615af2d7e4306220d4f3fe690c91988a61"},
+    {file = "regex-2023.8.8-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:5ec4b3f0aebbbe2fc0134ee30a791af522a92ad9f164858805a77442d7d18570"},
+    {file = "regex-2023.8.8-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:3ae646c35cb9f820491760ac62c25b6d6b496757fda2d51be429e0e7b67ae0ab"},
+    {file = "regex-2023.8.8-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:ca339088839582d01654e6f83a637a4b8194d0960477b9769d2ff2cfa0fa36d2"},
+    {file = "regex-2023.8.8-cp310-cp310-musllinux_1_1_ppc64le.whl", hash = "sha256:d9b6627408021452dcd0d2cdf8da0534e19d93d070bfa8b6b4176f99711e7f90"},
+    {file = "regex-2023.8.8-cp310-cp310-musllinux_1_1_s390x.whl", hash = "sha256:bd3366aceedf274f765a3a4bc95d6cd97b130d1dda524d8f25225d14123c01db"},
+    {file = "regex-2023.8.8-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:7aed90a72fc3654fba9bc4b7f851571dcc368120432ad68b226bd593f3f6c0b7"},
+    {file = "regex-2023.8.8-cp310-cp310-win32.whl", hash = "sha256:80b80b889cb767cc47f31d2b2f3dec2db8126fbcd0cff31b3925b4dc6609dcdb"},
+    {file = "regex-2023.8.8-cp310-cp310-win_amd64.whl", hash = "sha256:b82edc98d107cbc7357da7a5a695901b47d6eb0420e587256ba3ad24b80b7d0b"},
+    {file = "regex-2023.8.8-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1e7d84d64c84ad97bf06f3c8cb5e48941f135ace28f450d86af6b6512f1c9a71"},
+    {file = "regex-2023.8.8-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:ce0f9fbe7d295f9922c0424a3637b88c6c472b75eafeaff6f910494a1fa719ef"},
+    {file = "regex-2023.8.8-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:06c57e14ac723b04458df5956cfb7e2d9caa6e9d353c0b4c7d5d54fcb1325c46"},
+    {file = "regex-2023.8.8-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e7a9aaa5a1267125eef22cef3b63484c3241aaec6f48949b366d26c7250e0357"},
+    {file = "regex-2023.8.8-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9b7408511fca48a82a119d78a77c2f5eb1b22fe88b0d2450ed0756d194fe7a9a"},
+    {file = "regex-2023.8.8-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:14dc6f2d88192a67d708341f3085df6a4f5a0c7b03dec08d763ca2cd86e9f559"},
+    {file = "regex-2023.8.8-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:48c640b99213643d141550326f34f0502fedb1798adb3c9eb79650b1ecb2f177"},
+    {file = "regex-2023.8.8-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:0085da0f6c6393428bf0d9c08d8b1874d805bb55e17cb1dfa5ddb7cfb11140bf"},
+    {file = "regex-2023.8.8-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:964b16dcc10c79a4a2be9f1273fcc2684a9eedb3906439720598029a797b46e6"},
+    {file = "regex-2023.8.8-cp311-cp311-musllinux_1_1_ppc64le.whl", hash = "sha256:7ce606c14bb195b0e5108544b540e2c5faed6843367e4ab3deb5c6aa5e681208"},
+    {file = "regex-2023.8.8-cp311-cp311-musllinux_1_1_s390x.whl", hash = "sha256:40f029d73b10fac448c73d6eb33d57b34607f40116e9f6e9f0d32e9229b147d7"},
+    {file = "regex-2023.8.8-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:3b8e6ea6be6d64104d8e9afc34c151926f8182f84e7ac290a93925c0db004bfd"},
+    {file = "regex-2023.8.8-cp311-cp311-win32.whl", hash = "sha256:942f8b1f3b223638b02df7df79140646c03938d488fbfb771824f3d05fc083a8"},
+    {file = "regex-2023.8.8-cp311-cp311-win_amd64.whl", hash = "sha256:51d8ea2a3a1a8fe4f67de21b8b93757005213e8ac3917567872f2865185fa7fb"},
+    {file = "regex-2023.8.8-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:e951d1a8e9963ea51efd7f150450803e3b95db5939f994ad3d5edac2b6f6e2b4"},
+    {file = "regex-2023.8.8-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:704f63b774218207b8ccc6c47fcef5340741e5d839d11d606f70af93ee78e4d4"},
+    {file = "regex-2023.8.8-cp36-cp36m-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:22283c769a7b01c8ac355d5be0715bf6929b6267619505e289f792b01304d898"},
+    {file = "regex-2023.8.8-cp36-cp36m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:91129ff1bb0619bc1f4ad19485718cc623a2dc433dff95baadbf89405c7f6b57"},
+    {file = "regex-2023.8.8-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:de35342190deb7b866ad6ba5cbcccb2d22c0487ee0cbb251efef0843d705f0d4"},
+    {file = "regex-2023.8.8-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b993b6f524d1e274a5062488a43e3f9f8764ee9745ccd8e8193df743dbe5ee61"},
+    {file = "regex-2023.8.8-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:3026cbcf11d79095a32d9a13bbc572a458727bd5b1ca332df4a79faecd45281c"},
+    {file = "regex-2023.8.8-cp36-cp36m-musllinux_1_1_aarch64.whl", hash = "sha256:293352710172239bf579c90a9864d0df57340b6fd21272345222fb6371bf82b3"},
+    {file = "regex-2023.8.8-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:d909b5a3fff619dc7e48b6b1bedc2f30ec43033ba7af32f936c10839e81b9217"},
+    {file = "regex-2023.8.8-cp36-cp36m-musllinux_1_1_ppc64le.whl", hash = "sha256:3d370ff652323c5307d9c8e4c62efd1956fb08051b0e9210212bc51168b4ff56"},
+    {file = "regex-2023.8.8-cp36-cp36m-musllinux_1_1_s390x.whl", hash = "sha256:b076da1ed19dc37788f6a934c60adf97bd02c7eea461b73730513921a85d4235"},
+    {file = "regex-2023.8.8-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:e9941a4ada58f6218694f382e43fdd256e97615db9da135e77359da257a7168b"},
+    {file = "regex-2023.8.8-cp36-cp36m-win32.whl", hash = "sha256:a8c65c17aed7e15a0c824cdc63a6b104dfc530f6fa8cb6ac51c437af52b481c7"},
+    {file = "regex-2023.8.8-cp36-cp36m-win_amd64.whl", hash = "sha256:aadf28046e77a72f30dcc1ab185639e8de7f4104b8cb5c6dfa5d8ed860e57236"},
+    {file = "regex-2023.8.8-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:423adfa872b4908843ac3e7a30f957f5d5282944b81ca0a3b8a7ccbbfaa06103"},
+    {file = "regex-2023.8.8-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4ae594c66f4a7e1ea67232a0846649a7c94c188d6c071ac0210c3e86a5f92109"},
+    {file = "regex-2023.8.8-cp37-cp37m-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e51c80c168074faa793685656c38eb7a06cbad7774c8cbc3ea05552d615393d8"},
+    {file = "regex-2023.8.8-cp37-cp37m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:09b7f4c66aa9d1522b06e31a54f15581c37286237208df1345108fcf4e050c18"},
+    {file = "regex-2023.8.8-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2e73e5243af12d9cd6a9d6a45a43570dbe2e5b1cdfc862f5ae2b031e44dd95a8"},
+    {file = "regex-2023.8.8-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:941460db8fe3bd613db52f05259c9336f5a47ccae7d7def44cc277184030a116"},
+    {file = "regex-2023.8.8-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:f0ccf3e01afeb412a1a9993049cb160d0352dba635bbca7762b2dc722aa5742a"},
+    {file = "regex-2023.8.8-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:2e9216e0d2cdce7dbc9be48cb3eacb962740a09b011a116fd7af8c832ab116ca"},
+    {file = "regex-2023.8.8-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:5cd9cd7170459b9223c5e592ac036e0704bee765706445c353d96f2890e816c8"},
+    {file = "regex-2023.8.8-cp37-cp37m-musllinux_1_1_ppc64le.whl", hash = "sha256:4873ef92e03a4309b3ccd8281454801b291b689f6ad45ef8c3658b6fa761d7ac"},
+    {file = "regex-2023.8.8-cp37-cp37m-musllinux_1_1_s390x.whl", hash = "sha256:239c3c2a339d3b3ddd51c2daef10874410917cd2b998f043c13e2084cb191684"},
+    {file = "regex-2023.8.8-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:1005c60ed7037be0d9dea1f9c53cc42f836188227366370867222bda4c3c6bd7"},
+    {file = "regex-2023.8.8-cp37-cp37m-win32.whl", hash = "sha256:e6bd1e9b95bc5614a7a9c9c44fde9539cba1c823b43a9f7bc11266446dd568e3"},
+    {file = "regex-2023.8.8-cp37-cp37m-win_amd64.whl", hash = "sha256:9a96edd79661e93327cfeac4edec72a4046e14550a1d22aa0dd2e3ca52aec921"},
+    {file = "regex-2023.8.8-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:f2181c20ef18747d5f4a7ea513e09ea03bdd50884a11ce46066bb90fe4213675"},
+    {file = "regex-2023.8.8-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:a2ad5add903eb7cdde2b7c64aaca405f3957ab34f16594d2b78d53b8b1a6a7d6"},
+    {file = "regex-2023.8.8-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9233ac249b354c54146e392e8a451e465dd2d967fc773690811d3a8c240ac601"},
+    {file = "regex-2023.8.8-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:920974009fb37b20d32afcdf0227a2e707eb83fe418713f7a8b7de038b870d0b"},
+    {file = "regex-2023.8.8-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:cd2b6c5dfe0929b6c23dde9624483380b170b6e34ed79054ad131b20203a1a63"},
+    {file = "regex-2023.8.8-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:96979d753b1dc3b2169003e1854dc67bfc86edf93c01e84757927f810b8c3c93"},
+    {file = "regex-2023.8.8-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2ae54a338191e1356253e7883d9d19f8679b6143703086245fb14d1f20196be9"},
+    {file = "regex-2023.8.8-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:2162ae2eb8b079622176a81b65d486ba50b888271302190870b8cc488587d280"},
+    {file = "regex-2023.8.8-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:c884d1a59e69e03b93cf0dfee8794c63d7de0ee8f7ffb76e5f75be8131b6400a"},
+    {file = "regex-2023.8.8-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:cf9273e96f3ee2ac89ffcb17627a78f78e7516b08f94dc435844ae72576a276e"},
+    {file = "regex-2023.8.8-cp38-cp38-musllinux_1_1_ppc64le.whl", hash = "sha256:83215147121e15d5f3a45d99abeed9cf1fe16869d5c233b08c56cdf75f43a504"},
+    {file = "regex-2023.8.8-cp38-cp38-musllinux_1_1_s390x.whl", hash = "sha256:3f7454aa427b8ab9101f3787eb178057c5250478e39b99540cfc2b889c7d0586"},
+    {file = "regex-2023.8.8-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:f0640913d2c1044d97e30d7c41728195fc37e54d190c5385eacb52115127b882"},
+    {file = "regex-2023.8.8-cp38-cp38-win32.whl", hash = "sha256:0c59122ceccb905a941fb23b087b8eafc5290bf983ebcb14d2301febcbe199c7"},
+    {file = "regex-2023.8.8-cp38-cp38-win_amd64.whl", hash = "sha256:c12f6f67495ea05c3d542d119d270007090bad5b843f642d418eb601ec0fa7be"},
+    {file = "regex-2023.8.8-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:82cd0a69cd28f6cc3789cc6adeb1027f79526b1ab50b1f6062bbc3a0ccb2dbc3"},
+    {file = "regex-2023.8.8-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:bb34d1605f96a245fc39790a117ac1bac8de84ab7691637b26ab2c5efb8f228c"},
+    {file = "regex-2023.8.8-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:987b9ac04d0b38ef4f89fbc035e84a7efad9cdd5f1e29024f9289182c8d99e09"},
+    {file = "regex-2023.8.8-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9dd6082f4e2aec9b6a0927202c85bc1b09dcab113f97265127c1dc20e2e32495"},
+    {file = "regex-2023.8.8-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:7eb95fe8222932c10d4436e7a6f7c99991e3fdd9f36c949eff16a69246dee2dc"},
+    {file = "regex-2023.8.8-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7098c524ba9f20717a56a8d551d2ed491ea89cbf37e540759ed3b776a4f8d6eb"},
+    {file = "regex-2023.8.8-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:4b694430b3f00eb02c594ff5a16db30e054c1b9589a043fe9174584c6efa8033"},
+    {file = "regex-2023.8.8-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:b2aeab3895d778155054abea5238d0eb9a72e9242bd4b43f42fd911ef9a13470"},
+    {file = "regex-2023.8.8-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:988631b9d78b546e284478c2ec15c8a85960e262e247b35ca5eaf7ee22f6050a"},
+    {file = "regex-2023.8.8-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:67ecd894e56a0c6108ec5ab1d8fa8418ec0cff45844a855966b875d1039a2e34"},
+    {file = "regex-2023.8.8-cp39-cp39-musllinux_1_1_ppc64le.whl", hash = "sha256:14898830f0a0eb67cae2bbbc787c1a7d6e34ecc06fbd39d3af5fe29a4468e2c9"},
+    {file = "regex-2023.8.8-cp39-cp39-musllinux_1_1_s390x.whl", hash = "sha256:f2200e00b62568cfd920127782c61bc1c546062a879cdc741cfcc6976668dfcf"},
+    {file = "regex-2023.8.8-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:9691a549c19c22d26a4f3b948071e93517bdf86e41b81d8c6ac8a964bb71e5a6"},
+    {file = "regex-2023.8.8-cp39-cp39-win32.whl", hash = "sha256:6ab2ed84bf0137927846b37e882745a827458689eb969028af8032b1b3dac78e"},
+    {file = "regex-2023.8.8-cp39-cp39-win_amd64.whl", hash = "sha256:5543c055d8ec7801901e1193a51570643d6a6ab8751b1f7dd9af71af467538bb"},
+    {file = "regex-2023.8.8.tar.gz", hash = "sha256:fcbdc5f2b0f1cd0f6a56cdb46fe41d2cce1e644e3b68832f3eeebc5fb0f7712e"},
 ]
 
 [[package]]
@@ -716,6 +1035,17 @@ files = [
     {file = "six-1.16.0.tar.gz", hash = "sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926"},
 ]
 
+[[package]]
+name = "soupsieve"
+version = "2.4.1"
+description = "A modern CSS selector implementation for Beautiful Soup."
+optional = false
+python-versions = ">=3.7"
+files = [
+    {file = "soupsieve-2.4.1-py3-none-any.whl", hash = "sha256:1c1bfee6819544a3447586c889157365a27e10d88cde3ad3da0cf0ddf646feb8"},
+    {file = "soupsieve-2.4.1.tar.gz", hash = "sha256:89d12b2d5dfcd2c9e8c22326da9d9aa9cb3dfab0a83a024f05704076ee8d35ea"},
+]
+
 [[package]]
 name = "tinycss2"
 version = "1.2.1"
@@ -736,52 +1066,55 @@ test = ["flake8", "isort", "pytest"]
 
 [[package]]
 name = "urllib3"
-version = "1.26.12"
+version = "2.0.4"
 description = "HTTP library with thread-safe connection pooling, file post, and more."
 optional = false
-python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, <4"
+python-versions = ">=3.7"
 files = [
-    {file = "urllib3-1.26.12-py2.py3-none-any.whl", hash = "sha256:b930dd878d5a8afb066a637fbb35144fe7901e3b209d1cd4f524bd0e9deee997"},
-    {file = "urllib3-1.26.12.tar.gz", hash = "sha256:3fa96cf423e6987997fc326ae8df396db2a8b7c667747d47ddd8ecba91f4a74e"},
+    {file = "urllib3-2.0.4-py3-none-any.whl", hash = "sha256:de7df1803967d2c2a98e4b11bb7d6bd9210474c46e8a0401514e3a42a75ebde4"},
+    {file = "urllib3-2.0.4.tar.gz", hash = "sha256:8d22f86aae8ef5e410d4f539fde9ce6b2113a001bb4d189e0aed70642d602b11"},
 ]
 
 [package.extras]
-brotli = ["brotli (>=1.0.9)", "brotlicffi (>=0.8.0)", "brotlipy (>=0.6.0)"]
-secure = ["certifi", "cryptography (>=1.3.4)", "idna (>=2.0.0)", "ipaddress", "pyOpenSSL (>=0.14)", "urllib3-secure-extra"]
-socks = ["PySocks (>=1.5.6,!=1.5.7,<2.0)"]
+brotli = ["brotli (>=1.0.9)", "brotlicffi (>=0.8.0)"]
+secure = ["certifi", "cryptography (>=1.9)", "idna (>=2.0.0)", "pyopenssl (>=17.1.0)", "urllib3-secure-extra"]
+socks = ["pysocks (>=1.5.6,!=1.5.7,<2.0)"]
+zstd = ["zstandard (>=0.18.0)"]
 
 [[package]]
 name = "watchdog"
-version = "2.1.9"
+version = "3.0.0"
 description = "Filesystem events monitoring"
 optional = false
-python-versions = ">=3.6"
+python-versions = ">=3.7"
 files = [
-    {file = "watchdog-2.1.9-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:a735a990a1095f75ca4f36ea2ef2752c99e6ee997c46b0de507ba40a09bf7330"},
-    {file = "watchdog-2.1.9-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:6b17d302850c8d412784d9246cfe8d7e3af6bcd45f958abb2d08a6f8bedf695d"},
-    {file = "watchdog-2.1.9-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:ee3e38a6cc050a8830089f79cbec8a3878ec2fe5160cdb2dc8ccb6def8552658"},
-    {file = "watchdog-2.1.9-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:64a27aed691408a6abd83394b38503e8176f69031ca25d64131d8d640a307591"},
-    {file = "watchdog-2.1.9-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:195fc70c6e41237362ba720e9aaf394f8178bfc7fa68207f112d108edef1af33"},
-    {file = "watchdog-2.1.9-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:bfc4d351e6348d6ec51df007432e6fe80adb53fd41183716017026af03427846"},
-    {file = "watchdog-2.1.9-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:8250546a98388cbc00c3ee3cc5cf96799b5a595270dfcfa855491a64b86ef8c3"},
-    {file = "watchdog-2.1.9-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:117ffc6ec261639a0209a3252546b12800670d4bf5f84fbd355957a0595fe654"},
-    {file = "watchdog-2.1.9-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:97f9752208f5154e9e7b76acc8c4f5a58801b338de2af14e7e181ee3b28a5d39"},
-    {file = "watchdog-2.1.9-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:247dcf1df956daa24828bfea5a138d0e7a7c98b1a47cf1fa5b0c3c16241fcbb7"},
-    {file = "watchdog-2.1.9-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:226b3c6c468ce72051a4c15a4cc2ef317c32590d82ba0b330403cafd98a62cfd"},
-    {file = "watchdog-2.1.9-pp37-pypy37_pp73-macosx_10_9_x86_64.whl", hash = "sha256:d9820fe47c20c13e3c9dd544d3706a2a26c02b2b43c993b62fcd8011bcc0adb3"},
-    {file = "watchdog-2.1.9-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:70af927aa1613ded6a68089a9262a009fbdf819f46d09c1a908d4b36e1ba2b2d"},
-    {file = "watchdog-2.1.9-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:ed80a1628cee19f5cfc6bb74e173f1b4189eb532e705e2a13e3250312a62e0c9"},
-    {file = "watchdog-2.1.9-py3-none-manylinux2014_aarch64.whl", hash = "sha256:9f05a5f7c12452f6a27203f76779ae3f46fa30f1dd833037ea8cbc2887c60213"},
-    {file = "watchdog-2.1.9-py3-none-manylinux2014_armv7l.whl", hash = "sha256:255bb5758f7e89b1a13c05a5bceccec2219f8995a3a4c4d6968fe1de6a3b2892"},
-    {file = "watchdog-2.1.9-py3-none-manylinux2014_i686.whl", hash = "sha256:d3dda00aca282b26194bdd0adec21e4c21e916956d972369359ba63ade616153"},
-    {file = "watchdog-2.1.9-py3-none-manylinux2014_ppc64.whl", hash = "sha256:186f6c55abc5e03872ae14c2f294a153ec7292f807af99f57611acc8caa75306"},
-    {file = "watchdog-2.1.9-py3-none-manylinux2014_ppc64le.whl", hash = "sha256:083171652584e1b8829581f965b9b7723ca5f9a2cd7e20271edf264cfd7c1412"},
-    {file = "watchdog-2.1.9-py3-none-manylinux2014_s390x.whl", hash = "sha256:b530ae007a5f5d50b7fbba96634c7ee21abec70dc3e7f0233339c81943848dc1"},
-    {file = "watchdog-2.1.9-py3-none-manylinux2014_x86_64.whl", hash = "sha256:4f4e1c4aa54fb86316a62a87b3378c025e228178d55481d30d857c6c438897d6"},
-    {file = "watchdog-2.1.9-py3-none-win32.whl", hash = "sha256:5952135968519e2447a01875a6f5fc8c03190b24d14ee52b0f4b1682259520b1"},
-    {file = "watchdog-2.1.9-py3-none-win_amd64.whl", hash = "sha256:7a833211f49143c3d336729b0020ffd1274078e94b0ae42e22f596999f50279c"},
-    {file = "watchdog-2.1.9-py3-none-win_ia64.whl", hash = "sha256:ad576a565260d8f99d97f2e64b0f97a48228317095908568a9d5c786c829d428"},
-    {file = "watchdog-2.1.9.tar.gz", hash = "sha256:43ce20ebb36a51f21fa376f76d1d4692452b2527ccd601950d69ed36b9e21609"},
+    {file = "watchdog-3.0.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:336adfc6f5cc4e037d52db31194f7581ff744b67382eb6021c868322e32eef41"},
+    {file = "watchdog-3.0.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:a70a8dcde91be523c35b2bf96196edc5730edb347e374c7de7cd20c43ed95397"},
+    {file = "watchdog-3.0.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:adfdeab2da79ea2f76f87eb42a3ab1966a5313e5a69a0213a3cc06ef692b0e96"},
+    {file = "watchdog-3.0.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:2b57a1e730af3156d13b7fdddfc23dea6487fceca29fc75c5a868beed29177ae"},
+    {file = "watchdog-3.0.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:7ade88d0d778b1b222adebcc0927428f883db07017618a5e684fd03b83342bd9"},
+    {file = "watchdog-3.0.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:7e447d172af52ad204d19982739aa2346245cc5ba6f579d16dac4bfec226d2e7"},
+    {file = "watchdog-3.0.0-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:9fac43a7466eb73e64a9940ac9ed6369baa39b3bf221ae23493a9ec4d0022674"},
+    {file = "watchdog-3.0.0-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:8ae9cda41fa114e28faf86cb137d751a17ffd0316d1c34ccf2235e8a84365c7f"},
+    {file = "watchdog-3.0.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:25f70b4aa53bd743729c7475d7ec41093a580528b100e9a8c5b5efe8899592fc"},
+    {file = "watchdog-3.0.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:4f94069eb16657d2c6faada4624c39464f65c05606af50bb7902e036e3219be3"},
+    {file = "watchdog-3.0.0-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:7c5f84b5194c24dd573fa6472685b2a27cc5a17fe5f7b6fd40345378ca6812e3"},
+    {file = "watchdog-3.0.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:3aa7f6a12e831ddfe78cdd4f8996af9cf334fd6346531b16cec61c3b3c0d8da0"},
+    {file = "watchdog-3.0.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:233b5817932685d39a7896b1090353fc8efc1ef99c9c054e46c8002561252fb8"},
+    {file = "watchdog-3.0.0-pp37-pypy37_pp73-macosx_10_9_x86_64.whl", hash = "sha256:13bbbb462ee42ec3c5723e1205be8ced776f05b100e4737518c67c8325cf6100"},
+    {file = "watchdog-3.0.0-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:8f3ceecd20d71067c7fd4c9e832d4e22584318983cabc013dbf3f70ea95de346"},
+    {file = "watchdog-3.0.0-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:c9d8c8ec7efb887333cf71e328e39cffbf771d8f8f95d308ea4125bf5f90ba64"},
+    {file = "watchdog-3.0.0-py3-none-manylinux2014_aarch64.whl", hash = "sha256:0e06ab8858a76e1219e68c7573dfeba9dd1c0219476c5a44d5333b01d7e1743a"},
+    {file = "watchdog-3.0.0-py3-none-manylinux2014_armv7l.whl", hash = "sha256:d00e6be486affb5781468457b21a6cbe848c33ef43f9ea4a73b4882e5f188a44"},
+    {file = "watchdog-3.0.0-py3-none-manylinux2014_i686.whl", hash = "sha256:c07253088265c363d1ddf4b3cdb808d59a0468ecd017770ed716991620b8f77a"},
+    {file = "watchdog-3.0.0-py3-none-manylinux2014_ppc64.whl", hash = "sha256:5113334cf8cf0ac8cd45e1f8309a603291b614191c9add34d33075727a967709"},
+    {file = "watchdog-3.0.0-py3-none-manylinux2014_ppc64le.whl", hash = "sha256:51f90f73b4697bac9c9a78394c3acbbd331ccd3655c11be1a15ae6fe289a8c83"},
+    {file = "watchdog-3.0.0-py3-none-manylinux2014_s390x.whl", hash = "sha256:ba07e92756c97e3aca0912b5cbc4e5ad802f4557212788e72a72a47ff376950d"},
+    {file = "watchdog-3.0.0-py3-none-manylinux2014_x86_64.whl", hash = "sha256:d429c2430c93b7903914e4db9a966c7f2b068dd2ebdd2fa9b9ce094c7d459f33"},
+    {file = "watchdog-3.0.0-py3-none-win32.whl", hash = "sha256:3ed7c71a9dccfe838c2f0b6314ed0d9b22e77d268c67e015450a29036a81f60f"},
+    {file = "watchdog-3.0.0-py3-none-win_amd64.whl", hash = "sha256:4c9956d27be0bb08fc5f30d9d0179a855436e655f046d288e2bcc11adfae893c"},
+    {file = "watchdog-3.0.0-py3-none-win_ia64.whl", hash = "sha256:5d9f3a10e02d7371cd929b5d8f11e87d4bad890212ed3901f9b4d68767bee759"},
+    {file = "watchdog-3.0.0.tar.gz", hash = "sha256:4d98a320595da7a7c5a18fc48cb633c2e73cda78f93cac2ef42d42bf609a33f9"},
 ]
 
 [package.extras]

From 248254dab53fb13a4e9415bcb033b53702ecf814 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Fri, 8 Sep 2023 09:52:05 +0200
Subject: [PATCH 20/39] feat(git): add `git log` range syntax

---
 docs/tools/git/git.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/tools/git/git.md b/docs/tools/git/git.md
index 1496fb5..5f61e1a 100644
--- a/docs/tools/git/git.md
+++ b/docs/tools/git/git.md
@@ -167,6 +167,13 @@ def load_reference(name_or_id):
 `git log --follow <file>`: list version history fo file, including renames  
 `git log --all --graph --decorate`: visualizes history as a DAG  
 `git log  --oneline`: compact log  
+`git log <rev>`: Include commits that are reachable from `<rev>`  
+`git log ^<rev>`: Exclude commits that are reachable from `<rev>`  
+`git log <rev1>..<rev2>`: Include commits that are reachable from `<rev2>` but exclude those that are reachable from `<rev1>`. 
+When either `<rev1>` or `<rev2>` is omitted, it defaults to HEAD.  
+`git log <rev1>...<rev2>`: Include commits that are reachable from either `<rev1>` or `<rev2>` but exclude those that are reachable from both. When either `<rev1>` or `<rev2>` is omitted, it defaults to HEAD.  
+`git log <rev>^@`: Include anything reachable from `<rev>` parents but not the commit itself
+
 
 `git shortlog`: list commits by author  
 `git reflog`: show record of when the tips of branches and other references were updated in the local repository  

From cbee07cbcb11f7fc8e990e8cc5cc15e563569f43 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Mon, 11 Sep 2023 21:51:03 +0200
Subject: [PATCH 21/39] feat(git): add git commit command option notes

---
 docs/tools/git/git.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/tools/git/git.md b/docs/tools/git/git.md
index 5f61e1a..316108c 100644
--- a/docs/tools/git/git.md
+++ b/docs/tools/git/git.md
@@ -109,6 +109,9 @@ def load_reference(name_or_id):
 `git commit -m "message"`: commit and provide a message  
 `git commit -a`: automatically notice any modified (but not new) files and commit  
 `git commit -v|--verbose`: show unified diff between the HEAD commit and what would be committed  
+`git commit --amend`: modify latest commit with the new changes  
+`git commit --no-verify`: commit without executing hooks  
+`git commit --fixup <commit>`: mark commit as correction to another  
 
 `git diff <filename>`: show difference since the last commit  
 `git diff <commit> <filename>`: show differences in a file since a particular snapshot  

From 3927f011d7f896bc552cce9a0e489d25f6b5629f Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Mon, 11 Sep 2023 21:51:25 +0200
Subject: [PATCH 22/39] feat(git): add git rebase command option notes

---
 docs/tools/git/git.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/tools/git/git.md b/docs/tools/git/git.md
index 316108c..9130f1d 100644
--- a/docs/tools/git/git.md
+++ b/docs/tools/git/git.md
@@ -233,7 +233,7 @@ It's generally recommended creating annotated tags so it's possible to have all
 `git cherry-pick <commit>^..<commit>`: bring in a  range of commits from another branch (first included)  
 `git cherry-pick <commit>..<commit>`: bring in a  range of commits from another branch (first excluded)  
 
-### Undo & [Rewriting History](https://www.themoderncoder.com/rewriting-git-history/)
+### Undo & Rewriting History
 
 `git rm -r --cached <file>`: remove a file from being tracked  
 `git commit --amend`: replace last commit by creating a new one (can add files or rewrite commit message)  
@@ -252,8 +252,11 @@ It's generally recommended creating annotated tags so it's possible to have all
 `git restore --source <commit> <file>`: revert file to commit version  
 `git restore <deleted-file>`: recover deleted file if previously committed  
 
+`git rebase -i`: modify (reword, edit, drop, squash, merge, ...) current branch commits  
 `git rebase -i HEAD~<n>`: modify (reword, edit, drop, squash, merge, ...) *n* commits  
 `git rebase -i <commit>`: modify (reword, edit, drop, squash, merge, ...) *from* commit to latest  
+`git rebase --autostash`: automatically create a temporary stash entry before rebasing  
+`git rebase --autosquash`: automatically apply "squash!" or "fixup!" or "amend!" commits  
 
 > **WARN**: Changing history can have nasty side effects
 

From f57b7ed07507d75556e41f6088f02a60c090a91a Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Fri, 8 Sep 2023 09:57:49 +0200
Subject: [PATCH 23/39] chore(git): move git notes under 'Misc'

---
 docs/{tools/git => }/git.md | 2 +-
 mkdocs.yml                  | 3 +--
 2 files changed, 2 insertions(+), 3 deletions(-)
 rename docs/{tools/git => }/git.md (99%)

diff --git a/docs/tools/git/git.md b/docs/git.md
similarity index 99%
rename from docs/tools/git/git.md
rename to docs/git.md
index 9130f1d..c751fb2 100644
--- a/docs/tools/git/git.md
+++ b/docs/git.md
@@ -211,7 +211,7 @@ It's generally recommended creating annotated tags so it's possible to have all
 
 ### Branching And Merging
 
-![branch](../../img/git_branches.png "how branches work")
+![branch](img/git_branches.png "how branches work")
 
 `git branch`: shows branches  
 `git branch -vv`: show branch + last commit + remote status  
diff --git a/mkdocs.yml b/mkdocs.yml
index 1c58e26..c322f0c 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -176,11 +176,10 @@ nav:
     - Bash:
         - Scripting: languages/bash/scripting.md
         - Commands: languages/bash/commands.md
-  - Tools:
-    - Git: tools/git/git.md
   - Devices:
     - iOS:
       - ContentView: devices/ios/content-view.md
   - Misc:
+    - Git: git.md
     - GraphQL: graph-ql.md
     - RegEx: regular-expressions.md
\ No newline at end of file

From 1f0748536f17a614da614dce17da2c0b118a4aeb Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Mon, 18 Sep 2023 10:51:28 +0200
Subject: [PATCH 24/39] chore: move file under 'misc' folder

---
 docs/{ => misc}/git.md                 | 0
 docs/{ => misc}/graph-ql.md            | 0
 docs/{ => misc}/regular-expressions.md | 0
 mkdocs.yml                             | 6 +++---
 4 files changed, 3 insertions(+), 3 deletions(-)
 rename docs/{ => misc}/git.md (100%)
 rename docs/{ => misc}/graph-ql.md (100%)
 rename docs/{ => misc}/regular-expressions.md (100%)

diff --git a/docs/git.md b/docs/misc/git.md
similarity index 100%
rename from docs/git.md
rename to docs/misc/git.md
diff --git a/docs/graph-ql.md b/docs/misc/graph-ql.md
similarity index 100%
rename from docs/graph-ql.md
rename to docs/misc/graph-ql.md
diff --git a/docs/regular-expressions.md b/docs/misc/regular-expressions.md
similarity index 100%
rename from docs/regular-expressions.md
rename to docs/misc/regular-expressions.md
diff --git a/mkdocs.yml b/mkdocs.yml
index c322f0c..8d65e1c 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -180,6 +180,6 @@ nav:
     - iOS:
       - ContentView: devices/ios/content-view.md
   - Misc:
-    - Git: git.md
-    - GraphQL: graph-ql.md
-    - RegEx: regular-expressions.md
\ No newline at end of file
+    - Git: misc/git.md
+    - GraphQL: misc/graph-ql.md
+    - RegEx: misc/regular-expressions.md
\ No newline at end of file

From 2709a479da23ffb3df86a58387eb3d4c7975c5c5 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Mon, 18 Sep 2023 16:10:14 +0200
Subject: [PATCH 25/39] feat(ssh): add `ssh` notes

---
 docs/misc/ssh.md | 45 +++++++++++++++++++++++++++++++++++++++++++++
 mkdocs.yml       |  3 ++-
 2 files changed, 47 insertions(+), 1 deletion(-)
 create mode 100644 docs/misc/ssh.md

diff --git a/docs/misc/ssh.md b/docs/misc/ssh.md
new file mode 100644
index 0000000..f800750
--- /dev/null
+++ b/docs/misc/ssh.md
@@ -0,0 +1,45 @@
+# SSH
+
+`ssh` is a program for logging into a remote machine and for executing commands on a remote machine. It is intended to provide secure encrypted communications between two untrusted hosts over an insecure network.
+
+## Basics
+
+```sh
+ssh user@destination <command> # exec <command> in remote machine ($SHELL if omitted)
+ssh user@destination -i <path/to/private-key>  # use key for auth
+ssh user@destination -f  # exec ssh in the background
+ssh user@destination -N  # do not send commands to the server (do not start $SHELL)
+ssh user@destination -g  # allow remote hosts to connect to local forwarded ports
+ssh user@destination -t  # force pseudo-tty emulation
+```
+
+> **Note**: use `~` while connected to use the "ssh console".
+
+### Jump-Hosts
+
+Connect to the final destination jumping through the specifies other destinations.
+
+```sh
+ssh -J user_1@destination_1,user_2@destination_2 user@final_destination
+```
+
+## Port Forwarding
+
+![ssh-tunnels](https://iximiuz.com/ssh-tunnels/ssh-tunnels.png "SSH Tunnels Cheat Sheet By Ivan Velichko")
+
+### Local Port Forwarding
+
+Start listening on `local_address:local_port` and forward any traffic to `remote_address:remote_port`.
+
+```sh
+ssh -N -f -L local_address:local_port:remote_address:remote_port user@destination
+ssh -N -f -L local_port:remote_address:remote_port user@destination  # local_address defaults to localhost
+```
+
+### Remote Port Forwarding
+
+Start listening on `remote_address:remote_port` and forward any traffic to `local_address:local_port`.
+
+```sh
+ssh -N -f -R remote_address:remote_port:local_address:local_port user@destination
+```
diff --git a/mkdocs.yml b/mkdocs.yml
index 8d65e1c..0052ad5 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -182,4 +182,5 @@ nav:
   - Misc:
     - Git: misc/git.md
     - GraphQL: misc/graph-ql.md
-    - RegEx: misc/regular-expressions.md
\ No newline at end of file
+    - RegEx: misc/regular-expressions.md
+    - SSH: misc/ssh.md
\ No newline at end of file

From 2fefc2dd5537d8eb4a9c6890106f5814ec9e5f18 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Thu, 21 Sep 2023 19:36:24 +0200
Subject: [PATCH 26/39] bump mkdocs-matarial to v9.4.0

---
 poetry.lock    | 373 ++++++++++++-------------------------------------
 pyproject.toml |   2 +-
 2 files changed, 90 insertions(+), 285 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 287f889..038c9ab 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -11,24 +11,6 @@ files = [
     {file = "Babel-2.12.1.tar.gz", hash = "sha256:cc2d99999cd01d44420ae725a21c9e3711b3aadc7976d6147f622d8581963455"},
 ]
 
-[[package]]
-name = "beautifulsoup4"
-version = "4.12.2"
-description = "Screen-scraping library"
-optional = false
-python-versions = ">=3.6.0"
-files = [
-    {file = "beautifulsoup4-4.12.2-py3-none-any.whl", hash = "sha256:bd2520ca0d9d7d12694a53d44ac482d181b4ec1888909b035a3dbf40d0f57d4a"},
-    {file = "beautifulsoup4-4.12.2.tar.gz", hash = "sha256:492bbc69dca35d12daac71c4db1bfff0c876c00ef4a2ffacce226d4638eb72da"},
-]
-
-[package.dependencies]
-soupsieve = ">1.2"
-
-[package.extras]
-html5lib = ["html5lib"]
-lxml = ["lxml"]
-
 [[package]]
 name = "cairocffi"
 version = "1.6.1"
@@ -266,17 +248,6 @@ files = [
     {file = "colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44"},
 ]
 
-[[package]]
-name = "cssselect"
-version = "1.2.0"
-description = "cssselect parses CSS3 Selectors and translates them to XPath 1.0"
-optional = false
-python-versions = ">=3.7"
-files = [
-    {file = "cssselect-1.2.0-py2.py3-none-any.whl", hash = "sha256:da1885f0c10b60c03ed5eccbb6b68d6eff248d91976fcde348f395d54c9fd35e"},
-    {file = "cssselect-1.2.0.tar.gz", hash = "sha256:666b19839cfaddb9ce9d36bfe4c969132c647b92fc9088c4e23f786b30f1b3dc"},
-]
-
 [[package]]
 name = "cssselect2"
 version = "0.7.0"
@@ -352,113 +323,6 @@ MarkupSafe = ">=2.0"
 [package.extras]
 i18n = ["Babel (>=2.7)"]
 
-[[package]]
-name = "lxml"
-version = "4.9.3"
-description = "Powerful and Pythonic XML processing library combining libxml2/libxslt with the ElementTree API."
-optional = false
-python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, != 3.4.*"
-files = [
-    {file = "lxml-4.9.3-cp27-cp27m-macosx_11_0_x86_64.whl", hash = "sha256:b0a545b46b526d418eb91754565ba5b63b1c0b12f9bd2f808c852d9b4b2f9b5c"},
-    {file = "lxml-4.9.3-cp27-cp27m-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:075b731ddd9e7f68ad24c635374211376aa05a281673ede86cbe1d1b3455279d"},
-    {file = "lxml-4.9.3-cp27-cp27m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:1e224d5755dba2f4a9498e150c43792392ac9b5380aa1b845f98a1618c94eeef"},
-    {file = "lxml-4.9.3-cp27-cp27m-win32.whl", hash = "sha256:2c74524e179f2ad6d2a4f7caf70e2d96639c0954c943ad601a9e146c76408ed7"},
-    {file = "lxml-4.9.3-cp27-cp27m-win_amd64.whl", hash = "sha256:4f1026bc732b6a7f96369f7bfe1a4f2290fb34dce00d8644bc3036fb351a4ca1"},
-    {file = "lxml-4.9.3-cp27-cp27mu-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c0781a98ff5e6586926293e59480b64ddd46282953203c76ae15dbbbf302e8bb"},
-    {file = "lxml-4.9.3-cp27-cp27mu-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:cef2502e7e8a96fe5ad686d60b49e1ab03e438bd9123987994528febd569868e"},
-    {file = "lxml-4.9.3-cp310-cp310-macosx_11_0_x86_64.whl", hash = "sha256:b86164d2cff4d3aaa1f04a14685cbc072efd0b4f99ca5708b2ad1b9b5988a991"},
-    {file = "lxml-4.9.3-cp310-cp310-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:42871176e7896d5d45138f6d28751053c711ed4d48d8e30b498da155af39aebd"},
-    {file = "lxml-4.9.3-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:ae8b9c6deb1e634ba4f1930eb67ef6e6bf6a44b6eb5ad605642b2d6d5ed9ce3c"},
-    {file = "lxml-4.9.3-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:411007c0d88188d9f621b11d252cce90c4a2d1a49db6c068e3c16422f306eab8"},
-    {file = "lxml-4.9.3-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:cd47b4a0d41d2afa3e58e5bf1f62069255aa2fd6ff5ee41604418ca925911d76"},
-    {file = "lxml-4.9.3-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:0e2cb47860da1f7e9a5256254b74ae331687b9672dfa780eed355c4c9c3dbd23"},
-    {file = "lxml-4.9.3-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1247694b26342a7bf47c02e513d32225ededd18045264d40758abeb3c838a51f"},
-    {file = "lxml-4.9.3-cp310-cp310-win32.whl", hash = "sha256:cdb650fc86227eba20de1a29d4b2c1bfe139dc75a0669270033cb2ea3d391b85"},
-    {file = "lxml-4.9.3-cp310-cp310-win_amd64.whl", hash = "sha256:97047f0d25cd4bcae81f9ec9dc290ca3e15927c192df17331b53bebe0e3ff96d"},
-    {file = "lxml-4.9.3-cp311-cp311-macosx_11_0_universal2.whl", hash = "sha256:1f447ea5429b54f9582d4b955f5f1985f278ce5cf169f72eea8afd9502973dd5"},
-    {file = "lxml-4.9.3-cp311-cp311-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:57d6ba0ca2b0c462f339640d22882acc711de224d769edf29962b09f77129cbf"},
-    {file = "lxml-4.9.3-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:9767e79108424fb6c3edf8f81e6730666a50feb01a328f4a016464a5893f835a"},
-    {file = "lxml-4.9.3-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:71c52db65e4b56b8ddc5bb89fb2e66c558ed9d1a74a45ceb7dcb20c191c3df2f"},
-    {file = "lxml-4.9.3-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:d73d8ecf8ecf10a3bd007f2192725a34bd62898e8da27eb9d32a58084f93962b"},
-    {file = "lxml-4.9.3-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:0a3d3487f07c1d7f150894c238299934a2a074ef590b583103a45002035be120"},
-    {file = "lxml-4.9.3-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:9e28c51fa0ce5674be9f560c6761c1b441631901993f76700b1b30ca6c8378d6"},
-    {file = "lxml-4.9.3-cp311-cp311-win32.whl", hash = "sha256:0bfd0767c5c1de2551a120673b72e5d4b628737cb05414f03c3277bf9bed3305"},
-    {file = "lxml-4.9.3-cp311-cp311-win_amd64.whl", hash = "sha256:25f32acefac14ef7bd53e4218fe93b804ef6f6b92ffdb4322bb6d49d94cad2bc"},
-    {file = "lxml-4.9.3-cp312-cp312-macosx_11_0_universal2.whl", hash = "sha256:d3ff32724f98fbbbfa9f49d82852b159e9784d6094983d9a8b7f2ddaebb063d4"},
-    {file = "lxml-4.9.3-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:48d6ed886b343d11493129e019da91d4039826794a3e3027321c56d9e71505be"},
-    {file = "lxml-4.9.3-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:9a92d3faef50658dd2c5470af249985782bf754c4e18e15afb67d3ab06233f13"},
-    {file = "lxml-4.9.3-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:b4e4bc18382088514ebde9328da057775055940a1f2e18f6ad2d78aa0f3ec5b9"},
-    {file = "lxml-4.9.3-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:fc9b106a1bf918db68619fdcd6d5ad4f972fdd19c01d19bdb6bf63f3589a9ec5"},
-    {file = "lxml-4.9.3-cp312-cp312-win_amd64.whl", hash = "sha256:d37017287a7adb6ab77e1c5bee9bcf9660f90ff445042b790402a654d2ad81d8"},
-    {file = "lxml-4.9.3-cp35-cp35m-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:56dc1f1ebccc656d1b3ed288f11e27172a01503fc016bcabdcbc0978b19352b7"},
-    {file = "lxml-4.9.3-cp35-cp35m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:578695735c5a3f51569810dfebd05dd6f888147a34f0f98d4bb27e92b76e05c2"},
-    {file = "lxml-4.9.3-cp35-cp35m-win32.whl", hash = "sha256:704f61ba8c1283c71b16135caf697557f5ecf3e74d9e453233e4771d68a1f42d"},
-    {file = "lxml-4.9.3-cp35-cp35m-win_amd64.whl", hash = "sha256:c41bfca0bd3532d53d16fd34d20806d5c2b1ace22a2f2e4c0008570bf2c58833"},
-    {file = "lxml-4.9.3-cp36-cp36m-macosx_11_0_x86_64.whl", hash = "sha256:64f479d719dc9f4c813ad9bb6b28f8390360660b73b2e4beb4cb0ae7104f1c12"},
-    {file = "lxml-4.9.3-cp36-cp36m-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:dd708cf4ee4408cf46a48b108fb9427bfa00b9b85812a9262b5c668af2533ea5"},
-    {file = "lxml-4.9.3-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5c31c7462abdf8f2ac0577d9f05279727e698f97ecbb02f17939ea99ae8daa98"},
-    {file = "lxml-4.9.3-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:e3cd95e10c2610c360154afdc2f1480aea394f4a4f1ea0a5eacce49640c9b190"},
-    {file = "lxml-4.9.3-cp36-cp36m-manylinux_2_28_x86_64.whl", hash = "sha256:4930be26af26ac545c3dffb662521d4e6268352866956672231887d18f0eaab2"},
-    {file = "lxml-4.9.3-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4aec80cde9197340bc353d2768e2a75f5f60bacda2bab72ab1dc499589b3878c"},
-    {file = "lxml-4.9.3-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:14e019fd83b831b2e61baed40cab76222139926b1fb5ed0e79225bc0cae14584"},
-    {file = "lxml-4.9.3-cp36-cp36m-musllinux_1_1_aarch64.whl", hash = "sha256:0c0850c8b02c298d3c7006b23e98249515ac57430e16a166873fc47a5d549287"},
-    {file = "lxml-4.9.3-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:aca086dc5f9ef98c512bac8efea4483eb84abbf926eaeedf7b91479feb092458"},
-    {file = "lxml-4.9.3-cp36-cp36m-win32.whl", hash = "sha256:50baa9c1c47efcaef189f31e3d00d697c6d4afda5c3cde0302d063492ff9b477"},
-    {file = "lxml-4.9.3-cp36-cp36m-win_amd64.whl", hash = "sha256:bef4e656f7d98aaa3486d2627e7d2df1157d7e88e7efd43a65aa5dd4714916cf"},
-    {file = "lxml-4.9.3-cp37-cp37m-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:46f409a2d60f634fe550f7133ed30ad5321ae2e6630f13657fb9479506b00601"},
-    {file = "lxml-4.9.3-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:4c28a9144688aef80d6ea666c809b4b0e50010a2aca784c97f5e6bf143d9f129"},
-    {file = "lxml-4.9.3-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:141f1d1a9b663c679dc524af3ea1773e618907e96075262726c7612c02b149a4"},
-    {file = "lxml-4.9.3-cp37-cp37m-manylinux_2_28_x86_64.whl", hash = "sha256:53ace1c1fd5a74ef662f844a0413446c0629d151055340e9893da958a374f70d"},
-    {file = "lxml-4.9.3-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:17a753023436a18e27dd7769e798ce302963c236bc4114ceee5b25c18c52c693"},
-    {file = "lxml-4.9.3-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:7d298a1bd60c067ea75d9f684f5f3992c9d6766fadbc0bcedd39750bf344c2f4"},
-    {file = "lxml-4.9.3-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:081d32421db5df44c41b7f08a334a090a545c54ba977e47fd7cc2deece78809a"},
-    {file = "lxml-4.9.3-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:23eed6d7b1a3336ad92d8e39d4bfe09073c31bfe502f20ca5116b2a334f8ec02"},
-    {file = "lxml-4.9.3-cp37-cp37m-win32.whl", hash = "sha256:1509dd12b773c02acd154582088820893109f6ca27ef7291b003d0e81666109f"},
-    {file = "lxml-4.9.3-cp37-cp37m-win_amd64.whl", hash = "sha256:120fa9349a24c7043854c53cae8cec227e1f79195a7493e09e0c12e29f918e52"},
-    {file = "lxml-4.9.3-cp38-cp38-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:4d2d1edbca80b510443f51afd8496be95529db04a509bc8faee49c7b0fb6d2cc"},
-    {file = "lxml-4.9.3-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:8d7e43bd40f65f7d97ad8ef5c9b1778943d02f04febef12def25f7583d19baac"},
-    {file = "lxml-4.9.3-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:71d66ee82e7417828af6ecd7db817913cb0cf9d4e61aa0ac1fde0583d84358db"},
-    {file = "lxml-4.9.3-cp38-cp38-manylinux_2_28_x86_64.whl", hash = "sha256:6fc3c450eaa0b56f815c7b62f2b7fba7266c4779adcf1cece9e6deb1de7305ce"},
-    {file = "lxml-4.9.3-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:65299ea57d82fb91c7f019300d24050c4ddeb7c5a190e076b5f48a2b43d19c42"},
-    {file = "lxml-4.9.3-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:eadfbbbfb41b44034a4c757fd5d70baccd43296fb894dba0295606a7cf3124aa"},
-    {file = "lxml-4.9.3-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:3e9bdd30efde2b9ccfa9cb5768ba04fe71b018a25ea093379c857c9dad262c40"},
-    {file = "lxml-4.9.3-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:fcdd00edfd0a3001e0181eab3e63bd5c74ad3e67152c84f93f13769a40e073a7"},
-    {file = "lxml-4.9.3-cp38-cp38-win32.whl", hash = "sha256:57aba1bbdf450b726d58b2aea5fe47c7875f5afb2c4a23784ed78f19a0462574"},
-    {file = "lxml-4.9.3-cp38-cp38-win_amd64.whl", hash = "sha256:92af161ecbdb2883c4593d5ed4815ea71b31fafd7fd05789b23100d081ecac96"},
-    {file = "lxml-4.9.3-cp39-cp39-macosx_11_0_x86_64.whl", hash = "sha256:9bb6ad405121241e99a86efff22d3ef469024ce22875a7ae045896ad23ba2340"},
-    {file = "lxml-4.9.3-cp39-cp39-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:8ed74706b26ad100433da4b9d807eae371efaa266ffc3e9191ea436087a9d6a7"},
-    {file = "lxml-4.9.3-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:fbf521479bcac1e25a663df882c46a641a9bff6b56dc8b0fafaebd2f66fb231b"},
-    {file = "lxml-4.9.3-cp39-cp39-manylinux_2_28_aarch64.whl", hash = "sha256:303bf1edce6ced16bf67a18a1cf8339d0db79577eec5d9a6d4a80f0fb10aa2da"},
-    {file = "lxml-4.9.3-cp39-cp39-manylinux_2_28_x86_64.whl", hash = "sha256:5515edd2a6d1a5a70bfcdee23b42ec33425e405c5b351478ab7dc9347228f96e"},
-    {file = "lxml-4.9.3-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:690dafd0b187ed38583a648076865d8c229661ed20e48f2335d68e2cf7dc829d"},
-    {file = "lxml-4.9.3-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:b6420a005548ad52154c8ceab4a1290ff78d757f9e5cbc68f8c77089acd3c432"},
-    {file = "lxml-4.9.3-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:bb3bb49c7a6ad9d981d734ef7c7193bc349ac338776a0360cc671eaee89bcf69"},
-    {file = "lxml-4.9.3-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:d27be7405547d1f958b60837dc4c1007da90b8b23f54ba1f8b728c78fdb19d50"},
-    {file = "lxml-4.9.3-cp39-cp39-win32.whl", hash = "sha256:8df133a2ea5e74eef5e8fc6f19b9e085f758768a16e9877a60aec455ed2609b2"},
-    {file = "lxml-4.9.3-cp39-cp39-win_amd64.whl", hash = "sha256:4dd9a263e845a72eacb60d12401e37c616438ea2e5442885f65082c276dfb2b2"},
-    {file = "lxml-4.9.3-pp310-pypy310_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:6689a3d7fd13dc687e9102a27e98ef33730ac4fe37795d5036d18b4d527abd35"},
-    {file = "lxml-4.9.3-pp37-pypy37_pp73-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:f6bdac493b949141b733c5345b6ba8f87a226029cbabc7e9e121a413e49441e0"},
-    {file = "lxml-4.9.3-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:05186a0f1346ae12553d66df1cfce6f251589fea3ad3da4f3ef4e34b2d58c6a3"},
-    {file = "lxml-4.9.3-pp37-pypy37_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:c2006f5c8d28dee289f7020f721354362fa304acbaaf9745751ac4006650254b"},
-    {file = "lxml-4.9.3-pp38-pypy38_pp73-macosx_11_0_x86_64.whl", hash = "sha256:5c245b783db29c4e4fbbbfc9c5a78be496c9fea25517f90606aa1f6b2b3d5f7b"},
-    {file = "lxml-4.9.3-pp38-pypy38_pp73-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:4fb960a632a49f2f089d522f70496640fdf1218f1243889da3822e0a9f5f3ba7"},
-    {file = "lxml-4.9.3-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:50670615eaf97227d5dc60de2dc99fb134a7130d310d783314e7724bf163f75d"},
-    {file = "lxml-4.9.3-pp38-pypy38_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:9719fe17307a9e814580af1f5c6e05ca593b12fb7e44fe62450a5384dbf61b4b"},
-    {file = "lxml-4.9.3-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:3331bece23c9ee066e0fb3f96c61322b9e0f54d775fccefff4c38ca488de283a"},
-    {file = "lxml-4.9.3-pp39-pypy39_pp73-macosx_11_0_x86_64.whl", hash = "sha256:ed667f49b11360951e201453fc3967344d0d0263aa415e1619e85ae7fd17b4e0"},
-    {file = "lxml-4.9.3-pp39-pypy39_pp73-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_24_i686.whl", hash = "sha256:8b77946fd508cbf0fccd8e400a7f71d4ac0e1595812e66025bac475a8e811694"},
-    {file = "lxml-4.9.3-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:e4da8ca0c0c0aea88fd46be8e44bd49716772358d648cce45fe387f7b92374a7"},
-    {file = "lxml-4.9.3-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:fe4bda6bd4340caa6e5cf95e73f8fea5c4bfc55763dd42f1b50a94c1b4a2fbd4"},
-    {file = "lxml-4.9.3-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:f3df3db1d336b9356dd3112eae5f5c2b8b377f3bc826848567f10bfddfee77e9"},
-    {file = "lxml-4.9.3.tar.gz", hash = "sha256:48628bd53a426c9eb9bc066a923acaa0878d1e86129fd5359aee99285f4eed9c"},
-]
-
-[package.extras]
-cssselect = ["cssselect (>=0.7)"]
-html5 = ["html5lib"]
-htmlsoup = ["BeautifulSoup4"]
-source = ["Cython (>=0.29.35)"]
-
 [[package]]
 name = "markdown"
 version = "3.4.4"
@@ -474,22 +338,6 @@ files = [
 docs = ["mdx-gh-links (>=0.2)", "mkdocs (>=1.0)", "mkdocs-nature (>=0.4)"]
 testing = ["coverage", "pyyaml"]
 
-[[package]]
-name = "markdown2"
-version = "2.4.10"
-description = "A fast and complete Python implementation of Markdown"
-optional = false
-python-versions = ">=3.5, <4"
-files = [
-    {file = "markdown2-2.4.10-py2.py3-none-any.whl", hash = "sha256:e6105800483783831f5dc54f827aa5b44eb137ecef5a70293d8ecfbb4109ecc6"},
-    {file = "markdown2-2.4.10.tar.gz", hash = "sha256:cdba126d90dc3aef6f4070ac342f974d63f415678959329cc7909f96cc235d72"},
-]
-
-[package.extras]
-all = ["pygments (>=2.7.3)", "wavedrom"]
-code-syntax-highlighting = ["pygments (>=2.7.3)"]
-wavedrom = ["wavedrom"]
-
 [[package]]
 name = "markupsafe"
 version = "2.1.3"
@@ -562,13 +410,13 @@ files = [
 
 [[package]]
 name = "mkdocs"
-version = "1.5.2"
+version = "1.5.3"
 description = "Project documentation with Markdown."
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "mkdocs-1.5.2-py3-none-any.whl", hash = "sha256:60a62538519c2e96fe8426654a67ee177350451616118a41596ae7c876bb7eac"},
-    {file = "mkdocs-1.5.2.tar.gz", hash = "sha256:70d0da09c26cff288852471be03c23f0f521fc15cf16ac89c7a3bfb9ae8d24f9"},
+    {file = "mkdocs-1.5.3-py3-none-any.whl", hash = "sha256:3b3a78e736b31158d64dbb2f8ba29bd46a379d0c6e324c2246c3bc3d2189cfc1"},
+    {file = "mkdocs-1.5.3.tar.gz", hash = "sha256:eb7c99214dcb945313ba30426c2451b735992c73c2e10838f76d09e39ff4d0e2"},
 ]
 
 [package.dependencies]
@@ -592,39 +440,42 @@ min-versions = ["babel (==2.9.0)", "click (==7.0)", "colorama (==0.4)", "ghp-imp
 
 [[package]]
 name = "mkdocs-material"
-version = "9.2.5"
+version = "9.4.2"
 description = "Documentation that simply works"
 optional = false
-python-versions = ">=3.7"
+python-versions = ">=3.8"
 files = [
-    {file = "mkdocs_material-9.2.5-py3-none-any.whl", hash = "sha256:315a59725f0565bccfec7f9d1313beae7658bf874a176264b98f804a0cbc1298"},
-    {file = "mkdocs_material-9.2.5.tar.gz", hash = "sha256:02b4d1f662bc022e9497411e679323c30185e031a08a7004c763aa8d47ae9a29"},
+    {file = "mkdocs_material-9.4.2-py3-none-any.whl", hash = "sha256:8651ff451f84681df9d2e3388906eee63c866576d98d6bb542826f83a091b289"},
+    {file = "mkdocs_material-9.4.2.tar.gz", hash = "sha256:d53b17d058e70efd04c281f9b384ca10fb1f0bfecfe85dacdadad891bb826e3d"},
 ]
 
 [package.dependencies]
-babel = ">=2.10.3"
-colorama = ">=0.4"
-jinja2 = ">=3.0"
-lxml = ">=4.6"
-markdown = ">=3.2"
-mkdocs = ">=1.5.2"
-mkdocs-material-extensions = ">=1.1"
-paginate = ">=0.5.6"
-pygments = ">=2.14"
-pymdown-extensions = ">=9.9.1"
-readtime = ">=2.0"
-regex = ">=2022.4.24"
-requests = ">=2.26"
+babel = ">=2.10,<3.0"
+colorama = ">=0.4,<1.0"
+jinja2 = ">=3.0,<4.0"
+markdown = ">=3.2,<4.0"
+mkdocs = ">=1.5.3,<2.0"
+mkdocs-material-extensions = ">=1.2,<2.0"
+paginate = ">=0.5,<1.0"
+pygments = ">=2.16,<3.0"
+pymdown-extensions = ">=10.2,<11.0"
+regex = ">=2022.4"
+requests = ">=2.26,<3.0"
+
+[package.extras]
+git = ["mkdocs-git-committers-plugin-2 (>=1.1,<2.0)", "mkdocs-git-revision-date-localized-plugin (>=1.2,<2.0)"]
+imaging = ["cairosvg (>=2.6,<3.0)", "pillow (>=9.4,<10.0)"]
+recommended = ["mkdocs-minify-plugin (>=0.7,<1.0)", "mkdocs-redirects (>=1.2,<2.0)", "mkdocs-rss-plugin (>=1.6,<2.0)"]
 
 [[package]]
 name = "mkdocs-material-extensions"
-version = "1.1.1"
+version = "1.2"
 description = "Extension pack for Python Markdown and MkDocs Material."
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "mkdocs_material_extensions-1.1.1-py3-none-any.whl", hash = "sha256:e41d9f38e4798b6617ad98ca8f7f1157b1e4385ac1459ca1e4ea219b556df945"},
-    {file = "mkdocs_material_extensions-1.1.1.tar.gz", hash = "sha256:9c003da71e2cc2493d910237448c672e00cefc800d3d6ae93d2fc69979e3bd93"},
+    {file = "mkdocs_material_extensions-1.2-py3-none-any.whl", hash = "sha256:c767bd6d6305f6420a50f0b541b0c9966d52068839af97029be14443849fb8a1"},
+    {file = "mkdocs_material_extensions-1.2.tar.gz", hash = "sha256:27e2d1ed2d031426a6e10d5ea06989d67e90bb02acd588bc5673106b5ee5eedf"},
 ]
 
 [[package]]
@@ -661,67 +512,65 @@ files = [
 
 [[package]]
 name = "pillow"
-version = "10.0.0"
+version = "10.0.1"
 description = "Python Imaging Library (Fork)"
 optional = false
 python-versions = ">=3.8"
 files = [
-    {file = "Pillow-10.0.0-cp310-cp310-macosx_10_10_x86_64.whl", hash = "sha256:1f62406a884ae75fb2f818694469519fb685cc7eaff05d3451a9ebe55c646891"},
-    {file = "Pillow-10.0.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:d5db32e2a6ccbb3d34d87c87b432959e0db29755727afb37290e10f6e8e62614"},
-    {file = "Pillow-10.0.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:edf4392b77bdc81f36e92d3a07a5cd072f90253197f4a52a55a8cec48a12483b"},
-    {file = "Pillow-10.0.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:520f2a520dc040512699f20fa1c363eed506e94248d71f85412b625026f6142c"},
-    {file = "Pillow-10.0.0-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:8c11160913e3dd06c8ffdb5f233a4f254cb449f4dfc0f8f4549eda9e542c93d1"},
-    {file = "Pillow-10.0.0-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:a74ba0c356aaa3bb8e3eb79606a87669e7ec6444be352870623025d75a14a2bf"},
-    {file = "Pillow-10.0.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:d5d0dae4cfd56969d23d94dc8e89fb6a217be461c69090768227beb8ed28c0a3"},
-    {file = "Pillow-10.0.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:22c10cc517668d44b211717fd9775799ccec4124b9a7f7b3635fc5386e584992"},
-    {file = "Pillow-10.0.0-cp310-cp310-win_amd64.whl", hash = "sha256:dffe31a7f47b603318c609f378ebcd57f1554a3a6a8effbc59c3c69f804296de"},
-    {file = "Pillow-10.0.0-cp311-cp311-macosx_10_10_x86_64.whl", hash = "sha256:9fb218c8a12e51d7ead2a7c9e101a04982237d4855716af2e9499306728fb485"},
-    {file = "Pillow-10.0.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:d35e3c8d9b1268cbf5d3670285feb3528f6680420eafe35cccc686b73c1e330f"},
-    {file = "Pillow-10.0.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3ed64f9ca2f0a95411e88a4efbd7a29e5ce2cea36072c53dd9d26d9c76f753b3"},
-    {file = "Pillow-10.0.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b6eb5502f45a60a3f411c63187db83a3d3107887ad0d036c13ce836f8a36f1d"},
-    {file = "Pillow-10.0.0-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:c1fbe7621c167ecaa38ad29643d77a9ce7311583761abf7836e1510c580bf3dd"},
-    {file = "Pillow-10.0.0-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:cd25d2a9d2b36fcb318882481367956d2cf91329f6892fe5d385c346c0649629"},
-    {file = "Pillow-10.0.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:3b08d4cc24f471b2c8ca24ec060abf4bebc6b144cb89cba638c720546b1cf538"},
-    {file = "Pillow-10.0.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:d737a602fbd82afd892ca746392401b634e278cb65d55c4b7a8f48e9ef8d008d"},
-    {file = "Pillow-10.0.0-cp311-cp311-win_amd64.whl", hash = "sha256:3a82c40d706d9aa9734289740ce26460a11aeec2d9c79b7af87bb35f0073c12f"},
-    {file = "Pillow-10.0.0-cp311-cp311-win_arm64.whl", hash = "sha256:bc2ec7c7b5d66b8ec9ce9f720dbb5fa4bace0f545acd34870eff4a369b44bf37"},
-    {file = "Pillow-10.0.0-cp312-cp312-macosx_10_10_x86_64.whl", hash = "sha256:d80cf684b541685fccdd84c485b31ce73fc5c9b5d7523bf1394ce134a60c6883"},
-    {file = "Pillow-10.0.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:76de421f9c326da8f43d690110f0e79fe3ad1e54be811545d7d91898b4c8493e"},
-    {file = "Pillow-10.0.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:81ff539a12457809666fef6624684c008e00ff6bf455b4b89fd00a140eecd640"},
-    {file = "Pillow-10.0.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ce543ed15570eedbb85df19b0a1a7314a9c8141a36ce089c0a894adbfccb4568"},
-    {file = "Pillow-10.0.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:685ac03cc4ed5ebc15ad5c23bc555d68a87777586d970c2c3e216619a5476223"},
-    {file = "Pillow-10.0.0-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:d72e2ecc68a942e8cf9739619b7f408cc7b272b279b56b2c83c6123fcfa5cdff"},
-    {file = "Pillow-10.0.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:d50b6aec14bc737742ca96e85d6d0a5f9bfbded018264b3b70ff9d8c33485551"},
-    {file = "Pillow-10.0.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:00e65f5e822decd501e374b0650146063fbb30a7264b4d2744bdd7b913e0cab5"},
-    {file = "Pillow-10.0.0-cp312-cp312-win_amd64.whl", hash = "sha256:f31f9fdbfecb042d046f9d91270a0ba28368a723302786c0009ee9b9f1f60199"},
-    {file = "Pillow-10.0.0-cp312-cp312-win_arm64.whl", hash = "sha256:1ce91b6ec08d866b14413d3f0bbdea7e24dfdc8e59f562bb77bc3fe60b6144ca"},
-    {file = "Pillow-10.0.0-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:349930d6e9c685c089284b013478d6f76e3a534e36ddfa912cde493f235372f3"},
-    {file = "Pillow-10.0.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:3a684105f7c32488f7153905a4e3015a3b6c7182e106fe3c37fbb5ef3e6994c3"},
-    {file = "Pillow-10.0.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b4f69b3700201b80bb82c3a97d5e9254084f6dd5fb5b16fc1a7b974260f89f43"},
-    {file = "Pillow-10.0.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f07ea8d2f827d7d2a49ecf1639ec02d75ffd1b88dcc5b3a61bbb37a8759ad8d"},
-    {file = "Pillow-10.0.0-cp38-cp38-manylinux_2_28_aarch64.whl", hash = "sha256:040586f7d37b34547153fa383f7f9aed68b738992380ac911447bb78f2abe530"},
-    {file = "Pillow-10.0.0-cp38-cp38-manylinux_2_28_x86_64.whl", hash = "sha256:f88a0b92277de8e3ca715a0d79d68dc82807457dae3ab8699c758f07c20b3c51"},
-    {file = "Pillow-10.0.0-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:c7cf14a27b0d6adfaebb3ae4153f1e516df54e47e42dcc073d7b3d76111a8d86"},
-    {file = "Pillow-10.0.0-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:3400aae60685b06bb96f99a21e1ada7bc7a413d5f49bce739828ecd9391bb8f7"},
-    {file = "Pillow-10.0.0-cp38-cp38-win_amd64.whl", hash = "sha256:dbc02381779d412145331789b40cc7b11fdf449e5d94f6bc0b080db0a56ea3f0"},
-    {file = "Pillow-10.0.0-cp39-cp39-macosx_10_10_x86_64.whl", hash = "sha256:9211e7ad69d7c9401cfc0e23d49b69ca65ddd898976d660a2fa5904e3d7a9baa"},
-    {file = "Pillow-10.0.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:faaf07ea35355b01a35cb442dd950d8f1bb5b040a7787791a535de13db15ed90"},
-    {file = "Pillow-10.0.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c9f72a021fbb792ce98306ffb0c348b3c9cb967dce0f12a49aa4c3d3fdefa967"},
-    {file = "Pillow-10.0.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9f7c16705f44e0504a3a2a14197c1f0b32a95731d251777dcb060aa83022cb2d"},
-    {file = "Pillow-10.0.0-cp39-cp39-manylinux_2_28_aarch64.whl", hash = "sha256:76edb0a1fa2b4745fb0c99fb9fb98f8b180a1bbceb8be49b087e0b21867e77d3"},
-    {file = "Pillow-10.0.0-cp39-cp39-manylinux_2_28_x86_64.whl", hash = "sha256:368ab3dfb5f49e312231b6f27b8820c823652b7cd29cfbd34090565a015e99ba"},
-    {file = "Pillow-10.0.0-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:608bfdee0d57cf297d32bcbb3c728dc1da0907519d1784962c5f0c68bb93e5a3"},
-    {file = "Pillow-10.0.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:5c6e3df6bdd396749bafd45314871b3d0af81ff935b2d188385e970052091017"},
-    {file = "Pillow-10.0.0-cp39-cp39-win_amd64.whl", hash = "sha256:7be600823e4c8631b74e4a0d38384c73f680e6105a7d3c6824fcf226c178c7e6"},
-    {file = "Pillow-10.0.0-pp310-pypy310_pp73-macosx_10_10_x86_64.whl", hash = "sha256:92be919bbc9f7d09f7ae343c38f5bb21c973d2576c1d45600fce4b74bafa7ac0"},
-    {file = "Pillow-10.0.0-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8f8182b523b2289f7c415f589118228d30ac8c355baa2f3194ced084dac2dbba"},
-    {file = "Pillow-10.0.0-pp310-pypy310_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:38250a349b6b390ee6047a62c086d3817ac69022c127f8a5dc058c31ccef17f3"},
-    {file = "Pillow-10.0.0-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:88af2003543cc40c80f6fca01411892ec52b11021b3dc22ec3bc9d5afd1c5334"},
-    {file = "Pillow-10.0.0-pp39-pypy39_pp73-macosx_10_10_x86_64.whl", hash = "sha256:c189af0545965fa8d3b9613cfdb0cd37f9d71349e0f7750e1fd704648d475ed2"},
-    {file = "Pillow-10.0.0-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ce7b031a6fc11365970e6a5686d7ba8c63e4c1cf1ea143811acbb524295eabed"},
-    {file = "Pillow-10.0.0-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:db24668940f82321e746773a4bc617bfac06ec831e5c88b643f91f122a785684"},
-    {file = "Pillow-10.0.0-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:efe8c0681042536e0d06c11f48cebe759707c9e9abf880ee213541c5b46c5bf3"},
-    {file = "Pillow-10.0.0.tar.gz", hash = "sha256:9c82b5b3e043c7af0d95792d0d20ccf68f61a1fec6b3530e718b688422727396"},
+    {file = "Pillow-10.0.1-cp310-cp310-macosx_10_10_x86_64.whl", hash = "sha256:8f06be50669087250f319b706decf69ca71fdecd829091a37cc89398ca4dc17a"},
+    {file = "Pillow-10.0.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:50bd5f1ebafe9362ad622072a1d2f5850ecfa44303531ff14353a4059113b12d"},
+    {file = "Pillow-10.0.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e6a90167bcca1216606223a05e2cf991bb25b14695c518bc65639463d7db722d"},
+    {file = "Pillow-10.0.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f11c9102c56ffb9ca87134bd025a43d2aba3f1155f508eff88f694b33a9c6d19"},
+    {file = "Pillow-10.0.1-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:186f7e04248103482ea6354af6d5bcedb62941ee08f7f788a1c7707bc720c66f"},
+    {file = "Pillow-10.0.1-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:0462b1496505a3462d0f35dc1c4d7b54069747d65d00ef48e736acda2c8cbdff"},
+    {file = "Pillow-10.0.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:d889b53ae2f030f756e61a7bff13684dcd77e9af8b10c6048fb2c559d6ed6eaf"},
+    {file = "Pillow-10.0.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:552912dbca585b74d75279a7570dd29fa43b6d93594abb494ebb31ac19ace6bd"},
+    {file = "Pillow-10.0.1-cp310-cp310-win_amd64.whl", hash = "sha256:787bb0169d2385a798888e1122c980c6eff26bf941a8ea79747d35d8f9210ca0"},
+    {file = "Pillow-10.0.1-cp311-cp311-macosx_10_10_x86_64.whl", hash = "sha256:fd2a5403a75b54661182b75ec6132437a181209b901446ee5724b589af8edef1"},
+    {file = "Pillow-10.0.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:2d7e91b4379f7a76b31c2dda84ab9e20c6220488e50f7822e59dac36b0cd92b1"},
+    {file = "Pillow-10.0.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:19e9adb3f22d4c416e7cd79b01375b17159d6990003633ff1d8377e21b7f1b21"},
+    {file = "Pillow-10.0.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:93139acd8109edcdeffd85e3af8ae7d88b258b3a1e13a038f542b79b6d255c54"},
+    {file = "Pillow-10.0.1-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:92a23b0431941a33242b1f0ce6c88a952e09feeea9af4e8be48236a68ffe2205"},
+    {file = "Pillow-10.0.1-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:cbe68deb8580462ca0d9eb56a81912f59eb4542e1ef8f987405e35a0179f4ea2"},
+    {file = "Pillow-10.0.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:522ff4ac3aaf839242c6f4e5b406634bfea002469656ae8358644fc6c4856a3b"},
+    {file = "Pillow-10.0.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:84efb46e8d881bb06b35d1d541aa87f574b58e87f781cbba8d200daa835b42e1"},
+    {file = "Pillow-10.0.1-cp311-cp311-win_amd64.whl", hash = "sha256:898f1d306298ff40dc1b9ca24824f0488f6f039bc0e25cfb549d3195ffa17088"},
+    {file = "Pillow-10.0.1-cp312-cp312-macosx_10_10_x86_64.whl", hash = "sha256:bcf1207e2f2385a576832af02702de104be71301c2696d0012b1b93fe34aaa5b"},
+    {file = "Pillow-10.0.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:5d6c9049c6274c1bb565021367431ad04481ebb54872edecfcd6088d27edd6ed"},
+    {file = "Pillow-10.0.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:28444cb6ad49726127d6b340217f0627abc8732f1194fd5352dec5e6a0105635"},
+    {file = "Pillow-10.0.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:de596695a75496deb3b499c8c4f8e60376e0516e1a774e7bc046f0f48cd620ad"},
+    {file = "Pillow-10.0.1-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:2872f2d7846cf39b3dbff64bc1104cc48c76145854256451d33c5faa55c04d1a"},
+    {file = "Pillow-10.0.1-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:4ce90f8a24e1c15465048959f1e94309dfef93af272633e8f37361b824532e91"},
+    {file = "Pillow-10.0.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:ee7810cf7c83fa227ba9125de6084e5e8b08c59038a7b2c9045ef4dde61663b4"},
+    {file = "Pillow-10.0.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:b1be1c872b9b5fcc229adeadbeb51422a9633abd847c0ff87dc4ef9bb184ae08"},
+    {file = "Pillow-10.0.1-cp312-cp312-win_amd64.whl", hash = "sha256:98533fd7fa764e5f85eebe56c8e4094db912ccbe6fbf3a58778d543cadd0db08"},
+    {file = "Pillow-10.0.1-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:764d2c0daf9c4d40ad12fbc0abd5da3af7f8aa11daf87e4fa1b834000f4b6b0a"},
+    {file = "Pillow-10.0.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:fcb59711009b0168d6ee0bd8fb5eb259c4ab1717b2f538bbf36bacf207ef7a68"},
+    {file = "Pillow-10.0.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:697a06bdcedd473b35e50a7e7506b1d8ceb832dc238a336bd6f4f5aa91a4b500"},
+    {file = "Pillow-10.0.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9f665d1e6474af9f9da5e86c2a3a2d2d6204e04d5af9c06b9d42afa6ebde3f21"},
+    {file = "Pillow-10.0.1-cp38-cp38-manylinux_2_28_aarch64.whl", hash = "sha256:2fa6dd2661838c66f1a5473f3b49ab610c98a128fc08afbe81b91a1f0bf8c51d"},
+    {file = "Pillow-10.0.1-cp38-cp38-manylinux_2_28_x86_64.whl", hash = "sha256:3a04359f308ebee571a3127fdb1bd01f88ba6f6fb6d087f8dd2e0d9bff43f2a7"},
+    {file = "Pillow-10.0.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:723bd25051454cea9990203405fa6b74e043ea76d4968166dfd2569b0210886a"},
+    {file = "Pillow-10.0.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:71671503e3015da1b50bd18951e2f9daf5b6ffe36d16f1eb2c45711a301521a7"},
+    {file = "Pillow-10.0.1-cp38-cp38-win_amd64.whl", hash = "sha256:44e7e4587392953e5e251190a964675f61e4dae88d1e6edbe9f36d6243547ff3"},
+    {file = "Pillow-10.0.1-cp39-cp39-macosx_10_10_x86_64.whl", hash = "sha256:3855447d98cced8670aaa63683808df905e956f00348732448b5a6df67ee5849"},
+    {file = "Pillow-10.0.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:ed2d9c0704f2dc4fa980b99d565c0c9a543fe5101c25b3d60488b8ba80f0cce1"},
+    {file = "Pillow-10.0.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f5bb289bb835f9fe1a1e9300d011eef4d69661bb9b34d5e196e5e82c4cb09b37"},
+    {file = "Pillow-10.0.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3a0d3e54ab1df9df51b914b2233cf779a5a10dfd1ce339d0421748232cea9876"},
+    {file = "Pillow-10.0.1-cp39-cp39-manylinux_2_28_aarch64.whl", hash = "sha256:2cc6b86ece42a11f16f55fe8903595eff2b25e0358dec635d0a701ac9586588f"},
+    {file = "Pillow-10.0.1-cp39-cp39-manylinux_2_28_x86_64.whl", hash = "sha256:ca26ba5767888c84bf5a0c1a32f069e8204ce8c21d00a49c90dabeba00ce0145"},
+    {file = "Pillow-10.0.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:f0b4b06da13275bc02adfeb82643c4a6385bd08d26f03068c2796f60d125f6f2"},
+    {file = "Pillow-10.0.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:bc2e3069569ea9dbe88d6b8ea38f439a6aad8f6e7a6283a38edf61ddefb3a9bf"},
+    {file = "Pillow-10.0.1-cp39-cp39-win_amd64.whl", hash = "sha256:8b451d6ead6e3500b6ce5c7916a43d8d8d25ad74b9102a629baccc0808c54971"},
+    {file = "Pillow-10.0.1-pp310-pypy310_pp73-macosx_10_10_x86_64.whl", hash = "sha256:32bec7423cdf25c9038fef614a853c9d25c07590e1a870ed471f47fb80b244db"},
+    {file = "Pillow-10.0.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b7cf63d2c6928b51d35dfdbda6f2c1fddbe51a6bc4a9d4ee6ea0e11670dd981e"},
+    {file = "Pillow-10.0.1-pp310-pypy310_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:f6d3d4c905e26354e8f9d82548475c46d8e0889538cb0657aa9c6f0872a37aa4"},
+    {file = "Pillow-10.0.1-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:847e8d1017c741c735d3cd1883fa7b03ded4f825a6e5fcb9378fd813edee995f"},
+    {file = "Pillow-10.0.1-pp39-pypy39_pp73-macosx_10_10_x86_64.whl", hash = "sha256:7f771e7219ff04b79e231d099c0a28ed83aa82af91fd5fa9fdb28f5b8d5addaf"},
+    {file = "Pillow-10.0.1-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:459307cacdd4138edee3875bbe22a2492519e060660eaf378ba3b405d1c66317"},
+    {file = "Pillow-10.0.1-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:b059ac2c4c7a97daafa7dc850b43b2d3667def858a4f112d1aa082e5c3d6cf7d"},
+    {file = "Pillow-10.0.1-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:d6caf3cd38449ec3cd8a68b375e0c6fe4b6fd04edb6c9766b55ef84a6e8ddf2d"},
+    {file = "Pillow-10.0.1.tar.gz", hash = "sha256:d72967b06be9300fed5cfbc8b5bafceec48bf7cdc7dab66b1d2549035287191d"},
 ]
 
 [package.extras]
@@ -770,13 +619,13 @@ plugins = ["importlib-metadata"]
 
 [[package]]
 name = "pymdown-extensions"
-version = "10.2"
+version = "10.3"
 description = "Extension pack for Python Markdown."
 optional = false
-python-versions = ">=3.7"
+python-versions = ">=3.8"
 files = [
-    {file = "pymdown_extensions-10.2-py3-none-any.whl", hash = "sha256:fbb86243db9a681602e3b869deef000211c55d0261015a5cc41d6f34d2afc57f"},
-    {file = "pymdown_extensions-10.2.tar.gz", hash = "sha256:06042274876eb4267f12a389daf505eabaebc38bdca26725560c9afda5867549"},
+    {file = "pymdown_extensions-10.3-py3-none-any.whl", hash = "sha256:77a82c621c58a83efc49a389159181d570e370fff9f810d3a4766a75fc678b66"},
+    {file = "pymdown_extensions-10.3.tar.gz", hash = "sha256:94a0d8a03246712b64698af223848fd80aaf1ae4c4be29c8c61939b0467b5722"},
 ]
 
 [package.dependencies]
@@ -786,24 +635,6 @@ pyyaml = "*"
 [package.extras]
 extra = ["pygments (>=2.12)"]
 
-[[package]]
-name = "pyquery"
-version = "2.0.0"
-description = "A jquery-like library for python"
-optional = false
-python-versions = "*"
-files = [
-    {file = "pyquery-2.0.0-py3-none-any.whl", hash = "sha256:8dfc9b4b7c5f877d619bbae74b1898d5743f6ca248cfd5d72b504dd614da312f"},
-    {file = "pyquery-2.0.0.tar.gz", hash = "sha256:963e8d4e90262ff6d8dec072ea97285dc374a2f69cad7776f4082abcf6a1d8ae"},
-]
-
-[package.dependencies]
-cssselect = ">=1.2.0"
-lxml = ">=2.1"
-
-[package.extras]
-test = ["pytest", "pytest-cov", "requests", "webob", "webtest"]
-
 [[package]]
 name = "python-dateutil"
 version = "2.8.2"
@@ -891,21 +722,6 @@ files = [
 [package.dependencies]
 pyyaml = "*"
 
-[[package]]
-name = "readtime"
-version = "3.0.0"
-description = "Calculates the time some text takes the average human to read, based on Medium's read time forumula"
-optional = false
-python-versions = "*"
-files = [
-    {file = "readtime-3.0.0.tar.gz", hash = "sha256:76c5a0d773ad49858c53b42ba3a942f62fbe20cc8c6f07875797ac7dc30963a9"},
-]
-
-[package.dependencies]
-beautifulsoup4 = ">=4.0.1"
-markdown2 = ">=2.4.3"
-pyquery = ">=1.2"
-
 [[package]]
 name = "regex"
 version = "2023.8.8"
@@ -1035,17 +851,6 @@ files = [
     {file = "six-1.16.0.tar.gz", hash = "sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926"},
 ]
 
-[[package]]
-name = "soupsieve"
-version = "2.4.1"
-description = "A modern CSS selector implementation for Beautiful Soup."
-optional = false
-python-versions = ">=3.7"
-files = [
-    {file = "soupsieve-2.4.1-py3-none-any.whl", hash = "sha256:1c1bfee6819544a3447586c889157365a27e10d88cde3ad3da0cf0ddf646feb8"},
-    {file = "soupsieve-2.4.1.tar.gz", hash = "sha256:89d12b2d5dfcd2c9e8c22326da9d9aa9cb3dfab0a83a024f05704076ee8d35ea"},
-]
-
 [[package]]
 name = "tinycss2"
 version = "1.2.1"
@@ -1066,13 +871,13 @@ test = ["flake8", "isort", "pytest"]
 
 [[package]]
 name = "urllib3"
-version = "2.0.4"
+version = "2.0.5"
 description = "HTTP library with thread-safe connection pooling, file post, and more."
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "urllib3-2.0.4-py3-none-any.whl", hash = "sha256:de7df1803967d2c2a98e4b11bb7d6bd9210474c46e8a0401514e3a42a75ebde4"},
-    {file = "urllib3-2.0.4.tar.gz", hash = "sha256:8d22f86aae8ef5e410d4f539fde9ce6b2113a001bb4d189e0aed70642d602b11"},
+    {file = "urllib3-2.0.5-py3-none-any.whl", hash = "sha256:ef16afa8ba34a1f989db38e1dbbe0c302e4289a47856990d0682e374563ce35e"},
+    {file = "urllib3-2.0.5.tar.gz", hash = "sha256:13abf37382ea2ce6fb744d4dad67838eec857c9f4f57009891805e0b5e123594"},
 ]
 
 [package.extras]
@@ -1134,4 +939,4 @@ files = [
 [metadata]
 lock-version = "2.0"
 python-versions = "^3.10"
-content-hash = "3c899a52668a042ce61da070b89557f2b288d1437b1180400dd996faa23ad383"
+content-hash = "b1a796541661c502a83bdff1d32338a15deedd516419a3f18c69a188c03a3b45"
diff --git a/pyproject.toml b/pyproject.toml
index 0d361a9..172ba67 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -8,7 +8,7 @@ license = "MIT"
 [tool.poetry.dependencies]
 python = "^3.10"
 mkdocs = "^1.4.3"
-mkdocs-material = "^9.1.16"
+mkdocs-material = "^9.4.0"
 pillow = "^10.0.0"
 cairosvg = "^2.7.0"
 

From 8e96eec2c54ae4437f4cda7e0648cf74a759493c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 4 Oct 2023 16:27:58 +0200
Subject: [PATCH 27/39] Poetry(deps): Bump urllib3 from 2.0.5 to 2.0.6 (#34)

Bumps [urllib3](https://github.com/urllib3/urllib3) from 2.0.5 to 2.0.6.
- [Release notes](https://github.com/urllib3/urllib3/releases)
- [Changelog](https://github.com/urllib3/urllib3/blob/main/CHANGES.rst)
- [Commits](https://github.com/urllib3/urllib3/compare/v2.0.5...2.0.6)

---
updated-dependencies:
- dependency-name: urllib3
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 poetry.lock | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 038c9ab..fd94a15 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -365,6 +365,16 @@ files = [
     {file = "MarkupSafe-2.1.3-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:5bbe06f8eeafd38e5d0a4894ffec89378b6c6a625ff57e3028921f8ff59318ac"},
     {file = "MarkupSafe-2.1.3-cp311-cp311-win32.whl", hash = "sha256:dd15ff04ffd7e05ffcb7fe79f1b98041b8ea30ae9234aed2a9168b5797c3effb"},
     {file = "MarkupSafe-2.1.3-cp311-cp311-win_amd64.whl", hash = "sha256:134da1eca9ec0ae528110ccc9e48041e0828d79f24121a1a146161103c76e686"},
+    {file = "MarkupSafe-2.1.3-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:f698de3fd0c4e6972b92290a45bd9b1536bffe8c6759c62471efaa8acb4c37bc"},
+    {file = "MarkupSafe-2.1.3-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:aa57bd9cf8ae831a362185ee444e15a93ecb2e344c8e52e4d721ea3ab6ef1823"},
+    {file = "MarkupSafe-2.1.3-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ffcc3f7c66b5f5b7931a5aa68fc9cecc51e685ef90282f4a82f0f5e9b704ad11"},
+    {file = "MarkupSafe-2.1.3-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47d4f1c5f80fc62fdd7777d0d40a2e9dda0a05883ab11374334f6c4de38adffd"},
+    {file = "MarkupSafe-2.1.3-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1f67c7038d560d92149c060157d623c542173016c4babc0c1913cca0564b9939"},
+    {file = "MarkupSafe-2.1.3-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:9aad3c1755095ce347e26488214ef77e0485a3c34a50c5a5e2471dff60b9dd9c"},
+    {file = "MarkupSafe-2.1.3-cp312-cp312-musllinux_1_1_i686.whl", hash = "sha256:14ff806850827afd6b07a5f32bd917fb7f45b046ba40c57abdb636674a8b559c"},
+    {file = "MarkupSafe-2.1.3-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:8f9293864fe09b8149f0cc42ce56e3f0e54de883a9de90cd427f191c346eb2e1"},
+    {file = "MarkupSafe-2.1.3-cp312-cp312-win32.whl", hash = "sha256:715d3562f79d540f251b99ebd6d8baa547118974341db04f5ad06d5ea3eb8007"},
+    {file = "MarkupSafe-2.1.3-cp312-cp312-win_amd64.whl", hash = "sha256:1b8dd8c3fd14349433c79fa8abeb573a55fc0fdd769133baac1f5e07abf54aeb"},
     {file = "MarkupSafe-2.1.3-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:8e254ae696c88d98da6555f5ace2279cf7cd5b3f52be2b5cf97feafe883b58d2"},
     {file = "MarkupSafe-2.1.3-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cb0932dc158471523c9637e807d9bfb93e06a95cbf010f1a38b98623b929ef2b"},
     {file = "MarkupSafe-2.1.3-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9402b03f1a1b4dc4c19845e5c749e3ab82d5078d16a2a4c2cd2df62d57bb0707"},
@@ -871,13 +881,13 @@ test = ["flake8", "isort", "pytest"]
 
 [[package]]
 name = "urllib3"
-version = "2.0.5"
+version = "2.0.6"
 description = "HTTP library with thread-safe connection pooling, file post, and more."
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "urllib3-2.0.5-py3-none-any.whl", hash = "sha256:ef16afa8ba34a1f989db38e1dbbe0c302e4289a47856990d0682e374563ce35e"},
-    {file = "urllib3-2.0.5.tar.gz", hash = "sha256:13abf37382ea2ce6fb744d4dad67838eec857c9f4f57009891805e0b5e123594"},
+    {file = "urllib3-2.0.6-py3-none-any.whl", hash = "sha256:7a7c7003b000adf9e7ca2a377c9688bbc54ed41b985789ed576570342a375cd2"},
+    {file = "urllib3-2.0.6.tar.gz", hash = "sha256:b19e1a85d206b56d7df1d5e683df4a7725252a964e3993648dd0fb5a1c157564"},
 ]
 
 [package.extras]

From a0ac51e859597946e296bd85a4d12f4d1ddcd06d Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Fri, 6 Oct 2023 14:26:54 +0200
Subject: [PATCH 28/39] add git clean notes

Signed-off-by: Marcello Lamonaca <marcello@lamonaca.eu>
---
 docs/misc/git.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/docs/misc/git.md b/docs/misc/git.md
index c751fb2..1e4abf5 100644
--- a/docs/misc/git.md
+++ b/docs/misc/git.md
@@ -94,8 +94,7 @@ def load_reference(name_or_id):
 ### Config
 
 `git config --global user.name "<name>"`: set name attached to commits  
-`git config --global user.email "<email address>"`: set email attached to commits    
-`git config --global color.ui auto`: enable colorization of command line output  
+`git config --global user.email "<email address>"`: set email attached to commits
 
 ### Making Changes
 
@@ -177,7 +176,6 @@ When either `<rev1>` or `<rev2>` is omitted, it defaults to HEAD.
 `git log <rev1>...<rev2>`: Include commits that are reachable from either `<rev1>` or `<rev2>` but exclude those that are reachable from both. When either `<rev1>` or `<rev2>` is omitted, it defaults to HEAD.  
 `git log <rev>^@`: Include anything reachable from `<rev>` parents but not the commit itself
 
-
 `git shortlog`: list commits by author  
 `git reflog`: show record of when the tips of branches and other references were updated in the local repository  
 
@@ -211,7 +209,7 @@ It's generally recommended creating annotated tags so it's possible to have all
 
 ### Branching And Merging
 
-![branch](img/git_branches.png "how branches work")
+![branch](../img/git_branches.png "how branches work")
 
 `git branch`: shows branches  
 `git branch -vv`: show branch + last commit + remote status  
@@ -245,6 +243,10 @@ It's generally recommended creating annotated tags so it's possible to have all
 `git reset --soft <commit>`: revert to specific commit but keep changes and staged files  
 `git reset --hard <commit>`: discard all history and changes back to specified commit  
 
+`git clean`: remove untracked files form the working tree  
+`git clean -d`: recurse into untracked directories while cleaning  
+`git clean --interactive`: clean files interactively
+
 `git checkout <file>`: discard changes  
 `git checkout -- <file>`: discard changes, no output to screen  
 `git restore .`: discard uncommitted changes  

From 65740da93796904ab4d86ef41679ec0ec1d1e717 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Fri, 6 Oct 2023 14:30:11 +0200
Subject: [PATCH 29/39] add git commit signoff notes

---
 docs/misc/git.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/misc/git.md b/docs/misc/git.md
index 1e4abf5..ccf27b2 100644
--- a/docs/misc/git.md
+++ b/docs/misc/git.md
@@ -111,6 +111,7 @@ def load_reference(name_or_id):
 `git commit --amend`: modify latest commit with the new changes  
 `git commit --no-verify`: commit without executing hooks  
 `git commit --fixup <commit>`: mark commit as correction to another  
+`git commit --signoff`: Add a `Signed-off-by` trailer by the committer at the end of the commit log message  
 
 `git diff <filename>`: show difference since the last commit  
 `git diff <commit> <filename>`: show differences in a file since a particular snapshot  
@@ -171,8 +172,7 @@ def load_reference(name_or_id):
 `git log  --oneline`: compact log  
 `git log <rev>`: Include commits that are reachable from `<rev>`  
 `git log ^<rev>`: Exclude commits that are reachable from `<rev>`  
-`git log <rev1>..<rev2>`: Include commits that are reachable from `<rev2>` but exclude those that are reachable from `<rev1>`. 
-When either `<rev1>` or `<rev2>` is omitted, it defaults to HEAD.  
+`git log <rev1>..<rev2>`: Include commits that are reachable from `<rev2>` but exclude those that are reachable from `<rev1>`. When either `<rev1>` or `<rev2>` is omitted, it defaults to HEAD.  
 `git log <rev1>...<rev2>`: Include commits that are reachable from either `<rev1>` or `<rev2>` but exclude those that are reachable from both. When either `<rev1>` or `<rev2>` is omitted, it defaults to HEAD.  
 `git log <rev>^@`: Include anything reachable from `<rev>` parents but not the commit itself
 
@@ -245,7 +245,7 @@ It's generally recommended creating annotated tags so it's possible to have all
 
 `git clean`: remove untracked files form the working tree  
 `git clean -d`: recurse into untracked directories while cleaning  
-`git clean --interactive`: clean files interactively
+`git clean --interactive`: clean files interactively  
 
 `git checkout <file>`: discard changes  
 `git checkout -- <file>`: discard changes, no output to screen  

From e47a9c5522b05b0cee16a75b9281ae1bdcd1566f Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Fri, 6 Oct 2023 14:44:26 +0200
Subject: [PATCH 30/39] add gir commands long options

---
 docs/misc/git.md | 46 ++++++++++++++++++++++------------------------
 1 file changed, 22 insertions(+), 24 deletions(-)

diff --git a/docs/misc/git.md b/docs/misc/git.md
index ccf27b2..669c0ba 100644
--- a/docs/misc/git.md
+++ b/docs/misc/git.md
@@ -81,8 +81,7 @@ def load_reference(name_or_id):
 
 ## Commands
 
-`git <command> -h`: get help for a git command  
-`git <command> --help`: get man page for a git command  
+`git <command> -h|--help`: get help for a git command  
 `git -C <path> <command>`: execute a git commend in the specified path  
 `git <command> <commit>^`: operate on commit *before* the provided commit hash  
 
@@ -100,31 +99,31 @@ def load_reference(name_or_id):
 
 `git status`: shows the status of changes as untracked, modified, or staged  
 `git add <filename1 filename2 ...>`: add files to the staging area  
-`git add -p <files>`: interactively stage chunks of a file  
+`git add -p|--patch <files>`: interactively stage chunks of a file  
 
 `git blame <file>`: show who last edited which line  
 
 `git commit`: save the snapshot to the project history  
-`git commit -m "message"`: commit and provide a message  
-`git commit -a`: automatically notice any modified (but not new) files and commit  
+`git commit -m|--message "message"`: commit and provide a message  
+`git commit -a|--all`: automatically notice any modified (but not new) files and commit  
 `git commit -v|--verbose`: show unified diff between the HEAD commit and what would be committed  
 `git commit --amend`: modify latest commit with the new changes  
 `git commit --no-verify`: commit without executing hooks  
 `git commit --fixup <commit>`: mark commit as correction to another  
-`git commit --signoff`: Add a `Signed-off-by` trailer by the committer at the end of the commit log message  
+`git commit -s|--signoff`: Add a `Signed-off-by` trailer by the committer at the end of the commit log message  
 
 `git diff <filename>`: show difference since the last commit  
 `git diff <commit> <filename>`: show differences in a file since a particular snapshot  
 `git diff <reference_1> <reference_2> <filename>`: show differences in a file between two snapshots  
 `git diff  --cached`: show what is about to be committed  
 `git diff <first-branch>...<second-branch>`: show content diff between two branches  
-`git diff -w`: show diff ignoring whitespace differences  
+`git diff -w|--ignore-all-space`: show diff ignoring whitespace differences  
 
 `git bisect`: binary search history (e.g. for regressions)  
 
 ### Stashes
 
-`git stash [push -m|--message]`: add all changes to the stash (and provide message)  
+`git stash [push] [-m|--message]`: add all changes to the stash (and provide message)  
 `git stash list` list all stashes  
 `git stash show [<stash>]`: show changes in the stash  
 `git stash pop`: restore last stash  
@@ -134,19 +133,19 @@ def load_reference(name_or_id):
 ### Remotes
 
 `git remote`: list remotes  
-`git remote -v`: list remotes names and URLs  
+`git remote -v|--verbose`: list remotes names and URLs  
 `git remote show <remote>`: inspect the remote  
 
 `git remote add <remote> <url | path>`: add a remote  
 `git remote remove <remote>`: remove the specified remote  
 `git remote rename <old_name> <new_name>`: rename a remote  
-`git branch --set-upstream-to=<remote>/<remote branch>`: set up correspondence between local and remote branch  
+`git branch -u|--set-upstream-to=<remote>/<remote branch>`: set up correspondence between local and remote branch  
 
 `git push`: send objects to default remote on current branch  
 `git push <remote> <branch>`: send objects to remote  
 `git push <remote> <local branch>:<remote branch>`: send objects to remote, and update remote reference  
 
-`git push --force`: overwrite remote with local version  
+`git push -f|--force`: overwrite remote with local version  
 `git push --force-with-lease`: overwrite remote with local version if remote has not been modified  
 `git push --force-with-lease --force-if--includes`: will verify if updates from the remote that may have been implicitly updated in the background are integrated locally before allowing a forced update  
 
@@ -154,8 +153,8 @@ def load_reference(name_or_id):
 `git pull`: update the local branch with updates from its remote counterpart, same as `git fetch; git merge`  
 `git pull --ff`: when possible resolve the merge as a fast-forward (only update branch pointer, don't create merge commit). Otherwise create a merge commit.  
 
-`git fetch|pull --prune`: remove any remote-tracking references that no longer exist on the remote  
-`git fetch|pull --tags`: fetch all tags from the remote
+`git fetch|pull -p|--prune`: remove any remote-tracking references that no longer exist on the remote  
+`git fetch|pull -t|--tags`: fetch all tags from the remote
 
 `git clone <url> [<folder_name>]`: download repository and repo history from remote  
 `git clone --shallow`: clone only repo files, not history of commits  
@@ -165,7 +164,7 @@ def load_reference(name_or_id):
 ### Viewing Project History
 
 `git log`: show history of changes  
-`git log -p`: show history of changes and complete differences  
+`git log -p|--patch`: show history of changes and complete differences  
 `git log --stat --summary`: show overview of the change  
 `git log --follow <file>`: list version history fo file, including renames  
 `git log --all --graph --decorate`: visualizes history as a DAG  
@@ -196,12 +195,12 @@ It's generally recommended creating annotated tags so it's possible to have all
 `git tag -l|--list <pattern>`: list existing tags matching a wildcard or pattern  
 
 `git tag <tag> [<commit_hash>]`: create a *lightweight* tag on the commit  
-`git tag -a <tag> [<commit_hash> -m <message>]`: create am *annotated* tag on the commit  
+`git tag -a|--annotate <tag> [<commit_hash> -m <message>]`: create am *annotated* tag on the commit  
 
 `git push <remote> <tagname>`: push a tag to the remote  
 `git push <remote> --tags`: push commits and their tags (both types) to the remote  
 
-`git tag -d <tagname>`: delete a tag  
+`git tag -d|--delete <tagname>`: delete a tag  
 `git push <remote> :refs/tags<tagname>:`: remove a tag from the remote  
 `git push <remote> --delete <tagname>`: remove a tag from the remote  
 
@@ -214,13 +213,12 @@ It's generally recommended creating annotated tags so it's possible to have all
 `git branch`: shows branches  
 `git branch -vv`: show branch + last commit + remote status  
 `git branch --merged [--remote]`: show branches (remote) that have been merged into current one (needs same history, merge squash/rebase break history)
-
-`git branch <branch-name>`: create new branch  
-`git checkout -b <branch-name>`: create a branch and switches to it, same as `git branch <name>; git checkout <name>`  
 `git branch`: show list of all existing branches  (* indicates current)  
+`git branch <branch-name>`: create new branch  
+`git branch -d|--delete <branch-name>`: delete specified branch  
+`git branch -m|--move <old_name> <new_name>`: rename a branch without affecting the branch's history  
+`git checkout -b <branch-name>`: create a branch and switches to it, same as `git branch <name>; git checkout <name>`  
 `git checkout <branch-name>`: change current branch (update HEAD) and update working directory  
-`git branch -d <branch-name>`: delete specified branch  
-`git branch -m <old_name> <new_name>`: rename a branch without affecting the branch's history  
 
 `git merge <branch-name>`: merges into current branch  
 `git merge --continue`: continue previous merge after solving a merge conflict  
@@ -254,9 +252,9 @@ It's generally recommended creating annotated tags so it's possible to have all
 `git restore --source <commit> <file>`: revert file to commit version  
 `git restore <deleted-file>`: recover deleted file if previously committed  
 
-`git rebase -i`: modify (reword, edit, drop, squash, merge, ...) current branch commits  
-`git rebase -i HEAD~<n>`: modify (reword, edit, drop, squash, merge, ...) *n* commits  
-`git rebase -i <commit>`: modify (reword, edit, drop, squash, merge, ...) *from* commit to latest  
+`git rebase -i|--interactive`: modify (reword, edit, drop, squash, merge, ...) current branch commits  
+`git rebase -i|--interactive HEAD~<n>`: modify (reword, edit, drop, squash, merge, ...) *n* commits  
+`git rebase -i|--interactive <commit>`: modify (reword, edit, drop, squash, merge, ...) *from* commit to latest  
 `git rebase --autostash`: automatically create a temporary stash entry before rebasing  
 `git rebase --autosquash`: automatically apply "squash!" or "fixup!" or "amend!" commits  
 

From 890cccae02ec1d6e225481305d110711ed4ef97e Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Sun, 15 Oct 2023 22:17:56 +0200
Subject: [PATCH 31/39] add assembly notes

---
 docs/languages/assembly/assembly.md | 146 ++++++++++++++++++++++++++++
 mkdocs.yml                          |   1 +
 2 files changed, 147 insertions(+)
 create mode 100644 docs/languages/assembly/assembly.md

diff --git a/docs/languages/assembly/assembly.md b/docs/languages/assembly/assembly.md
new file mode 100644
index 0000000..ff3e24d
--- /dev/null
+++ b/docs/languages/assembly/assembly.md
@@ -0,0 +1,146 @@
+# Assembly (Inter - x86_64)
+
+> **WARN**: Since assembly is _not_ portable all instructions will only work under a 64bit Linux system.
+
+## Compiling & Linking
+
+```sh
+# compiling
+nasm -g -f elf64 src.asm  # -g adds debug info, -f specifies the 64bit ELF format
+
+# linking
+ld -o src src.o  # -o specifies the output name
+```
+
+## Basics
+
+### Exports & Sections
+
+Symbols can be exported to be linked against with the linker
+
+Every program in ELF has several sections:
+
+- `data`: global variables
+- `rodata`: global constants (read-only data)
+- `bss`: space reserved at program startup
+- `text`: CPU instructions
+
+```asm
+; export the '_start' symbol for linking
+global _start
+
+; specify a section
+section .data
+section .text
+```
+
+### Labels & Declarations
+
+Anything that's on the beginning of a line and is followed by a colon (`:`) is a label. Labels generally store addresses.
+
+Declaration instructions:
+
+- `db`: declare bytes
+- `dw`: declare word (2 bytes)
+- `dd`: declare double word (4 bytes)
+- `dq`: declare quad word (8 bytes)
+- `equ`: set a name to the value of an expression
+
+> **Note**: See the NASM manual, section 3.2.1 for the full list.
+> **Note**: all byte declaarations are [Little Endian](https://en.wikipedia.org/wiki/Endianness "Endiannes")
+
+```asm
+arr: db 0x12,0x34,0x56,0x78,0x90
+```
+
+### Registers
+
+There are several registers available on x86_64.  
+Some serve a specific purposes (e.g. registers for storing floating point ; numbers), while others are called "general purpose" registers.
+
+There are 16 of them:
+
+- `rax`: accumulator
+- `rbx`: base
+- `rcx`: counter
+- `rdx`: destination
+- `rsp` and `rbp`: stack pointer and base pointer
+- `rsi` and `rdi`: source and destination index
+- `r8` through `r15`: lack of creativity
+
+The prefix `r` means that instructions will use **all 64 bits** in the registers.  
+
+For all those registers, except `r8` through `r15`, it's possible to access:
+
+- the **lowest 32 bits** with `e` _prefix_ (e.g. `eax`, `ebp`)
+- the **lowest 16 bits** _without_ any _prefix_ (e.g. `ax`, `si`)
+
+For registers `rax` through `rdx`, it's possible to access:
+
+- the **lowest byte** with the `l` _suffix_, replacing the trailing `x` (e.g. `al`)
+- the **highest byt** in the 16 bits with the `h` _suffix_, in the same way (e.g. `ah`)
+
+## Instructions
+
+Instructions are operations that the CPU knowns how to execute directly.  
+They are separated from their operands by whitespace, and the operands are separated from other with commas.
+
+```asm
+<instr> <operand1>, <operand2>, ..., <operand_n>
+
+; Intel syntax dictates the first operand is the destination, and the second is the source
+<instr> DEST, SOURCE
+```
+
+```asm
+mov eax, 0x12345678  ; copies 4 bytes to eax
+inc rdi  ; INC: increment
+dec rsi  ; DEC: decrement
+```
+
+### `add`
+
+Adds the two operands and stores the result in the _destination_.
+
+```asm
+add rdi, rbx  ; Equivalent to rdi += rbx
+```
+
+### `sub`
+
+Subtract the two operands and stores the result in the _destination_.
+
+```asm
+sub rsi, rbx  ; Equivalent to rsi -= rbx
+```
+
+### `mul`, `div`, `imul`, `idiv`
+
+`mul` and `div` interpret their  operands as unsigned integers.  
+`imul` and `idiv` interpret their operands as signed integers in two's complement.
+
+`mul` and `div` instructions take a single operand because they use fixed registers for the other number.
+
+For `mul`, the result is `rax` * `<operand>`, and it's a _128-bit_ value stored in `rdx:rax`,
+meaning the _64 lower bits_ are stored in `rdx`, while the _64 upper bits_ are stored in `rax`.
+
+For `div`, the operand is the **divisor** and the **dividend** is `rdx:rax`,
+meaning it's a _128-bit_ value whose _64 upper bits_ are in `rdx` and whose _64 lower bits_ are in `rax`.  
+The **quotient** is a _64-bit_ value stored in `rax`, and the **remainder** is also a _64-bit_ value, stored in `rdx`.
+
+### `and`, `or`, `xor`
+
+```asm
+and rdi, rsi  ; bitwise AND
+or rdi, rsi  ; bitwise OR
+xor rdi, rsi  ; bitwise XOR
+```
+
+### `shr`, `shl`
+
+```asm
+shr rsi, 2  ; right (logical) bitshift: equivalent to rsi >> 2
+shl rsi, 3  ; left (logical) bitshift: equivalent to rsi << 3
+```
+
+**Note**: there's `sar` for arithmetic right shift and `sal` for arithmetic shift left.
diff --git a/mkdocs.yml b/mkdocs.yml
index 0052ad5..8635c98 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -84,6 +84,7 @@ nav:
     - SQL: databases/sql.md
     - MongoDB: databases/mongo-db.md
   - Languages:
+    - Assembly: languages/assembly/assembly.md
     - HTML: languages/html/html.md
     - Markdown: languages/markdown.md
     - CSS: languages/css/css.md

From 1ccb16f652594f02120c57dca2e242ed9e0cdbe7 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Wed, 18 Oct 2023 12:10:59 +0200
Subject: [PATCH 32/39] make dependabot update github-actions

---
 .github/dependabot.yml | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index 9ccfa63..b90dd75 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -1,13 +1,22 @@
 version: 2
 updates:
-  - package-ecosystem: "pip" # See documentation for possible values
-    directory: "/" # Location of package manifests
+  - package-ecosystem: "pip"
+    directory: "/"
     schedule:
       interval: "weekly"
     commit-message:
       prefix: "Poetry"
       include: "scope"
     ignore:
-      # ignore patch updates
       - dependency-name: "*"
         update-types: ["version-update:semver-patch"]
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule: 
+      interval: "weekly"
+    commit-message:
+      prefix: "Github Actions"
+      include: "scope"
+    ignore:
+      - dependency-name: "*"
+        update-types: ["version-update:semver-minor"]

From f25179843483f6152a570e8c109b0ba59be6c1cc Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Fri, 20 Oct 2023 17:51:58 +0200
Subject: [PATCH 33/39] show copy button in code snippets

---
 mkdocs.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/mkdocs.yml b/mkdocs.yml
index 8635c98..62eefa4 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -59,6 +59,7 @@ theme:
     - navigation.tabs.sticky
     - navigation.footer
     - toc.follow
+    - content.code.copy
 
 
 markdown_extensions:

From 09b46d5c571aea87674c3c2ab1c11a824ec48276 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Fri, 20 Oct 2023 18:16:19 +0200
Subject: [PATCH 34/39] improve regex notes

---
 docs/misc/regular-expressions.md | 256 +++++++++++++++++++++++++------
 1 file changed, 209 insertions(+), 47 deletions(-)

diff --git a/docs/misc/regular-expressions.md b/docs/misc/regular-expressions.md
index 0409c89..09c4252 100644
--- a/docs/misc/regular-expressions.md
+++ b/docs/misc/regular-expressions.md
@@ -1,66 +1,228 @@
 # Common Regex Syntax
 
-## Character Types
+A **regular expression** is a *pattern* that the regular expression engine attempts to match in input text. A pattern consists of one or more character literals, operators, or constructs.
 
-`\d` any digit (0-9)  
-`\D` any non digit character  
-`\s` whitespace (space, tab, new line)  
-`\S` any non whitespace characters  
-`\w` any alphanumeric character (a-z, A-Z)  
-`\W` any non alphanumeric character  
-`\b` whitespace surrounding words (only at row start or end)  
-`\B` whitespace surrounding words (not at row start or end)  
-`\A` search only at string start  
-`\Z` search only at string end  
-`.` any characters but newline (CRLF, CR, LF)  
+## Character Classes
+
+A **character class** matches any one of a set of characters.
+
+- `[character_group]`:: matches any single character in *character_group*.
+- `[^character_group]`: matches any single character **not** in *character_group*.
+- `[first-last]`: matches any single character in range from *first* to *last*.
+- `.`: matches any single character except `\n`.
+- `\p{name}`: matches any single character in the Unicode general category or named block specified by *name*.
+- `\P{name}`: matches any single character **not** in the Unicode general category or named block specified by *name*.
+- `\w`: matches any word character.
+- `\W`: matches any **non** word character.
+- `\s`: matches any whitespace character.
+- `\S`: matches any **non** whitespace character.
+- `\d`: matches any decimal digit.
+- `\D`: matches any character other than a decimal digit.
+
+> **Note**: `^`, `\`, `-` and `]` must be escaped to be used in ranges. (`[ \] \[ \^ \- ]`)
+
+## Anchors
+
+**Anchors**, or atomic zero-width assertions, cause a match to succeed or fail depending on the current position in the string, but they do not cause the engine to advance through the string or consume characters.
+
+- `^`: The match must be at the *start* of a string/line.
+- `$`: The match must be at the *end* of a string/line.
+- `\A`: The match must occur at the start of the string.
+- `\Z`: The match must occur at the end of the string or before `\n` at the end of the string.
+- `\z`: The match must occur at the end of the string.
+- `\G`: The match must occur at the point where the previous match ended, or if there was no previous match, at the position in the string where matching started.
+- `\b`: The match must occur on a boundary between a `\w` (alphanumeric) and a `\W` (non-alphanumeric) character.
+- `\B`: The match must not occur on a `\b` boundary.
+
+## Grouping Constructs
+
+**Grouping constructs** delineate subexpressions of a regular expression and typically capture substrings of an input string.
+
+### Subexpressions
+
+```regex title="Regex Syntax" linenums="1"
+(subexpression)
+```
+
+The *subexpression* is any valid regular expression pattern.
+
+Captures that use parentheses are numbered automatically from left to right based on the order of the opening parentheses in the regular expression, starting from `1`. The capture that's numbered `0` is the text matched by the entire regular expression pattern.
+
+> **Note**: named capture groups are always ordered last, after non-named capture groups.
+
+It's possible to access the captured group in the following ways:
+
+- By using the *backreference construct* within the regular expression.
+
+    The matched subexpression is referenced in the same regular expression by using the syntax `\number`, where number is the ordinal number of the captured subexpression.
+
+- By using the *named backreference construct* within the regular expression.
+
+    The matched subexpression is referenced in the same regular expression by using the syntax `\k<name>`, where name is the name of a capturing group, or `\k<number>`, where number is the ordinal number of a capturing group.
+
+    A capturing group has a default name that is identical to its ordinal number. For more information, see Named matched subexpressions later in this topic.
+
+- By using the `$number` *replacement sequence* where number is the ordinal number of the captured subexpression.
+
+### Named Subexpressions
+
+```regex title="Regex Syntax" linenums="1"
+(?<name> subexpression)
+(?'name' subexpression)
+```
+
+THe *name* is a valid group name, and *subexpression* is any valid regular expression pattern. *name* must not contain any punctuation characters and cannot begin with a number.
+
+It's possible to access the named captured group in the following ways:
+
+- By using the named *backreference construct* within the regular expression.
+
+    The matched subexpression is referenced in the same regular expression by using the syntax `\k<name>`, where name is the name of the captured subexpression.
+
+- By using the *backreference construct* within the regular expression.
+
+    The matched subexpression is referenced in the same regular expression by using the syntax `\number`, where number is the ordinal number of the captured subexpression.
+
+    Named matched subexpressions are numbered consecutively from left to right after matched subexpressions.
+
+- By using the `${name}` *replacement sequence* where name is the name of the captured subexpression.
+- By using the `$number` *replacement sequence* where number is the ordinal number of the captured subexpression.
+
+### Noncapturing groups
+
+```regex title="Regex Syntax" linenums="1"
+(?:subexpression)
+```
+
+The *subexpression* is any valid regular expression pattern. The noncapturing group construct is typically used when a quantifier is applied to a group, but the substrings captured by the group are of no interest.
+
+### Zero-width positive lookahead assertions
+
+```regex title="Regex Syntax" linenums="1"
+(?= subexpression)
+```
+
+The *subexpression* is any regular expression pattern. For a match to be successful, the input string must match the regular expression pattern in subexpression, although the matched substring is not included in the match result. A zero-width positive lookahead assertion does not backtrack.
+
+Typically, a zero-width positive lookahead assertion is found at the end of a regular expression pattern. It defines a substring that must be found at the end of a string for a match to occur but that should not be included in the match. It is also useful for preventing excessive backtracking.
+
+It's possible to use a zero-width positive lookahead assertion to ensure that a particular captured group begins with text that matches a subset of the pattern defined for that captured group.
+
+### Zero-width negative lookahead assertions
+
+```regex title="Regex Syntax" linenums="1"
+(?! subexpression)
+```
+
+The *subexpression* is any regular expression pattern. For the match to be successful, the input string must not match the regular expression pattern in subexpression, although the matched string is not included in the match result.
+
+A zero-width negative lookahead assertion is typically used either at the beginning or at the end of a regular expression. At the beginning of a regular expression, it can define a specific pattern that should not be matched when the beginning of the regular expression defines a similar but more general pattern to be matched. In this case, it is often used to limit backtracking. At the end of a regular expression, it can define a subexpression that cannot occur at the end of a match.
+
+### Zero-width positive lookbehind assertions
+
+```regex title="Regex Syntax" linenums="1"
+(?<= subexpression)
+```
+
+The *subexpression* is any regular expression pattern. For a match to be successful, subexpression must occur at the input string to the left of the current position, although subexpression is not included in the match result. A zero-width positive lookbehind assertion does not backtrack.
+
+Zero-width positive lookbehind assertions are typically used at the beginning of regular expressions. The pattern that they define is a precondition for a match, although it is not a part of the match result.
+
+### Zero-width negative lookbehind assertions
+
+```regex title="Regex Syntax" linenums="1"
+(?<! subexpression)
+(?> subexpression)
+```
+
+Hte *subexpression* is any regular expression pattern. For a match to be successful, subexpression must not occur at the input string to the left of the current position. However, any substring that does not match subexpression is not included in the match result.
+
+Zero-width negative lookbehind assertions are typically used at the beginning of regular expressions. The pattern that they define precludes a match in the string that follows. They are also used to limit backtracking when the last character or characters in a captured group must not be one or more of the characters that match that group's regular expression pattern.
+
+### Atomic groups
+
+```regex title="Regex Syntax" linenums="1"
+(?> subexpression )
+```
+
+The *subexpression* is any regular expression pattern.
+
+Ordinarily, if a regular expression includes an optional or alternative matching pattern and a match does not succeed, the regular expression engine can branch in multiple directions to match an input string with a pattern. If a match is not found when it takes the first branch, the regular expression engine can back up or backtrack to the point where it took the first match and attempt the match using the second branch. This process can continue until all branches have been tried.
+
+The `(?>subexpression)` language construct disables backtracking. The regular expression engine will match as many characters in the input string as it can. When no further match is possible, it will not backtrack to attempt alternate pattern matches. (That is, the subexpression matches only strings that would be matched by the subexpression alone; it does not attempt to match a string based on the subexpression and any subexpressions that follow it.)
 
 ## Quantifiers
 
-`+` one or more repetitions  
-`*` zero or more repetitions  
-`?` zero or one repetition  
-`{m}` exactly *m* times  
-`{m, n}` at least *m* times, at most *n* times
+A quantifier specifies how many instances of the previous element (which can be a character, a group, or a character class) must be present in the input string for a match to occur.
 
-The `*`, `x`, and `?` qualifiers are all greedy; they match as much text as possible  
-Adding `?` *after* the qualifier makes it perform the match in non-greedy or minimal fashion; as few characters as possible will be matched.
+- `*`: Matches the previous element zero or more times.
+- `+`: Matches the previous element one or more times.
+- `?`: Matches the previous element zero or one time.
+- `{n}`: Matches the previous element exactly n times.
+- `{n}`: Matches the previous element at least n times.
+- `{n,m}`: Matches the previous element at least n times, but no more than m times.
+- `*?`: Matches the previous element zero or more times, but as few times as possible.
+- `+?`: Matches the previous element one or more times, but as few times as possible.
+- `??`: Matches the previous element zero or one time, but as few times as possible.
+- `{n}?`: Matches the preceding element exactly n times.
+- `{n}?`: Matches the previous element at least n times, but as few times as possible.
+- `{n,m}?`: Matches the previous element between n and m times, but as few times as possible.
 
-## Special Characters
+## Alternation Constructs
 
-`\a, \b, \f, \n, \r, \t, \u, \U, \v, \x, \\, \?, \*, \+ , \., \^, \$` special characters  
-`\(`, `\)`, `\[`, `\]` brackets escaping
+Alternation constructs modify a regular expression to enable either/or matching.
 
-## Delimiters
+- `|`: Matches any one element separated by the vertical bar (`|`) character.
 
-`^` match must be at start of string/line  
-`$` match must be at end of string/line  
-`^__$` match must be whole string  
+## Backreference Constructs
 
-## Character classes
+A backreference allows a previously matched subexpression to be identified subsequently in the same regular expression.
 
-`[__]` one of the characters in the class (`[ab]` --> a or b)  
-`[__]{m , n}` consecutive characters in the class (`[aeiou]{2}` --> ae, ao, ...)  
-`[a-z]` sequence of lowercase characters  
-`[A-Z]` sequence of uppercase characters  
-`[a-zA-Z]` sequence of lowercase or uppercase characters  
-`[a-z][A-Z]` sequence of lowercase characters followed by sequence of uppercase characters  
-`[^__]` anything but the elements of the class (include `\n` to avoid matching line endings)
+`\number`: Backreference. Matches the value of a numbered subexpression.
+`\k<name>`: Named backreference. Matches the value of a named expression.
 
-`^`, `\`, `-` and `]` must be escaped to be used in classes: `[ \]\[\^\- ]`
+## Substitutions
 
-## Groups
+Substitutions are regular expression language elements that are supported in replacement patterns.
 
-`(__)` capturing group  
-`(?:__)` non-capturing group  
-`(REGEX_1 | REGEX_2)` match in multiple regex (R1 OR R2)  
-`(?=__)` match only if `__` is next substring  
-`(?!__)` match only if `__` is not next substring  
-`(?<=__)` match only if `__` is previous substring  
-`(?<!__)` match only if `__` is not previous substring  
+- `$ number`: Substitutes the substring matched by group number.
+- `${ name }`: Substitutes the substring matched by the named group name.
+- `$$`: Substitutes a literal "$".
+- `$&`: Substitutes a copy of the whole match.
+- $`: Substitutes all the text of the input string before the match.
+- `$'`: Substitutes all the text of the input string after the match.
+- `$+`: Substitutes the last group that was captured.
+- `$_`: Substitutes the entire input string.
 
-`\<number>` refers to n-th group  
+## Special Constructs
 
-## Special Cases
+- `(.*)`: Matches anything
+- `(.*?)`: Matches anything, but as few times as possible
+- `(?# comment )`: code comment, can be in the middle of the pattern
 
-`(.*)` match anything  
-`(.*?)` match anything, non-greedy match
+Brackets escapes:
+
+- `\(`
+- `\)`
+- `\[`
+- `\]`
+
+Special characters escapes:
+
+- `\a`
+- `\b`
+- `\f`
+- `\n`
+- `\r`
+- `\t`
+- `\u`
+- `\U`
+- `\v`
+- `\x`
+- `\\`
+- `\?`
+- `\*`
+- `\+`
+- `\.`
+- `\^`
+- `\$`

From b308443203be044cc007e639d86dcf3dbb3b1bd8 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Fri, 20 Oct 2023 18:22:46 +0200
Subject: [PATCH 35/39] show line numbers in conde snippets

---
 docs/containers/docker.md                     |  28 +--
 docs/containers/kubernetes.md                 |  11 +-
 docs/databases/mongo-db.md                    |  56 ++---
 docs/databases/redis.md                       |  12 +-
 docs/databases/sql.md                         |  52 ++--
 docs/devices/ios/content-view.md              |  34 +--
 docs/languages/assembly/assembly.md           |  18 +-
 docs/languages/bash/commands.md               |  16 +-
 docs/languages/bash/scripting.md              |  28 +--
 docs/languages/c/c.md                         |  74 +++---
 docs/languages/css/css.md                     | 128 +++++-----
 docs/languages/dotnet/asp.net/blazor.md       |  21 +-
 docs/languages/dotnet/asp.net/filters.md      |  18 +-
 docs/languages/dotnet/asp.net/middleware.md   |  12 +-
 docs/languages/dotnet/asp.net/minimal-api.md  |  49 ++--
 docs/languages/dotnet/asp.net/razor-syntax.md |  18 +-
 docs/languages/dotnet/asp.net/signalr.md      |  22 +-
 docs/languages/dotnet/asp.net/web-forms.md    |   8 +-
 .../dotnet/csharp/async-programming.md        |  10 +-
 docs/languages/dotnet/csharp/collections.md   |  20 +-
 docs/languages/dotnet/csharp/csharp.md        | 230 +++++++++---------
 docs/languages/dotnet/csharp/linq.md          |   8 +-
 .../dotnet/csharp/reactive-extensions.md      |   2 +-
 docs/languages/dotnet/csharp/unit-tests.md    |   6 +-
 docs/languages/dotnet/database/ado.net.md     |   8 +-
 .../dotnet/database/entity-framework.md       |  16 +-
 docs/languages/html/html.md                   |  70 +++---
 docs/languages/java/dao.md                    |   6 +-
 .../java/java-collection-framework.md         |  10 +-
 docs/languages/java/java.md                   | 134 +++++-----
 docs/languages/java/spring/pom.xml.md         |   2 +-
 docs/languages/java/spring/spring-project.md  |  12 +-
 docs/languages/java/web/servlet.md            |   4 +-
 docs/languages/javascript/ajax.md             |   8 +-
 docs/languages/javascript/dom.md              |  20 +-
 docs/languages/javascript/events-animation.md |   8 +-
 docs/languages/javascript/javascript.md       | 106 ++++----
 docs/languages/javascript/jquery.md           |  38 +--
 .../javascript/react/react-router.md          |  12 +-
 .../languages/javascript/react/react-tests.md |  12 +-
 docs/languages/javascript/react/react.md      |  26 +-
 .../languages/javascript/react/redux-tests.md |  12 +-
 docs/languages/javascript/react/redux.md      |  32 +--
 docs/languages/javascript/svelte/svelte.md    |  24 +-
 docs/languages/kotlin/kotlin.md               |  28 +--
 docs/languages/markdown.md                    |  16 +-
 docs/languages/php/composer.md                |  10 +-
 docs/languages/php/database.md                |  12 +-
 docs/languages/php/dependency-injection.md    |  10 +-
 docs/languages/php/php.md                     | 116 ++++-----
 docs/languages/php/plates-templating.md       |  18 +-
 docs/languages/php/psr-7.md                   |   2 +-
 docs/languages/php/simple-mvc/rest-api.md     |   4 +-
 docs/languages/php/simple-mvc/simple-mvc.md   |  13 +-
 docs/languages/php/unit-tests.md              |  20 +-
 docs/languages/php/web.md                     |  16 +-
 docs/languages/powershell/commands.md         |   2 +-
 docs/languages/powershell/scripting.md        |  54 ++--
 docs/languages/python/libs/beautiful-soup.md  |  18 +-
 docs/languages/python/libs/numpy.md           |  34 +--
 docs/languages/python/libs/pandas.md          |  92 +++----
 docs/languages/python/libs/requests.md        |  26 +-
 docs/languages/python/libs/seaborn.md         |  30 +--
 docs/languages/python/libs/tkinter.md         |  86 +++----
 docs/languages/python/modules/argparse.md     |  32 +--
 docs/languages/python/modules/ftplib.md       |   6 +-
 docs/languages/python/modules/json.md         |   6 +-
 docs/languages/python/modules/logging.md      |   4 +-
 docs/languages/python/modules/shutil.md       |   2 +-
 docs/languages/python/modules/smtplib.md      |   2 +-
 docs/languages/python/modules/socket.md       |   4 +-
 docs/languages/python/modules/sqlite.md       |  12 +-
 .../languages/python/modules/time-datetime.md |   4 +-
 docs/languages/python/modules/unittest.md     |   2 +-
 docs/languages/python/python.md               |  98 ++++----
 docs/languages/rust/cargo.md                  |  16 +-
 docs/languages/rust/rust.md                   | 152 ++++++------
 docs/languages/rust/unit-tests.md             |   4 +-
 docs/languages/swift/swift.md                 |  56 ++---
 docs/misc/git.md                              |   4 +-
 docs/misc/graph-ql.md                         |  40 +--
 docs/misc/ssh.md                              |   8 +-
 82 files changed, 1249 insertions(+), 1251 deletions(-)

diff --git a/docs/containers/docker.md b/docs/containers/docker.md
index 0f40f89..f738a75 100644
--- a/docs/containers/docker.md
+++ b/docs/containers/docker.md
@@ -63,7 +63,7 @@ VMs incur a lot of overhead beyond what is being consumed by your application lo
 
 ### [`docker run`](https://docs.docker.com/engine/reference/commandline/run/)
 
-```sh
+```sh linenums="1"
 docker run <image>  # run selected app inside a container (downloaded from Docker Hub if missing from image)
 docker run -d|--detach <image>  # run docker container in the background (does not occupy stdout & stderr)
 docker run -i|--interactive <image>  # run docker container in interactive mode (read stdin)
@@ -80,7 +80,7 @@ docker run --name=<container_name> <image>  # set container name
 
 ### [`docker container`](https://docs.docker.com/engine/reference/commandline/container/)
 
-```sh
+```sh linenums="1"
 docker container ls  # list of currently running containers
 docker container ls -a|--all  # list of all containers, running and exited
 docker container rm <container>  # remove one or more containers
@@ -97,7 +97,7 @@ docker container exec <container> <command>  # exec a command inside a container
 
 ### [`docker image`](https://docs.docker.com/engine/reference/commandline/image/)
 
-```sh
+```sh linenums="1"
 docker image ls  # list of existing images
 docker image rm <image>  # remove one or more images
 docker image prune <image>  # remove unused images
@@ -106,20 +106,20 @@ docker image pull <image>  # download an image w/o starting the container
 
 ### [`docker build`](https://docs.docker.com/engine/reference/commandline/build/)
 
-```sh
+```sh linenums="1"
 docker build -t <tag> -f <dockerfile> <context>  # build image with specific tag (usually user/app:version)
 docker build -t <tag> -f <dockerfile> --build-arg ARG=value <context>  # pass args to ARG steps
 ```
 
 ### [`docker push`](https://docs.docker.com/engine/reference/commandline/push/)
 
-```sh
+```sh linenums="1"
 docker push <image>  # publish image to registry (defaults to Docker Hub)
 ```
 
 ## [Dockerfile](https://docs.docker.com/engine/reference/builder/)
 
-```docker
+```docker linenums="1"
 # starting image or scratch
 FROM <base_image>:<tag>
 
@@ -149,7 +149,7 @@ ENTRYPOINT <executable> <arg1> <arg2>
 
 ### `CMD` vs `ENTRYPOINT`
 
-`CMD` is used to provide all the default scenarios which can be overridden. _Anything_ defined in CMD can be overridden by passing arguments in `docker run` command.
+`CMD` is used to provide all the default scenarios which can be overridden. *Anything* defined in CMD can be overridden by passing arguments in `docker run` command.
 
 `ENTRYPOINT` is used to define a specific executable (and it's arguments) to be executed during container invocation which cannot be overridden.  
 The user can however define arguments to be passed in the executable by adding them in the `docker run` command.
@@ -160,7 +160,7 @@ With multi-stage builds, it's possible to use multiple `FROM` statements in the
 
 It's possible to selectively copy artifacts from one stage to another, leaving behind everything not wanted in the final image.
 
-```docker
+```docker linenums="1"
 FROM <base_image>:<tag> AS <runtime_alias>
 RUN <command>  # install external dependencies (apt get ...)
 
@@ -186,7 +186,7 @@ COPY --from=<build_alias|stage_number> <src> <dir_in_container>
 CMD ["executable"]  # run app
 ```
 
-```docker
+```docker linenums="1"
 FROM mcr.microsoft.com/dotnet/<runtime|aspnet>:<alpine_tag> AS runtime
 RUN <command>  # install external dependencies (apt get ...)
 
@@ -219,7 +219,7 @@ ENTRYPOINT ["dotnet", "<project>.dll"]
 
 Starting container networks: `bridge` (default), `none`, `host`.
 
-```sh
+```sh linenums="1"
 docker run <image> --network=none/host  # specify a non-default network to be used
 docker network ls  # list all available networks
 ```
@@ -233,7 +233,7 @@ None: Containers are not attached to a network and cannot access other container
 
 ## User-defined Networks
 
-```sh
+```sh linenums="1"
 docker network create \
   --driver NETWORK_TYPE \
   --subnet GATEWAY_TP/SUBNET_MASK_SIZE 
@@ -250,7 +250,7 @@ Docker has an internal DNS that allows finding other container by their name ins
 
 ## File System
 
-```sh
+```sh linenums="1"
 /var/lib/docker
 |_<storage_driver>
 |_containers
@@ -270,7 +270,7 @@ To modify a file during while the container runs docker creates a local copy in
 **volume mounting**: create a volume under the docker installation folder (`/var/lib/docker/volumes/`).
 **bind mounting**: link docker to an exiting folder to be used as a volume.
 
-```sh
+```sh linenums="1"
 docker run -v <existing_dir>:<container_dir> <image>:<tag>  # older command for bind mounting
 docker run --mount type=bind, source=:<existing_dir>, target=<container_dir> <image>:<tag>  # modern command for bind mounting
 ```
@@ -287,7 +287,7 @@ Using Compose is basically a three-step process:
 2. Define the services that make up your app in `docker-compose.yml` so they can be run together in an isolated environment.
 3. Run `docker-compose up` and Compose starts and runs the entire app.
 
-```yaml
+```yaml linenums="1"
 version: 3.x
 services:
   <service_name>:
diff --git a/docs/containers/kubernetes.md b/docs/containers/kubernetes.md
index 0d790ea..e600461 100644
--- a/docs/containers/kubernetes.md
+++ b/docs/containers/kubernetes.md
@@ -96,7 +96,7 @@ As pods successfully complete, the Job tracks the successful completions. When a
 
 ## Kubernetes Configuration
 
-Each kubernetes configuration file is composed by 3 parts: 
+Each kubernetes configuration file is composed by 3 parts:
 
 - metadata
 - specification
@@ -110,7 +110,7 @@ Each kubernetes configuration file is composed by 3 parts:
 
 ### `kubectl get`
 
-```sh
+```sh linenums="1"
 kubectl config get-contexts  # list available contexts
 
 kubectl get namespaces  # list namespaces inside current context
@@ -121,11 +121,12 @@ kubectl get pod [-n|--namespace <namespace>] <pod> -o|--output jsonpath='{.spec.
 
 ### `kubectl exec`
 
-```sh
+```sh linenums="1"
 kubectl exec [-i|--stdin] [-t|--tty] [-n|--namespace <namespace>] <pod> [-c|--container <container>] -- <command>  # execute a command inside a container
 ```
+
 ### `kubectl logs`
 
-```sh
+```sh linenums="1"
 kubectl logs [-f|--follow] [-n|--namespace <namespace>] <pod> [-c|--container]  # get pod/container logs
-```
\ No newline at end of file
+```
diff --git a/docs/databases/mongo-db.md b/docs/databases/mongo-db.md
index d63a43d..cf8e586 100644
--- a/docs/databases/mongo-db.md
+++ b/docs/databases/mongo-db.md
@@ -25,7 +25,7 @@ MongoDB automatically creates an `ObjectId()` if it's not provided.
 To create a database is sufficient to switch towards a non existing one with `use <database>` (implicit creation).
 The database is not actually created until a document is inserted.
 
-```sh
+```sh linenums="1"
 show dbs  # list all databases
 use <database>  # use a particular database
 show collections  # list all collection for the current database
@@ -38,7 +38,7 @@ db.<collection>.insertOne({document})  # implicit collection creation
 
 ## Operators (MQL Syntax)
 
-```json
+```json linenums="1"
 /* --- Update operators --- */
 { "$inc":  { "<key>": "<increment>", ... } }  // Increment value
 { "$set":  { "<key>": "<value>", ... } }  // Set value
@@ -79,7 +79,7 @@ db.<collection>.insertOne({document})  # implicit collection creation
 
 > **Note**:  `$<key>` is used to access the value of the field dynamically
 
-```json
+```json linenums="1"
 { "$expr": { "<expression>" } }  // aggregation expression, variables, conditional expressions
 { "$expr":  { "$<comparison_operator>": [ "$<key>", "$<key>" ] } }  // compare field values (operators use aggregation syntax)
 ```
@@ -95,7 +95,7 @@ Insertion results:
 - error -> rollback
 - success -> entire documents gets saved
 
-```sh
+```sh linenums="1"
 # explicit collection creation, all options are optional
 db.createCollection( <name>,
    {
@@ -128,7 +128,7 @@ db.<collection>.insertMany([ { document }, { document } ] , { "ordered": false }
 
 ### Querying
 
-```sh
+```sh linenums="1"
 db.<collection>.findOne()  # find only one document
 db.<collection>.find(filter)  # show selected documents
 db.<collection>.find().pretty()  # show documents formatted
@@ -172,7 +172,7 @@ db.<collection>.find().hint( { $natural : -1 } )  # force the query to perform a
 
 [Update Operators](https://docs.mongodb.com/manual/reference/operator/update/ "Update Operators Documentation")
 
-```sh
+```sh linenums="1"
 db.<collection>.replaceOne(filter, update, options)
 db.<collection>.updateOne(filter, update, {upsert: true})  # modify document if existing, insert otherwise
 
@@ -181,7 +181,7 @@ db.<collection>.updateOne(filter, { "$push": { ... }, "$set": { ... }, { "$inc":
 
 ### Deletion
 
-```sh
+```sh linenums="1"
 db.<collection>.deleteOne(filter, options)
 db.<collection>.deleteMany(filter, options)
 
@@ -199,7 +199,7 @@ Utility to import all docs into a specified collection.
 If the collection already exists `--drop` deletes it before reuploading it.
 **WARNING**: CSV separators must be commas (`,`)
 
-```sh
+```sh linenums="1"
 mongoimport <options> <connection-string> <file>
 
 --uri=<connectionString>
@@ -218,7 +218,7 @@ mongoimport <options> <connection-string> <file>
 
 Utility to export documents into a specified file.
 
-```sh
+```sh linenums="1"
 mongoexport --collection=<collection> <options> <connection-string>
 
 --uri=<connectionString>
@@ -272,7 +272,7 @@ Indexes _slow down writing operations_ since the index must be updated at every
 
 ### Diagnosis and query planning
 
-```sh
+```sh linenums="1"
 db.<collection>.find({...}).explain()  # explain won't accept other functions
 db.explain().<collection>.find({...})  # can accept other functions
 db.explain("executionStats").<collection>.find({...})  # more info
@@ -280,7 +280,7 @@ db.explain("executionStats").<collection>.find({...})  # more info
 
 ### Index Creation
 
-```sh
+```sh linenums="1"
 db.<collection>.createIndex( <key and index type specification>, <options> )
 
 db.<collection>.createIndex( { "<key>": <type>, "<key>": <type>, ... } )  # normal, compound or multikey (field is array) index
@@ -302,7 +302,7 @@ db.<collection>.createIndex(
 
 ### [Index Management](https://docs.mongodb.com/manual/tutorial/manage-indexes/)
 
-```sh
+```sh linenums="1"
 # view all db indexes
 db.getCollectionNames().forEach(function(collection) {
    indexes = db[collection].getIndexes();
@@ -339,7 +339,7 @@ handling connections, requests and persisting the data.
 
 ### Basic Shell Helpers
 
-```sh
+```sh linenums="1"
 db.<method>()  # database interaction
 db.<collection>.<method>()  # collection interaction
 rs.<method>();  # replica set deployment and management
@@ -378,7 +378,7 @@ Log Verbosity Level:
 - `0`: Default Verbosity (Information)
 - `1 - 5`: Increases the verbosity up to Debug messages
 
-```sh
+```sh linenums="1"
 db.getLogComponents()  # get components and their verbosity
 db.adminCommand({"getLog": "<scope>"})  # retrieve logs (getLog must be run on admin db -> adminCommand)
 db.setLogLevel(<level>, "<component>");  # set log level (output is OLD verbosity levels)
@@ -404,7 +404,7 @@ Events captured by the profiler:
 
 > **Note**: Logs are saved in the `system.profile` _capped_ collection.
 
-```sh
+```sh linenums="1"
 db.setProfilingLevel(n)  # set profiler level
 db.setProfilingLevel(1, { slowms: <ms> })
 db.getProfilingStatus()  # check profiler status
@@ -454,7 +454,7 @@ Built-in Roles Groups and Names:
 - Backup/Restore: `backup`, `restore`
 - Super User: `root`
 
-```sh
+```sh linenums="1"
 db.createUser(
     {
         user: "<username>",
@@ -509,7 +509,7 @@ Variable syntax in aggregations:
 
 Filters the documents to pass only the documents that match the specified condition(s) to the next pipeline stage.
 
-```sh
+```sh linenums="1"
 db.<collection>.aggregate([ 
     { "$match": { "<query>" } },
 
@@ -541,7 +541,7 @@ Passes along the documents with the requested fields to the next stage in the pi
 - [`$sum`][$sum_docs]
 - [`$avg`][$avg_docs]
 
-```sh
+```sh linenums="1"
 db.<collection>.aggregate([ 
      { 
         "$project": { 
@@ -598,7 +598,7 @@ db.<collection>.aggregate([
 Adds new fields to documents (can be result of computation).  
 `$addFields` outputs documents that contain _all existing fields_ from the input documents and newly added fields.
 
-```sh
+```sh linenums="1"
 db.<collection>.aggregate({
     { $addFields: { <newField>: <expression>, ... } }
 })
@@ -610,7 +610,7 @@ db.<collection>.aggregate({
 
 The $`group` stage separates documents into groups according to a "group key". The output is one document for each unique group key.
 
-```sh
+```sh linenums="1"
 db.<collection>.aggregate([ 
      { 
         "$group": {
@@ -629,7 +629,7 @@ db.<collection>.aggregate([
 Deconstructs an array field from the input documents to output a document for each element.  
 Each output document is the input document with the value of the array field replaced by the element
 
-```sh
+```sh linenums="1"
 db.<collection>.aggregate([ 
      { "$unwind": "<array-key>" }
 
@@ -647,7 +647,7 @@ db.<collection>.aggregate([
 
 ### [`$count` Aggregation Stage][$count_docs]
 
-```sh
+```sh linenums="1"
 db.<collection>.aggregate([ 
      { "$count": "<count-key>" }
 ])
@@ -657,7 +657,7 @@ db.<collection>.aggregate([
 
 ### [`$sort` Aggregation Stage][$sort_docs]
 
-```sh
+```sh linenums="1"
 db.<collection>.aggregate([ 
      { 
         "$sort": { 
@@ -676,7 +676,7 @@ db.<collection>.aggregate([
 
 ### [`$skip` Aggregation Stage][$skip_docs]
 
-```sh
+```sh linenums="1"
 db.<collection>.aggregate([ 
      { "$skip": "<positive 64-bit integer>" }
 ])
@@ -686,7 +686,7 @@ db.<collection>.aggregate([
 
 ### [`$limit` Aggregation Stage][$limit_docs]
 
-```sh
+```sh linenums="1"
 db.<collection>.aggregate([ 
      { "$limit": "<positive 64-bit integer>" }
 ])
@@ -701,7 +701,7 @@ The `$lookup` stage adds a new array field to each input document. The new array
 
 > **Note**: To combine elements from two different collections, use the [`$unionWith`][$unionWith_docs] pipeline stage.
 
-```sh
+```sh linenums="1"
 db.<collection>.aggregate([ 
     {
         "$lookup": {
@@ -724,7 +724,7 @@ Performs a recursive search on a collection, with options for restricting the se
 
 The collection on which the aggregation is performed and the `from` collection can be the same (in-collection search) or different (cross-collection search)
 
-```sh
+```sh linenums="1"
 db.<collection>.aggregate([
     {
         $graphLookup: {
@@ -754,7 +754,7 @@ Each output document contains two fields: an `_id` field containing the distinct
 
 The documents are sorted by count in descending order.
 
-```sh
+```sh linenums="1"
 db.<collection>.aggregate([
     { $sortByCount:  <expression> }
 ])
diff --git a/docs/databases/redis.md b/docs/databases/redis.md
index a130b89..df1436e 100644
--- a/docs/databases/redis.md
+++ b/docs/databases/redis.md
@@ -10,14 +10,14 @@ Often Redis it is called a *data structure* server because it has outer key-valu
 
 ### Server Startup
 
-```bash
+```bash linenums="1"
 redis-server  # start the server
 redis-cli
 ```
 
 ### [Key-Value Pairs](https://redis.io/commands#generic)
 
-```sh
+```sh linenums="1"
 SET <key> <value> [ EX <seconds> ] # store a key-value pair, TTL optional
 GET <key>  # read a key content
 EXISTS <key>  # check if a key exists
@@ -40,7 +40,7 @@ PERSIST <key>  # make the key permanent
 
 A list is a series of ordered values.
 
-```sh
+```sh linenums="1"
 RPUSH <key> <value1> <value2> ... # add one or more values to the end of the list
 LPUSH <key> <value1> <value2> ...  # add one or more values to the start of a list
 
@@ -55,7 +55,7 @@ RPOP  # remove and return the last item fro the list
 
 A set is similar to a list, except it does not have a specific order and each element may only appear once.
 
-```sh
+```sh linenums="1"
 SADD <key> <value1> <value2> ... # add one or more values to the set (return 0 if values are already inside)
 SREM <key> <value>  # remove the given member from the set, return 1 or 0 to signal if the member was actually there or not.
 SPOP <key> <value>  # remove and return value from the set
@@ -72,7 +72,7 @@ Sets are a very handy data type, but as they are unsorted they don't work well f
 
 A sorted set is similar to a regular set, but now each value has an associated score. This score is used to sort the elements in the set.
 
-```sh
+```sh linenums="1"
 ZADD <key> <score> <value>  # add a value with it's score
 
 ZRANGE <key> <start_index> <end_index>  # return a subset of the sortedSet
@@ -84,7 +84,7 @@ ZRANGE <key> <start_index> <end_index>  # return a subset of the sortedSet
 
 Hashes are maps between string fields and string values, so they are the perfect data type to represent objects.
 
-```sh
+```sh linenums="1"
 HSET <key> <field> <value> [ <field> <value> ... ] # set the string of a hash field
 HSETNX <key> <field> <value>  # set the value of a hash field, only if the field does not exist
 
diff --git a/docs/databases/sql.md b/docs/databases/sql.md
index 1870cbb..3504865 100644
--- a/docs/databases/sql.md
+++ b/docs/databases/sql.md
@@ -2,7 +2,7 @@
 
 ## DDL
 
-```sql
+```sql linenums="1"
 show databases;    -- mostra database
 CREATE DATABASE <database>;    -- database creation
 use <database_name>;    -- usa un database particolare
@@ -16,7 +16,7 @@ show tables;    -- mostra tabelle del database
 
 ### Table Creation
 
-```sql
+```sql linenums="1"
 CREATE TABLE <table_name>
     (<field_name> <field_type> <option>,
     ...);
@@ -24,7 +24,7 @@ CREATE TABLE <table_name>
 
 ### PRIMARY KEY from multiple fields
 
-```sql
+```sql linenums="1"
 CREATE TABLE <table_name>(
     ...,
     PRIMARY KEY (<field1>, ...),
@@ -33,7 +33,7 @@ CREATE TABLE <table_name>(
 
 ### Table Field Options
 
-```sql
+```sql linenums="1"
 PRIMARY KEY -- marks primary key as field option
 NOT NULL -- marks a necessary field
 REFERENCES <table> (<field>) -- adds foreign key reference
@@ -43,7 +43,7 @@ UNIQUE (<field>) -- set field as unique (MySQL)
 
 ### Table Modification
 
-```sql
+```sql linenums="1"
 ALTER TABLE <table>
     ADD PRIMARY KEY (<field>, ...),    -- definition of PK after table creation
     ADD <field_name> <field_type> <option>;    -- addition of a new field, field will have no value in the table
@@ -63,20 +63,20 @@ ALTER TABLE <table>
 
 ### Data Insertion
 
-```sql
+```sql linenums="1"
 INSERT INTO <table> (field_1, ...) VALUES (value_1, ...), (value_1, ...);
 INSERT INTO <table> VALUES (value_1, ...), (value_1, ...);    -- field order MUST respect tables's columns order
 ```
 
 ### Data Update
 
-```sql
+```sql linenums="1"
 UPDATE <table> SET <field> = <value>, <field> = <value>, ... WHERE <condition>;
 ```
 
 ### Data Elimination
 
-```sql
+```sql linenums="1"
 DELETE FROM <table> WHERE <condition>
 DELETE FROM <table> -- empty the table
 ```
@@ -85,7 +85,7 @@ DELETE FROM <table> -- empty the table
 
 `*`: denotes all table fields
 
-```sql
+```sql linenums="1"
 SELECT * FROM <table>;    -- show table contents
 SHOW columns FROM <table>;    -- show table columns
 DESCRIBE <table>;    -- shows table
@@ -93,13 +93,13 @@ DESCRIBE <table>;    -- shows table
 
 ### Alias
 
-```sql
+```sql linenums="1"
 SELECT <field> as <alias>; -- shows <field/funzione> with name <alias>
 ```
 
 ### Conditional Selection
 
-```sql
+```sql linenums="1"
 SELECT * FROM <table> WHERE <condition>;    -- shows elements that satisfy the condition
 AND, OR, NOT    -- logic connectors
 
@@ -108,7 +108,7 @@ SELECT * FROM <table> WHERE <field> Between <value_1> AND <value_2>;
 
 ### Ordering
 
-```sql
+```sql linenums="1"
 SELECT * FROM <table> ORDER BY <field>, ...;    -- shows the table ordered by <field>
 SELECT * FROM <table> ORDER BY <field>, ... DESC;    -- shows the table ordered by <field>, decreasing order
 SELECT * FROM <table> ORDER BY <field>, ... LIMIT n;    -- shows the table ordered by <field>, shows n items
@@ -117,7 +117,7 @@ SELECT TOP(n) * FROM <table> ORDER BY <field>, ...;    -- T-SQL
 
 ## Grouping
 
-```sql
+```sql linenums="1"
 SELECT * FROM <table> GROUP BY <field>;
 SELECT * FROM <table> GROUP BY <field> HAVING <condition>;
 SELECT DISTINCT <field> FROM <table>;    -- shows elements without repetitions
@@ -127,7 +127,7 @@ SELECT DISTINCT <field> FROM <table>;    -- shows elements without repetitions
 
 `%`: any number of characters
 
-```sql
+```sql linenums="1"
 SELECT * FROM <table> WHERE <field> LIKE '<char>%';    -- selects items in <field> that start with <char>
 SELECT * FROM <table> WHERE <field> LIKE '%<char>';    -- selects items in <field> that end with <char>
 SELECT * FROM <table> WHERE <field> LIKE '%<char>%';    -- selects items in <field> that contain <char>
@@ -136,14 +136,14 @@ SELECT * FROM <table> WHERE <field> NOT LIKE '%<char>%';    -- selects items in
 
 ### Selection from multiple tables
 
-```sql
+```sql linenums="1"
 SELECT a.<field>, b.<field> FROM <table> AS a, <table> AS b
     WHERE a.<field> ...;
 ```
 
 ## Functions
 
-```sql
+```sql linenums="1"
 SELECT COUNT(*) FROM <field>;    -- count of items in <field>
 SELECT MIN(*) FROM <table>;    -- min value
 SELECT MAX(*) FROM <table>;    -- max value
@@ -154,7 +154,7 @@ ANY (SELECT ...)
 
 ## Nested Queries
 
-```sql
+```sql linenums="1"
 SELECT * FROM <table> WHERE EXISTS (SELECT * FROM <table>)  -- selected field existing in subquery
 SELECT * FROM <table> WHERE NOT EXISTS (SELECT * FROM <table>)  -- selected field not existing in subquery
 ```
@@ -163,7 +163,7 @@ SELECT * FROM <table> WHERE NOT EXISTS (SELECT * FROM <table>)  -- selected fiel
 
 Create new table with necessary fields:
 
-```sql
+```sql linenums="1"
 CREATE TABLE <table> (
     (<field_name> <field_type> <option>,
     ...);
@@ -172,14 +172,14 @@ CREATE TABLE <table> (
 
 Fill fields with data from table:
 
-```sql
+```sql linenums="1"
 INSERT INTO <table>
     SELECT <fields> FROM <TABLE> WHERE <condition>;
 ```
 
 ## Join
 
-```sql
+```sql linenums="1"
 SELECT * FROM <table1> JOIN <table2> ON <table1>.<field> = <table2>.<field>;
 SELECT * FROM <table1> LEFT JOIN <table2> ON <condition>;
 SELECT * FROM <table1> RIGHT JOIN <table2> ON <condition>
@@ -189,7 +189,7 @@ SELECT * FROM <table1> RIGHT JOIN <table2> ON <condition>
 
 ## Multiple Join
 
-```sql
+```sql linenums="1"
 SELECT * FROM <table1>
 JOIN <table2> ON <table1>.<field> = <table2>.<field>
 JOIN <table3> ON <table2>.<field> = <table3>.<field>;
@@ -203,7 +203,7 @@ JOIN <table3> ON <table2>.<field> = <table3>.<field>;
 
 ### T-SQL Insert From table
 
-```sql
+```sql linenums="1"
 USE [<db_name>]
 
 SET IDENTITY_INSERT [<destination_table>] ON
@@ -217,7 +217,7 @@ SET IDENTITY_INSERT [<destination_table>] OFF
 
 ### T-SQL Parametric Query
 
-```sql
+```sql linenums="1"
 -- variable declaration
 DECLARE @var_name <type>
 
@@ -238,7 +238,7 @@ GO
 
 A view represents a virtual table. Join multiple tables in a view and use the view to present the data as if the data were coming from a single table.
 
-```sql
+```sql linenums="1"
 CREATE VIEW <name> AS
 SELECT * FROM <table> ...
 ```
@@ -250,7 +250,7 @@ SELECT * FROM <table> ...
 
 Stored Procedure Definition:
 
-```sql
+```sql linenums="1"
 CREATE PROCEDURE <Procedure_Name>
     -- Add the parameters for the stored procedure here
     <@Param1> <Datatype_For_Param1> = <Default_Value_For_Param1>,
@@ -268,7 +268,7 @@ GO
 
 Stored Procedure call in query:
 
-```sql
+```sql linenums="1"
 USE <database>
 GO
 
diff --git a/docs/devices/ios/content-view.md b/docs/devices/ios/content-view.md
index f76b8ef..c86b1e3 100644
--- a/docs/devices/ios/content-view.md
+++ b/docs/devices/ios/content-view.md
@@ -16,7 +16,7 @@ SwiftUI memorizes internally the value of the `@State` property and updates the
 - Permits the visualization of simple UIs.
 - Constituted by a body of type `View`
 
-```swift
+```swift linenums="1"
 struct SimpleViewName: View {
 
     let CONSTANT: Type
@@ -38,7 +38,7 @@ struct SimpleViewName: View {
 
 Used to organize elements without dealing with constraints or forcing the visualization on devices wih different screen sizes.
 
-```swift
+```swift linenums="1"
 struct ContentView: View {
     var body: some View {
 
@@ -61,7 +61,7 @@ The basic object that creates the table view is the `List()`. It's job is to cre
 The array can be filtered with a *search bar*.
 The array elements can be grouped with the `Section()` object that groups cells under a common name in the table.
 
-```swift
+```swift linenums="1"
 // view name can be any
 struct TableView: View {
     var array = [...]
@@ -88,7 +88,7 @@ Every cell can have a link to visualize the details of the selected object. This
 The `NavigationView` contains the list and the property `.navigationBarTitle()` sets the view title.
 It's possible to add other controls in the top part of the view (buttons, ...) using the property `.navigationBarItems()`.
 
-```swift
+```swift linenums="1"
 struct ContentView: View {
     let array = [...]
     var body: some View {
@@ -108,7 +108,7 @@ struct ContentView: View {
 This view handles a bar on the bottom of the screen with links to simple or more complex views.
 This is useful for designing pages that can be easily navigated by the user.
 
-```swift
+```swift linenums="1"
 struct TabBarView: View {
     var body: some View {
 
@@ -143,20 +143,20 @@ It's possible to integrate the NavigationView in the TabBar in two ways:
 
 ### Text
 
-```swift
+```swift linenums="1"
 Text("")
 ```
 
 ### Shapes
 
-```swift
+```swift linenums="1"
 Rectangle()
 Circle()
 ```
 
 ### Spacing
 
-```swift
+```swift linenums="1"
 Divider()
 Spacer()
 ```
@@ -165,13 +165,13 @@ Spacer()
 
 [System Images](https://developer.apple.com/design/human-interface-guidelines/sf-symbols/overview/)
 
-```swift
+```swift linenums="1"
 Image(systemName: "sfsymbol")
 ```
 
 ### Button
 
-```swift
+```swift linenums="1"
 Button(action: { /* statements */ }) {
     Text("Label")
     //or
@@ -202,7 +202,7 @@ Common syle options:
 - `shadow()`: Sets the object's shadow
 - `lineLimit()`: limits the number of visible lines in `TextField`
 
-```swift
+```swift linenums="1"
 View().styleOption()
 // or
 View {
@@ -212,7 +212,7 @@ View {
 
 ## Forms & Input
 
-```swift
+```swift linenums="1"
 Form {
     Section (header: Text("Section Title")) {
         // form components
@@ -222,7 +222,7 @@ Form {
 
 ### Picker
 
-```swift
+```swift linenums="1"
 // list item picker
 Picker(selction: $index, label: Text("Selection Title")) {
     ForEach(0..<itemArray.count){
@@ -233,26 +233,26 @@ Picker(selction: $index, label: Text("Selection Title")) {
 
 ### Stepper
 
-```swift
+```swift linenums="1"
 Stepper("\(number)", value: $number, in: start...end)
 ```
 
 ### TextField
 
-```swift
+```swift linenums="1"
 TextField("Placeholder Text", text: $result)
     .keyboardType(.<kb_type>)
 ```
 
 ### Slider
 
-```swift
+```swift linenums="1"
 Slider(value: $numVariable)
 ```
 
 ## API Interaction
 
-```swift
+```swift linenums="1"
 @State private var apiItems = [<struct>]()
 
 // struct should be Identifiable & Codable
diff --git a/docs/languages/assembly/assembly.md b/docs/languages/assembly/assembly.md
index ff3e24d..80e5b17 100644
--- a/docs/languages/assembly/assembly.md
+++ b/docs/languages/assembly/assembly.md
@@ -4,7 +4,7 @@
 
 ## Compiling & Linking
 
-```sh
+```sh linenums="1"
 # compiling
 nasm -g -f elf64 src.asm  # -g adds debug info, -f specifies the 64bit ELF format
 
@@ -25,7 +25,7 @@ Every program in ELF has several sections:
 - `bss`: space reserved at program startup
 - `text`: CPU instructions
 
-```asm
+```asm linenums="1"
 ; export the '_start' symbol for linking
 global _start
 
@@ -49,7 +49,7 @@ Declaration instructions:
 > **Note**: See the NASM manual, section 3.2.1 for the full list.
 > **Note**: all byte declaarations are [Little Endian](https://en.wikipedia.org/wiki/Endianness "Endiannes")
 
-```asm
+```asm linenums="1"
 arr: db 0x12,0x34,0x56,0x78,0x90
 ```
 
@@ -85,14 +85,14 @@ For registers `rax` through `rdx`, it's possible to access:
 Instructions are operations that the CPU knowns how to execute directly.  
 They are separated from their operands by whitespace, and the operands are separated from other with commas.
 
-```asm
+```asm linenums="1"
 <instr> <operand1>, <operand2>, ..., <operand_n>
 
 ; Intel syntax dictates the first operand is the destination, and the second is the source
 <instr> DEST, SOURCE
 ```
 
-```asm
+```asm linenums="1"
 mov eax, 0x12345678  ; copies 4 bytes to eax
 inc rdi  ; INC: increment
 dec rsi  ; DEC: decrement
@@ -102,7 +102,7 @@ dec rsi  ; DEC: decrement
 
 Adds the two operands and stores the result in the _destination_.
 
-```asm
+```asm linenums="1"
 add rdi, rbx  ; Equivalent to rdi += rbx
 ```
 
@@ -110,7 +110,7 @@ add rdi, rbx  ; Equivalent to rdi += rbx
 
 Subtract the two operands and stores the result in the _destination_.
 
-```asm
+```asm linenums="1"
 sub rsi, rbx  ; Equivalent to rsi -= rbx
 ```
 
@@ -130,7 +130,7 @@ The **quotient** is a _64-bit_ value stored in `rax`, and the **remainder** is a
 
 ### `and`, `or`, `xor`
 
-```asm
+```asm linenums="1"
 and rdi, rsi  ; bitwise AND
 or rdi, rsi  ; bitwise OR
 xor rdi, rsi  ; bitwise XOR
@@ -138,7 +138,7 @@ xor rdi, rsi  ; bitwise XOR
 
 ### `shr`, `shl`
 
-```asm
+```asm linenums="1"
 shr rsi, 2  ; right (logical) bitshift: equivalent to rsi >> 2
 shl rsi, 3  ; left (logical) bitshift: equivalent to rsi << 3
 ```
diff --git a/docs/languages/bash/commands.md b/docs/languages/bash/commands.md
index 01a6783..927226f 100644
--- a/docs/languages/bash/commands.md
+++ b/docs/languages/bash/commands.md
@@ -8,7 +8,7 @@
 
 [sudo vs su](https://unix.stackexchange.com/questions/35338/su-vs-sudo-s-vs-sudo-i-vs-sudo-bash/35342)
 
-```bash
+```bash linenums="1"
 sudo su  # login as root (user must be sudoers, root password not required) DANGEROUS
 sudo -s  # act as root and inherit current user environment (env as is now, along current dir and env vars) SAFE (can modify user environment)
 sudo -i  # act as root and and use a clean environment (goes to user's home, runs .bashrc) SAFEST
@@ -22,7 +22,7 @@ su USER  # change user but don't load it's home folder
 
 ### Getting Info
 
-```sh
+```sh linenums="1"
 man COMMAND  # show command manual
 help COMMAND  # show command info
 whatis COMMAND  # one-line command explanation
@@ -35,7 +35,7 @@ id  # Print user and group information for the specified USER, or (when USER omi
 
 ### Moving & Showing Directory Contents
 
-```sh
+```sh linenums="1"
 pwd  # print working (current) directory
 ls [option]... [FILE]...   # list directory contents ("list storage")
 cd rel_path  # change directory to path (rel_path must be inside current directory)
@@ -49,7 +49,7 @@ popd  # return to previous directory (before pushd)
 
 ### Creating, Reading, Copying, Moving, Modifying Files And Directories
 
-```sh
+```sh linenums="1"
 touch FILE  # change FILE timestamp fi exists, create file otherwise
 cat [FILE]  # concatenate files and print on standard output (FD 1)
 cat >> FILE  # append following content ot file (Ctrl+D to stop)
@@ -84,7 +84,7 @@ cp SOURCE DESTINATION  # copy SOURCE to DESTINATION
 
 ![Linux Permissions](../../img/bash_files-permissions-and-ownership-basics-in-linux.png "files info and permissions")
 
-```sh
+```sh linenums="1"
 chmod MODE FILE  # change file (or directory) permissions
 chmod OCTAL-MODE FILE  # change file (or directory) permissions
 
@@ -121,7 +121,7 @@ chgrp [OPTION]... GROUP FILE...  # change group ownership
 
 ### Finding Files And Directories
 
-```sh
+```sh linenums="1"
 find [path] [expression]   # search file in directory hierarchy
 find [start-position] -type f -name FILENAME  # search for a file named "filename"
 find [start-position] -type d -name DIRNAME  # search for a directory named "dirname"
@@ -134,7 +134,7 @@ find [path] -exec <command> {} \;  # execute command on found items (identified
 
 ### Other
 
-```sh
+```sh linenums="1"
 tee  # copy standard input and write to standard output AND files simultaneously
 tee [FILE]
 command | sudo tee FILE  # operate on file w/o using shell as su
@@ -171,7 +171,7 @@ watch -n SECONDS COMMAND  # execute command every SECONDS seconds (no less than
 
 **Data wrangling** is the process of transforming and mapping data from one "raw" data form into another format with the intent of making it more appropriate and valuable for a variety of downstream purposes such as analytics.
 
-```bash
+```bash linenums="1"
 sed  # stream editor for filtering and transforming text
 sed -E "s/REGEX/replacement/"  # substitute text ONCE (-E uses modern REGEX)
 sed -E "s/REGEX/replacement/g"  # substitute text multiple times (every match)
diff --git a/docs/languages/bash/scripting.md b/docs/languages/bash/scripting.md
index a9667b1..95e0c74 100644
--- a/docs/languages/bash/scripting.md
+++ b/docs/languages/bash/scripting.md
@@ -44,20 +44,20 @@ shebang indicating which interpreter to use
 
 ### Simple Command
 
-```bash
+```bash linenums="1"
 [ var=value ... ] command [ arg ... ] [ redirection ... ]  # [.] is optional component
 ```
 
 ### Pipelines (commands concatenation)
 
-```bash
+```bash linenums="1"
 command | file.ext  # link the first process' standard output to the second process' standard input
 command |& file.ext  # link the first process' standard output & standard error to the second process' standard input
 ```
 
 ### Lists (sequence of commands)
 
-```bash
+```bash linenums="1"
 command_1; command_2; ...  # execute command in sequence, one after the other
 command_1 || command_2 || ...  # execute successive commands only if preceding ones fail
 command_1 && command_2 && ..  # execute successive commands only if preceding ones succeeds
@@ -65,7 +65,7 @@ command_1 && command_2 && ..  # execute successive commands only if preceding on
 
 ### COMPOUND COMMANDs (multiple commands as one)
 
-```bash
+```bash linenums="1"
 # block of commands executed as one
 <keyword>
     command_1; command_2; ...
@@ -108,7 +108,7 @@ We can copy file descriptors to make them share a stream. There are also many ot
 
 ### Redirections
 
-```bash
+```bash linenums="1"
 [x]>file  # make FD x write to file
 [x]<file  # make FD x read from file
 
@@ -142,7 +142,7 @@ x>&-, x<&-  # close FD x (stream disconnected from FD x)
 
 With Command Substitution, we effectively write a command within a command, and we ask bash to expand the inner command into its output and use that output as argument data for the main command.  
 
-```bash
+```bash linenums="1"
 $(inner_command)  # $ --> value-expansion prefix
 command !*  # !* expands to everything except the first argument in the previous line
 command !$  # refers to the last argument of the previous command
@@ -151,7 +151,7 @@ sudo !! # !! expands to the entire previous command
 
 ## Shell Variables
 
-```bash
+```bash linenums="1"
 varname=value  # variable assignment
 varname="$(command)"  # command substitution, MUST be double-quoted
 "$varname", "${varname}"  # variable expansion, MUST be double-quoted (name substituted w/ variable content)
@@ -188,7 +188,7 @@ Omit the pattern to match any character.
 
 Only the final exit code after executing the entire list is relevant for the branch's evaluation.
 
-```bash
+```bash linenums="1"
 if command_list; then
     command_list;
 elif command_list; then
@@ -207,7 +207,7 @@ fi
 
 ### Comparison Operators
 
-```bash
+```bash linenums="1"
 [[ "$a" -eq "$b" ]]  # is equal to
 [[ "$a" -ne "$b" ]]  # in not equal to
 [[ "$a" -gt "$b" ]]  # greater than
@@ -218,7 +218,7 @@ fi
 
 ### Arithmetic Comparison Operators
 
-```bash
+```bash linenums="1"
 (("$a" > "$b"))  # greater than
 (("$a" >= "$b"))   # greater than or equal to
 (("$a" < "$b"))  # less than
@@ -227,7 +227,7 @@ fi
 
 ### String Comparison Operators
 
-```bash
+```bash linenums="1"
 [ "$a" = "$b" ]    # is equal to (whitespace around operator)
 
 [[ $a == z* ]]     # True if $a starts with an "z" (pattern matching)
@@ -246,14 +246,14 @@ fi
 
 ## Commands short circuit evaluation
 
-```bash
+```bash linenums="1"
 command_1 || command_2  # if command_1 fails executes command_2
 command_1 && command_2  # executes command_2 only if command_1 succeeds
 ```
 
 ## Loops
 
-```bash
+```bash linenums="1"
 for var in iterable ; do
     # command here
 done
@@ -261,7 +261,7 @@ done
 
 ## Script Hardening
 
-```sh
+```sh linenums="1"
 set -o errexit  # exit on error
 set -o nounset  # fail on unset variable (bypass with ${VAR:-})
 set -o pipefail  # file entire pipeline if one step fails
diff --git a/docs/languages/c/c.md b/docs/languages/c/c.md
index 54876f0..db70409 100644
--- a/docs/languages/c/c.md
+++ b/docs/languages/c/c.md
@@ -2,7 +2,7 @@
 
 ## Library Import
 
-```c
+```c linenums="1"
 #include <stdio.h>  // search in current + system directories
 #include "lib.h" // search in current directory
 ```
@@ -22,7 +22,7 @@ Can be omitted and replaced by namespace`::`
 
 ## Main Function
 
-```c
+```c linenums="1"
 int main(int argc, char *argv[]) { }
 ```
 
@@ -30,14 +30,14 @@ int main(int argc, char *argv[]) { }
 
 ### Constant Declaration
 
-```c
+```c linenums="1"
 #define constant_name value
 const type constant_name = value;
 ```
 
 ### Variable Declaration
 
-```c
+```c linenums="1"
 type var_name = value;    //c-like initialization
 type var_name (value);    //constructor initialization
 type var_name {value};    //uniform initialization
@@ -124,7 +124,7 @@ Escape Character   | Character
 
 ### Standard Output
 
-```c
+```c linenums="1"
 #include <stdio.h>
 
 printf_s("text %<fmt_spec>", variable);
@@ -132,13 +132,13 @@ printf_s("text %<fmt_spec>", variable);
 
 ### Standard Input
 
-```c
+```c linenums="1"
 #include <stdio.h>
 
 scanf_s("%<fmt_spec>", &variable);    //return number of successfully accepted inputs
 ```
 
-### Format Specifiers %[width].[length][specifier]
+### Format Specifiers `%[width].[length][specifier]`
 
 Specifier   | Specified Format
 ------------|-----------------------------------------
@@ -236,7 +236,7 @@ a `>>=` b   | a = a >> b
 
 ### Mathematical Functions
 
-```c
+```c linenums="1"
 #include <cmath>
 
 abs(x);    // absolute value
@@ -263,7 +263,7 @@ tanh(x);    //hyperbolic tan(X)
 
 ### Character Functions
 
-```c
+```c linenums="1"
 isalnum(c);    //true if c is alphanumeric
 isalpha(c);    //true if c is a letter
 isdigit(c);    //true if char is 0 1 2 3 4 5 6 7 8 9
@@ -283,7 +283,7 @@ toupper(c);    //transform character in uppercase
 
 ### String Functions
 
-```c
+```c linenums="1"
 strlen(string);    //return length (num of chars) of the string
 strcat(destination, source);    //appends chars of string2 to string1
 strncat(string1, string2, nchar);    //appends the first n chars of string 2 to string1
@@ -301,7 +301,7 @@ strpbrk(string, charSet);    //Returns a pointer to the first occurrence of any
 
 ### String Conversion
 
-```c
+```c linenums="1"
 atof(string);    //converts string in double if possible
 atoi(string);    //converts string in integer if possible
 atol(string);    //converts string in long if possible
@@ -309,7 +309,7 @@ atol(string);    //converts string in long if possible
 
 ### String Methods
 
-```C++
+```C linenums="1"++
 string.at(pos);    // returns char at index pos
 string.substr(start, end);    // returns substring between indexes START and END
 string.c_str();    //reads string char by char
@@ -318,7 +318,7 @@ string.find(substring);    // The zero-based index of the first character in str
 
 ## Vectors
 
-```c
+```c linenums="1"
 #include <vector>
 vector<type> vector_name = {values};    //variable length array
 ```
@@ -327,7 +327,7 @@ vector<type> vector_name = {values};    //variable length array
 
 ### If Statements
 
-```c
+```c linenums="1"
 if (condition) { }
 
 if (condition) 
@@ -346,7 +346,7 @@ else
 
 ### Switch
 
-```c
+```c linenums="1"
 switch (expression) {
     case constant_1:
         //code here
@@ -365,7 +365,7 @@ switch (expression) {
 
 ### While Loop
 
-```c
+```c linenums="1"
 while (condition) {
     //code here
 }
@@ -373,7 +373,7 @@ while (condition) {
 
 ### Do While
 
-```c
+```c linenums="1"
 do {
     //code here
 } while (condition);
@@ -381,7 +381,7 @@ do {
 
 ### For Loop
 
-```c
+```c linenums="1"
 for (initialization; condition; increase) {
     //code here
 }
@@ -401,7 +401,7 @@ Functions **must** be declared **before** the main function.
 It is possible to declare functions **after** the main only if the *prototype* is declared **before** the main.  
 To return multiple variables those variables can be passed by reference so that their values is adjourned in the main.
 
-```c
+```c linenums="1"
 type function_name(type argument1, ...); // function prototype
 
 type functionName (parameters) {
@@ -416,7 +416,7 @@ void functionName (parameters) { }
 Passing arguments by reference causes modifications made inside the function to be propagated to the values outside.  
 Passing arguments by values copies the values to the arguments: changes remain inside the function.  
 
-```c
+```c linenums="1"
 type functionName (type &argument1, ...) {
     //code here
     return <expression>;
@@ -430,7 +430,7 @@ type functionName (type &argument1, ...) {
 Passing arguments by reference causes modifications made inside the function to be propagated to the values outside.  
 Passing arguments by values copies the values to the arguments: changes remain inside the function.
 
-```c
+```c linenums="1"
 type function_name (type *argument_1, ...) {
     instructions;
     return <expression>;
@@ -441,7 +441,7 @@ type function_name (type *argument_1, ...) {
 
 ## Arrays
 
-```c
+```c linenums="1"
 type arrayName[dimension];    //array declaration
 type arrayName[dimension] = {value1, value2, ...};    //array declaration & initialization, values number must match dimension
 
@@ -454,7 +454,7 @@ array[index] = value;    //value assignment at position index
 The dimension is not specified because it is determined by the passed array.  
 The array is passed by reference.
 
-```c
+```c linenums="1"
 type function(type array[]){
     //code here
 }
@@ -469,14 +469,14 @@ function(array);    //array passed w/out square brackets []
 
 ### Multi-Dimensional Array (Matrix)
 
-```c
+```c linenums="1"
 type matrix[rows][columns];
 matrix[i][j]    //element A_ij of the matrix
 ```
 
 ### Matrix as function parameter
 
-```c
+```c linenums="1"
 //matrix passed by reference, second dimension is mandatory
 type function(type matrix[][columns]){
     //code here
@@ -496,7 +496,7 @@ type function(type matrix[][dim2]...[dimN]){
 
 ### Struct Definition
 
-```c
+```c linenums="1"
 struct Struct {
     type field1;
     type field2;
@@ -512,7 +512,7 @@ variable.field    // field access
 
 Pointers hold memory addresses of declared variables, they should be initialized to NULL.
 
-```c
+```c linenums="1"
 type *pointer = &variable;     //pointer init and assignment
 type *pointer = NULL;
 type *pointer = otherPointer;
@@ -523,7 +523,7 @@ type **pointerToPointer = &pointer;    // pointerToPointer -> pointer -> variabl
 pointer type and variable type **must** match.  
 (*) --> "value pointed to by"
 
-```c
+```c linenums="1"
 pointer    //address of pointed value (value of variable)
 *pointer    //value of pointed variable
 **pointer //value pointed by *pointer (pointer to pointer)
@@ -531,7 +531,7 @@ pointer    //address of pointed value (value of variable)
 
 ### Pointer to array
 
-```c
+```c linenums="1"
 type *pointer;
 type array[dim] = {};
 
@@ -542,7 +542,7 @@ pointer++;    //change pointed value to successive "cell" of array
 
 ### Pointers, Arrays & Functions
 
-```c
+```c linenums="1"
 func(array)    //pass entire array to function (no need to use (&) to extract address)
 
 type func(type* array){
@@ -552,7 +552,7 @@ type func(type* array){
 
 ### Pointer to Struct
 
-```c
+```c linenums="1"
 (*structPointer).field    //access to field value
 structPointer->structField    //access to field value
 ```
@@ -576,7 +576,7 @@ Every node is composed by two parts:
 A **Stack** is a list in with nodes can be extracted from one *side* only (*LIFO*).
 The extraction of an item from the *top* is called **pop**
 
-```c
+```c linenums="1"
 // node structure
 struct Node {
     type value;
@@ -586,7 +586,7 @@ struct Node {
 
 #### Node Insertion
 
-```c
+```c linenums="1"
 Node *stackNode;    //current node
 Node* head = NULL;    //pointer to head of stack
 
@@ -603,7 +603,7 @@ head = stackNode;    //update head to point to new first node
 
 #### Node Deletion
 
-```c
+```c linenums="1"
 stackNode = head->next;    //memorize location of second node
 free(head);    //delete first node
 head = stackNode;    //update head to point to new first node
@@ -611,7 +611,7 @@ head = stackNode;    //update head to point to new first node
 
 #### Passing Head To Functions
 
-```c
+```c linenums="1"
 type function(Node** head)    //value of head passed by address (head is Node*)
 {
     *head = ...    //update value of head (pointed variable/object/Node)
@@ -644,7 +644,7 @@ C does not automatically free allocated memory when nodes are deleted. It must b
 * `malloc()` returns a void pointer if the allocation is successful.
 * `free()` frees the memory
 
-```C
+```C linenums="1"
 list *pointer = (list*)malloc(sizeof(list));    //memory allocation
 free(pointer)    //freeing of memory
 ```
@@ -666,7 +666,7 @@ The available classes in C++ to operate on files are:
 
 Filename can be string literal or CharArray (use `c_str()`).
 
-```c
+```c linenums="1"
 ifstream file;
 file.open("filename");    //read from file
 
diff --git a/docs/languages/css/css.md b/docs/languages/css/css.md
index 1f5ccd7..4366e95 100644
--- a/docs/languages/css/css.md
+++ b/docs/languages/css/css.md
@@ -4,7 +4,7 @@
 
 ### Inline CSS
 
-```html
+```html linenums="1"
 <tag style="property:value"></tag>
 ```
 
@@ -14,7 +14,7 @@ Not recommended except in cases where choices are constrained.
 
 ### Embedded CSS
 
-```html
+```html linenums="1"
 <head>
     <style>
         selector {
@@ -40,7 +40,7 @@ Not Recommended, only use when the number of rules is small and there are constr
 
 ### External CSS
 
-```html
+```html linenums="1"
 <head>
     <link rel="stylesheet" href="style.css">
 </head>
@@ -54,7 +54,7 @@ Easier to maintain, especially in larger projects.
 
 The selector points to the html element to style.
 
-```css
+```css linenums="1"
 selector {property: value; property: value}
 
 selector {
@@ -65,7 +65,7 @@ selector {
 
 ### Multiple Selectors
 
-```css
+```css linenums="1"
 selector1, selector2 {property: value;}
 ```
 
@@ -73,7 +73,7 @@ selector1, selector2 {property: value;}
 
 Used to select tags nested inn other tags.
 
-```css
+```css linenums="1"
 outerSelector innerSelector {property: value;}
 ```
 
@@ -81,7 +81,7 @@ outerSelector innerSelector {property: value;}
 
 Should apply to one element on a page.
 
-```css
+```css linenums="1"
 #selector {property: value;}    /* selects <tag id="selector"> */
 ```
 
@@ -89,13 +89,13 @@ Should apply to one element on a page.
 
 Many elements can have the same class, classes are used to group HTML elements together.
 
-```css
+```css linenums="1"
 .selector {property: value;}    /* selects <tag class="selector"> */
 ```
 
 ### Universal Selector
 
-```css
+```css linenums="1"
 * {property: value;}    /* selects every HTML element */
 ```
 
@@ -107,11 +107,11 @@ A CSS selector  can contain more than one basic selector.
 
 Selects an element that resides anywhere within an identified ancestor element.
 
-```css
+```css linenums="1"
 article h2 { property: value; }
 ```
 
-```html
+```html linenums="1"
 <!-- Will NOT match -->
 <h2>title</h2>
 <article>
@@ -128,11 +128,11 @@ article h2 { property: value; }
 
 Selects an elements that resides immediately inside an identified parent element.
 
-```css
+```css linenums="1"
 article > p { property: value; }
 ```
 
-```html
+```html linenums="1"
 <!-- Will NOT match -->
 <p>Lorem ipsum dolor sit amet</p>
 <article>
@@ -150,11 +150,11 @@ article > p { property: value; }
 Selects an element that follows anywhere after the prior element.  
 Both elements share the same parent.
 
-```css
+```css linenums="1"
 h2 ~ p { property: value; }
 ```
 
-```html
+```html linenums="1"
 <section>
     <!-- Will NOT match -->
     <p>Lorem ipsum dolor sit amet</p>
@@ -177,11 +177,11 @@ h2 ~ p { property: value; }
 Selects an element that follows directly after the prior element.  
 Both elements share the same parent.
 
-```css
+```css linenums="1"
 h2 + p { property: value; }
 ```
 
-```html
+```html linenums="1"
 <section>
     <!-- Will NOT match -->
     <p>Lorem ipsum dolor sit amet</p>
@@ -209,7 +209,7 @@ Select elements based on whether an attribute is present and what it's value may
 
 `a[target]{ property: value; }` will match
 
-```html
+```html linenums="1"
 <a href="#" target="_blank">click here</a>
 ```
 
@@ -217,7 +217,7 @@ Select elements based on whether an attribute is present and what it's value may
 
 `a[href="https://google.com"] { property: value; }` will match
 
-```html
+```html linenums="1"
 <a href="http://google.com/">search on google</a>
 ```
 
@@ -225,7 +225,7 @@ Select elements based on whether an attribute is present and what it's value may
 
 `a[href*="login"] { property: value; }` will match
 
-```html
+```html linenums="1"
 <a href="/login.php">login page</a>
 ```
 
@@ -233,7 +233,7 @@ Select elements based on whether an attribute is present and what it's value may
 
 `a[href^="Https://"] { property: value; }` will match
 
-```html
+```html linenums="1"
 <a href="https://www.bbc.com/">The BBC</a>
 ```
 
@@ -241,7 +241,7 @@ Select elements based on whether an attribute is present and what it's value may
 
 `a[href$=".pdf"] { property: value; }`
 
-```html
+```html linenums="1"
 <!-- WILL match -->
 <a href="/docs/menu.pdf">download menu</a>
 <!-- Will NOT match -->
@@ -252,7 +252,7 @@ Select elements based on whether an attribute is present and what it's value may
 
 `img[alt~="child"] { property: value; }`
 
-```html
+```html linenums="1"
 <!-- WILL match -->
 <img src="child.jpg" alt='a small child'>
 <!-- Will NOT match -->
@@ -265,7 +265,7 @@ Select elements based on whether an attribute is present and what it's value may
 
 `p[lang|="en"] { property: value; }`
 
-```html
+```html linenums="1"
 <!-- WILL match -->
 <p lang="en">English</p>
 <!-- WILL match -->
@@ -278,7 +278,7 @@ Select elements based on whether an attribute is present and what it's value may
 
 Pseudo-classes can style elements based on their current state. They must be specified after the base case.
 
-```css
+```css linenums="1"
 selector:pseudo-class { property: value; }
 ```
 
@@ -337,7 +337,7 @@ When used within selectors allow unique parts of the page to be stylized. Only o
 `selector::after {...}` creates a pseudo-element after, or behind, the selected element.  
 **These pseudo-elements appear nested within the selected element, not outside of it.**
 
-```css
+```css linenums="1"
 a::after/before {
     property: value;
     content: " (" attr(attribute_name) ")";
@@ -385,7 +385,7 @@ a::after/before {
 
 The color property changes the color of the text,
 
-```css
+```css linenums="1"
 selector {
     color: color-name;
     color: #<hex-digits>;
@@ -401,7 +401,7 @@ selector {
 - All background definitions are optional, but at least one must be stated
 - Default values are given to background if some are not defined
 
-```css
+```css linenums="1"
 selector {
     background:
          url('texture.jpg') /* image */
@@ -454,7 +454,7 @@ Specifies whether the background image should scroll with the page or be fixed
 
 The font family defines which font is used. When listing multiple fonts, always  list a generic name last.
 
-```css
+```css linenums="1"
 selector {
     /* specific font name */
     font-family: "Font Name";
@@ -473,14 +473,14 @@ selector {
 
 In `page.html`:
 
-```html
+```html linenums="1"
 <!-- Google Font -->
 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=FontFamily&display=swap">
 ```
 
 In `style.css`:
 
-```css
+```css linenums="1"
 selector {
     font-family: 'Font Name';
 }
@@ -488,7 +488,7 @@ selector {
 
 ### Font Size
 
-```css
+```css linenums="1"
 selector {
     font-size: 11px;  /* pixels */
     font-size: 1.5em;
@@ -498,7 +498,7 @@ selector {
 
 ### Fonts (shorthand)
 
-```css
+```css linenums="1"
 selector {
     font-style: italic;
     font-weight: bold;
@@ -514,7 +514,7 @@ selector {
 
 ### Text Decoration & Text Align
 
-```css
+```css linenums="1"
 selector {
     text-decoration: line color style thickness;
     text-align: alignment;
@@ -544,7 +544,7 @@ selector {
 Sets the width of a block-level element or img; does not work for inline elements (unless their display property is changed).  
 Accepts a variety of length units.
 
-```css
+```css linenums="1"
 selector {
     width: 200px;
     width: 20em ;   /* relative to font size */
@@ -558,7 +558,7 @@ selector {
 Sets the height of a block-level element or img; does not work for inline elements (unless their display property is changed).  
 Accepts a variety of length units.
 
-```css
+```css linenums="1"
 selector {
     height: 200px;
     height: 20em ;    /* relative to font size */
@@ -571,7 +571,7 @@ selector {
 
 The aspect-ratio  CSS property sets a preferred aspect ratio for the box, which will be used in the calculation of auto sizes and some other layout functions.
 
-```css
+```css linenums="1"
 selector {
     aspect-ratio: <width> / <height>;
 }
@@ -583,7 +583,7 @@ Set upper or lower limits to the size of elements.
 An element cannot be smaller than its `min-width` or `min-height`.  
 An element cannot be larger than its `max-width` or `max-height`.
 
-```css
+```css linenums="1"
 selector {
     max-width: 100%;    /* may be no wider than the containing element */
     width: 30%;    /* will be 30% of the width of the containing element */
@@ -613,7 +613,7 @@ Only use `!important` when:
 - overriding foreign CSS (e.g. from a library)
 - overriding inline CSS
 
-```css
+```css linenums="1"
 selector[style*="property:value"] {
     property: value !important;
 }
@@ -652,7 +652,7 @@ Space between the border and the content.
 
 It's possible to specify the padding for each side of the element:
 
-```css
+```css linenums="1"
 selector {
     padding-top: 15px;
     padding-right: 10%;
@@ -663,7 +663,7 @@ selector {
 
 #### Padding shortcuts
 
-```css
+```css linenums="1"
 selector {
     padding: top right bottom left;  /* Four values (TRBL) */
     padding: top right/left bottom;  /* Three values (T/TL/B) */
@@ -678,7 +678,7 @@ selector {
 
 Borders are specified as "thickness, style, color".
 
-```css
+```css linenums="1"
 selector {
     border-width: 10px;
     border-style: dashed;
@@ -690,7 +690,7 @@ selector {
 
 #### Border shortcuts
 
-```css
+```css linenums="1"
 selector {
     border: thickness style color;
 }
@@ -702,7 +702,7 @@ selector {
 
 Defines whether the width and height (and min/max) of an element should include padding and borders or not.
 
-```css
+```css linenums="1"
 selector {
     box-sizing: content-box;    /* Border and padding are not included */
     box-sizing: border-box;    /* Include the content, padding and border */
@@ -713,7 +713,7 @@ selector {
 
 Universal Box Sizing with Inheritance
 
-```css
+```css linenums="1"
 html {
     box-sizing: border-box;
 }
@@ -730,7 +730,7 @@ Transparent area around the box that separates it from other elements.
 
 It's possible to specify the margin for each side of the element:
 
-```css
+```css linenums="1"
 selector {
     padding-top: 15px;
     padding-right: 10%;
@@ -741,7 +741,7 @@ selector {
 
 #### Margin shortcuts
 
-```css
+```css linenums="1"
 selector {
     margin: top right bottom left;  /* Four values (TRBL) */
     margin: top right/left bottom;  /* Three values (T/TL/B) */
@@ -756,7 +756,7 @@ selector {
 
 If a margin is set to auto on a box that has width it will take up as much space as possible.
 
-```css
+```css linenums="1"
 selector {
     /* Centered */
     margin: 0 auto;
@@ -779,7 +779,7 @@ Top and bottom margins of near elements are collapsed into a single margin that
 
 ### Display Property
 
-```css
+```css linenums="1"
 div {
     display: inline; /* Default of all elements, unless UA (user agent) stylesheet overrides */
     display: block; /* block is default for elements like <div> and <section>*/
@@ -841,7 +841,7 @@ It's possible to specify whether an element is floated or not and which side it
 
 To place two block level elements to be side by side float both elements, one left and one right.
 
-```css
+```css linenums="1"
 .float-child-left {
     float: left;
     width: 200px;
@@ -862,7 +862,7 @@ appear.
 
 Clearing both ensures the element doesn't wrap next to floats on either side.
 
-```css
+```css linenums="1"
 selector {
     clear: right;
     clear: left;
@@ -879,7 +879,7 @@ Static elements ignore top, bottom, right, or left property specifications.
 In normal flow block elements flow from top to bottom making a new line after every element.
 In normal flow inline elements flow from left to right wrapping to next line when needed.
 
-```css
+```css linenums="1"
 selector {
     position: static;
 }
@@ -891,7 +891,7 @@ Takes the element out of the normal flow, allowing it to be moved in relation to
 Makes an element a "positioning context" in which to position other elements relative to it.  
 The relative value will still put the element in the normal flow, but then offset it according to top, bottom, right and left properties.
 
-```css
+```css linenums="1"
 selector {
     position: relative;
 }
@@ -904,7 +904,7 @@ An absolutely positioned element is offset from its container block, set with th
 Its container block is the first surrounding element that has any position other than static.  
 If no such element is found, the container block is `<html>`.
 
-```css
+```css linenums="1"
 selector {
     position: absolute;
 }
@@ -915,7 +915,7 @@ selector {
 The fixed value takes an element out of the normal flow, it positions it relative to the viewport.  
 Parent positioning will no longer affect fixed elements.
 
-```css
+```css linenums="1"
 selector {
     position: fixed;
 }
@@ -926,7 +926,7 @@ selector {
 Sticky positioning is a hybrid of relative and fixed positioning.  
 The element is treated as relative positioned until it crosses a specified threshold, at which point it is treated as fixed positioned.
 
-```css
+```css linenums="1"
 selector {
     position: sticky;
     position: -webkit-sticky;
@@ -945,7 +945,7 @@ When elements overlap, the order of overlapping can be changed with z-index:
 
 **Nesting is important**: if element *B* is on top of element *A*, a child of element *A* can never be higher than element *B*.
 
-```css
+```css linenums="1"
 selector {
     z-index: <int>;
 }
@@ -953,7 +953,7 @@ selector {
 
 ### [Grid](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Grid_Layout)
 
-```css
+```css linenums="1"
 selector {
     display: grid;
     grid-template-columns: 1fr 1fr 1fr;  /* 3 equal columns */
@@ -970,7 +970,7 @@ The `clamp()` function can be used anywhere a `<length>`, `<frequency>`, `<angle
 
 clamp(MIN, VAL, MAX) is resolved as max(MIN, min(VAL, MAX))
 
-```css
+```css linenums="1"
 selector {
     length: clamp(MIN, VAL, MAX)  /* is resolved as max(MIN, min(VAL, MAX)) */
 }
@@ -978,7 +978,7 @@ selector {
 
 ### Var & Variables
 
-```css
+```css linenums="1"
 :root {
     /* define variables on :root element */
     --variable: value;
@@ -1094,7 +1094,7 @@ Some of the most common widths used:
 
 Example of *Bootstrap* (front-end framework) breakpoints:
 
-```css
+```css linenums="1"
 /* Extra small devices (portrait phones, less than 576px) */
 /* No media query for `xs` since this is the default in Bootstrap */
 /* Small devices (landscape phones, 576px and up) */
@@ -1133,7 +1133,7 @@ A media query is a logical expression: true or false; if a media query is true,
 | `screen` | computer screens, tablets, smart-phones, etc |
 | `speech` | screen readers that "reads" the page out loud |
 
-```css
+```css linenums="1"
 @media type operator (feature) {
     selector {
         /* css rule */
@@ -1168,14 +1168,14 @@ A media query is a logical expression: true or false; if a media query is true,
 
 It's possible to specify a media attribute in the link element. This applies a whole stylesheet when the condition is true. Possible to do but preferable to specify a single stylesheet with individual media queries.
 
-```html
+```html linenums="1"
 <link rel="stylesheet" media="screen and (min-width: 900px)" href="widescreen.css">
 <link rel="stylesheet" media="screen and (max-width: 600px)" href="smallscreen.css">
 ```
 
 It's also possible to have different stylesheets based on media type. This might make sense for some use cases.
 
-```html
+```html linenums="1"
 <link rel="stylesheet" type="text/css" href="screen.css" media="screen">
 <link rel="stylesheet" type="text/css" href="print.css" media="print">
 ```
diff --git a/docs/languages/dotnet/asp.net/blazor.md b/docs/languages/dotnet/asp.net/blazor.md
index f12f55a..e08150b 100644
--- a/docs/languages/dotnet/asp.net/blazor.md
+++ b/docs/languages/dotnet/asp.net/blazor.md
@@ -18,7 +18,7 @@ The component class is usually written in the form of a Razor markup page with a
 
 [Blazor Components](https://docs.microsoft.com/en-us/aspnet/core/blazor/components/)
 
-```cs
+```cs linenums="1"
 @page "/route/{RouteParameter}"  // make component accessible from a URL
 @page "/route/{RouteParameter?}"  // specify route parameter as optional
 @page "/route/{RouteParameter:<type>}"  // specify route parameter type
@@ -59,7 +59,7 @@ The component class is usually written in the form of a Razor markup page with a
 
 It's now possible to pass state when navigating in Blazor apps using the `NavigationManager`.
 
-```cs
+```cs linenums="1"
 navigationManager.NavigateTo("/<route>", new NavigationOptions { HistoryEntryState = value });
 ```
 
@@ -67,12 +67,12 @@ This mechanism allows for simple communication between different pages. The spec
 
 ### Blazor WASM
 
-```cs
+```cs linenums="1"
 // setup state singleton
 builder.Services.AddSingleton<StateContainer>();
 ```
 
-```cs
+```cs linenums="1"
 // StateContainer singleton
 using System;
 
@@ -96,7 +96,7 @@ public class StateContainer
 }
 ```
 
-```cs
+```cs linenums="1"
 // component that changes the state
 @inject StateContainer State
 
@@ -113,7 +113,7 @@ public class StateContainer
 }
 ```
 
-```cs
+```cs linenums="1"
 // component that should be update on state change
 @implements IDisposable
 @inject StateContainer State
@@ -139,7 +139,7 @@ public class StateContainer
 
 ## Data Binding & Events
 
-```cs
+```cs linenums="1"
 <p>
     <button @on{DOM EVENT}="{DELEGATE}" />
     <button @on{DOM EVENT}="{DELEGATE}" @on{DOM EVENT}:preventDefault />  // prevent default action
@@ -186,7 +186,6 @@ public class StateContainer
 ```
 
 > **Note**: When a user provides an unparsable value to a data-bound element, the unparsable value is automatically reverted to its previous value when the bind event is triggered.
-
 > **Note**: The `@bind:get` and `@bind:set` modifiers are always used together.  
 > `The @bind:get` modifier specifies the value to bind to and the `@bind:set` modifier specifies a callback that is called when the value changes
 
@@ -199,7 +198,7 @@ public class StateContainer
 
 To render a Blazor component from JavaScript, first register it as a root component for JavaScript rendering and assign it an identifier:
 
-```cs
+```cs linenums="1"
 // Blazor Server
 builder.Services.AddServerSideBlazor(options =>
 {
@@ -212,7 +211,7 @@ builder.RootComponents.RegisterForJavaScript<Counter>(identifier: "counter");
 
 Load Blazor into the JavaScript app (`blazor.server.js` or `blazor.webassembly.js`) and then render the component from JavaScript into a container element using the registered identifier, passing component parameters as needed:
 
-```js
+```js linenums="1"
 let containerElement = document.getElementById('my-counter');
 await Blazor.rootComponents.add(containerElement, 'counter', { incrementAmount: 10 });
 ```
@@ -224,6 +223,6 @@ Custom elements use standard HTML interfaces to implement custom HTML elements.
 
 To create a custom element using Blazor, register a Blazor root component as custom elements like this:
 
-```cs
+```cs linenums="1"
 options.RootComponents.RegisterAsCustomElement<Counter>("my-counter");
 ```
diff --git a/docs/languages/dotnet/asp.net/filters.md b/docs/languages/dotnet/asp.net/filters.md
index f9af4fe..5645381 100644
--- a/docs/languages/dotnet/asp.net/filters.md
+++ b/docs/languages/dotnet/asp.net/filters.md
@@ -85,7 +85,7 @@ Filter attributes:
 
 ## **Filter scopes**
 
-A filter can be added to the pipeline at one of three *scopes*:
+A filter can be added to the pipeline at one of three _scopes_:
 
 - Using an attribute on a controller action. Filter attributes cannot be applied to Razor Pages handler methods.
 
@@ -124,14 +124,14 @@ builder.Services.AddControllersWithViews(options =>
 
 When there are multiple filters for a particular stage of the pipeline, scope determines the default order of filter execution. Global filters surround class filters, which in turn surround method filters.
 
-As a result of filter nesting, the *after* code of filters runs in the reverse order of the *before* code. The filter sequence:
+As a result of filter nesting, the _after_ code of filters runs in the reverse order of the _before_ code. The filter sequence:
 
-- The *before* code of global filters.
-  - The *before* code of controller and Razor Page filters.
-    - The *before* code of action method filters.
-    - The *after* code of action method filters.
-  - The *after* code of controller and Razor Page filters.
-- The *after* code of global filters.
+- The _before_ code of global filters.
+  - The _before_ code of controller and Razor Page filters.
+    - The _before_ code of action method filters.
+    - The _after_ code of action method filters.
+  - The _after_ code of controller and Razor Page filters.
+- The _after_ code of global filters.
 
 ### Cancellation and Short-Circuiting
 
@@ -156,7 +156,7 @@ public class ShortCircuitingResourceFilterAttribute : Attribute, IResourceFilter
 
 ## Dependency Injection
 
-Filters can be added _by type_ or _by instance_. If an instance is added, that instance is used for every request. If a type is added, it's type-activated. 
+Filters can be added _by type_ or _by instance_. If an instance is added, that instance is used for every request. If a type is added, it's type-activated.
 
 A type-activated filter means:
 
diff --git a/docs/languages/dotnet/asp.net/middleware.md b/docs/languages/dotnet/asp.net/middleware.md
index 9772fc1..29e5673 100644
--- a/docs/languages/dotnet/asp.net/middleware.md
+++ b/docs/languages/dotnet/asp.net/middleware.md
@@ -33,7 +33,7 @@ Short-circuiting is often desirable because it avoids unnecessary work.
 
 It's possible to perform actions both *before* and *after* the next delegate:
 
-```cs
+```cs linenums="1"
 // "inline" middleware, best if in own class
 app.Use(async (context, next) =>
 {
@@ -45,7 +45,7 @@ app.Use(async (context, next) =>
 
 `Run` delegates don't receive a next parameter. The first `Run` delegate is always terminal and terminates the pipeline.
 
-```cs
+```cs linenums="1"
 // "inline" middleware, best if in own class
 app.Use(async (context, next) =>
 {
@@ -69,7 +69,7 @@ The Endpoint middleware executes the filter pipeline for the corresponding app t
 
 The order that middleware components are added in the `Startup.Configure` method defines the order in which the middleware components are invoked on requests and the reverse order for the response. The order is **critical** for security, performance, and functionality.
 
-```cs
+```cs linenums="1"
 if (env.IsDevelopment())
 {
     app.UseDeveloperExceptionPage();
@@ -121,7 +121,7 @@ Unlike with `MapWhen`, this branch is rejoined to the main pipeline if it doesn'
 
 Middleware is generally encapsulated in a class and exposed with an extension method.
 
-```cs
+```cs linenums="1"
 public class CustomMiddleware
 {
     private readonly RequestDelegate _next;
@@ -152,7 +152,7 @@ The middleware class **must** include:
 
 ## Middleware Extension Methods
 
-```cs
+```cs linenums="1"
 using Microsoft.AspNetCore.Builder;
 
 public static class MiddlewareExtensions
@@ -164,7 +164,7 @@ public static class MiddlewareExtensions
 }
 ```
 
-```cs
+```cs linenums="1"
 // other middlewares
 
 app.UseCustom();  // add custom middleware in the pipeline
diff --git a/docs/languages/dotnet/asp.net/minimal-api.md b/docs/languages/dotnet/asp.net/minimal-api.md
index 434cd23..d113ee0 100644
--- a/docs/languages/dotnet/asp.net/minimal-api.md
+++ b/docs/languages/dotnet/asp.net/minimal-api.md
@@ -2,7 +2,7 @@
 
 > **Note**: Requires .NET 6+
 
-```cs
+```cs linenums="1"
 var builder = WebApplication.CreateBuilder(args);
 
 builder.Services.AddSingleton<IService, Service>();
@@ -18,7 +18,6 @@ app.Run();
 app.RunAsync();
 ```
 
-
 ## Application Settings
 
 App settings are loaded (in order) from:
@@ -42,7 +41,7 @@ Setting a value is done with `dotnet user-secrets set <key> <value>`, keys can b
 
 ## Swagger
 
-```cs
+```cs linenums="1"
 builder.Services.AddEndpointsApiExplorer();
 builder.Services.AddSwaggerGen();
 
@@ -60,7 +59,7 @@ app.MapPost("/route", Handler).Accepts<Type>(contentType);
 
 ## MVC
 
-```cs
+```cs linenums="1"
 builder.Services.AddControllersWithViews();
 //or
 builder.Services.AddControllers();
@@ -96,7 +95,7 @@ app.MapControllerRoute(
 
 To define routes and handlers using Minimal APIs, use the `Map(Get|Post|Put|Delete)` methods.
 
-```cs
+```cs linenums="1"
 // the dependencies are passed as parameters in the handler delegate
 app.MapGet("/route/{id}", (IService service, int id) => {
     
@@ -113,7 +112,7 @@ IResult Search(int id, int? page = 1, int? pageSize = 10) { /* ... */ }
 The `MapGroup()` extension method, which helps organize groups of endpoints with a common prefix.  
 It allows for customizing entire groups of endpoints with a singe call to methods like `RequireAuthorization()` and `WithMetadata()`.
 
-```cs
+```cs linenums="1"
 var group = app.MapGroup("<route-prefix>");
 
 group.MapGet("/", GetAllTodos);  // route: /<route-prefix>
@@ -127,14 +126,14 @@ group.MapGet("/{id}", GetTodo);  // route: /<route-prefix>/{id}
 The `Microsoft.AspNetCore.Http.TypedResults` static class is the “typed” equivalent of the existing `Microsoft.AspNetCore.Http.Results` class.  
 It's possible to use `TypedResults` in minimal APIs to create instances of the in-framework `IResult`-implementing types and preserve the concrete type information.
 
-```cs
+```cs linenums="1"
 public static async Task<IResult> GetAllTodos(TodoDb db)
 {
     return TypedResults.Ok(await db.Todos.ToArrayAsync());
 }
 ```
 
-```cs
+```cs linenums="1"
 [Fact]
 public async Task GetAllTodos_ReturnsOkOfObjectResult()
 {
@@ -153,7 +152,7 @@ public async Task GetAllTodos_ReturnsOkOfObjectResult()
 
 The `Results<TResult1, TResult2, TResultN>` generic union types, along with the `TypesResults` class, can be used to declare that a route handler returns multiple `IResult`-implementing concrete types.
 
-```cs
+```cs linenums="1"
 // Declare that the lambda returns multiple IResult types
 app.MapGet("/todos/{id}", async Results<Ok<Todo>, NotFound> (int id, TodoDb db)
 {
@@ -165,7 +164,7 @@ app.MapGet("/todos/{id}", async Results<Ok<Todo>, NotFound> (int id, TodoDb db)
 
 ## Filters
 
-```cs
+```cs linenums="1"
 public class ExampleFilter : IRouteHandlerFilter
 {
     public async ValueTask<object?> InvokeAsync(RouteHandlerInvocationContext context, RouteHandlerFilterDelegate next)
@@ -178,7 +177,7 @@ public class ExampleFilter : IRouteHandlerFilter
 }
 ```
 
-```cs
+```cs linenums="1"
 app.MapPost("/route", Handler).AddFilter<ExampleFilter>();
 ```
 
@@ -192,7 +191,7 @@ With Minimal APIs it's possible to access the contextual information by passing
 - `ClaimsPrincipal`
 - `CancellationToken` (RequestAborted)
 
-```cs
+```cs linenums="1"
 app.MapGet("/hello", (ClaimsPrincipal user) => {
     return "Hello " + user.FindFirstValue("sub");
 });
@@ -202,7 +201,7 @@ app.MapGet("/hello", (ClaimsPrincipal user) => {
 
 The `Microsoft.AspNetCore.OpenApi` package exposes a `WithOpenApi` extension method that generates an `OpenApiOperation` derived from a given endpoint’s route handler and metadata.
 
-```cs
+```cs linenums="1"
 app.MapGet("/todos/{id}", (int id) => ...)
     .WithOpenApi();
 
@@ -218,7 +217,7 @@ app.MapGet("/todos/{id}", (int id) => ...)
 Using [Minimal Validation](https://github.com/DamianEdwards/MinimalValidation) by Damian Edwards.  
 Alternatively it's possible to use [Fluent Validation](https://fluentvalidation.net/).
 
-```cs
+```cs linenums="1"
 app.MapPost("/widgets", (Widget widget) => {
     var isValid = MinimalValidation.TryValidate(widget, out var errors);
 
@@ -241,7 +240,7 @@ class Widget
 
 ## JSON Serialization
 
-```cs
+```cs linenums="1"
 // Microsoft.AspNetCore.Http.Json.JsonOptions
 builder.Services.Configure<JsonOptions>(opt =>
 {
@@ -251,7 +250,7 @@ builder.Services.Configure<JsonOptions>(opt =>
 
 ## Authorization
 
-```cs
+```cs linenums="1"
 builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme).AddJwtBearer();
 
 builder.Services.AddAuthorization();
@@ -284,13 +283,13 @@ app.MapGet("/special-secret", () => "This is a special secret!")
 The `user-jwts` tool is similar in concept to the existing `user-secrets` tools, in that it can be used to manage values for the app that are only valid for the current user (the developer) on the current machine.  
 In fact, the `user-jwts` tool utilizes the `user-secrets` infrastructure to manage the key that the JWTs will be signed with, ensuring it’s stored safely in the user profile.
 
-```sh
+```sh linenums="1"
 dotnet user-jwts create  # configure a dev JWT fot the current user
 ```
 
 ## Output Caching
 
-```cs
+```cs linenums="1"
 builder.Services.AddOutputCaching();  // no special options
 builder.Services.AddOutputCaching(options => 
 {
@@ -322,7 +321,7 @@ app.MapGet("/<route>", [OutputCache(/* options */)]RouteHandler);
 
 ### Cache Eviction
 
-```cs
+```cs linenums="1"
 
 app.MapGet("/<route-one>", RouteHandler).CacheOutput(x => x.Tag("<tag>"));  // tag cache portion
 
@@ -334,11 +333,11 @@ app.MapGet("/<route-two>", (IOutputCacheStore cache, CancellationToken token) =>
 
 ### Custom Cache Policy
 
-```cs
+```cs linenums="1"
 app.MapGet("/<route-one>", RouteHandler).CacheOutput(x => x.AddCachePolicy<CustomCachePolicy>());
 ```
 
-```cs
+```cs linenums="1"
 class CustomCachePolicy : IOutputCachePolicy
 {
     public ValueTask CacheRequestAsync(OutputCacheContext context, CancellationToken cancellationToken) { }
@@ -353,7 +352,7 @@ class CustomCachePolicy : IOutputCachePolicy
 
 The *options pattern* uses classes to provide strongly-typed access to groups of related settings.
 
-```json
+```json linenums="1"
 {
     "SecretKey": "Secret key value",
     "TransientFaultHandlingOptions": {
@@ -370,7 +369,7 @@ The *options pattern* uses classes to provide strongly-typed access to groups of
 }
 ```
 
-```cs
+```cs linenums="1"
 // options model for binding
 public class TransientFaultHandlingOptions
 {
@@ -379,13 +378,13 @@ public class TransientFaultHandlingOptions
 }
 ```
 
-```cs
+```cs linenums="1"
 // setup the options
 builder.Services.Configure<TransientFaultHandlingOptions>(builder.Configuration.GetSection<TransientFaultHandlingOptions>(nameof(Options)));
 builder.Services.Configure<TransientFaultHandlingOptions>(builder.Configuration.GetSection<TransientFaultHandlingOptions>(key));
 ```
 
-```cs
+```cs linenums="1"
 class DependsOnOptions
 {
   private readonly IOptions<TransientFaultHandlingOptions> _options;
diff --git a/docs/languages/dotnet/asp.net/razor-syntax.md b/docs/languages/dotnet/asp.net/razor-syntax.md
index 82a0da1..ac9cd1e 100644
--- a/docs/languages/dotnet/asp.net/razor-syntax.md
+++ b/docs/languages/dotnet/asp.net/razor-syntax.md
@@ -2,7 +2,7 @@
 
 ## Markup
 
-```cs
+```cs linenums="1"
 @page  // set this as razor page
 
 @model <App>.Models.Entity  // if MVC set type of elements passed to the view 
@@ -35,7 +35,7 @@
 
 Example:
 
-```html
+```html linenums="1"
 <!-- tag helpers for a lin in ASP.NET MVC -->
 <a class="nav-link text-dark" asp-area="" asp-controller="Home" asp-action="Index">Home</a>
 ```
@@ -44,7 +44,7 @@ Example:
 
 The `@addTagHelper` directive makes Tag Helpers available to the view. Generally, the view file is `Pages/_ViewImports.cshtml`, which by default is inherited by all files in the `Pages` folder and subfolders, making Tag Helpers available.
 
-```cs
+```cs linenums="1"
 @using <App>
 @namespace <App>.Pages  // or <Project>.Models
 @addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
@@ -57,7 +57,7 @@ The first parameter after `@addTagHelper` specifies the Tag Helpers to load (`*`
 
 It's possible to disable a Tag Helper at the element level with the Tag Helper opt-out character (`!`)
 
-```cshtml
+```cshtml linenums="1"
 <!-- disable email validation -->
 <!span asp-validation-for="Email" ></!span>
 ```
@@ -66,7 +66,7 @@ It's possible to disable a Tag Helper at the element level with the Tag Helper o
 
 The `@tagHelperPrefix` directive allows to specify a tag prefix string to enable Tag Helper support and to make Tag Helper usage explicit.
 
-```cshtml
+```cshtml linenums="1"
 @tagHelpersPrefix th:
 ```
 
@@ -74,7 +74,7 @@ The `@tagHelperPrefix` directive allows to specify a tag prefix string to enable
 
 [Understanding Html Helpers](https://stephenwalther.com/archive/2009/03/03/chapter-6-understanding-html-helpers)
 
-```cs
+```cs linenums="1"
 @model <App>.Models.Entity
 
 // Display the name of the property
@@ -112,7 +112,7 @@ The `@tagHelperPrefix` directive allows to specify a tag prefix string to enable
 
 In `ViewModel.cs`:
 
-```cs
+```cs linenums="1"
 class ViewModel 
 {
     public int EntityId { get; set; }  // value selected in form ends up here
@@ -126,7 +126,7 @@ class ViewModel
 
 In `View.cs`
 
-```cs
+```cs linenums="1"
 @model ViewModel
 
 <form asp-controller="Controller" asp-action="PostAction">
@@ -140,7 +140,7 @@ In `View.cs`
 
 In `Controller.cs`:
 
-```cs
+```cs linenums="1"
 public IActionResult GetAction()
 {
     var vm = new ViewModel();
diff --git a/docs/languages/dotnet/asp.net/signalr.md b/docs/languages/dotnet/asp.net/signalr.md
index 26c2a22..7f8c664 100644
--- a/docs/languages/dotnet/asp.net/signalr.md
+++ b/docs/languages/dotnet/asp.net/signalr.md
@@ -8,7 +8,7 @@ The SignalR Hubs API enables to call methods on connected clients from the serve
 
 In `Startup.cs`:
 
-```cs
+```cs linenums="1"
 builder.Services.AddSignalR();
 
 var app = builder.Build();
@@ -21,7 +21,7 @@ app.UseEndpoints(endpoints =>
 
 ### Creating Hubs
 
-```cs
+```cs linenums="1"
 public class CustomHub : Hub
 {
     public task HubMethod(Type args)
@@ -46,7 +46,7 @@ A drawback of using `SendAsync` is that it relies on a magic string to specify t
 
 An alternative to using SendAsync is to strongly type the Hub with `Hub<T>`.
 
-```cs
+```cs linenums="1"
 public interface IHubClient
 {
     // matches method to be called on the client
@@ -54,7 +54,7 @@ public interface IHubClient
 }
 ```
 
-```cs
+```cs linenums="1"
 public class CustomHub : Hub<IHubClient>
 {
     public Task HubMethod(Type args)
@@ -72,7 +72,7 @@ Using a strongly typed `Hub<T>` disables the ability to use `SendAsync`. Any met
 
 The SignalR Hubs API provides the OnConnectedAsync and OnDisconnectedAsync virtual methods to manage and track connections. Override the OnConnectedAsync virtual method to perform actions when a client connects to the Hub, such as adding it to a group.
 
-```cs
+```cs linenums="1"
 public override async Task OnConnectedAsync()
 {
     await Groups.AddToGroupAsync(Context.ConnectionId, "GroupName");
@@ -98,7 +98,7 @@ If the Hub throws an exception, connections aren't closed. By default, SignalR r
 
 If you have an exceptional condition you *do* want to propagate to the client, use the `HubException` class. If you throw a `HubException` from your hub method, SignalR will send the entire message to the client, unmodified.
 
-```cs
+```cs linenums="1"
 public Task ThrowException()
 {
     throw new HubException("This error will be sent to the client!");
@@ -109,7 +109,7 @@ public Task ThrowException()
 
 ### Installing the client package
 
-```sh
+```sh linenums="1"
 npm init -y
 npm install @microsoft/signalr
 ```
@@ -118,7 +118,7 @@ npm installs the package contents in the `node_modules\@microsoft\signalr\dist\b
 
 Reference the SignalR JavaScript client in the `<script>` element. For example:
 
-```html
+```html linenums="1"
 <script src="~/lib/signalr/signalr.js"></script>
 ```
 
@@ -126,7 +126,7 @@ Reference the SignalR JavaScript client in the `<script>` element. For example:
 
 [Reconnect Clients Docs](https://docs.microsoft.com/en-us/aspnet/core/signalr/javascript-client#reconnect-clients)
 
-```js
+```js linenums="1"
 const connection = new signalR.HubConnectionBuilder()
     .withUrl("/hub/endpoint")
     .configureLogging(signalR.LogLevel.Information)
@@ -158,7 +158,7 @@ JavaScript clients call public methods on hubs via the `invoke` method of the `H
 - The name of the hub method.
 - Any arguments defined in the hub method.
 
-```js
+```js linenums="1"
 try {
     await connection.invoke("HubMethod", args);
 } catch (err) {
@@ -177,6 +177,6 @@ To receive messages from the hub, define a method using the `on` method of the `
 - The name of the JavaScript client method.
 - Arguments the hub passes to the method.
 
-```cs
+```cs linenums="1"
 connection.on("ClientMethod", (args) => { /* ... */});
 ```
diff --git a/docs/languages/dotnet/asp.net/web-forms.md b/docs/languages/dotnet/asp.net/web-forms.md
index 1df75dd..30ea018 100644
--- a/docs/languages/dotnet/asp.net/web-forms.md
+++ b/docs/languages/dotnet/asp.net/web-forms.md
@@ -4,7 +4,7 @@
 
 The fist loaded page is `Default.aspx` and its underlying code.
 
-```html
+```html linenums="1"
 <!-- directive -->
 <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Default.aspx.cs" Inherits="Project.Default" %>
 
@@ -26,7 +26,7 @@ The fist loaded page is `Default.aspx` and its underlying code.
 
 ### Page Directive
 
-```cs
+```cs linenums="1"
 <%@ Page Language="C#"  // define language used (can be C# or VB)
     AutoEventWireup="true"  // automatically create and setup event handlers
     CodeBehind="Default.aspx.cs"  // define the underlying code file
@@ -35,7 +35,7 @@ The fist loaded page is `Default.aspx` and its underlying code.
 
 ### Web Controls
 
-```xml
+```xml linenums="1"
 <asp:Control ID="" runat="server" ...></asp:Control>
 
 <!-- Label: empty text will diplay ID, use empty space as text for empty label -->
@@ -59,7 +59,7 @@ The fist loaded page is `Default.aspx` and its underlying code.
 
 ## `Page.aspx.cs`
 
-```cs
+```cs linenums="1"
 public partial class Default : System.Web.UI.Page
 {
     protected void Page_Load(object sender, EventArgs e)
diff --git a/docs/languages/dotnet/csharp/async-programming.md b/docs/languages/dotnet/csharp/async-programming.md
index d01cc58..1d2b78e 100644
--- a/docs/languages/dotnet/csharp/async-programming.md
+++ b/docs/languages/dotnet/csharp/async-programming.md
@@ -14,7 +14,7 @@ In performance-sensitive code, asynchronous APIs are useful, because instead of
 
 The `async` and `await` keywords in C# are the heart of async programming.
 
-```cs
+```cs linenums="1"
 public async Task<TResult> MethodAsync
 {
     Task<TResult> resultTask = obj.OtherMethodAsync();
@@ -90,7 +90,7 @@ Because `Task` and `Task<TResult>` are **reference types**, memory allocation in
 
 ### Async Composition
 
-```cs
+```cs linenums="1"
 public async Task DoOperationsConcurrentlyAsync()
 {
   Task[] tasks = new Task[3];
@@ -132,7 +132,7 @@ If work starting from a UI thread is performed, but there is no particular need
 If the asynchronous operation is a `Task`, `Task<T>`, `ValueTask` or `ValueTask<T>`, it's possible to discard the *synchronization context* by calling the `ConfigureAwait(false)`.  
 This returns a different representation of the asynchronous operation, and if this iss awaited that instead of the original task, it will ignore the current `SynchronizationContext` if there is one.
 
-```cs
+```cs linenums="1"
 private async Task DownloadFileAsync(string fileName)
 {
   await OperationAsync(fileName).ConfigureAwait(false);  // discarding original context
@@ -156,7 +156,7 @@ This is true even of exceptions thrown before the first `await`.
 If the calling method immediately calls `await` on the return task, this won’t matter much—it will see the exception in any case.  
 But some code may choose not to wait immediately, in which case it won’t see the argument exception until later.
 
-```cs
+```cs linenums="1"
 async Task<string> MethodWithValidationAsync(string argument)
 {
   if(sting.IsNullOrEmpty(argument))
@@ -173,7 +173,7 @@ async Task<string> MethodWithValidationAsync(string argument)
 In cases where you want to throw this kind of exception straightaway, the usual technique is to write a normal method that validates the arguments before calling an async method that does the
 work, and to make that second method either private or local.
 
-```cs
+```cs linenums="1"
 // not marked with async, exception propagate directly to caller
 public static Task<string> MethodWithValidationAsync(string argument)
 {
diff --git a/docs/languages/dotnet/csharp/collections.md b/docs/languages/dotnet/csharp/collections.md
index 9865621..839770e 100644
--- a/docs/languages/dotnet/csharp/collections.md
+++ b/docs/languages/dotnet/csharp/collections.md
@@ -6,7 +6,7 @@ An array is an object that contains multiple elements of a particular type. The
 
 An array type is always a reference type, regardless of the element type. Nonetheless, the choice between reference type and value type elements makes a significant difference in an array's behavior.
 
-```cs
+```cs linenums="1"
 type[] array = new type[dimension];
 type array[] = new type[dimension];  //invalid
 
@@ -24,7 +24,7 @@ array.OfType<Type>();  // filter array based on type, returns IEnumerable<Type>
 
 ### [Array Methods](https://docs.microsoft.com/en-us/dotnet/api/system.array?view=netcore-3.1#methods)
 
-```cs
+```cs linenums="1"
 // overloaded search methods
 Array.IndexOf(array, item);  // return index of searched item in passed array
 Array.LastIndexOf(array, item); // return index of searched item staring from the end of the array
@@ -54,7 +54,7 @@ C# supports two multidimensional array forms: [jagged][jagg_arrays] arrays and [
 [jagg_arrays]: https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/arrays/jagged-arrays
 [rect_arrays]: https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/arrays/multidimensional-arrays
 
-```cs
+```cs linenums="1"
 //specify first dimension
 type[][] jagged = new type[][]
 {
@@ -87,7 +87,7 @@ matrix.GetLength(int dimension); // get the size of a particular direction
 
 `List<T>` stores sequences of elements. It can grow or shrink, allowing to add or remove elements.
 
-```cs
+```cs linenums="1"
 using System.Collections.Generics;
 
 List<T> list = new List<T>();
@@ -140,7 +140,7 @@ It's possible to use a `yield break` statement or exception to end the iteration
 
 **Note**: Since an iterator returns an `IEnumerable<T>` is can be used to implement a `GetEnumerator()`.
 
-```cs
+```cs linenums="1"
 // simple iterator
 public static System.Collections.IEnumerable<int> IterateRange(int start = 0, int end)
 {
@@ -156,7 +156,7 @@ public static System.Collections.IEnumerable<int> IterateRange(int start = 0, in
 
 Exposes the enumerator, which supports a simple iteration over a collection of a specified type.
 
-```cs
+```cs linenums="1"
 public interface IEnumerable<out T> : IEnumerable
 {
     IEnumerator<T> GetEnumerator();  // return an enumerator
@@ -179,7 +179,7 @@ public interface IEnumerator<T>
 
 ### [`ICollection<T>`](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.icollection-1)
 
-```cs
+```cs linenums="1"
 public interface ICollection<T> : IEnumerable<T>
 {
     // properties
@@ -197,7 +197,7 @@ public interface ICollection<T> : IEnumerable<T>
 
 ### [`IList<T>`](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.ilist-1)
 
-```cs
+```cs linenums="1"
 public interface IList<T> : ICollection<T>, IEnumerable<T>
 {
     // properties
@@ -228,7 +228,7 @@ public interface IList<T> : ICollection<T>, IEnumerable<T>
 - Enumerating a dictionary will return `KeyValuePair<TKey, TValue>`.
 - The `Dictionary<TKey, TValue>` collection class relies on hashes to offer fast lookup (`TKey` should have a good `GetHashCode()`).
 
-```cs
+```cs linenums="1"
 Dictionary<TKey, TValue> dict = new Dictionary<TKey, TValue>();  // init empty dict
 Dictionary<TKey, TValue> dict = new Dictionary<TKey, TValue>(IEqualityComparer<TKey>);  // specify key comparer (TKey must implement Equals() and GetHashCode())
 
@@ -270,7 +270,7 @@ dict.TryGetValue(key, out var);  // put the value associated with kay in the var
 
 Collection of non duplicate items.
 
-```cs
+```cs linenums="1"
 HashSet<T> set = new HashSet<T>();
 
 set.Add(T); // adds an item to the set; true if the element is added, false if the element is already present.
diff --git a/docs/languages/dotnet/csharp/csharp.md b/docs/languages/dotnet/csharp/csharp.md
index e41f7be..aa3f436 100644
--- a/docs/languages/dotnet/csharp/csharp.md
+++ b/docs/languages/dotnet/csharp/csharp.md
@@ -18,7 +18,7 @@ to native code later.
 
 ### Comments
 
-```cs
+```cs linenums="1"
 // comment
 /* multi line comment */
 /// single line xml comment (docstring)
@@ -44,7 +44,7 @@ to native code later.
 
 Hierarchic organization of programs an libraries.
 
-```cs
+```cs linenums="1"
 using System;  // import the System Namespace
 using Alias = Namespace;  // set an alias for a specific namespace
 using static System.Console;  // statically import a class to use its static methods w/o qualification
@@ -62,13 +62,13 @@ namespace Namespace  // namespace declaration
 
 To enable .NET 6/C# 10 **implicit namespace imports**:
 
-```xml
+```xml linenums="1"
 <ImplicitUsings>enable</ImplicitUsings>
 ```
 
 ### Top Level Statements/Programs (C# 9)
 
-```cs
+```cs linenums="1"
 // imports
 
 // code here, no main, no namespace
@@ -76,7 +76,7 @@ To enable .NET 6/C# 10 **implicit namespace imports**:
 
 ### Main Method
 
-```cs
+```cs linenums="1"
 public static void Main(string[] args)
 {
     // code here
@@ -85,7 +85,7 @@ public static void Main(string[] args)
 
 ### Constant Declaration
 
-```cs
+```cs linenums="1"
 const type CONSTANT_NAME = value;
 ```
 
@@ -97,7 +97,7 @@ If a variable has not been assigned it assumes the `default` value.
 
 ### Input
 
-```cs
+```cs linenums="1"
 // input is a string, convert before saving in a non String variable
 Console.ReadLines();    // read util <Return>  is pressed
 Console.Read();    // read until space
@@ -115,7 +115,7 @@ Console.ReadKey();    // read a key from keyboard and display pressed kay immedi
 
 ### Screen Output
 
-```cs
+```cs linenums="1"
 Console.WriteLine();    // single line output
 ```
 
@@ -123,7 +123,7 @@ Console.WriteLine();    // single line output
 
 `{index[,alignment][:<formatString><num_decimal_digits>]}`
 
-```cs
+```cs linenums="1"
 Console.WriteLine("Name is {0}, Marks are {1}", name, marks);    // string composite formatting
 Console.WriteLine($"Name is {name}, Marks are {marks}");    // string interpolation
 
@@ -197,7 +197,7 @@ The static fields and methods of the `MathF` class correspond to those of the `M
 `BigInteger` represents an integer that will grow as large as is necessary to accommodate values.  
 Unlike the builtin numeric types, it has no theoretical limit on its range.
 
-```cs
+```cs linenums="1"
 using System;
 using System.Numerics;
 
@@ -209,7 +209,7 @@ BigInteger bi;
 Binary literal: `0b<digits>`
 Hexadecimal literal: `0x<digits>`
 
-```cs
+```cs linenums="1"
 // three variables that store the number 2 million
 int decimalNotation = 2_000_000;
 int binaryNotation = 0b_0001_1110_1000_0100_1000_0000;
@@ -229,19 +229,19 @@ int hexadecimalNotation = 0x_001E_8480;
 
 The compiler determines the required type based on the assigned value.
 
-```cs
+```cs linenums="1"
 var variable = value;  // Inferred tipe cant change after first assignment
 ```
 
 ### Dynamic Type
 
-```cs
+```cs linenums="1"
 dynamic variable = value;
 ```
 
 ### Anonymous types (Reference Type)
 
-```cs
+```cs linenums="1"
 // cannot be used as return types
 var x = new { Key = value, ...};  // read only properties
 x.Key;  // member access
@@ -257,7 +257,7 @@ A [System.Range][range_type] represents a range that has start and end indexes.
 [index_type]: https://docs.microsoft.com/en-us/dotnet/api/system.index
 [range_type]: https://docs.microsoft.com/en-us/dotnet/api/system.range
 
-```cs
+```cs linenums="1"
 Index i = position;
 Index i = new Index(position, IsFromEnd: false);  // start-relative index
 
@@ -285,7 +285,7 @@ Tuples are designed as a convenient way to package together a few values in case
 Tuples support comparison, so it's possible to use the `==` and `!=` relational operators.  
 To be considered equal, two tuples must have the same shape and each value in the first tuple must be equal to its counterpart in the second tuple.
 
-```cs
+```cs linenums="1"
 (Type Var1, Type Var2, ...) variable = (value1, value2, ...);
 var variable = (Var1: value1, Var2: value2, ...);  // if name are not supplied they default to Item1, Item2, ...
 var variable = (var1, var2);  // constructed w/ pre-existing values, tuple attributes named after the variables
@@ -293,14 +293,14 @@ var variable = (var1, var2);  // constructed w/ pre-existing values, tuple attri
 
 Since the names of the attributes of a tuple do not matter (a tuple is an instance of `ValueTuple<Type, Type, ...>`) it's possible to assign any tuple to another tuple with the same structure.
 
-```cs
+```cs linenums="1"
 (int X, Int Y) a = (1 , 0);
 (int Width, int Height) b = a;
 ```
 
 ### Tuple Deconstruction
 
-```cs
+```cs linenums="1"
 (int X, int Y) point = (10, 35);
 (int a, int b) = point;  // extract data based on position into two variables
 ```
@@ -309,7 +309,7 @@ Since the names of the attributes of a tuple do not matter (a tuple is an instan
 
 I'ts possible to create record types with immutable properties by using standard property syntax or positional parameters:
 
-```cs
+```cs linenums="1"
 public record Person
 {
     public string FirstName { get; init; } = default!;
@@ -330,7 +330,7 @@ public readonly record struct Point(double X, double Y, double Z);
 
 it's also possible to create record types with mutable properties and fields:
 
-```cs
+```cs linenums="1"
 // mutable record
 public record Person
 {
@@ -358,7 +358,7 @@ While records can be mutable, they're primarily intended for supporting immutabl
 When working with immutable data, a common pattern is to create new values from existing ones to represent a new state.  
 To help with this style of programming, records allow for a new kind of expression; the with-expression.
 
-```cs
+```cs linenums="1"
 var newRecord = oldRecord with { Property = value };
 ```
 
@@ -366,7 +366,7 @@ With-expressions use object initializer syntax to state what's different in the
 A record implicitly defines a protected "copy constructor", a constructor that takes an existing record object and copies it field by field to the new one.  
 The `with` expression causes the copy constructor to get called, and then applies the object initializer on top to change the properties accordingly.
 
-```cs
+```cs linenums="1"
 protected Record(Record original) { /* copy all the fields */ } // generated
 ```
 
@@ -378,7 +378,7 @@ Records have a hidden virtual method that is entrusted with "cloning" the whole
 Every derived record type overrides this method to call the copy constructor of that type, and the copy constructor of a derived record chains to the copy constructor of the base record.  
 A with-expression simply calls the hidden "clone" method and applies the object initializer to the result.
 
-```cs
+```cs linenums="1"
 public record Base{ Type Prop1, Type Prop2 };
 public record Derived : Base { Type Prop3 };
 
@@ -391,7 +391,7 @@ var newBase = @base with { Prop2 = value };  // new Derived record even if type
 Records have a virtual protected property called `EqualityContract`.  
 Every derived record overrides it, and in order to compare equal, the two objects musts have the same `EqualityContract`.
 
-```cs
+```cs linenums="1"
 public record Base{ Type Prop1, Type Prop2 };
 public record Derived : Base { Type Prop3 };
 
@@ -408,7 +408,7 @@ This creates a lot of extra work for .NET's garbage collector, causing the progr
 
 In these situations, it's possible to can use a type called `StringBuilder`. This is conceptually similar to a string but it is modifiable.
 
-```cs
+```cs linenums="1"
 "string contents here"    // string literal
 @"string contents here"    // verbatim string, escape characters printed as-is (raw string literal)
 $"{variable} contents here"    // string interpolation
@@ -419,7 +419,7 @@ String.Length    // returns the length of the string
 
 ### String Methods (Not In-Place)
 
-```cs
+```cs linenums="1"
 string_.IndexOf(<character/string>, startIndex, endIndex);    // index of first occurrence of character/string, -1 otherwise
 string_.LastIndexOf(<character/string>, startIndex, endIndex);    // index last occurrence of character/string, -1 otherwise
 string_.IndexOfAny(char_array, startIndex, endIndex);    // index of any of the characters in the supplied array
@@ -454,7 +454,7 @@ A raw string literal starts with at least three double-quote (`"""`) characters.
 Typically, a raw string literal uses three double quotes on a single line to start the string, and three double quotes on a separate line to end the string.
 The newlines following the opening quote and preceding the closing quote aren't included in the final content:
 
-```cs
+```cs linenums="1"
 
 string longMessage = """
     This is a long message.
@@ -470,7 +470,7 @@ string longMessage = """
 
 Raw string literals can be combined with _string interpolation_ to include braces in the output text. Multiple `$` characters denote how many consecutive braces start and end the interpolation
 
-```cs
+```cs linenums="1"
 var location = $$"""
     You are at {{{Longitude}}, {{Latitude}}}
     """;
@@ -493,7 +493,7 @@ When a nullable type is boxed, the common language runtime automatically boxes t
 
 If the `HasValue` property of a nullable type is `false`, the result of a boxing operation is `null`. Consequently, if a boxed nullable type is passed to a method that expects an object argument, that method must be prepared to handle the case where the argument is `null`. When `null` is unboxed into a nullable type, the common language runtime creates a new `Nullable<T>` structure and initializes its `HasValue` property to `false`.
 
-```cs
+```cs linenums="1"
 Type? nullableValueType = default;  // assigns null
 
 nullableValueType.HasValue  // boolean, use for null check
@@ -545,7 +545,7 @@ Valid settings are:
 
 In `Project.csproj`:
 
-```xml
+```xml linenums="1"
 <Project Sdk="Microsoft.NET.Sdk">
     <PropertyGroup>
         <OutputType>Exe</OutputType>
@@ -559,7 +559,7 @@ In `Project.csproj`:
 
 In `Program.cs`:
 
-```cs
+```cs linenums="1"
 #nullable enable  // Sets the nullable annotation context and nullable warning context to enabled.
 #nullable disable  // Sets the nullable annotation context and nullable warning context to disabled.
 #nullable restore  // Restores the nullable annotation context and nullable warning context to the project settings.
@@ -573,7 +573,7 @@ In `Program.cs`:
 
 ### Null Conditional, Null Coalescing, Null Forgiving Operator, Null Checks
 
-```cs
+```cs linenums="1"
 Type? variable = null;  // the variable can also contain the NULL value (nullable type)
 
 <expr>!  // declare explicitly that the expression is not null (null forgiving operator)
@@ -624,7 +624,7 @@ That information helps the compiler perform static analysis and determine when a
 
 ## Type Conversion
 
-```cs
+```cs linenums="1"
 variable.GetType();  // System type of variable
 
 (type) variable  // explicit conversion
@@ -677,7 +677,7 @@ The _.NET SDK_ defines certain symbols by default. It supports two configuration
 It defines a `DEBUG` compilation symbol in the Debug configuration, whereas Release will define `RELEASE` instead.  
 It defines a symbol called `TRACE` in both configurations.
 
-```cs
+```cs linenums="1"
 #if DEBUG
     // instructions
 #endif
@@ -687,7 +687,7 @@ C# provides a more subtle mechanism to support this sort of thing, called a _con
 The compiler recognizes an attribute defined by the .NET class libraries, called `ConditionalAttribute`, for which it provides special compile time behavior.  
 Method annotated with this attribute will not be present in a non-Debug release.
 
-```cs
+```cs linenums="1"
 [System.Diagnostics.Conditional("DEBUG")]
 Type Method() { ... }
 ```
@@ -696,7 +696,7 @@ Type Method() { ... }
 
 C# allows choose to generate _compiler errors_ or warnings with the `#error` and `#warning` directives. These are typically used inside conditional regions.
 
-```cs
+```cs linenums="1"
 #if NETSTANDARD
     #error .NET Standard is not a supported target for this source file
 #endif
@@ -707,7 +707,7 @@ C# allows choose to generate _compiler errors_ or warnings with the `#error` and
 The `#pragma` directive provides two features: it can be used to disable selected compiler warnings, and it can also be used to override the checksum values the compiler puts into the `.pdb` file it generates containing debug information.  
 Both of these are designed primarily for code generation scenarios, although they can occasionally be useful to disable warnings in ordinary code.
 
-```cs
+```cs linenums="1"
 #pragma warning disable CS<number>
 ```
 
@@ -806,7 +806,7 @@ Both of these are designed primarily for code generation scenarios, although the
 
 ### `If`-`Else If`-`Else`
 
-```cs
+```cs linenums="1"
 Object o;
 
 if (condition)
@@ -829,7 +829,7 @@ else
 
 A pattern describes one or more criteria that a value can be tested against. It's usable in switch statements, switch expressions and if statements.
 
-```cs
+```cs linenums="1"
 // type pattern
 <expr> is Type t  // type pattern
 
@@ -882,7 +882,7 @@ The `when` keyword can be used to specify a filter condition that causes its ass
 
 [Switch Expressions](https://dotnetcoretutorials.com/2019/06/25/switch-expressions-in-c-8/)
 
-```cs
+```cs linenums="1"
 switch (expr)
 {
     // multiple labels for same block
@@ -921,7 +921,7 @@ variable switch
 
 ### `While` Loop
 
-```cs
+```cs linenums="1"
 while (condition)
 {
     // code here
@@ -932,7 +932,7 @@ while (condition)
 
 Executes at least one time.
 
-```cs
+```cs linenums="1"
 do
 {
     // code here
@@ -942,7 +942,7 @@ while (condition);
 
 ### `For` Loop
 
-```cs
+```cs linenums="1"
 for (initializer; condition; iterator)
 {
     // code here
@@ -959,7 +959,7 @@ Technically, the `foreach` statement will work on any type that follows these ru
 
 There are interfaces named `IEnumerable` and `IEnumerable<T>` that formally define these rules but technically the compiler does not require the type to implement these interfaces.
 
-```cs
+```cs linenums="1"
 foreach (type item in iterabile)
 {
     // code here
@@ -971,7 +971,7 @@ foreach (type item in iterabile)
 
 Example:
 
-```cs
+```cs linenums="1"
 // make integers enumerable
 public static IEnumerator<int> GetEnumerator(this int source)
 {
@@ -989,14 +989,14 @@ public static IEnumerator<int> GetEnumerator(this int source)
 
 ### Yield Statement
 
-```cs
+```cs linenums="1"
 yield return <expression>;    // returns the results one at a time.
 yield break;    // concludes the iteration
 ```
 
 ### Context Statement & Using Declarations
 
-```cs
+```cs linenums="1"
 using (Type obj = new Type())  // obj disposed at the end of the using block
 {
     // code here
@@ -1020,7 +1020,7 @@ It is done by editing the `.csproj` file, adding `<CheckForOverflowUnderflow>tru
 
 > **Note**: checking can make individual integer operations several times slower.
 
-```cs
+```cs linenums="1"
 checked
 {
     // code here
@@ -1042,7 +1042,7 @@ unchecked(<expr>);
 
 [Exception Object](https://docs.microsoft.com/en-us/dotnet/api/system.exception)
 
-```cs
+```cs linenums="1"
 try
 {
     // "dangerous" code
@@ -1068,7 +1068,7 @@ finally
 
 ### Throwing Exceptions
 
-```cs
+```cs linenums="1"
 throw new ExceptionClass();
 throw new ExceptionClass("message");
 
@@ -1089,7 +1089,7 @@ Environment.FailFast(causeOfFailure);
 
 ### Custom Exceptions
 
-```cs
+```cs linenums="1"
 public class CustomException : Exception  // must derive from Exception (either directly or indirectly)
 {
     public CustomException()
@@ -1115,7 +1115,7 @@ public class CustomException : Exception  // must derive from Exception (either
 An enumeration type (or enum type) is a value type defined by a set of **named constants** of the underlying _integral numeric_ type (`int`, `long`, `byte`, ...).  
 Consecutive names increase the value by one.
 
-```cs
+```cs linenums="1"
 [Flags]  // indicate that the flag can be combined (best if values are binary) as a bit mask
 enum EnumType : IntegralNumericType // named values MUST match IntegerNumericType allowed values
 {
@@ -1150,7 +1150,7 @@ The method signature is the number & type of the input parameters defined for th
 C# makes the fairly common distinction between _parameters_ and _arguments_: a method defines a list of the inputs it expects (the parameters) and the code inside the method refers to these parameters by name.  
 The values seen by the code could be different each time the method is invoked, and the term argument refers to the specific value supplied for a parameter in a particular invocation.
 
-```cs
+```cs linenums="1"
 type MethodName (type parameter, ...)
 {
     // code here
@@ -1165,13 +1165,13 @@ void MethodName (type parameter, ...) {
 
 ### Expression Body Definition
 
-```cs
+```cs linenums="1"
 type MethodName() => <expression>;    // expression result type MUST match method type
 ```
 
 ### Arbitrary Number Of Parameter In Methods
 
-```cs
+```cs linenums="1"
 // params keyword must be last parameter and must be an array
 type MethodName (type parameter, params type[] args)
 {
@@ -1181,7 +1181,7 @@ type MethodName (type parameter, params type[] args)
 
 ### [Named Arguments](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/classes-and-structs/named-and-optional-arguments#named-arguments)
 
-```cs
+```cs linenums="1"
 type MethodName (type param1, type param2, ...) { }
 
 MethodName(param1: value, param2: value);
@@ -1205,7 +1205,7 @@ A default value must be one of the following types of expressions:
 - an expression of the form new ValType(), where ValType is a value type, such as an enum or a struct;
 - an expression of the form default(ValType), where ValType is a value type.
 
-```cs
+```cs linenums="1"
 type MethodName (type required, type firstOptional = default_value, type secondOptional = default_value, ...) { }
 MethodName(value1);  // use defaults for optional arguments
 MethodName(required: value, secondOptional: value);  // use default for first optional but pass second optional
@@ -1238,7 +1238,7 @@ Use cases:
 While the method can use members of the passed reference type, it can't normally replace it with a different object.  
 But if a reference type argument is marked with ref, the method has access to the variable, so it could replace it with a reference to a completely different object.
 
-```cs
+```cs linenums="1"
 // method declaration
 type MethodName (type param1,  ref type param2, out type param3, in type param4, ...)
 {
@@ -1258,7 +1258,7 @@ OutMethod(arg1, out var arg2);  // create out variable on the fly
 **Must** be C# 7+.  
 The retuned tuple MUST match the tuple-type in the instantiation
 
-```cs
+```cs linenums="1"
 (type returnedVar1, type returnedVar2, ...) MethodName (type parameter, ...)
 {
    // code here
@@ -1268,7 +1268,7 @@ The retuned tuple MUST match the tuple-type in the instantiation
 
 ### Returning Multiple Values W/ Structs (Return Struct Variable)
 
-```cs
+```cs linenums="1"
 StructName MethodName (args)
 {
    // code here
@@ -1282,7 +1282,7 @@ StructName MethodName (args)
 
 ### Local Functions
 
-```cs
+```cs linenums="1"
 type OuterMethod(...)
 {
     var foo = InnerMethod();
@@ -1299,7 +1299,7 @@ It's just an illusion maintained by the C# compiler, one that it keeps up even i
 
 > **Note**: Extension Method can be declared only inside static classes. Extension methods are available only if their namespace is imported with the `using` keyword.
 
-```cs
+```cs linenums="1"
 public static class ExtensionMethods
 {
     type ExtensionMethod(this type param)
@@ -1325,7 +1325,7 @@ It's possible to use a `yield break` statement or exception to end the iteration
 
 > **Note**: Since an iterator returns an `IEnumerable<T>` is can be used to implement a `GetEnumerator()`.
 
-```cs
+```cs linenums="1"
 // simple iterator
 public static System.Collections.IEnumerable<int> IterateRange(int start = 0, int end)
 {
@@ -1358,7 +1358,7 @@ Modifiable value types tend to be problematic, because it's all too easy to end
 So it's usually a good idea for value types to be immutable. This doesn't mean that variables of these types cannot be modified;  
 it just means that to modify the variable, its contents must be replaced entirely with a different value.
 
-```cs
+```cs linenums="1"
 public struct Point
 {
     public Point(double x, double y)
@@ -1387,7 +1387,7 @@ If you attempt to access the variable outside of the code block, you'll get a co
 
 [Access Modifiers](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/classes-and-structs/access-modifiers)
 
-```cs
+```cs linenums="1"
 // ACCESS MODIFIERS
 public    // visible from everywhere
 private    // not visible outside of the class (default for members)
@@ -1426,7 +1426,7 @@ A _property_ is a member that provides a flexible mechanism to read, write, or c
 
 The `static` keyword declares that a member is not associated with any particular instance of the class.
 
-```cs
+```cs linenums="1"
 class Class
 {
     // if static contractor exists the initializer is runned immediately before the static constructor,
@@ -1473,7 +1473,7 @@ class Class
 
 [Properties Docs](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/classes-and-structs/properties)
 
-```cs
+```cs linenums="1"
 class Class
 {
     private type _backingField;
@@ -1525,7 +1525,7 @@ Because `init` accessors can only be called during initialization, they are allo
 **Object initializers** allow to assign values to any accessible fields or properties of an object at creation time without having to invoke a constructor followed by lines of assignment statements.  
 The object initializer syntax enables to specify arguments for a constructor or omit the arguments (and parentheses syntax).
 
-```cs
+```cs linenums="1"
 public class Class
 {
     // Auto-implemented properties.
@@ -1557,7 +1557,7 @@ Class obj = new Class(arg1) { Prop2 = arg2 };  // w/ constructor
 var copy = original with { Prop = newValue };  // other props are copies of the original
 ```
 
-```cs
+```cs linenums="1"
 public class Matrix
 {
     private double[,] matrix = new double[3, 3];
@@ -1593,7 +1593,7 @@ List<int> digits = new List<int> { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 };
 
 Static classes **can't** instantiate objects and all their methods **must** be static.
 
-```cs
+```cs linenums="1"
 static class Class
 {
     static type variable = value;
@@ -1625,7 +1625,7 @@ static class Class
 An **indexer** is a property that takes one or more arguments, and is accessed with the same syntax as is used for arrays.  
 This is useful when writing a class that contains a collection of objects.
 
-```cs
+```cs linenums="1"
 public class Class<T>
 {
     public T this[int i]
@@ -1671,7 +1671,7 @@ Members marked as `abstract` must be implemented by non-abstract classes that de
 - It is an error to use the `abstract` modifier on a `static` property.
 - An `abstract` inherited property can be overridden in a derived class by including a property declaration that uses the `override` modifier.
 
-```cs
+```cs linenums="1"
 public abstract class Abstract : Interface
 {
     public abstract Type Property { get; set; }
@@ -1696,7 +1696,7 @@ public class Derived : Abstract
 
 ### Cloning
 
-```cs
+```cs linenums="1"
 Class obj = new Class()
 
 Object.MemberwiseClone();  // Returns shallow copy of the object
@@ -1709,7 +1709,7 @@ Deconstruction is not limited to tuples. By providing a `Deconstruct(...)` metho
 
 > **Note**: Types with a deconstructor can also use _positional pattern matching_.
 
-```cs
+```cs linenums="1"
 public readonly struct Size
 {
     public Size(double w, double h)
@@ -1762,7 +1762,7 @@ Use the operator keyword to declare an operator. An operator declaration must sa
 
 [Overloadable operators](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/operators/operator-overloading#overloadable-operators)
 
-```cs
+```cs linenums="1"
 using System;
 
 public readonly struct Fraction
@@ -1852,7 +1852,7 @@ An interface is effectively a list of the members that a type will need to provi
 
 C# 8.0 adds the ability to define default implementations for some or all methods, and also to define nested types and static fields.
 
-```cs
+```cs linenums="1"
 // can only be public or internal if not nested, any accessibility otherwise
 public interface IContract
 {
@@ -1909,7 +1909,7 @@ which is effectively an object that holds a copy of a struct in a way that can b
 [Generics Docs](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/generics/)
 [Generic Methods Docs](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/generics/generic-methods)
 
-```cs
+```cs linenums="1"
 // type parameter T in angle brackets
 // WARNING: T is not instantiable, new t(), new t[] are INVALID
 public class GenericClass<T> {
@@ -1936,7 +1936,7 @@ obj.GenericMethodName(Type param);  // type deduced by input, input type and gen
 
 ### Multiple Generics
 
-```cs
+```cs linenums="1"
 public class GenericClass<T1, T2, ...> { }  // number of generic types is not limited
 ```
 
@@ -1953,7 +1953,7 @@ C# supports only six kinds of constraints on a type argument:
 - `unmanaged`
 - `new()`
 
-```cs
+```cs linenums="1"
 // type constraints
 public class GenericClass<T> where T : Interface { }
 public class GenericClass<T> where T: GenericClass { }
@@ -2002,7 +2002,7 @@ both public and private—an instance of the derived class can do anything an in
 > **Note**: When deriving from a class, it's not possible to make the derived class more visible than its base. This restriction does not apply to interfaces.  
 A `public` class is free to implement `internal` or `private` interfaces. However, it does apply to an interface's bases: a `public` interface cannot derive from an `internal` interface.
 
-```cs
+```cs linenums="1"
 class BaseClass
 {
     public virtual Property { get; set; }
@@ -2027,7 +2027,7 @@ class ChildClass : BaseClass, Interface, Interface<Type>
 
 Downcasting is the conversion from a base class type to one of it's derived types.
 
-```cs
+```cs linenums="1"
 Base b;
 var d = (Derived) b;  // explicit casting (if conversion fails throws InvalidCastException)
 var d = b as Derived;  // as operator (if conversion fails AS will return NULL)
@@ -2048,7 +2048,7 @@ Initialization order:
 3. Base class constructor
 4. Derived class constructor
 
-```cs
+```cs linenums="1"
 public class Base
 {
     public Base(Type param) {}
@@ -2066,7 +2066,7 @@ public class Derived
 If you derive from a generic class, you must supply the type arguments it requires.  
 You must provide concrete types unless your derived type is generic, in which case it can use its own type parameters as arguments.
 
-```cs
+```cs linenums="1"
 public class GenericBase1<T>
 {
     public T Item { get; set; }
@@ -2085,7 +2085,7 @@ public class MixedDerived<T> : GenericBase2<T, Type>  // derived is generic but
 
 It's allowed to use derived type as a type argument to the base class. And it's also possible to specify a constraint on a type argument requiring it to derive from the derived type.
 
-```cs
+```cs linenums="1"
 public class Derived : base<Derived> {}
 public class Derived<T> where T : Derived<T>
 ```
@@ -2105,7 +2105,7 @@ Generic type parameters support covariance and contravariance to provide greater
 
 > **Note**: annotate generic type parameters with `out` and `in` annotations to specify whether they should behave covariantly or contravariantly.
 
-```cs
+```cs linenums="1"
 public class Base {};
 public class Derived : Base {}
 
@@ -2147,7 +2147,7 @@ This ability to refer to a method as a parameter makes delegates ideal for defin
 Any method from any accessible class or struct that matches the delegate type can be assigned to the delegate. The method can be either static or an instance method.  
 This makes it possible to programmatically change method calls, and also plug new code into existing classes.
 
-```cs
+```cs linenums="1"
 // delegate definition
 public delegate Type Delegate(Type param, ...);  // can take any method with specified type params and return type
 public delegate Type Delegate<T>(T param);  // generic delegate
@@ -2161,7 +2161,7 @@ Delegate<Type> delegate = Method;  // implicit creation
 
 **Multicast Delegates** are delegates that can have more than one element in their invocation list.
 
-```cs
+```cs linenums="1"
 Delegate<Type> multicastDelegate = Method1 + Method2 + ...;  // multicast delegate creation
 multicastDelegate += Method;  // add method to delegate
 multicastDelegate -= Method;  // remove method from delegate
@@ -2175,7 +2175,7 @@ Subtraction of a multicast delegate succeeds only if the delegate from which sub
 Invoking a delegate with a single target method works as though the code had called the target method in the conventional way.  
 Invoking a multicast delegate is just like calling each of its target methods in turn.
 
-```cs
+```cs linenums="1"
 Delegate<Type> delegate = Method;
 
 delegate(args);  // use delegate as standard method
@@ -2188,7 +2188,7 @@ multicastDelegate.GetInvocationList();  // list of methods called by the delegat
 
 > **Note**: Each delegate has an overload taking from zero to 16 arguments;
 
-```cs
+```cs linenums="1"
 public delegate void Action<in T1, ...>(T1 arg1, ...);
 public delegate TResult Func<in T1, ..., out TResult>(T1 arg1, ...);
 public delegate bool Predicate<in T1, ...>(T1 arg1, ...);
@@ -2203,7 +2203,7 @@ However, the type system supports certain implicit reference conversions for gen
 
 Delegates without explicit separated method.
 
-```cs
+```cs linenums="1"
 // lambda variations
 Delegate<Type> lambda = () => <expr>;
 Delegate<Type> lambda = input => <expr>;
@@ -2240,7 +2240,7 @@ Structs and classes can declare events. This kind of member enables a type to pr
 The class who raises events is called _Publisher_, and the class who receives the notification is called _Subscriber_. There can be multiple subscribers of a single event.  
 Typically, a publisher raises an event when some action occurred. The subscribers, who are interested in getting a notification when an action occurred, should register with an event and handle it.
 
-```cs
+```cs linenums="1"
 public delegate void EventDelegate(object sender, CustomEventArgs args);  // called on event trigger
 
 public class Publisher
@@ -2257,7 +2257,7 @@ public class Publisher
 
 ### Registering Event Handlers
 
-```cs
+```cs linenums="1"
 public class Subscriber
 {
     Publisher publisher = new Publisher();
@@ -2278,7 +2278,7 @@ public class Subscriber
 Typically, any event should include two parameters: the _source_ of the event and event _data_.  
 The `EventHandler` delegate is used for all events that do not include event data, the `EventHandler<TEventArgs>` delegate is used for events that include data to be sent to handlers.
 
-```cs
+```cs linenums="1"
 public class Publisher
 {
     public event EventHandler Event;
@@ -2304,7 +2304,7 @@ public class Subscriber
 
 ### Custom Event Args
 
-```cs
+```cs linenums="1"
 public class CustomEventArgs : EventArgs { }
 
 public class Publisher
@@ -2485,7 +2485,7 @@ To be used as an attribute, a type must derive from the `System.Attribute` class
 
 It's possible to pass arguments to the attribute _constructor_ in the annotation.
 
-```cs
+```cs linenums="1"
 [AttName]  // simple attribute
 
 [AttName(value)]  // valorize private fields (through the constructor)
@@ -2496,7 +2496,7 @@ It's possible to pass arguments to the attribute _constructor_ in the annotation
 
 ### Multiple Attributes
 
-```cs
+```cs linenums="1"
 [Attribute1]
 [Attribute2]
 
@@ -2505,7 +2505,7 @@ It's possible to pass arguments to the attribute _constructor_ in the annotation
 
 ### Defining Custom Attribute Types
 
-```cs
+```cs linenums="1"
 // specify what the attribute can be applied to (enforced by c# compiler)
 [AttributeUsage(AttributeTargets.<TargetType>)]
 public class CustomAttribute : Attribute
@@ -2523,7 +2523,7 @@ public class CustomAttribute : Attribute
 It's possible to discover which attributes have been applied through the reflection API.  
 The various targets of attribute have a reflection type representing them (`MethodInfo`, `PropertyInfo`, ...) which all implement the interface `ICustomAttributeProvider`.
 
-```cs
+```cs linenums="1"
 public interface ICustomAttributeProvider
 {
     object[] GetCustomAttributes(bool inherit);
@@ -2542,7 +2542,7 @@ A console application uses streams to represent its input and output.
 The `Stream` class is defined in the `System.IO` namespace.  
 It is an abstract base class, with concrete derived types such as `FileStream` or `GZipStream` representing particular kinds of streams.
 
-```cs
+```cs linenums="1"
 // The most important members of Stream
 public abstract int Read(byte[] buffer, int offset, int count);
 public abstract void Write(byte[] buffer, int offset, int count);
@@ -2571,7 +2571,7 @@ This is not guaranteed to work because it's not always possible to support it. S
 Stream also defines a Seek method, this allows to specify the position required relative to the stream's current position.  
 Passing `SeekOrigin.Current` as second argument will set the position by adding the first argument to the current position.
 
-```cs
+```cs linenums="1"
 public abstract long Seek(long offset, SeekOrigin origin);  // offset can be negative
 ```
 
@@ -2602,7 +2602,7 @@ It's possible to constructing them by passing a `Stream` as a constructor argume
 
 [Encoding](https://docs.microsoft.com/en-us/dotnet/api/system.text.encoding)
 
-```cs
+```cs linenums="1"
 // Will detect encoding from stream contents
 StreamReader file = new StreamReader(string path);
 StreamReader file = new StreamReader(string path, System.Text.Encoding encoding);  // encoding is System.Text.Encoding
@@ -2649,7 +2649,7 @@ The `FileStream` class derives from `Stream` and represents a file from the file
 It' common to use the constructors in which the `FileStream` uses OS APIs to create the file handle. It's possible to provide varying levels of detail on how this si to be done.  
 At a minimum the file's path and a value from the `FileMode` enumeration must be provided.
 
-```cs
+```cs linenums="1"
 // overloaded FileStream Constructors
 public FileStream(string path, FileMode mode);
 public FileStream(string path, FileMode mode, FileAccess access);
@@ -2693,7 +2693,7 @@ public FileStream(string path, FileMode mode, FileAccess access, FileShare share
 
 > **Note**: The `WriteThrough` flag will ensure that when the stream is disposed or flushed, all the data written will have been delivered to the drive, but the drive will not necessarily have written that data persistently (drives can defer writing for performance), so data loss id still possible if the power fails.
 
-```cs
+```cs linenums="1"
 // object to read or write to a file (file can be binary)
 {
     using(FileStream fstream = new FileStream(path, FileMode.OpenOrCreate, FileAccess.ReadWrite))
@@ -2707,7 +2707,7 @@ public FileStream(string path, FileMode mode, FileAccess access, FileShare share
 
 The static `File` class provides methods for performing various operations on files.
 
-```cs
+```cs linenums="1"
 File.Create(string path);  // Return Read/Write FileStream to file
 File.Open(string path, System.IO.FileMode mode);  // Open a FileStream on the specified path with read/write access with no sharing.
 File.Open(string path, System.IO.FileMode mode, System.IO.FileAccess access);  // Opens a FileStream on the specified path, with the specified mode and access with no sharing.
@@ -2747,7 +2747,7 @@ File.Replace(string sourceFileName, string destinationFileName, string destinati
 
 Exposes static methods for creating, moving, and enumerating through directories and subdirectories.
 
-```cs
+```cs linenums="1"
 Directory.CreateDirectory(string path);  // Create directory as specified
 Directory.Delete(string path);  // Delete an empty directory from a specified path (dir must be writable)
 Directory.Delete(string path, bool recursive);  // Delete the specified directory and, if indicated, any subdirectories and files in the directory
@@ -2775,7 +2775,7 @@ Directory.GetFileSystemEntries (string path, string searchPattern, SearchOption
 
 ### [Path](https://docs.microsoft.com/en-us/dotnet/api/system.io.path) Class
 
-```cs
+```cs linenums="1"
 Combine(string path1, string path2);  // Combine two strings into a path
 Combine(string[] paths);  // Combine strings into a path
 
@@ -2822,7 +2822,7 @@ Classes to hold multiple info about a file or directory. If some property change
 
 Types are required to opt into CLR serialization. .NET defines a `[Serializable]` attribute that must be present before the CLR will serialize the type (class).
 
-```cs
+```cs linenums="1"
 [Serializable]
 class Class { }
 ```
@@ -2839,7 +2839,7 @@ Serialization works directly with an object's fields. It uses reflection, which
 
 Object that represents the difference between two dates
 
-```cs
+```cs linenums="1"
 TimeSpan Interval = new DateTime() - new DateTime()  // difference between dates
 
 // constructors
@@ -2872,7 +2872,7 @@ length.
 
 Access to a span contents is done like an and since a `Span<T>` knows its own length, its indexer checks that the index is in range, just as the built-in array type does.
 
-```cs
+```cs linenums="1"
 Span<int> numbers = stackalloc int[] { 1, 2, 3 };
 var first = numbers[0];
 ```
@@ -2912,7 +2912,7 @@ This makes these memory types useful when you want something span-like, but in a
 
 [regex reference](https://docs.microsoft.com/en-us/dotnet/standard/base-types/regular-expression-language-quick-reference)
 
-```cs
+```cs linenums="1"
 Match match = Regex.Match(string, pattern, regexOptions);
 
 match.Success;  // whether there was a match or not
@@ -2949,7 +2949,7 @@ The `fixed` statement sets a pointer to a managed variable and "pins" that varia
 Pointers to movable managed variables are useful only in a fixed context. Without a fixed context, garbage collection could relocate the variables unpredictably.  
 The C# compiler only allows to assign a pointer to a managed variable in a fixed statement.
 
-```cs
+```cs linenums="1"
 unsafe Type UnsafeMethod() { /* unsafe context */ }
 // or
 unsafe
@@ -2976,7 +2976,7 @@ unsafe
 
 ### Native Memory
 
-```cs
+```cs linenums="1"
 using System.Runtime.InteropServices;
 
 unsafe
@@ -2993,7 +2993,7 @@ The `extern` modifier is used to declare a method that is implemented externally
 A common use of the extern modifier is with the `DllImport` attribute when using Interop services to call into _unmanaged_ code.  
 In this case, the method must also be declared as `static`.
 
-```cs
+```cs linenums="1"
 [DllImport("avifil32.dll")]
 private static extern void AVIFileInit();
 ```
@@ -3004,13 +3004,13 @@ Methods needed to implement a behaviour which do not need an interface to work.
 
 ### Enumerable
 
-```cs
+```cs linenums="1"
 public bool MoveNext(/* ... */);
 public T Current { get; }
 ```
 
 ### Awaitable
 
-```cs
+```cs linenums="1"
 public TaskAwaiter GetAwaiter(/* ... */);
 ```
diff --git a/docs/languages/dotnet/csharp/linq.md b/docs/languages/dotnet/csharp/linq.md
index 0f6da31..66ca301 100644
--- a/docs/languages/dotnet/csharp/linq.md
+++ b/docs/languages/dotnet/csharp/linq.md
@@ -13,7 +13,7 @@ LINQ to Objects will be used when any `IEnumerable<T>` is specified as the sourc
 All query expressions are required to begin with a `from` clause, which specifies the source of the query.  
 The final part of the query is a `select` (or `group`) clause. This determines the final output of the query and its system type.
 
-```cs
+```cs linenums="1"
 // query expression
 var result = from item in enumerable select item;
 
@@ -35,7 +35,7 @@ var result = from item in enumerable group item by item.property;  // returns IE
 The compiler converts all query expressions into one or more method calls. Once it has done that, the LINQ provider is selected through exactly the same mechanisms that C# uses for any other method call.  
 The compiler does not have any built-in concept of what constitutes a LINQ provider.
 
-```cs
+```cs linenums="1"
 // expanded query expression
 var result = Enumerable.Where(item => condition).Select(item => item);
 ```
@@ -44,7 +44,7 @@ The `Where` and `Select` methods are examples of LINQ operators. A LINQ operator
 
 ### Methods on `Enumerable` or `IEnumerable<T>`
 
-```cs
+```cs linenums="1"
 Enumerable.Range(int start, int end);  // IEnumerable<int> of values between start & end
 
 IEnumerable<TSource>.Select(Func<TSource, TResult> selector);  // map
@@ -77,7 +77,7 @@ IEnumerable<TFirst>.Zip(IEnumerable<TSecond> enumerable); // Produces a sequence
 
 > **Note**: `Enumerable` provides a set of `static` methods for querying objects that implement `IEnumerable<T>`. Most methods are extensions of `IEnumerable<T>`
 
-```cs
+```cs linenums="1"
 Enumerable.Method(IEnumerable<T> source, args);
 // if extension method same as
 IEnumerable<T>.Method(args);
diff --git a/docs/languages/dotnet/csharp/reactive-extensions.md b/docs/languages/dotnet/csharp/reactive-extensions.md
index 8e7d017..8b13376 100644
--- a/docs/languages/dotnet/csharp/reactive-extensions.md
+++ b/docs/languages/dotnet/csharp/reactive-extensions.md
@@ -19,7 +19,7 @@ Because Rx implements standard LINQ operators, it's possible to write queries ag
 The two most important types in Rx are the `IObservable<T>` and `IObserver<T>` interfaces.  
 They are important enough to be in the System namespace. The other parts of Rx are in the `System.Reactive` NuGet package.
 
-```cs
+```cs linenums="1"
 public interface IObservable<out T>
 {
     IDisposable Subscribe(IObserver<T> observer);
diff --git a/docs/languages/dotnet/csharp/unit-tests.md b/docs/languages/dotnet/csharp/unit-tests.md
index 0eb214e..3c98283 100644
--- a/docs/languages/dotnet/csharp/unit-tests.md
+++ b/docs/languages/dotnet/csharp/unit-tests.md
@@ -5,7 +5,7 @@
 
 ## xUnit
 
-```cs
+```cs linenums="1"
 using System;
 using Xunit;
 
@@ -37,7 +37,7 @@ For context cleanup, add the `IDisposable` interface to the test class, and put
 
 ## Mocking with Moq
 
-```cs
+```cs linenums="1"
 var mockObj = new Mock<MockedType>();
 
 mockObj.Setup(m => m.Method(It.IsAny<InputType>())).Returns(value);
@@ -48,4 +48,4 @@ mockObj.Verify(m => m.Method(It.IsAny<InputType>()), Times.Once());
 
 // check that the invocation is forwarded to the mock with a specific input
 mockObj.Verify(m => m.Method(input), Times.Once());
-```
\ No newline at end of file
+```
diff --git a/docs/languages/dotnet/database/ado.net.md b/docs/languages/dotnet/database/ado.net.md
index e93a966..1acea4f 100644
--- a/docs/languages/dotnet/database/ado.net.md
+++ b/docs/languages/dotnet/database/ado.net.md
@@ -27,7 +27,7 @@ The `ADO.NET` classes are found in `System.Data.dll`, and are integrated with th
 
 ## Connection to DB
 
-```cs
+```cs linenums="1"
 using System;
 using System.Data.SqlClient;  // ADO.NET Provider, installed through NuGet
 
@@ -55,7 +55,7 @@ namespace <namespace>
 
 ### `SqlConnection`
 
-```cs
+```cs linenums="1"
 using (SqlConnection connection = new SqlConnection())
 {
     connection.ConnectionString = connectionString.ConnectionString;
@@ -70,7 +70,7 @@ using (SqlConnection connection = new SqlConnection(connectionString)) {
 
 ### [SqlCommand](https://docs.microsoft.com/en-us/dotnet/api/system.data.sqlclient.sqlcommand)
 
-```cs
+```cs linenums="1"
 string sql = "<sql_instruction>";
 
 using (SqlCommand command = new SqlCommand())
@@ -94,7 +94,7 @@ using (SqlCommand command = new SqlCommand())
 
 ### `SqlDataReader`
 
-```cs
+```cs linenums="1"
 using (SqlDataReader cursor = command.ExecuteReader())  // object to get data from db
 {
     while (cursor.Read())  // get data till possible
diff --git a/docs/languages/dotnet/database/entity-framework.md b/docs/languages/dotnet/database/entity-framework.md
index 4168f0d..c73aca8 100644
--- a/docs/languages/dotnet/database/entity-framework.md
+++ b/docs/languages/dotnet/database/entity-framework.md
@@ -2,7 +2,7 @@
 
 ## Model & Data Annotations
 
-```cs
+```cs linenums="1"
 using System;
 using System.Collections.Generic;
 using System.ComponentModel.DataAnnotations;
@@ -35,7 +35,7 @@ NuGet Packages to install:
 - `Microsoft.EntityFrameworkCore.Design` *or* `Microsoft.EntityFrameworkCore.<db_provider>.Design` needed for tools to work (bundled w\ tools)
 - `Microsoft.EntityFrameworkCore.<db_provider>`
 
-```cs
+```cs linenums="1"
 using Microsoft.EntityFrameworkCore;
 
 namespace <Project>.Model
@@ -69,14 +69,14 @@ Create & Update DB Schema if necessary.
 
 In Package Manager Shell:
 
-```ps1
+```ps1 linenums="1"
 PM> Add-Migration <migration_name>
 PM> update-database [-Verbose] # use the migrations to modify the db, -Verbose to show SQL queries
 ```
 
 In dotnet cli:
 
-```ps1
+```ps1 linenums="1"
 dotnet tool install --global dotnet-ef  # if not already installed
 
 dotnet ef migrations add <migration_name>
@@ -87,7 +87,7 @@ dotnet ef database update
 
 ### Create
 
-```cs
+```cs linenums="1"
 context.Add(entity);
 context.AddRange(entities);
 
@@ -98,7 +98,7 @@ context.SaveChanges();
 
 [Referenced Object Not Loading Fix](https://stackoverflow.com/a/5385288)
 
-```cs
+```cs linenums="1"
 context.Entities.ToList();
 context.Entities.Find(id);
 
@@ -108,7 +108,7 @@ context.Entities.Include(c => c.ForeignObject).Find(id);
 
 ### Update
 
-```cs
+```cs linenums="1"
 context.Entities.Update(entity);
 context.UpdateRange(entities);
 
@@ -117,7 +117,7 @@ context.SaveChanges();
 
 ### Delete
 
-```cs
+```cs linenums="1"
 context.Entities.Remove(entity);
 context.RemoveRange(entities);
 
diff --git a/docs/languages/html/html.md b/docs/languages/html/html.md
index 4b7f332..60f6f39 100644
--- a/docs/languages/html/html.md
+++ b/docs/languages/html/html.md
@@ -26,14 +26,14 @@ The first thing on an HTML page is the doctype, which tells the browser which ve
 
 ### XHTML 1.0 Strict
 
-```html
+```html linenums="1"
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 ```
 
 ### HTML4 Transitional
 
-```html
+```html linenums="1"
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
  "http://www.w3.org/TR/html4/loose.dtd">
 ```
@@ -46,7 +46,7 @@ The first thing on an HTML page is the doctype, which tells the browser which ve
 
 After `<doctype>`, the page content must be contained between tags.
 
-```html
+```html linenums="1"
 <!doctype html>
 <html lang="en">
     <!-- page contents -->
@@ -66,7 +66,7 @@ HTML5: `<meta charset="utf-8">`
 
 Used to make old browsers understand newer HTML5 and newer components.
 
-```html
+```html linenums="1"
 <!--[if lt IE 9]>
     <script src="https://cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv.js"></script>
 <![endif]-->
@@ -76,7 +76,7 @@ Used to make old browsers understand newer HTML5 and newer components.
 
 The body contains the actual content of the page. Everything that is contained in the body is visible to the user.
 
-```html
+```html linenums="1"
 <body>
     <!-- page contents -->
 </body>
@@ -147,7 +147,7 @@ Before using build-in validation make sure that it's supported by the target bro
 
 ## General structure of HTML page
 
-```html
+```html linenums="1"
 <!-- HTML Boilerplate -->
 <!DOCTYPE html>
 <html lang="en">
@@ -189,7 +189,7 @@ Attributes describe additional characteristics of an HTML element.
 
 Paragraphs allow to format the content in a readable fashion.
 
-```html
+```html linenums="1"
 <p> paragraph-content </p>
 <p> paragraph-content </p>
 ```
@@ -198,7 +198,7 @@ Paragraphs allow to format the content in a readable fashion.
 
 Heading numbers indicates hierarchy, not size.
 
-```html
+```html linenums="1"
 <h1> Heading 1 </h1>
 <h2> Heading 2 </h2>
 ```
@@ -225,7 +225,7 @@ Without semantic value, used as last resort:
 
 Surround content to turn into links.
 
-```html
+```html linenums="1"
 <!-- Link to absolute URL -->
 <a href="uri/url" title="content-title" target="_self"> text/image </a>
 
@@ -260,12 +260,12 @@ Surround content to turn into links.
 
 ### Images
 
-```html
+```html linenums="1"
 <img src="image-location" alt="brief-description"/>    <!-- image element -->
 <!-- alt should be always be populated for accessibility and SEO purposes -->
 ```
 
-```html
+```html linenums="1"
 <!-- supported by modern browsers -->
 <figure>
     <img src="img-location" alt="description">
@@ -275,7 +275,7 @@ Surround content to turn into links.
 
 ### Unordered list (bullet list)
 
-```html
+```html linenums="1"
 <ul>
     <li></li>    <!-- list element -->
     <li></li>
@@ -284,7 +284,7 @@ Surround content to turn into links.
 
 ### Ordered list (numbered list)
 
-```html
+```html linenums="1"
 <ol>
     <li></li>
     <li></li>
@@ -293,7 +293,7 @@ Surround content to turn into links.
 
 ### Description list (list of terms and descriptions)
 
-```html
+```html linenums="1"
 <dl>
     <dt>term</dt>    <!-- define term/name -->
     <dd>definition</dd> <!-- describe term/name -->
@@ -304,7 +304,7 @@ Surround content to turn into links.
 
 ### Tables
 
-```html
+```html linenums="1"
 <table>
     <thead>    <!-- table head row -->
         <th></th> <!-- table head, one for each column-->
@@ -332,7 +332,7 @@ Code     | Character
 
 Used to group elements together into sections, eventually to style them differently.
 
-```html
+```html linenums="1"
 <div>
     <!-- content here -->
 </div>
@@ -342,13 +342,13 @@ Used to group elements together into sections, eventually to style them differen
 
 Used to apply a specific style inline.
 
-```html
+```html linenums="1"
 <p> non-styled content <span class="..."> styled content </span> non-styled content </p>
 ```
 
 ### HTML5 new tags
 
-```html
+```html linenums="1"
 <header></header>
 <nav></nav>
 <main></main>
@@ -360,7 +360,7 @@ Used to apply a specific style inline.
 
 ## HTML Forms & Inputs
 
-```html
+```html linenums="1"
 <form action="data-receiver" target="" method="http-method">
     <!-- ALL form elements go here -->
 </form>
@@ -392,7 +392,7 @@ PROs & CONs of `POST` method:
 
 ### Basic Form Elements
 
-```html
+```html linenums="1"
 <form action="" method="">
     <label for="target-identifier">label-here</label>
     <input type="input-type" name="input-name" value="value-sent" id="target-identifier">
@@ -421,7 +421,7 @@ Input Attributes:
 
 One line areas that allow the user to input text.  
 
-```html
+```html linenums="1"
 <input type="text" placeholder="placeholder-text" spellcheck="true" pattern="\regex\">
 ```
 
@@ -429,27 +429,27 @@ One line areas that allow the user to input text.
 
 ### Password Field
 
-```html
+```html linenums="1"
 <input type="password">
 ```
 
 ### Radio Buttons
 
-```html
+```html linenums="1"
 <input type="radio" value="value">
 <input type="radio" value="value" checked>
 ```
 
 ### Checkboxes
 
-```html
+```html linenums="1"
 <input type="checkbox">
 <input type="checkbox" checked>
 ```
 
 ### Dropdown Menus
 
-```html
+```html linenums="1"
 <select multiple>
     <option value="value">Value</option>
     <option value="value">Value</option>
@@ -467,7 +467,7 @@ Conceptually, `<select>` becomes more similar to checkboxes.
 Upload a local file as an attachment. The `accept` attribute value is a string that defines the file types the file input should accept.  
 This string is a comma-separated list of [unique file type specifiers][file_type_specifiers_docs].
 
-```html
+```html linenums="1"
 <input type="file" value="filename" accept=".txt,application/json,audio/*">
 ```
 
@@ -477,13 +477,13 @@ This string is a comma-separated list of [unique file type specifiers][file_type
 
 Multi line text input.
 
-```html
+```html linenums="1"
 <textarea rows="row-number" cols="column-number" >pre-existing editable test</textarea>
 ```
 
 ### Submit & Reset
 
-```html
+```html linenums="1"
 <input type="submit" value="label">
 <input type="reset" value="label">
 <!-- OR -->
@@ -496,7 +496,7 @@ Multi line text input.
 
 ### Button
 
-```html
+```html linenums="1"
 <button type="button/reset/submit" value="label"/>
 
 <!-- can contain HTML -->
@@ -507,7 +507,7 @@ Multi line text input.
 
 Group controls into categories. Particularly important for screen readers.
 
-```html
+```html linenums="1"
 <fieldset>
     <legend>Color</legend>
     <input type="radio" name="colour" value="red" id="colour_red">
@@ -524,7 +524,7 @@ Group controls into categories. Particularly important for screen readers.
 Used to receive a valid e-mail address from the user. Most browsers can validate this without needing javascript.
 Older browsers don't support this input type.
 
-```html
+```html linenums="1"
 <form>
     <label for="user-email">Email:</label>
     <input type="email" name="user-email" id="form-email">
@@ -534,13 +534,13 @@ Older browsers don't support this input type.
 
 ### Progress Bar
 
-```html
+```html linenums="1"
 <progress max="100" value="70"> 70% </progress>
 ```
 
 ### Slider
 
-```html
+```html linenums="1"
 <input type="range" min="0" max="20">
 ```
 
@@ -548,13 +548,13 @@ Older browsers don't support this input type.
 
 The `<meter>` HTML element represents either a scalar value within a known range or a fractional value.
 
-```html
+```html linenums="1"
 <meter min="0" max="100" low="33" high="66" optimum="80" value="50" />
 ```
 
 ### More Input Types
 
-```html
+```html linenums="1"
 <input type="email" id="email" name="email">
 <input type="url" id="url" name="url">
 <input type="number" name="" id="identifier" min="min-value" max="max-value" step="">
diff --git a/docs/languages/java/dao.md b/docs/languages/java/dao.md
index f6972ab..558a31e 100644
--- a/docs/languages/java/dao.md
+++ b/docs/languages/java/dao.md
@@ -4,7 +4,7 @@
 
 Connection to the DB.
 
-```java
+```java linenums="1"
 package dao;
 
 import java.sql.Connection;
@@ -51,7 +51,7 @@ public class DB {
 
 Interface for CRUD methods on a database.
 
-```java
+```java linenums="1"
 package dao;
 
 import java.sql.SQLException;
@@ -69,7 +69,7 @@ public interface I<Type>DAO {
 
 Class implementing `I<Type>DAO` and handling the communication with the db.
 
-```java
+```java linenums="1"
 package dao;
 
 import java.sql.ResultSet;
diff --git a/docs/languages/java/java-collection-framework.md b/docs/languages/java/java-collection-framework.md
index 12df23e..586abfe 100644
--- a/docs/languages/java/java-collection-framework.md
+++ b/docs/languages/java/java-collection-framework.md
@@ -18,7 +18,7 @@ The **Java Collection Framework** is constituted by:
 
 ### Collection Functions
 
-```java
+```java linenums="1"
 boolean add (Object o) e.g., <x>.add (<y>)    //append to collection, false if fails
 boolean add (int index, Object o)    //insertion at given index
 boolean addAll (Collection c)    //appends a collection to another
@@ -36,7 +36,7 @@ Iterator iterator()    //returns iterator to iterate over the collection
 
 ### Collections Methods
 
-```java
+```java linenums="1"
 Collection<E>.forEach(Consumer<? super T> action);
 ```
 
@@ -52,7 +52,7 @@ Abstracts the problem of iterating over all the elements of a collection;
 
 **Note**: ArrayLists can't contain *primitive* values. *Use wrapper classes* instead.
 
-```java
+```java linenums="1"
 import java.util.ArrayList;
 ArrayList<Type> ArrayListName = new ArrayList<Type>(starting_dim);    //resizable array
 ArrayList<Type> ArrayListName = new ArrayList<Type>();    //resizable array
@@ -82,7 +82,7 @@ ArrayListName.forEach(item -> function(v));
 
 To sort a collection it's items must implement `Comparable<T>`:
 
-```java
+```java linenums="1"
 class ClassName implements Comparable<ClassName> {
 
     @override
@@ -99,7 +99,7 @@ Collections.sort(list);    //"natural" sorting uses compareTo()
 
 Otherwise a `Comparator()` must be implemented:
 
-```java
+```java linenums="1"
 class Classname {
     //code here
 }
diff --git a/docs/languages/java/java.md b/docs/languages/java/java.md
index 9846254..5a6a76f 100644
--- a/docs/languages/java/java.md
+++ b/docs/languages/java/java.md
@@ -1,6 +1,6 @@
 # Java
 
-```java
+```java linenums="1"
 //single line comment
 /* multi line comment */
 /** javaDoc docstring */
@@ -19,7 +19,7 @@ Package definition: `package <package_location>;`
 
 ### Main Method (entry point of algorithm)
 
-```java
+```java linenums="1"
 public static void main (String[] args) {
     //code here
 }
@@ -31,21 +31,21 @@ public static void main (String[] args) {
 
 ### Constant Definition (outside of main method/function)
 
-```java
+```java linenums="1"
 public static final Type CONSTANT_NAME = value;
 public static final double PI = 3.14159;   //example
 ```
 
 ### Constant Definition (inside main method/function)
 
-```java
+```java linenums="1"
 final Type CONSTANT_NAME = value;
 final double PI = 3.14159;   //example
 ```
 
 ### Screen Output
 
-```java
+```java linenums="1"
 System.out.println(output_1 + _ + output_n);   //newline at every invocation
 System.out.print(output_1 + _ + output_n);
 ```
@@ -54,7 +54,7 @@ System.out.print(output_1 + _ + output_n);
 
 [String.format() Examples](https://dzone.com/articles/java-string-format-examples)
 
-```java
+```java linenums="1"
 System.out.printf("string %..", variable);
 System.out.println(String.format(format, args));
 ```
@@ -65,7 +65,7 @@ Methods inherited from C. The value pf the variable substitutes %.
 
 `NumberFormat` class is used to format a number output.
 
-```java
+```java linenums="1"
 Locale locale = new Locale("language", "country");  // as defined by IETF lang tag, RCF 5646, RCF 4647
 NumberFormat fmt = NumberFormat.getCurrencyInstance(locale);  // format a number as a currency based on a Locale
 fmt.format(number);  // apply format to a number, returns a String
@@ -73,7 +73,7 @@ fmt.format(number);  // apply format to a number, returns a String
 
 ## Keyboard Input
 
-```java
+```java linenums="1"
 import java.util.Scanner;   //package import
 Scanner scanner = new Scanner(System.in);  //Scanner obj init
 scanner.useDelimiter("delimitatore");   //delimiter setting
@@ -92,7 +92,7 @@ Thus when switching to a different input method is necessary to call `nextLine()
 
 ### Primitive Types
 
-```java
+```java linenums="1"
 TYPE        WRAPPER     SIZE        MIN_VALUE               MAX_VALUE
 int         Integer                 -2147483648             2147483647
 byte        Byte        8 bit       -128                    127
@@ -115,7 +115,7 @@ For high precision calcs is best to use `BigDecimal`.
 
 ### Type Conversion (casting) & Type checking
 
-```java
+```java linenums="1"
 Type variable = (Type) <expression>;  // convert to other Type
 var instanceof Type;  // true if var is an instance of Type
 ```
@@ -125,7 +125,7 @@ var instanceof Type;  // true if var is an instance of Type
 Every primitive type has a corresponding wrapper class.  
 Wrapper classes permits the creation of an object with the same type of a primitive type but with added methods and constants.
 
-```java
+```java linenums="1"
 WrapperClass objectName = new WrapperClass(primitiveValue);  //declaration
 WrapperClass objectName = primitiveValue;  //shortened declaration
 
@@ -143,7 +143,7 @@ WrapperClass.toString(primitive);  // converts the wrapper class value to a stri
 
 ### String & Char
 
-```java
+```java linenums="1"
 String string = "text";  //strings always in double quotes
 char character = 'C';  //chars always in single quotes
 ```
@@ -172,7 +172,7 @@ String are immutable. Concatenation creates a new string.
 
 ### String Conversion to Number
 
-```java
+```java linenums="1"
 double d  = Double.parseDouble(string);
 float f = Float.parseFloat(string);
 int i = integer.parseInt(string);
@@ -180,7 +180,7 @@ int i = integer.parseInt(string);
 
 ### String Class Methods
 
-```java
+```java linenums="1"
 string.equals(otherString);   // returns TRUE if the strings are equal
 string.equalsIgnoreCase(otherString);   // returns TRUE if the strings are equals ignoring the case
 string.charAt(index);  // returns the character at position INDEX
@@ -211,7 +211,7 @@ To compare in alphabetical order both strings must have the same case.
 
 ### Mathematical Operations
 
-```java
+```java linenums="1"
 Math.PI  // value of pi
 Math.E  // value of e
 
@@ -317,7 +317,7 @@ Full evaluation can be forced using `&` and `|`.
 
 ### `If Else`
 
-```java
+```java linenums="1"
 if (condition) {
     //code here
 } else {
@@ -327,7 +327,7 @@ if (condition) {
 
 ### `If, Else If, Else`
 
-```java
+```java linenums="1"
 if (condition) {
     //code here
 } else if (condition) {
@@ -346,7 +346,7 @@ if condition is `true` executes instruction1 otherwise executes instruction2.
 
 ### `Switch`
 
-```java
+```java linenums="1"
 switch (matchExpression) {
     case matchingPattern:
         //code here
@@ -366,7 +366,7 @@ Omitting the `break` keyword causes multiple branches to execute the same code.
 
 ### `While` Loop
 
-```java
+```java linenums="1"
 while (condition) {
    //code here
 }
@@ -374,7 +374,7 @@ while (condition) {
 
 ### `Do While` Loop
 
-```java
+```java linenums="1"
 do {
     //code here
 } while (espressione_booleana);
@@ -384,7 +384,7 @@ Loop body executed *at least* one time
 
 ### `For` Loop
 
-```java
+```java linenums="1"
 for (initializer; condition; iterator) {
     //code here
 }
@@ -392,7 +392,7 @@ for (initializer; condition; iterator) {
 
 ### `Foreach` Loop
 
-```java
+```java linenums="1"
 for (Type variable : iterable){
     //code here
 }
@@ -400,7 +400,7 @@ for (Type variable : iterable){
 
 ### Multiple iterators in `For` Loop
 
-```java
+```java linenums="1"
 for (initializer1, initializer2; condition; iterator1, iterator2) {
     //code here
 }
@@ -417,7 +417,7 @@ The iterator declared in the for is a local variable and can be used only in the
 If the assertion check is enabled (`java -ebableassetrions programName`) the execution of the algorithm is terminated if an assertion fails.  
 Assertions can be used to check if a variable has a wanted value in a precise point in the code (Sanity Check).
 
-```java
+```java linenums="1"
 assert <booleanExpression>;
 ```
 
@@ -427,7 +427,7 @@ Static methods are not bound to an *instance* of a class but they act on the cla
 
 ### Static Void Method Definition
 
-```java
+```java linenums="1"
 static void methodName (parameters) {
     //code here
 }
@@ -435,7 +435,7 @@ static void methodName (parameters) {
 
 ### Static Method Definition
 
-```java
+```java linenums="1"
 static tipo_metodo methodName (parameters) {
     //code here
     return <espressione>;   //returned type MUST match method type
@@ -444,7 +444,7 @@ static tipo_metodo methodName (parameters) {
 
 ### Static Method Invocation
 
-```java
+```java linenums="1"
 methodName(arguments);
 ClassName.methodName(arguments);    //if method is used outside its class
 ```
@@ -453,7 +453,7 @@ ClassName.methodName(arguments);    //if method is used outside its class
 
 ## Array Declaration
 
-```java
+```java linenums="1"
 Type[] arrayName = new Type[dimension];
 
 Type arrayName[] = new Type[dimension];
@@ -463,7 +463,7 @@ arrayName.length  //length of the array
 
 Its possible to break the declaration in two lines  
 
-```java
+```java linenums="1"
 Type[] arrayName;
 arrayType = new Type[dimension];
 ```
@@ -475,7 +475,7 @@ Array dimension is determined by the number of values.
 
 ### Arrays as method parameters
 
-```java
+```java linenums="1"
 static Type methodName (Type[] arrayName) {
     //code here
 }
@@ -492,7 +492,7 @@ Array contents must be confronted by looping through the array.
 
 ### Methods returning Arrays
 
-```java
+```java linenums="1"
 static Type[] methodName (parameters) {
     Type[] arrayName = new Type[dimension];  //array declaration
     //array valorization
@@ -502,7 +502,7 @@ static Type[] methodName (parameters) {
 
 ## Variable numbers of parameters in a method
 
-```java
+```java linenums="1"
 static Type methodName (parameters, tipo[] ArrayName) {
     //code here
 }
@@ -512,14 +512,14 @@ It's not necessary to specify a dimension of the array, it's determined by Java
 
 ### Multi-Dimensional Arrays
 
-```java
+```java linenums="1"
 Type[]...[] arrayName = new Type[dimension1]...[dimensionN];
 Type arrayName[]...[] = new Type[dimension1]...[dimensionN];
 ```
 
 ### Multi-Dimensional Arrays as parameters
 
-```java
+```java linenums="1"
 static Type methodName (Type[]...[] ArrayName) {
     //code here
 }
@@ -527,7 +527,7 @@ static Type methodName (Type[]...[] ArrayName) {
 
 ### Methods returning multi-dimensional arrays
 
-```java
+```java linenums="1"
 static Type[]...[] methodName (parameters) {
     Type[]...[] array = new Type[dimension1]...[dimensionN];
     //array valorization
@@ -537,14 +537,14 @@ static Type[]...[] methodName (parameters) {
 
 ### Array Length of multi-dimensional arrays
 
-```java
+```java linenums="1"
 array.length  //row length
 array[rowIndex].length  //column length
 ```
 
 ### Irregular Table Visualization
 
-```java
+```java linenums="1"
 static void viewTable (Type[][] matrix){
     for (int row = 0; row < matrix.length; row++){   //run through the rows
         for (int column = 0; column < arrayName[row].length; column++){   //run through the columns
@@ -571,7 +571,7 @@ Unchecked exceptions usually mean that there is an error in the logic of the pro
 
 This construct permits to monitor what happens in a block of code and to specify what to do in case of errors (*exceptions*).
 
-```java
+```java linenums="1"
 try {
     //monitored code
 } catch (SpecificException e) {
@@ -590,7 +590,7 @@ A `try-catch` construct can handle multiple exceptions at once.  Every `catch` i
 
 ### Try with Resources
 
-```java
+```java linenums="1"
 try (
     //resource definition
 ){
@@ -607,7 +607,7 @@ try (
 The `throw` keyword is used to generate a custom exception in a point of the code.  
 `throw` is used together with an exception type.
 
-```java
+```java linenums="1"
 Type methodName(parameters) {
     if (condition) {
       throw new Exception("error message");
@@ -618,7 +618,7 @@ Type methodName(parameters) {
 The `throws` keyword is used to indicate what exception Type may be thrown by a method.  
 `throws` is used together with a exception class. It's used to send the exception to the method caller.
 
-```java
+```java linenums="1"
 Type methodName(parameters) throws ExceptionClass {
     if (condition) {
       throw new SpecificException("error message");
@@ -630,7 +630,7 @@ Type methodName(parameters) throws ExceptionClass {
 
 A user-defined exception has to inherit from `Exception` or one of it's descendants.
 
-```java
+```java linenums="1"
 public class CustomException extends Exception {
 
     public CustomException(){
@@ -659,7 +659,7 @@ If not specified variables, methods and classes are *only* accessible from the s
 
 ### Instance Method Definition
 
-```java
+```java linenums="1"
 Type methodName (parameters) {
     //code here
 }
@@ -667,7 +667,7 @@ Type methodName (parameters) {
 
 ### `Void` Instance Method
 
-```java
+```java linenums="1"
 void methodName (parameters) {
     //code here
 }
@@ -675,7 +675,7 @@ void methodName (parameters) {
 
 ### Class Definition
 
-```java
+```java linenums="1"
 public class ClassName {
     //instance variables declaration
 
@@ -711,7 +711,7 @@ Constructors are special methods that are invoked with the `new` operator when a
 Constructors assign the starting values of the object attributes.  
 If a constructor id defined Java doesn't create the default constructor.
 
-```java
+```java linenums="1"
 class ClassName (){
 
     //attributes declaration (aka instance variables)
@@ -736,7 +736,7 @@ Static variable do not belong to the class objects.
 
 ### Getters & Setter Methods
 
-```java
+```java linenums="1"
 public void setAttribute(Type attribute){
     this.attribute = attribute;
 }
@@ -750,7 +750,7 @@ public Type getAttribute(){
 
 Automatically returns a string if the object is directly called in a print method.
 
-```java
+```java linenums="1"
 @Override
 Public String toString(){
     return "string-representation-of-object"
@@ -777,7 +777,7 @@ A child class can inherit from *only* one parent class.
 Child class **must** implement a constructor that instantiates the parent (super) class.  
 `super()` instantiates the superclass of the child class.
 
-```java
+```java linenums="1"
 class ChildClass extends ParentClass{
 
     public ChildClass(parentParameters, childParameters){
@@ -800,7 +800,7 @@ An overridden method can change the access modifier as long as the new modifier
 
 A `ParentClass` type can contain a `ChildClass` object. This is useful for using collections and arrays of objects.
 
-```java
+```java linenums="1"
 ParentClass objectName = ChildClass();  // upcast
 (ChildClass)ParentClassObject;  // downcast
 ```
@@ -814,7 +814,7 @@ Abstract classes are marked by the `abstract` keyword.
 An abstract method is a method without implementation.  
 The methods **must** be `public` and marked with the `abstract` keyword.
 
-```java
+```java linenums="1"
 //abstract class
 abstract class className{
     //attributes here
@@ -838,7 +838,7 @@ Interfaces' attributes are always `public static final`, no need for the keyword
 
 A class can implement *more than one* Interface.
 
-```java
+```java linenums="1"
 public interface InterfaceName{
     //attributes here
 
@@ -869,7 +869,7 @@ Enums are used to restrict the type of data to a set of the possible constant va
 Enums are classes which constructor is private by default.
 It's still possible to create a custom constructor to add values.
 
-```java
+```java linenums="1"
 enum enumName {
     value1,
     value2,
@@ -904,7 +904,7 @@ enumName variable;  //creation of a variable of type enumName
 
 *Anonymous classes* make the code more concise. They enable to declare and instantiate a class at the same time. They are like local classes except that they do not have a name. Useful if is needed a local class that is used once.
 
-```java
+```java linenums="1"
 AnonymousClass objectName = new AnonymousClass(Type parameter, ...) {
 
     // attributes
@@ -915,7 +915,7 @@ AnonymousClass objectName = new AnonymousClass(Type parameter, ...) {
 
 ### Cloning
 
-```java
+```java linenums="1"
 class ClassName implements Clonable {
 
 }
@@ -923,7 +923,7 @@ class ClassName implements Clonable {
 
 ## Generics
 
-```java
+```java linenums="1"
 // WARNING: T is not instantiable, new t(), new t[] are INVALID
 public class GenericClass<T> {
     private T generic;
@@ -949,7 +949,7 @@ GenericClass<Type>[] obj = new GenericClass<>[];  // invalid
 
 ### Multiple Generics
 
-```java
+```java linenums="1"
 public class GenericClass<T1, T2, ...> { }  // number of generic types is not limited
 ```
 
@@ -957,7 +957,7 @@ public class GenericClass<T1, T2, ...> { }  // number of generic types is not li
 
 Specify an interface or class that the generic type must implement/inherit.
 
-```java
+```java linenums="1"
 public class GenericClass<T extends Interface1 & Interface2> { }
 public class GenericClass<T1 extends Interface1 & Interface2, T2 extends Class1> { }
 public class GenericClass<T extends Class1> { }
@@ -965,7 +965,7 @@ public class GenericClass<T extends Class1> { }
 
 ### Generic Methods
 
-```java
+```java linenums="1"
 public class ClassName{
 
     public <T> methodName() {
@@ -1001,7 +1001,7 @@ obj.<Type>methodName();  // generic method call
 
 #### Writing on a file
 
-```java
+```java linenums="1"
 // opening/creating the file for writing
 PrintWriter outStream = null;  // output stream creation
 try{
@@ -1022,7 +1022,7 @@ outStream.close()  // close stream and write buffer contents.
 
 #### Reading from a file
 
-```java
+```java linenums="1"
 Filereader filereader = new Filereader("filename");  //open the file
 Scanner scanner = new Scanner(filereader);  //scanner for the file
 
@@ -1058,7 +1058,7 @@ public void close() throws IOException  // closes the stream
 
 The File class is an abstraction of the file and it's path. The abstraction is independent from the OS.
 
-```java
+```java linenums="1"
 File("path/to/file")  // UNIX like path
 File("path\\to\\file")  // Windows path
 
@@ -1075,7 +1075,7 @@ file.length()  // file length in bytes
 
 #### Writing to a binary file
 
-```java
+```java linenums="1"
 ObjectOutputStream outStream;
 try {
     outStream = new ObjectOutputStream(new FileOutputSteam(filename));
@@ -1104,7 +1104,7 @@ public void close()
 
 #### Reading from a binary file
 
-```java
+```java linenums="1"
 ObjectInputStream inStream;
 try {
     inStream = new ObjectInputStream(new FileinputSteam(filename));
@@ -1148,7 +1148,7 @@ Needed for a class to be *serializable*:
 
 An array is serializable if it's base type is a serializable object.
 
-```java
+```java linenums="1"
 SerializableObject[] array = (SerializableObject[])inStream.readObject();  // read returns Object, cast needed
 ```
 
@@ -1160,7 +1160,7 @@ Functional interfaces provide target types for *lambda expressions*.
 
 General purpose `@functionalInterfaces`:
 
-```java
+```java linenums="1"
 // takes input, performs actions, return boolean
 public interface Predicate<T> {
     boolean test(T t);
@@ -1215,7 +1215,7 @@ The features of Java stream are:
 
 Usable only by a `@FunctionalInterface`'s method or a method of a *stream*.
 
-```java
+```java linenums="1"
 lambda operator -> body;
 
 //zero parameter
diff --git a/docs/languages/java/spring/pom.xml.md b/docs/languages/java/spring/pom.xml.md
index 4335265..9b7bc70 100644
--- a/docs/languages/java/spring/pom.xml.md
+++ b/docs/languages/java/spring/pom.xml.md
@@ -2,7 +2,7 @@
 
 File specifing project dependencies.
 
-```xml
+```xml linenums="1"
 <?xml version="1.0" encoding="UTF-8"?>
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
diff --git a/docs/languages/java/spring/spring-project.md b/docs/languages/java/spring/spring-project.md
index fc64809..e65492e 100644
--- a/docs/languages/java/spring/spring-project.md
+++ b/docs/languages/java/spring/spring-project.md
@@ -10,7 +10,7 @@
 
 ## application.properties
 
-```ini
+```ini linenums="1"
 spring.datasource.url=DB_url
 spring.datasource.username=user
 spring.datasource.password=password
@@ -24,7 +24,7 @@ server.port=server_port
 
 Model of a table of the DB
 
-```java
+```java linenums="1"
 package <base_package>.entities;
 
 import javax.persistence.Entity;
@@ -54,7 +54,7 @@ public class Entity {
 
 Spring Interface for DB connection and CRUD operations.
 
-```java
+```java linenums="1"
 package <base_package>.dal  // or .repository
 
 import org.springframework.data.repository.JpaRepository;
@@ -77,7 +77,7 @@ Interfaces and method to access the Data Access Layer (DAL).
 
 In `IEntityService.java`:
 
-```java
+```java linenums="1"
 package <base_package>.services;
 
 import java.util.List;
@@ -105,7 +105,7 @@ public interface IEntityService {
 
 In `EntityService.java`:
 
-```java
+```java linenums="1"
 package <base_package>.services;
 
 import java.util.List;
@@ -161,7 +161,7 @@ public class EntityService implements IEntityService {
 
 REST API routes & endpoints to supply data as JSON.
 
-```java
+```java linenums="1"
 package <base_package>.integration;
 
 import java.util.List;
diff --git a/docs/languages/java/web/servlet.md b/docs/languages/java/web/servlet.md
index f03a512..cdd9569 100644
--- a/docs/languages/java/web/servlet.md
+++ b/docs/languages/java/web/servlet.md
@@ -5,7 +5,7 @@ Although servlets can respond to many types of requests, they most commonly impl
 
 ## Basic Structure
 
-```java
+```java linenums="1"
 package <package>;
 
 import java.io.IOException;
@@ -39,7 +39,7 @@ public class <className> extends HttpServlet {
 
 ## Servlet Instructions
 
-```java
+```java linenums="1"
 request.getParameter()  // read request parameter
 
 response.setContentType("text/html");  // to return HTML in the response
diff --git a/docs/languages/javascript/ajax.md b/docs/languages/javascript/ajax.md
index b3c5355..f7ccd60 100644
--- a/docs/languages/javascript/ajax.md
+++ b/docs/languages/javascript/ajax.md
@@ -14,7 +14,7 @@ AJAX Interaction:
 
 ## XMLHttpRequest
 
-```js
+```js linenums="1"
 var request = new XMLHttpRequest();
 
 request.addEventListener(event, function() {...});
@@ -39,7 +39,7 @@ To check the status use `XMLHttpRequest.status` and `XMLHttpRequest.statusText`.
 
 **Alternative `XMLHttpRequest` using `onLoad`**:
 
-```js
+```js linenums="1"
 var request = new XMLHttpRequest();
 request.open('GET', 'myservice/username?id=some-unique-id');
 request.onload = function(){
@@ -54,7 +54,7 @@ request.send();
 
 **Alternative `XMLHttpRequest` using `readyState`**:
 
-```js
+```js linenums="1"
 var request = new XMLHttpRequest(),  method ='GET',  url ='https://developer.mozilla.org/';
 
 request.open(method, url, true);
@@ -77,7 +77,7 @@ request.send();
 
 Old versions of IE don't implement XMLHttpRequest. You must use the ActiveXObject if XMLHttpRequest is not available
 
-```js
+```js linenums="1"
 var request =window.XMLHttpRequest ? new XMLHttpRequest() : new ActiveXObject('Microsoft.XMLHTTP');
 
 // OR
diff --git a/docs/languages/javascript/dom.md b/docs/languages/javascript/dom.md
index ed52ddc..4758aec 100644
--- a/docs/languages/javascript/dom.md
+++ b/docs/languages/javascript/dom.md
@@ -10,7 +10,7 @@ The document object is *globally available* in the browser. It allows to access
 `getElementById()` and `querySelector()` return a single element.  
 `getElementsByClassName()`, `getElementsByTagName()`, and `querySelectorAll()` return a collection of elements.
 
-```js
+```js linenums="1"
 Javascript
 // By Id
 var node = document.getElementById('id');
@@ -32,7 +32,7 @@ var nodes = document.querySelectorAll('css-selector');
 
 It's possible access and change the attributes of a DOM node using the *dot notation*.
 
-```js
+```js linenums="1"
 // Changing the src of an image:
 var image = document.getElementById('id');
 var oldImageSource = image.src;
@@ -48,7 +48,7 @@ node.className = 'new-class';
 It's possible to access and change the styles of a DOM nodes via the **style** property.
 CSS property names with a `-` must be **camelCased** and number properties must have a unit.
 
-```css
+```css linenums="1"
 body {
     color: red;
     background-color: pink;
@@ -56,7 +56,7 @@ body {
 }
 ```
 
-```js
+```js linenums="1"
 var pageNode = document.body;
 pageNode.style.color = 'red';
 pageNode.style.backgroundColor = 'pink';
@@ -67,7 +67,7 @@ pageNode.style.paddingTop = '10px';
 
 Each DOM node has an `innerHTML` attribute. It contains the HTML of all its children.
 
-```js
+```js linenums="1"
 var pageNode = document.body;
 console.log(pageNode.innerHTML);
 
@@ -96,13 +96,13 @@ To change the actual text of a node, `textContent` may be a better choice:
 
 In `page.html`:
 
-```html
+```html linenums="1"
 <input type="" id="identifier" value="">
 ```
 
 In `script.js`:
 
-```js
+```js linenums="1"
 var formNode = document.getElementById("Identifier");
 var value = formNode.value;
 ```
@@ -111,7 +111,7 @@ var value = formNode.value;
 
 The document object also allows to create new nodes from scratch.
 
-```js
+```js linenums="1"
 // create node
 document.createElement('tagName');
 document.createTextNode('text');
@@ -129,7 +129,7 @@ node.parentNode.removeChild(node);
 
 Example:
 
-```js
+```js linenums="1"
 var body = document.body;
 
 var newImg = document.createElement('img');
@@ -148,7 +148,7 @@ body.appendChild(newParagraph);
 
 ### Creating DOM Nodes with Constructor Functions
 
-```js
+```js linenums="1"
 function Node(params) {
     this.node = document.createElement("tag");
 
diff --git a/docs/languages/javascript/events-animation.md b/docs/languages/javascript/events-animation.md
index 2fdc0c6..afd7eec 100644
--- a/docs/languages/javascript/events-animation.md
+++ b/docs/languages/javascript/events-animation.md
@@ -12,7 +12,7 @@ Event Types:
 
 ### Managing Event Listeners
 
-```js
+```js linenums="1"
 var domNode = document.getElementById("id");
 
 var onEvent = function(event) {  // parameter contains info on the triggered event
@@ -38,7 +38,7 @@ Event Options:
 - `bubbles` (bool): whether the event propagates through bubbling
 - `cancellable` (bool): if `true` the "default action" may be prevented
 
-```js
+```js linenums="1"
 let event = new Event(type [,options]);  // create the event, type can be custom
 let event = new CustomEvent(type, { detail: /* custom data */ });  // create event w/ custom data
 domNode.dispatchEvent(event);  // launch the event
@@ -53,7 +53,7 @@ The window object is the assumed global object on a page.
 Animation in JavascriptThe standard way to animate in JS is to use window methods.
 It's possible to animate CSS styles to change size, transparency, position, color, etc.
 
-```js
+```js linenums="1"
 //Calls a function once after a delay
 window.setTimeout(callbackFunction, delayMilliseconds);
 
@@ -73,7 +73,7 @@ window.requestAnimationFrame(callbackFunction);
 [StackOverflow](https://stackoverflow.com/a/294273/8319610)
 [Wrong dimensions at runtime](https://stackoverflow.com/a/46772849/8319610)
 
-```js
+```js linenums="1"
 > console.log(document.getElementById('id').getBoundingClientRect());
 DOMRect {
     bottom: 177,
diff --git a/docs/languages/javascript/javascript.md b/docs/languages/javascript/javascript.md
index d64374e..f42370b 100644
--- a/docs/languages/javascript/javascript.md
+++ b/docs/languages/javascript/javascript.md
@@ -1,4 +1,4 @@
-# JavaScript 
+# JavaScript
 
 ## Basics
 
@@ -11,14 +11,14 @@
 
 ### Comments
 
-```javascript
+```javascript linenums="1"
 //single line comment
 /*multiline comment*/
 ```
 
 ### File Header
 
-```javascript
+```javascript linenums="1"
 /**
  * @file filename.js
  * @author author's name
@@ -32,7 +32,7 @@
 
 If located at the top of the script the whole script works the “modern” way (enables post-ES5 functionalities).  
 
-```js
+```js linenums="1"
 "use strict"
 
 // script contents
@@ -42,7 +42,7 @@ If located at the top of the script the whole script works the “modern” way
 
 Interrupts script execution until closure, **to be avoided**
 
-```javascript
+```javascript linenums="1"
 alert("message");
 ```
 
@@ -69,7 +69,7 @@ Variable names can only contain numbers, digits, underscores and $. Variable nam
 Variable declared with `let` are in local to the code block in which are declared.
 Variable declared with `var` are local only if declared in a function.
 
-```js
+```js linenums="1"
 function func(){
     variable = value;  // implicitly declared as a global variable
     var variable = value;  // local variable
@@ -99,7 +99,7 @@ Hard-coded values are UPPERCASE and snake_case, camelCase otherwise.
 
 Only numeric type is `number`.
 
-```javascript
+```javascript linenums="1"
 let number = 10;  //integer numbers
 number = 15.7;  //floating point numbers
 number = Infinity;  //mathematical infinity
@@ -115,7 +115,7 @@ Mathematical expression will *never* cause an error. At worst the result will be
 
 ### String data type
 
-```javascript
+```javascript linenums="1"
 let string = "text";
 let string$ = 'text';
 let string_ = `text ${expression}`;  //string interpolation (needs backticks)
@@ -137,7 +137,7 @@ Property access is unpredictable:
 
 If the parameters to slice are negative, they reference the string from the end. Substring and substr doesn´t.
 
-```js
+```js linenums="1"
 string.slice(begin [, end]);
 string.substring(from [, to]);
 string.substr(start [, length]);
@@ -145,27 +145,27 @@ string.substr(start [, length]);
 
 ### Boolean data type
 
-```javascript
+```javascript linenums="1"
 let boolean = true;
 let boolean_ = false;
 ```
 
 ### Null data type
 
-```javascript
+```javascript linenums="1"
 let _ = null;
 ```
 
 ### Undefined
 
-```javascript
+```javascript linenums="1"
 let $;  //value is "undefined"
 $ = undefined;
 ```
 
 ### Typeof()
 
-```javascript
+```javascript linenums="1"
 typeof x;  //returns the type of the variable x as a string
 typeof(x);  //returns the type of the variable x as a string
 ```
@@ -176,7 +176,7 @@ It is a special value with a separate type of its own. So, again, this is an err
 
 ### Type Casting
 
-```javascript
+```javascript linenums="1"
 String(value);  //converts value to string
 
 Number(value);  //converts value to a number
@@ -200,7 +200,7 @@ typeof var_ == "number";  // typeof returns a string with the name of the type
 
 ### Type Checking
 
-```js
+```js linenums="1"
 isNaN(var);  // converts var in number and then check if is NaN
 
 Number("A") == NaN;  //false ?!?
@@ -209,7 +209,7 @@ Number("A") == NaN;  //false ?!?
 
 ### Dangerous & Stupid Implicit Type Casting
 
-```js
+```js linenums="1"
 2 + 'text';  //"2text", implicit conversion and concatenation
 1 + "1";  //"11", implicit conversion and concatenation
 "1" + 1;  //"11", implicit conversion and concatenation
@@ -305,7 +305,7 @@ Number("A") == NaN;  //false ?!?
 
 ### IF-ELSE
 
-```javascript
+```javascript linenums="1"
 if (condition) {
     //code here
 } else {
@@ -315,7 +315,7 @@ if (condition) {
 
 ### IF-ELSE Multi-Branch
 
-```javascript
+```javascript linenums="1"
 if (condition) {
     //code here
 } else if (condition) {
@@ -331,7 +331,7 @@ if (condition) {
 
 ### Switch Statement
 
-```javascript
+```javascript linenums="1"
 switch (expression) {
     case expression:
         //code here
@@ -347,7 +347,7 @@ switch (expression) {
 
 ### While Loop
 
-```javascript
+```javascript linenums="1"
 while (condition) {
     //code here
 }
@@ -355,7 +355,7 @@ while (condition) {
 
 ### Do-While Loop
 
-```javascript
+```javascript linenums="1"
 do {
     //code here
 } while (condition);
@@ -363,7 +363,7 @@ do {
 
 ### For Loop
 
-```javascript
+```javascript linenums="1"
 // basic for
 for (begin; condition; step) { }
 
@@ -384,7 +384,7 @@ iterable.forEach(() => { /* statements */ });
 `break;`  exits the loop.  
 `continue;` skip to next loop cycle.
 
-```javascript
+```javascript linenums="1"
 label: for(begin; condition; step) {
     //code here
 }
@@ -394,7 +394,7 @@ break label;  //breaks labelled loop and nested loops inside it
 
 ## Arrays
 
-```js
+```js linenums="1"
 let array = [];  // empty array
 let array = ["text", 3.14, [1.41]];  // array declaration and initialization
 
@@ -417,7 +417,7 @@ array.splice(start, deleteCount, [items_to_add]);  // remove and RETURN items fr
 
 ### `filter()` & `map()`, `reduce()`
 
-```js
+```js linenums="1"
 let array = [ items ];
 
 // execute an operation on each item, producing a new array
@@ -432,7 +432,7 @@ array.reduce((x, y) => ...);
 
 ## Spread Operator (...)
 
-```js
+```js linenums="1"
 // arrays
 let array1 = [ 1, 2, 3, 4, 5, 6 ];
 let array2 = [ 7, 8, 9, 10 ];
@@ -457,7 +457,7 @@ func(arg0, ...args);
 
 ## Dictionaries
 
-```js
+```js linenums="1"
 let dict = { FirstName: "Chris", "one": 1, 1: "some value" };
 
 
@@ -471,7 +471,7 @@ dict.FirstName = "Chris";
 
 ### Iterating Key-Value pairs
 
-```js
+```js linenums="1"
 for(let key in dict) {
   let value = dict[key];
 
@@ -485,7 +485,7 @@ Object.keys(dict).forEach(key => { });
 
 ### JSDOC documentation standard
 
-```javascript
+```javascript linenums="1"
 /**
  * @param {type} parameter - description
  * @returns {type} parameter - description
@@ -494,7 +494,7 @@ Object.keys(dict).forEach(key => { });
 
 ### Function Declaration
 
-```javascript
+```javascript linenums="1"
 // ...args will contain extra parameters (rest argument)
 function functionName(parameter=default-value, ...args) {
     //code here
@@ -504,7 +504,7 @@ function functionName(parameter=default-value, ...args) {
 
 ### Default Parameters (old versions)
 
-```javascript
+```javascript linenums="1"
 function functionName(parameters) {
     if (parameter == undefined) {
         parameter = value;
@@ -517,7 +517,7 @@ function functionName(parameters) {
 
 ### Function Expressions
 
-```javascript
+```javascript linenums="1"
 let functionName = function(parameters) {
     //code here
     return expression;
@@ -526,7 +526,7 @@ let functionName = function(parameters) {
 
 ### Arrow Functions
 
-```javascript
+```javascript linenums="1"
 (input) => { /* statements */ }
 (input) => expression;
 input => expression;  // parenthesis are optional
@@ -552,7 +552,7 @@ An object is a collection of related data and/or functionality.
 
 **Note**: It's not possible to transform a variable in an object simply by using the object assignment.
 
-```js
+```js linenums="1"
 let variable = value;
 
 // object literal
@@ -596,7 +596,7 @@ Object.entries(obj);  // list contents as key-value pairs
 JavaScript uses special functions called **constructor functions** to define and initialize objects and their features.
 Notice that it has all the features you'd expect in a function, although it doesn't return anything or explicitly create an object — it basically just defines properties and methods.
 
-```js
+```js linenums="1"
 // constructor function definition
 function Class(params) {
     this.property = param;
@@ -622,7 +622,7 @@ An object's prototype object may also have a prototype object, which it inherits
 This is often referred to as a **prototype chain**, and explains why different objects have properties and methods defined on other objects available to them.
 If a method is implemented on an object (and not it's prototype) then only that object will heve that method and not all the ones that come from the same prototype.
 
-```js
+```js linenums="1"
 // constructor function
 function Obj(param1, ...) {
     this.param1 = param1,
@@ -640,7 +640,7 @@ obj.method();  // call method from prototype
 
 ### Extending with prototypes
 
-```js
+```js linenums="1"
 // constructor function
 function DerivedObj(param1, param2, ...) {
     Obj.call(this, param1);  // use prototype constructor
@@ -661,7 +661,7 @@ dobj.method();  // call method from prototype
 
 ### Classes (ES6+)
 
-```js
+```js linenums="1"
 class Obj {
     constructor(param1, ...) {
         this.param1 = param1,
@@ -686,7 +686,7 @@ obj.func();  // call method
 
 ### Extending with Classes
 
-```js
+```js linenums="1"
 class DerivedObj extends Obj {
     constructor(param1, param2, ...){
         super(param1);  // use superclass constructor
@@ -704,7 +704,7 @@ dobj.newFunc();
 
 ### Object deconstruction
 
-```js
+```js linenums="1"
 let obj = {
     property: value,
     ...
@@ -717,14 +717,14 @@ let { property: var1, var2 = default_value } = obj;  // use default values if ob
 
 ### Array Deconstruction
 
-```js
+```js linenums="1"
 let array = [ 1, 2, 3, 4, 5, 6 ];
 let [first, , third, , seventh = "missing" ] = array;  // extract specific values from array
 ```
 
 ## Serialization
 
-```js
+```js linenums="1"
 let object = {
     // object attributes
 }
@@ -741,7 +741,7 @@ let object = JSON.parse(json);  // deserialize to Object
 
 Function runs *once* after an interval of time.
 
-```js
+```js linenums="1"
 // param1, param2, ... are the arguments passed to the function (IE9+)
 let timerId = setTimeout(func [, milliseconds, param1, param2, ... ]);  // wait milliseconds before executing the code (params are read at execution time)
 
@@ -776,7 +776,7 @@ useTimeout();
 
 ### `let` vs `var` with `setTimeout`
 
-```js
+```js linenums="1"
 // let instantiates a new variable for each iteration
 for (let i = 0; i < 3; ++i) {
     setTimeout(function() {
@@ -795,7 +795,7 @@ for (var i = 0; i < 3; ++i) {
 
 ### Preserving the context
 
-```js
+```js linenums="1"
 let obj = {
     prop: value,
 
@@ -824,7 +824,7 @@ let obj = {
 
 Function runs regularly with a specified interval. JavaScript is **Single Threaded**.
 
-```js
+```js linenums="1"
 // param1, param2, ... are the arguments passed to the function (IE9+)
 let timerId = setInterval(func, milliseconds [, param1, param2, ... ]); // (params are read at execution time)
 
@@ -852,7 +852,7 @@ There are generally 4 types of JavaScript date input formats:
 - Long Date: `"Mar 25 2015"` or `"25 Mar 2015"`
 - Full Date: `"Wednesday March 25 2015"`
 
-```js
+```js linenums="1"
 // constructors
 new Date();
 new Date(milliseconds);
@@ -892,7 +892,7 @@ let date = new Date(msec);
 
 Comparison operators work also on dates
 
-```js
+```js linenums="1"
 let date1 = new Date();
 let date2 = new Date("May 24, 2017 10:50:00");
 
@@ -909,20 +909,20 @@ if(date1 > date2){
 
 > **Note**: Firefox 68 and later define the origin of a page opened using a `file:///` URI as unique. Therefore, other resources in the same directory or its subdirectories no longer satisfy the CORS same-origin rule. This new behavior is enabled by default using the `privacy.file_unique_origin` preference.
 
-```json
+```json linenums="1"
 "privacy.file_unique_origin": "false"
 ```
 
 In `page.html`
 
-```html
+```html linenums="1"
 <script src="scripts/module.js"></script>
 <script src="scripts/script.js"></script>
 ```
 
 In `module.js`:
 
-```js
+```js linenums="1"
 // exporting individual fractures
 export default function() {}  // one per module
 export func = () => expression;  // zero or more per module
@@ -942,7 +942,7 @@ export { func } from "other_script.js"
 
 In `script.js`:
 
-```js
+```js linenums="1"
 import default_func_alias, { func as alias } from "./module.js";  // import default and set alias
 import { default as default_func_alias, func as alias } from "./module.js";  // import default and set alias
 
@@ -951,7 +951,7 @@ default_func_alias();
 alias();
 ```
 
-```js
+```js linenums="1"
 import * from "./module.js";  // import all
 
 module.function();  // use imported content with fully qualified name
diff --git a/docs/languages/javascript/jquery.md b/docs/languages/javascript/jquery.md
index 45b6bc7..1896e0f 100644
--- a/docs/languages/javascript/jquery.md
+++ b/docs/languages/javascript/jquery.md
@@ -4,7 +4,7 @@
 
 ### Download and link the file
 
-```html
+```html linenums="1"
 <head>
     <script src="jquery-x.x.x.min.js"></script>
 </head>
@@ -12,7 +12,7 @@
 
 ### Use a CDN
 
-```html
+```html linenums="1"
 <head>
     <script src="https://ajax.googleapis.com/ajax/libs/jquery/x.x.x/jquery.min.js"></script>
 </head>
@@ -34,7 +34,7 @@ CDNs serve a large fraction of the Internet content today, including web objects
 
 ### [Finding DOM elements](https://api.jquery.com/category/selectors/)
 
-```js
+```js linenums="1"
 $('tag');
 $("#id");
 $(".class");
@@ -42,11 +42,11 @@ $(".class");
 
 ### Manipulating DOM elements
 
-```js
+```js linenums="1"
 $("p").addClass("special");
 ```
 
-```html
+```html linenums="1"
 <!-- before -->
 <p>Welcome to jQuery<p>
 
@@ -56,11 +56,11 @@ $("p").addClass("special");
 
 ### Reading Elements
 
-```html
+```html linenums="1"
 <a id="yahoo" href="http://www.yahoo.com" style="font-size:20px;">Yahoo!</a>
 ```
 
-```js
+```js linenums="1"
 // find it & store it
 var link = $('a#yahoo');
 
@@ -72,14 +72,14 @@ link.css('font-size'); // '20px
 
 ### Modifying Elements
 
-```js
+```js linenums="1"
 // jQuery
 $('a').html('Yahoo!');
 $('a').attr('href', 'http://www.yahoo.com');
 $('a').css({'color': 'purple'});
 ```
 
-```html
+```html linenums="1"
 <!-- before -->
 <a href="http://www.google.com">Google</a>
 
@@ -89,7 +89,7 @@ $('a').css({'color': 'purple'});
 
 ### Create, Store, Manipulate and inject
 
-```js
+```js linenums="1"
 let paragraph = $('<p class="intro">Welcome<p>');  // create and store element
 
 paragraph.css('property', 'value');  // manipulate element
@@ -99,7 +99,7 @@ $("body").append(paragraph);  // inject in DOM
 
 ### Regular DOM Nodes to jQuery Objects
 
-```js
+```js linenums="1"
 var paragraphs = $('p'); // an array
 var aParagraph = paragraphs[0]; // a regular DOM node
 var $aParagraph = $(paragraphs[0]); // a jQuery Object
@@ -114,7 +114,7 @@ for(var i = 0; i < paragraphs.length; i++) {
 
 ## [Events](https://api.jquery.com/category/events/)
 
-```js
+```js linenums="1"
 var onButtonClick = function() {  
     console.log('clicked!');
 }
@@ -133,7 +133,7 @@ $('button').click(onButtonClick);
 
 ### Preventing Default Event
 
-```js
+```js linenums="1"
 $('selector').on('event', function(event) {
     event.preventDefault();
     // custom logic
@@ -144,13 +144,13 @@ $('selector').on('event', function(event) {
 
 In the HTML, add a `<script>` ag that hotlinks to the CDN or source file:
 
-```html
+```html linenums="1"
 <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery-validate/1.17.0/jquery.validate.min.js"><script>
 ```
 
 In the JavaScript call the jQuery plugin on the DOM:
 
-```js
+```js linenums="1"
 $("form").validate();
 ```
 
@@ -160,7 +160,7 @@ $("form").validate();
 
 ### Patters & Anti-Patterns
 
-```js
+```js linenums="1"
 // Pattern: name variables with $var
 $myVar =$('#myNode');
 
@@ -179,7 +179,7 @@ $(document).on('click', 'p', function(argument){
 
 ### Chaining
 
-```js
+```js linenums="1"
 banner.css('color', 'red');
 banner.html('Welcome!');
 banner.show();
@@ -197,7 +197,7 @@ banner.css('color', 'red')
 
 DOM manipulation and event binding doesn't work if the `<script>` is in the `<head>`
 
-```js
+```js linenums="1"
 $(document).ready(function() {
     // the DOM is fully loaded
 });
@@ -209,7 +209,7 @@ $(window).on('load', function(){
 
 ## AJAX (jQuery `1.5`+)
 
-```js
+```js linenums="1"
 $.ajax({
     method: 'POST',
     url: 'some.php',
diff --git a/docs/languages/javascript/react/react-router.md b/docs/languages/javascript/react/react-router.md
index 94f495a..401f302 100644
--- a/docs/languages/javascript/react/react-router.md
+++ b/docs/languages/javascript/react/react-router.md
@@ -16,7 +16,7 @@ Router Types:
 - *BrowserRouter*: `/route`, uses HTML5 history API to provide clean URLs
 - *MemoryRouter*: no URL
 
-```js
+```js linenums="1"
 // index.js
 
 //other imports ...
@@ -31,7 +31,7 @@ React.render(
 )
 ```
 
-```js
+```js linenums="1"
 // Component.js
 import { Route, Route } from "react-router-dom";
 
@@ -52,7 +52,7 @@ import { Route, Route } from "react-router-dom";
 
 ### URL Parameters & Query String
 
-```js
+```js linenums="1"
 // Given
 <Route path="/route/:placeholder" element={<Component props={props} />} />
 // URL: app.com/route/sub-route?param=value
@@ -66,7 +66,7 @@ function Component(props) {
 
 ### Redirecting
 
-```js
+```js linenums="1"
 import { Navigate } from "react-router-dom";
 
 // redirects to another URL on render, shouldn't be rendered on component mount but after an action
@@ -80,7 +80,7 @@ props.history.push("/new-route");
 
 ### Prompts
 
-```js
+```js linenums="1"
 import { Prompt } from "react-router-dom";
 
 // displays a prompt when the condition is true
@@ -91,7 +91,7 @@ import { Prompt } from "react-router-dom";
 
 Clicks on a link created with React-Router will be captured by react an all the routing will happen client side.
 
-```js
+```js linenums="1"
 import { Link } from "react-router-dom";
 
 // TARGET: <Route path="/route/:itemId" />
diff --git a/docs/languages/javascript/react/react-tests.md b/docs/languages/javascript/react/react-tests.md
index 5eec208..3d32faf 100644
--- a/docs/languages/javascript/react/react-tests.md
+++ b/docs/languages/javascript/react/react-tests.md
@@ -4,7 +4,7 @@
 
 ### Jest Configuration
 
-```js
+```js linenums="1"
 // jest.config.js
 module.exports = {
   testEnvironment: 'jsdom',
@@ -18,7 +18,7 @@ module.exports = {
 
 [Expect docs](https://jestjs.io/docs/expect)
 
-```js
+```js linenums="1"
 // .spec.js or .test.js
 it("test description", () => {
     // test body
@@ -36,7 +36,7 @@ describe("test group name", () => {
 
 In `Component.Snapshots.js`:
 
-```js
+```js linenums="1"
 import React from "react";
 import renderer from "react-test-renderer";
 
@@ -60,7 +60,7 @@ it("test description", () => {
 
 ### Enzyme Configuration
 
-```js
+```js linenums="1"
 // testSetup.js
 import { configure } from "enzyme";
 import Adapter from "enzyme-adapter-react-<version>";
@@ -72,7 +72,7 @@ configure({ adapter: new Adapter() });
 
 In `Component.test.js`:
 
-```js
+```js linenums="1"
 import React from "react";
 import { shallow, mount } from "enzyme";
 // eventual wrapper components (react-router, react-redux's provider, ...) for mount render
@@ -125,7 +125,7 @@ Encourages to write test based on what the user sees. So components are always *
 
 In `Components.test.js`:
 
-```js
+```js linenums="1"
 import React from "react";
 import { cleanup, render } from "@testing-library/react";
 
diff --git a/docs/languages/javascript/react/react.md b/docs/languages/javascript/react/react.md
index 9a025fc..450504f 100644
--- a/docs/languages/javascript/react/react.md
+++ b/docs/languages/javascript/react/react.md
@@ -9,7 +9,7 @@ There are two types of react components:
 
 Both types can be stateful and have side effects or be purely presentational.
 
-```jsx
+```jsx linenums="1"
 // functional component
 const Component = (props) => {
     return (
@@ -33,7 +33,7 @@ Within the component state can be changed while the props object represent fixed
 
 JSX syntax can represent HTML but gets converted to pure JavaScript before being sent to the browser:
 
-```js
+```js linenums="1"
 // JSX
 const element = (
   <h1 className="greeting">Hello, world!</h1>
@@ -49,7 +49,7 @@ const element = React.createElement(
 
 ### App Entry-point
 
-```js
+```js linenums="1"
 const container = document.getElementById('root')!;
 const root = createRoot(container);
 
@@ -59,7 +59,7 @@ root.render(element)
 
 ### Dynamic Expressions
 
-```js
+```js linenums="1"
 <tag>{expression}</tag>  // expression is evaluated an it's result is displayed
 <tag onEvent={funcReference}>{expression}</tag>
 <tag onEvent={() => func(args)}>{expression}</tag>
@@ -67,7 +67,7 @@ root.render(element)
 
 ### Props
 
-```js
+```js linenums="1"
 <Component propName={value} />  // pass a value the component
 <Component propName={funcReference} />  // pass a function to the component
 
@@ -83,7 +83,7 @@ class Component extends React.Component{
 
 ### Simple Function Component
 
-```js
+```js linenums="1"
 // Button.js
 import { useState } from "react";
 
@@ -105,7 +105,7 @@ export default Button;
 
 ### Simple Class Component
 
-```js
+```js linenums="1"
 class Button extends React.Component {
 
     state = {count: 0};
@@ -137,7 +137,7 @@ class Button extends React.Component {
 
 ### Nesting Components
 
-```js
+```js linenums="1"
 import { useState } from "react";
 
 function Button(props) {
@@ -173,7 +173,7 @@ export default App;
 
 ### User Input (Forms)
 
-```js
+```js linenums="1"
 function Form() {
     const [userName, setUserName] = useState("");
 
@@ -198,7 +198,7 @@ function Form() {
 
 ### Lists of Components
 
-```js
+```js linenums="1"
 // ...
     <div>
         {array.map(item => <Component key={uniqueID}>)}
@@ -219,7 +219,7 @@ Hook used to create a state object.
 - state object (getter)
 - updater function (setter)
 
-```js
+```js linenums="1"
 const [state, setState] = useState(default);
 ```
 
@@ -227,7 +227,7 @@ const [state, setState] = useState(default);
 
 Hook used to trigger an action on each render of the component or when one of the watched items changes.
 
-```js
+```js linenums="1"
 
 useEffect(() => {
     // "side effects" operations
@@ -238,7 +238,7 @@ useEffect(() => {
 
 ### Custom Hooks
 
-```js
+```js linenums="1"
 // hook definitions
 const useCustomHook = () => {
     // eventual state definitions
diff --git a/docs/languages/javascript/react/redux-tests.md b/docs/languages/javascript/react/redux-tests.md
index 4de8229..09dd711 100644
--- a/docs/languages/javascript/react/redux-tests.md
+++ b/docs/languages/javascript/react/redux-tests.md
@@ -9,7 +9,7 @@ Connected components are wrapped in a call to `connect`. Way of solving the prob
 
 In `Component.js`:
 
-```js
+```js linenums="1"
 export function Component(props) { /* ... */ }  // export unconnected component
 
 export default connect(mapStateToProps, mapDispatchToProps)(Component)  // default export of connected component
@@ -17,7 +17,7 @@ export default connect(mapStateToProps, mapDispatchToProps)(Component)  // defau
 
 In `Component.test.js`:
 
-```js
+```js linenums="1"
 import React from "react";
 // import enzyme or react testing library
 
@@ -48,7 +48,7 @@ it("test description", () => {
 
 ## Tests for Action Creators
 
-```js
+```js linenums="1"
 import * as actions from "path/to/actionCreators";
 // import eventual action types constants
 // import mock data
@@ -65,7 +65,7 @@ it("test description", () => {
 
 ## Tests for Reducers
 
-```js
+```js linenums="1"
 import reducer from "path/to/reducer";
 import * as actions from "path/to/actionCreators";
 
@@ -83,7 +83,7 @@ it("test description", () => {
 
 ## Tests for the Store
 
-```js
+```js linenums="1"
 import { createStore } from "redux";
 
 import rootReducer from "path/to/rootReducer";
@@ -111,7 +111,7 @@ Thunk testing requires the mocking of:
 - store (using `redux-mock-store`)
 - HTTP calls (using `fetch-mock`)
 
-```js
+```js linenums="1"
 import thunk from "redux-thunk";
 import fetchMock from "fetch-mock";
 import configureMockStore from "redux-mock-store";
diff --git a/docs/languages/javascript/react/redux.md b/docs/languages/javascript/react/redux.md
index 823da1f..47d8290 100644
--- a/docs/languages/javascript/react/redux.md
+++ b/docs/languages/javascript/react/redux.md
@@ -11,7 +11,7 @@ By convention, that information is stored in a field called `payload`.
 
 **Action Creators** are functions that create and return action objects.
 
-```js
+```js linenums="1"
 function actionCreator(data)
 {
     return { type: ACTION_TYPE, payload: data };  // action obj
@@ -30,7 +30,7 @@ The store will run its reducer function and save the new state value inside.
 
 In `initialState.js`;
 
-```js
+```js linenums="1"
 export default {
     // initial state here
 }
@@ -38,7 +38,7 @@ export default {
 
 In `configStore.js`:
 
-```js
+```js linenums="1"
 // configStore.js
 import { createStore, applyMiddleware, compose } from "redux";
 
@@ -71,7 +71,7 @@ Reducers must **always** follow some specific rules:
   Instead, they must make *immutable updates*, by copying the existing `state` and making changes to the copied values.
 - They must not do any asynchronous logic, calculate random values, or cause other "side effects"
 
-```js
+```js linenums="1"
 import initialState from "path/to/initialState";
 
 function reducer(state = initialState, action) {
@@ -118,7 +118,7 @@ Presentational Components:
 
 Used at the root component and wraps all the application.
 
-```js
+```js linenums="1"
 // index.js
 import React from 'react';
 import ReactDOM from 'react-dom';
@@ -139,7 +139,7 @@ ReactDOM.render(
 );
 ```
 
-```js
+```js linenums="1"
 // Component.js
 import { connect } from 'react-redux';
 import { increment, decrement, reset } from './actionCreators';
@@ -183,7 +183,7 @@ A "thunk" is a function that wraps an expression to delay it's evaluation.
 
 In `configStore.js`:
 
-```js
+```js linenums="1"
 import { createStore, applyMiddleware, compose } from "redux";
 import thunk from "redux-thunk";
 
@@ -199,7 +199,7 @@ function configStore(initialState) {
 }
 ```
 
-```js
+```js linenums="1"
 // usually action on async func success
 function actionCreator(arg) {
     return { type: TYPE, data: arg };
@@ -241,7 +241,7 @@ Using Create React App​
 
 The recommended way to start new apps with React and Redux is by using the official Redux+JS template or Redux+TS template for Create React App, which takes advantage of Redux Toolkit and React Redux's integration with React components.
 
-```sh
+```sh linenums="1"
 # Redux + Plain JS template
 npx create-react-app my-app --template redux
 
@@ -286,7 +286,7 @@ Included Default Middleware​:
 
 Currently, the return value of `getDefaultMiddleware()` is:
 
-```js
+```js linenums="1"
 // development
 const middleware = [thunk, immutableStateInvariant, serializableStateInvariant]
 
@@ -294,7 +294,7 @@ const middleware = [thunk, immutableStateInvariant, serializableStateInvariant]
 const middleware = [thunk]
 ```
 
-```js
+```js linenums="1"
 
 import { combineReducers } from 'redux'
 import { configureStore } from '@reduxjs/toolkit'
@@ -320,7 +320,7 @@ export default store
 
 ### [`createAction`](https://redux-toolkit.js.org/api/createAction)
 
-```js
+```js linenums="1"
 import { createAction } from '@reduxjs/toolkit';
 
 const increment = createAction<number | undefined>('counter/increment');
@@ -333,7 +333,7 @@ increment.toString();  // 'counter/increment'
 
 ### [`createReducer`](https://redux-toolkit.js.org/api/createReducer)
 
-```js
+```js linenums="1"
 import { createAction, createReducer } from '@reduxjs/toolkit'
 
 interface CounterState {
@@ -368,7 +368,7 @@ Internally, it uses `createAction` and `createReducer`, so it's possible to use
 
 **Note**: action types will have the `<slice-name>/<reducer-name>` shape.
 
-```js
+```js linenums="1"
 import { createSlice, PayloadAction } from '@reduxjs/toolkit'
 
 interface CounterState {
@@ -415,7 +415,7 @@ The `payloadCreator` function will be called with two arguments:
 
 The logic in the `payloadCreator` function may use any of these values as needed to calculate the result.
 
-```js
+```js linenums="1"
 import { createAsyncThunk, createSlice } from '@reduxjs/toolkit'
 
 const payloadCreator = async (arg, ThunkAPI): Promise<T> => { /* ... */ };
@@ -444,7 +444,7 @@ It is intended to simplify common cases for loading data in a web application, e
 
 RTK Query is included within the installation of the core Redux Toolkit package. It is available via either of the two entry points below:
 
-```cs
+```cs linenums="1"
 import { createApi } from '@reduxjs/toolkit/query'
 
 /* React-specific entry point that automatically generates hooks corresponding to the defined endpoints */
diff --git a/docs/languages/javascript/svelte/svelte.md b/docs/languages/javascript/svelte/svelte.md
index 8ee7c54..be3e474 100644
--- a/docs/languages/javascript/svelte/svelte.md
+++ b/docs/languages/javascript/svelte/svelte.md
@@ -1,6 +1,6 @@
 # [Svelte](https://svelte.dev/docs)
 
-```sh
+```sh linenums="1"
 npx degit sveltejs/template <project name>
 
 # set project to use typescript
@@ -12,7 +12,7 @@ npm init vite@latest
 
 ## App Entry-point
 
-```js
+```js linenums="1"
 import App from "./App.svelte"; // import the component
 
 const app = new App({
@@ -29,7 +29,7 @@ export default app;
 
 ### Basic Structure
 
-```html
+```html linenums="1"
 <!-- code for the component -->
 <script lang="ts">
   import { Component } from "Component.svelte";
@@ -57,7 +57,7 @@ export default app;
 
 ### If-Else
 
-```js
+```js linenums="1"
 {#if <condition>}
   // markup here
 {:else if <condition>}
@@ -69,7 +69,7 @@ export default app;
 
 ### Loops
 
-```js
+```js linenums="1"
 {#each array as item, index}  // index is optional
     // markup here
 {/each}
@@ -81,7 +81,7 @@ export default app;
 
 ### Await Blocks
 
-```js
+```js linenums="1"
 {#await promise}
  <p>...waiting</p>
 {:then number}
@@ -103,7 +103,7 @@ The full list of modifiers:
 - `once` — remove the handler after the first time it runs
 - `self` — only trigger handler if `event.target` is the element itself
 
-```js
+```js linenums="1"
 <script>
   const eventHandler = () => {};
 </script>
@@ -119,7 +119,7 @@ The full list of modifiers:
 
 ## Binding
 
-```html
+```html linenums="1"
 <script>
   let name = "Foo";
 </script>
@@ -137,7 +137,7 @@ Often, some parts of a component's state need to be computed from other parts an
 
 For these, Svelte has reactive declarations. They look like this:
 
-```js
+```js linenums="1"
 let count = 0;
 $: double =  count * 2;  // recalculated when count changes
 // or
@@ -149,7 +149,7 @@ $: <expression>
 
 [Svelte Routing](https://github.com/EmilTholin/svelte-routing)
 
-```js
+```js linenums="1"
 <!-- App.svelte -->
 <script>
   import { Router, Link, Route } from "svelte-routing";
@@ -177,14 +177,14 @@ $: <expression>
 
 ## Data Stores
 
-```js
+```js linenums="1"
 // stores.js
 import { writable } from "svelte/store";
 
 export const count = writable(0);
 ```
 
-```html
+```html linenums="1"
 <script>
   import { onDestroy } from "svelte";
   import { count } from ".path/to/stores.js";
diff --git a/docs/languages/kotlin/kotlin.md b/docs/languages/kotlin/kotlin.md
index 3a07697..ca0ae8d 100644
--- a/docs/languages/kotlin/kotlin.md
+++ b/docs/languages/kotlin/kotlin.md
@@ -2,7 +2,7 @@
 
 ## Package & Imports
 
-```kotlin
+```kotlin linenums="1"
 package com.app.uniqueID
 
 import <package>
@@ -10,7 +10,7 @@ import <package>
 
 ## Variable & Constants
 
-```kotlin
+```kotlin linenums="1"
 
 var variable: Type    //variable declaration
 var variable = value    //type can be omitted if it can be deduced by initialization
@@ -23,7 +23,7 @@ val CONSTANT_NAME: Type = value    //constant declaration
 For a variable to hold a null value, it must be of a nullable type.  
 Nullable types are specified suffixing `?` to the variable type.
 
-```kotlin
+```kotlin linenums="1"
 var nullableVariable: Type? = null
 
 nullableVariable?.method()    //correct way to use
@@ -37,7 +37,7 @@ nullablevariavle!!.method()    //unsafe way
 
 ### `If` - `Else If` - `Else`
 
-```kotlin
+```kotlin linenums="1"
 if (condition) {
     //code here
 } else if (condition) {
@@ -49,7 +49,7 @@ if (condition) {
 
 ### Conditional Expressions
 
-```kotlin
+```kotlin linenums="1"
 var variable: Type = if (condition) {
     //value to be assigned here
 } else if (condition) {
@@ -65,7 +65,7 @@ Each branch in a `when` expression is represented by a condition, an arrow (`->`
 If the condition on the left-hand side of the arrow evaluates to true, then the result of the expression on the right-hand side is returned.  
 Note that execution does not fall through from one branch to the next.
 
-```kotlin
+```kotlin linenums="1"
 when (variable){
     condition -> value
     condition -> value
@@ -90,7 +90,7 @@ when {
 
 ### `For` Loop
 
-```kotlin
+```kotlin linenums="1"
 for (item in iterable){
     //code here
 }
@@ -103,7 +103,7 @@ for(i in start..end) {
 
 ## Functions
 
-```kotlin
+```kotlin linenums="1"
 fun functionName(parameter: Type): Type {
     //code here
 
@@ -113,7 +113,7 @@ fun functionName(parameter: Type): Type {
 
 ### Simplifying Function Declarations
 
-```kotlin
+```kotlin linenums="1"
 fun functionName(parameter: Type): Type {
     return if (condition) {
         //returned value
@@ -132,7 +132,7 @@ fun functionName(parameter: Type): Type = if (condition) {
 
 ### Anonymous Functions
 
-```kotlin
+```kotlin linenums="1"
 val anonymousFunction: (Type) -> Type = { input ->
     //code acting on input here
 }
@@ -145,7 +145,7 @@ val variableName: Type = anonymousFunction(input)
 A function can take another function as an argument. Functions that use other functions as arguments are called *higher-order* functions.  
 This pattern is useful for communicating between components in the same way that you might use a callback interface in Java.
 
-```kotlin
+```kotlin linenums="1"
 fun functionName(parameter: Type, function: (Type) -> Type): Type {
     //invoke function
     return function(parameter)
@@ -156,7 +156,7 @@ fun functionName(parameter: Type, function: (Type) -> Type): Type {
 
 ### Class
 
-```kotlin
+```kotlin linenums="1"
 //primary constructor
 class ClassName(private var attribute: Type) {
 
@@ -177,7 +177,7 @@ class ClassName {
 
 [Companion Object Docs](https://kotlinlang.org/docs/tutorials/kotlin-for-py/objects-and-companion-objects.html)
 
-```kotlin
+```kotlin linenums="1"
 class ClassName {
 
     // in java: static
@@ -191,7 +191,7 @@ class ClassName {
 
 ### ArrayList
 
-```kotlin
+```kotlin linenums="1"
 var array:ArrayList<Type>? = null  // List init
 
 array.add(item)  //add item to list
diff --git a/docs/languages/markdown.md b/docs/languages/markdown.md
index 77bd44d..280698f 100644
--- a/docs/languages/markdown.md
+++ b/docs/languages/markdown.md
@@ -2,7 +2,7 @@
 
 ## Headings
 
-```markdown
+```markdown linenums="1"
 Heading 1
 =========
 
@@ -16,7 +16,7 @@ Heading 2
 
 ## Text Formatting
 
-```markdown
+```markdown linenums="1"
 *Italic*    _Italic_
 **Bold**    __Bold__
 
@@ -25,7 +25,7 @@ Heading 2
 
 ## Links & Images
 
-```markdown
+```markdown linenums="1"
 [link text](http://b.org "title")
 
 [link text][anchor]
@@ -37,7 +37,7 @@ Heading 2
 [anchor]: http://url/b.jpg "title"
 ```
 
-```markdown
+```markdown linenums="1"
 > Blockquote
 
 * unordered list        - unordered list
@@ -54,16 +54,16 @@ Heading 2
 
 ### Horizontal rule
 
-```markdown
+```markdown linenums="1"
 ---                     ***
 ```
 
 ## Code
 
-```markdown
+```markdown linenums="1"
 `inline code`
 
-    ```lang
+    ```lang linenums="1"
     multi-line
     code block
     ```
@@ -71,7 +71,7 @@ Heading 2
 
 ## Table
 
-```markdown
+```markdown linenums="1"
 | column label | column label | column label  |
 |:-------------|:------------:|--------------:|
 | left-aligned | centered     | right-aligned |
diff --git a/docs/languages/php/composer.md b/docs/languages/php/composer.md
index 0ccb2b2..c83b8f3 100644
--- a/docs/languages/php/composer.md
+++ b/docs/languages/php/composer.md
@@ -6,7 +6,7 @@ The function [spl_autoload_register()](https://www.php.net/manual/en/function.sp
 
 In `autoload.php`:
 
-```php
+```php linenums="1"
 # custom function
 function autoloader($class) {
 
@@ -31,7 +31,7 @@ spl_autoload_register('autoloader');  // register function
 
 In `file.php`:
 
-```php
+```php linenums="1"
 require "autoload.php";
 
 # other code
@@ -43,7 +43,7 @@ require "autoload.php";
 
 It's possible to resister multiple autoloading functions by calling `spl_autoload_register()` multiple times.
 
-```php
+```php linenums="1"
 # prepend adds the function at the start of the queue
 # throws selects if errors in loading throw exceptions
 spl_autoload_register(callable $func, $throw=TRUE, $prepend=FALSE);
@@ -60,7 +60,7 @@ Libraries are downloaded through [Packagist](https://packagist.org/) and [GitHub
 
 In `composer.json`:
 
-```json
+```json linenums="1"
 {
     "require": {
         "php": ">=7.0",
@@ -93,7 +93,7 @@ To update dependencies use `composer update`. To update only the autoloading sec
 
 Composer can also autoload classes belonging to the current project. It's sufficient to add the `autoload` keyword in the JSON and specify the path and autoload mode.
 
-```json
+```json linenums="1"
 {
     "autoload": {
         "psr-4": {
diff --git a/docs/languages/php/database.md b/docs/languages/php/database.md
index feba722..bbc3d28 100644
--- a/docs/languages/php/database.md
+++ b/docs/languages/php/database.md
@@ -8,7 +8,7 @@ PDO is the PHP extension for database access through a single API. It supports v
 
 ### Database Connection
 
-```php
+```php linenums="1"
 $dsn = "mysql:dbname=<dbname>;host=<ip>";
 $user="<db_user>";
 $password="<db_password>";
@@ -25,7 +25,7 @@ try {
 
 To execute a query it's necessary to "prepare it" with *parameters*.
 
-```php
+```php linenums="1"
 # literal string with markers
 $sql = 'SELECT fields
 FROM tables
@@ -44,7 +44,7 @@ $result = $stmt->fetchAll(PDO::FETCH_CLASS, ClassName::class);  # result as obje
 
 ### Parameter Binding
 
-```php
+```php linenums="1"
 # bindValue
 $stmt = pdo->prepare(sql);
 $stmt->bindValue(':marker', value, PDO::PARAM_<type>);
@@ -64,7 +64,7 @@ Its possible to disable this behaviour setting `PDO::ATTR_STRINGIFY_FETCHES` and
 
 > **Note**: `FETCH_OBJ` abd `FETCH_CLASS` return classes and don't have this behaviour.
 
-```php
+```php linenums="1"
 pdo->setAttribute()
 
 $pdo->setAttribute(PDO::ATTR_STRINGIFY_FETCHES, false);
@@ -77,7 +77,7 @@ $result = $stmt->fetchAll(PDO::FETCH_ASSOC);
 
 ### PDO Debug
 
-```php
+```php linenums="1"
 $stmt = $pdo->prepare($sql);
 $stmt->execute([':marker' => value]);
 $result = $stmt->fetchAll(PDO::FETCH_ASSOC);
@@ -87,7 +87,7 @@ $stmt->debugDumpParams();  # print the SQL query that has been sent to the datab
 
 ## [SQLite3](https://www.php.net/manual/en/book.sqlite3.php)
 
-```php
+```php linenums="1"
 $db = SQLite3("db_file.sqlite3");  // connection
 
 $stmt = $db->prepare("SELECT fields FROM tables WHERE field <operator> :marker");  // prepare query
diff --git a/docs/languages/php/dependency-injection.md b/docs/languages/php/dependency-injection.md
index d7eb626..2c03e3f 100644
--- a/docs/languages/php/dependency-injection.md
+++ b/docs/languages/php/dependency-injection.md
@@ -2,7 +2,7 @@
 
 Explicit definition of a class dependencies with the injection through the constructor or *getters*/*setters*.
 
-```php
+```php linenums="1"
 class Foo
 {
     public function __construct(PDO $pdo)  // depends on PDO
@@ -24,7 +24,7 @@ The dependency injection container for humans. Installation: `composer require p
 - Use of [Reflection](https://www.php.net/manual/en/intro.reflection.php)
 - Configuration of the container through annotations & PHP code.
 
-```php
+```php linenums="1"
 class Foo
 {
     private $bar;
@@ -42,7 +42,7 @@ $foo = $container->get('Foo');  // get instance of Foo (automatic DI of Bar)
 
 ### DIC Configuration
 
-```php
+```php linenums="1"
 // Foo.php
 class Foo
 {
@@ -53,7 +53,7 @@ class Foo
 }
 ```
 
-```php
+```php linenums="1"
 // config.php
 use Psr\Container\ContainerInterface;
 
@@ -68,7 +68,7 @@ return [
 ];
 ```
 
-```php
+```php linenums="1"
 $builder = new \DI\ContainerBuilder();
 $builder->addDefinitions("config.php");  // load config
 $container = $builder->build();  // construct container
diff --git a/docs/languages/php/php.md b/docs/languages/php/php.md
index 3ea9c4a..b9127b5 100644
--- a/docs/languages/php/php.md
+++ b/docs/languages/php/php.md
@@ -2,7 +2,7 @@
 
 [PHP Docs](https://www.php.net/docs.php)
 
-```php
+```php linenums="1"
 declare(strict_types=1);  # activates variable type checking on function arguments
 # single line comment
 //single line comment
@@ -11,7 +11,7 @@ declare(strict_types=1);  # activates variable type checking on function argumen
 
 ## Include, Require
 
-```php
+```php linenums="1"
 include "path\\file.php";  # import an external php file, E_WARNING if fails
 include_once "path\\file.php";  # imports only if not already loaded
 
@@ -23,7 +23,7 @@ require_once "path\\file.php";  # imports only if not already loaded
 
 In `config.php`:
 
-```php
+```php linenums="1"
 //config.php
 
 //store configuration options in associative array
@@ -33,7 +33,7 @@ return [
 ]
 ```
 
-```php
+```php linenums="1"
 $config = include "config.php";  // retrieve config and store into variable
 ```
 
@@ -41,7 +41,7 @@ $config = include "config.php";  // retrieve config and store into variable
 
 [PSR-4 Spec](https://www.php-fig.org/psr/psr-4/)
 
-```php
+```php linenums="1"
 namespace Foo\Bar\Baz;   # set namespace for all file contents, \ for nested namespaces
 
 use <PHP_Class>  # using a namespace hides standard php classes (WHY?!?)
@@ -68,7 +68,7 @@ fnn\func();  # use function from Foo\Bar\Baz
 
 ## Basics
 
-```php
+```php linenums="1"
 declare(strict_types=1);  # activates type checking
 # single line comment
 //single line comment
@@ -77,7 +77,7 @@ declare(strict_types=1);  # activates type checking
 
 ### Screen Output
 
-```php
+```php linenums="1"
 echo "string";  # string output
 echo 'string\n';  # raw string output
 printf("format", $variables);  # formatted output of strings and variables
@@ -86,7 +86,7 @@ sprintf("format", $variables);  # return formatted string
 
 ### User Input
 
-```php
+```php linenums="1"
 $var = readline("prompt");
 
 # if readline is not installed
@@ -105,7 +105,7 @@ if (!function_exists('readline')) {
 
 ## Variables
 
-```php
+```php linenums="1"
 $variableName = value;  # weakly typed
 echo gettype(&variable);  # output type of variable
 
@@ -114,7 +114,7 @@ var_dump($var);  # prints info of variable (bit dimension, type & value)
 
 ### Integers
 
-```php
+```php linenums="1"
 &max = PHP_INT_MAX;  # max value for int type -> 9223372036854775807
 &min = PHP_INT_MIN;  # min value for int type -> -9223372036854775808
 &bytes = PHP_INT_SIZE;  # bytes for int type -> 8
@@ -127,7 +127,7 @@ var_dump($var);  # prints info of variable (bit dimension, type & value)
 
 ### Double
 
-```php
+```php linenums="1"
 $a = 1.234; // 1.234
 $b = 1.2e3; // 1200
 $c = 7E-10; // 0.0000000007
@@ -163,14 +163,14 @@ A string is a sequence of ASCII characters. In PHP a string is an array of chara
 
 ### String Concatenation
 
-```php
+```php linenums="1"
 $string1 . $string2; # method 1
 $string1 .= $string2;  # method 2
 ```
 
 ### String Functions
 
-```php
+```php linenums="1"
 strlen($string);  # returns the string length
 strpos($string, 'substring');  # position of substring in string
 substr($string, start, len);  # extract substring of len from position start
@@ -184,7 +184,7 @@ $var = sprintf("format", $variables)  # construct and return a formatted string
 
 ## Constants
 
-```php
+```php linenums="1"
 define ('CONSTANT_NAME', 'value')
 ```
 
@@ -201,7 +201,7 @@ define ('CONSTANT_NAME', 'value')
 
 Heterogeneous sequence of values.
 
-```php
+```php linenums="1"
 $array = (sequence_of_items);  # array declaration and valorization
 $array = [sequence_of_items];  # array declaration and valorization
 
@@ -216,7 +216,7 @@ $array[] = value;  # value appending
 
 Array of array. Can have arbitrary number of nested array
 
-```php
+```php linenums="1"
 $matrix = [
     [1, 2, 3],
     [4, 5, 6],
@@ -228,14 +228,14 @@ $matrix = [
 
 Single instruction to print whole array is ``
 
-```php
+```php linenums="1"
 $array = [1, 2, 3];
 print_r($array);  # print all the array values
 ```
 
 ### Array Functions
 
-```php
+```php linenums="1"
 count($array);  # returns number of items in the array
 array_sum($array)  # sum of the array value
 sort($array);  # quick sort
@@ -263,7 +263,7 @@ list($array1 [, $array2, ...]) = $data;  # Python-like tuple unpacking
 
 Associative arrays have a value as an index. Alternative names are _hash tables_ or _dictionaries_.
 
-```php
+```php linenums="1"
 $italianDay = [
     'Mon' => 'Lunedì',
     'Tue' => 'Martedì',
@@ -309,14 +309,14 @@ With `==` a string evaluates to `0`.
 
 ### Ternary Operator
 
-```php
+```php linenums="1"
 condition ? result_if_true : result_if_false;
 condition ?: result_if_false;
 ```
 
 ### NULL Coalesce
 
-```php
+```php linenums="1"
 $var1 = $var2 ?? value;  # if variable == NULL assign value, otherwise return value of $var2
 
 # equivalent to
@@ -325,7 +325,7 @@ $var1 = isset($var2) ? $var2 : value
 
 ### Spaceship Operator
 
-```php
+```php linenums="1"
 $a <=> $b;
 
 # equivalent to
@@ -339,7 +339,7 @@ if $a < $b
 
 ### `If` - `Elseif` - `Else`
 
-```php
+```php linenums="1"
 if (condition) {
   # code here
 } elseif (condition) {
@@ -359,7 +359,7 @@ endif;
 
 ### Switch Case
 
-```php
+```php linenums="1"
 # weak comparison
 switch ($var) {
     case value:
@@ -385,7 +385,7 @@ switch (true) {
 
 `match` can return values, doesn't require break statements, can combine conditions, uses strict type comparisons and doesn't do any type coercion.
 
-```php
+```php linenums="1"
 $result = match($input) {
     0 => "hello",
     '1', '2', '3' => "world",
@@ -396,7 +396,7 @@ $result = match($input) {
 
 ### For, Foreach
 
-```php
+```php linenums="1"
 for (init, condition, increment){
     # code here
 }
@@ -421,7 +421,7 @@ foreach($sequence as $key => $value) {
 
 ### While, Do-While
 
-```php
+```php linenums="1"
 while (condition) {
     # code here
 }
@@ -447,7 +447,7 @@ do {
 
 Parameters with default values are optional in the function call and must be the last ones in the function declaration. Return type is optional if type checking is disabled.
 
-```php
+```php linenums="1"
 declare(strict_types=1);  # activates type checking
 
 /**
@@ -475,7 +475,7 @@ function functionName (type $parameter, $parameter = default_value): Type
 
 ### Void function
 
-```php
+```php linenums="1"
 function functionName (type $parameter, $parameter = default_value): Void
 {
     # code here
@@ -484,7 +484,7 @@ function functionName (type $parameter, $parameter = default_value): Void
 
 ### Passing a parameter by reference (`&$`)
 
-```php
+```php linenums="1"
 function functionName (type &$parameter): Type
 {
     # code here
@@ -494,7 +494,7 @@ function functionName (type &$parameter): Type
 
 ### Variable number of parameters, variadic operator (`...`)
 
-```php
+```php linenums="1"
 function functionName (type $parameter, ...$args): Type
 function functionName (type $parameter, type ...$args): Type
 {
@@ -505,7 +505,7 @@ function functionName (type $parameter, type ...$args): Type
 
 ### Nullable parameters
 
-```php
+```php linenums="1"
 function functionName (?type $parameter): ?Type
 {
     # code here
@@ -515,7 +515,7 @@ function functionName (?type $parameter): ?Type
 
 ## Anonymous Functions (Closure)
 
-```php
+```php linenums="1"
 # declaration and assignment to variable
 $var = function (type $parameter) {
     # code here
@@ -526,7 +526,7 @@ $var($arg);
 
 ### Use Operator
 
-```php
+```php linenums="1"
 # use imports a variable into the closure
 $foo = function (type $parameter) use ($average) {
     # code here
@@ -537,7 +537,7 @@ $foo = function (type $parameter) use ($average) {
 
 **Union types** are a collection of two or more types which indicate that _either_ one of those _can be used_.
 
-```php
+```php linenums="1"
 public function foo(Foo|Bar $input): int|float;
 ```
 
@@ -546,7 +546,7 @@ public function foo(Foo|Bar $input): int|float;
 Named arguments allow to pass in values to a function, by specifying the value name, to avoid taking their order into consideration.
 It's also possible to skip optional parameters.
 
-```php
+```php linenums="1"
 function foo(string $a, string $b, ?string $c = null, ?string $d = null) { /* … */ }
 
 foo(
@@ -568,7 +568,7 @@ foo(
 
 ### Class Declaration & Instantiation
 
-```php
+```php linenums="1"
 # case insensitive
 class ClassName
 {
@@ -611,7 +611,7 @@ $object instanceof ClassName  // check type of the object
 Inside static methods it's impossible to use `$this`.
 A static variable is unique for the class and all instances.
 
-```php
+```php linenums="1"
 class ClassName {
 
     public static $var;
@@ -636,7 +636,7 @@ $obj::$var;  // access to the static variable
 
 Parameters of the dependency can be modified before passing the required class to the constructor.
 
-```php
+```php linenums="1"
 class ClassName
 {
     private $dependency;
@@ -653,7 +653,7 @@ class ClassName
 If a class is defined `final` it can't be extended.
 If a function is declared `final` it can't be overridden.
 
-```php
+```php linenums="1"
 class Child extends Parent
 {
     public __construct() {
@@ -666,7 +666,7 @@ class Child extends Parent
 
 Abstract classes cannot be instantiated;
 
-```php
+```php linenums="1"
 abstract class ClassName
 {
     # code here
@@ -679,7 +679,7 @@ An interface is a "contract" that defines what methods the implementing classes
 
 A class can implement multiple interfaces but there must be no methods in common between interface to avoid ambiguity.
 
-```php
+```php linenums="1"
 interface InterfaceName {
 
     // it is possible to define __construct
@@ -703,7 +703,7 @@ It can be used to mitigate the problem of _multiple inheritance_, which is absen
 
 In case of functions name conflict it's possible to use `insteadof` to specify which function to use. It's also possible to use an _alias_ to resolve the conflicts.
 
-```php
+```php linenums="1"
 trait TraitName {
     // code here
 }
@@ -716,7 +716,7 @@ class ClassName {
 
 ### Anonymous Classes
 
-```php
+```php linenums="1"
 $obj = new ClassName;
 
 $obj->method(new class implements Interface {
@@ -728,7 +728,7 @@ $obj->method(new class implements Interface {
 
 ## Serialization & JSON
 
-```php
+```php linenums="1"
 $serialized = serialize($obj);  # serialization
 $obj = unserialize($serialized);  # de-serialization
 
@@ -740,7 +740,7 @@ $json = json_encode($value);  # Returns a string containing the JSON representat
 
 ### Read/Write on Files
 
-```php
+```php linenums="1"
 file(filename);  // return file lines in an array
 
 // problematic with large files (allocates memory to read all file, can fill RAM)
@@ -750,7 +750,7 @@ file_get_contents(filename);  // read whole file
 
 ## Regular Expressions
 
-```php
+```php linenums="1"
 preg_match('/PATTERN/', string $subject, array $matches);  # returns 1 if the pattern matches given subject, 0 if it does not, or FALSE if an error occurred
 # $matches[0] = whole matched string
 # $matches[i] = i-th group of the regex
@@ -774,7 +774,7 @@ Supported hashing algrithms:
 - `joaat`
 - `haval128,3`, `haval160,3`, `haval192,3`, `haval224,3`, `haval256,3`, `haval128,4`, `haval160,4`, `haval192,4`, `haval224,4`, `haval256,4`, `haval128,5`, `haval160,5`, `haval192,5`, `haval224,5`, `haval256,5`
 
-```php
+```php linenums="1"
 hash($algorithm, $data);
 ```
 
@@ -804,7 +804,7 @@ Algorithms currently supported:
 - **time_cost** (integer) - Maximum amount of time it may take to compute the Argon2 hash. Defaults to PASSWORD_ARGON2_DEFAULT_TIME_COST.
 - **threads** (integer) - Number of threads to use for computing the Argon2 hash. Defaults to PASSWORD_ARGON2_DEFAULT_THREADS.
 
-```php
+```php linenums="1"
 password_hash($password, $algorithm);  # create a new password hash using a strong one-way hashing algorithm.
 password_verify($password, $hash);  # Verifies that a password matches a hash
 ```
@@ -817,17 +817,17 @@ Types of PHP errors:
 - **Warning**: generated at runtime, does not stop the execution (non-blocking).
 - **Notice**: informative errors or messages, non-blocking.
 
-```php
+```php linenums="1"
 $a = new StdClass()
 $a->foo();  // PHP Fatal Error: foo() does not exist
 ```
 
-```php
+```php linenums="1"
 $a = 0;
 echo 1/$a;  // PHP Warning: Division by zero
 ```
 
-```php
+```php linenums="1"
 echo $a;  // PHP Notice: $a undefined
 ```
 
@@ -837,7 +837,7 @@ echo $a;  // PHP Notice: $a undefined
 
 Its possible to configure PHP to signal only some type of errors. Errors below a certain levels are ignored.
 
-```php
+```php linenums="1"
 error_reporting(E_<type>);  // set error report threshold (for log file)
 // does not disable PARSER ERROR
 
@@ -847,7 +847,7 @@ ini_set("error_log", "path\\error.log");  // set log file
 
 ### Triggering Errors
 
-```php
+```php linenums="1"
 // generate E_USER_ errors
 trigger_error("message");  // default type: E_USER_NOTICE
 trigger_error("message", E_USER_<Type>);
@@ -859,7 +859,7 @@ trigger_error("Deprecated Function", E_USER_DEPRECATED);
 
 It's possible to use log files unrelated to the php log file.
 
-```php
+```php linenums="1"
 error_log("message", 3, "path\\log.log");  // write log message to a specified file
 
 //example
@@ -870,7 +870,7 @@ error_log(sprintf("[%s] Error: _", date("Y-m-d h:i:s")), 3, "path\\log.log")
 
 PHP offers the possibility to handle errors with the _exception model_.
 
-```php
+```php linenums="1"
 try {
     // dangerous code
 } catch(ExceptionType1 | ExceptionType2 $e) {
@@ -884,7 +884,7 @@ throw new ExceptionType("message");  // throw an exception
 
 All exceptions in PHP implement the interface `Throwable`.
 
-```php
+```php linenums="1"
 Interface Throwable {
     abstract public string getMessage ( void )
     abstract public int getCode ( void )
@@ -899,7 +899,7 @@ Interface Throwable {
 
 ### Custom Exceptions
 
-```php
+```php linenums="1"
 /**
  * Define a custom exception class
  */
diff --git a/docs/languages/php/plates-templating.md b/docs/languages/php/plates-templating.md
index 7c7c4bb..387b805 100644
--- a/docs/languages/php/plates-templating.md
+++ b/docs/languages/php/plates-templating.md
@@ -6,7 +6,7 @@ To separate HTML code and PHP code it's possible to use **templates** with marke
 Variables are created in the PHP code and are passed to the template in the **rendering** phase.
 The server transmits only the `index.php` file to the user. The php file renders the templates as needed.
 
-```html
+```html linenums="1"
 <html>
     <head>
         <title><?= $this->e($title)?></title>
@@ -24,7 +24,7 @@ Plates is a template engine for PHP. A template engine permits to separate the P
 
 Installation through composer: `composer require league/plates`.
 
-```php
+```php linenums="1"
 # index.php
 require "vendor/autoload.php";
 
@@ -38,7 +38,7 @@ echo $templates->render("template_name", [
 ]);
 ```
 
-```php
+```php linenums="1"
 # template.php
 <html>
     <head>
@@ -60,7 +60,7 @@ In a layout it's possible to create a section called **content** that identifies
 
 > **Note**: Since only the template has the data passed eventual loops have to be done there.
 
-```php
+```php linenums="1"
 # index.php
 require 'vendor/autoload.php';
 use League\Plates\Engine;
@@ -68,7 +68,7 @@ $template = new Engine('/path/to/templates');
 echo $template->render('template_name', [ "marker" => value, ... ]);
 ```
 
-```php
+```php linenums="1"
 # template.php
 
 # set the layout used for this template
@@ -78,7 +78,7 @@ echo $template->render('template_name', [ "marker" => value, ... ]);
 <p> <?= $this->e($marker) ?> </p>
 ```
 
-```php
+```php linenums="1"
 # layout.php
 <html>
     <head>
@@ -101,7 +101,7 @@ In general the output validation allows to prevent [Cross-Site Scripting][owasp-
 
 ### Folders
 
-```php
+```php linenums="1"
 # index.php
 $templates->addFolder("alias", "path/to/template/folder");  # add a template folder
 echo $templates->render("folder::template");  # use a template in a specific folder
@@ -111,7 +111,7 @@ echo $templates->render("folder::template");  # use a template in a specific fol
 
 It's possible to inject templates in a layout or template. It is done by using the `insert()` function.
 
-```php
+```php linenums="1"
 # layout.php
 <html>
     <head>
@@ -132,7 +132,7 @@ It's possible to inject templates in a layout or template. It is done by using t
 It's possible to insert page contest from another template with the `section()` function.
 The content to be inserted must be surrounded with by the `start()` and `stop()` functions.
 
-```php
+```php linenums="1"
 # template.php
 
 <?php $this->start("section_name") ?>  # start section
diff --git a/docs/languages/php/psr-7.md b/docs/languages/php/psr-7.md
index 378c8f5..63b53b6 100644
--- a/docs/languages/php/psr-7.md
+++ b/docs/languages/php/psr-7.md
@@ -14,7 +14,7 @@ Standard of the PHP Framework Interop Group that defines common interfaces for h
 
 Example:
 
-```php
+```php linenums="1"
 // empty array if not found
 $header = $request->getHeader('Accept');
 
diff --git a/docs/languages/php/simple-mvc/rest-api.md b/docs/languages/php/simple-mvc/rest-api.md
index d497b1a..b4b0593 100644
--- a/docs/languages/php/simple-mvc/rest-api.md
+++ b/docs/languages/php/simple-mvc/rest-api.md
@@ -2,7 +2,7 @@
 
 ## Routing (Example)
 
-```php
+```php linenums="1"
 // config/route.php
 return [   
    [ 'GET', '/api/user[/{id}]', Controller\User::class ],
@@ -14,7 +14,7 @@ return [
 
 ## Controller (Example)
 
-```php
+```php linenums="1"
 public class UserController implements ControllerInterface
 {
     public function __construct(UserModel $user)
diff --git a/docs/languages/php/simple-mvc/simple-mvc.md b/docs/languages/php/simple-mvc/simple-mvc.md
index 29b0253..44bb928 100644
--- a/docs/languages/php/simple-mvc/simple-mvc.md
+++ b/docs/languages/php/simple-mvc/simple-mvc.md
@@ -6,18 +6,17 @@ This framework is mainly used as tutorial for introducing the Model-View-Control
 
 [php-di]: https://php-di.org/
 [fastroute]: https://github.com/nikic/FastRoute
-[psr7]:https://github.com/Nyholm/psr7
 [plates]: https://platesphp.com/
 
 ## Installation
 
-```ps1
+```ps1 linenums="1"
 composer create-project ezimuel/simple-mvc
 ```
 
 ## Structure
 
-```txt
+```txt linenums="1"
 |- config
 |  |- container.php --> DI Container Config (PHP-DI)
 |  |- route.php --> routing
@@ -35,7 +34,7 @@ composer create-project ezimuel/simple-mvc
 
 ### `index.php`
 
-```php
+```php linenums="1"
 <?php
 declare(strict_types=1);
 
@@ -99,7 +98,7 @@ $controller->execute($request);
 
 ### `route.php`
 
-```php
+```php linenums="1"
 <?php
 use SimpleMVC\Controller;
 
@@ -112,7 +111,7 @@ return [
 
 ### `container.php`
 
-```php
+```php linenums="1"
 <?php
 use League\Plates\Engine;
 use Psr\Container\ContainerInterface;
@@ -131,7 +130,7 @@ return [
 
 Each controller *must* implement this interface.
 
-```php
+```php linenums="1"
 <?php
 declare(strict_types=1);
 
diff --git a/docs/languages/php/unit-tests.md b/docs/languages/php/unit-tests.md
index 9d03a5d..d40a355 100644
--- a/docs/languages/php/unit-tests.md
+++ b/docs/languages/php/unit-tests.md
@@ -4,11 +4,11 @@
 
 ### Dev-Only Installation
 
-```ps1
+```ps1 linenums="1"
 composer require --dev phpunit/phpunit
 ```
 
-```json
+```json linenums="1"
     "require-dev": {
         "phpunit/phpunit": "<version>"
     }
@@ -18,7 +18,7 @@ composer require --dev phpunit/phpunit
 
 PHPUnit can be configured in a XML file called `phpunit.xml`:
 
-```xml
+```xml linenums="1"
 <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
          bootstrap="vendor/autoload.php"
@@ -46,7 +46,7 @@ PHPUnit can be configured in a XML file called `phpunit.xml`:
 A test is a method of a *test class* prefixed with `test`.  
 PHPUnit is executed from the command line with `vendor/bin/phpunit  --colors`.
 
-```php
+```php linenums="1"
 namespace App;
 
 class Filter
@@ -58,7 +58,7 @@ class Filter
 }
 ```
 
-```php
+```php linenums="1"
 namespace App\Test;
 use PHPUnit\Framework\TestCase;
 use App\Filter;
@@ -92,7 +92,7 @@ class FilterTest extends TestCase
 
 ### [PHPUnit Testing Exceptions](https://phpunit.readthedocs.io/en/9.3/writing-tests-for-phpunit.html#testing-exceptions)
 
-```php
+```php linenums="1"
 public function testAggiungiEsameException(string $esame)
 {
     $this->expectException(Exception::class);
@@ -131,7 +131,7 @@ public function testNoExceptions(string $esame)
 
 ### Test Setup & Teardown (Example)
 
-```php
+```php linenums="1"
 class ClassTest extends TestCase
 {
     // initialize the test
@@ -157,7 +157,7 @@ class ClassTest extends TestCase
 
 ### Data Provider
 
-```php
+```php linenums="1"
 class DataTest extends TestCase
 {
     /**
@@ -195,7 +195,7 @@ class DataTest extends TestCase
 
 ### Mock Objects
 
-```php
+```php linenums="1"
 class UnitTest extends TestCase
 {
     public function setUp()
@@ -225,6 +225,6 @@ class UnitTest extends TestCase
 
 ### Code Coverage (needs [XDebug](https://xdebug.org/))
 
-```ps1
+```ps1 linenums="1"
 vendor/bin/phpunit --coverage-text  # code coverage analysis in the terminal
 ```
diff --git a/docs/languages/php/web.md b/docs/languages/php/web.md
index bdb1953..2814286 100644
--- a/docs/languages/php/web.md
+++ b/docs/languages/php/web.md
@@ -4,7 +4,7 @@
 
 Command Line Web Server in PHP, useful in testing phase. Limited since handles only one request at a time. **Do not use in production**.
 
-```ps1
+```ps1 linenums="1"
 PHP -S <ip:post>  # start web server
 PHP -S <ip:post> -t /path/to/folder  # execute in specified folder at specified address
 PHP -S <ip:post> file.php  # redirect requests to single file
@@ -22,7 +22,7 @@ Handling of HTTP requests happens using the following global variables:
 
 ### `$_FILES`
 
-```html
+```html linenums="1"
 <!-- method MUST BE post -->
 <!-- must have enctype="multipart/form-data" attribute -->
 <form name="<name>" action="file.php" method="POST" enctype="multipart/form-data">
@@ -33,7 +33,7 @@ Handling of HTTP requests happens using the following global variables:
 
 Files in `$_FILES` are memorized in a system temp folder. They can be moved with `move_uploaded_file()`
 
-```php
+```php linenums="1"
 if (! isset($_FILES['photo']['error'])) {
     http_response_code(400);  # send a response code
     echo'<h1>No file has been sent</h1>';
@@ -61,7 +61,7 @@ echo'<h1>File successfully sent</h1>';
 
 Request Header Access:
 
-```php
+```php linenums="1"
 $_SERVER["REQUEST_METHOD"];
 $_SERVER["REQUEST_URI"];
 $_SERVER["SERVER_PROTOCOL"];  // HTTP Versions
@@ -83,7 +83,7 @@ All sites **must** have a page for the consensus about using cookies.
 **Cookies** are HTTP headers used to memorize key-value info *on the client*. They are sent from the server to the client to keep track of info on the user that is visiting the website.  
 When a client receives a HTTP response that contains `Set-Cookie` headers it has to memorize that info and reuse them in future requests.
 
-```http
+```http linenums="1"
 Set-Cookie: <cookie-name>=<cookie-value>
 Set-Cookie: <cookie-name>=<cookie-value>; Expires=<date>
 Set-Cookie: <cookie-name>=<cookie-value>; Max-Age=<seconds>
@@ -97,13 +97,13 @@ Anyone can modify the contents of a cookie; for this reason cookies **must not c
 
 When a client has memorized a cookie, it is sent in successive HTTP requests through the `Cookie` header.
 
-```http
+```http linenums="1"
 Cookie: <cookie-name>=<cookie-value>
 ```
 
 [PHP setcookie docs](https://www.php.net/manual/en/function.setcookie.php)
 
-```php
+```php linenums="1"
 setcookie (
 string $name,
 [ string $value = "" ],
@@ -130,7 +130,7 @@ PHP generates a cookie named `PHPSESSID` containing a *session identifier* and a
 To use the session it's necessary to recall the function `session_start()` at the beginning of a PHP script that deals with sessions.  
 After starting the session information in be saved in the `$_SESSION` array.
 
-```php
+```php linenums="1"
 $_SESSION["key"] = value;  // save data in session file (serialized data)
 
 unset($_SESSION["key"]);  // delete data from the session
diff --git a/docs/languages/powershell/commands.md b/docs/languages/powershell/commands.md
index fb7d55c..b47965c 100644
--- a/docs/languages/powershell/commands.md
+++ b/docs/languages/powershell/commands.md
@@ -1,6 +1,6 @@
 # Powershell Commands
 
-```ps1
+```ps1 linenums="1"
 Get-Location  # Gets information about the current working location or a location stack
 Set-Location -Path <path>  # change current working directory to specified path (DEFAULTs to ~)
 Get-ChildItem  -Path <path>  # Gets the items and child items in one or more specified locations.
diff --git a/docs/languages/powershell/scripting.md b/docs/languages/powershell/scripting.md
index 6bce137..094279f 100644
--- a/docs/languages/powershell/scripting.md
+++ b/docs/languages/powershell/scripting.md
@@ -11,20 +11,20 @@ If you do call a cmdlet/PS function with parentheses, it is the same as passing
 
 ## Screen Output
 
-```ps1
+```ps1 linenums="1"
 Write-Host "message"
 ```
 
 ## User Input
 
-```ps1
+```ps1 linenums="1"
 # Reading a value from input:
 $variable = Read-Host "prompt"
 ```
 
 ## Variables
 
-```ps1
+```ps1 linenums="1"
 # Declaration
 [type]$var = value
 $var = value -as [type]
@@ -52,7 +52,7 @@ Write-Host (<expression>)
 
 ### Built-in Variables
 
-```ps1
+```ps1 linenums="1"
 $True, $False  # boolean
 $null  # empty value
 $?  # last program return value
@@ -71,7 +71,7 @@ $Args # Unbound arguments
 
 ### Lists & Dictionaries
 
-```ps1
+```ps1 linenums="1"
 $List = @(5, "ice", 3.14, $True)  # Explicit syntax
 $List = 2, "ice", 3.14, $True  # Implicit syntax
 $List = (1..10)  # Inclusive range
@@ -93,7 +93,7 @@ foreach ($k in $Dict.keys) {
 
 ## Flow Control
 
-```ps1
+```ps1 linenums="1"
 if (condition) {
     # Code here
 } elseif (condition) {
@@ -113,7 +113,7 @@ if (condition) {
 - **File**: Takes input from a file rather than a value statement. If multiple File parameters are included, only the last one is used. Each line of the file is read and evaluated by the Switch statement. The comparison is case-insensitive.
 - **Regex**: Performs regular expression matching of the value to the condition. If the match clause is not a string, this parameter is ignored. The comparison is case-insensitive. The `$matches` automatic variable is available for use within the matching statement block.
 
-```ps1
+```ps1 linenums="1"
 switch(variable) {
     20                      { "Exactly 20"; break }
     { $_ -eq 42 }           { "The answer equals 42"; break }
@@ -142,7 +142,7 @@ switch [-regex|-wildcard|-exact][-casesensitive] -file filename
 
 ### Loops
 
-```ps1
+```ps1 linenums="1"
 # The classic for
 for(setup; condition; iterator) {
     # Code here
@@ -169,7 +169,7 @@ do {
 
 ### Operators
 
-```ps1
+```ps1 linenums="1"
 # Conditionals
 $a -eq $b  # is equal to
 $a -ne $b  # in not equal to
@@ -186,7 +186,7 @@ $True -Or $False
 
 ### Exception Handling
 
-```ps1
+```ps1 linenums="1"
 try {} catch {} finally {}
 try {} catch [System.NullReferenceException] {
     echo $_.Exception | Format-List -Force
@@ -195,7 +195,7 @@ try {} catch [System.NullReferenceException] {
 
 ## [Functions](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_functions?view=powershell-7)
 
-```ps1
+```ps1 linenums="1"
 function func() {}
 
 # function with named parameters
@@ -221,7 +221,7 @@ If the function defines a `Begin`, `Process` or `End` block, all the code **must
 
 If the function has a `Process` keyword, each object in `$input` is removed from `$input` and assigned to `$_`.
 
-```ps1
+```ps1 linenums="1"
 function [<scope:>]<name> [([type]$parameter1[,[type]$parameter2])]
 {
   param([type]$parameter1 [,[type]$parameter2])  # other way to specify named parameters
@@ -236,7 +236,7 @@ function [<scope:>]<name> [([type]$parameter1[,[type]$parameter2])]
 
 Optionally, it's possible to provide a brief help string that describes the default value of the parameter, by adding the `PSDefaultValue` attribute to the description of the parameter, and specifying the `Help` property of `PSDefaultValue`.
 
-```ps1
+```ps1 linenums="1"
 function Func {
   param (
       [PSDefaultValue(Help = defValue)]
@@ -249,7 +249,7 @@ function Func {
 
 ### Parsing Script Arguments
 
-```ps1
+```ps1 linenums="1"
 $args  # array of passed arguments
 $args[$index]  # access to the arguments
 $args.count  # number of arguments
@@ -259,7 +259,7 @@ $args.count  # number of arguments
 
 In `scripts.ps1`:
 
-```ps1
+```ps1 linenums="1"
 param($param1, $param2, ...)  # basic usage
 param($param1, $param2=defvalue, ...)  # with default values
 param([Type] $param1, $param2, ...)  # specify a type
@@ -270,7 +270,7 @@ param([switch]$flag=$false, ...)  # custom flags
 
 In PowerShell:
 
-```ps1
+```ps1 linenums="1"
 .\script.ps1 arg1 arg2  # order of arguments will determine which data goes in which parameter
 
 .\script.ps1 -param2 arg2 -param1 arg1  # custom order
@@ -280,7 +280,7 @@ In PowerShell:
 
 A filter is a type of function that runs on each object in the pipeline. A filter resembles a function with all its statements in a `Process` block.
 
-```ps1
+```ps1 linenums="1"
 filter [<scope:>]<name> {<statement list>}
 ```
 
@@ -288,14 +288,14 @@ filter [<scope:>]<name> {<statement list>}
 
 The syntax for comment-based help is as follows:
 
-```ps1
+```ps1 linenums="1"
 # .<help keyword>
 # <help content>
 ```
 
 or
 
-```ps1
+```ps1 linenums="1"
 <#
 .<help keyword>
 <help content>
@@ -322,7 +322,7 @@ The description of a parameter. Add a `.PARAMETER` keyword for each parameter in
 
 Type the parameter name on the same line as the `.PARAMETER` keyword. Type the parameter description on the lines following the `.PARAMETER` keyword. Windows PowerShell interprets all text between the `.PARAMETER` line and the next keyword or the end of the comment block as part of the parameter description. The description can include paragraph breaks.
 
-```ps1
+```ps1 linenums="1"
 .PARAMETER  <Parameter-Name>
 ```
 
@@ -332,7 +332,7 @@ You can also specify a parameter description by placing a comment in the functio
 
 If you use both a syntax comment and a `.PARAMETER` keyword, the description associated with the `.PARAMETER` keyword is used, and the syntax comment is ignored.
 
-```ps1
+```ps1 linenums="1"
 <#
 .SYNOPSIS
     Short description here
@@ -389,7 +389,7 @@ The keywords that describe the intended use of the function. The **Functionality
 
 Redirects to the help topic for the specified command. You can redirect users to any help topic, including help topics for a function, script, cmdlet, or provider.
 
-```ps1
+```ps1 linenums="1"
 # .FORWARDHELPTARGETNAME <Command-Name>
 ```
 
@@ -397,7 +397,7 @@ Redirects to the help topic for the specified command. You can redirect users to
 
 Specifies the help category of the item in `.ForwardHelpTargetName`. Valid values are `Alias`, `Cmdlet`, `HelpFile`, `Function`, `Provider`, `General`, `FAQ`, `Glossary`, `ScriptCommand`, `ExternalScript`, `Filter`, or `All`. Use this keyword to avoid conflicts when there are commands with the same name.
 
-```ps1
+```ps1 linenums="1"
 # .FORWARDHELPCATEGORY <Category>
 ```
 
@@ -406,7 +406,7 @@ Specifies the help category of the item in `.ForwardHelpTargetName`. Valid value
 Specifies a session that contains the help topic. Enter a variable that contains a **PSSession** object. This keyword is used by the [Export-PSSession](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/export-pssession?view=powershell-7)
 cmdlet to find the help topics for the exported commands.
 
-```ps1
+```ps1 linenums="1"
 # .REMOTEHELPRUNSPACE <PSSession-variable>
 ```
 
@@ -414,7 +414,7 @@ cmdlet to find the help topics for the exported commands.
 
 Specifies an XML-based help file for the script or function.
 
-```ps1
+```ps1 linenums="1"
 # .EXTERNALHELP <XML Help File>
 
 ```
@@ -425,7 +425,7 @@ The `.ExternalHelp` keyword takes precedence over other comment-based help keywo
 
 If the function is exported by a module, set the value of the `.ExternalHelp` keyword to a filename without a path. `Get-Help` looks for the specified file name in a language-specific subdirectory of the module directory. There are no requirements for the name of the XML-based help file for a function, but a best practice is to use the following format:
 
-```ps1
+```ps1 linenums="1"
 <ScriptModule.psm1>-help.xml
 ```
 
@@ -439,7 +439,7 @@ For more information about the cmdlet help XML-based help file format, see [How
 
 ### Classes
 
-```ps1
+```ps1 linenums="1"
 [class]::func()  # use function from a static class
 [class]::attribute  # access to static class attribute
 ```
diff --git a/docs/languages/python/libs/beautiful-soup.md b/docs/languages/python/libs/beautiful-soup.md
index f7cedde..accf205 100644
--- a/docs/languages/python/libs/beautiful-soup.md
+++ b/docs/languages/python/libs/beautiful-soup.md
@@ -2,7 +2,7 @@
 
 ## Making the Soup
 
-```py
+```py linenums="1"
 
 from bs4 import BeautifulSoup
 import requests
@@ -24,7 +24,7 @@ Beautiful Soup transforms a complex HTML document into a complex tree of Python
 
 A Tag object corresponds to an XML or HTML tag in the original document
 
-```py
+```py linenums="1"
 soup = BeautifulSoup('<b class="boldest">Extremely bold</b>', 'html.parser')  # parse HTML/XML
 
 tag = soup.b
@@ -44,7 +44,7 @@ A string corresponds to a bit of text within a tag. Beautiful Soup uses the `Nav
 
 ### Going Down
 
-```py
+```py linenums="1"
 soup.<tag>.<child_tag>  # navigate using tag names
 
 <tag>.contents  # direct children as a list
@@ -61,14 +61,14 @@ soup.<tag>.<child_tag>  # navigate using tag names
 
 ### Going Up
 
-```py
+```py linenums="1"
 <tag>.parent  # tags direct parent (BeautifulSoup has parent None, html has parent BeautifulSoup)
 <tag>.parents  # iterable over all parents
 ```
 
 ### Going Sideways
 
-```py
+```py linenums="1"
 <tag>.previous_sibling
 <tag>.next_sibling
 
@@ -78,7 +78,7 @@ soup.<tag>.<child_tag>  # navigate using tag names
 
 ### Going Back and Forth
 
-```py
+```py linenums="1"
 <tag>.previous_element  # whatever was parsed immediately before
 <tag>.next_element # whatever was parsed immediately afterwards
 
@@ -90,7 +90,7 @@ soup.<tag>.<child_tag>  # navigate using tag names
 
 ## Filter Types
 
-```py
+```py linenums="1"
 soup.find_all("tag")  # by name
 soup.find_all(["tag1", "tag2"])  # multiple tags in a list
 soup.find_all(function)  # based on a bool function
@@ -107,7 +107,7 @@ Methods arguments:
 - `limit` (int). limit number of results
 - `**kwargs`: be turned into a filter on one of a tag's attributes.
 
-```py
+```py linenums="1"
 find_all(name, attrs, recursive, string, limit, **kwargs)  # several results
 find(name, attrs, recursive, string, **kwargs)  # one result
 
@@ -135,7 +135,7 @@ soup.select("css_selector")  # search for CSS selectors of HTML tags
 
 ### Changing Tag Names an Attributes
 
-```py
+```py linenums="1"
 <tag>.name = "new_html_tag"  # modify the tag type
 <tag>["attribute"]  = "value"  # modify the attribute value
 del <tag>["attribute"]  # remove the attribute
diff --git a/docs/languages/python/libs/numpy.md b/docs/languages/python/libs/numpy.md
index 7c616f0..23e41a9 100644
--- a/docs/languages/python/libs/numpy.md
+++ b/docs/languages/python/libs/numpy.md
@@ -2,7 +2,7 @@
 
 ## MOST IMPORTANT ATTRIBUTES ATTRIBUTES
 
-```py
+```py linenums="1"
 array.ndim     # number of axes (dimensions) of the array
 array.shape  # dimensions of the array, tuple of integers
 array.size  # total number of elements in the array
@@ -15,7 +15,7 @@ array.data  # buffer containing the array elements
 Unless explicitly specified `np.array` tries to infer a good data type for the array that it creates.  
 The data type is stored in a special dtype object.
 
-```py
+```py linenums="1"
 var = np.array(sequence)  # creates array
 var = np.asarray(sequence)  # convert input to array
 var = np.ndarray(*sequence)  # creates multidimensional array
@@ -33,7 +33,7 @@ var = np.linspace(start, stop, num_of_elements)  # step of elements calculated b
 
 ## DATA TYPES FOR NDARRAYS
 
-```py
+```py linenums="1"
 var = array.astype(np.dtype)  # copy of the array, cast to a specified type
 # return TypeError if casting fails
 ```
@@ -72,7 +72,7 @@ array_1 `/` array_2 --> element-wise division (`[1, 2, 3] / [3, 2, 1] = [0.33, 1
 
 ## SHAPE MANIPULATION
 
-```py
+```py linenums="1"
 np.reshape(array, new_shape)  # changes the shape of the array
 np.ravel(array)  #  returns the array flattened
 array.resize(shape)  # modifies the array itself
@@ -84,7 +84,7 @@ np.swapaxes(array, first_axis, second_axis)  # interchange two axes of an array
 
 ## JOINING ARRAYS
 
-```py
+```py linenums="1"
 np.vstack((array1, array2))   # takes tuple, vertical stack of arrays (column wise)
 np.hstack((array1, array2))  # takes a tuple, horizontal stack of arrays (row wise)
 np.dstack((array1, array2)) # takes a tuple, depth wise stack of arrays (3rd dimension)
@@ -94,7 +94,7 @@ np.concatenate((array1, array2, ...), axis) # joins a sequence of arrays along a
 
 ## SPLITTING ARRAYS
 
-```py
+```py linenums="1"
 np.split(array, indices)  # splits an array into equall7 long sub-arrays (indices is int), if not possible raises error
 np.vsplit(array, indices)  # splits an array equally into sub-arrays vertically (row wise) if not possible raises error
 np.hsplit(array, indices)  # splits an array equally into sub-arrays horizontally (column wise) if not possible raises error
@@ -104,7 +104,7 @@ np.array_split(array, indices) # splits an array into sub-arrays, arrays can be
 
 ## VIEW()
 
-```py
+```py linenums="1"
 var = array.view()  # creates a new array that looks at the same data
 # slicing returns a view
 # view shapes are separated but assignment changes all arrays
@@ -112,7 +112,7 @@ var = array.view()  # creates a new array that looks at the same data
 
 ## COPY()
 
-```py
+```py linenums="1"
 var = array.copy()  # creates a deep copy of the array
 ```
 
@@ -136,7 +136,7 @@ iteration on first index, use .flat() to iterate over each element
 
 Functions that performs element-wise operations (vectorization).
 
-```py
+```py linenums="1"
 np.abs(array)  # vectorized abs(), return element absolute value
 np.fabs(array)  # faster abs() for non-complex values
 np.sqrt(array)  # vectorized square root (x^0.5)
@@ -193,7 +193,7 @@ np.logical_xor(x_array, y_array)  # vectorized x ^ y
 
 ## CONDITIONAL LOGIC AS ARRAY OPERATIONS
 
-```py
+```py linenums="1"
 np.where(condition, x, y)  # return x if condition == True, y otherwise
 ```
 
@@ -202,7 +202,7 @@ np.where(condition, x, y)  # return x if condition == True, y otherwise
 `np.method(array, args)` or `array.method(args)`.  
 Boolean values are coerced to 1 (`True`) and 0 (`False`).
 
-```py
+```py linenums="1"
 np.sum(array, axis=None)  # sum of array elements over a given axis
 np.median(array, axis=None)  # median along the specified axis
 np.mean(array, axis=None)  # arithmetic mean along the specified axis
@@ -220,21 +220,21 @@ np.cumprod(array, axis=None)  # cumulative sum of the elements along a given axi
 
 ## METHODS FOR BOOLEAN ARRAYS
 
-```py
+```py linenums="1"
 np.all(array, axis=None)  # test whether all array elements along a given axis evaluate to True
 np.any(array, axis=None)  # test whether any array element along a given axis evaluates to True
 ```
 
 ## SORTING
 
-```py
+```py linenums="1"
 array.sort(axis=-1)  # sort an array in-place (axis = None applies on flattened array)
 np.sort(array, axis=-1)  # return a sorted copy of an array (axis = None applies on flattened array)
 ```
 
 ## SET LOGIC
 
-```py
+```py linenums="1"
 np.unique(array)  # sorted unique elements of an array
 np.intersect1d(x, y)  # sorted common elements in x and y
 np.union1d(x, y)  # sorte union of elements
@@ -245,7 +245,7 @@ np.setxor1d()  # Set symmetric differences; elements that are in either of the a
 
 ## FILE I/O WITH ARRAYS
 
-```py
+```py linenums="1"
 np.save(file, array)  # save array to binary file in .npy format
 np.savez(file, *array) # save several arrays into a single file in uncompressed .npz format
 np.savez_compressed(file, *args, *kwargs)  # save several arrays into a single file in compressed .npz format
@@ -266,7 +266,7 @@ np.loadtxt(file, dtype=float, comments="#", delimiter=None)
 
 ## LINEAR ALGEBRA
 
-```py
+```py linenums="1"
 np.diag(array, k=0)  # extract a diagonal or construct a diagonal array
 # K: {int} -- k>0 diagonals above main diagonal, k<0 diagonals below main diagonal (main diagonal k = 0)
 
@@ -290,7 +290,7 @@ np.linalg.lstsq(A, B)  # return the least-squares solution to a linear matrix eq
 
 ## RANDOM NUMBER GENERATION
 
-```py
+```py linenums="1"
 np.random.seed()
 np.random.rand()
 np.random.randn()
diff --git a/docs/languages/python/libs/pandas.md b/docs/languages/python/libs/pandas.md
index 40c249b..fb1fc10 100644
--- a/docs/languages/python/libs/pandas.md
+++ b/docs/languages/python/libs/pandas.md
@@ -2,7 +2,7 @@
 
 ## Basic Pandas Imports
 
-```py
+```py linenums="1"
 import numpy as np
 import pandas as pd
 from pandas import Series, DataFrame
@@ -13,7 +13,7 @@ from pandas import Series, DataFrame
 1-dimensional labelled array, axis label referred as INDEX.  
 Index can contain repetitions.
 
-```py
+```py linenums="1"
 s = Series(data, index=index, name='name')
 # DATA: {python dict, ndarray, scalar value}
 # NAME: {string}
@@ -22,7 +22,7 @@ s = Series(dict)  # Series created from python dict, dict keys become index valu
 
 ### INDEXING / SELECTION / SLICING
 
-```py
+```py linenums="1"
 s['index']  # selection by index label
 s[condition]  # return slice selected by condition
 s[ : ]  # slice endpoint included
@@ -34,7 +34,7 @@ s[condition] = *value  # modify slice by condition
 
 Missing data appears as NaN (Not a Number).
 
-```py
+```py linenums="1"
 pd.isnull(array)  # return a Series index-bool indicating which indexes don't have data
 pd.notnull(array)  # return a Series index-bool indicating which indexes have data
 array.isnull()
@@ -43,7 +43,7 @@ array.notnull()
 
 ### SERIES ATTRIBUTES
 
-```py
+```py linenums="1"
 s.values  # NumPy representation of Series
 s.index  # index object of Series
 s.name = "Series name"  # renames Series object
@@ -52,7 +52,7 @@ s.index.name = "index name"  # renames index
 
 ### SERIES METHODS
 
-```py
+```py linenums="1"
 pd.Series.isin(self, values)  #  boolean Series showing whether elements in Series matches elements in values exactly
 
 # Conform Series to new index, new object produced unless the new index is equivalent to current one and copy=False
@@ -80,7 +80,7 @@ pd.Series.value_counts(self, normalize=False, sort=True, ascending=False, bins=N
 2-dimensional labeled data structure with columns of potentially different types.
 Index and columns can contain repetitions.
 
-```py
+```py linenums="1"
 df = DataFrame(data, index=row_labels, columns=column_labels)
 # DATA: {list, dict (of lists), nested dicts, series, dict of 1D ndarray, 2D ndarray, DataFrame}
 # INDEX: {list of row_labels}
@@ -112,7 +112,7 @@ del df[col]  # delete column
 
 ### DATAFRAME ATTRIBUTES
 
-```py
+```py linenums="1"
 df.index  # row labels
 df.columns  # column labels
 df.values  # NumPy representation of DataFrame
@@ -123,7 +123,7 @@ df.T # transpose
 
 ### DATAFRAME METHODS
 
-```py
+```py linenums="1"
 pd.DataFrame.isin(self , values)  # boolean DataFrame showing whether elements in DataFrame matches elements in values exactly
 
 # Conform DataFrame to new index, new object produced unless the new index is equivalent to current one and copy=False
@@ -146,7 +146,7 @@ Holds axis labels and metadata, immutable.
 
 ### INDEX TYPES
 
-```py
+```py linenums="1"
 pd.Index  # immutable ordered ndarray, sliceable. stores axis labels
 pd.Int64Index  # special case of Index with purely integer labels
 pd.MultiIndex  # multi-level (hierarchical) index object for pandas objects
@@ -156,7 +156,7 @@ pd.DatetimeIndex  # nanosecond timestamps (uses Numpy datetime64)
 
 ### INDEX ATTRIBUTERS
 
-```py
+```py linenums="1"
 pd.Index.is_monotonic_increasing  # Return True if the index is monotonic increasing (only equal or increasing) values
 pd.Index.is_monotonic_decreasing  # Return True if the index is monotonic decreasing (only equal or decreasing) values
 pd.Index.is_unique  # Return True if the index has unique values.
@@ -165,7 +165,7 @@ pd.Index.hasnans  # Return True if the index has NaNs
 
 ### INDEX METHODS
 
-```py
+```py linenums="1"
 pd.Index.append(self, other)  # append a collection of Index options together
 
 pd.Index.difference(self, other, sort=None)  # set difference of two Index objects
@@ -197,7 +197,7 @@ Missing values propagate in arithmetic computations (NaN `<operator>` value = Na
 
 ### ADDITION
 
-```py
+```py linenums="1"
 self + other
 pd.Series.add(self, other, fill_value=None)  # add(), supports substitution of NaNs
 pd,Series.radd(self, other, fill_value=None)  # radd(), supports substitution of NaNs
@@ -210,7 +210,7 @@ pd.DataFrame.radd(self, other, axis=columns, fill_value=None)  # radd(), support
 
 ### SUBTRACTION
 
-```py
+```py linenums="1"
 self - other
 pd.Series.sub(self, other, fill_value=None)  # sub(), supports substitution of NaNs
 pd.Series.radd(self, other, fill_value=None)  # radd(), supports substitution of NaNs
@@ -223,7 +223,7 @@ pd.DataFrame.rsub(self, other, axis=columns, fill_value=None)  # rsub(), support
 
 ### MULTIPLICATION
 
-```py
+```py linenums="1"
 self * other
 pd.Series.mul(self, other, fill_value=None)  # mul(), supports substitution of NaNs
 pd.Series.rmul(self, other, fill_value=None)  # rmul(), supports substitution of NaNs
@@ -236,7 +236,7 @@ pd.DataFrame.rmul(self, other, axis=columns, fill_value=None)  # rmul(), support
 
 ### DIVISION (float division)
 
-```py
+```py linenums="1"
 self / other
 pd.Series.div(self, other, fill_value=None)  # div(), supports substitution of NaNs
 pd.Series.rdiv(self, other, fill_value=None)  # rdiv(), supports substitution of NaNs
@@ -253,7 +253,7 @@ pd.DataFrame.rtruediv(self, other, axis=columns, fill_value=None)  # rtruediv(),
 
 ### FLOOR DIVISION
 
-```py
+```py linenums="1"
 self // other
 pd.Series.floordiv(self, other, fill_value=None)  # floordiv(), supports substitution of NaNs
 pd.Series.rfloordiv(self, other, fill_value=None)  # rfloordiv(), supports substitution of NaNs
@@ -266,7 +266,7 @@ pd.DataFrame.rfloordiv(self, other, axis=columns, fill_value=None)  # rfloordiv(
 
 ### MODULO
 
-```py
+```py linenums="1"
 self % other
 pd.Series.mod(self, other, fill_value=None)  # mod(), supports substitution of NaNs
 pd.Series.rmod(self, other, fill_value=None)  # rmod(), supports substitution of NaNs
@@ -279,7 +279,7 @@ pd.DataFrame.rmod(self, other, axis=columns, fill_value=None)  # rmod(), support
 
 ### POWER
 
-```py
+```py linenums="1"
 other ** self
 pd.Series.pow(self, other, fill_value=None)  # pow(), supports substitution of NaNs
 pd.Series.rpow(self, other, fill_value=None)  # rpow(), supports substitution of NaNs
@@ -296,7 +296,7 @@ pd.DataFrame.rpow(self, other, axis=columns, fill_value=None)  # rpow(), support
 
 NumPy ufuncs work fine with pandas objects.
 
-```py
+```py linenums="1"
 pd.DataFrame.applymap(self, func)  # apply function element-wise
 
 pd.DataFrame.apply(self, func, axis=0, args=())  # apply a function along an axis of a DataFrame
@@ -324,7 +324,7 @@ pd.DataFrame.sort_values(self, axis=0, ascending=True, **kwargs)  # sort object
 
 ### COUNT
 
-```py
+```py linenums="1"
 pd.Series.count(self)  # return number of non-NA/null observations in the Series
 pd.DataFrame.count(self, numeric_only=False)  # count non-NA cells for each column or row
 # NUMERIC_ONLY: {bool} -- Include only float, int or boolean data -- DEFAULT False
@@ -334,7 +334,7 @@ pd.DataFrame.count(self, numeric_only=False)  # count non-NA cells for each colu
 
 Generate descriptive statistics summarizing central tendency, dispersion and shape of dataset's distribution (exclude NaN).
 
-```py
+```py linenums="1"
 pd.Series.describe(self, percentiles=None, include=None, exclude=None)
 pd.DataFrame.describe(self, percentiles=None, include=None, exclude=None)
 # PERCENTILES: {list-like of numbers} -- percentiles to include in output,between 0 and 1 -- DEFAULT [.25, .5, .75]
@@ -344,7 +344,7 @@ pd.DataFrame.describe(self, percentiles=None, include=None, exclude=None)
 
 ### MAX - MIN
 
-```py
+```py linenums="1"
 pd.Series.max(self, skipna=None, numeric_only=None)  # maximum of the values for the requested axis
 pd.Series.min(self, skipna=None, numeric_only=None)  # minimum of the values for the requested axis
 pd.DataFrame.max(self, axis=None, skipna=None, numeric_only=None)  # maximum of the values for the requested axis
@@ -355,7 +355,7 @@ pd.DataFrame.min(self, axis=None, skipna=None, numeric_only=None)  # minimum of
 
 ### IDXMAX - IDXMIN
 
-```py
+```py linenums="1"
 pd.Series.idxmax(self, skipna=True)  # row label of the maximum value
 pd.Series.idxmin(self, skipna=True)  # row label of the minimum value
 pd.DataFrame.idxmax(self, axis=0, skipna=True)  #  Return index of first occurrence of maximum over requested axis
@@ -366,7 +366,7 @@ pd.DataFrame.idxmin(self, axis=0, skipna=True)  #  Return index of first occurre
 
 ### QUANTILE
 
-```py
+```py linenums="1"
 pd.Series.quantile(self, q=0.5, interpolation='linear')  # return values at the given quantile
 pd.DataFrame.quantile(self, q=0.5, axis=0, numeric_only=True, interpolation='linear') # return values at the given quantile over requested axis
 # Q: {flaot, array} -- value between 0 <= q <= 1, the quantile(s) to compute -- DEFAULT 0.5 (50%)
@@ -376,7 +376,7 @@ pd.DataFrame.quantile(self, q=0.5, axis=0, numeric_only=True, interpolation='lin
 
 ### SUM
 
-```py
+```py linenums="1"
 pd.Series.sum(self, skipna=None, numeric_only=None, min_count=0)  # sum of the values
 pd.DataFrame.sum(self, axis=None, skipna=None, numeric_only=None, min_count=0)  # sum of the values for the requested axis
 # AXIS: {0, 1, index, columns} -- axis for the function to be applied on
@@ -387,7 +387,7 @@ pd.DataFrame.sum(self, axis=None, skipna=None, numeric_only=None, min_count=0)
 
 ### MEAN
 
-```py
+```py linenums="1"
 pd.Series.mean(self, skipna=None, numeric_only=None)   # mean of the values
 pd.DataFrame.mean(self, axis=None, skipna=None, numeric_only=None)  # mean of the values for the requested axis
 # AXIS: {0, 1, index, columns} -- axis for the function to be applied on
@@ -397,7 +397,7 @@ pd.DataFrame.mean(self, axis=None, skipna=None, numeric_only=None)  # mean of th
 
 ### MEDIAN
 
-```py
+```py linenums="1"
 pd.Series.median(self, skipna=None, numeric_only=None)  # median of the values
 pd.DataFrame.median(self, axis=None, skipna=None, numeric_only=None)  # median of the values for the requested axis
 # AXIS: {0, 1, index, columns} -- axis for the function to be applied on
@@ -407,7 +407,7 @@ pd.DataFrame.median(self, axis=None, skipna=None, numeric_only=None)  # median o
 
 ### MAD (mean absolute deviation)
 
-```py
+```py linenums="1"
 pd.Series.mad(self, skipna=None)  # mean absolute deviation
 pd.DataFrame.mad(self, axis=None, skipna=None)  # mean absolute deviation of the values for the requested axis
 # AXIS: {0, 1, index, columns} -- axis for the function to be applied on
@@ -416,7 +416,7 @@ pd.DataFrame.mad(self, axis=None, skipna=None)  # mean absolute deviation of the
 
 ### VAR (variance)
 
-```py
+```py linenums="1"
 pd.Series.var(self, skipna=None, numeric_only=None)  # unbiased variance
 pd.DataFrame.var(self, axis=None, skipna=None, ddof=1, numeric_only=None)  #  unbiased variance over requested axis
 # AXIS: {0, 1, index, columns} -- axis for the function to be applied on
@@ -427,7 +427,7 @@ pd.DataFrame.var(self, axis=None, skipna=None, ddof=1, numeric_only=None)  #  un
 
 ### STD (standard deviation)
 
-```py
+```py linenums="1"
 pd.Series.std(self, skipna=None, ddof=1, numeric_only=None)  # sample standard deviation
 pd.Dataframe.std(self, axis=None, skipna=None, ddof=1, numeric_only=None)  # sample standard deviation over requested axis
 # AXIS: {0, 1, index, columns} -- axis for the function to be applied on
@@ -438,7 +438,7 @@ pd.Dataframe.std(self, axis=None, skipna=None, ddof=1, numeric_only=None)  # sam
 
 ### SKEW
 
-```py
+```py linenums="1"
 pd.Series.skew(self, skipna=None, numeric_only=None)  # unbiased skew Normalized bt N-1
 pd.DataFrame.skew(self, axis=None, skipna=None, numeric_only=None)  #  unbiased skew over requested axis Normalized by N-1
 # AXIS: {0, 1, index, columns} -- axis for the function to be applied on
@@ -450,7 +450,7 @@ pd.DataFrame.skew(self, axis=None, skipna=None, numeric_only=None)  #  unbiased
 
 Unbiased kurtosis over requested axis using Fisher's definition of kurtosis (kurtosis of normal == 0.0). Normalized by N-1.
 
-```py
+```py linenums="1"
 pd.Series.kurt(self, skipna=None, numeric_only=None)
 pd.Dataframe.kurt(self, axis=None, skipna=None, numeric_only=None)
 # AXIS: {0, 1, index, columns} -- axis for the function to be applied on
@@ -460,7 +460,7 @@ pd.Dataframe.kurt(self, axis=None, skipna=None, numeric_only=None)
 
 ### CUMSUM (cumulative sum)
 
-```py
+```py linenums="1"
 pd.Series.cumsum(self, skipna=True)  # cumulative sum
 pd.Dataframe.cumsum(self, axis=None, skipna=True)  # cumulative sum over requested axis
 # AXIS: {0, 1, index, columns} -- axis for the function to be applied on
@@ -469,7 +469,7 @@ pd.Dataframe.cumsum(self, axis=None, skipna=True)  # cumulative sum over request
 
 ### CUMMAX - CUMMIN (cumulative maximum - minimum)
 
-```py
+```py linenums="1"
 pd.Series.cummax(self, skipna=True)  # cumulative maximum
 pd.Series.cummin(self, skipna=True)  # cumulative minimum
 pd.Dataframe.cummax(self, axis=None, skipna=True)  # cumulative maximum over requested axis
@@ -480,7 +480,7 @@ pd.Dataframe.cummin(self, axis=None, skipna=True)  # cumulative minimum over req
 
 ### CUMPROD (cumulative product)
 
-```py
+```py linenums="1"
 pd.Series.cumprod(self, skipna=True)  # cumulative product
 pd.Dataframe.cumprod(self, axis=None, skipna=True)  # cumulative product over requested axis
 # AXIS: {0, 1, index, columns} -- axis for the function to be applied on
@@ -492,7 +492,7 @@ pd.Dataframe.cumprod(self, axis=None, skipna=True)  # cumulative product over re
 Calculates the difference of a DataFrame element compared with another element in the DataFrame.  
 (default is the element in the same column of the previous row)
 
-```py
+```py linenums="1"
 pd.Series.diff(self, periods=1)
 pd.DataFrame.diff(self, periods=1, axis=0)
 # PERIODS: {int} -- Periods to shift for calculating difference, accepts negative values -- DEFAULT 1
@@ -503,7 +503,7 @@ pd.DataFrame.diff(self, periods=1, axis=0)
 
 Percentage change between the current and a prior element.
 
-```py
+```py linenums="1"
 pd.Series.Pct_change(self, periods=1, fill_method='pad', limit=None, freq=None)
 pd.Dataframe.pct_change(self, periods=1, fill_method='pad', limit=None)
 # PERIODS:{int} -- periods to shift for forming percent change
@@ -515,7 +515,7 @@ pd.Dataframe.pct_change(self, periods=1, fill_method='pad', limit=None)
 
 ### FILTERING OUT MISSING DATA
 
-```py
+```py linenums="1"
 pd.Series.dropna(self, inplace=False)  # return a new Series with missing values removed
 pd.DataFrame.dropna(axis=0, how='any', tresh=None, subset=None, inplace=False)  # return a new DataFrame with missing values removed
 # AXIS: {tuple, list} -- tuple or list to drop on multiple axes. only a single axis is allowed
@@ -529,7 +529,7 @@ pd.DataFrame.dropna(axis=0, how='any', tresh=None, subset=None, inplace=False)
 
 Fill NA/NaN values using the specified method.
 
-```py
+```py linenums="1"
 pd.Series.fillna(self, value=None, method=None, inplace=False, limit=None)
 pd.DataFrame.fillna(self, value=None, method=None, axis=None, inplace=False, limit=None)
 # VALUE: {scalar, dict, Series, DataFrame} -- value to use to fill holes, dict/Series/DataFrame specifying which value to use for each index or column
@@ -546,7 +546,7 @@ In lower dimensional data structures like Series (1d) and DataFrame (2d).
 
 ### MULTIIINDEX CREATION
 
-```py
+```py linenums="1"
 pd.MultiIndex.from_arrays(*arrays, names=None)  # convert arrays to MultiIndex
 pd.MultiIndex.from_tuples(*arrays, names=None)  # convert tuples to MultiIndex
 pd.MultiIndex.from_frame(df, names=None)  # convert DataFrame to MultiIndex
@@ -559,7 +559,7 @@ pd.DataFrame(*arrays)  # Index constructor makes MultiINdex from DataFrame
 
 Vector of label values for requested level, equal to the length of the index.
 
-```py
+```py linenums="1"
 pd.MultiIndex.get_level_values(self, level)
 ```
 
@@ -567,7 +567,7 @@ pd.MultiIndex.get_level_values(self, level)
 
 Partial selection "drops" levels of the hierarchical index in the result  in a completely analogous way to selecting a column in a regular DataFrame.
 
-```py
+```py linenums="1"
 pd.Series.xs(self, key, axis=0, level=None, drop_level=True)  # cross-section from Series
 pd.DataFrame.xs(self, key, axis=0, level=None, drop_level=True)  #  cross-section from DataFrame
 # KEY: {label, tuple of label} -- label contained in the index, or partially in a MultiIndex
@@ -580,7 +580,7 @@ pd.DataFrame.xs(self, key, axis=0, level=None, drop_level=True)  #  cross-sectio
 
 Multi index keys take the form of tuples.
 
-```py
+```py linenums="1"
 df.loc[('lvl_1', 'lvl_2', ...)]  # selection of single row
 df.loc[('idx_lvl_1', 'idx_lvl_2', ...), ('col_lvl_1', 'col_lvl_2', ...)]  # selection of single value
 
@@ -591,7 +591,7 @@ df.loc[('idx_lvl_1', 'idx_lvl_2') : ('idx_lvl_1', 'idx_lvl_2')]  # slice of rows
 
 ### REORDERING AND SORTING LEVELS
 
-```py
+```py linenums="1"
 pd.MultiIndex.swaplevel(self, i=-2, j=-1)  # swap level i with level j
 pd.Series.swaplevel(self, i=-2, j=-1) # swap levels i and j in a MultiIndex
 pd.DataFrame.swaplevel(self, i=-2, j=-1, axis=0) # swap levels i and j in a MultiIndex on a partivular axis
@@ -604,7 +604,7 @@ pd.MultiIndex.sortlevel(self, level=0, ascending=True, sort_remaining=True)  # s
 
 ## DATA LOADING, STORAGE FILE FORMATS
 
-```py
+```py linenums="1"
 pd.read_fwf(filepath, colspecs='infer', widths=None, infer_nrows=100)  # read a table of fixed-width formatted lines into DataFrame
 # FILEPATH: {str, path object} -- any valid string path is acceptable, could be a URL. Valid URLs: http, ftp, s3, and file
 # COLSPECS: {list of tuple (int, int), 'infer'} -- list of tuples giving extents of fixed-width fields of each line as half-open intervals { [from, to) }
diff --git a/docs/languages/python/libs/requests.md b/docs/languages/python/libs/requests.md
index cb3b728..596567c 100644
--- a/docs/languages/python/libs/requests.md
+++ b/docs/languages/python/libs/requests.md
@@ -4,7 +4,7 @@
 
 Get or retrieve data from specified resource
 
-```py
+```py linenums="1"
 response = requests.get('URL')    # returns response object
 
 # PAYLOAD -> valuable information of response
@@ -18,7 +18,7 @@ The response message consists of:
 - empty line
 - optional message body
 
-```text
+```text linenums="1"
 1xx -> INFORMATIONAL RESPONSE
 2xx -> SUCCESS
     200 OK -> request successful
@@ -28,7 +28,7 @@ The response message consists of:
 5xx -> SERVER ERRORS
 ```
 
-```py
+```py linenums="1"
 # raise exception HTTPError for error status codes
 response.raise_for_status()
 
@@ -41,7 +41,7 @@ response.headers    # response headers (dict)
 
 ### QUERY STRING PARAMETERS
 
-```py
+```py linenums="1"
 response = requests.get('URL', params={'q':'query'})
 response = requests.get('URL', params=[('q', 'query')])
 response = requests.get('URL', params=b'q=query')
@@ -49,7 +49,7 @@ response = requests.get('URL', params=b'q=query')
 
 ### REQUEST HEADERS
 
-```py
+```py linenums="1"
 response = requests.get(
     'URL',
     params={'q': 'query'},
@@ -61,7 +61,7 @@ response = requests.get(
 
 ### DATA INPUT
 
-```py
+```py linenums="1"
 # requests that entity enclosed be stored as a new subordinate of the web resource identified by the URI
 requests.post('URL', data={'key':'value'})
 # requests that the enclosed entity be stored under the supplied URI
@@ -78,13 +78,13 @@ requests.options('URL')
 
 ### SENDING JSON DATA
 
-```py
+```py linenums="1"
 requests.post('URL', json={'key': 'value'})
 ```
 
 ### INSPECTING THE REQUEST
 
-```py
+```py linenums="1"
 # requests lib prepares the requests before sending it
 response = requests.post('URL', data={'key':'value'})
 response.request.something    # inspect request field
@@ -92,7 +92,7 @@ response.request.something    # inspect request field
 
 ## AUTHENTICATION
 
-```py
+```py linenums="1"
 requests.get('URL', auth=('username', 'password'))    # use implicit HTTP Basic Authorization
 
 # explicit HTTP Basic Authorization and other
@@ -103,7 +103,7 @@ requests.get('URL', auth=HTTPBasicAuth('username', getpass()))
 
 ### PERSONALIZED AUTH
 
-```py
+```py linenums="1"
 from requests.auth import AuthBase
 class TokenAuth(AuthBase):
     "custom authentication scheme"
@@ -121,7 +121,7 @@ requests.get('URL', auth=TokenAuth('1234abcde-token'))
 
 ### DISABLING SSL VERIFICATION
 
-```py
+```py linenums="1"
 requests.get('URL', verify=False)
 ```
 
@@ -129,14 +129,14 @@ requests.get('URL', verify=False)
 
 ### REQUEST TIMEOUT
 
-```py
+```py linenums="1"
 # raise Timeout exception if request times out
 requests.get('URL', timeout=(connection_timeout, read_timeout))
 ```
 
 ### MAX RETRIES
 
-```py
+```py linenums="1"
 from requests.adapters import HTTPAdapter
 URL_adapter = HTTPAdapter(max_retries = int)
 session = requests.Session()
diff --git a/docs/languages/python/libs/seaborn.md b/docs/languages/python/libs/seaborn.md
index 0b0d1b3..e2e72c9 100644
--- a/docs/languages/python/libs/seaborn.md
+++ b/docs/languages/python/libs/seaborn.md
@@ -2,7 +2,7 @@
 
 ## Basic Imports For Seaborn
 
-```python
+```python linenums="1"
 import numpy as np
 import pandas as pd
 import matplotlib.pyplot as plt
@@ -15,7 +15,7 @@ sns.set(style='darkgrid')
 
 ## REPLOT (relationship)
 
-```python
+```python linenums="1"
 sns.replot(x='name_in_data', y='name_in_data', hue='point_color', size='point_size', style='point_shape', data=data)
 # HUE, SIZE and STYLE: {name in data} -- used to differentiate points, a sort-of 3rd dimension
 # hue behaves differently if the data is categorical or numerical, numerical uses a color gradient
@@ -38,7 +38,7 @@ sns.scatterplot()  # underlying axis-level function of replot()
 
 Using semantics in lineplot will determine the aggregation of data.
 
-```python
+```python linenums="1"
 sns.replot(ci=None, sort=bool, kind='line')
 sns.lineplot()  # underlying axis-level function of replot()
 ```
@@ -47,7 +47,7 @@ sns.lineplot()  # underlying axis-level function of replot()
 
 Categorical: divided into discrete groups.
 
-```python
+```python linenums="1"
 sns.catplot(x='name_in_data', y='name_in_data', data=data)
 # HUE: {name in data} -- used to differenziate points, a sort-of 3rd dimension
 # COL, ROW: {name in data}  -- categorical variables that will determine the grid of plots
@@ -68,7 +68,7 @@ sns.stripplot()
 
 Adjusts the points along the categorical axis preventing overlap.
 
-```py
+```py linenums="1"
 sns.catplot(kind='swarm')
 sns.swarmplot()
 # SIZE: {float}  -- Diameter of the markers, in points
@@ -84,7 +84,7 @@ sns.boxplot()
 
 Combines a boxplot with the kernel density estimation procedure.
 
-```py
+```py linenums="1"
 sns.catplot(kind='violin')
 sns.violonplot()
 ```
@@ -94,7 +94,7 @@ sns.violonplot()
 Plot similar to boxplot but optimized for showing more information about the shape of the distribution.  
 It is best suited for larger datasets.
 
-```py
+```py linenums="1"
 sns.catplot(kind='boxen')
 sns.boxenplot()
 ```
@@ -103,7 +103,7 @@ sns.boxenplot()
 
 Show point estimates and confidence intervals using scatter plot glyphs.
 
-```py
+```py linenums="1"
 sns.catplot(kind='point')
 sns.pointplot()
 # CI: {float, sd} -- size of confidence intervals to draw around estimated values, sd -> standard deviation
@@ -120,7 +120,7 @@ sns.pointplot()
 
 Show point estimates and confidence intervals as rectangular bars.
 
-```py
+```py linenums="1"
 sns.catplot(kind='bar')
 sns.barplot()
 # CI: {float, sd} -- size of confidence intervals to draw around estimated values, sd -> standard deviation
@@ -134,7 +134,7 @@ sns.barplot()
 
 Show the counts of observations in each categorical bin using bars.
 
-```py
+```py linenums="1"
 sns.catplot(kind='count')
 sns.countplot()
 # DODGE: {bool} -- whether elements should be shifted along the categorical axis if hue is used
@@ -146,7 +146,7 @@ sns.countplot()
 
 Flexibly plot a univariate distribution of observations
 
-```py
+```py linenums="1"
 # A: {series, 1d-array, list}
 sns.distplot(a=data)
 # BINS: {None, arg for matplotlib hist()} -- specification of hist bins, or None to use Freedman-Diaconis rule
@@ -160,7 +160,7 @@ sns.distplot(a=data)
 
 Plot datapoints in an array as sticks on an axis.
 
-```py
+```py linenums="1"
 # A: {vector} -- 1D array of observations
 sns.rugplot(a=data) # -> axes obj with plot on it
 # HEIGHT: {scalar} --  height of ticks as proportion of the axis
@@ -172,7 +172,7 @@ sns.rugplot(a=data) # -> axes obj with plot on it
 
 Fit and plot a univariate or bivariate kernel density estimate.
 
-```py
+```py linenums="1"
 # DATA: {1D array-like} -- input data
 sns.kdeplot(data=data)
 # DATA2 {1D array-like} -- second input data. if present, a bivariate KDE will be estimated.
@@ -185,7 +185,7 @@ sns.kdeplot(data=data)
 
 Draw a plot of two variables with bivariate and univariate graphs.
 
-```py
+```py linenums="1"
 # X, Y: {string, vector} -- data or names of variables in data
 sns.jointplot(x=data, y=data)
 # DATA:{pandas DataFrame} -- DataFrame when x and y are variable names
@@ -203,7 +203,7 @@ sns.jointplot(x=data, y=data)
 
 Plot pairwise relationships in a dataset.
 
-```py
+```py linenums="1"
 # DATA: {pandas DataFrame} -- tidy (long-form) dataframe where each column is a variable and each row is an observation
 sns.pairplot(data=pd.DataFrame)
 # HUE: {string (variable name)} -- variable in data to map plot aspects to different colors
diff --git a/docs/languages/python/libs/tkinter.md b/docs/languages/python/libs/tkinter.md
index 70eb521..1078d79 100644
--- a/docs/languages/python/libs/tkinter.md
+++ b/docs/languages/python/libs/tkinter.md
@@ -2,7 +2,7 @@
 
 ## Standard Imports
 
-```py
+```py linenums="1"
 from tkinter import *  # import Python Tk Binding
 from tkinter import ttk  # import Themed Widgets
 ```
@@ -19,7 +19,7 @@ geometry managers determine size and oder widget drawing properties
 event loop receives events from the OS  
 customizable events provide a callback as a widget configuration
 
-```py
+```py linenums="1"
 widget.bind('event', function)  # method to capture any event and than execute an arbitrary piece of code (generally a function or lambda)
 ```
 
@@ -29,7 +29,7 @@ VIRTUAL EVENT --> hig level event generated by widget (listed in widget docs)
 
 Widgets are objects and all things on screen. All widgets are children of a window.
 
-```py
+```py linenums="1"
 widget_name = tk_object(parent_window)  # widget is inserted into widget hierarchy
 ```
 
@@ -37,7 +37,7 @@ widget_name = tk_object(parent_window)  # widget is inserted into widget hierarc
 
 Displays a single rectangle, used as container for other widgets
 
-```py
+```py linenums="1"
 frame = ttk.Frame(parent, width=None, height=None, borderwidth=num:int)
 # BORDERWIDTH: sets frame border width (default: 0)
 # width, height MUST be specified if frame is empty, otherwise determined by parent geometry manager
@@ -47,7 +47,7 @@ frame = ttk.Frame(parent, width=None, height=None, borderwidth=num:int)
 
 Extra space inside widget (margin).
 
-```py
+```py linenums="1"
 frame['padding'] = num  # same padding for every border
 frame['padding'] = (horizontal, vertical)  # set horizontal THEN vertical padding
 frame['padding'] = (left, top, right, bottom)  # set left, top, right, bottom padding
@@ -60,13 +60,13 @@ frame['relief'] = border_style
 
 Display text or image without interactivity.
 
-```py
+```py linenums="1"
 label = ttk.Label(parent, text='label text')
 ```
 
 ### DEFINING UPDATING LABEL
 
-```py
+```py linenums="1"
 var = StringVar()  # variable containing text, watches for changes. Use get, set methods to interact with the value
 label['textvariable'] = var  # attach var to label (only of type StringVar)
 var.set("new text label")  #  change label text
@@ -74,14 +74,14 @@ var.set("new text label")  #  change label text
 
 ### DISPLAY IMAGES (2 steps)
 
-```py
+```py linenums="1"
 image = PhotoImage(file='filename')  # create image object
 label['image'] = image  # use image config
 ```
 
 ### DISPLAY IMAGE AND-OR TEXT
 
-```py
+```py linenums="1"
 label['compound'] = value
 ```
 
@@ -97,20 +97,20 @@ Compound value:
 
 Specifies edge or corner that the label is attached.
 
-```py
+```py linenums="1"
 label['anchor'] = compass_direction  #compass_direction: n, ne, e, se, s, sw, w, nw, center
 ```
 
 ### MULTI-LINE TEXT WRAP
 
-```py
+```py linenums="1"
 # use \n for multi line text
 label['wraplength'] = size  # max line length
 ```
 
 ### CONTROL TEXT JUSTIFICATION
 
-```py
+```py linenums="1"
 label['justify'] = value  #value: left, center, right
 
 label['relief'] = label_style
@@ -120,7 +120,7 @@ label['background'] = color  # color passed with name or HEX RGB codes
 
 ### FONT STYLE (use with caution)
 
-```py
+```py linenums="1"
 # used outside style option
 label['font'] = font
 ```
@@ -141,19 +141,19 @@ Fonts:
 
 Press to perform some action
 
-```py
+```py linenums="1"
 button = ttk.Button(parent, text='button_text', command=action_performed)
 ```
 
 ### TEXT or IMAGE
 
-```py
+```py linenums="1"
 button['text/textvariable'], button['image'], button['compound']
 ```
 
 ### BUTTON INVOCATION
 
-```py
+```py linenums="1"
 button.invoke()  # button activation in the program
 ```
 
@@ -161,7 +161,7 @@ button.invoke()  # button activation in the program
 
 Activate or deactivate the widget.
 
-```py
+```py linenums="1"
 button.state(['disabled'])            # set the disabled flag, disabling the button
 button.state(['!disabled'])           # clear the disabled flag
 button.instate(['disabled'])          # return true if the button is disabled, else false
@@ -174,7 +174,7 @@ button.instate(['!disabled'], cmd)  # execute 'cmd' if the button is not disable
 
 Button with binary value of some kind (e.g a toggle) and also invokes a command callback
 
-```py
+```py linenums="1"
 checkbutton_var = TkVarType
 check = ttk.Checkbutton(parent, text='button text', command=action_performed, variable=checkbutton_var, onvalue=value_on, offvalue=value_off)
 ```
@@ -189,7 +189,7 @@ checkbutton won't set the linked variable (MUST be done in the program)
 
 ### CONFIG OPTIONS
 
-```py
+```py linenums="1"
 check['text/textvariable']
 check['image']
 check['compound']
@@ -201,7 +201,7 @@ check.instate(['flag'])
 
 Multiple-choice selection (good if options are few).
 
-```py
+```py linenums="1"
 #RADIOBUTTON CREATION (usually as a set)
 radio_var = TkVarType
 radio_1 = ttk.Radiobutton(parent, text='button text', variable=radio_var, value=button_1_value)
@@ -221,7 +221,7 @@ radio.instate(['flag'])
 
 Single line text field accepting a string.
 
-```py
+```py linenums="1"
 entry_var = StringVar()
 entry = ttk.Entry(parent, textvariable=entry_var, width=char_num, show=symbol)
 # SHOW: replaces the entry test with symbol, used for password
@@ -230,7 +230,7 @@ entry = ttk.Entry(parent, textvariable=entry_var, width=char_num, show=symbol)
 
 ### CHANGE ENTRY VALUE
 
-```py
+```py linenums="1"
 entry.get()  # returns entry value
 entry.delete(start, 'end')  # delete between two indices, 0-based
 entry.insert(index, 'text value')  # insert new text at a given index
@@ -238,7 +238,7 @@ entry.insert(index, 'text value')  # insert new text at a given index
 
 ### ENTRY CONFIG OPTIONS
 
-```py
+```py linenums="1"
 radio.state(['flag'])
 radio.instate(['flag'])
 ```
@@ -247,7 +247,7 @@ radio.instate(['flag'])
 
 Drop-down list of available options.
 
-```py
+```py linenums="1"
 combobox_var = StringVar()
 combo = ttk.Combobox(parent, textvariable=combobox_var)
 combobox.get()  # return combobox current value
@@ -259,7 +259,7 @@ combobox.bind('<<ComboboxSelected>>', function)
 
 ### PREDEFINED VALUES
 
-```py
+```py linenums="1"
 combobox['values'] = (value_1, value_2, ...)  # provides a list of choose-able values
 combobox.state(['readonly'])  # restricts choose-able values to those provided with 'values' config option
 # SUGGESTION: call selection clear method on value change (on ComboboxSelected event) to avoid visual oddities
@@ -269,7 +269,7 @@ combobox.state(['readonly'])  # restricts choose-able values to those provided w
 
 Display list of single-line items, allows browsing and multiple selection (part og Tk classic, missing in themed Tk widgets).
 
-```py
+```py linenums="1"
 lstbx = Listbox(parent, height=num, listvariable=item_list:list)
 # listvariable links a variable (MUST BE a list) to the listbox, each element is a item of the listbox
 # manipulation of the list changes the listbox
@@ -277,7 +277,7 @@ lstbx = Listbox(parent, height=num, listvariable=item_list:list)
 
 ### SELECTING ITEMS
 
-```py
+```py linenums="1"
 lstbx['selectmode'] = mode  # MODE: browse (single selection), extended (multiple selection)
 lstbx.curselection()  # returns list of indices of selected items
 # on selection change: generate event <ListboxSelect>
@@ -288,7 +288,7 @@ lstbx.curselection()  # returns list of indices of selected items
 
 ## SCROLLBAR
 
-```py
+```py linenums="1"
 scroll = ttk.Scrollbar(parent, orient=direction, command=widget.view)
 # ORIENT: VERTICAL, HORIZONTAL
 # WIDGET.VIEW: .xview, .yview
@@ -301,7 +301,7 @@ widget.configure(yscrollcommand=scroll.set)
 
 Box in right bottom of widget, allows resize.
 
-```py
+```py linenums="1"
 ttk.Sizegrip(parent).grid(column=999, row=999, sticky=(S, E))
 ```
 
@@ -309,7 +309,7 @@ ttk.Sizegrip(parent).grid(column=999, row=999, sticky=(S, E))
 
 Area accepting multiple line of text.
 
-```py
+```py linenums="1"
 txt = Text(parent, width=num:int, height=num:int, wrap=flag)  # width is character num, height is row num
 # FLAG: none (no wrapping), char (wrap at every character), word (wrap at word boundaries)
 txt['state'] = flag  # FLAG: disabled, normal
@@ -323,7 +323,7 @@ txt.delete(start, end)  # delete range of text
 
 Feedback about progress of lenghty operation.
 
-```py
+```py linenums="1"
 progbar = ttk.Progressbar(parent, orient=direction, length=num:int, value=num, maximum=num:float mode=mode)
 # DIRECTION: VERTICAL, HORIZONTAL
 # MODE: determinate (relative progress of completion), indeterminate (no estimate of completion)
@@ -334,13 +334,13 @@ progbar = ttk.Progressbar(parent, orient=direction, length=num:int, value=num, m
 
 ### DETERMINATE PROGRESS
 
-```py
+```py linenums="1"
 progbar.step(amount)  # increment value of given amount (DEFAULT: 1.0)
 ```
 
 ### INDETERMINATE PROGRESS
 
-```py
+```py linenums="1"
 progbar.start()  # starts progressbar
 progbar.stop()  #stoops progressbar
 ```
@@ -349,7 +349,7 @@ progbar.stop()  #stoops progressbar
 
 Provide a numeric value through direct manipulation.
 
-```py
+```py linenums="1"
 scale = ttk.Scale(parent, orient=DIR, length=num:int, from_=num:float, to=num:float, command=cmd)
 # COMMAND: calls cmd at every scale change, appends current value to func call
 scale['value']  # set or read current value
@@ -361,7 +361,7 @@ scale.get()  # get current value
 
 Choose numbers. The spinbox choses item from a list, arrows permit cycling lits items.
 
-```py
+```py linenums="1"
 spinval = StringVar()
 spin = Spinbox(parent, from_=num, to=num, textvariable=spinval, increment=num, value=lst, wrap=boolean)
 # INCREMENT specifies increment\decrement by arrow button
@@ -402,7 +402,7 @@ A single value for the option puts the same padding on both left and right (or t
 while a two-value list lets you put different amounts on left and right (or top and bottom).  
 To add padding around an entire row or column, the "columnconfigure" and "rowconfigure" methods accept a "pad" option.  
 
-```py
+```py linenums="1"
 widget.grid(column=num, row=num, columnspan=num, rowspan=num, sticky=(), padx=num, pady=num)  # sticky: N, S, E, W
 widget.columnconfigure(pad=num, weight=num)
 widget.rowconfigure(pad=num, weight=num)
@@ -419,7 +419,7 @@ widget.grid_remove(slaves)  # takes a list of slaves, removes slaves from grid (
 
 ### CREATING TOPLEVEL WINDOW
 
-```py
+```py linenums="1"
 tlw = Toplevel(parent)  # parent of root window, no need to grid it
 
 window.destroy()
@@ -429,7 +429,7 @@ window.destroy()
 
 ### CHANGING BEHAVIOR AND STYLE
 
-```py
+```py linenums="1"
 # WINDOW TILE
 window.title()  # returns title of the window
 window.title('new title')  # sets title
@@ -469,7 +469,7 @@ window.deiconify()  # deiconifies window
 
 ### STANDARD DIALOGS
 
-```py
+```py linenums="1"
 # SLEETING FILE AND DIRECTORIES
 # on Windows and Mac invokes underlying OS dialogs directly
 from tkinter import filedialog
@@ -507,7 +507,7 @@ POSSIBLE ALERT/CONFIRMATION RETURN VALUES:
 
 ## SEPARATOR
 
-```py
+```py linenums="1"
 # horizontal or vertical line between groups of widgets
 separator = ttk.Separator(parent, orient=direction)
 # DIRECTION: horizontal, vertical
@@ -532,7 +532,7 @@ pw.forget(position)  # remove widget from pane
 
 Allows switching between multiple pages
 
-```py
+```py linenums="1"
 nb = ttk.Notebook(parent)
 f1 = ttk.Frame(parent, ...)  # child of notebook
 f2 = ttk.Frame(parent, ...)
@@ -555,7 +555,7 @@ nb.tab(tabid, option=value)   # change tab option
 
 Creation of personalized fonts
 
-```py
+```py linenums="1"
 from tkinter import font
 font_name = font.Font(family='font_family', size=num, weight='bold/normal', slant='roman/italic', underline=boolean, overstrike=boolean)
 # FAMILY: Courier, Times, Helvetica (support guaranteed)
@@ -573,7 +573,7 @@ label['image'] = imgobj
 
 #### IMAGES W/ Pillow
 
-```py
+```py linenums="1"
 from PIL import ImageTk, Image
 myimg = ImageTk.PhotoImage(Image.open('filename'))
 ```
diff --git a/docs/languages/python/modules/argparse.md b/docs/languages/python/modules/argparse.md
index 71dc359..af0e746 100644
--- a/docs/languages/python/modules/argparse.md
+++ b/docs/languages/python/modules/argparse.md
@@ -2,7 +2,7 @@
 
 ## Creating a parser
 
-```py
+```py linenums="1"
 import argparse
 
 parser = argparse.ArgumentParser(description="description", allow_abbrev=True)
@@ -25,7 +25,7 @@ parser = argparse.ArgumentParser(description="description", allow_abbrev=True)
 
 ## [Adding Arguments](https://docs.python.org/3/library/argparse.html#the-add-argument-method)
 
-```py
+```py linenums="1"
 ArgumentParser.add_argument("name_or_flags", nargs="...", action="...")
 ```
 
@@ -47,7 +47,7 @@ ArgumentParser.add_argument("name_or_flags", nargs="...", action="...")
 
 `store`: This just stores the argument's value. This is the default action.
 
-```py
+```py linenums="1"
 >>> parser = argparse.ArgumentParser()
 >>> parser.add_argument('--foo')
 >>> parser.parse_args('--foo 1'.split())
@@ -56,7 +56,7 @@ Namespace(foo='1')
 
 `store_const`: This stores the value specified by the const keyword argument. The `store_const` action is most commonly used with optional arguments that specify some sort of flag.
 
-```py
+```py linenums="1"
 >>> parser = argparse.ArgumentParser()
 >>> parser.add_argument('--foo', action='store_const', const=42)
 >>> parser.parse_args(['--foo'])
@@ -65,7 +65,7 @@ Namespace(foo=42)
 
 `store_true` and `store_false`: These are special cases of `store_const` used for storing the values True and False respectively. In addition, they create default values of False and True respectively.
 
-```py
+```py linenums="1"
 >>> parser = argparse.ArgumentParser()
 >>> parser.add_argument('--foo', action='store_true')
 >>> parser.add_argument('--bar', action='store_false')
@@ -76,7 +76,7 @@ Namespace(foo=True, bar=False, baz=True)
 
 `append`: This stores a list, and appends each argument value to the list. This is useful to allow an option to be specified multiple times. Example usage:
 
-```py
+```py linenums="1"
 >>> parser = argparse.ArgumentParser()
 >>> parser.add_argument('--foo', action='append')
 >>> parser.parse_args('--foo 1 --foo 2'.split())
@@ -85,7 +85,7 @@ Namespace(foo=['1', '2'])
 
 `append_const`: This stores a list, and appends the value specified by the const keyword argument to the list. (Note that the const keyword argument defaults to None.) The `append_const` action is typically useful when multiple arguments need to store constants to the same list. For example:
 
-```py
+```py linenums="1"
 >>> parser = argparse.ArgumentParser()
 >>> parser.add_argument('--str', dest='types', action='append_const', const=str)
 >>> parser.add_argument('--int', dest='types', action='append_const', const=int)
@@ -96,7 +96,7 @@ Namespace(types=[<class 'str'>, <class 'int'>])
 `count`: This counts the number of times a keyword argument occurs. For example, this is useful for increasing verbosity levels:
 **Note**: the default will be None unless explicitly set to 0.
 
-```py
+```py linenums="1"
 >>> parser = argparse.ArgumentParser()
 >>> parser.add_argument('--verbose', '-v', action='count', default=0)
 >>> parser.parse_args(['-vvv'])
@@ -107,7 +107,7 @@ Namespace(verbose=3)
 
 `version`: This expects a version= keyword argument in the add_argument() call, and prints version information and exits when invoked:
 
-```py
+```py linenums="1"
 >>> import argparse
 >>> parser = argparse.ArgumentParser(prog='PROG')
 >>> parser.add_argument('--version', action='version', version='%(prog)s 2.0')
@@ -117,7 +117,7 @@ PROG 2.0
 
 `extend`: This stores a list, and extends each argument value to the list. Example usage:
 
-```py
+```py linenums="1"
 >>> parser = argparse.ArgumentParser()
 >>> parser.add_argument("--foo", action="extend", nargs="+", type=str)
 >>> parser.parse_args(["--foo", "f1", "--foo", "f2", "f3", "f4"])
@@ -133,7 +133,7 @@ The `nargs` keyword argument associates a different number of command-line argum
 
 `N` (an integer): N arguments from the command line will be gathered together into a list.
 
-```py
+```py linenums="1"
 >>> parser = argparse.ArgumentParser()
 >>> parser.add_argument('--foo', nargs=2)
 >>> parser.add_argument('bar', nargs=1)
@@ -147,7 +147,7 @@ Namespace(bar=['c'], foo=['a', 'b'])
 
 For optional arguments, there is an additional case: the option string is present but not followed by a command-line argument. In this case the value from const will be produced.
 
-```py
+```py linenums="1"
 >>> parser = argparse.ArgumentParser()
 >>> parser.add_argument('--foo', nargs='?', const='c', default='d')
 >>> parser.add_argument('bar', nargs='?', default='d')
@@ -161,7 +161,7 @@ Namespace(bar='d', foo='d')
 
 `*`: All command-line arguments present are gathered into a list. Note that it generally doesn't make much sense to have more than one positional argument with `nargs='*'`, but multiple optional arguments with `nargs='*'` is possible.
 
-```py
+```py linenums="1"
 >>> parser = argparse.ArgumentParser()
 >>> parser.add_argument('--foo', nargs='*')
 >>> parser.add_argument('--bar', nargs='*')
@@ -172,7 +172,7 @@ Namespace(bar=['1', '2'], baz=['a', 'b'], foo=['x', 'y'])
 
 `+`: All command-line args present are gathered into a list. Additionally, an error message will be generated if there wasn't at least one command-line argument present.
 
-```py
+```py linenums="1"
 >>> parser = argparse.ArgumentParser(prog='PROG')
 >>> parser.add_argument('foo', nargs='+')
 >>> parser.parse_args(['a', 'b'])
@@ -184,7 +184,7 @@ PROG: error: the following arguments are required: foo
 
 `argparse.REMAINDER`: All the remaining command-line arguments are gathered into a list. This is commonly useful for command line utilities that dispatch to other command line utilities.
 
-```py
+```py linenums="1"
 >>> parser = argparse.ArgumentParser(prog='PROG')
 >>> parser.add_argument('--foo')
 >>> parser.add_argument('command')
@@ -195,7 +195,7 @@ Namespace(args=['--arg1', 'XX', 'ZZ'], command='cmd', foo='B')
 
 ## Parsing Arguments
 
-```py
+```py linenums="1"
 # Convert argument strings to objects and assign them as attributes of the namespace. Return the populated namespace.
 ArgumentParser.parse_args(args=None, namespace=None)
 
diff --git a/docs/languages/python/modules/ftplib.md b/docs/languages/python/modules/ftplib.md
index 91f8840..16ecd04 100644
--- a/docs/languages/python/modules/ftplib.md
+++ b/docs/languages/python/modules/ftplib.md
@@ -2,7 +2,7 @@
 
 ## FTP CLASSES
 
-```py
+```py linenums="1"
 ftplib.FTP(host="", user="", password="", acct="")
 # if HOST => connect(host)
 # if USER => login(user, password, acct)
@@ -13,7 +13,7 @@ ftplib.FTP_TLS(host="", user="", password="", acct="")
 
 ## EXCEPTIONS
 
-```py
+```py linenums="1"
 ftplib.error_reply  # unexpected error from server
 ftplib.error_temp  # temporary error (response codes 400-499)
 ftplib.error_perm  # permanent error (response codes 500-599)
@@ -23,7 +23,7 @@ ftplib.all_errors  # tuple of all exceptions
 
 ## FTP OBJECTS
 
-```py
+```py linenums="1"
 # method on text files: -lines
 # method on binary files: -binary
 
diff --git a/docs/languages/python/modules/json.md b/docs/languages/python/modules/json.md
index 599f663..341708f 100644
--- a/docs/languages/python/modules/json.md
+++ b/docs/languages/python/modules/json.md
@@ -34,7 +34,7 @@ WHITESPACE can be inserted between any pair of tokens.
 
 ## Usage
 
-```python
+```python linenums="1"
 
 # serialize obj as JSON formatted stream to fp
 json.dump(obj, fp, cls=None, indent=None, separators=None, sort_keys=False)
@@ -90,7 +90,7 @@ Conversions (Python -> Json):
 
 ## Extending JSONEncoder (Example)
 
-```python
+```python linenums="1"
 import json
 
 class ComplexEncoder(json.JSONEncoder):
@@ -103,7 +103,7 @@ class ComplexEncoder(json.JSONEncoder):
 
 ## Retrieving Data from json dict
 
-```python
+```python linenums="1"
 data = json.loads(json)
 data["key"]  # retrieve the value associated with the key
 data["outer key"]["nested key"]  # nested key value retrieval
diff --git a/docs/languages/python/modules/logging.md b/docs/languages/python/modules/logging.md
index d9311d8..3352a4b 100644
--- a/docs/languages/python/modules/logging.md
+++ b/docs/languages/python/modules/logging.md
@@ -2,7 +2,7 @@
 
 ## Configuration
 
-```python
+```python linenums="1"
 # basic configuration for the logging system
 logging.basicConfig(filename="relpath", level=logging.LOG_LEVEL, format=f"message format", **kwargs)  
 # DATEFMT: Use the specified date/time format, as accepted by time.strftime().
@@ -76,7 +76,7 @@ Log Levels (Low To High):
 - error: `40`
 - critical: `50`
 
-```python
+```python linenums="1"
 logging.debug(msg)  # Logs a message with level DEBUG on the root logger
 logging.info(msg)  # Logs a message with level INFO on the root logger
 logging.warning(msg)  # Logs a message with level WARNING on the root logger
diff --git a/docs/languages/python/modules/shutil.md b/docs/languages/python/modules/shutil.md
index 17f8793..749ccbc 100644
--- a/docs/languages/python/modules/shutil.md
+++ b/docs/languages/python/modules/shutil.md
@@ -2,7 +2,7 @@
 
 High-level file operations
 
-```python
+```python linenums="1"
 # copy file src to fil dst, return dst in most efficient way
 shutil.copyfile(src, dst)
 # dst MUST be complete target name
diff --git a/docs/languages/python/modules/smtplib.md b/docs/languages/python/modules/smtplib.md
index 99acd65..d75589e 100644
--- a/docs/languages/python/modules/smtplib.md
+++ b/docs/languages/python/modules/smtplib.md
@@ -1,6 +1,6 @@
 # SMTPlib Module
 
-```python
+```python linenums="1"
 import smtplib
 
 # SMTP instance that encapsulates a SMTP connection
diff --git a/docs/languages/python/modules/socket.md b/docs/languages/python/modules/socket.md
index 6720ad5..6240689 100644
--- a/docs/languages/python/modules/socket.md
+++ b/docs/languages/python/modules/socket.md
@@ -9,7 +9,7 @@ In this context, sockets are assumed to be associated with a specific socket add
 
 ## Socket Creation & Connection
 
-```python
+```python linenums="1"
 import socket
 
 # socket over the internet, socket is a stream of data
@@ -21,7 +21,7 @@ socket.close()  # close connection
 
 ## Making HTTP Requests
 
-```python
+```python linenums="1"
 import socket
 HTTP_Method = "GET http://url/resource HTTP/version\n\n".encode()  # set HTTP request (encoded string from UTF-8 to bytes)
 socket.send(HTTP_Method)   # make HTTP request
diff --git a/docs/languages/python/modules/sqlite.md b/docs/languages/python/modules/sqlite.md
index bf3f5e3..302a707 100644
--- a/docs/languages/python/modules/sqlite.md
+++ b/docs/languages/python/modules/sqlite.md
@@ -4,14 +4,14 @@
 
 To use the module, you must first create a Connection object that represents the database.
 
-```python
+```python linenums="1"
 import sqlite3
 connection = sqlite3.connect("file.db")
 ```
 
 Once you have a `Connection`, you can create a `Cursor` object and call its `execute()` method to perform SQL commands.
 
-```python
+```python linenums="1"
 cursor = connection.cursor()
 
 cursor.execute(sql)
@@ -31,7 +31,7 @@ it makes your program vulnerable to an [SQL injection attack](https://en.wikiped
 
 Put `?` as a placeholder wherever you want to use a value, and then provide a _tuple of values_ as the second argument to the cursor's `execute()` method.
 
-```python
+```python linenums="1"
 # Never do this -- insecure!
 c.execute("SELECT * FROM stocks WHERE symbol = value")
 
@@ -50,7 +50,7 @@ c.executemany('INSERT INTO stocks VALUES (?,?,?,?,?)', purchases)
 
 ### Writing Operations to Disk
 
-```python
+```python linenums="1"
 cursor = connection.cursor()
 cursor.execute("SQL")
 connection.commit()
@@ -58,7 +58,7 @@ connection.commit()
 
 ### Multiple SQL Instructions
 
-```python
+```python linenums="1"
 connection = sqlite3.connect("file.db")
 cur = con.cursor()
 cur.executescript("""
@@ -73,7 +73,7 @@ con.close()
 
 ### Retrieving Records
 
-```python
+```python linenums="1"
 # Fetches the next row of a query result set, returning a single sequence.
 # Returns None when no more data is available.
 cursor.fetchone()  
diff --git a/docs/languages/python/modules/time-datetime.md b/docs/languages/python/modules/time-datetime.md
index 762d0cf..e02611a 100644
--- a/docs/languages/python/modules/time-datetime.md
+++ b/docs/languages/python/modules/time-datetime.md
@@ -2,7 +2,7 @@
 
 ## Time
 
-```py
+```py linenums="1"
 # epoch: elapsed time in seconds (in UNIX starts from 01-010-1970)
 import time # UNIX time
 variable = time.time () # returns the time (in seconds) elapsed since 01-01-1970
@@ -42,7 +42,7 @@ var = time.perf_counter () # returns the current running time
 
 ## Datetime
 
-```py
+```py linenums="1"
 import datetime
 today = datetime.date.today () # returns current date
 today = datetime.datetime.today () # returns the current date and time
diff --git a/docs/languages/python/modules/unittest.md b/docs/languages/python/modules/unittest.md
index afd9a5d..a70aaf1 100644
--- a/docs/languages/python/modules/unittest.md
+++ b/docs/languages/python/modules/unittest.md
@@ -1,6 +1,6 @@
 # Unittest Module
 
-```py
+```py linenums="1"
 import unittest
 import module_under_test
 
diff --git a/docs/languages/python/python.md b/docs/languages/python/python.md
index 1751d40..4bc9fa6 100644
--- a/docs/languages/python/python.md
+++ b/docs/languages/python/python.md
@@ -8,7 +8,7 @@ Class -> PascalCase
 Method, Function -> snake_case  
 Variable -> snake_case
 
-```py
+```py linenums="1"
 # standard comment
 '''multiline comment'''
 """DOCSTRING"""
@@ -38,7 +38,7 @@ string.whitespace
 
 ### Assignment Operation
 
-```py
+```py linenums="1"
 """instructions to the right of = executed before instructions to the left of ="""
 variable = expression # the type of the variable is dynamically decided by python based on the content
 var_1, var_2 = value1, value2 # parallel assignment
@@ -56,7 +56,7 @@ x = a or b # If bool (a) returns False, then x is assigned the value of b
 
 ### Expression Assignment
 
-```py
+```py linenums="1"
 (var: = expression) # assign an expression to a variable to avoid repeating the expression
 ```
 
@@ -67,7 +67,7 @@ x = a or b # If bool (a) returns False, then x is assigned the value of b
 
 ### On Screen Output
 
-```py
+```py linenums="1"
 print() # print blank line and wrap
 print('string' * n) # print string n times
 print('string1 \ n string2') # wrap with \ n
@@ -131,7 +131,7 @@ Format: `[[fill]align] [sign] [#] [width] [grouping] [.precision] [type]`
 
 ### Keyboard Input
 
-```py
+```py linenums="1"
 # input always returns a STRING
 s = input() # input request without message
 s = input('Prompt') # request input
@@ -144,7 +144,7 @@ list = [int(x) for x in input('prompt'). split('separator')]
 
 ## Numeric Types
 
-```py
+```py linenums="1"
 a = 77
 b = 1_000_000 # underscore can be used to separate groups of digits
 c = -69
@@ -189,7 +189,7 @@ It is worth checking if the difference between the numbers is small enough.
 
 ## Strings
 
-```py
+```py linenums="1"
 
 string = 'string content' # assignment and creation of string variable
 string = '''multi
@@ -266,7 +266,7 @@ string.center(width, 'char') # stretch the string with char to width
 
 ## Lists
 
-```py
+```py linenums="1"
 list = [9, 11, 'WTC', -5.6, True] # lists can contain data of different types
 
 list[3] # indexing
@@ -339,7 +339,7 @@ var = [(exp_1, exp_2) for item_1 in seq_1 for item_2 in seq_2] # -> [(..., ...),
 
 ## Tuple
 
-```py
+```py linenums="1"
 # TUPLES CANNOT BE MODIFIED
 tuple = (69, 420, 69, 'abc') # tuple assignment
 tuple = (44,) # single element tuples need a comma
@@ -370,7 +370,7 @@ var_1, * body, var_2, var_3 = sequence # var_1 = seq [0], body = seq [1: -2], va
 
 ## Set
 
-```py
+```py linenums="1"
 # SETS MAY NOT CONTAIN REPEATED ELEMENTS (THEY ARE OMITTED)
 # THE ORDER DOES NOT MATTER (NO SLICING, INDEXING, REPETITION, ...)
 set = {10, 20, 30, 'abc', 20}
@@ -426,7 +426,7 @@ var[i, ...] # -> shortcut for var [i,:,:,:,]
 
 ## Bytes e Bytearray
 
-```py
+```py linenums="1"
 # THE BYTES CANNOT BE MODIFIED OR INDEXED
 # THE BYTEARRAYS CAN BE MODIFIED AND INDEXED
 # YOU CANNOT DO REPETITION AND SLICING ON BYTE OR BYTEARRAY
@@ -453,7 +453,7 @@ Unicode Literals:
 - `\U00000041` --> 'A'
 - `\x41` --> 'A'
 
-```py
+```py linenums="1"
 # ENCODING
 # transform string into literal byte
 # UnicodeEncodeError on error
@@ -494,7 +494,7 @@ def fold_equal (str_1, str_2):
 
 ## Memoryview
 
-```py
+```py linenums="1"
 # memoryview objects allow python to access the data inside the object
 # without copy if it supports the buffer protocol
 v = memoryview(object) # create a memoryview with reference to object
@@ -538,7 +538,7 @@ v.shape # tuple of integers indicating the shape of the memoryview
 
 ## Dictionaries
 
-```py
+```py linenums="1"
 # SET OF KEY-VALUE PAIRS
 d = {1: 'Alex', 2: 'Bob', 3: 'Carl'}
 d = dict (one = 'Alex', two = 'Bob', three = 'Carl')
@@ -677,7 +677,7 @@ built-in objects considered *false*:
 
 ### `if-else`
 
-```py
+```py linenums="1"
 if (condition):
     # code here
 elif (condition):
@@ -688,7 +688,7 @@ else:
 
 ### Context Manager
 
-```py
+```py linenums="1"
 with resource as target:
      # code here
 
@@ -709,7 +709,7 @@ contextmanager.__exit__(self, exc_type, exc_value, traceback)
 
 ### `while`
 
-```py
+```py linenums="1"
 while(condition):
      # code here
 else:
@@ -720,7 +720,7 @@ else:
 
 ### `for`
 
-```py
+```py linenums="1"
 for index in sequence: # sequence can be a list, set, tuple, etc ..
      # code here
 else:
@@ -742,21 +742,21 @@ for key, value in dict.items ():
 
 ### `range`
 
-```py
+```py linenums="1"
 range(start, end, step) # generate sequence num integers (does not include num stops) with possible step
 list(range(start, end, step)) # return sequence of integers in a list
 ```
 
 ### `enumerate`
 
-```py
+```py linenums="1"
 enumerate(iterable) # iterable of item & index pairs
 list(enumerate(iterable)) # returns list of tuples [(1, iterable [0]), (2, iterable [1]), (3, iterable [2])]
 ```
 
 ### `zip`
 
-```py
+```py linenums="1"
 list_1 = [1, 2, 3, 4, 5]
 list_2 = ['a', 'b', 'c', 'd', 'e']
 
@@ -766,7 +766,7 @@ list(zip(list_1, list_2)) # returns list of tuples by merging list [(list_1 [0],
 
 ### `shuffle` & `randint`
 
-```py
+```py linenums="1"
 from random import shuffle, randint
 shuffle(iterable) # shuffle the list
 randint(start, end) # returns a random integer between start and end
@@ -774,7 +774,7 @@ randint(start, end) # returns a random integer between start and end
 
 ### `in`
 
-```py
+```py linenums="1"
 item in iterable # check for the presence of item in iterable (returns True or False)
 ```
 
@@ -782,7 +782,7 @@ item in iterable # check for the presence of item in iterable (returns True or F
 
 ### Function Definition
 
-```py
+```py linenums="1"
 def function_name (parameters):
      "" "DOCSTRING" ""
      # code here
@@ -795,14 +795,14 @@ def function_name (parameters):
 - parameters between `/` and `*` can be *positional* or *keyworded*
 - parameters after `*` can only be *keyworded*
   
-```py
+```py linenums="1"
 def func (a, b, /, c, d, *, e, f):
      # code here
 ```
 
 ### Docstring Style
 
-```py
+```py linenums="1"
 """function description
 
 Args:
@@ -823,14 +823,14 @@ Raises:
 
 When used in combination `*args` always goes before`**kwargs` (in def function and in function call)
 
-```py
+```py linenums="1"
 def func(*args, **kwargs):
     # code here
 ```
 
 ### Function with default parameters
 
-```py
+```py linenums="1"
 def function(parameter1 = value1, parameter2 = value3): # default values in case of omitted use of arguments in the call
      # code here
      return expression
@@ -840,7 +840,7 @@ function(parameter2 = value2, parameter1 = value1) # arguments passed with keywo
 
 ### Global And Local Variables
 
-```py
+```py linenums="1"
 # global scope
 
 def external_func():
@@ -859,7 +859,7 @@ def external_func():
 
 `Note`: variables declared inside a function are not usable outside
 
-```py
+```py linenums="1"
 def function():
      # global statement makes a variable global
      # actions on global variable within the function also have an effect outside
@@ -887,7 +887,7 @@ Operation `iter()`:
 
 ### `next()` & `iter()`
 
-```py
+```py linenums="1"
 next(iterable) # next item of the iterable or error StopIteration
 
 iter(object) # get an iterator from an object
@@ -900,7 +900,7 @@ iter(callable_obj, sentinel)
 
 Used to generate a sequence of values to be used once (they are not stored)
 
-```py
+```py linenums="1"
 def custom_generator(parameters):
      while condition: # or for loop
          yield variable # returns the value without terminating the function, values passed to the caller without storing in a variable
@@ -912,7 +912,7 @@ for item in custom_generator(parameters):
 
 ### Termination Generator And Exception Handling
 
-```py
+```py linenums="1"
 # raise exception at the suspension point and return generator value
 # if the generator terminates without returning values it raises StopIteration
 # if an exception is not handled it is propagated to the caller
@@ -926,7 +926,7 @@ generator.close()
 
 ### Generator Comprehensions
 
-```py
+```py linenums="1"
 # zero-length sequence (instantaneously generated values)
 var = (for expression iterable in sequence if condition)
 # EDUCATION ENUMERATE ()
@@ -937,7 +937,7 @@ enumerate(sequence) # -> enumerate object
 
 ## Coroutines
 
-```py
+```py linenums="1"
 def simple_coroutine():
     """coroutine defined as a generator: yield in block"""
 
@@ -994,7 +994,7 @@ coroutine.close()
 **SUBGENERATOR**: generator obtained from `yield from`
 **CALLER-CLIENT**: code calling *delegating generator*
 
-The main function of `yield from` is to open a bidirectional channel between the external caller (* client *) and the internal * subgenerator * so that values and exceptions can pass between the two.
+The main function of `yield from` is to open a bidirectional channel between the external caller (*client*) and the internal *subgenerator* so that values and exceptions can pass between the two.
 
 1. client calls delegating generator, delegating generator calls subgenerator
 2. exhausted subgenerator returns value to `yield from <expr>` (`return <result>` statement)
@@ -1020,7 +1020,7 @@ The main function of `yield from` is to open a bidirectional channel between the
   - If this call results in an exception, it is propagated to the delegating generator.
   - Otherwise, `GeneratorExit` is raised in the delegating generator
 
-```py
+```py linenums="1"
 def sub_gen():
      sent_input = yield
      # result of sub_gen() returned to delegating_gen()
@@ -1040,7 +1040,7 @@ def client():
 
 Possible use within functions. Useful for replacing functions if the logic is simple.
 
-```py
+```py linenums="1"
 var = lambda argument_list: <expression>
 ```
 
@@ -1048,7 +1048,7 @@ var = lambda argument_list: <expression>
 
 ### Class Definition
 
-```py
+```py linenums="1"
 class Class:
 
     static_var = expression
@@ -1077,7 +1077,7 @@ class Class:
 
 ### Setter & Getter with `@Property`
 
-```py
+```py linenums="1"
 class Class:
      def __init__(self, parameter):
          self.__parameter = parameter
@@ -1102,7 +1102,7 @@ The `__slots__` attribute implements the **Flyweight Design Pattern**: it saves
 
 ### Inner Classes
 
-```py
+```py linenums="1"
 class Class:
      def __init__(self, parameters):
          ...
@@ -1122,7 +1122,7 @@ object_2 = Class.InnerClass(arguments) # inner class created as object of the 'e
 
 Special methods are defined by the use of double underscores; they allow the use of specific functions (possibly adapted) on the objects defined by the class.
 
-```py
+```py linenums="1"
 class Class():
 
      def __init__(self, parameters):
@@ -1148,7 +1148,7 @@ del object # delete object
 
 **Note**: if the operator cannot be applied, returns `NotImplemented`
 
-```py
+```py linenums="1"
 # arithmetic operators
 __add__(self, other)         # +
 __sub__(self, other)         # -
@@ -1309,7 +1309,7 @@ however, if the underlying method is linear (as it would be with a linked list),
 
 ### Inheritance
 
-```py
+```py linenums="1"
 class Parent ():
     def __init __ (self, parameters):
         ...
@@ -1350,7 +1350,7 @@ class Child(Parent): # parent class in brackets to inherit properties
 
 **Note**: python does not support method overloading
 
-```py
+```py linenums="1"
 # DUCKTYPING
 # Working with objects regardless of their type, as long as they implement certain protocols
 
@@ -1396,7 +1396,7 @@ Virtual subclasses are used to include third-party classes as subclasses of a cl
 
 The `@Class.register` or `Class.register(subclass)` decorators are used to mark subclasses.
 
-```py
+```py linenums="1"
 from abc import abstractmethod, ABC
 
 class Abstract(ABC): # abstract class MUST INHERIT from parent class ABC
@@ -1429,7 +1429,7 @@ class Child(Abstract):
 
 ## Exception Handling
 
-```py
+```py linenums="1"
 # CHECK ASERATIONS
 assert condition, 'error message' # if the assertion is false show an error message
 
@@ -1490,7 +1490,7 @@ Open binary file mode:
 
 **Note**: Linux and MacOSX use `UTF-8` everywhere while windows uses `cp1252`, `cp850`,`mbcs`, `UTF-8`. Don't rely on default encoding and use **explicitly** `UTF-8`.
 
-```py
+```py linenums="1"
 object = open('filename', mode = 'r', encoding = 'utf-8') # encoding MUST BE utf-8 for compatibility
 # filename can be the absolute path to the file location (default: file created in the source code folder)
 # double slash to avoid \ escaping
@@ -1525,7 +1525,7 @@ else:
 **SHALLOW COPY**: copies the "container" and references to the content
 **DEEP COPY**: copies the "container" and contents (no reference)
 
-```py
+```py linenums="1"
 copy (x) # returns shallow copy of xor
 deepcopy (x) # returns shallow copy of x
 ```
diff --git a/docs/languages/rust/cargo.md b/docs/languages/rust/cargo.md
index 1c7729f..2e8d5e7 100644
--- a/docs/languages/rust/cargo.md
+++ b/docs/languages/rust/cargo.md
@@ -2,7 +2,7 @@
 
 ## Creating a project
 
-```ps1
+```ps1 linenums="1"
 cargo new project_name  # creates project folder and basic files
 cargo new --vcs=git project_name  # init project as git repo
 ```
@@ -11,7 +11,7 @@ cargo new --vcs=git project_name  # init project as git repo
 
 Inside the project directory:
 
-```ps1
+```ps1 linenums="1"
 cargo build  # build project and download eventual needed dependencies
 cargo build --release  # build project for release (build + optimisations)
 cargo run  # executes the built executable
@@ -22,7 +22,7 @@ cargo check  # verifies buildability without producing an executable
 
 In `Cargo.toml`:
 
-```toml
+```toml linenums="1"
 [dependencies]
 crate_name = "<version_number>"
 ```
@@ -70,7 +70,7 @@ A path can take two forms:
 
 Both absolute and relative paths are followed by one or more identifiers separated by double colons (`::`).
 
-```rs
+```rs linenums="1"
 module::function();  // rel path (same crate)
 super::function();;  // rel path starting in outer module (same crate)
 
@@ -88,7 +88,7 @@ The way privacy works in Rust is that all items (functions, methods, structs, en
 Items in a parent module can’t use the private items inside child modules, but items in child modules can use the items in their ancestor modules.  
 The reason is that child modules wrap and hide their implementation details, but the child modules can see the context in which they’re defined.
 
-```rs
+```rs linenums="1"
 mod module {
     fn func() {}
 }
@@ -109,7 +109,7 @@ In contrast, if an enum is made public, all of its variants are then public.
 
 ### `use`
 
-```rs
+```rs linenums="1"
 use <crate_name>::module;  // import module (abs path, other crate)
 use crate::module;  // import module (abs path, same crate)
 use self::module;  // import module (rel path, same crate)
@@ -125,7 +125,7 @@ module::function();  // use func w/ shorter path
 
 ## Separating into multiple files
 
-```txt
+```txt linenums="1"
 src
 |_main.rs  --> default executable file
 |_lib.rs  --> default library file
@@ -134,7 +134,7 @@ src
 |  |_submodule.rs --> submodule
 ```
 
-```rs
+```rs linenums="1"
 // main.rs
 mod module;  // declare module directory as a module
 
diff --git a/docs/languages/rust/rust.md b/docs/languages/rust/rust.md
index 543b814..57ba083 100644
--- a/docs/languages/rust/rust.md
+++ b/docs/languages/rust/rust.md
@@ -2,7 +2,7 @@
 
 ## Basics
 
-```rs
+```rs linenums="1"
 use <module>;  // bring a type into scope
 
 fn main() {  //program entry point
@@ -12,7 +12,7 @@ fn main() {  //program entry point
 
 ### Standard Output
 
-```rs
+```rs linenums="1"
 // macro (func have no "!")
 println!("Value: {}", value);  // {} is a placeholder for a value or variable
 println!("Values: {1}, {0}", value1, value2);  // use index to print values
@@ -30,7 +30,7 @@ print!();
 
 ### Standard Input
 
-```rs
+```rs linenums="1"
 use io;
 
 let mut buffer = String::new();
@@ -50,7 +50,7 @@ An associated function is implemented on a type rather than on a particular inst
 
 By default variables are *immutable*.
 
-```rs
+```rs linenums="1"
 let var1 = value;  // immutable var init
 let var2: Type = value;  // explicit type annotation
 
@@ -68,7 +68,7 @@ By using let, it's possible to perform a few transformations on a value but have
 The other difference between *mut* and *shadowing* is that because we're effectively creating a new variable when we use the let keyword again,  
 we can change the type of the value but reuse the same name.
 
-```rs
+```rs linenums="1"
 let x: u32 = 10;
 let x: i32 = 11;  // shadowing
 ```
@@ -88,7 +88,7 @@ let x: i32 = 11;  // shadowing
 
 #### Explicit Mathematical Operations (Integers)
 
-```rs
+```rs linenums="1"
 i32::MAX.checked_add(value);  // Option<i32> => None if overflow
 i32::MAX.wrapping_add(value);  // i32 => Wrap around
 i32::MAX.saturating_add(value);  //  i32 => MIN <= x <= MAX (Clamp)
@@ -164,7 +164,7 @@ Rust's `char` type is the language's most primitive alphabetic type.
 
 Rust's `char` type is four bytes in size and represents a Unicode Scalar Value: range from `U+0000` to `U+D7FF` and `U+E000` to `U+10FFFF` inclusive.
 
-```rs
+```rs linenums="1"
 let c: char = 'C';  // SINGLE QUOTES
 let c: char = '\u{261D}';  // Unicode Code Point U+261D
 let c: char = '\x2A';  // ASCII for *
@@ -179,7 +179,7 @@ std::char::from:digit(2, 10);  // Some(2)
 
 ### String Types
 
-```rs
+```rs linenums="1"
 let s = String::new();  // create empty string
 let s = String::from("string literal");  // construct string from literal
 
@@ -205,7 +205,7 @@ s.push_str(""); // appending string literals
 A tuple is a general way of grouping together a number of values with a variety of types into one compound type.  
 Tuples have a *fixed length*: once declared, they cannot grow or shrink in size.
 
-```rs
+```rs linenums="1"
 let tup: (i32, f64, u8) = (500, 6.4, 1);
 let tup = (500, 6.4, 1);
 
@@ -219,7 +219,7 @@ tup.0 = value;  // member access & update (mut be mutable)
 Every element of an array must have the *same type*. Arrays in Rust have a fixed length, like tuples.  
 An array isn't as flexible as the `vector` type, though. A vector is a similar collection type provided by the standard library that *is allowed to grow or shrink in size*.
 
-```rs
+```rs linenums="1"
 let array = [0, 1, 2, 3, 4];
 let array: [Type; length] = [...];
 let array: [value; length];  // repeat expression (same as python's [value] * length)
@@ -249,7 +249,7 @@ The reverse is not possible since the slice lacks some information about the Str
 
 > **Note**: When working with functions is easier to always expect a `&str` instead of a `&String`.
 
-```rs
+```rs linenums="1"
 let s = String::from("string literal");
 let slice: &str = &s[start..end];
 
@@ -262,7 +262,7 @@ sequence[..end]  // slice from start to end (excluded)
 
 ### Type Aliases
 
-```rs
+```rs linenums="1"
 type Alias = T;
 ```
 
@@ -275,7 +275,7 @@ The curly brackets tell the compiler where the function body begins and ends.
 
 Rust doesn't care where the functions are defined, only that they're defined somewhere.
 
-```rs
+```rs linenums="1"
 fn func(param: Type) {  // parameters MUST have the Type annotation
     // code here
 }
@@ -301,7 +301,7 @@ fn func() {
 
 ### if - else if - else
 
-```rs
+```rs linenums="1"
 if condition {
     // [...]
 } else if condition {
@@ -313,13 +313,13 @@ if condition {
 
 ### let if
 
-```rs
+```rs linenums="1"
 let var = if condition { value } else { value };  // returned types must be the same
 ```
 
 ### [if-let](https://doc.rust-lang.org/rust-by-example/flow_control/if_let.html)
 
-```rs
+```rs linenums="1"
 if let <pattern> = <expr> {
     <block1>
 } else {
@@ -335,20 +335,20 @@ match <expr> {
 
 ### loop
 
-```rs
+```rs linenums="1"
 // loop's forever if not explicitly stopped (return or break)
 loop { }
 ```
 
 ### while
 
-```rs
+```rs linenums="1"
 while condition { }
 ```
 
 ### for
 
-```rs
+```rs linenums="1"
 for item in sequence.iter() { }
 for item in sequence.iter_mut() { }  // iterate over mutable items
 
@@ -362,7 +362,7 @@ for i in (start..end) { }
 
 ### Range
 
-```rs
+```rs linenums="1"
 ..  // RangeFull
 a ..  // RangeFrom { start: a }
 .. b  // RangeTo { end: b }
@@ -373,7 +373,7 @@ a ..= b  // RangeInclusive::new(a, b)
 
 ### `break` & `continue`
 
-```rs
+```rs linenums="1"
 while <condition> {
     // [...]
 
@@ -449,7 +449,7 @@ Cloning is an explicit action, `x.clone()`. The implementation of Clone can prov
 
 Rust won't allow to annotate a type with the `Copy` trait if the type, or any of its parts, has implemented the `Drop` trait.  
 
-```rs
+```rs linenums="1"
 let s = String::new()
 let t = s;  // MOVE, s is now uninitialized
 let u = t.clone();  // deep copy, t is still valid
@@ -462,7 +462,7 @@ let x = n;  // x holds a COPY of the VALUE of n
 
 The semantics for passing a value to a function are similar to those for assigning a value to a variable. Passing a variable to a function will move or copy, just as assignment does.
 
-```rs
+```rs linenums="1"
 fn main() {
     let s = String::from("hello");  // s comes into scope
 
@@ -487,7 +487,7 @@ fn makes_copy(some_integer: i32) { // some_integer comes into scope
 
 Returning values can also transfer ownership.
 
-```rs
+```rs linenums="1"
 fn main() {
     let s1 = gives_ownership();         // gives_ownership moves its return value into s1
 
@@ -537,7 +537,7 @@ A data race is similar to a race condition and happens when these three behavior
 - At least one of the pointers is being used to write to the data.  
 - There's no mechanism being used to synchronize access to the data.
 
-```rs
+```rs linenums="1"
 fn borrow(var: &Type) {  // &Type indicates that the var is a reference
     // here var cannot be modified
 } // when var goes out of scope it doesn't get dropped because the scope didn't own it
@@ -554,7 +554,7 @@ fn borrow2(var: &mut Type) {
 
 The `.` operator can **implicitly borrow or dereference** a reference
 
-```rs
+```rs linenums="1"
 let struct = Struct { field: /* [...] */ }
 let ref = &struct;
 
@@ -578,7 +578,7 @@ To define a struct enter the keyword struct and name the entire struct.
 A struct's name should describe the significance of the pieces of data being grouped together.  
 Then, inside curly brackets, define the names and types of the pieces of data, which we call *fields*.
 
-```rs
+```rs linenums="1"
 struct Struct {
     field: Type,
     ...
@@ -591,7 +591,7 @@ struct UnitStruct;  // no field, useful in generics
 
 To use a struct after defining it, create an instance of that struct by specifying concrete values for each of the fields.
 
-```rs
+```rs linenums="1"
 let mut var = Struct {
     field: value,
     ...
@@ -600,7 +600,7 @@ let mut var = Struct {
 
 ### Field Init Shorthand
 
-```rs
+```rs linenums="1"
 let mut var = Struct {
     field,  // shortened form since func param is named as the struct's field
     ...
@@ -613,7 +613,7 @@ var.field = value;  // member access
 
 ### Struct Update Syntax
 
-```rs
+```rs linenums="1"
 let struct1 = Struct {
     field1: value,
     field2: value,
@@ -631,7 +631,7 @@ let struct2 = Struct {
 Use Tuple Structs to create different types easily.  
 To define a **tuple struct**, start with the `struct` keyword and the struct name followed by the types in the tuple.
 
-```rs
+```rs linenums="1"
 struct Point(i32, i32, i32);
 struct Color(i32, i32, i32);
 
@@ -640,7 +640,7 @@ let origin = Point(0, 0, 0);
 
 ### Struct Printing
 
-```rs
+```rs linenums="1"
 #[derive(Debug)]  // inherit the debug trait
 struct Struct { }
 
@@ -650,7 +650,7 @@ println!("{:?}", s)  // debug output: { field: value, ... }
 
 ### Associated Functions & Type-Associated Functions (aka Methods)
 
-```rs
+```rs linenums="1"
 struct Struct { };
 impl Struct
 {
@@ -667,7 +667,7 @@ Struct::type_associated_function(arg);
 
 ### Associated Consts
 
-```rs
+```rs linenums="1"
 struct Struct {
     const ASSOCIATED_CONST: Type = <value>;
 }
@@ -680,7 +680,7 @@ Struct::ASSOCIATED_CONST;
 A Trait is a collection of methods representing a set of behaviours necessary to accomplish some task.  
 Traits can be used as generic types constraints and can be implemented by data types.
 
-```rs
+```rs linenums="1"
 trait Trait {
     fn method_signature(&self, param: Type) -> Type;
     fn method_signature(&self, param: Type) -> Type {
@@ -701,7 +701,7 @@ impl Trait for Struct {
 
 ### Fully Qualified Method Calls
 
-```rs
+```rs linenums="1"
 value.method();
 Type::method(value);
 Trait::method(value);
@@ -726,7 +726,7 @@ Derivable Traits:
 - `Default`
 - `Debug`
 
-```rs
+```rs linenums="1"
 #[derive(Trait)]  // derive a trait for the struct
 #[derive(Trait, Trait, ...)]  // derive multiple traits
 struct Struct {
@@ -738,7 +738,7 @@ struct Struct {
 
 Trait Bound are used to require a generic to implement specific traits and guarantee that a type will have the necessary behaviours.
 
-```rs
+```rs linenums="1"
 fn generic_method<T: RequiredTrait>() {}
 fn generic_method<T: RequiredTrait + RequiredTrait>() {}  // multiple bounds
 // or
@@ -760,7 +760,7 @@ fn method_signature(param: &(impl TraitOne + TraitTwo)) -> Type {}
 
 ### Trait Extensions
 
-```rs
+```rs linenums="1"
 extern crate foo;
 use foo::Foo;
 
@@ -784,7 +784,7 @@ Rust accomplishes this by performing *monomorphization* of the code that is usin
 Monomorphization is the process of turning generic code into specific code by filling in the concrete types that are used when compiled.
 For this reason if a function as a trait as return type (trait bound), only a single type that implements the trait can be returned.
 
-```rs
+```rs linenums="1"
 struct GenericStruct<T, U> {
     T generic_field,
     U generic_field,
@@ -817,10 +817,10 @@ fn generic<T: Trait>() -> Type { }  // use generic constraint
 
 ### Associated Types
 
-_Associated types_ connect a type placeholder with a trait such that the trait method definitions can use these placeholder types in their signatures.  
+*Associated types* connect a type placeholder with a trait such that the trait method definitions can use these placeholder types in their signatures.  
 The implementor of a trait will specify the concrete type to be used instead of the placeholder type for the particular implementation.
 
-```rs
+```rs linenums="1"
 trait Iterator {
     type Item;
 
@@ -848,7 +848,7 @@ In memory, a trait object is a fat pointer consisting of a pointer to the value,
 
 > **Note**: Rust automatically converts ordinary references into trait objects when needed
 
-```rs
+```rs linenums="1"
 let trait_object = &mut dyn Trait = &mut source;
 let trait_object: Box<dyn Trait> = Box::new(source);  // same for Rc<T>, Arc<T>, ...
 ```
@@ -856,7 +856,7 @@ let trait_object: Box<dyn Trait> = Box::new(source);  // same for Rc<T>, Arc<T>,
 This works differently from defining a struct or function that uses a generic type parameter with trait bounds.  
 A generic type parameter can only be substituted with *one concrete type* at a time, whereas trait objects allow for *multiple* concrete types to fill in for the trait object at runtime.
 
-```rs
+```rs linenums="1"
 fn func() -> Box<dyn Trait> { }  // return something that implements the specified trait
 ```
 
@@ -881,7 +881,7 @@ The annotation does not affect how long the references live.
 
 In case of different lifetimes the complier will use the most restrictive.
 
-```rs
+```rs linenums="1"
 // lifetime annotation syntax
 fn func<'a>(x: &'a Type, y: &'a Type) -> &'a Type { }
 
@@ -914,7 +914,7 @@ They describe situations that do not require explicit lifetime annotations.
 
 ## Enums
 
-```rs
+```rs linenums="1"
 // enum definition
 enum Enum
 {
@@ -948,7 +948,7 @@ A *match expression* is made up of *arms*. An arm consists of a *pattern* and th
 
 > **Note**: `match` arms must be exhaustive for compilation.
 
-```rs
+```rs linenums="1"
 enum Enum {
     Variant1,
     Variant2,
@@ -988,7 +988,7 @@ Guard Expression      | `<pattern> if <condition>` | `match` only
 
 > **Note**: `..` in slices matches *any number* of elements. `..` in structs *ignores* all remaining fields
 
-```rs
+```rs linenums="1"
 // unpack a struct into local variables
 let Struct { local_1, local_2, local_3, .. } = source;
 
@@ -1010,7 +1010,7 @@ A **refutable pattern** is one that might not match, like `Ok(x)`. Refutable pat
 
 Refutable patterns are also allowed in `if let` and `while let` expressions:
 
-```rs
+```rs linenums="1"
 // handle just one enum variant specially
 if let Enum::VariantX(_, _) = source { }
 
@@ -1032,7 +1032,7 @@ The `Option` type is used in many places because it encodes the very common scen
 
 `Result<T, E>` is the type used for returning and propagating errors. It is an enum with the variants, `Ok(T)`, representing success and containing a value, and `Err(E)`, representing error and containing an error value.
 
-```rs
+```rs linenums="1"
 // std implementation
 enum Option<T> {
     Some(T),
@@ -1099,7 +1099,7 @@ Ending an expression with `?` will result in the unwrapped success (`Ok`) value,
 
 When working with multiple error types is useful to return a "generic error" type. All the standard library error types can be represented by `Box<dyn std::Error + Send + Sync + 'static>`.
 
-```rs
+```rs linenums="1"
 // convenience type aliases for the generic error
 type GenericError = Box<dyn std::Error + Send + Sync + 'static>;
 type GenericResult<T> = Result<T; GenericError>;
@@ -1109,7 +1109,7 @@ type GenericResult<T> = Result<T; GenericError>;
 
 ### Custom Error Types
 
-```rs
+```rs linenums="1"
 use thiserror::Error;  // utility crate for custom errors
 
 #[derive(Error, Debug)]
@@ -1130,7 +1130,7 @@ pub struct JsonError {
 Vectors allow to store more than one value in a single data structure that puts all the values next to each other in memory. Vectors can only store values of the *same type*.  
 Like any other struct, a vector is freed when it goes out of scope. When the vector gets dropped, all of its contents are also dropped.
 
-```rs
+```rs linenums="1"
 let v: Vec<Type> = Vec<Type>::new();  // empty vec init
 let mut v: vec![item1, item2, ...];  // vec init (type inferred)
 
@@ -1149,7 +1149,7 @@ for i in mut &v {
 
 A vector can hold different types if those type are variants of the same enum. It's also possible to use trait objects.
 
-```rs
+```rs linenums="1"
 enum Enum {
     Int(i32),
     Float(f64),
@@ -1167,7 +1167,7 @@ let v = vec![
 
 Stores data in key-value pairs.
 
-```rs
+```rs linenums="1"
 use std::collections::HashMap;
 
 let map: HashMap<K, V> = HashMap::new();
@@ -1189,7 +1189,7 @@ Within these limited contexts, the compiler is reliably able to infer the types
 The first time a closure is called with an argument, the compiler infers the type of the parameter and the return type of the closure.  
 Those types are then locked into the closure and a type error is returned if a different type is used with the same closure.
 
-```rs
+```rs linenums="1"
 // closure definition
 let closure = |param1, param2| <expr>;
 let closure = |param1, param2| {/* multiple lines of code */};
@@ -1207,7 +1207,7 @@ To define structs, enums, or function parameters that use closures generics and
 
 The `Fn` traits are provided by the standard library. All closures implement at least one of the traits: `Fn`, `FnMut`, or `FnOnce`.
 
-```rs
+```rs linenums="1"
 struct ClosureStruct<T> where T: Fn(u32) -> u32 {
     closure: T,
 }
@@ -1236,7 +1236,7 @@ All closures implement `FnOnce` because they can all be called at least once. Cl
 To force the closure to take ownership of the values it uses in the environment, use the `move` keyword before the parameter list.  
 This technique is mostly useful when passing a closure to a new thread to move the data so it's owned by the new thread.
 
-```rs
+```rs linenums="1"
 let closure = move |param| <expr>;
 ```
 
@@ -1246,7 +1246,7 @@ The *iterator pattern* allows to perform some task on a sequence of items in tur
 
 In Rust, iterators are *lazy*, meaning they have no effect until a call to methods that consume the iterator to use it up.
 
-```rs
+```rs linenums="1"
 // iterator trait
 pub trait Iterator {
     type Item;
@@ -1266,7 +1266,7 @@ Other methods defined on the `Iterator` trait, known as *iterator adaptors*, all
 It's possible to chain multiple calls to iterator adaptors to perform complex actions in a readable way.  
 But because all iterators are lazy, a call one of the consuming adaptor methods is needed to get the results.
 
-```rs
+```rs linenums="1"
 let iterator: = vec![1, 2, 3];
 iterator
     .map(|x| x + 1)  // iterator adapter
@@ -1276,7 +1276,7 @@ iterator
 
 ### Custom Iterators
 
-```rs
+```rs linenums="1"
 struct Counter {
     count: u32,
 }
@@ -1334,7 +1334,7 @@ Boxes don't have performance overhead, other than storing their data on the heap
 - Transferring ownership of a large amount of data but ensuring the data won't be copied when you do so
 - Owning a value and which implements a particular trait rather than being of a specific type
 
-```rs
+```rs linenums="1"
 let _box = Box::new(pointed_value);
 ```
 
@@ -1343,7 +1343,7 @@ let _box = Box::new(pointed_value);
 Implementing the `Deref` trait allows to customize the behavior of the dereference operator, `*`.
 By implementing `Deref` in such a way that a smart pointer can be treated like a regular reference.
 
-```rs
+```rs linenums="1"
 struct CustomSmartPointer<T>(T);
 
 impl<T> CustomSmartPointer<T> {
@@ -1370,7 +1370,7 @@ let v = *(s.deref());
 It works only on types that implement the `Deref` trait and converts such a type into a reference to another type.  
 Deref coercion was added to Rust so that programmers writing function and method calls don't need to add as many explicit references and dereferences with `&` and `*`.
 
-```rs
+```rs linenums="1"
 fn hello(name: &str) {
     println!("Hello {}", name);
 }
@@ -1395,7 +1395,7 @@ Rust does *deref coercion* when it finds types and trait implementations in thre
 
 `Drop` allows to customize what happens when a value is about to go out of scope. It-s possible to provide an implementation for the `Drop` trait on any type.
 
-```rs
+```rs linenums="1"
 struct CustomSmartPointer<T>(T);
 
 impl<T> Drop for CustomSmartPointer<T> {
@@ -1419,7 +1419,7 @@ Rust provides the *reference-counted* pointer types `Rc<T>` and `Arc<T>`.
 The `Rc<T>` and `Arc<T>` types are very similar; the only difference between them is that an `Arc<T>` is safe to share between
 threads directly (the name Arc is short for *atomic* reference count) whereas a plain `Rc<T>` uses faster non-thread-safe code to update its reference count.
 
-```rs
+```rs linenums="1"
 use std::rc::Rc;
 
 let s: Rc<String> = Rc::new("some string".to_string());
@@ -1477,10 +1477,10 @@ This creates memory leaks because the reference count of each item in the cycle
 
 ### Creating Threads
 
-The `thread::spawn` function creates a new tread that will execute the passed closure. Any data captured by the closure is _moved_ to the capturing thread.  
+The `thread::spawn` function creates a new tread that will execute the passed closure. Any data captured by the closure is *moved* to the capturing thread.  
 The thread's **handle** can be used to wait for completion and retieve the computation result or errors if any.
 
-```rs
+```rs linenums="1"
 // if no data is captured the move keyword can be removed
 let handle = std::thread::spawn(move || { /* ... */ });
 
@@ -1490,12 +1490,12 @@ handle.join().unwrap();
 > **Note**: a thread's execution can be termiated early if it's not joined and the main process terminates before the thread had completed it's work.  
 > **Note**: if a thread panics the handle will return the panic message so that it can be handled.
 
-### Channnels
+### Channels
 
-To accomplish message-sending concurrently Rust's standard library provides an implementation of _channels_.  
+To accomplish message-sending concurrently Rust's standard library provides an implementation of *channels*.  
 A **channel** is a general programming concept by which data is sent from one thread to another.
 
-```rs
+```rs linenums="1"
 let (sender, receiver) = std::sync::mpsc::channel();  // the sender can be cloned to create multiple transmitters
 
 let sender_1 = sender.clone();
@@ -1521,13 +1521,13 @@ for message in receiver { } // receive multiple values (iteration stops when cha
 
 The `Send` marker trait indicates that ownership of values of the type implementing `Send` can be transferred between threads. Any type composed entirely of `Send` types is automatically marked as `Send`.  Almost all primitive types are `Send`, aside from raw pointers.
 
-The `Sync` marker trait indicates that it is safe for the type implementing `Sync` to be referenced from multiple threads. In other words, any type `T` is `Sync` if `&T` (an immutable reference to `T`) is `Send`, meaning the reference can be sent safely to another thread. Similar to `Send`, primitive types are `Sync`, and types composed entirely of types that are `Sync `are also `Sync`.
+The `Sync` marker trait indicates that it is safe for the type implementing `Sync` to be referenced from multiple threads. In other words, any type `T` is `Sync` if `&T` (an immutable reference to `T`) is `Send`, meaning the reference can be sent safely to another thread. Similar to `Send`, primitive types are `Sync`, and types composed entirely of types that are `Sync`are also `Sync`.
 
 ## Files
 
 ### Reading Files
 
-```rs
+```rs linenums="1"
 use std::fs;
 
 let contents: Vec<u8> = fs::read("path/to/file").unwrap_or_default();
@@ -1538,7 +1538,7 @@ contents.lines(); // iterator over text lines
 
 ### Writing Files
 
-```rs
+```rs linenums="1"
 use std::fs;
 use std::io::Write;  // write trait
 // or
@@ -1562,7 +1562,7 @@ The extern keyword is used in two places in Rust:
 
 `extern` is used in two different contexts within FFI. The first is in the form of external blocks, for declaring function interfaces that Rust code can call foreign code by.
 
-```rs
+```rs linenums="1"
 #[link(name = "my_c_library")]
 extern "C" {
     fn my_c_function(x: i32) -> bool;
@@ -1575,7 +1575,7 @@ Working with non-Rust languages and FFI is inherently unsafe, so wrappers are us
 
 The mirror use case of FFI is also done via the extern keyword:
 
-```rs
+```rs linenums="1"
 #[no_mangle]
 pub extern "C" fn callable_from_c(x: i32) -> bool {
     x % 3 == 0
diff --git a/docs/languages/rust/unit-tests.md b/docs/languages/rust/unit-tests.md
index fa68ccd..add6bf4 100644
--- a/docs/languages/rust/unit-tests.md
+++ b/docs/languages/rust/unit-tests.md
@@ -2,7 +2,7 @@
 
 ## Test Functions
 
-```rs
+```rs linenums="1"
 // module code here
 
 #[cfg(test)]
@@ -33,7 +33,7 @@ mod tests {
 
 ## Controlling How Tests Are Run
 
-```sh
+```sh linenums="1"
 cargo test -- --test-threads=<number>  # run tests in parallel (1 no parallelism)
 cargo test -- --show-output  # show content printed in stdout in each test
 cargo test <test_name>  # run only a specific test
diff --git a/docs/languages/swift/swift.md b/docs/languages/swift/swift.md
index 9514f2b..6b2412a 100644
--- a/docs/languages/swift/swift.md
+++ b/docs/languages/swift/swift.md
@@ -8,7 +8,7 @@
 
 ### Macro
 
-```swift
+```swift linenums="1"
 #if DEBUG
 
 // contents compiled only if in DEBUG build
@@ -18,7 +18,7 @@
 
 ### Comments
 
-```swift
+```swift linenums="1"
 // single line comment
 
 /*  
@@ -28,7 +28,7 @@ multi line comment
 
 ### Variables
 
-```swift
+```swift linenums="1"
 var variable = value  // implicit variable init (auto-determine type)
 var variable: Type = value  // explicit variable init
 var variable: Type? = value  // explicit nullable variable init
@@ -36,13 +36,13 @@ var variable: Type? = value  // explicit nullable variable init
 
 ### Constants
 
-```swift
+```swift linenums="1"
 let CONSTANT = value  // constant init (value can be assigned at runtime)
 ```
 
 ### Console Output
 
-```swift
+```swift linenums="1"
 print()  // empty line
 print(variable)
 print("string")
@@ -50,7 +50,7 @@ print("string")
 
 ## Strings
 
-```swift
+```swift linenums="1"
 var string "Text: \(<expr>)"  // string interpolation
 var string = "Hello" + "There"  // string concatenation
 
@@ -60,7 +60,7 @@ to make a string span multiple lines"""
 
 ## Array
 
-```swift
+```swift linenums="1"
 var array = ["firstItem", "secondItem", ...]
 var array = [Type()]  // init empty homogeneous array
 
@@ -85,7 +85,7 @@ It's possible to use a tuple type as the return type of a function to enable the
 It's possible to name the elements of a tuple type and use those names to refer to the values of the individual elements.
 An element name consists of an identifier followed immediately by a colon (:).
 
-```swift
+```swift linenums="1"
 var tuple: (Type, Type) = (value, value)  // explicit type
 var tuple = (value, value)  // implicit type
 tuple.0  // item access
@@ -98,21 +98,21 @@ tuple.name1  // item access
 
 ### Tuple Decomposition
 
-```swift
+```swift linenums="1"
 var tuple = (value1, value2)
 var (var1, var2) = tuple  // var1 = value1, var2 = value2
 ```
 
 ## Type Identifier
 
-```swift
+```swift linenums="1"
 typealias Point = (Int, Int)
 var origin: (0, 0)
 ```
 
 ## Dictionary
 
-```swift
+```swift linenums="1"
 var dict = [
     "key": "value",
     ...
@@ -208,7 +208,7 @@ dict[key] = value // value update
 
 ### Nil Checks
 
-```swift
+```swift linenums="1"
 variable ?? value
 // same as
 if(variable == nil) { variable = value }
@@ -216,7 +216,7 @@ if(variable == nil) { variable = value }
 
 ## If-Else
 
-```swift
+```swift linenums="1"
 if condition {
     // code here
 } else if condition {
@@ -233,7 +233,7 @@ if var0 != nil { /* statements */ }
 
 ### Switch
 
-```swift
+```swift linenums="1"
 switch <value> {
     case <pattern/key>:
         // code here
@@ -253,7 +253,7 @@ switch <value> {
 
 ### For Loop
 
-```swift
+```swift linenums="1"
 // range based for
 for i in start...end { /* statements */ }  // end included
 for i in start..<end { /* statements */ }  // end excluded
@@ -270,7 +270,7 @@ for (key, value) in dict {
 
 ### While Loop
 
-```swift
+```swift linenums="1"
 while condition {
     // code here
 }
@@ -283,7 +283,7 @@ repeat {
 
 ## Functions
 
-```swift
+```swift linenums="1"
 // "void function"
 func funcName(param: Type, ...) {
     // code here
@@ -318,14 +318,14 @@ funcWithLabels(value, label: value, ...)
 
 ### Passing Functions as Parameters
 
-```swift
+```swift linenums="1"
 func f(param: Type) -> Type {}
 func g(f: (Type) -> Type) {}  // (Type) -> Type are the passed func input and output types
 ```
 
 ### Functions Returning Functions
 
-```swift
+```swift linenums="1"
 func f() -> ((Type) -> Type) {
     func g(param: Type) -> type {}
 
@@ -338,7 +338,7 @@ func f() -> ((Type) -> Type) {
 **Closures** are self-contained blocks of functionality that can be passed around and used in code.
 Closures in Swift are similar to blocks in C and Objective-C and to lambdas in other programming languages.
 
-```swift
+```swift linenums="1"
 { (parameters: Type) -> Type in
     // statements
 }
@@ -351,7 +351,7 @@ Closures in Swift are similar to blocks in C and Objective-C and to lambdas in o
 
 ### Enum Definition
 
-```swift
+```swift linenums="1"
 enum EnumName {
     case key1
     case key2
@@ -363,7 +363,7 @@ EnumName.key1 // key1
 
 ### Enum with Raw Values
 
-```swift
+```swift linenums="1"
 enum EnumName: Type {
     case key1 = value
     case key2 = value
@@ -382,7 +382,7 @@ enum IntegerEnum: Int {
 
 ### Matching Enumeration Values with a Switch Statement
 
-```swift
+```swift linenums="1"
 enum Rank: Int {
     case ace = 1, two, three, four, five, six, seven, eight, nine, ten
     case jack, queen, king
@@ -411,7 +411,7 @@ Rank.jack.rawValue // 11
 
 ## Struct (Value Type)
 
-```swift
+```swift linenums="1"
 struct StructName {
     var attribute = value  // instance variable
     private var _attribute: Type  // backing field for property
@@ -446,7 +446,7 @@ var structure = StructName()  // struct instantiation
 
 ### Class Definition & Instantiation
 
-```swift
+```swift linenums="1"
 class ClassName {
     var attribute = value  // instance variable
     private var _attribute: Type  // backing field for property
@@ -483,7 +483,7 @@ Do actions before/after modifying a property value.
 
 > **Note**: `willSet` and `didSet` do not *set* the value of the property.
 
-```swift
+```swift linenums="1"
 class ClassName {
 
     var _attribute: Type
@@ -505,7 +505,7 @@ class ClassName {
 
 ### Inheritance
 
-```swift
+```swift linenums="1"
 class Derived: SuperClass {
 
     var attribute: Type
@@ -522,7 +522,7 @@ class Derived: SuperClass {
 
 ### Exception Handling
 
-```swift
+```swift linenums="1"
 guard let variable = <expression>
 else {
     /* statements */
diff --git a/docs/misc/git.md b/docs/misc/git.md
index 669c0ba..24451c1 100644
--- a/docs/misc/git.md
+++ b/docs/misc/git.md
@@ -24,7 +24,7 @@
 
 Data Model Structure:
 
-```txt
+```txt linenums="1"
 <root> (tree)
 |
 |_ foo (tree)
@@ -35,7 +35,7 @@ Data Model Structure:
 
 Data Model as pseudocode:
 
-```py
+```py linenums="1"
 # a file is a bunch of bytes
 blob = array<byte>
 
diff --git a/docs/misc/graph-ql.md b/docs/misc/graph-ql.md
index 007d6ed..18e0ce6 100644
--- a/docs/misc/graph-ql.md
+++ b/docs/misc/graph-ql.md
@@ -14,7 +14,7 @@ A GraphQL service is created by defining types and fields on those types, then p
 
 The most basic components of a GraphQL schema are object types, which just represent a kind of object fetchable from the service, and what fields it has.
 
-```graphql
+```graphql linenums="1"
 type Type {
   field: Type
   field: Type!  # non-nullable type
@@ -29,7 +29,7 @@ Every field on a GraphQL object type can have zero or more arguments. All argume
 
 Arguments can be either *required* or *optional*. When an argument is optional, it's possible to define a default value.
 
-```graphql
+```graphql linenums="1"
 type Type {
   field: Type,
   field(namedArg: Type = defaultValue): Type
@@ -55,7 +55,7 @@ GraphQL comes with a set of default scalar types out of the box:
 
 In most GraphQL service implementations, there is also a way to specify custom scalar types.
 
-```graphql
+```graphql linenums="1"
 scalar ScalarType
 ```
 
@@ -70,7 +70,7 @@ This allows to:
 1. Validate that any arguments of this type are one of the allowed values
 2. Communicate through the type system that a field will always be one of a finite set of values
 
-```graphql
+```graphql linenums="1"
 enum Type{
   VALUE,
   VALUE,
@@ -97,7 +97,7 @@ Like many type systems, GraphQL supports interfaces. An Interface is an abstract
 
 Interfaces are useful when returning an object or set of objects, but those might be of several different types.
 
-```graphql
+```graphql linenums="1"
 interface Interface {
   fieldA: TypeA
   fieldB: TypeB
@@ -115,7 +115,7 @@ type Type implements Interface {
 
 Interfaces are useful when returning an object or set of objects, but those might be of several different types.
 
-```graphql
+```graphql linenums="1"
 union Union = TypeA | TypeB | TypeC
 ```
 
@@ -125,7 +125,7 @@ union Union = TypeA | TypeB | TypeC
 
 In the GraphQL schema language, input types look exactly the same as regular object types, but with the keyword input instead of type:
 
-```graphql
+```graphql linenums="1"
 input Input {
   field: Type,
   ...
@@ -141,7 +141,7 @@ Input object types also can't have arguments on their fields.
 
 ### Simple Query
 
-```graphql
+```graphql linenums="1"
 {
   field {  # root field
     ...  # payload
@@ -149,7 +149,7 @@ Input object types also can't have arguments on their fields.
 }
 ```
 
-```json
+```json linenums="1"
 {
   "data" : {
     "field": {
@@ -167,7 +167,7 @@ But in GraphQL, every field and nested object can get its own set of arguments,
 
 It's aldo possible to pass arguments into scalar fields, to implement data transformations once on the server, instead of on every client separately.
 
-```graphql
+```graphql linenums="1"
 {
   fieldA(arg: value)  # filter results
   fieldB(arg: value)
@@ -177,7 +177,7 @@ It's aldo possible to pass arguments into scalar fields, to implement data trans
 
 ### Aliases
 
-```graphql
+```graphql linenums="1"
 {
   aliasA: field(arg: valueA) {
     field
@@ -193,7 +193,7 @@ It's aldo possible to pass arguments into scalar fields, to implement data trans
 Fragments allow to construct sets of fields, and then include them in queries where that are needed.
 The concept of fragments is frequently used to split complicated application data requirements into smaller chunks.
 
-```graphql
+```graphql linenums="1"
 {
   aliasA: field(arg: valueA) {
     ...fragment
@@ -214,7 +214,7 @@ fragment fragment on Type {
 
 It is possible for fragments to access variables declared in the query or mutation.
 
-```graphql
+```graphql linenums="1"
 query Query($var: Type = value) {
     aliasA: field(arg: valueA) {
   ...fragment
@@ -240,7 +240,7 @@ The *operation type* is either `query`, `mutation`, or `subscription` and descri
 
 The *operation name* is a meaningful and explicit name for the operation. It is only required in multi-operation documents, but its use is encouraged because it is very helpful for debugging and server-side logging. When something goes wrong it is easier to identify a query in the codebase by name instead of trying to decipher the contents.
 
-```graphql
+```graphql linenums="1"
 query Operation {
   ...
 }
@@ -254,7 +254,7 @@ When  working with variables, three things need to be done:
 2. Declare `$variableName` as one of the variables accepted by the query
 3. Pass `variableName: value` in the separate, transport-specific (usually JSON) variables dictionary
 
-```graphql
+```graphql linenums="1"
 query Operation($var: Type = defaultValue) {
   field(arg: $var) {
     field
@@ -288,7 +288,7 @@ Operations of mutations:
 - **Updating** existing data
 - **Deleting** existing data
 
-```graphql
+```graphql linenums="1"
 mutation Operation {
   createObject(arg: value, ...) {
     field
@@ -301,7 +301,7 @@ mutation Operation {
 
 Open a stable connection with the server to receive real-time updates on the operations happening.
 
-```graphql
+```graphql linenums="1"
 subscription Operation {
   event {  # get notified when event happens
     field  # data received on notification
@@ -314,7 +314,7 @@ subscription Operation {
 
 If you are querying a field that returns an interface or a union type, you will need to use inline fragments to access data on the underlying concrete type. Named fragments can also be used in the same way, since a named fragment always has a type attached.
 
-```graphql
+```graphql linenums="1"
 query Operation($var: Type) {
     field(arg: $var) {  # interface of union
   field
@@ -332,7 +332,7 @@ query Operation($var: Type) {
 
 GraphQL allows to request `__typename`, a meta field, at any point in a query to get the name of the object type at that point.
 
-```graphql
+```graphql linenums="1"
 {
     field(arg: value) {
   __typename
@@ -357,7 +357,7 @@ If a field produces a scalar value like a string or number, then the execution c
 
 At the top level of every GraphQL server is a type that represents all of the possible entry points into the GraphQL API, it's often called the *Root* type or the *Query* type.
 
-```graphql
+```graphql linenums="1"
 # root types for entry-points
 
 type Query {
diff --git a/docs/misc/ssh.md b/docs/misc/ssh.md
index f800750..7f45d61 100644
--- a/docs/misc/ssh.md
+++ b/docs/misc/ssh.md
@@ -4,7 +4,7 @@
 
 ## Basics
 
-```sh
+```sh linenums="1"
 ssh user@destination <command> # exec <command> in remote machine ($SHELL if omitted)
 ssh user@destination -i <path/to/private-key>  # use key for auth
 ssh user@destination -f  # exec ssh in the background
@@ -19,7 +19,7 @@ ssh user@destination -t  # force pseudo-tty emulation
 
 Connect to the final destination jumping through the specifies other destinations.
 
-```sh
+```sh linenums="1"
 ssh -J user_1@destination_1,user_2@destination_2 user@final_destination
 ```
 
@@ -31,7 +31,7 @@ ssh -J user_1@destination_1,user_2@destination_2 user@final_destination
 
 Start listening on `local_address:local_port` and forward any traffic to `remote_address:remote_port`.
 
-```sh
+```sh linenums="1"
 ssh -N -f -L local_address:local_port:remote_address:remote_port user@destination
 ssh -N -f -L local_port:remote_address:remote_port user@destination  # local_address defaults to localhost
 ```
@@ -40,6 +40,6 @@ ssh -N -f -L local_port:remote_address:remote_port user@destination  # local_add
 
 Start listening on `remote_address:remote_port` and forward any traffic to `local_address:local_port`.
 
-```sh
+```sh linenums="1"
 ssh -N -f -R remote_address:remote_port:local_address:local_port user@destination
 ```

From d87ecb420686bd2cee5b786d965e9d0cd5702ce3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 24 Oct 2023 10:59:13 +0200
Subject: [PATCH 36/39] Poetry(deps): Bump urllib3 from 2.0.6 to 2.0.7 (#36)

* make dependabot update github-actions

* show copy button in code snippets

* improve regex notes

* show line numbers in conde snippets

* Poetry(deps): Bump urllib3 from 2.0.6 to 2.0.7

Bumps [urllib3](https://github.com/urllib3/urllib3) from 2.0.6 to 2.0.7.
- [Release notes](https://github.com/urllib3/urllib3/releases)
- [Changelog](https://github.com/urllib3/urllib3/blob/main/CHANGES.rst)
- [Commits](https://github.com/urllib3/urllib3/compare/2.0.6...2.0.7)

---
updated-dependencies:
- dependency-name: urllib3
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: Marcello Lamonaca <marcello@lamonaca.eu>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 poetry.lock | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index fd94a15..0719ea4 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -881,13 +881,13 @@ test = ["flake8", "isort", "pytest"]
 
 [[package]]
 name = "urllib3"
-version = "2.0.6"
+version = "2.0.7"
 description = "HTTP library with thread-safe connection pooling, file post, and more."
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "urllib3-2.0.6-py3-none-any.whl", hash = "sha256:7a7c7003b000adf9e7ca2a377c9688bbc54ed41b985789ed576570342a375cd2"},
-    {file = "urllib3-2.0.6.tar.gz", hash = "sha256:b19e1a85d206b56d7df1d5e683df4a7725252a964e3993648dd0fb5a1c157564"},
+    {file = "urllib3-2.0.7-py3-none-any.whl", hash = "sha256:fdb6d215c776278489906c2f8916e6e7d4f5a9b602ccbcfdf7f016fc8da0596e"},
+    {file = "urllib3-2.0.7.tar.gz", hash = "sha256:c97dfde1f7bd43a71c8d2a58e369e9b2bf692d1334ea9f9cae55add7d0dd0f84"},
 ]
 
 [package.extras]

From b99c03cda958e083ff16f3c03ebeccaabe8c035b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 24 Oct 2023 10:59:44 +0200
Subject: [PATCH 37/39] Github Actions(deps): Bump actions/checkout from 3 to 4
 (#38)

Bumps [actions/checkout](https://github.com/actions/checkout) from 3 to 4.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v3...v4)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/docs.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 6de48b7..b14ea5f 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -9,7 +9,7 @@ jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       
       - name: Install poetry
         run: pipx install poetry

From 75aa74dbed0922f199d01ce355c0d8747c403396 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 24 Oct 2023 11:00:07 +0200
Subject: [PATCH 38/39] Github Actions(deps): Bump actions/setup-python from
 3.1.3 to 4.7.1 (#37)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 3.1.3 to 4.7.1.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v3.1.3...v4.7.1)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/docs.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index b14ea5f..7e9362d 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -15,7 +15,7 @@ jobs:
         run: pipx install poetry
       
       - name: Setup Python
-        uses: actions/setup-python@v3.1.3
+        uses: actions/setup-python@v4.7.1
         with:
           python-version: '3.x'
           cache: poetry

From 4d3f97c655b7fb16420f99749a8af81db5b488d8 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 24 Oct 2023 11:00:42 +0200
Subject: [PATCH 39/39] Poetry(deps): Bump pillow from 10.0.1 to 10.1.0 (#35)

Bumps [pillow](https://github.com/python-pillow/Pillow) from 10.0.1 to 10.1.0.
- [Release notes](https://github.com/python-pillow/Pillow/releases)
- [Changelog](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst)
- [Commits](https://github.com/python-pillow/Pillow/compare/10.0.1...10.1.0)

---
updated-dependencies:
- dependency-name: pillow
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Marcello Lamonaca <marcello@lamonaca.eu>
---
 poetry.lock    | 112 ++++++++++++++++++++++++-------------------------
 pyproject.toml |   2 +-
 2 files changed, 57 insertions(+), 57 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 0719ea4..826ac87 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -522,65 +522,65 @@ files = [
 
 [[package]]
 name = "pillow"
-version = "10.0.1"
+version = "10.1.0"
 description = "Python Imaging Library (Fork)"
 optional = false
 python-versions = ">=3.8"
 files = [
-    {file = "Pillow-10.0.1-cp310-cp310-macosx_10_10_x86_64.whl", hash = "sha256:8f06be50669087250f319b706decf69ca71fdecd829091a37cc89398ca4dc17a"},
-    {file = "Pillow-10.0.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:50bd5f1ebafe9362ad622072a1d2f5850ecfa44303531ff14353a4059113b12d"},
-    {file = "Pillow-10.0.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e6a90167bcca1216606223a05e2cf991bb25b14695c518bc65639463d7db722d"},
-    {file = "Pillow-10.0.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f11c9102c56ffb9ca87134bd025a43d2aba3f1155f508eff88f694b33a9c6d19"},
-    {file = "Pillow-10.0.1-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:186f7e04248103482ea6354af6d5bcedb62941ee08f7f788a1c7707bc720c66f"},
-    {file = "Pillow-10.0.1-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:0462b1496505a3462d0f35dc1c4d7b54069747d65d00ef48e736acda2c8cbdff"},
-    {file = "Pillow-10.0.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:d889b53ae2f030f756e61a7bff13684dcd77e9af8b10c6048fb2c559d6ed6eaf"},
-    {file = "Pillow-10.0.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:552912dbca585b74d75279a7570dd29fa43b6d93594abb494ebb31ac19ace6bd"},
-    {file = "Pillow-10.0.1-cp310-cp310-win_amd64.whl", hash = "sha256:787bb0169d2385a798888e1122c980c6eff26bf941a8ea79747d35d8f9210ca0"},
-    {file = "Pillow-10.0.1-cp311-cp311-macosx_10_10_x86_64.whl", hash = "sha256:fd2a5403a75b54661182b75ec6132437a181209b901446ee5724b589af8edef1"},
-    {file = "Pillow-10.0.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:2d7e91b4379f7a76b31c2dda84ab9e20c6220488e50f7822e59dac36b0cd92b1"},
-    {file = "Pillow-10.0.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:19e9adb3f22d4c416e7cd79b01375b17159d6990003633ff1d8377e21b7f1b21"},
-    {file = "Pillow-10.0.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:93139acd8109edcdeffd85e3af8ae7d88b258b3a1e13a038f542b79b6d255c54"},
-    {file = "Pillow-10.0.1-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:92a23b0431941a33242b1f0ce6c88a952e09feeea9af4e8be48236a68ffe2205"},
-    {file = "Pillow-10.0.1-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:cbe68deb8580462ca0d9eb56a81912f59eb4542e1ef8f987405e35a0179f4ea2"},
-    {file = "Pillow-10.0.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:522ff4ac3aaf839242c6f4e5b406634bfea002469656ae8358644fc6c4856a3b"},
-    {file = "Pillow-10.0.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:84efb46e8d881bb06b35d1d541aa87f574b58e87f781cbba8d200daa835b42e1"},
-    {file = "Pillow-10.0.1-cp311-cp311-win_amd64.whl", hash = "sha256:898f1d306298ff40dc1b9ca24824f0488f6f039bc0e25cfb549d3195ffa17088"},
-    {file = "Pillow-10.0.1-cp312-cp312-macosx_10_10_x86_64.whl", hash = "sha256:bcf1207e2f2385a576832af02702de104be71301c2696d0012b1b93fe34aaa5b"},
-    {file = "Pillow-10.0.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:5d6c9049c6274c1bb565021367431ad04481ebb54872edecfcd6088d27edd6ed"},
-    {file = "Pillow-10.0.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:28444cb6ad49726127d6b340217f0627abc8732f1194fd5352dec5e6a0105635"},
-    {file = "Pillow-10.0.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:de596695a75496deb3b499c8c4f8e60376e0516e1a774e7bc046f0f48cd620ad"},
-    {file = "Pillow-10.0.1-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:2872f2d7846cf39b3dbff64bc1104cc48c76145854256451d33c5faa55c04d1a"},
-    {file = "Pillow-10.0.1-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:4ce90f8a24e1c15465048959f1e94309dfef93af272633e8f37361b824532e91"},
-    {file = "Pillow-10.0.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:ee7810cf7c83fa227ba9125de6084e5e8b08c59038a7b2c9045ef4dde61663b4"},
-    {file = "Pillow-10.0.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:b1be1c872b9b5fcc229adeadbeb51422a9633abd847c0ff87dc4ef9bb184ae08"},
-    {file = "Pillow-10.0.1-cp312-cp312-win_amd64.whl", hash = "sha256:98533fd7fa764e5f85eebe56c8e4094db912ccbe6fbf3a58778d543cadd0db08"},
-    {file = "Pillow-10.0.1-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:764d2c0daf9c4d40ad12fbc0abd5da3af7f8aa11daf87e4fa1b834000f4b6b0a"},
-    {file = "Pillow-10.0.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:fcb59711009b0168d6ee0bd8fb5eb259c4ab1717b2f538bbf36bacf207ef7a68"},
-    {file = "Pillow-10.0.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:697a06bdcedd473b35e50a7e7506b1d8ceb832dc238a336bd6f4f5aa91a4b500"},
-    {file = "Pillow-10.0.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9f665d1e6474af9f9da5e86c2a3a2d2d6204e04d5af9c06b9d42afa6ebde3f21"},
-    {file = "Pillow-10.0.1-cp38-cp38-manylinux_2_28_aarch64.whl", hash = "sha256:2fa6dd2661838c66f1a5473f3b49ab610c98a128fc08afbe81b91a1f0bf8c51d"},
-    {file = "Pillow-10.0.1-cp38-cp38-manylinux_2_28_x86_64.whl", hash = "sha256:3a04359f308ebee571a3127fdb1bd01f88ba6f6fb6d087f8dd2e0d9bff43f2a7"},
-    {file = "Pillow-10.0.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:723bd25051454cea9990203405fa6b74e043ea76d4968166dfd2569b0210886a"},
-    {file = "Pillow-10.0.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:71671503e3015da1b50bd18951e2f9daf5b6ffe36d16f1eb2c45711a301521a7"},
-    {file = "Pillow-10.0.1-cp38-cp38-win_amd64.whl", hash = "sha256:44e7e4587392953e5e251190a964675f61e4dae88d1e6edbe9f36d6243547ff3"},
-    {file = "Pillow-10.0.1-cp39-cp39-macosx_10_10_x86_64.whl", hash = "sha256:3855447d98cced8670aaa63683808df905e956f00348732448b5a6df67ee5849"},
-    {file = "Pillow-10.0.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:ed2d9c0704f2dc4fa980b99d565c0c9a543fe5101c25b3d60488b8ba80f0cce1"},
-    {file = "Pillow-10.0.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f5bb289bb835f9fe1a1e9300d011eef4d69661bb9b34d5e196e5e82c4cb09b37"},
-    {file = "Pillow-10.0.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3a0d3e54ab1df9df51b914b2233cf779a5a10dfd1ce339d0421748232cea9876"},
-    {file = "Pillow-10.0.1-cp39-cp39-manylinux_2_28_aarch64.whl", hash = "sha256:2cc6b86ece42a11f16f55fe8903595eff2b25e0358dec635d0a701ac9586588f"},
-    {file = "Pillow-10.0.1-cp39-cp39-manylinux_2_28_x86_64.whl", hash = "sha256:ca26ba5767888c84bf5a0c1a32f069e8204ce8c21d00a49c90dabeba00ce0145"},
-    {file = "Pillow-10.0.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:f0b4b06da13275bc02adfeb82643c4a6385bd08d26f03068c2796f60d125f6f2"},
-    {file = "Pillow-10.0.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:bc2e3069569ea9dbe88d6b8ea38f439a6aad8f6e7a6283a38edf61ddefb3a9bf"},
-    {file = "Pillow-10.0.1-cp39-cp39-win_amd64.whl", hash = "sha256:8b451d6ead6e3500b6ce5c7916a43d8d8d25ad74b9102a629baccc0808c54971"},
-    {file = "Pillow-10.0.1-pp310-pypy310_pp73-macosx_10_10_x86_64.whl", hash = "sha256:32bec7423cdf25c9038fef614a853c9d25c07590e1a870ed471f47fb80b244db"},
-    {file = "Pillow-10.0.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b7cf63d2c6928b51d35dfdbda6f2c1fddbe51a6bc4a9d4ee6ea0e11670dd981e"},
-    {file = "Pillow-10.0.1-pp310-pypy310_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:f6d3d4c905e26354e8f9d82548475c46d8e0889538cb0657aa9c6f0872a37aa4"},
-    {file = "Pillow-10.0.1-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:847e8d1017c741c735d3cd1883fa7b03ded4f825a6e5fcb9378fd813edee995f"},
-    {file = "Pillow-10.0.1-pp39-pypy39_pp73-macosx_10_10_x86_64.whl", hash = "sha256:7f771e7219ff04b79e231d099c0a28ed83aa82af91fd5fa9fdb28f5b8d5addaf"},
-    {file = "Pillow-10.0.1-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:459307cacdd4138edee3875bbe22a2492519e060660eaf378ba3b405d1c66317"},
-    {file = "Pillow-10.0.1-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:b059ac2c4c7a97daafa7dc850b43b2d3667def858a4f112d1aa082e5c3d6cf7d"},
-    {file = "Pillow-10.0.1-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:d6caf3cd38449ec3cd8a68b375e0c6fe4b6fd04edb6c9766b55ef84a6e8ddf2d"},
-    {file = "Pillow-10.0.1.tar.gz", hash = "sha256:d72967b06be9300fed5cfbc8b5bafceec48bf7cdc7dab66b1d2549035287191d"},
+    {file = "Pillow-10.1.0-cp310-cp310-macosx_10_10_x86_64.whl", hash = "sha256:1ab05f3db77e98f93964697c8efc49c7954b08dd61cff526b7f2531a22410106"},
+    {file = "Pillow-10.1.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:6932a7652464746fcb484f7fc3618e6503d2066d853f68a4bd97193a3996e273"},
+    {file = "Pillow-10.1.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a5f63b5a68daedc54c7c3464508d8c12075e56dcfbd42f8c1bf40169061ae666"},
+    {file = "Pillow-10.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c0949b55eb607898e28eaccb525ab104b2d86542a85c74baf3a6dc24002edec2"},
+    {file = "Pillow-10.1.0-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:ae88931f93214777c7a3aa0a8f92a683f83ecde27f65a45f95f22d289a69e593"},
+    {file = "Pillow-10.1.0-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:b0eb01ca85b2361b09480784a7931fc648ed8b7836f01fb9241141b968feb1db"},
+    {file = "Pillow-10.1.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:d27b5997bdd2eb9fb199982bb7eb6164db0426904020dc38c10203187ae2ff2f"},
+    {file = "Pillow-10.1.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:7df5608bc38bd37ef585ae9c38c9cd46d7c81498f086915b0f97255ea60c2818"},
+    {file = "Pillow-10.1.0-cp310-cp310-win_amd64.whl", hash = "sha256:41f67248d92a5e0a2076d3517d8d4b1e41a97e2df10eb8f93106c89107f38b57"},
+    {file = "Pillow-10.1.0-cp311-cp311-macosx_10_10_x86_64.whl", hash = "sha256:1fb29c07478e6c06a46b867e43b0bcdb241b44cc52be9bc25ce5944eed4648e7"},
+    {file = "Pillow-10.1.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:2cdc65a46e74514ce742c2013cd4a2d12e8553e3a2563c64879f7c7e4d28bce7"},
+    {file = "Pillow-10.1.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:50d08cd0a2ecd2a8657bd3d82c71efd5a58edb04d9308185d66c3a5a5bed9610"},
+    {file = "Pillow-10.1.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:062a1610e3bc258bff2328ec43f34244fcec972ee0717200cb1425214fe5b839"},
+    {file = "Pillow-10.1.0-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:61f1a9d247317fa08a308daaa8ee7b3f760ab1809ca2da14ecc88ae4257d6172"},
+    {file = "Pillow-10.1.0-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:a646e48de237d860c36e0db37ecaecaa3619e6f3e9d5319e527ccbc8151df061"},
+    {file = "Pillow-10.1.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:47e5bf85b80abc03be7455c95b6d6e4896a62f6541c1f2ce77a7d2bb832af262"},
+    {file = "Pillow-10.1.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:a92386125e9ee90381c3369f57a2a50fa9e6aa8b1cf1d9c4b200d41a7dd8e992"},
+    {file = "Pillow-10.1.0-cp311-cp311-win_amd64.whl", hash = "sha256:0f7c276c05a9767e877a0b4c5050c8bee6a6d960d7f0c11ebda6b99746068c2a"},
+    {file = "Pillow-10.1.0-cp312-cp312-macosx_10_10_x86_64.whl", hash = "sha256:a89b8312d51715b510a4fe9fc13686283f376cfd5abca8cd1c65e4c76e21081b"},
+    {file = "Pillow-10.1.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:00f438bb841382b15d7deb9a05cc946ee0f2c352653c7aa659e75e592f6fa17d"},
+    {file = "Pillow-10.1.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3d929a19f5469b3f4df33a3df2983db070ebb2088a1e145e18facbc28cae5b27"},
+    {file = "Pillow-10.1.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9a92109192b360634a4489c0c756364c0c3a2992906752165ecb50544c251312"},
+    {file = "Pillow-10.1.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:0248f86b3ea061e67817c47ecbe82c23f9dd5d5226200eb9090b3873d3ca32de"},
+    {file = "Pillow-10.1.0-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:9882a7451c680c12f232a422730f986a1fcd808da0fd428f08b671237237d651"},
+    {file = "Pillow-10.1.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:1c3ac5423c8c1da5928aa12c6e258921956757d976405e9467c5f39d1d577a4b"},
+    {file = "Pillow-10.1.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:806abdd8249ba3953c33742506fe414880bad78ac25cc9a9b1c6ae97bedd573f"},
+    {file = "Pillow-10.1.0-cp312-cp312-win_amd64.whl", hash = "sha256:eaed6977fa73408b7b8a24e8b14e59e1668cfc0f4c40193ea7ced8e210adf996"},
+    {file = "Pillow-10.1.0-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:fe1e26e1ffc38be097f0ba1d0d07fcade2bcfd1d023cda5b29935ae8052bd793"},
+    {file = "Pillow-10.1.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:7a7e3daa202beb61821c06d2517428e8e7c1aab08943e92ec9e5755c2fc9ba5e"},
+    {file = "Pillow-10.1.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:24fadc71218ad2b8ffe437b54876c9382b4a29e030a05a9879f615091f42ffc2"},
+    {file = "Pillow-10.1.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fa1d323703cfdac2036af05191b969b910d8f115cf53093125e4058f62012c9a"},
+    {file = "Pillow-10.1.0-cp38-cp38-manylinux_2_28_aarch64.whl", hash = "sha256:912e3812a1dbbc834da2b32299b124b5ddcb664ed354916fd1ed6f193f0e2d01"},
+    {file = "Pillow-10.1.0-cp38-cp38-manylinux_2_28_x86_64.whl", hash = "sha256:7dbaa3c7de82ef37e7708521be41db5565004258ca76945ad74a8e998c30af8d"},
+    {file = "Pillow-10.1.0-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:9d7bc666bd8c5a4225e7ac71f2f9d12466ec555e89092728ea0f5c0c2422ea80"},
+    {file = "Pillow-10.1.0-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:baada14941c83079bf84c037e2d8b7506ce201e92e3d2fa0d1303507a8538212"},
+    {file = "Pillow-10.1.0-cp38-cp38-win_amd64.whl", hash = "sha256:2ef6721c97894a7aa77723740a09547197533146fba8355e86d6d9a4a1056b14"},
+    {file = "Pillow-10.1.0-cp39-cp39-macosx_10_10_x86_64.whl", hash = "sha256:0a026c188be3b443916179f5d04548092e253beb0c3e2ee0a4e2cdad72f66099"},
+    {file = "Pillow-10.1.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:04f6f6149f266a100374ca3cc368b67fb27c4af9f1cc8cb6306d849dcdf12616"},
+    {file = "Pillow-10.1.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bb40c011447712d2e19cc261c82655f75f32cb724788df315ed992a4d65696bb"},
+    {file = "Pillow-10.1.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1a8413794b4ad9719346cd9306118450b7b00d9a15846451549314a58ac42219"},
+    {file = "Pillow-10.1.0-cp39-cp39-manylinux_2_28_aarch64.whl", hash = "sha256:c9aeea7b63edb7884b031a35305629a7593272b54f429a9869a4f63a1bf04c34"},
+    {file = "Pillow-10.1.0-cp39-cp39-manylinux_2_28_x86_64.whl", hash = "sha256:b4005fee46ed9be0b8fb42be0c20e79411533d1fd58edabebc0dd24626882cfd"},
+    {file = "Pillow-10.1.0-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:4d0152565c6aa6ebbfb1e5d8624140a440f2b99bf7afaafbdbf6430426497f28"},
+    {file = "Pillow-10.1.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:d921bc90b1defa55c9917ca6b6b71430e4286fc9e44c55ead78ca1a9f9eba5f2"},
+    {file = "Pillow-10.1.0-cp39-cp39-win_amd64.whl", hash = "sha256:cfe96560c6ce2f4c07d6647af2d0f3c54cc33289894ebd88cfbb3bcd5391e256"},
+    {file = "Pillow-10.1.0-pp310-pypy310_pp73-macosx_10_10_x86_64.whl", hash = "sha256:937bdc5a7f5343d1c97dc98149a0be7eb9704e937fe3dc7140e229ae4fc572a7"},
+    {file = "Pillow-10.1.0-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b1c25762197144e211efb5f4e8ad656f36c8d214d390585d1d21281f46d556ba"},
+    {file = "Pillow-10.1.0-pp310-pypy310_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:afc8eef765d948543a4775f00b7b8c079b3321d6b675dde0d02afa2ee23000b4"},
+    {file = "Pillow-10.1.0-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:883f216eac8712b83a63f41b76ddfb7b2afab1b74abbb413c5df6680f071a6b9"},
+    {file = "Pillow-10.1.0-pp39-pypy39_pp73-macosx_10_10_x86_64.whl", hash = "sha256:b920e4d028f6442bea9a75b7491c063f0b9a3972520731ed26c83e254302eb1e"},
+    {file = "Pillow-10.1.0-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1c41d960babf951e01a49c9746f92c5a7e0d939d1652d7ba30f6b3090f27e412"},
+    {file = "Pillow-10.1.0-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:1fafabe50a6977ac70dfe829b2d5735fd54e190ab55259ec8aea4aaea412fa0b"},
+    {file = "Pillow-10.1.0-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:3b834f4b16173e5b92ab6566f0473bfb09f939ba14b23b8da1f54fa63e4b623f"},
+    {file = "Pillow-10.1.0.tar.gz", hash = "sha256:e6bf8de6c36ed96c86ea3b6e1d5273c53f46ef518a062464cd7ef5dd2cf92e38"},
 ]
 
 [package.extras]
@@ -949,4 +949,4 @@ files = [
 [metadata]
 lock-version = "2.0"
 python-versions = "^3.10"
-content-hash = "b1a796541661c502a83bdff1d32338a15deedd516419a3f18c69a188c03a3b45"
+content-hash = "b3fda6291133bee58347705e446b75763872f0449f9718f9d3b365bce47ae9ff"
diff --git a/pyproject.toml b/pyproject.toml
index 172ba67..36d2055 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -9,7 +9,7 @@ license = "MIT"
 python = "^3.10"
 mkdocs = "^1.4.3"
 mkdocs-material = "^9.4.0"
-pillow = "^10.0.0"
+pillow = "^10.1.0"
 cairosvg = "^2.7.0"
 
 [tool.poetry.dev-dependencies]