X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=lib%2Flyxrc.example;h=a78fa333c0bb77963e8cd6c4d0451b21a4c27232;hb=fb1e227a93a394bcc56be0edacd7001679b5044f;hp=82e96da2df35dff3054350585d410d4464b889b5;hpb=f4b8943ebb264c92b86a9756f9ae02b76552b347;p=lyx.git diff --git a/lib/lyxrc.example b/lib/lyxrc.example index 82e96da2df..a78fa333c0 100644 --- a/lib/lyxrc.example +++ b/lib/lyxrc.example @@ -1,13 +1,20 @@ -### This file is part of -### ===================================================== -### -### LyX, the High Level Word Processor -### -### Copyright 1995-1997 Matthias Ettrich & the LyX Team -### -### ===================================================== - -# The file lyxrc.example is a template to write your own lyxrc file. +# -*- text -*- + +# file lyxrc.example +# This file is part of LyX, the document processor. +# Licence details can be found in the file COPYING. + +# author Lars Gullik Bjønnes +# author Jean-Marc Lasgouttes +# author José Matos +# author Asger Alstrup Nielsen +# author Ed Scott +# author Lior Silberman +# author Dekel Tsur + +# Full author contact details are available in file CREDITS. + +# The file lyxrc.example is a template to write your own lyxrc file. # If you copy/rename it to lyxrc in the current directory, it will # give global options for all LyX users. It is also possible to copy # this file to $HOME/.lyx/lyxrc so that the configuration applies to a @@ -31,7 +38,7 @@ # cua.bind for Windows-, Mac- and Motif-like bindings # emacs.bind for Emacs-like bindings. # -# The \bind_file command looks in the LyX bind directory for a file +# The \bind_file command looks in the LyX bind directory for a file # of the given name, but a full path can also be given. If you have # a bind file in your ~/.lyx/bind/ directory, it will be preferred # over a system wide bind file. Default is `cua'. @@ -47,7 +54,7 @@ # However, if you're not at all happy with the default bindings, # the most logical thing to do would be to use one of the system # wide bind files as a template and place your own version in -# ~/.lyx/bind/mine_is_best.bind and change the above \bind_file +# ~/.lyx/bind/mine_is_best.bind and change the above \bind_file # to this instead: #\bind_file mine_is_best @@ -77,26 +84,23 @@ # 0 means no auto-save, default is 300 for five minutes. #\autosave 600 -# LyX asks for a second confirmation to exit if you exit with changed -# documents that you don't want to save. You can turn this confirmation off +# LyX asks for a second confirmation to exit if you exit with changed +# documents that you don't want to save. You can turn this confirmation off # (LyX will still ask to save changed documents) with the following line. # We recommend to keep the confirmation, though. #\exit_confirmation false -# LyX continously displays names of last command executed, along with a list +# This sets the behaviour if you want to be asked for a filename when +# creating a new document or wait until you save it and be asked then. +# The default for now is ask on save. +# \new_ask_filename false + +# LyX continously displays names of last command executed, along with a list # of defined short-cuts for it in the minibuffer. # It requires some horsepower to function, so you can turn it off, if LyX # seems slow to you, by uncommenting this line: #\display_shortcuts false -# Define which program to use to view dvi files here. -# You can include any options you need by "quoting" the entire command. -# The default is "xdvi". -# Example: the next line would use xdvi and display with shrink 2: -#\view_dvi_command "xdvi -s 2" -# It can get more involved. Expert users might prefer something like: -#\view_dvi_command "xdvi -s 2 -expert -geometry 1014x720+0+0 -keep -margins 1.5" - # \view_dvi_paper_option allows to specify a paper option to the dvi # viewer. By default LyX specifies the paper size of the document to # the dvi viewer via the command line option -paper size, where size @@ -107,38 +111,13 @@ # not append the -paper option to the dvi command at all. This case is # especially useful when viewing your documents on Windows with yap, # because yap does not allow a command line option for the paper size. -#\view_dvi_paper_option "" +#\view_dvi_paper_option "" # LyX assumes that the default papersize should be usletter. If this is not # true for your site, use the next line to specify usletter, legal, # executive, a3, a4, a5, or b5 as the default papersize. #\default_papersize "a4" -# Define which program to use to view pdf files here. -# You can include any options you need by "quoting" the entire command -# The default is auto-detected, but you might want to override it. -# Usual values are: xpdf, acroread, gv, ghostscript. -# Warning: This option is not functional! -#\view_pdf_command "xpdf" - -# Define which program to use to view postscript files here. -# You can include any options you need by "quoting" the entire command -# The default is auto-detected, but you might want to override it. -# It is possible to get nice anti-aliased text (slower, but as nice as -# xdvi) by using something like -#\view_ps_command "ghostview -swap -sDEVICE=x11alpha" - -# Define which program to use to full screen view included postscript -# pictures. You can not include any options. The default is auto-detected. -#\view_pspic_command ghostview - -# Define which program to use to use as postscript interpreter for included -# images. -# You can not include any options. The default is "gs" if it can be found. -# If you have a slow computer, you should consider turning off the WYSIWYG -# display of includes images, by using this command: -#\ps_command "" - # Define which program to use to run "chktex". # You should include options that turn different warnings on and off. # Default is "chktex -n1 -n3 -n6 -n9 -n22 -n25 -n30 -n38" @@ -146,18 +125,6 @@ # Example: use this to ignore warnings about using "\ldots" instead of "..." #\chktex_command "chktex -n11 -n1 -n3 -n6 -n9 -22 -n25 -n30 -n38" -# Define which program to use to translate latex to HTML. -# You should include options. The default is autodetected: the programs -# checked are tth, latex2html and hevea, and the default command lines -# used are: -#\html_command "tth -t < '$$FName' > '$$OutName'" -#\html_command "latex2html -no_subdir -split 0 -show_section_numbers '$$FName'" -#\html_command "hevea -s '$$FName'" -# The variable name $$FName is replaced with the name of the .tex -# file, and $$OutName is replaced with the name of the html file. -# Example: use this to let math be italic with tth. -#\html_command "tth -t -i < '$$FName' > '$$OutName'" - # Keyboard Mapping. Use this to set the correct mapping file for your # keyboard, that is if you need one. You'll need one if you for instance # want to type German documents on an American keyboard. In that case, @@ -171,7 +138,7 @@ # the lib/kbd directory if you want to write support for your language. # If you do, please submit it to lyx-devel@lists.lyx.org. -# The Pause button is defined to be a three-way switch between primary +# The Pause button is defined to be a three-way switch between primary # keyboard, secondary keyboard, and no keyboard mapping with the # following command. It is useful if you want to write in a language # not directly supported by your keyboard and you have defined a @@ -182,18 +149,6 @@ # '.in' and '.out'. Only for advanced users. # \serverpipe "/home/chb/.lyxpipe" -# Which command to use to invoke the reLyX script to convert -# LaTeX files to LyX files. This setting is automatically -# disabled if you do not have the appropriate Perl version -# installed. In that case, the File->Import LaTeX command -# will be disabled. If the reLyX command does work for you, -# you can override that here by uncommenting this line: -#\relyx_command "reLyX" -# -# If it doesn't work, you can disable the command by uncommenting -# this line: -#\relyx_command "none" - # Default format string for the date-insert command # # This accepts the normal strftime formats; see man strftime for full @@ -201,16 +156,24 @@ # #\date_insert_format "%A, %e. %B %Y" + +# Maximum number of words in the initialization string for a new label. +# If it is set to 0, then the init. string will only contain the prefix +# (e.g. "sec:"). If it is set to -1, the init. string will be empty. +# This feature is disabled in 1.1.6. +# +#\label_init_length 0 + # # SCREEN & FONTS SECTION ################################################# # -# DPI (dots per inch) of your monitor is auto-detected by LyX. If that goes +# DPI (dots per inch) of your monitor is auto-detected by LyX. If that goes # wrong, you can override the setting here: #\screen_dpi 100 # The zoom percentage for screen fonts. -# A setting of 100% will make the fonts roughly the same size as on paper. +# A setting of 100% will make the fonts roughly the same size as on paper. # However, since a screen is wider than a piece of paper, the default setting # is 150%. #\screen_zoom 100 @@ -222,8 +185,8 @@ # LyX normally doesn't update the cursor position if you move the scrollbar. # If you scroll the cursor off the screen and then start typing LyX will -# move you back to where the cursor was. If you'd prefer to always have the -# cursor on screen, bounded by the topmost and bottommost visible lines +# move you back to where the cursor was. If you'd prefer to always have the +# cursor on screen, bounded by the topmost and bottommost visible lines # -- much like XEmacs for example -- then uncomment the next line. #\cursor_follows_scrollbar true @@ -247,21 +210,26 @@ # the same as what LaTeX calls latin1. #\screen_font_encoding iso8859-2 -# The font for popups. It is set to +# The norm for the popup fonts. The default is an empty string, which +# causes to use the screen fonts norm (defined by \screen_font_encoding). +#\popup_font_encoding iso8859-2 + + +# The normal font for popups. It is set to # -*-*-*-?-*-*-*-*-. # The default is: -#\screen_font_popup "-*-helvetica-medium-r" +#\popup_font_name "-*-helvetica-medium-r" -# The font for menus (and groups titles in popups). It is set to +# The bold font for popups. It is set to # -*-*-*-?-*-*-*-*-. # The default is: -#\screen_font_menu "-*-helvetica-bold-r" +#\popup_bold_font "-*-helvetica-bold-r" # The font sizes used for calculating the scaling of the screen fonts. # You should only have to change these if the fonts on your screen look bad, # in which case you can fine tune the font selection size by size. LyX selects # font size according to this table, the monitor DPI setting and the current -# zoom setting. +# zoom setting. # The format is: #\screen_font_sizes tiny smallest smaller small normal large larger largest huge huger # @@ -278,7 +246,7 @@ # UI SECTION ######################################################## # -# Choose your UI (user interface) definition here. The .ui files are in the +# Choose your UI (user interface) definition here. The .ui files are in the # directory "lib/ui" and contains the definition of the menu and the toolbar. #\ui_file "default" @@ -305,15 +273,15 @@ # your print program. #\print_command dvips -# Extra options to pass to printing program after everything +# Extra options to pass to printing program after everything # else, but before the filename of the DVI file to be printed. #\print_extra_options "" -# When set, this printer option automatically prints to a file +# When set, this printer option automatically prints to a file # and then calls a separate print spooling program on that file # with the given name and arguments. # This is set by default to 'lp' or 'lpr', depending on what your -# system uses. +# system uses. # Set this to "" if you have set up dvips so that it sends # output to the right printer (remember to also use \print_adapt_output). #\print_spool_command "" @@ -321,7 +289,7 @@ # If you specify a printer name in the print dialog, # the following argument is prepended along with the printer name # after the spool command. The default is autodetected, along with -# \print_spool_command determination. +# \print_spool_command determination. #\print_spool_printerprefix "" # Other print related options @@ -335,10 +303,10 @@ # program. Look at the man page for your favorite print program to learn # which options to use. # Normally you don't need to change this unless you use something other -# than dvips. +# than dvips. #\print_evenpage_flag -B #\print_oddpage_flag -A -#\print_reverse_flag -r +#\print_reverse_flag -r #\print_landscape_flag "-t landscape" #\print_pagerange_flag -pp #\print_copies_flag -c @@ -350,7 +318,7 @@ #\print_to_printer -P # Option to pass to the print program to print to a file. -#\print_to_file -o +#\print_to_file -o # Extension of printer program output file. Usually .ps #\print_file_extension .ps @@ -361,7 +329,7 @@ #\print_extra_options -q #\print_evenpage_flag "-D2 -r" #\print_oddpage_flag -D1 -#\print_reverse_flag -r +#\print_reverse_flag -r #\print_landscape_flag -l #\print_pagerange_flag -p #\print_to_file -e @@ -370,50 +338,65 @@ #\print_collcopies_flag -c #\print_adapt_output false - # # EXPORT SECTION ######################################################## # - -# With this you can send a LyX-Document to a User-defined program. You -# can specify by adding the tag $$FName where the filename should be -# put on the defined command. if no $$FName is specified the file is -# sent in standard input (stdin). There is no default command -# specified. Example: -#\custom_export_command "kghostview $$FName" -# -# A more elaborate example to create pdf files with ps2pdf would be: -#\custom_export_command "ps2pdf '$$FName' `basename '$$FName' .ps_tmp`.pdf" - - -# This is the default for the type of contents to be sent to the export -# command: possible values are lyx, dvi, tex, ps and ascii. -#\custom_export_format ps +# The \converter command defines a converter between two formats. +# LyX uses the defined converters for generating output in various formats, +# or for importing. +# The converter command has 4 arguments: The source format, the target format, +# the command, and additional flags. +# For example, the following defines a DVI->Postscript converter: +#\converter dvi ps "dvips -o $$o $$i" "" +# The variable name $$i is replaced with the name of the source file, +# and $$o is replaced with the name of the target file. +# The flags argument is a list of comma separated flags. +# Known flags are +# - * : copy the previously defined flags +# - latex : The converter is latex or its derivatives (pdflatex). +# - originaldir : The converter must be invoked in the directory of the lyx +# file and not in the temporary directory. This is needed for tex->html +# converters in order to be able to read the eps files. +# - needaux : The converted uses the .aux file, so we need to call latex +# before running the converter. +# - resultdir=dir : The converter put all the files in dir. +# Using "resultdir" is same as "resultdir=$$b". +# Note: When exporting, the whole directory will be moved from the temporary +# directory to the target directory. +# - resultfile=file : Name of main file in the result directory, for example +# "index.html" or "$$b.html" +# If "resultfile" is omitted, the name of this file is assumed to be +# "index.format" +# - parselog=filtername : filtername is a name of a filter command that takes +# the converter error log (from stderr), and converts it to a fake latex .log +# file. +# For example: +#\converter latex html "latex2html -split 0 $$i" +# "originaldir,needaux,resultdir" +# +# For literate programming, use something like +#\converter literate latex "noweave -delay -index $$i >$$o" +# "parselog=listerrors g" +#\converter literate program "build-script $$i" +# "originaldir,parselog=listerrors g" + +# The format command is used to define file formats. It has 4 arguments: +# the format name, the extension, and "pretty name" and menu shortcut. +# For example +#\Format latex tex LaTeX L + +# The \viewer command is used to define viewers for new formats, +# or to change the already defined viewers. +# For example, to use xdvi as the viewer to dvi files use +#\viewer dvi "xdvi" +# It can get more involved. Expert users might prefer something like: +#\viewer dvi "xdvi -s 2 -expert -geometry 1014x720+0+0 -keep -margins 1.5" # # TEX SECTION ########################################################### # -# LyX tries to auto-detect which command to use to invoke LaTeX(2e). -# If the auto-detection for some reasons fail, you can override it -# here: -#\latex_command latex2e - -# The command used to generate pdf files directly from a latex file. -# A program that works in anyother way is not guarantied to work. -# Warning: This option is not functional! -#\pdflatex_command pdflatex - -# The command used to generate postscript files from pdf files. -# Warning: This option is not functional! -#\pdf_to_ps_command pdf2ps - -# If to use pdf as native export format instead of dvi. This makes LyX use -# pdflatex, pdf2ps and other utility programs. Default is false. -# Warning: This option is not functional! -#\pdf_mode false - # The font encoding used for the LaTeX2e fontenc package. # T1 is highly recommended for non-English languages. LyX uses T1 as a # default if you have the ec fonts installed on your system. @@ -421,37 +404,6 @@ # Choose "default" if T1 doesn't work for you for some reason: #\font_encoding default - -# -# LINUXDOC SECTION ####################################################### -# - -# If you want to pass extra flags to the LinuxDoc sgml scripts, insert them -# here. -# Example: the next line activates iso-latin1 support: -#\linuxdoc_to_latex_command "sgml2latex -c latin" - -# Here you have the command to convert from linuxdoc to html. -# Example: one html file only. -#\linuxdoc_to_html_command "sgml2html -s 0 '$$FName'" - -# The LinuxDoc to LyX converter -#\linuxdoc_to_lyx_command "sgml2lyx" - -# -# DOCBOOK SECTION ######################################################## -# - -# Command to convert a docbook file to dvi -#\docbook_to_dvi_command "sgmltools -b dvi" - -# Command to convert a docbook file to html -#\docbook_to_html_command "sgmltools -b html '$$FName'" - -# Command to convert a docbook file to pdf -#\docbook_to_pdf_command "" - - # # FILE SECTION ########################################################## # @@ -471,7 +423,7 @@ # Flag telling whether the lastfiles should be checked for existence. # Files that does not exist are left out of the lastfiles entries. # Default is true. If you use slow or removable media, such as networks -# or floppy disks, you can speed up the starting time of LyX by disabling +# or floppy disks, you can speed up the starting time of LyX by disabling # this feature. #\check_lastfiles false @@ -500,7 +452,7 @@ #\use_tempdir false # This is the maximum line length of an exported ASCII file (LaTeX, -# SGML or plain text). Default is 75. +# SGML or plain text). Default is 75. #\ascii_linelen 80 # Set to false if you don't want LyX to create backup files. @@ -512,34 +464,12 @@ # Default is "". #\backupdir_path "~/Desktop/Trash/" - -# -# FAX SECTION ############################################################# -# - -# In the following, the <$$something> strings are substituted by -# reasonable values by LyX. The 's are important as there may be spaces in -# the string. The default is auto-detected. -# This one is what is used with HylaFax: -#\fax_command "sendfax -n -h '$$Host' -c '$$Comment' -x '$$Enterprise' -d '$$Name'@'$$Phone' '$$FName'" -# Use this for the efax-command: -#\fax_command "faxsend '$$Phone' '$$FName'" - -# This is the name of your phone book. It's per default situated in ~/.lyx/, -# but you can override that with an absolute path. -#\phone_book phonebook - -# This is how to call an external FAX-program instead of the built-in. -# You may also insert $$FName to reference the PostScript file. -#\fax_program "myfaxprg '$$FName'" -#\fax_program tkhylafax - # # ASCII EXPORT SECTION ################################################### # # The following entry can be used to define an external program to -# render tables in the ASCII output. If you specify "none", a simple +# render tables in the ASCII output. If you specify "none", a simple # internal routine is used. The default is auto-detected. # The following line will use groff and output using latin-1 encoding # (here $$FName is the input file and the output goes to stdout): @@ -555,11 +485,11 @@ # installed and configured, you might want to uncomment the line below. #\spell_command aspell -# Consider run-together words, such as "notthe" for "not the", as legal -# words? Default is false. +# Consider run-together words, such as "notthe" for "not the", as legal +# words? Default is false. #\accept_compound true -# Specify an alternate language. The default is to use the language of +# Specify an alternate language. The default is to use the language of # document. Uncomment both to enable. #\use_alt_language true #\alternate_language dansk @@ -569,15 +499,15 @@ #\escape_chars "æøåÆØÅ" # Specify an alternate personal dictionary file. If the file name does not -# begin with "/", $HOME is prefixed. The default is to search for a personal -# dictionary in both the current directory and $HOME, creating one in $HOME -# if none is found. The preferred name is constructed by appending ".ispell_" -# to the base name of the hash file. For example, if you use the English -# dictionary, your personal dictionary would be named ".ispell_english". +# begin with "/", $HOME is prefixed. The default is to search for a personal +# dictionary in both the current directory and $HOME, creating one in $HOME +# if none is found. The preferred name is constructed by appending ".ispell_" +# to the base name of the hash file. For example, if you use the English +# dictionary, your personal dictionary would be named ".ispell_english". #\use_personal_dictionary true #\personal_dictionary .ispell_dansk -# Specify whether to pass the -T input encoding option to ispell (only if the +# Specify whether to pass the -T input encoding option to ispell (only if the # language is different than "default".) Enable this if you can't spellcheck # words with international letters in them. There have been reports that this # does not work with all dictionaries, so this is disabled by default. @@ -618,6 +548,12 @@ # Default is "true" #\mark_foreign_language false +# It is possible to bind keys for changing the language inside a document. +# For example, the following command will cause F12 to switch between French +# and English in a French document, and in a document of other language it will +# switch between that language and French. +#\bind "F12" "language french" + # # HEBREW SUPPORT SECTION #################################################### # @@ -627,7 +563,8 @@ #\kbmap true #\kbmap_primary null #\kbmap_secondary hebrew -#\latex_command elatex +#\converter tex dvi elatex "" +#\converter tex pdf pdfelatex "" #\font_encoding default # You also need to bind a key for switching between Hebrew and English.