cjk-gs-integrate version 20170624.0

Usage: [perl] cjk-gs-integrate[.pl] [OPTIONS] Configuring Ghostscript for CJK CID/TTF fonts This script searches a list of directories for CJK fonts, and makes them available to an installed Ghostscript. In the simplest case with sufficient privileges, a run without arguments should effect in a complete setup of Ghostscript. Options: -o, --output DIR specifies the base output dir, if not provided, the Resource directory of an installed Ghostscript is searched and used. -f, --fontdef FILE specify alternate set of font definitions, if not given, the built-in set is used -a, --alias LL=RR defines an alias, or overrides a given alias; illegal if LL is provided by a real font, or RR is neither available as real font or alias; can be given multiple times --filelist FILE read list of available font files from FILE instead of searching with kpathsea --link-texmf [DIR] link fonts into DIR/fonts/opentype/cjk-gs-integrate and DIR/fonts/truetype/cjk-gs-integrate where DIR defaults to TEXMFLOCAL --otfps [DIR] generate configuration file (psnames-for-otf) into DIR/dvips/ps2otfps which is used by ps2otfps (developed by Akira Kakuto), instead of generating snippets --force do not bail out if linked fonts already exist --remove try to remove instead of create --cleanup try to clean up all possible links/snippets and cidfmap.local/cidfmap.aliases, which could have been generated in the previous runs -n, --dry-run do not actually output anything -q, --quiet be less verbose -d, --debug output debug information, can be given multiple times -v, --version outputs only the version information -h, --help this help Command like options: --dump-data [FILE] dump the built-in set of font definitions; you can easily modify it, and tell me with -f (or --fontdef) the data file name defaults to cjk-gs-integrate-data.dat --only-aliases regenerate only cidfmap.aliases file, instead of all --list-aliases lists the available aliases and their options, with the selected option on top --list-all-aliases list all possible aliases without searching for actually present files --list-fonts lists the fonts found on the system --info combines the information of --list-aliases and --list-fonts --machine-readable output of --list-aliases is machine readable Operation: For each found TrueType (TTF) font it creates a cidfmap entry in <Resource>/Init/cidfmap.local -- if you are using tlgs win32, tlpkg/tlgs/lib/cidfmap.local instead and links the font to <Resource>/CIDFSubst/ For each CID font it creates a snippet in <Resource>/Font/ and links the font to <Resource>/CIDFont/ The `<Resource>` dir is either given by `-o`/`--output`, or otherwise searched from an installed Ghostscript (binary name is assumed to be 'gs' on unix, 'gswin32c' on win32). Aliases are added to <Resource>/Init/cidfmap.aliases -- if you are using tlgs win32, tlpkg/tlgs/lib/cidfmap.aliases instead Finally, it tries to add runlib calls to <Resource>/Init/cidfmap -- if you are using tlgs win32, tlpkg/tlgs/lib/cidfmap to load the cidfmap.local and cidfmap.aliases. How and which directories are searched: Search is done using the kpathsea library, in particular using kpsewhich program. By default the following directories are searched: - all TEXMF trees - `/Library/Fonts`, `/Library/Fonts/Microsoft`, `/System/Library/Fonts`, `/System/Library/Assets`, `/Network/Library/Fonts`, `~/Library/Fonts` and `/usr/share/fonts` (all if available) - `/Applications/Microsoft Word.app/Contents/Resources/{Fonts,DFonts}`, `/Applications/Microsoft Excel.app/Contents/Resources/{Fonts,DFonts}`, `/Applications/Microsoft PowerPoint.app/Contents/Resources/{Fonts,DFonts}` (all if available, meant for Office for Mac 2016) - `c:/windows/fonts` (on Windows) - the directories in `OSFONTDIR` environment variable In case you want to add some directories to the search path, adapt the `OSFONTDIR` environment variable accordingly: Example: OSFONTDIR="/usr/local/share/fonts/truetype//:/usr/local/share/fonts/opentype//" $prg will result in fonts found in the above two given directories to be searched in addition. Output files: If no output option is given, the program searches for a Ghostscript interpreter 'gs' and determines its Resource directory. This might fail, in which case one need to pass the output directory manually. Since the program adds files and link to this directory, sufficient permissions are necessary. Aliases: Aliases are managed via the Provides values in the font database. At the moment entries for the basic font names for CJK fonts are added: Japanese: Ryumin-Light GothicBBB-Medium FutoMinA101-Bold FutoGoB101-Bold Jun101-Light Korean: HYSMyeongJo-Medium HYGoThic-Medium HYRGoThic-Medium Simplified Chinese: STSong-Light STSong-Regular STHeiti-Regular STHeiti-Light STKaiti-Regular STFangsong-Light STFangsong-Regular Traditional Chinese: MSung-Light MSung-Medium MHei-Medium MKai-Medium In addition, we also include provide entries for the OTF Morisawa names: RyuminPro-Light GothicBBBPro-Medium FutoMinA101Pro-Bold FutoGoB101Pro-Bold Jun101Pro-Light The order is determined by the Provides setting in the font database, and for the Japanese fonts it is currently: Morisawa Pr6N, Morisawa, Hiragino ProN, Hiragino, Kozuka Pr6N, Kozuka ProVI, Kozuka, Yu OSX, Yu Win, MS, Moga-Mobo-ex, Moga-Mobo, IPAex, IPA, Ume That is, the first font found in this order will be used to provide the alias if necessary. For the Korean fonts: (Hanyang,) Adobe, Solaris-hanyang, MS, Unfonts, Baekmuk For the Simplified Chinese: Adobe, Fandol, Hiragino, Founder, MS, CJKUnifonts, Arphic, CJKUnifonts-ttf For the Traditional Chinese: Adobe, MS, CJKUnifonts, Arphic, CJKUnifonts-ttf Overriding aliases Using the command line option `--alias LL=RR` one can add arbitrary aliases, or override ones selected by the program. For this to work the following requirements of `LL` and `RR` must be fulfilled: * `LL` is not provided by a real font * `RR` is available either as real font, or as alias (indirect alias) Authors, Contributors, and Copyright: The script and its documentation was written by Norbert Preining, based on research and work by Yusuke Kuroki, Bruno Voisin, Hironobu Yamashita, Munehiro Yamamoto and the TeX Q&A wiki page. The script is licensed under GNU General Public License Version 3 or later. The contained font data is not copyrightable.