From 060cd1db0ffe0161521dd09612bac578041275bd Mon Sep 17 00:00:00 2001 From: alfrix Date: Mon, 8 Jan 2024 09:59:43 -0300 Subject: [PATCH] docs: minor fixups --- docs/Android.md | 6 +++--- docs/Changelog.md | 2 +- docs/Configuration.md | 2 +- docs/Contact.md | 2 +- docs/Installation.md | 11 +++++----- docs/Panels/Job_status.md | 2 +- docs/Panels/Zcalibrate.md | 2 +- docs/Theming.md | 3 ++- docs/Troubleshooting.md | 10 ++++----- docs/Troubleshooting/Physical_Install.md | 2 +- docs/VNC.md | 27 ++++++++++++------------ docs/index.md | 14 ++++++------ docs/macros.md | 4 ++-- 13 files changed, 43 insertions(+), 44 deletions(-) diff --git a/docs/Android.md b/docs/Android.md index 2fd6ce83..14d28799 100644 --- a/docs/Android.md +++ b/docs/Android.md @@ -11,7 +11,7 @@ This article describes how to use KlipperScreen from an android device 1. [First installl KlipperScreen on the Pi](Installation.md) 2. Install [XServer-XSDL](https://play.google.com/store/apps/details?id=x.org.server) on the android device -3. Choose [USB(ADB)](#adb) or [WIFI](#wifi) +3. Choose [USB(ADB)](#adb) or [WI-FI](#wifi) ### ADB @@ -104,11 +104,11 @@ sudo service KlippyScreenAndroid stop sudo rm /etc/systemd/system/KlippyScreenAndroid.service ``` -Follow this guide on how to setup the new launcher script with [USB(ADB)](#adb) or [WIFI](#wifi) and restart KS. +Follow this guide on how to set up the new launcher script with [USB(ADB)](#adb) or [WI-FI](#wifi) and restart KS. ## Help -[The Discourse thread has old instructions but you may get some help if needed](https://klipper.discourse.group/t/how-to-klipperscreen-on-android-smart-phones/1196) +[The Discourse thread has old instructions, but you may get some help if needed](https://klipper.discourse.group/t/how-to-klipperscreen-on-android-smart-phones/1196) [#klipper-screen channel on Discord](https://discord.klipper3d.org/) diff --git a/docs/Changelog.md b/docs/Changelog.md index dc36928c..fb51d859 100644 --- a/docs/Changelog.md +++ b/docs/Changelog.md @@ -23,7 +23,7 @@ and the power device in moonraker.conf to have the same name. The "Power" panel will be in the Menu if there are power devices found #### [2022 01 11](https://github.com/KlipperScreen/KlipperScreen/commit/8a8c6c064cc6d097b1b34a5c42b4001367e545a6) -* The Preheat panel has been deprecated in favor of an all in one Temperature panel +* The Preheat panel has been deprecated in favor of an all-in-one Temperature panel Remove preheat panel from your Klipperscreen.conf or replace the occurrences of preheat with temperature diff --git a/docs/Configuration.md b/docs/Configuration.md index 8a6d23b7..4f0a173b 100644 --- a/docs/Configuration.md +++ b/docs/Configuration.md @@ -151,7 +151,7 @@ button press. There are two menus available in KlipperScreen, __main and __print printer is idle. The __print menu is accessible from the printing status page. !!! info - A predefined set of menus is already provided and it's recommended to be used + A predefined set of menus is already provided A menu item is configured as follows: ```{ .ini .no-copy } diff --git a/docs/Contact.md b/docs/Contact.md index d994b5b2..9173fbcc 100644 --- a/docs/Contact.md +++ b/docs/Contact.md @@ -20,4 +20,4 @@ or open an issue describing the changes. or even provide ideas for a feature. -[Github repository](https://github.com/KlipperScreen/KlipperScreen/) +[GitHub repository](https://github.com/KlipperScreen/KlipperScreen/) diff --git a/docs/Installation.md b/docs/Installation.md index d2239739..b1a35ee9 100644 --- a/docs/Installation.md +++ b/docs/Installation.md @@ -7,20 +7,19 @@ It's strongly recommended to test it and ensure your hardware is working with Ra Once you have established that the screen is working, then proceed installing KlipperScreen. ## Setup -This install process is meant for a non-desktop version of the OS for example RaspberryOS Lite, but it should work on other debian derivatives. +The installation process is meant for a non-desktop version of the OS for example RaspberryOS Lite, but it should work on other debian derivatives. + +[Click to learn how to check if you installed a desktop version](../../FAQ/#how-to-check-if-you-have-a-desktop-environment) If you installed a desktop (GUI version) of the OS and want to run KlipperScreen exclusively then do: ```sh title="Boot to console / KlipperScreen" -sudo systemctl set-default multi-user.target -sudo reboot +sudo systemctl set-default multi-user.target && sudo reboot ``` to undo and go back to the desktop environment: ```sh title="Boot to the desktop" -sudo systemctl set-default graphical.target -sudo reboot +sudo systemctl set-default graphical.target && sudo reboot ``` - ## Auto install [KIAUH](https://github.com/th33xitus/kiauh) is a tool that helps you install or upgrade Klipper, Moonraker, Mainsail, and other extensions. diff --git a/docs/Panels/Job_status.md b/docs/Panels/Job_status.md index e91e9f88..d544504c 100644 --- a/docs/Panels/Job_status.md +++ b/docs/Panels/Job_status.md @@ -24,5 +24,5 @@ This panel has more information than it shows by default, just click/tap the cor ## Extra temperature items -By default only extruder and bed temperatures will be available but additional items can be defined +By default, only extruder and bed temperatures will be available but additional items can be defined using ["titlebar_items" in the config](../Configuration.md#printer-options) diff --git a/docs/Panels/Zcalibrate.md b/docs/Panels/Zcalibrate.md index e034d181..903acf3e 100644 --- a/docs/Panels/Zcalibrate.md +++ b/docs/Panels/Zcalibrate.md @@ -16,7 +16,7 @@ It's strongly suggested to read Klipper documentation about [Bed level](https:// ## Calibration methods ### Endstop (`Z_ENDSTOP_CALIBRATE`) -Available when an physical endstop is defined for `[stepper_z]` +Available when a physical endstop is defined for `[stepper_z]` See Klipper documentation: [Calibrating a Z endstop](https://www.klipper3d.org/Manual_Level.html#calibrating-a-z-endstop) diff --git a/docs/Theming.md b/docs/Theming.md index 9e1d96ac..c50a671b 100644 --- a/docs/Theming.md +++ b/docs/Theming.md @@ -2,7 +2,8 @@ To create a custom theme, create a folder in: _${KlipperScreen_Directory}/styles/_ -The folder name will be the theme name, in that folder create another folder named `images` this is where the icons should be placed. The icons must be SVG files and they need to have specific names that are defined in the code, use the default theme as a reference for the names or check the code. +The folder name will be the theme name, in that folder create another folder named `images` this is where the icons should be placed. +The icons must be SVG files with specific names that are defined in the code, use the default theme as a reference for the names or check the code. To edit colors and styles, create a css file named `style.css` you can use the contents of another theme as a reference. diff --git a/docs/Troubleshooting.md b/docs/Troubleshooting.md index dfacdece..39e3f85b 100644 --- a/docs/Troubleshooting.md +++ b/docs/Troubleshooting.md @@ -12,9 +12,9 @@ The first step to troubleshooting any problem is getting the cause of the error. Depending on your setup the file could be accessible from the web interface alongside other logs -Mainsail | Fluidd -:-:|:-: -![mainsail_logs](img/troubleshooting/logs_mainsail.png) | ![fluidd_logs](img/troubleshooting/logs_fluidd.png) +| Mainsail | Fluidd | +|:-------------------------------------------------------:|:---------------------------------------------------:| +| ![mainsail_logs](img/troubleshooting/logs_mainsail.png) | ![fluidd_logs](img/troubleshooting/logs_fluidd.png) | if you can't find it in the web interface, use sftp to grab the log (for example Filezilla, WinSCP) Located at `~/printer_data/logs`or in `/tmp/` if the former doesn't exist. @@ -74,7 +74,7 @@ cat /var/log/Xorg.0.log ```sh modprobe: FATAL: Module g2d_23 not found in directory /lib/modules/6.1.21-v8+ ``` - This error is common on RaspberryOS when using FBturbo and it's not a related issue. + This error is common on RaspberryOS when using FBturbo, it's not a related issue. !!! abstract "If you see this line in the [system logs](#system-logs):" ```sh @@ -119,7 +119,7 @@ In KliperScreen settings find 'Screen DPMS' and turn it off. Your screen doesn't seem to support turning off via software. KlipperScreen will enable an internal screensaver to make it all black, and hopefully avoid burn-in. -If you find a way of turning it off and you want to share it: [Contact](Contact.md) +If you find a way of turning it off, please share it: [Contact](Contact.md) ## Touch issues diff --git a/docs/Troubleshooting/Physical_Install.md b/docs/Troubleshooting/Physical_Install.md index 129aa7a2..7845e63b 100644 --- a/docs/Troubleshooting/Physical_Install.md +++ b/docs/Troubleshooting/Physical_Install.md @@ -1,4 +1,4 @@ -# Physical install issues +# Physical installation issues If the screen never shows the console even during startup, Then it's typically an improperly installed screen, diff --git a/docs/VNC.md b/docs/VNC.md index 28d62a72..58555911 100644 --- a/docs/VNC.md +++ b/docs/VNC.md @@ -11,23 +11,22 @@ This article describes how to use KlipperScreen through a remote connection. 1. [First installl KlipperScreen](Installation.md) 2. Install a vnc server package, for example: -```bash -sudo apt install tigervnc-standalone-server -``` + ```bash + sudo apt install tigervnc-standalone-server + ``` 3. Create `launch_KlipperScreen.sh`: -```bash -#!/usr/bin/env bash - -# Use display 10 to avoid clashing with local X server, if anyy -Xtigervnc -rfbport 5900 -noreset -AlwaysShared -SecurityTypes none :10& -DISPLAY=:10 $KS_XCLIENT& -wait -``` + ```bash + #!/usr/bin/env bash + # Use display 10 to avoid clashing with local X server, if anyy + Xtigervnc -rfbport 5900 -noreset -AlwaysShared -SecurityTypes none :10& + DISPLAY=:10 $KS_XCLIENT& + wait + ``` 4. Restart KlipperScreen or reboot the system: -```bash -sudo systemctl service KlipperScreen restart -``` + ```bash + sudo systemctl service KlipperScreen restart + ``` 5. On KlipperScreen set the following configuration: DPMS: off diff --git a/docs/index.md b/docs/index.md index 860a1d43..7458ec97 100644 --- a/docs/index.md +++ b/docs/index.md @@ -28,16 +28,16 @@ will natively work with [Klipper](https://github.com/klipper3d/klipper) and [Moo KlipperScreen has been created and maintained by Jordan Ruthe from 2020 to 2021 -|Donate to Jordan| -|-| -|[Patreon](https://www.patreon.com/klipperscreen)| -|[Ko-fi](https://ko-fi.com/klipperscreen)| +| Donate to Jordan | +|--------------------------------------------------| +| [Patreon](https://www.patreon.com/klipperscreen) | +| [Ko-fi](https://ko-fi.com/klipperscreen) | The current maintainer is Alfredo Monclus (alfrix) from 2021 onwards -|Dontate to Alfrix| -|-| -|[Ko-fi](https://ko-fi.com/alfrix)| +| Dontate to Alfrix | +|-----------------------------------| +| [Ko-fi](https://ko-fi.com/alfrix) | thanks to all the people who helped along the way. diff --git a/docs/macros.md b/docs/macros.md index ae444367..6928a32b 100644 --- a/docs/macros.md +++ b/docs/macros.md @@ -3,7 +3,7 @@ ## Recommended !!! note - If you have already installed other UIs then you may have this macros already, and it's usually asked by KIAUH + If you have already installed other UIs then you may have these macros already, and it's usually asked by KIAUH None of the following macros are strictly required for KlipperScreen, but they provide the toolhead parking at pause and cancel. @@ -109,7 +109,7 @@ gcode: ### LOAD_FILAMENT / UNLOAD_FILAMENT -This macros are used in the Extrude panel `Load` and `Unload` buttons. and they will be hidden from the macros panel. +These macros are used in the Extrude panel `Load` and `Unload` buttons. and they will be hidden from the macros panel. The selected speed in the panel is transferred as a parameter.