1 ### This file is part of
2 ### =====================================================
4 ### LyX, the High Level Word Processor
6 ### Copyright 1995-1997 Matthias Ettrich & the LyX Team
8 ### =====================================================
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
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
22 # BIND SECTION ###########################################################
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:
31 # cua.bind for Windows-, Mac- and Motif-like bindings
32 # emacs.bind for Emacs-like bindings.
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'.
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"
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
52 #\bind_file mine_is_best
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
61 # Tip: Use "lyx -dbg 4" to survey how LyX interprets your keybindings.
65 # MISC SECTION ###########################################################
68 # Set this to false if you don't want the startup banner.
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
76 # This is the time interval between auto-saves (in seconds).
77 # 0 means no auto-save, default is 300 for five minutes.
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
86 # LyX continously displays names of last command executed, along with a list
87 # of defined short-cuts for it in the minibuffer.
88 # It requires some horsepower to function, so you can turn it off, if LyX
89 # seems slow to you, by uncommenting this line:
90 #\display_shortcuts false
92 # Define which program to use to view dvi files here.
93 # You can include any options you need by "quoting" the entire command.
94 # The default is "xdvi".
95 # Example: the next line would use xdvi and display with shrink 2:
96 #\view_dvi_command "xdvi -s 2"
97 # It can get more involved. Expert users might prefer something like:
98 #\view_dvi_command "xdvi -s 2 -expert -geometry 1014x720+0+0 -keep -margins 1.5"
100 # \view_dvi_paper_option allows to specify a paper option to the dvi
101 # viewer. By default LyX specifies the paper size of the document to
102 # the dvi viewer via the command line option -paper size, where size
103 # is one of "us","letter","a3","a4" and so on. The command
104 # \view_dvi_paper_option allows the user to overwrite the name of the
105 # command line flag, i.e. replace -paper with something else. If
106 # specified and left empty, i.e. \view_dvi_paper_option "", LyX does
107 # not append the -paper option to the dvi command at all. This case is
108 # especially useful when viewing your documents on Windows with yap,
109 # because yap does not allow a command line option for the paper size.
110 #\view_dvi_paper_option ""
112 # LyX assumes that the default papersize should be usletter. If this is not
113 # true for your site, use the next line to specify usletter, legal,
114 # executive, a3, a4, a5, or b5 as the default papersize.
115 #\default_papersize "a4"
117 # Define which program to use to view pdf files here.
118 # You can include any options you need by "quoting" the entire command
119 # The default is auto-detected, but you might want to override it.
120 # Usual values are: xpdf, acroread, gv, ghostscript.
121 #\view_pdf_command "xpdf"
123 # Define which program to use to view postscript files here.
124 # You can include any options you need by "quoting" the entire command
125 # The default is auto-detected, but you might want to override it.
126 # It is possible to get nice anti-aliased text (slower, but as nice as
127 # xdvi) by using something like
128 #\view_ps_command "ghostview -swap -sDEVICE=x11alpha"
130 # Define which program to use to full screen view included postscript
131 # pictures. You can not include any options. The default is auto-detected.
132 #\view_pspic_command ghostview
134 # Define which program to use to use as postscript interpreter for included
136 # You can not include any options. The default is "gs" if it can be found.
137 # If you have a slow computer, you should consider turning off the WYSIWYG
138 # display of includes images, by using this command:
141 # Define which program to use to run "chktex".
142 # You should include options that turn different warnings on and off.
143 # Default is "chktex -n1 -n3 -n6 -n9 -n22 -n25 -n30 -n38"
144 # Check the ChkTeX documentation for info on what the flags mean.
145 # Example: use this to ignore warnings about using "\ldots" instead of "..."
146 #\chktex_command "chktex -n11 -n1 -n3 -n6 -n9 -22 -n25 -n30 -n38"
148 # Define which program to use to translate latex to HTML.
149 # You should include options. The default is autodetected: the programs
150 # checked are tth, latex2html and hevea, and the default command lines
152 #\html_command "tth -t < '$$FName' > '$$OutName'"
153 #\html_command "latex2html -no_subdir -split 0 -show_section_numbers '$$FName'"
154 #\html_command "hevea -s '$$FName'"
155 # The variable name $$FName is replaced with the name of the .tex
156 # file, and $$OutName is replaced with the name of the html file.
157 # Example: use this to let math be italic with tth.
158 #\html_command "tth -t -i < '$$FName' > '$$OutName'"
160 # Keyboard Mapping. Use this to set the correct mapping file for your
161 # keyboard, that is if you need one. You'll need one if you for instance
162 # want to type German documents on an American keyboard. In that case,
163 # uncomment these three lines:
165 #\kbmap_primary german
166 #\kbmap_secondary american
167 # The following keyboards are supported: american, czech, francais,
168 # french, german, german-2, magyar, magyar-2, portuges, romanian,
169 # slovak, slovene, transilvanian, turkish and turkish-f. Check
170 # the lib/kbd directory if you want to write support for your language.
171 # If you do, please submit it to lyx-devel@lists.lyx.org.
173 # The Pause button is defined to be a three-way switch between primary
174 # keyboard, secondary keyboard, and no keyboard mapping with the
175 # following command. It is useful if you want to write in a language
176 # not directly supported by your keyboard and you have defined a
177 # custom keyboard mapping above.
178 #\bind "Pause" "keymap-toggle"
180 # This starts the lyxserver. The pipes get an additional extension
181 # '.in' and '.out'. Only for advanced users.
182 # \serverpipe "/home/chb/.lyxpipe"
184 # Which command to use to invoke the reLyX script to convert
185 # LaTeX files to LyX files. This setting is automatically
186 # disabled if you do not have the appropriate Perl version
187 # installed. In that case, the File->Import LaTeX command
188 # will be disabled. If the reLyX command does work for you,
189 # you can override that here by uncommenting this line:
190 #\relyx_command "reLyX"
192 # If it doesn't work, you can disable the command by uncommenting
194 #\relyx_command "none"
197 # SCREEN & FONTS SECTION #################################################
200 # DPI (dots per inch) of your monitor is auto-detected by LyX. If that goes
201 # wrong, you can override the setting here:
204 # The zoom percentage for screen fonts.
205 # A setting of 100% will make the fonts roughly the same size as on paper.
206 # However, since a screen is wider than a piece of paper, the default setting
210 # The wheel movement factor (for mice with wheels or five button mice)
211 # Default is 100, about a page down. A value of 10 give me about a line and
215 # LyX normally doesn't update the cursor position if you move the scrollbar.
216 # If you scroll the cursor off the screen and then start typing LyX will
217 # move you back to where the cursor was. If you'd prefer to always have the
218 # cursor on screen, bounded by the topmost and bottommost visible lines
219 # -- much like XEmacs for example -- then uncomment the next line.
220 #\cursor_follows_scrollbar true
222 # The screen fonts used to display the text while editing
224 #\screen_font_roman "-*-times"
225 #\screen_font_sans "-*-helvetica"
226 #\screen_font_typewriter "-*-courier"
228 # For some, this font looks better:
229 #\screen_font_roman "-*-utopia"
231 # Allow the use of scalable screen fonts? Default is true.
232 # If you choose "false", LyX will use the closest existing size for a match.
233 # Use this if the scalable fonts look bad and you have many fixed size fonts.
234 #\screen_font_scalable false
236 # Tip: Run lyx as "lyx -dbg 512" to learn which fonts are used.
238 # The norm for the screen fonts. The default is iso8859-1, which is
239 # the same as what LaTeX calls latin1.
240 #\screen_font_encoding iso8859-2
242 # The font for popups. It is set to
243 # <font_popup>-*-*-*-?-*-*-*-*-<font_encoding>.
245 #\screen_font_popup "-*-helvetica-medium-r"
247 # The font for menus (and groups titles in popups). It is set to
248 # <font_menu>-*-*-*-?-*-*-*-*-<font_encoding>.
250 #\screen_font_menu "-*-helvetica-bold-r"
252 # The font sizes used for calculating the scaling of the screen fonts.
253 # You should only have to change these if the fonts on your screen look bad,
254 # in which case you can fine tune the font selection size by size. LyX selects
255 # font size according to this table, the monitor DPI setting and the current
258 #\screen_font_sizes tiny smallest smaller small normal large larger largest huge huger
260 # This is the default in LyX (exactly what LaTeX does):
261 #\screen_font_sizes 5.0 7.0 8.0 9.0 10.0 12.0 14.4 17.28 20.74 24.88
263 # To change the colors for footnotes:
264 #\set_color footnote green
265 # for mathed you may also want to change the coloring of lines and brackets:
266 #\set_color math yellow
267 #\set_color mathlines yellow
270 # TOOLBAR SECTION ########################################################
273 # Setup your favorite Toolbar here:
274 # Only three commands are allowed inside the begin_toolbar and end_toolbar
276 # \add <action> [<parameter>] adds an icon to the toolbar performing
277 # "<action> <parameter>"
279 # \add font-size small
282 # \layouts adds the layouts combo-box to the toolbar
284 # \separator adds some spacing to the toolbar
286 # These actions have icons (please give us more :-):
287 # buffer-open, buffer-close, buffer-print, buffer-write, font-emph,
288 # font-noun, font-free, footnote-insert, depth-next, copy, cut, paste,
289 # tex-mode, math-mode, marginpar-insert, figure-insert, table-insert,
290 # melt, lyx-quit, buffer-export ascii|latex, font-bold, font-sans,
291 # buffer-typeset, buffer-view, buffer-view-ps, symbol_insert [parameter]
293 # All other lyx commands will get a "unknown" icon.
295 # This is the default toolbar:
310 #\add footnote-insert
311 #\add marginpar-insert
322 # PRINTER SECTION ########################################################
325 # The default printer to print on. If none is specified, LyX will use
326 # the environment variable PRINTER. If that fails, the default is empty.
329 # If you have setup (as we recommend you to do) your print program
330 # (e.g. dvips) to take advantage of the particularities of the various
331 # printers you have access to, then you should set the following to
332 # true. Then LyX will pass the name of the destination printer to your
334 # The default is false, because we have unfortunately to cope with
335 # people who refuse to take the time to configure their system.
336 # Note that you will probably have to change \print_spool_command below.
337 #\print_adapt_output true
339 # If you don't use dvips, you may specify your favorite print program
340 # here. See other options at the end of this section to adapt LyX to
341 # your print program.
342 #\print_command dvips
344 # Extra options to pass to printing program after everything
345 # else, but before the filename of the DVI file to be printed.
346 #\print_extra_options ""
348 # When set, this printer option automatically prints to a file
349 # and then calls a separate print spooling program on that file
350 # with the given name and arguments.
351 # This is set by default to 'lp' or 'lpr', depending on what your
353 # Set this to "" if you have set up dvips so that it sends
354 # output to the right printer (remember to also use \print_adapt_output).
355 #\print_spool_command ""
357 # If you specify a printer name in the print dialog,
358 # the following argument is prepended along with the printer name
359 # after the spool command. The default is autodetected, along with
360 # \print_spool_command determination.
361 #\print_spool_printerprefix ""
363 # Other print related options
365 # The following options are only of interest to people who do not
366 # use dvips as print command. You may safely skip to the end of this
369 # These specify the options to pass to the printer program to select the
370 # corresponding features. These default to the options used for the dvips
371 # program. Look at the man page for your favorite print program to learn
372 # which options to use.
373 # Normally you don't need to change this unless you use something other
375 #\print_evenpage_flag -B
376 #\print_oddpage_flag -A
377 #\print_reverse_flag -r
378 #\print_landscape_flag "-t landscape"
379 #\print_pagerange_flag -pp
380 #\print_copies_flag -c
381 #\print_collcopies_flag -C
382 #\print_paper_flag -t
383 #\print_paper_dimension_flag -T
385 # Option to pass to the print program to print on a specific printer.
386 #\print_to_printer -P
388 # Option to pass to the print program to print to a file.
391 # Extension of printer program output file. Usually .ps
392 #\print_file_extension .ps
394 # Sample configuration to use with dvilj4 for a HP Laserjet IV (or
395 # better) printer [provided by Reuben Thomas <rrt@sc3d.org>]:
396 #\print_command dvilj4
397 #\print_extra_options -q
398 #\print_evenpage_flag "-D2 -r"
399 #\print_oddpage_flag -D1
400 #\print_reverse_flag -r
401 #\print_landscape_flag -l
402 #\print_pagerange_flag -p
404 #\print_file_extension .lj
405 #\print_copies_flag -c
406 #\print_collcopies_flag -c
407 #\print_adapt_output false
411 # EXPORT SECTION ########################################################
415 # With this you can send a LyX-Document to a User-defined program. You
416 # can specify by adding the tag $$FName where the filename should be
417 # put on the defined command. if no $$FName is specified the file is
418 # sent in standard input (stdin). There is no default command
419 # specified. Example:
420 #\custom_export_command "kghostview $$FName"
422 # A more elaborate example to create pdf files with ps2pdf would be:
423 #\custom_export_command "ps2pdf '$$FName' `basename '$$FName' .ps_tmp`.pdf"
426 # This is the default for the type of contents to be sent to the export
427 # command: possible values are lyx, dvi, tex, ps and ascii.
428 #\custom_export_format ps
431 # TEX SECTION ###########################################################
434 # LyX tries to auto-detect which command to use to invoke LaTeX(2e).
435 # If the auto-detection for some reasons fail, you can override it
437 #\latex_command latex2e
439 # The command used to generate pdf files directly from a latex file.
440 # A program that works in anyother way is not guarantied to work.
441 #\pdflatex_command pdflatex
443 # The command used to generate postscript files from pdf files.
444 #\pdf_to_ps_command pdf2ps
446 # If to use pdf as native export format instead of dvi. This makes LyX use
447 # pdflatex, pdf2ps and other utility programs. Default is false.
450 # The font encoding used for the LaTeX2e fontenc package.
451 # T1 is highly recommended for non-English languages. LyX uses T1 as a
452 # default if you have the ec fonts installed on your system.
454 # Choose "default" if T1 doesn't work for you for some reason:
455 #\font_encoding default
459 # LINUXDOC SECTION #######################################################
462 # If you want to pass extra flags to the LinuxDoc sgml scripts, insert them
464 # Example: the next line activates iso-latin1 support:
465 #\linuxdoc_to_latex_command "sgml2latex -c latin"
467 # Here you have the command to convert from linuxdoc to html.
468 # Example: one html file only.
469 #\linuxdoc_to_html_command "sgml2html -s 0 '$$FName'"
471 # The LinuxDoc to LyX converter
472 #\linuxdoc_to_lyx_command "sgml2lyx"
475 # DOCBOOK SECTION ########################################################
478 # Command to convert a docbook file to dvi
479 #\docbook_to_dvi_command "sgmltools -b dvi"
481 # Command to convert a docbook file to html
482 #\docbook_to_html_command "sgmltools -b html '$$FName'"
484 # Command to convert a docbook file to pdf
485 #\docbook_to_pdf_command ""
489 # FILE SECTION ##########################################################
492 # The default path for your documents.
494 #\document_path ~/Documents/
496 # The file where the last-files information should be stored.
497 # Default is ~/.lyx/lastfiles
498 #\lastfiles ~/.lyx_lastfiles
500 # Maximal number of lastfiles. Up to nine can appear in the file menu.
504 # Flag telling whether the lastfiles should be checked for existence.
505 # Files that does not exist are left out of the lastfiles entries.
506 # Default is true. If you use slow or removable media, such as networks
507 # or floppy disks, you can speed up the starting time of LyX by disabling
509 #\check_lastfiles false
511 # The path that LyX will set when offering you to choose a template.
512 # Default is (System LyX dir)/templates
513 #\template_path ~/.lyx/templates
515 # The path that LyX will use to put temporary TeX outputs.
516 # Default is /tmp/<unique directory for each instance of LyX>
517 # containing <unique subdirectory for each buffer>
518 # If you set it, it will be /directory/<unique subdirectory for each buffer>
519 # (unless set to /tmp).
520 #\tempdir_path /usr/tmp
522 # If you set this flag, LyX will always use a temporary directory
523 # to put TeX outputs into. It is enabled by default.
524 # This directory is deleted when you quit LyX.
525 # You might want to avoid using a temporary directory in several
527 # - LaTeX cannot find some files it needs;
528 # - you have a large number of include files, and you get messages
529 # saying that some LaTeX buffers overflow.
530 # Note that, even if tell LyX not to use a temporary directory, there
531 # will be cases where it will be forced to: this happens for example
532 # when typesetting a file in a read-only directory (documentation).
535 # This is the maximum line length of an exported ASCII file (LaTeX,
536 # SGML or plain text). Default is 75.
539 # Set to false if you don't want LyX to create backup files.
543 # The path for storing backup files. If it is the empty string, LyX will
544 # store the backup file in the same directory of the original file.
546 #\backupdir_path "~/Desktop/Trash/"
550 # FAX SECTION #############################################################
553 # In the following, the <$$something> strings are substituted by
554 # reasonable values by LyX. The 's are important as there may be spaces in
555 # the string. The default is auto-detected.
556 # This one is what is used with HylaFax:
557 #\fax_command "sendfax -n -h '$$Host' -c '$$Comment' -x '$$Enterprise' -d '$$Name'@'$$Phone' '$$FName'"
558 # Use this for the efax-command:
559 #\fax_command "faxsend '$$Phone' '$$FName'"
561 # This is the name of your phone book. It's per default situated in ~/.lyx/,
562 # but you can override that with an absolute path.
563 #\phone_book phonebook
565 # This is how to call an external FAX-program instead of the built-in.
566 # You may also insert $$FName to reference the PostScript file.
567 #\fax_program "myfaxprg '$$FName'"
568 #\fax_program tkhylafax
571 # ASCII EXPORT SECTION ###################################################
574 # The following entry can be used to define an external program to
575 # render tables in the ASCII output. If you specify "none", a simple
576 # internal routine is used. The default is auto-detected.
577 # The following line will use groff and output using latin-1 encoding
578 # (here $$FName is the input file and the output goes to stdout):
579 #\ascii_roff_command "groff -t -Tlatin1 $$FName"
582 # SPELLCHECKER SECTION ####################################################
585 # What command runs the spell checker? Default is "ispell" if it is
586 # installed, "none" otherwise.
587 # If you have aspell (http://metalab.unc.edu/kevina/aspell/)
588 # installed and configured, you might want to uncomment the line below.
589 #\spell_command aspell
591 # Consider run-together words, such as "notthe" for "not the", as legal
592 # words? Default is false.
593 #\accept_compound true
595 # Specify an alternate language. The default is to use the language of
596 # document. Uncomment both to enable.
597 #\use_alt_language true
598 #\alternate_language dansk
600 # Specify additional chars that can be part of a word.
601 #\use_escape_chars true
602 #\escape_chars "æøåÆØÅ"
604 # Specify an alternate personal dictionary file. If the file name does not
605 # begin with "/", $HOME is prefixed. The default is to search for a personal
606 # dictionary in both the current directory and $HOME, creating one in $HOME
607 # if none is found. The preferred name is constructed by appending ".ispell_"
608 # to the base name of the hash file. For example, if you use the English
609 # dictionary, your personal dictionary would be named ".ispell_english".
610 #\use_personal_dictionary true
611 #\personal_dictionary .ispell_dansk
613 # Specify whether to pass the -T input encoding option to ispell (only if the
614 # language is different than "default".) Enable this if you can't spellcheck
615 # words with international letters in them. There have been reports that this
616 # does not work with all dictionaries, so this is disabled by default.
617 #\use_input_encoding true
619 # Default format string for the date-insert command
621 # This accepts the normal strftime formats; see man strftime for full
622 # details of the format.
624 #\date_insert_format "%A, %e. %B %Y"
627 # LANGUAGE SUPPORT SECTION ####################################################
630 # Set to true to enable support of right-to-left languages (e.g. Hebrew,
631 # Arabic). Default is false.
634 # The latex command for loading the language package.
635 # Default is \usepackage{babel}.
636 #\language_package "\usepackage{omega}"
638 # The latex command for changing the from the language of the document
639 # to another language. $$lang is substituted by the name of the second
640 # language. Default is \selectlanguage{$$lang}.
641 #\language_command_begin "\begin{otherlanguage}{$$lang}"
643 # The latex command for changing back the language to the language of
644 # the document. Default is \selectlanguage{$$lang}.
645 #\language_command_end "\end{otherlanguage}"
647 # Set to false if a language switching command is needed at the beginning of
648 # the document. Default is true.
649 #\language_auto_begin false
651 # Set to false if a language switching command is needed at the end of
652 # the document. Default is true.
653 #\language_auto_end false
655 # Set mark_foreign_language to "false" to disable the highlighting of words
656 # with a foreign language to the language of the documet.
658 #\mark_foreign_language false
661 # HEBREW SUPPORT SECTION ####################################################
664 # To enable the Hebrew support, uncommnet the following lines:
668 #\kbmap_secondary hebrew
669 #\latex_command elatex
670 #\font_encoding default
672 # You also need to bind a key for switching between Hebrew and English.
674 #\bind "F12" "language hebrew"
676 # You might want ot disable the foreign language marking:
677 #\mark_foreign_language false
679 # Finally, you need to select iso8859-8 font encoding, and select screen fonts
680 # (below are the default fonts. You need to replace them by Hebrew fonts)
681 #\screen_font_encoding iso8859-8
682 #\screen_font_roman "-*-times"
683 #\screen_font_sans "-*-helvetica"
684 #\screen_font_typewriter "-*-courier"
685 #\screen_font_popup "-*-helvetica-medium-r"
686 #\screen_font_menu "-*-helvetica-bold-r"
689 # ARABIC SUPPORT SECTION ####################################################
692 # To enable the Arabic support, uncommnet the following lines:
696 #\kbmap_secondary arabic
698 # You also need to bind a key for switching between Arabic and English.
700 #\bind "F12" "language arabic"
702 # If you use arabtex, uncomment the following lines
703 #\language_auto_begin false
704 #\language_auto_end false
705 #\language_command_begin "\begin{arabtext}"
706 #\language_command_end "\end{arabtext}"
707 #\language_package "\usepackage{arabtex,iso88596}\setcode{iso8859-6}"
709 # Finally, you need to select iso8859-6.8x font encoding,
710 # and select screen fonts.
711 # iso8859-6.8x fonts can be found at
712 # http://www.langbox.com/AraMosaic/mozilla/fontXFE/
713 #\screen_font_encoding iso8859-6.8x
714 #\screen_font_encoding_menu iso8859-1
715 #\screen_font_roman "-*-naskhi"