Path: ...!weretis.net!feeder7.news.weretis.net!news.albasani.net!.POSTED!not-for-mail
From: Ralph Fox <-rf-nz-@-.invalid>
Newsgroups: alt.usenet.offline-reader.forte-agent
Subject: [Unicode] How to -- Full Unicode display in Agent's message body pane
Date: Sat, 04 Jan 2020 21:01:05 +1300
Organization: No; Y2.038Chaos instead!
Lines: 171
Message-ID: <k2h01fh7212c9fss2fhq4i5354ner69cki@4ax.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Trace: news.albasani.net wRg4De5YaSte/2MWx1iAt5uXSxZZvAaaGav8ogCXuvkVGN70V/5JNWoiCxoWd+bO7uQxokNHX6F1yth1UK2Li7J+Ts4b22ypKFfC5Q5CNYJNf9pLElJIMAJlwoRXE9YB
NNTP-Posting-Date: Sat, 4 Jan 2020 08:01:09 +0000 (UTC)
Injection-Info: news.albasani.net; logging-data="LeSj26A89DmVZrdwx4ALxvj+2IxyFH2Zzk0FkD9Dfr6ZHRsn/O8yaceurwFgnE03WhJnDSj/cOXNqPukEf7lm5mtqfGKDVedZgYxux6vFhqmpo31nVHkL4tuJpX/Z0M3"; mail-complaints-to="abuse@albasani.net"
User-Agent: ForteAgent/8.00.32.1272
X-Face: 5gSW~"1=jGDo(BXfTrgL2BnC3tUB_\d0u@mP~wA1fvK`z8I[>1jXVVZ!N6ittQ.K<5!i3l> ==jcyAk.[B>kLg8TY{+8%edZ(le:ncPt%s8Pr?]QXNXO]0RC#V_zt|%>=bt>rZ2iCI^-yl7Be(]Ep> OfyI!3Bf|e
Cancel-Lock: sha1:WqvXlg3jFppFQRc9f09/1wAx28s=
Bytes: 8123

Happy New Year!

Here is how to get full Unicode text display in Agent's message body pane.
This works in the plain text viewer (but not in the HTML viewer).


1. REQUIREMENTS

    1.1   Windows 10 version 1903 or higher.  IMPORTANT - the config here
          won't work without it.
    1.2   A 32-bit version of Agent which uses .cod files.  This means 
          Agent 1.6 or later.  Agent 7.00 or later is recommended.
    1.3   The ability to edit your own AGENT.INI file.


2. RESULTS

    This is an example screen-shot:   <https://i.imgur.com/JEPDF1v.png>


3. CONFIG INSTRUCTIONS

    All of these config steps are required before it will work.  
    Doing half these steps will not get it half working.


    3.1  COD FILE

         Create a text file "cp65001.cod" with the contents between
         the wavy lines near the bottom of this message.  The file 
         must be named "cp65001.cod", not "cp65001.cod.txt".

         Place a copy of the file "cp65001.cod" into your Agent
         program folder (the folder where agent.exe is).

         Now restart Agent so that it loads the new .cod file
         "cp65001.cod".


    3.2  AGENT LANGUAGE SETTINGS

         Go to Agent's "Languages" panel
            [Agent 1.x - 2.0]   "Options >> General Preferences >> Languages" 
            [Agent 3.0 - 8.00]  "Tools >> Options >> Languages" 

         Create a new language (say) "Unicode UTF-8 (English)" based on 
         your existing language (say) "English".

         Adjust the settings for the new language "Unicode UTF-8 (English)" 
         as below:
           3.2.1  Set 'Codepage' to "Unicode FULL UTF-8 (Codepage 65001)"
           3.2.2  Set 'Send Usenet As' to "Unicode FULL UTF-8 (us-ascii, UTF-8)"
           3.2.3  Set 'Send Email As' to "Unicode FULL UTF-8 (us-ascii, UTF-8)"
         Do _not_ set 'Default Charset' to UTF-8.

             Screen-shot: <https://i.imgur.com/BN6NlKB.png>
         
         Do not change the 'Codepage' of your existing language(s) (say 
         'English') to Codepage 65001.  If you change this, it will 
         trash the 8-bit "extended ascii" characters in your existing 
         sent messages.

         If you already have a language with Codepage 65001 then you
         can re-use it.  Otherwise, create a new language in Agent to 
         avoid trashing your existing sent messages.


    3.3  AGENT FONT SETTINGS

         Go to Agent's "Fonts" panel
            [Agent 1.x]         "Options >> Display Preferences >> Fonts" 
            [Agent 2.0]         "Options >> General Preferences >> Display >> Fonts" 
            [Agent 3.0 - 8.00]  "Tools >> Options >> Display >> Fonts" 

         Select your new language (say) "Unicode UTF-8 (English)" in
         the drop-down.  Then adjust the font settings for your new
         language.

         To display as many Unicode characters as possible, it is important
         which font you select.  I find the best results (most characters) 
         are with these fonts
             Variable Pitch (proportional):   Tahoma
             Fixed Pitch (monospaced):        Lucida Console

         Set the 'Variable Pitch Body', 'Fixed Pitch Body', and 'Printer' 
         fonts.  

         When setting the fonts for a language in Agent, we normally 
         set the font's 'Script' setting to match the language's 'Code 
         Page' setting.  But the Windows font dialog does not show an 
         option for UTF-8 (Codepage 65001) in the 'Script' drop-down. 
         In this case we need to edit AGENT.INI to set the font's 
         'Script' setting to UTF-8.

         Each time you update the font settings, you will also need 
         to edit AGENT.INI again.


    3.4  EDIT AGENT.INI

         Close Agent, then edit your AGENT.INI file.
         Find the [Language<x>] section for the language 
         "Unicode UTF-8 (English)".

         In that section, the 'Variable', 'Fixed', and 'Printer' 
         settings will have a font name followed by six numbers.  To 
         set the font's 'Script' to UTF-8, set the last (6th) number 
         to 254.  [This only works in Windows 10 version 1903 and 
         later.]

             Screen-shot: <https://i.imgur.com/0kKbXh6.gif>

         If you update the font settings in Agent for "Unicode UTF-8 
         (English)", you will also have to edit AGENT.INI again and 
         do this again.


