feat: restructure docs into "chapters" (#12)

* feat(docker, k8s): create containers folder and kubernetes notes
2025-05-15 15:44:47 +00:00 · 2023-03-13 11:33:51 +00:00 · 2023-03-13 11:33:51 +00:00 · 2725e3cb70
commit 2725e3cb70
parent b1cb858508
92 changed files with 777 additions and 367 deletions
--- a/mkdocs.yml
+++ b/mkdocs.yml
@ -11,6 +11,18 @@ copyright: MIT
 docs_dir: docs
 site_dir: site

+extra:
+  social:
+    - icon: fontawesome/brands/mastodon 
+      link: https://hachyderm.io/@m_lamonaca
+    - icon: fontawesome/brands/github
+      link: https://github.com/m-lamonaca
+
+plugins:
+  - social:
+      cards_font: JetBrains Mono
+
+
 theme:
  name: material
  language: en
@ -38,10 +50,15 @@ theme:

  features:
    - navigation.instant
+    - navigation.indexes
    - navigation.tracking
    # - navigation.sections
-    # - navigation.expand
    - navigation.top
+    - navigation.tabs
+    - navigation.tabs.sticky
+    - navigation.footer
+    - toc.follow
+

 markdown_extensions:
  - pymdownx.highlight:
@ -57,111 +74,117 @@ markdown_extensions:


 nav:
-  - Home: index.md
-  - Git: git/git.md
-  - HTML: html/html.md
-  - CSS: css/css.md
-  - Markdown: markdown.md
-  - GraphQL: graph-ql.md
-  - RegEx: regular-expressions.md
-  - Docker: docker/docker.md
-  - C: c/c.md
-  - Kotlin: kotlin/kotlin.md
-  - Swift: swift/swift.md
-  - Database:
-    - Redis: database/redis.md
-    - SQL: database/sql.md
-    - MongoDB: database/mongo-db.md
-  - Python:
-      - Python: python/python.md
+  - Home: README.md
+  - Containers:
+    - Docker: containers/docker.md
+    - Kubernetes: containers/kubernetes.md
+  - Databases:
+    - Redis: databases/redis.md
+    - SQL: databases/sql.md
+    - MongoDB: databases/mongo-db.md
+  - Languages:
+    - HTML: languages/html/html.md
+    - Markdown: languages/markdown.md
+    - CSS: languages/css/css.md
+    - C: languages/c/c.md
+    - Kotlin: languages/kotlin/kotlin.md
+    - Swift: languages/swift/swift.md
+    - Python:
+      - Python: languages/python/python.md
      - Modules:  
-        - argparse: python/modules/argparse.md
-        - collection: python/modules/collections.md
-        - csv: python/modules/csv.md
-        - ftplib: python/modules/ftplib.md
-        - itertools: python/modules/itertools.md
-        - json: python/modules/json.md
-        - logging: python/modules/logging.md
-        - shutil: python/modules/shutil.md
-        - smtplib: python/modules/smtplib.md
-        - socket: python/modules/socket.md
-        - sqlite: python/modules/sqlite.md
-        - time & datetime: python/modules/time-datetime.md
-        - unittest: python/modules/unittest.md
+        - argparse: languages/python/modules/argparse.md
+        - collection: languages/python/modules/collections.md
+        - csv: languages/python/modules/csv.md
+        - ftplib: languages/python/modules/ftplib.md
+        - itertools: languages/python/modules/itertools.md
+        - json: languages/python/modules/json.md
+        - logging: languages/python/modules/logging.md
+        - shutil: languages/python/modules/shutil.md
+        - smtplib: languages/python/modules/smtplib.md
+        - socket: languages/python/modules/socket.md
+        - sqlite: languages/python/modules/sqlite.md
+        - time & datetime: languages/python/modules/time-datetime.md
+        - unittest: languages/python/modules/unittest.md
      - Libraries:
-        - TKinter: python/libs/tkinter.md
-        - Numpy: python/libs/numpy.md
-        - Pandas: python/libs/pandas.md
-        - Seaborn: python/libs/seaborn.md
-        - Requests: python/libs/requests.md
-        - Beatiful Soup: python/libs/beautiful-soup.md
-  - .NET:
+        - TKinter: languages/python/libs/tkinter.md
+        - Numpy: languages/python/libs/numpy.md
+        - Pandas: languages/python/libs/pandas.md
+        - Seaborn: languages/python/libs/seaborn.md
+        - Requests: languages/python/libs/requests.md
+        - Beatiful Soup: languages/python/libs/beautiful-soup.md
+    - .NET:
      - C#:
-          - C#: dotnet/C#/C#.md
-          - Linq: dotnet/C#/linq.md
-          - Collections: dotnet/C#/collections.md
-          - Reactive Extensions: dotnet/C#/reactive-extensions.md
-          - Async Programming: dotnet/C#/async-programming.md
-          - Unit Tests: dotnet/C#/unit-tests.md
+          - C#: languages/dotnet/csharp/csharp.md
+          - Linq: languages/dotnet/csharp/linq.md
+          - Collections: languages/dotnet/csharp/collections.md
+          - Reactive Extensions: languages/dotnet/csharp/reactive-extensions.md
+          - Async Programming: languages/dotnet/csharp/async-programming.md
+          - Unit Tests: languages/dotnet/csharp/unit-tests.md
      - ASP.NET:
-          - App Configuration: dotnet/asp.net/app-configuration.md
-          - Minimal API: dotnet/asp.net/minimal-api.md
-          - MVC: dotnet/asp.net/mvc.md
-          - FIlters: dotnet/asp.net/filters.md
-          - Middleware: dotnet/asp.net/middleware.md
-          - Razor Pages: dotnet/asp.net/razor-syntax.md
-          - Blazor: dotnet/asp.net/blazor.md
-          - Razor Pages: dotnet/asp.net/razor-pages.md
-          - Razor Syntax: dotnet/asp.net/razor-syntax.md
-          - REST API: dotnet/asp.net/rest-api.md
-          - SignalR: dotnet/asp.net/signalr.md
-          - Web Forms: dotnet/asp.net/web-forms.md
+          - 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
+          - SignalR: languages/dotnet/asp.net/signalr.md
+          - Web Forms: languages/dotnet/asp.net/web-forms.md
      - Database:
-          - ADO.NET: dotnet/database/ado.net.md
-          - Entity Framework: dotnet/database/entity-framework.md
-  - Java:
-      - Java: java/java.md
-      - Java Collection Framework: java/java-collection-framework.md
-      - DAO: java/dao.md
-      - Web:
-          - Serverlet: java/web/servlet.md
-          - Spring:
-              - POM: java/spring/pom.xml.md
-              - Project Structure: java/spring/spring-project.md
-  - PHP:
-      - PHP: php/php.md
-      - Database: php/database.md
-      - Web: php/web.md
-      - Dependency Injection: php/dependency-injection.md
-      - Unit Tests: php/unit-tests.md
-      - Composer: php/composer.md
-      - PSR 7: php/psr-7.md
-      - Plates: php/plates-templating.md
-      - Simple MVC:
-          - Simple MVC: php/simple-mvc/simple-mvc.md
-          - REST API: php/simple-mvc/rest-api.md
-  - Rust:
-      - Rust: rust/rust.md
-      - Cargo: rust/cargo.md
-      - Unit Tests: rust/unit-tests.md
-  - Javascript:
-      - Javascript: javascript/javascript.md
-      - DOM: javascript/dom.md
-      - Events & Animation: javascript/events-animation.md
-      - AJAX: javascript/ajax.md
-      - jQuery: javascript/jquery.md
-      - React:
-          - React: javascript/react/react.md
-          - React Router: javascript/react/react-router.md
-          - React Tests: javascript/react/react-tests.md
-          - Redux: javascript/react/redux.md
-          - Redux Tests: javascript/react/redux-tests.md
-      - Svelte: javascript/svelte/svelte.md
-  - iOS:
-      - ContentView: ios/content-view.md
-  - PowerShell:
-      - Scripting: powershell/scripting.md
-      - Commands: powershell/commands.md
-  - Bash:
-      - Scripting: bash/scripting.md
-      - Commands: bash/commands.md
+          - ADO.NET: languages/dotnet/database/ado.net.md
+          - Entity Framework: languages/dotnet/database/entity-framework.md
+    - Java:
+        - Java: languages/java/java.md
+        - Java Collection Framework: languages/java/java-collection-framework.md
+        - DAO: languages/java/dao.md
+        - Web:
+            - Serverlet: languages/java/web/servlet.md
+            - Spring:
+                - POM: languages/java/spring/pom.xml.md
+                - Project Structure: languages/java/spring/spring-project.md
+    - PHP:
+        - PHP: languages/php/php.md
+        - Database: languages/php/database.md
+        - Web: languages/php/web.md
+        - Dependency Injection: languages/php/dependency-injection.md
+        - Unit Tests: languages/php/unit-tests.md
+        - Composer: languages/php/composer.md
+        - PSR 7: languages/php/psr-7.md
+        - Plates: languages/php/plates-templating.md
+        - Simple MVC:
+            - Simple MVC: languages/php/simple-mvc/simple-mvc.md
+            - REST API: languages/php/simple-mvc/rest-api.md
+    - Rust:
+        - Rust: languages/rust/rust.md
+        - Cargo: languages/rust/cargo.md
+        - Unit Tests: languages/rust/unit-tests.md
+    - Javascript:
+        - Javascript: languages/javascript/javascript.md
+        - DOM: languages/javascript/dom.md
+        - Events & Animation: languages/javascript/events-animation.md
+        - AJAX: languages/javascript/ajax.md
+        - jQuery: languages/javascript/jquery.md
+        - React:
+            - React: languages/javascript/react/react.md
+            - React Router: languages/javascript/react/react-router.md
+            - React Tests: languages/javascript/react/react-tests.md
+            - Redux: languages/javascript/react/redux.md
+            - Redux Tests: languages/javascript/react/redux-tests.md
+        - Svelte: languages/javascript/svelte/svelte.md
+    - PowerShell:
+        - Scripting: languages/powershell/scripting.md
+        - Commands: languages/powershell/commands.md
+    - 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:
+    - GraphQL: graph-ql.md
+    - RegEx: regular-expressions.md