Create docs

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" },
 ]

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>

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.

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.

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.

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.

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"
+]
++++

content/patterns/_index.md

@@ -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.

content/tutorials/GettingStarted/index.md

@@ -1,7 +0,0 @@
-+++
-title = "Getting Started"
-description = "Learn Aparoksha following a simple path."
-date = 2023-09-12
-[taxonomies]
-tags = ["Linux", "macOS", "Windows", "Aparoksha"]
-+++

content/tutorials/_index.md

@@ -1,6 +0,0 @@
-+++
-title = "Tutorials"
-sort_by = "date"
-template = "article_list.html"
-page_template = "article.html"
-+++

themes/duckling

@@ -1 +1 @@
-Subproject commit 9f538c804d83b59cd4cb0ca9bd17f3165b37c01d
+Subproject commit 4e6f1af8064ee89612803ad5d5cc397f25b6a82b