ErikDB87
diff --git a/‎.vuepress/.gitignore
+1 b/‎.vuepress/.gitignore
+1
diff --git a/‎.vuepress/config.js
-94 b/‎.vuepress/config.js
-94
diff --git a/‎.vuepress/config.ts
+67 b/‎.vuepress/config.ts
+67
diff --git a/‎README.md
+34-6 b/‎README.md
+34-6
diff --git a/‎images/local-docu-preview.png
60.1 KB b/‎images/local-docu-preview.png
60.1 KB
@@ -1,3 +1,4 @@
 addons-*
 public/logos
 tmp
+dist
@@ -0,0 +1,67 @@
+import { DefaultThemeConfig, UserConfig, defineConfig } from "vuepress/config";
+
+const DocsSidebarNavigation = require('./docs-sidebar.js')
+
+const base = process.env.OH_DOCS_VERSION
+    ? `/v${process.env.OH_DOCS_VERSION}/`
+    : '/'
+
+const config: UserConfig<DefaultThemeConfig> = {
+    title: 'v4 Documentation Preview',
+    description: 'This is a preview of the main parts of the documentation, found in the openhab/openhab-docs repository',
+    dest: 'vuepress',
+    host: 'localhost',
+    plugins: [
+        // @ts-ignore
+        'tabs',
+        'container'
+    ],
+    // @ts-ignore
+    base: base,
+    patterns: [
+        'docs/**/*.md',
+        'addons/integrations/**/*.md',
+        '**/*.vue'],
+    configureWebpack: {
+        module: {
+            rules: [
+                {
+                    test: /\.(drawio|xml|txt)$/,
+                    exclude: /node_modules/,
+                    use: 'null-loader'
+                }
+            ]
+        }
+    },
+    head: [
+        ['link', { rel: 'stylesheet', href: `/fonts/fonts.css` }],
+        ['link', { rel: 'icon', href: `/favicon.ico` }],
+        ['link', { rel: 'shortcut icon', href: `/favicon.ico` }],
+        ['link', { rel: 'apple-touch-icon', href: `/apple-icon.png` }],
+        ['meta', { property: 'og:type', content: 'website' }],
+        ['meta', { property: 'og:image', content: 'https://www.openhab.org/og-image.png' }],
+
+    ],
+    themeConfig: {
+        logo: `/openhab-logo.png`,
+        editLinks: false,
+        activeHeaderLinks: false,
+        sidebarDepth: 0,
+        docsDir: 'docs',
+        nav: [
+            {
+                text: 'Documentation',
+                link: '/docs/',
+            },
+            {
+                text: 'GitHub',
+                link: 'https://github.com/openhab/openhab-docs',
+            }
+        ],
+        sidebar: {
+            '/docs/': DocsSidebarNavigation
+        }
+    }
+};
+
+export default defineConfig(config);
@@ -50,12 +50,6 @@ Imagine you want to do an improvement of the zwave binding and have to update th
 That's twice the effort and also we would have to coordinate two Pull Requests.
 So we are saving time for everyone by keeping those files at their original location along with the code.
 
-::: tip UNDER REVIEW
-
-The process below is subject to changes until the openHAB.x website become the production one.
-
-:::
-
 ### How the documentation build works
 
 We have set up our [build server](https://ci.openhab.org/view/Documentation/) to do the magic automatically.
@@ -85,6 +79,40 @@ When one of these jobs is finished, it will then notify our website hosting serv
 This is recognized due to new commits in the final branch of this repository.
 The new build will include all the latest changes in the code repository and in all external repositories.
 
+### How to build the documentation locally
+
+It is possible to build a preview version of the documentation on your local machine. The following software is required:
+
+- [`node =16.20.1`](https://nodejs.org/en)
+- [`ruby >=3.0.2`](https://www.ruby-lang.org/en/)
+- [`Python >= 3.10.12`](https://www.python.org)
+
+If you work on multiple node projects [Node Version Manager](https://github.com/nvm-sh/nvm) is recommended in case they use a different version of node.
+
+Example:
+
+```bash
+$ nvm install 16
+# ...
+$ nvm use 16
+Now using node v16.20.2 (npm v8.19.4)
+$ npm install
+# ...
+$ npm run serve
+# ...
+Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/)
+```
+
+The local preview is available under the following options
+
+- [http://0.0.0.0:8000/docs](http://0.0.0.0:8000/docs)
+- [http://localhost:8000/docs](http://localhost:8000/docs)
+- [http://[::]/:8000/docs](http://[::]:8000/docs)
+
+![local preview](images/local-docu-preview.png)
+
+This will also allow you to preview how the page renders on different devices using the respective browser tools.
+
 ## Documentation Versioning
 
 Just as openHAB is released in versions, the documentation website provides fixed versions of the documentation articles, e.g., [https://www.openhab.org/v2.2/installation/linux.html](https://www.openhab.org/v2.2/installation/linux.html)