1 files changed, 64 insertions, 4 deletions
diff --git a/system/CNS11643-font/README b/system/CNS11643-font/README
index 71352aaf8b..674ef9135d 100644
--- a/system/CNS11643-font/README
+++ b/system/CNS11643-font/README
@@ -2,10 +2,70 @@ This package contains two type of fonts: TW-Kai and TW-Sung, which are
 provided by CNS11643 Chinese Standard Interchange Code Master Ideographs
 from Taiwan.
 
-This SlackBuild puts 35-CNS11643-font.conf into /etc/fonts/conf.avail.
-It sets the "serif" and "monospace"aliases to TW-Sung fonts, the "sans"
-aliases to TW-Kai fonts. You canuncomment the symlink in the slackbuild
-if you like.
+A config file is included, 35-CNS11643-font.conf, which binds the
+Windows counterparts "MingLiU" (細明體) and "PMingLiU"
+(新細明體) to TW-Sung, and "DFKai-SB", "UKai" (標楷體) to TW-Kai.
+If you want it copied into /etc/fonts/conf.avail, add the
+environment variable "ADDCONF=yes" in front of the SlackBuild.
+I recommend running the SlackBuild like this:
+
+  ADDCONF=yes ./CNS11643-font.SlackBuild
+
+If you're using a SlackBuild manager, the way of adding variables may
+differ; please consult the manual of your program for instructions.
+
+If you don't want your default fonts replaced, you can add this to
+/etc/fonts/conf.avail/50-user.conf between the <fontconfig> tags:
+(please replace the font names according to the comments)
+
+<!-- Custom font preference -->
+<alias>
+    <family>serif</family>
+    <prefer>
+        <!-- preferred serif latin font -->
+        <family>Noto Serif</family>
+        <!-- preferred serif fallback font -->
+        <family>Noto Serif CJK TC</family>
+    </prefer>
+</alias>
+<alias>
+    <family>sans-serif</family>
+    <prefer>
+        <!-- preferred sans-serif latin font -->
+        <family>Noto Sans</family>
+        <!-- preferred sans-serif fallback font -->
+        <family>Noto Sans CJK TC</family>
+    </prefer>
+</alias>
+<match target="pattern">
+    <test qual="any" name="family" compare="eq">
+        <string>monospace</string>
+    </test>
+    <!-- replace "Liberation Mono" with preferred monospace font -->
+    <edit name="family" mode="assign" binding="strong">
+        <string>Liberation Mono</string>
+    </edit>
+</match>
+<alias>
+    <!-- replace "Liberation Mono" with preferred monospace font -->
+    <family>Liberation Mono</family>
+    <prefer>
+        <!-- preferred monospace font -->
+        <family>Liberation Mono</family>
+        <!-- preferred monospace fallback font
+             (does not necessarily need to be monospace -->
+        <family>Sarasa Fixed TC</family>
+    </prefer>
+</alias>
+<alias>
+    <family>system-ui</family>
+    <prefer>
+        <!-- preferred system-ui latin font (usually sans-serif) -->
+        <family>Noto Sans</family>
+        <!-- preferred system-ui fallback font -->
+        <family>Noto Sans CJK TC</family>
+    </prefer>
+</alias>
 
 The source file can be found at "http://data.gov.tw/node/5961", and the
 license can be found at "http://www.cns11643.gov.tw/AIDB/copyright.do".