4. TEST IT WORKS

   When you have done the configuration, test it:
    4.1  Select this message.
    4.2  Change this message's language to "Unicode UTF-8 (English)"
            [Agent 1.x - 2.0]   "Message >> Language" 
            [Agent 3.0 - 8.00]  "Edit >> Language" 
    4.3  Look at the Unicode text below.  It should show Unicode 
         characters instead of question marks.

   ***************************************************************

	ℂ𝕠𝕟𝕘𝕣𝕒𝕥𝕦𝕝𝕒𝕥𝕚𝕠𝕟𝕤!  𝕐𝕠𝕦 𝕕𝕚𝕕 𝕚𝕥!

	𝐇𝐚𝐩𝐩𝐲 𝐍𝐞𝐰 𝐘𝐞𝐚𝐫
	𝕱𝖗𝖔𝖍𝖊𝖘 𝕹𝖊𝖚𝖊𝖘 𝕵𝖆𝖍𝖗
	С Новым Годом
	Καλή Χρονιά
	Շնորհավոր Նոր Տարի
	नया साल मुबारक
	༄༅།།ལོ་གསར་ལ་བཀྲ་ཤིས་བདེ་ལེགས་ཞུ།
	สวัสดีปีใหม่
	新年快樂
	새해 복 많이 받으세요
	あけましておめでとうございます
	Ngā mihi o te tau hou
	ᐊᐢᐱᓄᔦ
	ᎤᎵᎮᎵᏍᏗ ᎢᏤ ᎠᏕᏘᏱᏍᎬ
	𝑩𝒍𝒘𝒚𝒅𝒅𝒚𝒏 𝑵𝒆𝒘𝒚𝒅𝒅 𝑫𝒅𝒂
	📆 🕛 🕭 🎉 🍾 🥂 🍻 🎶 🕺💃

   ***************************************************************


FILE

File cp65001.cod
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ COPY ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Name: cp65001
Description: Unicode FULL UTF-8
Version: 1
Codepage: 65001
Charset: UTF-8, csUTF8, UNICODE-1-1-UTF-8
Inbound-Charsets: ascii, utf7, cp65001, iso-8859-1, iso-8859-2, iso-8859-3, iso-8859-4, iso-8859-5, iso-8859-6, iso-8859-7, iso-8859-8, iso-8859-9, iso-8859-10, iso-8859-11, iso-8859-13, iso-8859-14, iso-8859-15, cp437, cp850, cp932, cp936, cp949, cp950, cp1250, cp1251, cp1252, cp1253, cp1254, cp1255, cp1256, cp1257, cp1258, cp1361, cp54936, iso-2022-cn, iso-2022-jp, koi8, koi8u, koi8ru, macroman, norwegian, swedish, tis-620, viscii
Outbound-Charsets: cp65001, Unicode FULL UTF-8, ascii, cp65001
Outbound-Charsets: utf7, Unicode UTF-7#STR_OCS_UTF7, ascii, utf7
Outbound-Charsets: ascii, ASCII Only#STR_OCS_ASCII, ascii
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ COPY ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


-- 
Kind regards
Ralph
🦊