[PATCH] doc: Ask user to install extra packages to display non-English alphabets.

[PATCH] doc: Ask user to install extra packages to display non-English alphabets.

[Alex Vong]

From f2eac896933814a3d5a85c4c20c1407b692be1ca Mon Sep 17 00:00:00 2001
From: Alex Vong <alexvong1995@gmail.com>
Date: Mon, 16 Nov 2015 23:57:35 +0800
Subject: [PATCH] doc: Ask user to install extra packages to display
 non-English alphabets.

* doc/guix.texi (X11 Fonts): Add instruction and example.
---
 doc/guix.texi | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 3b6955c..dab8ab7 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -1000,6 +1000,11 @@ to display fonts, you will have to install fonts with Guix as well.
 Essential font packages include @code{gs-fonts}, @code{font-dejavu}, and
 @code{font-gnu-freefont-ttf}.
 
+In addition, if your graphical applications display non-english alphabets,
+you may need to install extra font packages.
+For instance, as of 2015, to correctly display CJK fonts in @code{icecat}
+browser package, you should install @code{font-wqy-zenhei} font package.
+
 @c TODO What else?
 
 @c *********************************************************************
-- 
2.6.3

Re: [PATCH] doc: Ask user to install extra packages to display non-English alphabets.

[Alex Kost]

Alex Vong (2015-11-16 19:11 +0300) wrote:

> From f2eac896933814a3d5a85c4c20c1407b692be1ca Mon Sep 17 00:00:00 2001
> From: Alex Vong <alexvong1995@gmail.com>
> Date: Mon, 16 Nov 2015 23:57:35 +0800
> Subject: [PATCH] doc: Ask user to install extra packages to display
>  non-English alphabets.
>
> * doc/guix.texi (X11 Fonts): Add instruction and example.
> ---
>  doc/guix.texi | 5 +++++
>  1 file changed, 5 insertions(+)
>
>
> diff --git a/doc/guix.texi b/doc/guix.texi
> index 3b6955c..dab8ab7 100644
> --- a/doc/guix.texi
> +++ b/doc/guix.texi
> @@ -1000,6 +1000,11 @@ to display fonts, you will have to install fonts with Guix as well.
>  Essential font packages include @code{gs-fonts}, @code{font-dejavu}, and
>  @code{font-gnu-freefont-ttf}.
>  
> +In addition, if your graphical applications display non-english alphabets,
> +you may need to install extra font packages.
> +For instance, as of 2015, to correctly display CJK fonts in @code{icecat}
> +browser package, you should install @code{font-wqy-zenhei} font package.

I didn't try 'font-wqy-zenhei', but there is also
'font-adobe-source-han-sans' package (thanks to 宋文武) that "solves"
Chinese, Japanese and Korean symbols I've met so far.

-- 
Alex

Re: [PATCH] doc: Ask user to install extra packages to display non-English alphabets.

[Paul van der Walt]

Hi Alex,

Here are some minor grammatical fixes; i cannot comment on the rest of
the patch.

On 2015-11-16 at 17:11, quoth Alex Vong:
> +In addition, if your graphical applications display non-english alphabets,

* non-English

> +you may need to install extra font packages.
> +For instance, as of 2015, to correctly display CJK fonts in @code{icecat}
> +browser package,

What about "in the Icecat browser"?

> you should install @code{font-wqy-zenhei} font package.

* install the @code{....

Regards,
p.

Re: [PATCH] doc: Ask user to install extra packages to display non-English alphabets.

[Ludovic Courtès]

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

Alex Vong <alexvong1995@gmail.com> skribis:

> +In addition, if your graphical applications display non-english alphabets,
> +you may need to install extra font packages.
> +For instance, as of 2015, to correctly display CJK fonts in @code{icecat}
> +browser package, you should install @code{font-wqy-zenhei} font package.

Alex Kost <alezost@gmail.com> skribis:

> I didn't try 'font-wqy-zenhei', but there is also
> 'font-adobe-source-han-sans' package (thanks to 宋文武) that "solves"
> Chinese, Japanese and Korean symbols I've met so far.

What about this:


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: Type: text/x-patch, Size: 837 bytes --]

diff --git a/doc/guix.texi b/doc/guix.texi
index 3b6955c..61e3445 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -1000,6 +1000,17 @@ to display fonts, you will have to install fonts with Guix as well.
 Essential font packages include @code{gs-fonts}, @code{font-dejavu}, and
 @code{font-gnu-freefont-ttf}.
 
