various cleanups, fixes and major documentation rewrite of the text module
[PyX.git] / pyx / data / pyxrc
blob6e5abffe4df0fbd646d331916e5a483b29ca1a8c
1 # This file is an example containing the runtime configuration options
2 # of PyX and its default values. You may copy it to ~/.pyxrc for personal
3 # configuration.
5 [general]
6 # general options
8 # Some options can contain several values and the space character is
9 # used by default to separate several values. In case the space
10 # character is needed itself as part of the values, you can set an
11 # unused replacement string to encode the space character being
12 # part of the value. By default 'SPACE' is this magic string:
13 space = SPACE
15 [text]
16 # runtime configuration of the text module
18 # 'tex' specifies the TeX executable and defaults to 'tex'.
19 tex = tex
21 # 'latex' specifies the LaTeX executable and defaults to 'latex'.
22 latex = latex
24 # 'psfontmaps' is a whitespace separated list of options listing font
25 # mapping files. Those files contain information about the available
26 # type1 fonts. Depending on your TeX-installation you may need to add
27 # further font mapping files like psfonts.cmz (if your TeX installation
28 # is not configured to use type1 fonts by default). For further
29 # information browse the FAQ for the term 'font mapping file'.
30 psfontmaps = psfonts.map
32 # 'pdffontmaps' is similar to psfontmaps, but used when pdf output
33 # is generated. (Note that pdf has a different set of builtin fonts.)
34 pdffontmaps = pdftex.map
36 # 'wait' is an positive integer. It is the number of seconds
37 # to be waited for an appropriate response from TeX/LaTeX.
38 wait = 60
40 # 'showwait' is an non-negative integer. It is the number of
41 # seconds to be waited until (and between) emitting messages
42 # indicating the waiting for an appropriate response from TeX/LaTeX.
43 # This feature can be turned off by setting showwaitfortex to 0.
44 showwait = 5
46 # 'texipc' is a boolean controlling the usage of the --ipc option of
47 # TeX/LaTeX. You should turn on this option when the ipc-extension is
48 # available in your TeX installation (check the output of tex --help).
49 # You will gain immediate access to the dvi-output of TeX by that,
50 # which will substantially improve the performance of certain
51 # operations (e.g. the usage of PyX markers).
52 texipc = 0
54 [filelocator]
55 # runtime configuration of file search mechanism
57 # 'methods' defines a list of methods to be tried one after each other
58 # to find files like, e.g., fonts and corresponding metrics information.
60 # Available methods are:
61 # - 'local': locates files in the current directory.
62 # - 'internal': locates files within the PyX data tree (works inside
63 #               of zipped Python eggs too)
64 # - 'recursivedir': locates files by searching recursively in a
65 #                   space-separated list of directories, which can
66 #                   be specified by the option 'recursivedir'.
67 # - 'ls-R': locates files by searching a list of ls-R files,
68 #           which can be specified by the option 'ls-R'.
69 # - 'pykpathsea': locate files using the pykpathsea extension if available.
70 #                 Building of this module can be enabled in the setup.cfg
71 #                 file distributed with PyX.
72 # - 'kpsewhich': locate files using the kpsewhich executable if available.
73 #                The name of the executable can be set by the 'kpsewhich'
74 #                option and defaults to 'kpsewhich'.
75 # - 'locate': locate files using a locate executable if available.
76 #             The name of the executable can be set by the 'locate'
77 #             option and defaults to 'locate'.
78 methods = local internal pykpathsea kpsewhich