Re: Feedback on Linux Manual Website - Translation Feature Compatibility

Re: Feedback on Linux Manual Website - Translation Feature Compatibility

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 2022 bytes --]

Hi zmy,

On Wed, May 01, 2024 at 12:18:35PM +0800, 凄临雨 wrote:
> Feedback on Linux Manual Website - Translation Feature Compatibility
> 
> Dear Linux Manual Web Team,
> 
> I hope you are doing well.  I am reaching out to provide some feedback
> regarding the Linux Manual website that I believe could help improve
> its usability for a wider audience.

Can you please provide a link to the website you're referring to?

> I have noticed that the <pre&gt; tags used on the website to display
> code and command examples are not compatible with the translation
> features embedded in web browsers.

The current website is <https://www.kernel.org/doc/man-pages/>, but that
is minimal and doesn't have any <pre> tags.

Or maybe you're referring to
<https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/README>
?

That's not the website, but rather a web view of the source code of the
repository.  It does use <pre> for everything, but because it's
formatting an entire file in the source repository.

Have a lovely day!
Alex

> This has created a barrier for
> non-native English speakers who rely on these translation tools to
> better understand the technical content presented.
> 
> The use of <pre&gt; tags to preserve the formatting of code blocks
> unfortunately prevents these users from being able to translate the
> text easily.  While the intention to maintain the original formatting
> is appreciated, it would be beneficial to explore alternatives that
> allow the translation functionality to work alongside the display of
> code.
> 
> I wanted to bring this to your attention as it impacts the
> accessibility of the content for international users.  I believe
> addressing this could significantly enhance the user experience for a
> diverse audience.
> 
> Thank you for the excellent resources you provide to the Linux
> community, and for considering this feedback.
> 
> Warm regards,
> 
> zmy

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

=?gb18030?B?u9i4tKO6IEZlZWRiYWNrIG9uIExpbnV4IE1hbnVhbCBXZWJzaXRlIC0gVHJhbnNsYXRpb24gRmVhdHVyZSBDb21wYXRpYmlsaXR5?=

[=?gb18030?B?xuDB2dPq?=]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain; charset="gb18030", Size: 492 bytes --]

The web page I am referring to is located at: https://www.man7.org/linux/man-pages/man1/man.1.html, but perhaps this site is not maintained by you? I am not sure whom to address my comments to.
> Can you please provide a link to the website you're referring to?

&gt; &gt; I have noticed that the <pre&gt; tags="" used="" on="" the="" website="" to="" display=""> &gt; code and command examples are not compatible with the translation
&gt; &gt; features embedded in web browsers.</pre&gt;>

Re: 回复： Feedback on Linux Manual Website - Translation Feature Compatibility

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 677 bytes --]

Hi,

On Thu, May 02, 2024 at 07:58:17PM +0800, 凄临雨 wrote:
> The web page I am referring to is located at:
> <https://www.man7.org/linux/man-pages/man1/man.1.html>, but perhaps
> this site is not maintained by you? I am not sure whom to address my
> comments to.

That website is maintained by Michael Kerrisk, the previous maintainer
of the project.  It is not part of the Linux man-pages project.

If you want to read translated manual pages, I suggest you look at
Debian's manpages:

<https://manpages.debian.org/bookworm/man-db/man.1.en.html>

It has links to many translations.

Have a lovely day!
Alex

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]