From f6d1110d6bafdf1b6d61ec120f9ddf058f3619c0 Mon Sep 17 00:00:00 2001
From: david-swift <haenerdavid@icloud.com>
Date: Sat, 12 Apr 2025 23:17:26 +0200
Subject: [PATCH] Create docs

---
 config.toml                                      |   2 +-
 content/_index.md                                |   5 +++--
 content/{patterns => docs}/Button/iconGNOME.png  | Bin
 .../{patterns => docs}/Button/iconWindows.png    | Bin
 content/{patterns => docs}/Button/index.md       |   7 +++----
 content/{patterns => docs}/Button/labelGNOME.png | Bin
 .../{patterns => docs}/Button/labelIconGNOME.png | Bin
 .../Button/labelIconWindows.png                  | Bin
 .../{patterns => docs}/Button/labelWindows.png   | Bin
 content/docs/{ => DetailedDocs}/index.md         |   8 ++++----
 .../{patterns => docs}/FlatNavigation/index.md   |   7 +++----
 .../FlatNavigation/primaryGNOME.png              | Bin
 .../FlatNavigation/primaryGNOMETop.png           | Bin
 .../FlatNavigation/primaryWindows.png            | Bin
 .../FlatNavigation/primaryWindowsTop.png         | Bin
 .../FlatNavigation/sidebarGNOME.png              | Bin
 .../FlatNavigation/sidebarWindows.png            | Bin
 .../FlatNavigation/topGNOME.png                  | Bin
 .../FlatNavigation/topWindows.png                | Bin
 content/docs/GettingStarted/index.md             |  15 +++++++++++++++
 content/docs/_index.md                           |  11 +++++++++++
 content/patterns/_index.md                       |   9 ---------
 content/tutorials/GettingStarted/index.md        |   7 -------
 content/tutorials/_index.md                      |   6 ------
 themes/duckling                                  |   2 +-
 25 files changed, 41 insertions(+), 38 deletions(-)
 rename content/{patterns => docs}/Button/iconGNOME.png (100%)
 rename content/{patterns => docs}/Button/iconWindows.png (100%)
 rename content/{patterns => docs}/Button/index.md (93%)
 rename content/{patterns => docs}/Button/labelGNOME.png (100%)
 rename content/{patterns => docs}/Button/labelIconGNOME.png (100%)
 rename content/{patterns => docs}/Button/labelIconWindows.png (100%)
 rename content/{patterns => docs}/Button/labelWindows.png (100%)
 rename content/docs/{ => DetailedDocs}/index.md (81%)
 rename content/{patterns => docs}/FlatNavigation/index.md (97%)
 rename content/{patterns => docs}/FlatNavigation/primaryGNOME.png (100%)
 rename content/{patterns => docs}/FlatNavigation/primaryGNOMETop.png (100%)
 rename content/{patterns => docs}/FlatNavigation/primaryWindows.png (100%)
 rename content/{patterns => docs}/FlatNavigation/primaryWindowsTop.png (100%)
 rename content/{patterns => docs}/FlatNavigation/sidebarGNOME.png (100%)
 rename content/{patterns => docs}/FlatNavigation/sidebarWindows.png (100%)
 rename content/{patterns => docs}/FlatNavigation/topGNOME.png (100%)
 rename content/{patterns => docs}/FlatNavigation/topWindows.png (100%)
 create mode 100644 content/docs/GettingStarted/index.md
 create mode 100644 content/docs/_index.md
 delete mode 100644 content/patterns/_index.md
 delete mode 100644 content/tutorials/GettingStarted/index.md
 delete mode 100644 content/tutorials/_index.md

diff --git a/config.toml b/config.toml
index 3c44bbb..661d5b7 100644
--- a/config.toml
+++ b/config.toml
@@ -47,7 +47,7 @@ show_source = true
 [extra.nav]
 links = [
   { url = "@/backends/_index.md", name = "Backends" },
-  { url = "/patterns", name = "Patterns" },
+  { url = "@/docs/GettingStarted/index.md", name = "Docs" },
   { url = "https://forums.aparoksha.dev/", name = "Community" },
   { url = "https://git.aparoksha.dev/aparoksha", name = "Code" },
 ]
