Re: docs: Convert the Speakup guide to rst

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hello,

On 01/06/2021 00:07, Samuel Thibault wrote:
Mmm, I'm unsure how the result is readable with the speakup screen
reader itself. I have attached the result, could people on the speakup
mailing list check how well it goes? If it significantly degrades
readability, we'll have to reject the move to rst formatting, since in
the end it's people who use the speakup screen reader who need to be
able to read this document.

Samuel

Can we not have two versions? I don't have Sphinx installed (used to format
https://www.kernel.org/doc/html/latest/index.html) but converted speakup.rst to html5 using rst2html5.py and indeed the output is way better looking and easier
to navigate than the txt version.

And anyway can we just provide a link to the web page that will be built
from the rst file? I think it should be accessible in graphical web browsers as
in console ones (I tried using links, lynx and w3m).

As an aside the document still states:
Speakup does NOT support usb connections!

Is it still true? PS I widely prefer the asciidoc/asciidoctor format than rst,
but the choice has been done for the Linux Kernel documentation, I know...

Didier




[Index of Archives]     [Linux for the Blind]     [Fedora Discussioin]     [Linux Kernel]     [Yosemite News]     [Big List of Linux Books]

  Powered by Linux