website: move integrations to separate folder, separate sidebar and new URL, add URL redirect

Signed-off-by: Jens Langhammer <jens.langhammer@beryju.org>

website/docs/releases/v2021.2.md

@@ -116,11 +116,11 @@ Due to the switch to managed objects, some default property mappings are changin
 The change affects the "SAML Name" property, which has been changed from an oid to a Schema URI to aid readability.
 
 The integrations affected are:
-- [Ansible Tower/AWX](/docs/integrations/services/awx-tower/index)
-- [GitLab](/docs/integrations/services/gitlab/index)
-- [NextCloud](/docs/integrations/services/nextcloud/index)
-- [Rancher](/docs/integrations/services/rancher/index)
-- [Sentry](/docs/integrations/services/sentry/index)
+- [Ansible Tower/AWX](/integrations/services/awx-tower/index)
+- [GitLab](/integrations/services/gitlab/index)
+- [NextCloud](/integrations/services/nextcloud/index)
+- [Rancher](/integrations/services/rancher/index)
+- [Sentry](/integrations/services/sentry/index)
 
 ### docker-compose
 

website/docusaurus.config.js

@@ -21,6 +21,12 @@ module.exports = {
                     label: "Docs",
                     position: "left",
                 },
+                {
+                    to: "integrations/",
+                    activeBasePath: "integrations",
+                    label: "Integrations",
+                    position: "left",
+                },
                 {
                     to: "developer-docs/",
                     activeBasePath: "developer-docs",
@@ -84,8 +90,8 @@ module.exports = {
             respectPrefersColorScheme: true,
         },
         algolia: {
-            apiKey: '1b60b8f630b127697cbe0d3b31841470',
-            indexName: 'goauthentik',
+            apiKey: "1b60b8f630b127697cbe0d3b31841470",
+            indexName: "goauthentik",
         },
     },
     presets: [
@@ -95,7 +101,8 @@ module.exports = {
                 docs: {
                     id: "docs",
                     sidebarPath: require.resolve("./sidebars.js"),
-                    editUrl: "https://github.com/goauthentik/authentik/edit/master/website/",
+                    editUrl:
+                        "https://github.com/goauthentik/authentik/edit/master/website/",
                 },
                 theme: {
                     customCss: require.resolve("./src/css/custom.css"),
@@ -105,13 +112,25 @@ module.exports = {
     ],
     plugins: [
         [
-            '@docusaurus/plugin-content-docs',
+            "@docusaurus/plugin-content-docs",
             {
-                id: 'docsDevelopers',
-                path: 'developer-docs',
-                routeBasePath: 'developer-docs',
-                sidebarPath: require.resolve('./sidebarsDev.js'),
-                editUrl: "https://github.com/goauthentik/authentik/edit/master/website/",
+                id: "docsIntegrations",
+                path: "integrations",
+                routeBasePath: "integrations",
+                sidebarPath: require.resolve("./sidebarsIntegrations.js"),
+                editUrl:
+                    "https://github.com/goauthentik/authentik/edit/master/website/",
+            },
+        ],
+        [
+            "@docusaurus/plugin-content-docs",
+            {
+                id: "docsDevelopers",
+                path: "developer-docs",
+                routeBasePath: "developer-docs",
+                sidebarPath: require.resolve("./sidebarsDev.js"),
+                editUrl:
+                    "https://github.com/goauthentik/authentik/edit/master/website/",
             },
         ],
     ],
@@ -143,5 +162,5 @@ module.exports = {
     <% }); %>
     <%~ it.postBodyTags %>
   </body>
-</html>`
+</html>`,
 };

website/integrations/index.md

@@ -0,0 +1,6 @@
+---
+title: Integrations
+slug: /
+---
+
+Here you can find a full list of applications that have been documented to work with authentik. If you find any mistake or a step does not work for you, open a GitHub issue [here](https://github.com/goauthentik/authentik/issues/new/choose).

website/integrations/services/home-assistant/index.md

@@ -60,6 +60,6 @@ Create an application in authentik and select the provider you've created above.
 
 ## Deployment
 
-Create an outpost deployment for the provider you've created above, as described [here](../../../outposts/outposts.md). Deploy this Outpost either on the same host or a different host that can access Home-Assistant.
+Create an outpost deployment for the provider you've created above, as described [here](../../../../../docs/outposts/outposts). Deploy this Outpost either on the same host or a different host that can access Home-Assistant.
 
 The outpost will connect to authentik and configure itself.

website/integrations/services/sonarr/index.md

@@ -37,6 +37,6 @@ Create an application in authentik and select the provider you've created above.
 
 ## Deployment
 
-Create an outpost deployment for the provider you've created above, as described [here](../../../outposts/outposts.md). Deploy this Outpost either on the same host or a different host that can access Sonarr.
+Create an outpost deployment for the provider you've created above, as described [here](../../../../../docs/outposts/outposts). Deploy this Outpost either on the same host or a different host that can access Sonarr.
 
 The outpost will connect to authentik and configure itself.

website/integrations/sources/ldap/index.md

@@ -9,9 +9,9 @@ Sources allow you to connect authentik to an existing user directory. They can a
 This source allows you to import users and groups from an LDAP Server.
 
 :::info
-For Active Directory, follow the [Active Directory Integration](integrations/sources/active-directory/index.md)
+For Active Directory, follow the [Active Directory Integration](../active-directory/index.md)
 
-For FreeIPA, follow the [FreeIPA Integration](integrations/sources/freeipa/index.md)
+For FreeIPA, follow the [FreeIPA Integration](../freeipa/index.md)
 :::
 
 - Server URI: URI to your LDAP server/Domain Controller.
@@ -27,4 +27,4 @@ For FreeIPA, follow the [FreeIPA Integration](integrations/sources/freeipa/index
 - Object uniqueness field: This field contains a unique identifier.
 - Sync groups: Enable/disable group synchronization. Groups are synced in the background every 5 minutes.
 - Sync parent group: Optionally set this group as the parent group for all synced groups. An example use case of this would be to import Active Directory groups under a root `imported-from-ad` group.
-- Property mappings: Define which LDAP properties map to which authentik properties. The default set of property mappings is generated for Active Directory. See also [LDAP Property Mappings](property-mappings/index.md#ldap-property-mapping)
+- Property mappings: Define which LDAP properties map to which authentik properties. The default set of property mappings is generated for Active Directory. See also [LDAP Property Mappings](../../../docs/property-mappings/index#ldap-property-mapping)

website/netlify.toml

@@ -2,6 +2,10 @@
   from = "/discord"
   to = "https://discord.gg/jg33eMhnj6"
 
+[[redirects]]
+  from = "/docs/integrations/*"
+  to = "/integrations/:split"
+
 [[redirects]]
   from = "/*"
   to = "/.netlify/functions/go-get"

website/sidebars.js

@@ -11,10 +11,7 @@ module.exports = {
         {
             type: "category",
             label: "Users & Groups",
-            items: [
-                "user-group/user",
-                "user-group/group",
-            ]
+            items: ["user-group/user", "user-group/group"],
         },
         {
             type: "category",
@@ -64,64 +61,6 @@ module.exports = {
                 },
             ],
         },
-        {
-            type: "category",
-            label: "Integrations",
-            items: [
-                {
-                    type: "category",
-                    label: "as Source",
-                    items: [
-                        "integrations/sources/index",
-                        "integrations/sources/active-directory/index",
-                        "integrations/sources/apple/index",
-                        "integrations/sources/azure-ad/index",
-                        "integrations/sources/discord/index",
-                        "integrations/sources/freeipa/index",
-                        "integrations/sources/github/index",
-                        "integrations/sources/google/index",
-                        "integrations/sources/ldap/index",
-                        "integrations/sources/oauth/index",
-                        "integrations/sources/plex/index",
-                        "integrations/sources/saml/index",
-                    ],
-                },
-                {
-                    type: "category",
-                    label: "as Provider",
-                    items: [
-                        "integrations/services/apache-guacamole/index",
-                        "integrations/services/aws/index",
-                        "integrations/services/awx-tower/index",
-                        "integrations/services/bookstack/index",
-                        "integrations/services/gitea/index",
-                        "integrations/services/gitlab/index",
-                        "integrations/services/grafana/index",
-                        "integrations/services/harbor/index",
-                        "integrations/services/home-assistant/index",
-                        "integrations/services/matrix-synapse/index",
-                        "integrations/services/minio/index",
-                        "integrations/services/nextcloud/index",
-                        "integrations/services/onlyoffice/index",
-                        "integrations/services/opnsense/index",
-                        "integrations/services/portainer/index",
-                        "integrations/services/proxmox-ve/index",
-                        "integrations/services/rancher/index",
-                        "integrations/services/sentry/index",
-                        "integrations/services/sonarr/index",
-                        "integrations/services/tautulli/index",
-                        "integrations/services/ubuntu-landscape/index",
-                        "integrations/services/veeam-enterprise-manager/index",
-                        "integrations/services/vikunja/index",
-                        "integrations/services/vmware-vcenter/index",
-                        "integrations/services/wekan/index",
-                        "integrations/services/wiki-js/index",
-                        "integrations/services/wordpress/index",
-                        "integrations/services/zabbix/index",
-                    ],
-                },
-            ],
-        },
         {
             type: "category",
             label: "Flows",
@@ -166,7 +105,7 @@ module.exports = {
             items: [
                 "events/index",
                 "events/notifications",
-                "events/transports"
+                "events/transports",
             ],
         },
         {

website/sidebarsIntegrations.js

@@ -0,0 +1,60 @@
+module.exports = {
+    integrations: [
+        {
+            type: "doc",
+            id: "index",
+        },
+        {
+            type: "category",
+            label: "as Source",
+            items: [
+                "sources/index",
+                "sources/active-directory/index",
+                "sources/apple/index",
+                "sources/azure-ad/index",
+                "sources/discord/index",
+                "sources/freeipa/index",
+                "sources/github/index",
+                "sources/google/index",
+                "sources/ldap/index",
+                "sources/oauth/index",
+                "sources/plex/index",
+                "sources/saml/index",
+            ],
+        },
+        {
+            type: "category",
+            label: "as Provider",
+            items: [
+                "services/apache-guacamole/index",
+                "services/aws/index",
+                "services/awx-tower/index",
+                "services/bookstack/index",
+                "services/gitea/index",
+                "services/gitlab/index",
+                "services/grafana/index",
+                "services/harbor/index",
+                "services/home-assistant/index",
+                "services/matrix-synapse/index",
+                "services/minio/index",
+                "services/nextcloud/index",
+                "services/onlyoffice/index",
+                "services/opnsense/index",
+                "services/portainer/index",
+                "services/proxmox-ve/index",
+                "services/rancher/index",
+                "services/sentry/index",
+                "services/sonarr/index",
+                "services/tautulli/index",
+                "services/ubuntu-landscape/index",
+                "services/veeam-enterprise-manager/index",
+                "services/vikunja/index",
+                "services/vmware-vcenter/index",
+                "services/wekan/index",
+                "services/wiki-js/index",
+                "services/wordpress/index",
+                "services/zabbix/index",
+            ],
+        },
+    ],
+};