+To display text written in Chinese languages, Japanese, or Korean in
+graphical applications, consider installing
+@code{font-adobe-source-han-sans} or @code{font-wqy-zenhei}.  The former
+has multiple outputs, one per language family (@pxref{Packages with
+Multiple Outputs}).  For instance, the following command installs fonts
+for Chinese languages:
+
+@example
+guix package -i font-adobe-source-han-sans:cn
+@ene example
+
 @c TODO What else?
 
 @c *********************************************************************

[-- Attachment #3: Type: text/plain, Size: 21 bytes --]


Thanks,
Ludo’.

Re: [PATCH] doc: Ask user to install extra packages to display non-English alphabets.

[Alex Kost]

Ludovic Courtès (2015-11-17 19:10 +0300) wrote:

> Alex Vong <alexvong1995@gmail.com> skribis:
>
>> +In addition, if your graphical applications display non-english alphabets,
>> +you may need to install extra font packages.
>> +For instance, as of 2015, to correctly display CJK fonts in @code{icecat}
>> +browser package, you should install @code{font-wqy-zenhei} font package.
>
> Alex Kost <alezost@gmail.com> skribis:
>
>> I didn't try 'font-wqy-zenhei', but there is also
>> 'font-adobe-source-han-sans' package (thanks to 宋文武) that "solves"
>> Chinese, Japanese and Korean symbols I've met so far.
>
> What about this:
>
>
> diff --git a/doc/guix.texi b/doc/guix.texi
> index 3b6955c..61e3445 100644
> --- a/doc/guix.texi
> +++ b/doc/guix.texi
> @@ -1000,6 +1000,17 @@ to display fonts, you will have to install fonts with Guix as well.
>  Essential font packages include @code{gs-fonts}, @code{font-dejavu}, and
>  @code{font-gnu-freefont-ttf}.
>  
> +To display text written in Chinese languages, Japanese, or Korean in
> +graphical applications, consider installing
> +@code{font-adobe-source-han-sans} or @code{font-wqy-zenhei}.  The former
> +has multiple outputs, one per language family (@pxref{Packages with
> +Multiple Outputs}).  For instance, the following command installs fonts
> +for Chinese languages:
> +
> +@example
> +guix package -i font-adobe-source-han-sans:cn
> +@ene example
Typo  ↑

Otherwise, this description looks perfect for me.

-- 
If I could write well, I would write something

Re: [PATCH] doc: Ask user to install extra packages to display non-English alphabets.

[Alex Vong]

Hi,

On 17/11/2015, Alex Kost <alezost@gmail.com> wrote:
> Alex Vong (2015-11-16 19:11 +0300) wrote:
>
>> From f2eac896933814a3d5a85c4c20c1407b692be1ca Mon Sep 17 00:00:00 2001
>> From: Alex Vong <alexvong1995@gmail.com>
>> Date: Mon, 16 Nov 2015 23:57:35 +0800
>> Subject: [PATCH] doc: Ask user to install extra packages to display
>>  non-English alphabets.
>>
>> * doc/guix.texi (X11 Fonts): Add instruction and example.
>> ---
>>  doc/guix.texi | 5 +++++
>>  1 file changed, 5 insertions(+)
>>
>>
>> diff --git a/doc/guix.texi b/doc/guix.texi
>> index 3b6955c..dab8ab7 100644
>> --- a/doc/guix.texi
>> +++ b/doc/guix.texi
>> @@ -1000,6 +1000,11 @@ to display fonts, you will have to install fonts
>> with Guix as well.
>>  Essential font packages include @code{gs-fonts}, @code{font-dejavu}, and
>>  @code{font-gnu-freefont-ttf}.
>>
>> +In addition, if your graphical applications display non-english
>> alphabets,
>> +you may need to install extra font packages.
>> +For instance, as of 2015, to correctly display CJK fonts in
>> @code{icecat}
>> +browser package, you should install @code{font-wqy-zenhei} font package.
>
> I didn't try 'font-wqy-zenhei', but there is also
> 'font-adobe-source-han-sans' package (thanks to 宋文武) that "solves"
> Chinese, Japanese and Korean symbols I've met so far.
>
I did tried `guix package -i font-adobe-source-han-sans`, but it
didn't work for icecat.

I have tried it just now to remove `font-wqy-zenhei` and install
`font-adobe-source-han-sans`, but it doesn't work for icecat. I guess
it is because `font-adobe-source-han-sans` is probably too new. Well,
it was invented in 2014
<https://en.wikipedia.org/wiki/Source_Han_Sans>...

> --
> Alex
>

Cheers,
Alex

Re: [PATCH] doc: Ask user to install extra packages to display non-English alphabets.

[Alex Vong]

Hi,

> diff --git a/doc/guix.texi b/doc/guix.texi
> index 3b6955c..61e3445 100644
> --- a/doc/guix.texi
> +++ b/doc/guix.texi
> @@ -1000,6 +1000,17 @@ to display fonts, you will have to install fonts with Guix as well.
>  Essential font packages include @code{gs-fonts}, @code{font-dejavu}, and
>  @code{font-gnu-freefont-ttf}.
>
> +To display text written in Chinese languages, Japanese, or Korean in
> +graphical applications, consider installing
> +@code{font-adobe-source-han-sans} or @code{font-wqy-zenhei}.  The former
Perhaps we could change `or` to `and/or`, since some packages only
work with one font but not another, e.g. Icecat.

> +has multiple outputs, one per language family (@pxref{Packages with
> +Multiple Outputs}).  For instance, the following command installs fonts
> +for Chinese languages:
There are two sets of Chinese characters, Simplified Chinese and
Traditional Chinese. cn is Simplified Chinese used in Mainland and tw
is Traditional Chinese used in Taiwan/HK/Macau. So I think `Chinese
Language` should be changed to `Simplified Chinese`, what is your
idea?

> +
> +@example
> +guix package -i font-adobe-source-han-sans:cn
> +@ene example
> +
>  @c TODO What else?
>

Otherwise, this looks great to me as well.

Cheers,
Alex

Re: [PATCH] doc: Ask user to install extra packages to display non-English alphabets.

[Ludovic Courtès]

Alex Vong <alexvong1995@gmail.com> skribis:

>> diff --git a/doc/guix.texi b/doc/guix.texi
>> index 3b6955c..61e3445 100644
>> --- a/doc/guix.texi
>> +++ b/doc/guix.texi
>> @@ -1000,6 +1000,17 @@ to display fonts, you will have to install fonts with Guix as well.
>>  Essential font packages include @code{gs-fonts}, @code{font-dejavu}, and
>>  @code{font-gnu-freefont-ttf}.
>>
>> +To display text written in Chinese languages, Japanese, or Korean in
>> +graphical applications, consider installing
>> +@code{font-adobe-source-han-sans} or @code{font-wqy-zenhei}.  The former
> Perhaps we could change `or` to `and/or`, since some packages only
> work with one font but not another, e.g. Icecat.

font-adobe-source-han-sans:cn works fine for me in IceCat.  Maybe you
installed an output other than ‘cn’?

>> +has multiple outputs, one per language family (@pxref{Packages with
>> +Multiple Outputs}).  For instance, the following command installs fonts
>> +for Chinese languages:
> There are two sets of Chinese characters, Simplified Chinese and
> Traditional Chinese. cn is Simplified Chinese used in Mainland and tw
> is Traditional Chinese used in Taiwan/HK/Macau. So I think `Chinese
> Language` should be changed to `Simplified Chinese`, what is your
> idea?

I wrote “Chinese languages”, plural, because, IIUC,
font-adobe-source-han-sans:cn provides glyphs for several languages in
the broad Chinese language family.

Does that make sense?

Ludo’.

Re: [PATCH] doc: Ask user to install extra packages to display non-English alphabets.

[Andreas Enge]

Hello,

On Wed, Nov 18, 2015 at 02:46:55AM +0800, Alex Vong wrote:
> Perhaps we could change `or` to `and/or`, since some packages only
> work with one font but not another, e.g. Icecat.

it seems to work without problem for me with icecat of guix on top of debian.
Maybe it is using a debian font, but if I remember correctly, I had to install
font-adobe-source-han-sans to make it work.

Andreas

Re: [PATCH] doc: Ask user to install extra packages to display non-English alphabets.

[Alex Kost]

Alex Vong (2015-11-17 21:28 +0300) wrote:

> On 17/11/2015, Alex Kost <alezost@gmail.com> wrote:
[...]
>> I didn't try 'font-wqy-zenhei', but there is also
>> 'font-adobe-source-han-sans' package (thanks to 宋文武) that "solves"
>> Chinese, Japanese and Korean symbols I've met so far.
>>
> I did tried `guix package -i font-adobe-source-han-sans`, but it
> didn't work for icecat.

Hm, it works for me with "conkeror" (which is "icecat" under the hood).
Perhaps "fc-cache -f" will help, dunno.

-- 
Alex

Re: [PATCH] doc: Ask user to install extra packages to display non-English alphabets.

[Ludovic Courtès]

I’ve committed the patch I had sent, minus typo.

Thanks,
Ludo’.