From 8d483c5443ea0c310f205ce72477b4b4e1e508ee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Juan=20Ruiti=C3=B1a?= Date: Tue, 1 Jul 2025 10:38:04 +0200 Subject: [PATCH 1/4] Provide command for Linux Small format change for first numbered list --- content/en/linux.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/content/en/linux.md b/content/en/linux.md index 3030af1..6117958 100644 --- a/content/en/linux.md +++ b/content/en/linux.md @@ -4,9 +4,9 @@ title: "Using RHVoice on Linux" There are three possible options of installing RHVoice on Linux: -* 1. An up-to-date package distributed through the Snap Store. Below we describe how to install it. -* 2. One of the packages built for specific Linux distributions. Not all of them will be up-to-date and provide all the voices. See [this page](https://github.com/RHVoice/RHVoice/blob/master/doc/en/Packaging-status.md) for more information. -* 3. Compiling from source: visit [RHVoice source repository](https://github.com/RHVoice/RHVoice) to learn more. +1. An up-to-date package distributed through the Snap Store. Below we describe how to install it. +2. One of the packages built for specific Linux distributions. Not all of them will be up-to-date and provide all the voices. See [this page](https://github.com/RHVoice/RHVoice/blob/master/doc/en/Packaging-status.md) for more information. +3. Compiling from source: visit [RHVoice source repository](https://github.com/RHVoice/RHVoice) to learn more. Distribution through the Snap packaging system is preferred by the developers of the core RHVoice engine, as it allows us to easily publish a single up-to-date binary. If you are not familiar with snaps, please visit [this website](https://snapcraft.io/) to learn about them. Your preferred Linux distribution may already have this system preinstalled, or it may be available as a package in its repository. @@ -45,8 +45,11 @@ If you use the Orca screen reader, you will need to manually connect RHVoice to The method described below has been tested on Ubuntu. If it doesn't work on your Linux distribution, please let us know. -1. Open the terminal and change directory to `/usr/lib/speech-dispatcher-modules`. -2. Create a symbolic link to RHVoice's module for Speech Dispatcher: +1. Open the terminal and change to the directory that contains Speech Dispatcher modules +``` +cd /usr/lib/speech-dispatcher-modules +``` +3. Create a symbolic link to RHVoice's module for Speech Dispatcher: ``` sudo ln -s /snap/rhvoice/current/bin/sd_rhvoice ``` From 81ffbc17030425feb5cf0b040ae6534e0048c160 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Juan=20Ruiti=C3=B1a?= Date: Tue, 1 Jul 2025 10:41:11 +0200 Subject: [PATCH 2/4] Update linux.md --- content/en/linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/linux.md b/content/en/linux.md index 6117958..f0dcd7e 100644 --- a/content/en/linux.md +++ b/content/en/linux.md @@ -45,7 +45,7 @@ If you use the Orca screen reader, you will need to manually connect RHVoice to The method described below has been tested on Ubuntu. If it doesn't work on your Linux distribution, please let us know. -1. Open the terminal and change to the directory that contains Speech Dispatcher modules +1. Open the terminal and change to the directory that contains Speech Dispatcher modules: ``` cd /usr/lib/speech-dispatcher-modules ``` From 042ae829d16402f54f8057d9895a2bd8e2ac0bd3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Juan=20Ruiti=C3=B1a?= Date: Tue, 1 Jul 2025 10:46:07 +0200 Subject: [PATCH 3/4] Add headings to linux.md --- content/en/linux.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/content/en/linux.md b/content/en/linux.md index f0dcd7e..248d270 100644 --- a/content/en/linux.md +++ b/content/en/linux.md @@ -10,6 +10,8 @@ There are three possible options of installing RHVoice on Linux: Distribution through the Snap packaging system is preferred by the developers of the core RHVoice engine, as it allows us to easily publish a single up-to-date binary. If you are not familiar with snaps, please visit [this website](https://snapcraft.io/) to learn about them. Your preferred Linux distribution may already have this system preinstalled, or it may be available as a package in its repository. +## Install RHVoice snap + The snap only installs the RHVoice TTS engine itself, including the module connecting RHVoice to Speech Dispatcher. Voices need to be installed via the newly implemented built-in command-line voice manager. Most of the commands described below need to be run as root. We will assume you use the sudo command. @@ -41,6 +43,8 @@ Now let's test if it speaks: echo hello|rhvoice.test ``` +### Use RHVoice with Orca + If you use the Orca screen reader, you will need to manually connect RHVoice to Speech Dispatcher, which is the software Orca relies on to work with TTS engines. Unfortunately, we are not aware of any way we could register RHVoice with Speech Dispatcher automatically. The method described below has been tested on Ubuntu. If it doesn't work on your Linux distribution, please let us know. From 32733d359179eb16fb7d1fc4273ef36aab3cd91d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Juan=20Ruiti=C3=B1a?= Date: Tue, 1 Jul 2025 10:56:02 +0200 Subject: [PATCH 4/4] Update linux.md Add mention to distros --- content/en/linux.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/content/en/linux.md b/content/en/linux.md index 248d270..08505c7 100644 --- a/content/en/linux.md +++ b/content/en/linux.md @@ -43,13 +43,14 @@ Now let's test if it speaks: echo hello|rhvoice.test ``` -### Use RHVoice with Orca +## Use RHVoice with Orca If you use the Orca screen reader, you will need to manually connect RHVoice to Speech Dispatcher, which is the software Orca relies on to work with TTS engines. Unfortunately, we are not aware of any way we could register RHVoice with Speech Dispatcher automatically. -The method described below has been tested on Ubuntu. If it doesn't work on your Linux distribution, please let us know. +Orca is the default screen reader in Linux distributions such as Ubuntu, Fedora and Debian. The method described below has been tested on Ubuntu. If it doesn't work on your Linux distribution, please let us know. -1. Open the terminal and change to the directory that contains Speech Dispatcher modules: +1. Install the RHVoice snap and at least one voice as explained in the previous section. +2. Open the terminal and change to the directory that contains the Speech Dispatcher modules: ``` cd /usr/lib/speech-dispatcher-modules ```