diff --git a/docs/getting-started/using-openwebui/resources.mdx b/docs/getting-started/using-openwebui/resources.mdx index 2147226..2bf1a3f 100644 --- a/docs/getting-started/using-openwebui/resources.mdx +++ b/docs/getting-started/using-openwebui/resources.mdx @@ -24,6 +24,8 @@ Connect with the Open WebUI community for support, tips, and discussions. [Join the Discord Server](https://discord.com/invite/5rJgQTnV4s) - **Reddit**: Follow the Open WebUI subreddit for announcements, discussions, and user-submitted content. [Visit Reddit Community](https://www.reddit.com/r/OpenWebUI/) +- **GitHub Community**: Participate in discussions, propose feature requests, and report issues specific to the Open WebUI Community Platform website. + [Explore the GitHub Community](https://github.com/open-webui/community) --- diff --git a/docs/tutorials/integrations/docker-install.md b/docs/tutorials/integrations/docker-install.md index bcb762e..b8fab48 100644 --- a/docs/tutorials/integrations/docker-install.md +++ b/docs/tutorials/integrations/docker-install.md @@ -1,3 +1,7 @@ +--- +sidebar_position: 2 +title: Installing Docker +--- :::warning This tutorial is a community contribution and is not supported by the OpenWebUI team. It serves only as a demonstration on how to customize OpenWebUI for your specific use case. Want to contribute? Check out the contributing tutorial. diff --git a/docs/tutorials/integrations/https-nginx.md b/docs/tutorials/integrations/https-nginx.md index 03be8bd..caff3c8 100644 --- a/docs/tutorials/integrations/https-nginx.md +++ b/docs/tutorials/integrations/https-nginx.md @@ -1,3 +1,7 @@ +--- +title: HTTPS using Nginx +--- + :::warning This tutorial is a community contribution and is not supported by the OpenWebUI team. It serves only as a demonstration on how to customize OpenWebUI for your specific use case. Want to contribute? Check out the contributing tutorial. ::: diff --git a/docs/tutorials/tips/contributing-tutorial.md b/docs/tutorials/tips/contributing-tutorial.md index 0bca1bc..6c3e200 100644 --- a/docs/tutorials/tips/contributing-tutorial.md +++ b/docs/tutorials/tips/contributing-tutorial.md @@ -18,23 +18,52 @@ We appreciate your interest in contributing tutorials to the Open WebUI document - Navigate to the [Open WebUI Docs Repository](https://github.com/open-webui/docs) on GitHub. - Click the **Fork** button at the top-right corner to create a copy under your GitHub account. -2. **Configure GitHub Environment Variables** +2. **Enable GitHub Actions** + + - In your forked repository, navigate to the **Actions** tab. + - If prompted, enable GitHub Actions by following the on-screen instructions. + +3. **Enable GitHub Pages** + + - Go to **Settings** > **Pages** in your forked repository. + - Under **Source**, select the branch you want to deploy (e.g., `main`) and the folder (e.g.,`/docs`). + - Click **Save** to enable GitHub Pages. + + +4. **Configure GitHub Environment Variables** - In your forked repository, go to **Settings** > **Secrets and variables** > **Actions** > **Variables**. - Add the following environment variables: - `BASE_URL` set to `/docs` (or your chosen base URL for the fork). - `SITE_URL` set to `https://.github.io/`. -3. **Enable GitHub Actions** +### 📝 Updating the GitHub Pages Workflow and Config File - - In your forked repository, navigate to the **Actions** tab. - - If prompted, enable GitHub Actions by following the on-screen instructions. +If you need to adjust deployment settings to fit your custom setup, here’s what to do: -4. **Enable GitHub Pages** +a. **Update `.github/workflows/gh-pages.yml`** + - Add environment variables for `BASE_URL` and `SITE_URL` to the build step if necessary: + ```yaml + - name: Build + env: + BASE_URL: ${{ vars.BASE_URL }} + SITE_URL: ${{ vars.SITE_URL }} + run: npm run build + ``` - - Go to **Settings** > **Pages** in your forked repository. - - Under **Source**, select the branch you want to deploy (e.g., `main`) and the folder (e.g.,`/docs`). - - Click **Save** to enable GitHub Pages. +b. **Modify `docusaurus.config.ts` to Use Environment Variables** + - Update `docusaurus.config.ts` to use these environment variables, with default values for local or direct deployment: + ```typescript + const config: Config = { + title: "Open WebUI", + tagline: "ChatGPT-Style WebUI for LLMs (Formerly Ollama WebUI)", + favicon: "img/favicon.png", + url: process.env.SITE_URL || "https://openwebui.com", + baseUrl: process.env.BASE_URL || "/", + ... + }; + ``` + - This setup ensures consistent deployment behavior for forks and custom setups. 5. **Run the `gh-pages` GitHub Workflow** @@ -43,7 +72,7 @@ We appreciate your interest in contributing tutorials to the Open WebUI document 6. **Browse to Your Forked Copy** - - Visit `https://.github.io/docs` to view your forked documentation. + - Visit `https://.github.io/` to view your forked documentation. 7. **Draft Your Changes**