]> git.lyx.org Git - lyx.git/blob - lib/lyxrc.example
Dekel's import/export patch
[lyx.git] / lib / lyxrc.example
1 ### This file is part of
2 ### =====================================================
3 ###
4 ###           LyX, the High Level Word Processor
5 ###
6 ###  Copyright 1995-1997 Matthias Ettrich & the LyX Team
7 ###
8 ### =====================================================
9
10 # The file lyxrc.example is a template to write your own lyxrc file. 
11 # If you copy/rename it to lyxrc in the current directory, it will
12 # give global options for all LyX users. It is also possible to copy
13 # this file to $HOME/.lyx/lyxrc so that the configuration applies to a
14 # particular user.
15 #
16 # Several of these settings have defaults that are auto-detected when you use
17 # the menu option Options->Reconfigure.  You can see their value by looking at
18 # the file $HOME/.lyx/lyxrc.defaults. Any setting in this file will override
19 # the defaults.
20
21 #
22 # BIND SECTION ###########################################################
23 #
24
25 # Before defining your own key-bindings, select one of the available default
26 # binding sets. These are resource files (like this one) that define a
27 # large set of (keyboard) bindings. These files live in bind directory of
28 # the LyX system directory and have in general the .bind suffix.
29 # Currently, you can choose from the following flavors:
30 #
31 # cua.bind            for Windows-, Mac- and Motif-like bindings
32 # emacs.bind          for Emacs-like bindings.
33 #
34 # The \bind_file command looks in the LyX bind directory for a file 
35 # of the given name, but a full path can also be given. If you have
36 # a bind file in your ~/.lyx/bind/ directory, it will be preferred
37 # over a system wide bind file. Default is `cua'.
38
39 #\bind_file cua
40 #\bind_file emacs
41
42 # Based on the default, you can now change part or all of it with the
43 # \bind command. For example, when you want the delete key to do the
44 # backspace action, uncomment the following line:
45 #\bind "Delete" "delete-backward"
46
47 # However, if you're not at all happy with the default bindings,
48 # the most logical thing to do would be to use one of the system
49 # wide bind files as a template and place your own version in
50 # ~/.lyx/bind/mine_is_best.bind and change the above \bind_file 
51 # to this instead:
52 #\bind_file mine_is_best
53
54 # By default, LyX takes over the handling of the dead keys (or accent
55 # keys) that may be defined for your keyboard. While this allows you
56 # to enter characters that would not be normally available, some
57 # people dislike the different behaviour. You can use raw dead keys by
58 # just uncommenting the next line
59 #\override_x_deadkeys false
60
61 # Tip: Use "lyx -dbg 4" to survey how LyX interprets your keybindings.
62
63
64 #
65 # MISC SECTION ###########################################################
66 #
67
68 # Set this to false if you don't want the startup banner.
69 # Default is true.
70 #\show_banner true
71
72 # Set to false if you don't want the current selection to be replaced
73 # automatically by what you type. Default is true.
74 #\auto_region_delete false
75
76 # This is the time interval between auto-saves (in seconds).
77 # 0 means no auto-save, default is 300 for five minutes.
78 #\autosave 600
79
80 # LyX asks for a second confirmation to exit if you exit with changed 
81 # documents that you don't want to save.  You can turn this confirmation off 
82 # (LyX will still ask to save changed documents) with the following line.
83 # We recommend to keep the confirmation, though.
84 #\exit_confirmation false
85
86 # This sets the behaviour if you want to be asked for a filename when
87 # creating a new document or wait until you save it and be asked then.
88 # The default for now is ask on save.
89 # \new_ask_filename false
90
91 # LyX continously displays names of last command executed, along with a list 
92 # of defined short-cuts for it in the minibuffer.
93 # It requires some horsepower to function, so you can turn it off, if LyX
94 # seems slow to you, by uncommenting this line:
95 #\display_shortcuts false
96
97 # \view_dvi_paper_option allows to specify a paper option to the dvi
98 # viewer. By default LyX specifies the paper size of the document to
99 # the dvi viewer via the command line option -paper size, where size
100 # is one of "us","letter","a3","a4" and so on. The command
101 # \view_dvi_paper_option allows the user to overwrite the name of the
102 # command line flag, i.e. replace -paper with something else. If
103 # specified and left empty, i.e. \view_dvi_paper_option "", LyX does
104 # not append the -paper option to the dvi command at all. This case is
105 # especially useful when viewing your documents on Windows with yap,
106 # because yap does not allow a command line option for the paper size.
107 #\view_dvi_paper_option "" 
108
109 # LyX assumes that the default papersize should be usletter.  If this is not
110 # true for your site, use the next line to specify usletter, legal,
111 # executive, a3, a4, a5, or b5 as the default papersize.
112 #\default_papersize "a4"
113
114 # Define which program to use to use as postscript interpreter for included
115 # images.
116 # You can not include any options. The default is "gs" if it can be found.
117 # If you have a slow computer, you should consider turning off the WYSIWYG 
118 # display of includes images, by using this command:
119 #\ps_command ""
120
121 # Define which program to use to run "chktex".
122 # You should include options that turn different warnings on and off.
123 # Default is "chktex -n1 -n3 -n6 -n9 -n22 -n25 -n30 -n38"
124 # Check the ChkTeX documentation for info on what the flags mean.
125 # Example: use this to ignore warnings about using "\ldots" instead of "..."
126 #\chktex_command "chktex -n11 -n1 -n3 -n6 -n9 -22 -n25 -n30 -n38"
127
128 # Keyboard Mapping. Use this to set the correct mapping file for your
129 # keyboard, that is if you need one. You'll need one if you for instance
130 # want to type German documents on an American keyboard. In that case,
131 # uncomment these three lines:
132 #\kbmap true
133 #\kbmap_primary german
134 #\kbmap_secondary american
135 # The following keyboards are supported: american, czech, francais,
136 # french, german, german-2, magyar, magyar-2, portuges, romanian,
137 # slovak, slovene, transilvanian, turkish and turkish-f. Check
138 # the lib/kbd directory if you want to write support for your language.
139 # If you do, please submit it to lyx-devel@lists.lyx.org.
140
141 # The Pause button is defined to be a three-way switch between primary 
142 # keyboard, secondary keyboard, and no keyboard mapping with the
143 # following command. It is useful if you want to write in a language
144 # not directly supported by your keyboard and you have defined a
145 # custom keyboard mapping above.
146 #\bind "Pause" "keymap-toggle"
147
148 # This starts the lyxserver. The pipes get an additional extension
149 # '.in' and '.out'. Only for advanced users.
150 # \serverpipe "/home/chb/.lyxpipe"
151
152 # Default format string for the date-insert command
153 #
154 # This accepts the normal strftime formats; see man strftime for full
155 # details of the format.
156 #
157 #\date_insert_format "%A, %e. %B %Y"
158
159 #
160 # SCREEN & FONTS SECTION #################################################
161 #
162
163 # DPI (dots per inch) of your monitor is auto-detected by LyX. If that goes 
164 # wrong, you can override the setting here:
165 #\screen_dpi 100
166
167 # The zoom percentage for screen fonts.
168 # A setting of 100% will make the fonts roughly the same size as on paper. 
169 # However, since a screen is wider than a piece of paper, the default setting
170 # is 150%.
171 #\screen_zoom 100
172
173 # The wheel movement factor (for mice with wheels or five button mice)
174 # Default is 100, about a page down. A value of 10 give me about a line and
175 # a half
176 #\wheel_jump 10
177
178 # LyX normally doesn't update the cursor position if you move the scrollbar.
179 # If you scroll the cursor off the screen and then start typing LyX will
180 # move you back to where the cursor was. If you'd prefer to always have the 
181 # cursor on screen, bounded by the topmost and bottommost visible lines 
182 # -- much like XEmacs for example -- then uncomment the next line.
183 #\cursor_follows_scrollbar true
184
185 # The screen fonts used to display the text while editing
186 # The defaults are:
187 #\screen_font_roman "-*-times"
188 #\screen_font_sans "-*-helvetica"
189 #\screen_font_typewriter "-*-courier"
190
191 # For some, this font looks better:
192 #\screen_font_roman "-*-utopia"
193
194 # Allow the use of scalable screen fonts? Default is true.
195 # If you choose "false", LyX will use the closest existing size for a match.
196 # Use this if the scalable fonts look bad and you have many fixed size fonts.
197 #\screen_font_scalable false
198
199 # Tip: Run lyx as "lyx -dbg 512" to learn which fonts are used.
200
201 # The norm for the screen fonts. The default is iso8859-1, which is
202 # the same as what LaTeX calls latin1.
203 #\screen_font_encoding iso8859-2
204
205 # The norm for the menu/popups fonts. The default is an empty string, which
206 # causes to use the screen fonts norm (defined by \screen_font_encoding).
207 #\screen_font_encoding_menu iso8859-2
208
209
210 # The font for popups. It is set to 
211 #    <font_popup>-*-*-*-?-*-*-*-*-<font_encoding>.
212 # The default  is:
213 #\screen_font_popup "-*-helvetica-medium-r"
214
215 # The font for menus (and groups titles in popups). It is set to 
216 #    <font_menu>-*-*-*-?-*-*-*-*-<font_encoding>.
217 # The default  is:
218 #\screen_font_menu "-*-helvetica-bold-r"
219
220 # The font sizes used for calculating the scaling of the screen fonts.
221 # You should only have to change these if the fonts on your screen look bad,
222 # in which case you can fine tune the font selection size by size. LyX selects
223 # font size according to this table, the monitor DPI setting and the current
224 # zoom setting. 
225 # The format is:
226 #\screen_font_sizes tiny smallest smaller small normal large larger largest huge huger
227 #
228 # This is the default in LyX (exactly what LaTeX does):
229 #\screen_font_sizes 5.0 7.0 8.0 9.0 10.0 12.0 14.4 17.28 20.74 24.88
230
231 # To change the colors for footnotes:
232 #\set_color footnote green
233 # for mathed you may also want to change the coloring of lines and brackets:
234 #\set_color math yellow
235 #\set_color mathlines yellow
236
237 #
238 # UI SECTION ########################################################
239 #
240
241 # Choose your UI (user interface) definition here. The .ui files are in the 
242 # directory "lib/ui" and contains the definition of the menu and the toolbar.
243 #\ui_file "default"
244
245 #
246 # PRINTER SECTION ########################################################
247 #
248
249 # The default printer to print on. If none is specified, LyX will use
250 # the environment variable PRINTER. If that fails, the default is empty.
251 #\printer ""
252
253 # If you have setup (as we recommend you to do) your print program
254 # (e.g. dvips) to take advantage of the particularities of the various
255 # printers you have access to, then you should set the following to
256 # true. Then LyX will pass the name of the destination printer to your
257 # print command.
258 # The default is false, because we have unfortunately to cope with
259 # people who refuse to take the time to configure their system.
260 # Note that you will probably have to change \print_spool_command below.
261 #\print_adapt_output true
262
263 # If you don't use dvips, you may specify your favorite print program
264 # here. See other options at the end of this section to adapt LyX to
265 # your print program.
266 #\print_command dvips
267
268 # Extra options to pass to printing program after everything 
269 # else, but before the filename of the DVI file to be printed.
270 #\print_extra_options ""
271
272 # When set, this printer option automatically prints to a file 
273 # and then calls a separate print spooling program on that file
274 # with the given name and arguments.
275 # This is set by default to 'lp' or 'lpr', depending on what your
276 # system uses. 
277 # Set this to "" if you have set up dvips so that it sends
278 # output to the right printer (remember to also use \print_adapt_output).
279 #\print_spool_command ""
280
281 # If you specify a printer name in the print dialog,
282 # the following argument is prepended along with the printer name
283 # after the spool command. The default is autodetected, along with
284 # \print_spool_command determination. 
285 #\print_spool_printerprefix ""
286
287 # Other print related options
288
289 # The following options are only of interest to people who do not
290 # use dvips as print command. You may safely skip to the end of this
291 # section otherwise.
292
293 # These specify the options to pass to the printer program to select the
294 # corresponding features. These default to the options used for the dvips
295 # program. Look at the man page for your favorite print program to learn
296 # which options to use.
297 # Normally you don't need to change this unless you use something other
298 # than dvips. 
299 #\print_evenpage_flag -B
300 #\print_oddpage_flag -A
301 #\print_reverse_flag -r 
302 #\print_landscape_flag "-t landscape"
303 #\print_pagerange_flag -pp
304 #\print_copies_flag -c
305 #\print_collcopies_flag -C
306 #\print_paper_flag -t
307 #\print_paper_dimension_flag -T
308
309 # Option to pass to the print program to print on a specific printer.
310 #\print_to_printer -P
311
312 # Option to pass to the print program to print to a file.
313 #\print_to_file -o 
314
315 # Extension of printer program output file. Usually .ps
316 #\print_file_extension .ps
317
318 # Sample configuration to use with dvilj4 for a HP Laserjet IV (or
319 # better) printer [provided by Reuben Thomas <rrt@sc3d.org>]:
320 #\print_command dvilj4
321 #\print_extra_options -q
322 #\print_evenpage_flag "-D2 -r"
323 #\print_oddpage_flag -D1
324 #\print_reverse_flag -r 
325 #\print_landscape_flag -l
326 #\print_pagerange_flag -p
327 #\print_to_file -e
328 #\print_file_extension .lj
329 #\print_copies_flag -c
330 #\print_collcopies_flag -c
331 #\print_adapt_output false
332
333 #
334 # EXPORT SECTION ########################################################
335 #
336
337 # The \converter command defines a converter between two formats. 
338 # LyX uses the defined converters for generating output in varius formats.
339 # The converter command has 4 arguments: The source format, the target format,
340 # the command, and additional flags.
341 # For example, the following defines a DVI->Postscript converter:
342 #\converter dvi ps "dvips -o $$OutName $$FName" ""
343 # The variable name $$FName is replaced with the name of the source file,
344 # and $$OutName is replaced with the name of the target file.
345 # The flags argument is a list of comma separated flags.
346 # Known flags are
347 # - * : copy the previously defined flags
348 # - latex : The converter is latex or its derivatives (pdflatex).
349 # - originaldir : The converter must be invoked in the directory of the lyx
350 #   file and not in the temporary directory. This is needed for tex->html
351 #   converters in order to be able to read the eps files.
352 # - needaux : The converted uses the .aux file, so we need to call latex
353 #   before running the converter.
354 # - resultdir=dir : The converter put all the files in dir.
355 #   Using "resultdir" is same as "resultdir=$$Basename".
356 #   Note: When exporting, the whole directory will be moved from the temporary
357 #   directory to the target directory.
358 # - resultfile=file : Name of main file in the result directory, for example
359 #  "index.html" or "$$BaseName.html"
360 #   If "resultfile" is omitted, the name of this file is assumed to be
361 #   "index.format"
362 # - parselog=filtername : filtername is a name of a filter command that takes
363 #   the converter error log (from stderr), and converts it to a fake latex .log
364 #   file.
365 #  - disable=backends : A list of & seperated backend in which the converter
366 #   should not be used.
367 # For example:
368 #\converter latex html "latex2html -split 0 $$FName"
369 #           "originaldir,needaux,resultdir,disable=linuxdoc&docbook"
370 #
371 # For literate programming, use something like
372 #\converter literate latex "noweave -delay -index $$FName >$$OutName"
373 #                          "parselog=listerrors g"
374 #\converter literate program "build-script $$FName"
375 #                            "originaldir,parselog=listerrors g"
376
377 # The format command is used to define file formats. It has 4 arguments:
378 # the format name, the extension, and "pretty name" and menu shortcut.
379 # For example
380 #\Format latex tex LaTeX L
381
382 # The \viewer command is used to define viewers for new formats,
383 # or to change the already defined viewers.
384 # For example, to use xdvi as the viewer to dvi files use
385 #\viewer dvi "xdvi"
386 # It can get more involved. Expert users might prefer something like:
387 #\viewer dvi "xdvi -s 2 -expert -geometry 1014x720+0+0 -keep -margins 1.5"
388
389 #
390 # TEX SECTION  ###########################################################
391 #
392
393 # The font encoding used for the LaTeX2e fontenc package.
394 # T1 is highly recommended for non-English languages. LyX uses T1 as a
395 # default if you have the ec fonts installed on your system.
396 #\font_encoding T1
397 # Choose "default" if T1 doesn't work for you for some reason:
398 #\font_encoding default
399
400 #
401 # FILE SECTION  ##########################################################
402 #
403
404 # The default path for your documents.
405 # Default is $HOME
406 #\document_path ~/Documents/
407
408 # The file where the last-files information should be stored.
409 # Default is ~/.lyx/lastfiles
410 #\lastfiles ~/.lyx_lastfiles
411
412 # Maximal number of lastfiles. Up to nine can appear in the file menu.
413 # Default is four.
414 #\num_lastfiles 9
415
416 # Flag telling whether the lastfiles should be checked for existence.
417 # Files that does not exist are left out of the lastfiles entries.
418 # Default is true. If you use slow or removable media, such as networks
419 # or floppy disks, you can speed up the starting time of LyX by disabling 
420 # this feature.
421 #\check_lastfiles false
422
423 # The path that LyX will set when offering you to choose a template.
424 # Default is (System LyX dir)/templates
425 #\template_path ~/.lyx/templates
426
427 # The path that LyX will use to put temporary TeX outputs.
428 # Default is /tmp/<unique directory for each instance of LyX>
429 # containing <unique subdirectory for each buffer>
430 # If you set it, it will be /directory/<unique subdirectory for each buffer>
431 # (unless set to /tmp).
432 #\tempdir_path /usr/tmp
433
434 # If you set this flag, LyX will always use a temporary directory
435 # to put TeX outputs into. It is enabled by default.
436 # This directory is deleted when you quit LyX.
437 # You might want to avoid using a temporary directory in several
438 # cases:
439 # - LaTeX cannot find some files it needs;
440 # - you have a large number of include files, and you get messages
441 #   saying that some LaTeX buffers overflow.
442 # Note that, even if tell LyX not to use a temporary directory, there
443 # will be cases where it will be forced to: this happens for example
444 # when typesetting a file in a read-only directory (documentation).
445 #\use_tempdir false
446
447 # This is the maximum line length of an exported ASCII file (LaTeX,
448 # SGML or plain text). Default is 75. 
449 #\ascii_linelen 80
450
451 # Set to false if you don't want LyX to create backup files.
452 # Default is true.
453 #\make_backup true
454
455 # The path for storing backup files. If it is the empty string, LyX will
456 # store the backup file in the same directory of the original file.
457 # Default is "".
458 #\backupdir_path "~/Desktop/Trash/"
459
460
461 #
462 # FAX SECTION #############################################################
463 #
464
465 # In the following, the <$$something> strings are substituted by
466 # reasonable values by LyX. The 's are important as there may be spaces in 
467 # the string. The default is auto-detected.
468 # This one is what is used with HylaFax:
469 #\fax_command "sendfax -n -h '$$Host' -c '$$Comment' -x '$$Enterprise' -d '$$Name'@'$$Phone' '$$FName'"
470 # Use this for the efax-command:
471 #\fax_command "faxsend '$$Phone' '$$FName'"
472
473 # This is the name of your phone book. It's per default situated in ~/.lyx/,
474 # but you can override that with an absolute path.
475 #\phone_book phonebook
476
477 # This is how to call an external FAX-program instead of the built-in.
478 # You may also insert $$FName to reference the PostScript file.
479 #\fax_program "myfaxprg '$$FName'"
480 #\fax_program tkhylafax
481
482 #
483 # ASCII EXPORT SECTION ###################################################
484 #
485
486 # The following entry can be used to define an external program to
487 # render tables in the ASCII output. If you specify "none", a simple 
488 # internal routine is used. The default is auto-detected.
489 # The following line will use groff and output using latin-1 encoding
490 # (here $$FName is the input file and the output goes to stdout):
491 #\ascii_roff_command "groff -t -Tlatin1 $$FName"
492
493 #
494 # SPELLCHECKER SECTION ####################################################
495 #
496
497 # What command runs the spell checker? Default is "ispell" if it is
498 # installed, "none" otherwise.
499 # If you have aspell (http://metalab.unc.edu/kevina/aspell/)
500 # installed and configured, you might want to uncomment the line below.
501 #\spell_command aspell
502
503 # Consider run-together words, such as "notthe" for "not the", as legal 
504 # words? Default is false. 
505 #\accept_compound true
506
507 # Specify an alternate language. The default is to use the language of 
508 # document. Uncomment both to enable.
509 #\use_alt_language true
510 #\alternate_language dansk
511
512 # Specify additional chars that can be part of a word.
513 #\use_escape_chars true
514 #\escape_chars "æøåÆØÅ"
515
516 # Specify an alternate personal dictionary file. If the file name does not
517 # begin with "/", $HOME is prefixed. The default is to search for a personal 
518 # dictionary in both the current directory and $HOME, creating one in $HOME 
519 # if none is found. The preferred name is constructed by appending ".ispell_" 
520 # to the base name of the hash file. For example, if you use the English 
521 # dictionary, your personal dictionary would be named ".ispell_english". 
522 #\use_personal_dictionary true
523 #\personal_dictionary .ispell_dansk
524
525 # Specify whether to pass the -T input encoding option to ispell (only if the 
526 # language is different than "default".) Enable this if you can't spellcheck
527 # words with international letters in them. There have been reports that this
528 # does not work with all dictionaries, so this is disabled by default.
529 #\use_input_encoding true
530
531
532 #
533 # LANGUAGE SUPPORT SECTION ####################################################
534 #
535
536 # Set to true to enable support of right-to-left languages (e.g. Hebrew,
537 # Arabic). Default is false.
538 #\rtl true
539
540 # The latex command for loading the language package.
541 # Default is \usepackage{babel}.
542 #\language_package "\usepackage{omega}"
543
544 # The latex command for changing the from the language of the document
545 # to another language. $$lang is substituted by the name of the second
546 # language. Default is \selectlanguage{$$lang}.
547 #\language_command_begin "\begin{otherlanguage}{$$lang}"
548
549 # The latex command for changing back the language to the language of
550 # the document. Default is \selectlanguage{$$lang}.
551 #\language_command_end "\end{otherlanguage}"
552
553 # Set to false if a language switching command is needed at the beginning of
554 # the document. Default is true.
555 #\language_auto_begin false
556
557 # Set to false if a language switching command is needed at the end of
558 # the document. Default is true.
559 #\language_auto_end false
560
561 # Set mark_foreign_language to "false" to disable the highlighting of words
562 # with a foreign language to the language of the documet.
563 # Default is "true"
564 #\mark_foreign_language false
565
566 # It is possible to bind keys for changing the language inside a document. 
567 # For example, the following command will cause F12 to switch between French
568 # and English in a French document, and in a document of other language it will
569 # switch between that language and French.
570 #\bind "F12" "language french"
571
572 #
573 # HEBREW SUPPORT SECTION ####################################################
574 #
575
576 # To enable the Hebrew support, uncommnet the following lines:
577 #\rtl true
578 #\kbmap true
579 #\kbmap_primary null
580 #\kbmap_secondary hebrew
581 #\converter tex dvi elatex ""
582 #\converter tex pdf pdfelatex ""
583 #\font_encoding default
584
585 # You also need to bind a key for switching between Hebrew and English.
586 # For example,
587 #\bind "F12" "language hebrew"
588
589 # You might want ot disable the foreign language marking:
590 #\mark_foreign_language false
591
592 # Finally, you need to select iso8859-8 font encoding, and select screen fonts
593 # (below are the default fonts. You need to replace them by Hebrew fonts)
594 #\screen_font_encoding iso8859-8
595 #\screen_font_roman "-*-times"
596 #\screen_font_sans "-*-helvetica"
597 #\screen_font_typewriter "-*-courier"
598 #\screen_font_popup "-*-helvetica-medium-r"
599 #\screen_font_menu "-*-helvetica-bold-r"
600
601 #
602 # ARABIC SUPPORT SECTION ####################################################
603 #
604
605 # To enable the Arabic support, uncommnet the following lines:
606 #\rtl true
607 #\kbmap true
608 #\kbmap_primary null
609 #\kbmap_secondary arabic
610
611 # You also need to bind a key for switching between Arabic and English.
612 # For example,
613 #\bind "F12" "language arabic"
614
615 # If you use arabtex, uncomment the following lines
616 #\language_auto_begin false
617 #\language_auto_end false
618 #\language_command_begin "\begin{arabtext}"
619 #\language_command_end "\end{arabtext}"
620 #\language_package "\usepackage{arabtex,iso88596}\setcode{iso8859-6}"
621
622 # Finally, you need to select iso8859-6.8x font encoding,
623 # and select screen fonts.
624 # iso8859-6.8x fonts can be found at
625 #   http://www.langbox.com/AraMosaic/mozilla/fontXFE/
626 #\screen_font_encoding iso8859-6.8x
627 #\screen_font_encoding_menu iso8859-1
628 #\screen_font_roman "-*-naskhi"