diff --git a/content/_index.md b/content/_index.md
index 2f2dcae..d72ee9c 100644
--- a/content/_index.md
+++ b/content/_index.md
@@ -19,6 +19,7 @@ Aparoksha is easy-to-use, safe, and <i>aparoksha</i>, meaning that its reactive
 {% alert(warning=true) %}
 This project is currently under development and not yet ready for production.
 Follow the project [on the Fediverse](https://mastodon.de/@aparoksha) to stay up to date.
+The most mature part is [Adwaita for Swift](/backends/adwaita/).
 {% end %}
 
 <br>
@@ -29,7 +30,7 @@ Follow the project [on the Fediverse](https://mastodon.de/@aparoksha) to stay up
 
 A view is a piece of the user interface.
 Create your own views, such as `Avatar`, `Post`, and `Timeline`.
-Combine them into pages, windows, and apps.
+Combine them to create more complex views, windows, and apps.
 
 <!---
 <aside>
@@ -55,7 +56,7 @@ struct Timeline: View {
 ## The Magic of the State
 
 Each of your views has the ability to store state throughout view updates.
-Let's create a simple counter view:
+Take a look at a simple, fully functional counter view:
 
 <!---
 <aside>
diff --git a/content/patterns/Button/iconGNOME.png b/content/docs/Button/iconGNOME.png
similarity index 100%
rename from content/patterns/Button/iconGNOME.png
rename to content/docs/Button/iconGNOME.png
diff --git a/content/patterns/Button/iconWindows.png b/content/docs/Button/iconWindows.png
similarity index 100%
rename from content/patterns/Button/iconWindows.png
rename to content/docs/Button/iconWindows.png
diff --git a/content/patterns/Button/index.md b/content/docs/Button/index.md
similarity index 93%
rename from content/patterns/Button/index.md
rename to content/docs/Button/index.md
index 7039822..fe51c0d 100644
--- a/content/patterns/Button/index.md
+++ b/content/docs/Button/index.md
@@ -1,9 +1,8 @@
 +++
 title = "Button"
-description = "Let the user trigger an event."
-date = 2024-11-15
-[taxonomies]
-tags = ["Aparoksha", "Windows", "Linux", "macOS"]
+weight = 1
+[extra]
+section = 1
 +++
 
 The button is one of the most common user interface elements.
diff --git a/content/patterns/Button/labelGNOME.png b/content/docs/Button/labelGNOME.png
similarity index 100%
rename from content/patterns/Button/labelGNOME.png
rename to content/docs/Button/labelGNOME.png
diff --git a/content/patterns/Button/labelIconGNOME.png b/content/docs/Button/labelIconGNOME.png
similarity index 100%
rename from content/patterns/Button/labelIconGNOME.png
rename to content/docs/Button/labelIconGNOME.png
diff --git a/content/patterns/Button/labelIconWindows.png b/content/docs/Button/labelIconWindows.png
similarity index 100%
rename from content/patterns/Button/labelIconWindows.png
rename to content/docs/Button/labelIconWindows.png
diff --git a/content/patterns/Button/labelWindows.png b/content/docs/Button/labelWindows.png
similarity index 100%
rename from content/patterns/Button/labelWindows.png
rename to content/docs/Button/labelWindows.png
diff --git a/content/docs/index.md b/content/docs/DetailedDocs/index.md
similarity index 81%
rename from content/docs/index.md
rename to content/docs/DetailedDocs/index.md
index 1438a1a..ce3a1a1 100644
--- a/content/docs/index.md
+++ b/content/docs/DetailedDocs/index.md
@@ -1,8 +1,8 @@
 +++
-title = "Documentation"
-description = "A collection of links to the documentation of the components of Aparoksha."
-[taxonomies]
-tags = ["Linux", "macOS", "Windows", "Aparoksha"]
+title = "Detailed Docs"
+weight = 0
+[extra]
+section = 2
 +++
 
 The following links lead to the API documentation of individual parts of the Aparoksha framework.
diff --git a/content/patterns/FlatNavigation/index.md b/content/docs/FlatNavigation/index.md
similarity index 97%
rename from content/patterns/FlatNavigation/index.md
rename to content/docs/FlatNavigation/index.md
index 1bd66a2..8e7379d 100644
--- a/content/patterns/FlatNavigation/index.md
+++ b/content/docs/FlatNavigation/index.md
@@ -1,9 +1,8 @@
 +++
 title = "Flat Navigation"
-description = "A navigation pattern for views of equal importance."
-date = 2024-11-16
-[taxonomies]
-tags = ["Aparoksha", "Windows", "Linux", "macOS"]
+weight = 0
+[extra]
+section = 1
 +++
 
 In a flat navigation structure, each page is equivalent in importance and can be opened form any of the others.
diff --git a/content/patterns/FlatNavigation/primaryGNOME.png b/content/docs/FlatNavigation/primaryGNOME.png
similarity index 100%
rename from content/patterns/FlatNavigation/primaryGNOME.png
rename to content/docs/FlatNavigation/primaryGNOME.png
diff --git a/content/patterns/FlatNavigation/primaryGNOMETop.png b/content/docs/FlatNavigation/primaryGNOMETop.png
similarity index 100%
rename from content/patterns/FlatNavigation/primaryGNOMETop.png
rename to content/docs/FlatNavigation/primaryGNOMETop.png
diff --git a/content/patterns/FlatNavigation/primaryWindows.png b/content/docs/FlatNavigation/primaryWindows.png
similarity index 100%
rename from content/patterns/FlatNavigation/primaryWindows.png
rename to content/docs/FlatNavigation/primaryWindows.png
diff --git a/content/patterns/FlatNavigation/primaryWindowsTop.png b/content/docs/FlatNavigation/primaryWindowsTop.png
similarity index 100%
rename from content/patterns/FlatNavigation/primaryWindowsTop.png
rename to content/docs/FlatNavigation/primaryWindowsTop.png
diff --git a/content/patterns/FlatNavigation/sidebarGNOME.png b/content/docs/FlatNavigation/sidebarGNOME.png
similarity index 100%
rename from content/patterns/FlatNavigation/sidebarGNOME.png
rename to content/docs/FlatNavigation/sidebarGNOME.png
diff --git a/content/patterns/FlatNavigation/sidebarWindows.png b/content/docs/FlatNavigation/sidebarWindows.png
similarity index 100%
rename from content/patterns/FlatNavigation/sidebarWindows.png
rename to content/docs/FlatNavigation/sidebarWindows.png
diff --git a/content/patterns/FlatNavigation/topGNOME.png b/content/docs/FlatNavigation/topGNOME.png
similarity index 100%
rename from content/patterns/FlatNavigation/topGNOME.png
rename to content/docs/FlatNavigation/topGNOME.png
diff --git a/content/patterns/FlatNavigation/topWindows.png b/content/docs/FlatNavigation/topWindows.png
similarity index 100%
rename from content/patterns/FlatNavigation/topWindows.png
rename to content/docs/FlatNavigation/topWindows.png
diff --git a/content/docs/GettingStarted/index.md b/content/docs/GettingStarted/index.md
new file mode 100644
index 0000000..81199e8
--- /dev/null
+++ b/content/docs/GettingStarted/index.md
@@ -0,0 +1,15 @@
++++
+title = "Getting Started"
+weight = 0
+[extra]
+section = 0
++++
+
+Aparoksha is currently under development. The availability of views is limited.
+Therefore, the usage of Aparoksha is not currently recommended.
+
+However, certain parts of the project are already quite stable.
+This includes [Adwaita for Swift](/backends/adwaita/) for the creation of [GNOME](https://www.gnome.org/) apps
+and the [Meta package](https://meta.aparoksha.dev/documentation/meta/) that can be used to create your own UI frameworks.
+
+Note that those docs are incomplete.
diff --git a/content/docs/_index.md b/content/docs/_index.md
new file mode 100644
index 0000000..2d5dd9d
--- /dev/null
+++ b/content/docs/_index.md
@@ -0,0 +1,11 @@
++++
+title = "Docs"
+sort_by = "weight"
+template = "subproject_list.html"
+page_template = "documentation_page.html"
+[extra]
+sections = [
+    "Patterns",
+    "More"
+]
++++
diff --git a/content/patterns/_index.md b/content/patterns/_index.md
deleted file mode 100644
index d98bb04..0000000
--- a/content/patterns/_index.md
+++ /dev/null
@@ -1,9 +0,0 @@
-+++
-title = "Views and Patterns"
-sort_by = "date"
-template = "subproject_list.html"
-page_template = "subproject.html"
-+++
-
-The following views and patterns are available in the Aparoksha framework.
-Other patterns available in a platform-specific framework can be used in your app, but are not listed here if there is no cross-platform version at the moment.
diff --git a/content/tutorials/GettingStarted/index.md b/content/tutorials/GettingStarted/index.md
deleted file mode 100644
index b0845ad..0000000
--- a/content/tutorials/GettingStarted/index.md
+++ /dev/null
@@ -1,7 +0,0 @@
-+++
-title = "Getting Started"
-description = "Learn Aparoksha following a simple path."
-date = 2023-09-12
-[taxonomies]
-tags = ["Linux", "macOS", "Windows", "Aparoksha"]
-+++
diff --git a/content/tutorials/_index.md b/content/tutorials/_index.md
deleted file mode 100644
index 830ae23..0000000
--- a/content/tutorials/_index.md
+++ /dev/null
@@ -1,6 +0,0 @@
-+++
-title = "Tutorials"
-sort_by = "date"
-template = "article_list.html"
-page_template = "article.html"
-+++
diff --git a/themes/duckling b/themes/duckling
index 9f538c8..4e6f1af 160000
--- a/themes/duckling
+++ b/themes/duckling
@@ -1 +1 @@
-Subproject commit 9f538c804d83b59cd4cb0ca9bd17f3165b37c01d
+Subproject commit 4e6f1af8064ee89612803ad5d5cc397f25b6a82b