From 3007303db7d0fcf05e4035437d2145184cae6a97 Mon Sep 17 00:00:00 2001 From: Stavros Kois <47820033+stavros-k@users.noreply.github.com> Date: Mon, 11 Jul 2022 22:13:45 +0300 Subject: [PATCH] chore(docs): add markdownlint and cpell config files (and apply some linting) (#3140) * chore(docs): apply some linting * chore(docs): add markdownlint and cpell config files * remove duplicate key * add extension recommendation * update cspell --- .github/README.md | 48 ++++++++++--------- .markdownlint.yaml | 13 +++++ .vscode/extensions.json | 2 + .../docs/installation_notes.md | 13 ++--- .../collabora-online/questions.yaml | 2 +- .../avidemux/docs/installation_notes.md | 4 +- .../dupeguru/docs/installation_notes.md | 4 +- .../filebot/docs/installation_notes.md | 4 +- .../mediainfo/docs/installation_notes.md | 4 +- .../mkvcleaver/docs/installation_notes.md | 4 +- .../qdirstat/docs/installation_notes.md | 4 +- ...tion_notes.md.md => installation_notes.md} | 4 +- .../deepstack/docs/installation_notes.md | 3 +- charts/stable/duplicati/docs/ingress.md | 2 +- .../fireflyiii/docs/installation_notes.md | 3 +- .../handbrake/docs/installation_notes.md | 4 +- .../jdownloader2/docs/installation_notes.md | 4 +- .../stable/makemkv/docs/installation_notes.md | 4 +- .../meshroom/docs/installation_notes.md | 7 +-- .../minecraft-java/docs/community-guide.md | 32 +++++-------- .../nextcloud/docs/installation_notes.md | 16 +++---- cspell.config.yaml | 27 +++++++++++ mkdocs.yml | 1 - 23 files changed, 131 insertions(+), 78 deletions(-) create mode 100644 .markdownlint.yaml rename charts/incubator/tsmuxer/docs/{installation_notes.md.md => installation_notes.md} (80%) create mode 100644 cspell.config.yaml diff --git a/.github/README.md b/.github/README.md index 6456c9bd7f2..7938c53f8a4 100644 --- a/.github/README.md +++ b/.github/README.md @@ -1,4 +1,5 @@ -# TrueCharts
+# TrueCharts + **Community App Catalog for TrueNAS SCALE** [![docs](https://img.shields.io/badge/docs-rtfm-yellow?logo=gitbook&logoColor=white&style=for-the-badge)](https://truecharts.org/) @@ -6,6 +7,7 @@ [![GitHub last commit](https://img.shields.io/github/last-commit/truecharts/apps?color=brightgreen&logoColor=white&style=for-the-badge)](https://github.com/truecharts/apps/commits) --- + TrueCharts is a catalog of highly optimised TrueNAS SCALE Apps. Made for the community, By the community! Our primary goals are: @@ -20,12 +22,14 @@ Our primary goals are: All our apps are supposed to work together, be easy to setup using the TrueNAS UI and, above all, give the average user more than enough options to tune things to their liking. -
+
## Getting started using TrueCharts + [![docs](https://img.shields.io/badge/docs-rtfm-yellow?logo=gitbook&logoColor=white&style=for-the-badge)](https://truecharts.org/) --- + Installing TrueCharts within TrueNAS SCALE, is possible using the TrueNAS SCALE Catalog list. Check TrueCharts [Quick-Start Guides](https://truecharts.org/manual/Quick-Start%20Guides/01-Adding-TrueCharts/) for more infotmation. @@ -40,29 +44,28 @@ Still something not working as expected? [Contact us!](https://truecharts.org/ab For big changes we do have a roadmap, every spot on the roadmap is synced to a TrueNAS SCALE Release and should be read as "Should be added at or before this release" - -
+
**Restructure of the Project - TrueNAS SCALE "Bluefin" 22.xx ALPHA 1** _The current project is hitting internal performance issues, for this reason we need to rework the structure and split some parts of the project into seperate repositories._ -
+
**Refactor the Common Chart - TrueNAS SCALE "Bluefin" 22.xx ALPHA 2** _The shared Common (chart) basis, used by all our Apps, needs some significant code cleanup. Primarily all code needs to follow a standardised format and comply to the same standard_ -
+
**Increased test coverage - TrueNAS SCALE "Bluefin" 22.xx BETA 1** _With most parts of our project somewhat cleaned up, we need to work on increasing the coverage of our test system. Our unittests should cover all features and we should also take upgrades into account when testing App changes_ - -
+
## Development + [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=for-the-badge)](https://github.com/pre-commit/pre-commit) [![renovate](https://img.shields.io/badge/renovate-enabled-brightgreen?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjUgNSAzNzAgMzcwIj48Y2lyY2xlIGN4PSIxODkiIGN5PSIxOTAiIHI9IjE4NCIgZmlsbD0iI2ZlMiIvPjxwYXRoIGZpbGw9IiM4YmIiIGQ9Ik0yNTEgMjU2bC0zOC0zOGExNyAxNyAwIDAxMC0yNGw1Ni01NmMyLTIgMi02IDAtN2wtMjAtMjFhNSA1IDAgMDAtNyAwbC0xMyAxMi05LTggMTMtMTNhMTcgMTcgMCAwMTI0IDBsMjEgMjFjNyA3IDcgMTcgMCAyNGwtNTYgNTdhNSA1IDAgMDAwIDdsMzggMzh6Ii8+PHBhdGggZmlsbD0iI2Q1MSIgZD0iTTMwMCAyODhsLTggOGMtNCA0LTExIDQtMTYgMGwtNDYtNDZjLTUtNS01LTEyIDAtMTZsOC04YzQtNCAxMS00IDE1IDBsNDcgNDdjNCA0IDQgMTEgMCAxNXoiLz48cGF0aCBmaWxsPSIjYjMwIiBkPSJNMjg1IDI1OGw3IDdjNCA0IDQgMTEgMCAxNWwtOCA4Yy00IDQtMTEgNC0xNiAwbC02LTdjNCA1IDExIDUgMTUgMGw4LTdjNC01IDQtMTIgMC0xNnoiLz48cGF0aCBmaWxsPSIjYTMwIiBkPSJNMjkxIDI2NGw4IDhjNCA0IDQgMTEgMCAxNmwtOCA3Yy00IDUtMTEgNS0xNSAwbC05LThjNSA1IDEyIDUgMTYgMGw4LThjNC00IDQtMTEgMC0xNXoiLz48cGF0aCBmaWxsPSIjZTYyIiBkPSJNMjYwIDIzM2wtNC00Yy02LTYtMTctNi0yMyAwLTcgNy03IDE3IDAgMjRsNCA0Yy00LTUtNC0xMSAwLTE2bDgtOGM0LTQgMTEtNCAxNSAweiIvPjxwYXRoIGZpbGw9IiNiNDAiIGQ9Ik0yODQgMzA0Yy00IDAtOC0xLTExLTRsLTQ3LTQ3Yy02LTYtNi0xNiAwLTIybDgtOGM2LTYgMTYtNiAyMiAwbDQ3IDQ2YzYgNyA2IDE3IDAgMjNsLTggOGMtMyAzLTcgNC0xMSA0em0tMzktNzZjLTEgMC0zIDAtNCAybC04IDdjLTIgMy0yIDcgMCA5bDQ3IDQ3YTYgNiAwIDAwOSAwbDctOGMzLTIgMy02IDAtOWwtNDYtNDZjLTItMi0zLTItNS0yeiIvPjxwYXRoIGZpbGw9IiMxY2MiIGQ9Ik0xNTIgMTEzbDE4LTE4IDE4IDE4LTE4IDE4em0xLTM1bDE4LTE4IDE4IDE4LTE4IDE4em0tOTAgODlsMTgtMTggMTggMTgtMTggMTh6bTM1LTM2bDE4LTE4IDE4IDE4LTE4IDE4eiIvPjxwYXRoIGZpbGw9IiMxZGQiIGQ9Ik0xMzQgMTMxbDE4LTE4IDE4IDE4LTE4IDE4em0tMzUgMzZsMTgtMTggMTggMTgtMTggMTh6Ii8+PHBhdGggZmlsbD0iIzJiYiIgZD0iTTExNiAxNDlsMTgtMTggMTggMTgtMTggMTh6bTU0LTU0bDE4LTE4IDE4IDE4LTE4IDE4em0tODkgOTBsMTgtMTggMTggMTgtMTggMTh6bTEzOS04NWwyMyAyM2M0IDQgNCAxMSAwIDE2TDE0MiAyNDBjLTQgNC0xMSA0LTE1IDBsLTI0LTI0Yy00LTQtNC0xMSAwLTE1bDEwMS0xMDFjNS01IDEyLTUgMTYgMHoiLz48cGF0aCBmaWxsPSIjM2VlIiBkPSJNMTM0IDk1bDE4LTE4IDE4IDE4LTE4IDE4em0tNTQgMThsMTgtMTcgMTggMTctMTggMTh6bTU1LTUzbDE4LTE4IDE4IDE4LTE4IDE4em05MyA0OGwtOC04Yy00LTUtMTEtNS0xNiAwTDEwMyAyMDFjLTQgNC00IDExIDAgMTVsOCA4Yy00LTQtNC0xMSAwLTE1bDEwMS0xMDFjNS00IDEyLTQgMTYgMHoiLz48cGF0aCBmaWxsPSIjOWVlIiBkPSJNMjcgMTMxbDE4LTE4IDE4IDE4LTE4IDE4em01NC01M2wxOC0xOCAxOCAxOC0xOCAxOHoiLz48cGF0aCBmaWxsPSIjMGFhIiBkPSJNMjMwIDExMGwxMyAxM2M0IDQgNCAxMSAwIDE2TDE0MiAyNDBjLTQgNC0xMSA0LTE1IDBsLTEzLTEzYzQgNCAxMSA0IDE1IDBsMTAxLTEwMWM1LTUgNS0xMSAwLTE2eiIvPjxwYXRoIGZpbGw9IiMxYWIiIGQ9Ik0xMzQgMjQ4Yy00IDAtOC0yLTExLTVsLTIzLTIzYTE2IDE2IDAgMDEwLTIzTDIwMSA5NmExNiAxNiAwIDAxMjIgMGwyNCAyNGM2IDYgNiAxNiAwIDIyTDE0NiAyNDNjLTMgMy03IDUtMTIgNXptNzgtMTQ3bC00IDItMTAxIDEwMWE2IDYgMCAwMDAgOWwyMyAyM2E2IDYgMCAwMDkgMGwxMDEtMTAxYTYgNiAwIDAwMC05bC0yNC0yMy00LTJ6Ii8+PC9zdmc+)](https://github.com/renovatebot/renovate) [![GitHub last commit](https://img.shields.io/github/last-commit/truecharts/apps?color=brightgreen&logoColor=white&style=for-the-badge)](https://github.com/truecharts/apps/commits) @@ -72,7 +75,6 @@ _With most parts of our project somewhat cleaned up, we need to work on increasi Our development process is fully distributed and agile, so every chart-maintainer is free to set their own roadmap and development speed and does not have to comply to a centralised roadmap. This ensures freedom and flexibility for everyone involved and makes sure you, the end user, always has the latest and greatest of every App installed. - ### Getting into creating Apps Creating charts takes some getting used to, as it's based on Helm charts. We highly suggest prior know-how on creation/modifying Helm Charts, before taking on the challenge of creating SCALE Apps. @@ -85,10 +87,10 @@ We provide a lot of tools to make it easier to develop charts, templates, automa Those tools do, however, take time to develop and are certainly not bug free. If you find mistakes in our tooling, please feel free to repost issues or submit any fixes you feel appropriate! -
- +
## Contact and Support + [![Discord](https://img.shields.io/badge/discord-chat-7289DA.svg?maxAge=60&style=for-the-badge)](https://discord.gg/tVsPTHWTtr) --- @@ -103,29 +105,30 @@ To contact the TrueCharts project: - Or [join our Discord server](https://truecharts.org/discord) -
+
-
- +
## Featured Projects A lot of our work is based on the great effort of others. We would love to extend special thanks to these projects we owe a lot to: | | | | | -| :---------------: | :---------------: | :---------------: | :---------------: | -| TrueNAS SCALE | K8S-At-Home | Traefik | Authelia | - -
+| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------: | +| TrueNAS SCALE | K8S-At-Home | Traefik | Authelia | +
## Contributors ✨ + [![All Contributors](https://img.shields.io/badge/all_contributors-106-orange.svg?style=for-the-badge)](#contributors) + + Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)): --- @@ -281,19 +284,18 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome! - - ## Licence + [![License](https://img.shields.io/badge/License-BSD%203--Clause-orange.svg?style=for-the-badge)](https://github.com/truecharts/apps/blob/master/docs/LICENSE.BSD3) --- -Truecharts as a whole, is based on a BSD-3-clause license, this ensures almost everyone can use and modify our charts. However: As a lot of Apps are based on upstream Helm Charts, Licences can vary on a per-App basis. This can easily be seen by the presence of a "LICENSE" file in the App root folder. +Truecharts as a whole, is based on a BSD-3-clause license, this ensures almost everyone can use and modify our charts. However: As a lot of Apps are based on upstream Helm Charts, Licences can vary on a per-App basis. This can easily be seen by the presence of a "LICENSE" file in the App root folder. Some Apps may also contain parts in other licenses, such as libraries or templates, these files can be recognised by their individual headers. - `SPDX-License-Identifier: BSD-3-Clause` --- -![built-with-resentment](http://forthebadge.com/images/badges/built-with-resentment.svg) ![contains-technical-debt](http://forthebadge.com/images/badges/contains-technical-debt.svg) + +![built-with-resentment](http://forthebadge.com/images/badges/built-with-resentment.svg) ![contains-technical-debt](http://forthebadge.com/images/badges/contains-technical-debt.svg) diff --git a/.markdownlint.yaml b/.markdownlint.yaml new file mode 100644 index 00000000000..64fbb2a0ee3 --- /dev/null +++ b/.markdownlint.yaml @@ -0,0 +1,13 @@ +# https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md033 +# Do not warn for "Inline HTML" +MD033: false + +# https://github.com/DavidAnson/markdownlint/blob/v0.25.1/doc/Rules.md#md036 +# Do not warn for "Emphasis used instead of a heading" +MD036: false + +# https://github.com/DavidAnson/markdownlint/blob/v0.25.1/doc/Rules.md#md013 +# Do not warn for Line length +MD013: + # We can lower this and wrap lines. Markdown does not care. + line_length: 999 diff --git a/.vscode/extensions.json b/.vscode/extensions.json index e889104925c..d18beb0d978 100644 --- a/.vscode/extensions.json +++ b/.vscode/extensions.json @@ -1,5 +1,7 @@ { "recommendations": [ + "streetsidesoftware.code-spell-checker", + "davidanson.vscode-markdownlint", "editorconfig.editorconfig", "ms-vscode-remote.remote-containers", "rebornix.ruby" diff --git a/charts/dependency/collabora-online/docs/installation_notes.md b/charts/dependency/collabora-online/docs/installation_notes.md index 50d89398cec..028c09fc434 100644 --- a/charts/dependency/collabora-online/docs/installation_notes.md +++ b/charts/dependency/collabora-online/docs/installation_notes.md @@ -1,8 +1,9 @@ # Installation Notes -* If you don't enable `Reverse Proxy` on `Collabora` (It's not recommended as it is unsecure), in order for it to work you have to - * Remove `-o:ssl.termination=true -o:ssl.enable=false` from `Extra Parameters`. - * Set `Server Name` to `hostIP:port` (The port number you set for `NodePort`) - * Set `Service type` to `NodePort` - * Set `Port type` to `HTTPS` - * Disable certificate validation in the app you are going to use it. (eg. Nextcloud have a checkbox under Collabora's URL to disable Cert Validtation) +If you don't enable `Reverse Proxy` on `Collabora` (It's not recommended as it is unsecure), in order for it to work you have to + +* Remove `-o:ssl.termination=true -o:ssl.enable=false` from `Extra Parameters`. +* Set `Server Name` to `hostIP:port` (The port number you set for `NodePort`) +* Set `Service type` to `NodePort` +* Set `Port type` to `HTTPS` +* Disable certificate validation in the app you are going to use it. (eg. Nextcloud have a checkbox under Collabora's URL to disable Cert Validation) diff --git a/charts/dependency/collabora-online/questions.yaml b/charts/dependency/collabora-online/questions.yaml index aced1fbad84..7f07e47018c 100644 --- a/charts/dependency/collabora-online/questions.yaml +++ b/charts/dependency/collabora-online/questions.yaml @@ -124,7 +124,7 @@ questions: default: "de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru" - variable: extra_params label: "Extra Parameters to add" - description: 'e.g. "--o:welcome.enable=false", See more on /etc/loolwsd/loowsd.xml. Separate params with space' + description: 'e.g. "--o:welcome.enable=false", See more on /etc/loolwsd/loolwsd.xml. Separate params with space' schema: type: string default: "--o:welcome.enable=false --o:logging.level=information --o:user_interface.mode=notebookbar --o:ssl.termination=true --o:ssl.enable=false" diff --git a/charts/incubator/avidemux/docs/installation_notes.md b/charts/incubator/avidemux/docs/installation_notes.md index 0afc9505bfe..776edbdc850 100644 --- a/charts/incubator/avidemux/docs/installation_notes.md +++ b/charts/incubator/avidemux/docs/installation_notes.md @@ -1,8 +1,10 @@ # Installation Notes - If you enable `Ingress` for this app, you need to have `SECURE_CONNECTION` set to `false` and `Port Type` set to `HTTP`, otherwise you may run into errors for `Too many redirects`. -- `VNC` can't be `Ingressed`. if you want to use `VNC`, you must set this service to `Simple` instead of `clusterIP`. +- You can't enable `Ingress` for `VNC` If you want to use `VNC`, you must set this service to `Simple` instead - `VNC` with `SECURE_CONNECTION` set `true`, only works with very few clients. One of them is `SSVNC`. - `SECURE_CONNECTION` affects both `WebUI` and `VNC`. +--- + - If you are passing through devices such as `Optical Drives`, you have to Click `Container Security Settings` and set `PUID` to `0`. diff --git a/charts/incubator/dupeguru/docs/installation_notes.md b/charts/incubator/dupeguru/docs/installation_notes.md index 0afc9505bfe..776edbdc850 100644 --- a/charts/incubator/dupeguru/docs/installation_notes.md +++ b/charts/incubator/dupeguru/docs/installation_notes.md @@ -1,8 +1,10 @@ # Installation Notes - If you enable `Ingress` for this app, you need to have `SECURE_CONNECTION` set to `false` and `Port Type` set to `HTTP`, otherwise you may run into errors for `Too many redirects`. -- `VNC` can't be `Ingressed`. if you want to use `VNC`, you must set this service to `Simple` instead of `clusterIP`. +- You can't enable `Ingress` for `VNC` If you want to use `VNC`, you must set this service to `Simple` instead - `VNC` with `SECURE_CONNECTION` set `true`, only works with very few clients. One of them is `SSVNC`. - `SECURE_CONNECTION` affects both `WebUI` and `VNC`. +--- + - If you are passing through devices such as `Optical Drives`, you have to Click `Container Security Settings` and set `PUID` to `0`. diff --git a/charts/incubator/filebot/docs/installation_notes.md b/charts/incubator/filebot/docs/installation_notes.md index 0afc9505bfe..776edbdc850 100644 --- a/charts/incubator/filebot/docs/installation_notes.md +++ b/charts/incubator/filebot/docs/installation_notes.md @@ -1,8 +1,10 @@ # Installation Notes - If you enable `Ingress` for this app, you need to have `SECURE_CONNECTION` set to `false` and `Port Type` set to `HTTP`, otherwise you may run into errors for `Too many redirects`. -- `VNC` can't be `Ingressed`. if you want to use `VNC`, you must set this service to `Simple` instead of `clusterIP`. +- You can't enable `Ingress` for `VNC` If you want to use `VNC`, you must set this service to `Simple` instead - `VNC` with `SECURE_CONNECTION` set `true`, only works with very few clients. One of them is `SSVNC`. - `SECURE_CONNECTION` affects both `WebUI` and `VNC`. +--- + - If you are passing through devices such as `Optical Drives`, you have to Click `Container Security Settings` and set `PUID` to `0`. diff --git a/charts/incubator/mediainfo/docs/installation_notes.md b/charts/incubator/mediainfo/docs/installation_notes.md index 0afc9505bfe..776edbdc850 100644 --- a/charts/incubator/mediainfo/docs/installation_notes.md +++ b/charts/incubator/mediainfo/docs/installation_notes.md @@ -1,8 +1,10 @@ # Installation Notes - If you enable `Ingress` for this app, you need to have `SECURE_CONNECTION` set to `false` and `Port Type` set to `HTTP`, otherwise you may run into errors for `Too many redirects`. -- `VNC` can't be `Ingressed`. if you want to use `VNC`, you must set this service to `Simple` instead of `clusterIP`. +- You can't enable `Ingress` for `VNC` If you want to use `VNC`, you must set this service to `Simple` instead - `VNC` with `SECURE_CONNECTION` set `true`, only works with very few clients. One of them is `SSVNC`. - `SECURE_CONNECTION` affects both `WebUI` and `VNC`. +--- + - If you are passing through devices such as `Optical Drives`, you have to Click `Container Security Settings` and set `PUID` to `0`. diff --git a/charts/incubator/mkvcleaver/docs/installation_notes.md b/charts/incubator/mkvcleaver/docs/installation_notes.md index 0afc9505bfe..776edbdc850 100644 --- a/charts/incubator/mkvcleaver/docs/installation_notes.md +++ b/charts/incubator/mkvcleaver/docs/installation_notes.md @@ -1,8 +1,10 @@ # Installation Notes - If you enable `Ingress` for this app, you need to have `SECURE_CONNECTION` set to `false` and `Port Type` set to `HTTP`, otherwise you may run into errors for `Too many redirects`. -- `VNC` can't be `Ingressed`. if you want to use `VNC`, you must set this service to `Simple` instead of `clusterIP`. +- You can't enable `Ingress` for `VNC` If you want to use `VNC`, you must set this service to `Simple` instead - `VNC` with `SECURE_CONNECTION` set `true`, only works with very few clients. One of them is `SSVNC`. - `SECURE_CONNECTION` affects both `WebUI` and `VNC`. +--- + - If you are passing through devices such as `Optical Drives`, you have to Click `Container Security Settings` and set `PUID` to `0`. diff --git a/charts/incubator/qdirstat/docs/installation_notes.md b/charts/incubator/qdirstat/docs/installation_notes.md index 0afc9505bfe..776edbdc850 100644 --- a/charts/incubator/qdirstat/docs/installation_notes.md +++ b/charts/incubator/qdirstat/docs/installation_notes.md @@ -1,8 +1,10 @@ # Installation Notes - If you enable `Ingress` for this app, you need to have `SECURE_CONNECTION` set to `false` and `Port Type` set to `HTTP`, otherwise you may run into errors for `Too many redirects`. -- `VNC` can't be `Ingressed`. if you want to use `VNC`, you must set this service to `Simple` instead of `clusterIP`. +- You can't enable `Ingress` for `VNC` If you want to use `VNC`, you must set this service to `Simple` instead - `VNC` with `SECURE_CONNECTION` set `true`, only works with very few clients. One of them is `SSVNC`. - `SECURE_CONNECTION` affects both `WebUI` and `VNC`. +--- + - If you are passing through devices such as `Optical Drives`, you have to Click `Container Security Settings` and set `PUID` to `0`. diff --git a/charts/incubator/tsmuxer/docs/installation_notes.md.md b/charts/incubator/tsmuxer/docs/installation_notes.md similarity index 80% rename from charts/incubator/tsmuxer/docs/installation_notes.md.md rename to charts/incubator/tsmuxer/docs/installation_notes.md index 0afc9505bfe..776edbdc850 100644 --- a/charts/incubator/tsmuxer/docs/installation_notes.md.md +++ b/charts/incubator/tsmuxer/docs/installation_notes.md @@ -1,8 +1,10 @@ # Installation Notes - If you enable `Ingress` for this app, you need to have `SECURE_CONNECTION` set to `false` and `Port Type` set to `HTTP`, otherwise you may run into errors for `Too many redirects`. -- `VNC` can't be `Ingressed`. if you want to use `VNC`, you must set this service to `Simple` instead of `clusterIP`. +- You can't enable `Ingress` for `VNC` If you want to use `VNC`, you must set this service to `Simple` instead - `VNC` with `SECURE_CONNECTION` set `true`, only works with very few clients. One of them is `SSVNC`. - `SECURE_CONNECTION` affects both `WebUI` and `VNC`. +--- + - If you are passing through devices such as `Optical Drives`, you have to Click `Container Security Settings` and set `PUID` to `0`. diff --git a/charts/stable/deepstack/docs/installation_notes.md b/charts/stable/deepstack/docs/installation_notes.md index 74c318f63bd..6f3bf9be6ef 100644 --- a/charts/stable/deepstack/docs/installation_notes.md +++ b/charts/stable/deepstack/docs/installation_notes.md @@ -1,5 +1,6 @@ -d# Installation Notes +# Installation Notes ## Custom Models + If you have custom models and you wan to use them, you have to add customStorage to this app. The default path to map is `/modelstore/detection`. In case you like to change it, you also have to change `Custom Models Path` field to the path you mapped as customStorage. diff --git a/charts/stable/duplicati/docs/ingress.md b/charts/stable/duplicati/docs/ingress.md index e6e9e82a385..93fde802a57 100644 --- a/charts/stable/duplicati/docs/ingress.md +++ b/charts/stable/duplicati/docs/ingress.md @@ -1,4 +1,4 @@ -## Ingress +# Ingress This chart requires Ingress to be enabled after initial install due to the configuration of the application upstream (see [Duplicati forum post](https://forum.duplicati.com/t/error-message-in-browser-the-host-header-sent-by-the-client-is-not-allowed/5806)). Please install the application without Ingress, access settings of the application and add your hostname inside the settings of the app. diff --git a/charts/stable/fireflyiii/docs/installation_notes.md b/charts/stable/fireflyiii/docs/installation_notes.md index e88e4d60daa..ef75ce3d383 100644 --- a/charts/stable/fireflyiii/docs/installation_notes.md +++ b/charts/stable/fireflyiii/docs/installation_notes.md @@ -1,4 +1,5 @@ # Important Notes -The FireFlyiii developers have decided to split their program into multiple different add-on containers, implementing these ourselves into the App is EXTREMELY time-consuming. While we would appreciate people with experience building Helm Charts and adding the feature containers, we have decided to flag them "out of scope" for True Charts. + +The Firefly III developers have decided to split their program into multiple different add-on containers, implementing these ourselves into the App is EXTREMELY time-consuming. While we would appreciate people with experience building Helm Charts and adding the feature containers, we have decided to flag them "out of scope" for True Charts. If you really want to use them, you can use custom-app or big-blue-button. However, we do not actively support such a setup. diff --git a/charts/stable/handbrake/docs/installation_notes.md b/charts/stable/handbrake/docs/installation_notes.md index 0afc9505bfe..776edbdc850 100644 --- a/charts/stable/handbrake/docs/installation_notes.md +++ b/charts/stable/handbrake/docs/installation_notes.md @@ -1,8 +1,10 @@ # Installation Notes - If you enable `Ingress` for this app, you need to have `SECURE_CONNECTION` set to `false` and `Port Type` set to `HTTP`, otherwise you may run into errors for `Too many redirects`. -- `VNC` can't be `Ingressed`. if you want to use `VNC`, you must set this service to `Simple` instead of `clusterIP`. +- You can't enable `Ingress` for `VNC` If you want to use `VNC`, you must set this service to `Simple` instead - `VNC` with `SECURE_CONNECTION` set `true`, only works with very few clients. One of them is `SSVNC`. - `SECURE_CONNECTION` affects both `WebUI` and `VNC`. +--- + - If you are passing through devices such as `Optical Drives`, you have to Click `Container Security Settings` and set `PUID` to `0`. diff --git a/charts/stable/jdownloader2/docs/installation_notes.md b/charts/stable/jdownloader2/docs/installation_notes.md index 0afc9505bfe..776edbdc850 100644 --- a/charts/stable/jdownloader2/docs/installation_notes.md +++ b/charts/stable/jdownloader2/docs/installation_notes.md @@ -1,8 +1,10 @@ # Installation Notes - If you enable `Ingress` for this app, you need to have `SECURE_CONNECTION` set to `false` and `Port Type` set to `HTTP`, otherwise you may run into errors for `Too many redirects`. -- `VNC` can't be `Ingressed`. if you want to use `VNC`, you must set this service to `Simple` instead of `clusterIP`. +- You can't enable `Ingress` for `VNC` If you want to use `VNC`, you must set this service to `Simple` instead - `VNC` with `SECURE_CONNECTION` set `true`, only works with very few clients. One of them is `SSVNC`. - `SECURE_CONNECTION` affects both `WebUI` and `VNC`. +--- + - If you are passing through devices such as `Optical Drives`, you have to Click `Container Security Settings` and set `PUID` to `0`. diff --git a/charts/stable/makemkv/docs/installation_notes.md b/charts/stable/makemkv/docs/installation_notes.md index 0afc9505bfe..776edbdc850 100644 --- a/charts/stable/makemkv/docs/installation_notes.md +++ b/charts/stable/makemkv/docs/installation_notes.md @@ -1,8 +1,10 @@ # Installation Notes - If you enable `Ingress` for this app, you need to have `SECURE_CONNECTION` set to `false` and `Port Type` set to `HTTP`, otherwise you may run into errors for `Too many redirects`. -- `VNC` can't be `Ingressed`. if you want to use `VNC`, you must set this service to `Simple` instead of `clusterIP`. +- You can't enable `Ingress` for `VNC` If you want to use `VNC`, you must set this service to `Simple` instead - `VNC` with `SECURE_CONNECTION` set `true`, only works with very few clients. One of them is `SSVNC`. - `SECURE_CONNECTION` affects both `WebUI` and `VNC`. +--- + - If you are passing through devices such as `Optical Drives`, you have to Click `Container Security Settings` and set `PUID` to `0`. diff --git a/charts/stable/meshroom/docs/installation_notes.md b/charts/stable/meshroom/docs/installation_notes.md index aa2ae16a2c8..5e32d9eea0b 100644 --- a/charts/stable/meshroom/docs/installation_notes.md +++ b/charts/stable/meshroom/docs/installation_notes.md @@ -1,9 +1,6 @@ # Notes -Meshroom in docker does not have weUIUI. - +Meshroom in docker does not have a webUI. You need an ssh client capable of X forwarding. - -You SSH into the app, with `ssh -p 10243 -X root@ /opt/Meshroom_bundle/Meshroom` - +You SSH into the app, with `ssh -p 10243 -X root@ /opt/Meshroom_bundle/Meshroom` Default password is `meshroom` diff --git a/charts/stable/minecraft-java/docs/community-guide.md b/charts/stable/minecraft-java/docs/community-guide.md index 7eb01f1ebd9..8b864db8c90 100644 --- a/charts/stable/minecraft-java/docs/community-guide.md +++ b/charts/stable/minecraft-java/docs/community-guide.md @@ -2,50 +2,40 @@ ⚠️ **Warning This guide contains information that uses Advanced/Expert settings. As a result this will be outside the scope of support!** ⚠️ -# Running Multiple MC-Java Servers +--- + +## Running Multiple MC-Java Servers You can easily run Multiple MC Servers. You simply need to change the external ports, Be sure to use an unused port. There is no need to change the Minecraft port or RCON port in the server.properties MC Server 1 -
- -
+![mc-server1](https://truecharts.org/img/communityguide/apps/games/minecraft-java/mc-server1.png) MC Server 2 -
- -
+![mc-server2](https://truecharts.org/img/communityguide/apps/games/minecraft-java/mc-server2.png) -# Plugins DIR +## Plugins DIR To easily get Plugins in to your MC server since PVC's are in use for the config storage you can add a host path storage for either /mods or /plugins depending on what your server needs like so -
- -
+![mc-plugins](https://truecharts.org/img/communityguide/apps/games/minecraft-java/mc-plugins.png) This will give you an easy folder to drop the plugins in and they will then sync to /data/plugins or /data/mods , you will/may need to shell in to the app to periodically clean up old versions -# Plugins/mods that need additional ports +## Plugins/mods that need additional ports Using Dynmap as an example Under network and Services Check Show Expert config (remember the warning at the top?) Click Configure add Manual Custom Services and fill out like so also adding Configure additional service ports -
- -
+![mc-modports1](https://truecharts.org/img/communityguide/apps/games/minecraft-java/mc-modports1.png) For the second server instance the setup is about the same one minor difference is the need to change the port for dynmap in the container to a new port and configure like so (note this could of just been my system being silly due to my tests and not rebooting) -
- -
+![mc-modports2](https://truecharts.org/img/communityguide/apps/games/minecraft-java/mc-modports2.png) Dynmap Web working -
- -
+![dynmap](https://truecharts.org/img/communityguide/apps/games/minecraft-java/dynmap.png) diff --git a/charts/stable/nextcloud/docs/installation_notes.md b/charts/stable/nextcloud/docs/installation_notes.md index 38c3d175214..1ad3f12918f 100644 --- a/charts/stable/nextcloud/docs/installation_notes.md +++ b/charts/stable/nextcloud/docs/installation_notes.md @@ -5,20 +5,20 @@ For this reason we ask you not to file support requests on our Discord or Github While we consider the App layer "Stable", we simply cannot guarantee stability due to the nature of the Nextcloud Application inside the App. - -# Installation Notes +## Installation Notes Nextcloud generates it's `config.php` file on the first startup/installation. Therefore you have to set some values correctly on the first try. Otherwise you will have to either re-install the App or edit the `config.php` manually, with the latter being out of our support scope. The mentioned values are: - - TRUSTED_PROXIES - - NODE_IP - - Ingress, if you plan to use it. - - Data storage location, type (eg. PVC, hostPath). +- TRUSTED_PROXIES +- NODE_IP +- Ingress, if you plan to use it. +- Data storage location, type (eg. PVC, hostPath). Also Nextcloud creates an Admin user on the first startup/installation, which you can only define it's username and password on the first install. Changing them later, will have no effect. The mentioned values are: - - NEXTCLOUD_ADMIN_USER - - NEXTCLOUD_ADMIN_PASSWORD + +- NEXTCLOUD_ADMIN_USER +- NEXTCLOUD_ADMIN_PASSWORD diff --git a/cspell.config.yaml b/cspell.config.yaml new file mode 100644 index 00000000000..4d25a6fd858 --- /dev/null +++ b/cspell.config.yaml @@ -0,0 +1,27 @@ +version: "0.2" +# ignorePaths: [] +# dictionaryDefinitions: [] +# dictionaries: [] +# ignoreWords: [] +# import: [] +words: + - aliasgroup + - collabora + - configmap + - daemonset + - duplicati + - healthcheck + - kubernetes + - loolwsd + - meshroom + - modelstore + - nextcloud + - notebookbar + - puid + - serviceexpert + - ssvnc + - statefulset + - subquestions + - tccr + - traefik + - truecharts diff --git a/mkdocs.yml b/mkdocs.yml index 3a70e44a4a5..1729eea3007 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -22,7 +22,6 @@ theme: favicon: _static/img/favicon.png icon: repo: fontawesome/brands/github-alt - language: en features: - navigation.tabs - navigation.tracking