Skip to content
This repository has been archived by the owner on Jul 12, 2024. It is now read-only.

Configuration

tp7ptr edited this page Jan 12, 2013 · 2 revisions

There are three places which might affect script configuration (in order of overriding) :

  • Source code
  • Configuration file
  • Command line

Source code stores default values and should not be touched.

Configuration file is a JSON file stored in application folder named config.json. It contains the following settings:

  • font_dirs - additional font directories to load. Default is empty.
  • include_system_fonts - determines if system fonts (defined in Windows registry or /etc/fonts/fonts.conf file on Linux) should be loaded. Default is true.
  • verbose - verbose log output. Default is false.
  • exclude_unused_fonts - determines if unused fonts should be excluded. Unused font is a font, defined in script but without any glyphs used. Default is true.
  • exclude_comments - determines if comments should be excluded. Default is true.
  • log_file - external log file. Can be a path to a file. Default is None (not set).
  • mmg - path to mkvmerge executable on your system (mkvmerge.exe on Windows). Default is yet to be determined, but currently "C:/Program Files (x86)/MKVtoolnix/mkvmerge.exe".

Command line arguments:

  • --include [directory] - appends directory to font_dirs. Can be used multiple times.
  • --with-system - Sets include_system_fonts to true
  • --without-system - Sets include_system_fonts to false
  • --exclude-comments - Sets exclude_comments to true
  • --include-comments - Sets exclude_comments to false
  • --exclude-unused-fonts - Sets exclude_unused_fonts to true
  • --include-unused-fonts - Sets exclude_unused_fonts to false
  • -v, --verbose - Sets verbose to true
  • --log [file] - Sets log_file
  • --rebuild-cache -- drop old font cache and create a new one
  • -o, --output [folder/file] - output folder or mks file. If this is a folder, fonts will be copied there. If this is an .mks file, fonts will be muxed into it.

In general, you should use configuration file for your default settings and command line arguments for temporal changes to it.

Clone this wiki locally