lib/doc/FAQ.lyx

   1 #LyX 1.6.0svn created this file. For more info see http://www.lyx.org/
   2 \lyxformat 341
   3 \begin_document
   4 \begin_header
   5 \textclass article
   6 \language english
   7 \inputencoding latin1
   8 \font_roman default
   9 \font_sans default
  10 \font_typewriter default
  11 \font_default_family default
  12 \font_sc false
  13 \font_osf false
  14 \font_sf_scale 100
  15 \font_tt_scale 100
  16
  17 \graphics default
  18 \paperfontsize default
  19 \spacing single
  20 \use_hyperref false
  21 \papersize default
  22 \use_geometry true
  23 \use_amsmath 0
  24 \use_esint 0
  25 \cite_engine basic
  26 \use_bibtopic false
  27 \paperorientation portrait
  28 \leftmargin 3cm
  29 \topmargin 2cm
  30 \rightmargin 3cm
  31 \bottommargin 3cm
  32 \secnumdepth 3
  33 \tocdepth 3
  34 \paragraph_separation indent
  35 \defskip medskip
  36 \quotes_language english
  37 \papercolumns 1
  38 \papersides 1
  39 \paperpagestyle default
  40 \tracking_changes true
  41 \output_changes false
  42 \author "RGH"
  43 \author ""
  44 \end_header
  45
  46 \begin_body
  47
  48 \begin_layout Title
  49 LyX Frequently Asked Questions with Answers
  50 \end_layout
  51
  52 \begin_layout Author
  53 by the LyX Team
  54 \begin_inset Foot
  55 status collapsed
  56
  57 \begin_layout Plain Layout
  58 \noindent
  59 If you have comments or error corrections, please send them to the LyX Documenta
  60 tion mailing list, <
  61 \begin_inset CommandInset href
  62 LatexCommand href
  63 target "lyx-docs@lists.lyx.org"
  64 type "mailto:"
  65
  66 \end_inset
  67
  68 >.
  69 \end_layout
  70
  71 \end_inset
  72
  73
  74 \end_layout
  75
  76 \begin_layout Abstract
  77 This is the list of Frequently Asked Questions for LyX, the Open Source
  78  document processor that provides a What-You-See-Is-What-You-Mean environment
  79  for producing high quality documents.
  80  For further help, you may wish to contact the LyX User Group mailing list
  81  at
  82 \family typewriter
  83
  84 \begin_inset CommandInset href
  85 LatexCommand href
  86 target "lyx-users@lists.lyx.org"
  87 type "mailto:"
  88
  89 \end_inset
  90
  91
  92 \family default
  93
  94 \emph on
  95 after
  96 \emph default
  97  you have read through the docs.
  98
  99 \end_layout
 100
 101 \begin_layout Abstract
 102 \begin_inset CommandInset toc
 103 LatexCommand tableofcontents
 104
 105 \end_inset
 106
 107
 108 \end_layout
 109
 110 \begin_layout Section
 111 Introduction and General Information
 112 \end_layout
 113
 114 \begin_layout Subsection
 115 What is LyX?
 116 \end_layout
 117
 118 \begin_layout Standard
 119 LyX is a program that provides a more modern approach to writing documents
 120  with a computer, an approach that breaks with the obsolete tradition of
 121  the
 122 \begin_inset Quotes eld
 123 \end_inset
 124
 125 typewriter concept.
 126 \begin_inset Quotes erd
 127 \end_inset
 128
 129  It is designed for authors who want professional output quickly with a
 130  minimum of effort without becoming specialists in typesetting.
 131  The job of typesetting is done mostly by the computer, not the author;
 132  with LyX, the author can concentrate on the contents of her writing.
 133 \end_layout
 134
 135 \begin_layout Standard
 136 LyX provides an
 137 \begin_inset Quotes eld
 138 \end_inset
 139
 140 almost-WYSIWYG
 141 \begin_inset Quotes erd
 142 \end_inset
 143
 144  view of the document.
 145
 146 \begin_inset Quotes eld
 147 \end_inset
 148
 149 Almost
 150 \begin_inset Quotes erd
 151 \end_inset
 152
 153  means that the line- and page-breaks are not displayed exactly as they
 154  will appear in the printed document.
 155  However, that's not really necessary, since LyX uses a separate typesetter
 156  program (called LaTeX) to perform the final formatting of your text.
 157  While LyX contains everything it needs to be a comfortable user interface,
 158  the typesetting program contains everything necessary to format text, and
 159  do so very, very well.
 160
 161 \end_layout
 162
 163 \begin_layout Standard
 164 So, line- and page-breaks aren't your problem anymore.
 165  Remembering which number to use for the next subsection isn't your problem
 166  anymore.
 167  Recalling what font you used for all of your section headings isn't your
 168  problem anymore.
 169  You tell LyX (and LaTeX) what
 170 \emph on
 171 kind
 172 \emph default
 173  of document you're editing and what
 174 \emph on
 175 type
 176 \emph default
 177  of paragraph this-or-that text is, the computer can typeset it accordingly.
 178  Of course you can also still do some low-level formatting for fine-tuning.
 179  However, the proper way with LyX is to tell the computer what the text
 180
 181 \emph on
 182 is
 183 \emph default
 184 , not what it should look like.
 185  So, we like to say that LyX gives you WYSIWYM editing (What You See Is
 186  What You
 187 \emph on
 188 Mean
 189 \emph default
 190 ).
 191 \end_layout
 192
 193 \begin_layout Subsection
 194 That's fine, but is it useful?
 195 \end_layout
 196
 197 \begin_layout Standard
 198 Absolutely.
 199  The following type of documents have been produced with LyX:
 200 \end_layout
 201
 202 \begin_layout Itemize
 203 Memos
 204 \end_layout
 205
 206 \begin_layout Itemize
 207 Letters
 208 \end_layout
 209
 210 \begin_layout Itemize
 211 Dissertations (260 pages in a single document, longer using include files)
 212 \end_layout
 213
 214 \begin_deeper
 215 \begin_layout Itemize
 216 for example,
 217 \begin_inset Flex URL
 218 status collapsed
 219
 220 \begin_layout Plain Layout
 221
 222 http://www.fee.uva.nl/scholar/mdw/leuven/thesis.pdf
 223 \end_layout
 224
 225 \end_inset
 226
 227
 228 \end_layout
 229
 230 \end_deeper
 231 \begin_layout Itemize
 232 Lecture notes (133 pages, 27 figures on a 33 MHz 486 machine!)
 233 \end_layout
 234
 235 \begin_layout Itemize
 236 Seminar notebooks (500+ pages)
 237 \end_layout
 238
 239 \begin_layout Itemize
 240 Conference proceedings (Proceedings of the Second Continental Workshop on
 241  the Geoid in Europe, (Finnish Geodetic Institute Report 98:4), 292 pages)
 242 \end_layout
 243
 244 \begin_layout Itemize
 245 Software Documentation (the LyX User Guide is about 120 pages)
 246 \end_layout
 247
 248 \begin_layout Itemize
 249 Books
 250 \end_layout
 251
 252 \begin_deeper
 253 \begin_layout Itemize
 254 see
 255 \begin_inset Flex URL
 256 status collapsed
 257
 258 \begin_layout Plain Layout
 259
 260 http://www.postgresql.org/docs/awbook.html
 261 \end_layout
 262
 263 \end_inset
 264
 265  for an example on PostgreSQL
 266 \end_layout
 267
 268 \begin_layout Itemize
 269 Donnay, J-P., Barnsley, M.J., and Longley, P.A., eds., 2001, Remote Sensing and
 270  Urban Analysis (Taylor and Francis: London).
 271 \end_layout
 272
 273 \begin_layout Itemize
 274 Herbert Voss: Praktische Kryptologie mit Java 286 pages, lots of equations,
 275  tables, figures.
 276  ISBN 3-8311-1458-7
 277 \end_layout
 278
 279 \begin_layout Itemize
 280 Yann Collette and Patrick Siarry, Optimisation multiobjectifs, 2002, Eyrolles
 281 \end_layout
 282
 283 \end_deeper
 284 \begin_layout Itemize
 285 Papers published in the following refereed journals:
 286 \end_layout
 287
 288 \begin_deeper
 289 \begin_layout Itemize
 290 Astronomy & Astrophysics (Suetterlin, P.
 291  1998, A&A, 333, 305; Suetterlin, P.
 292  & Wiehr, E.
 293  1998, A&A, 336, 367)
 294 \end_layout
 295
 296 \begin_layout Itemize
 297 Astronomical Journal (Ressler, M.
 298  E.
 299  & Barsony, M.
 300  2001, AJ, 121, 1098)
 301 \end_layout
 302
 303 \end_deeper
 304 \begin_layout Itemize
 305 Novels (400+ page novel due out in September 2000; an 836 page novel is
 306  currently with an agent)
 307 \end_layout
 308
 309 \begin_layout Itemize
 310 Scripts for plays and movies
 311 \end_layout
 312
 313 \begin_layout Itemize
 314 Business proposals for > $1 M (US)
 315 \end_layout
 316
 317 \begin_layout Subsection
 318 Where do I start?
 319 \end_layout
 320
 321 \begin_layout Standard
 322 The website
 323 \begin_inset Flex URL
 324 status collapsed
 325
 326 \begin_layout Plain Layout
 327
 328 www.lyx.org
 329 \end_layout
 330
 331 \end_inset
 332
 333  is the first place to go for anything related to LyX.
 334  News, examples, downloads, and lots of other stuff is available there.
 335  After you have installed LyX and started it the first time, read the Tutorial
 336  (
 337 \family sans
 338 Help\SpecialChar \menuseparator
 339 Tutorial
 340 \family default
 341 ).
 342  Yes, I really mean that.
 343 \end_layout
 344
 345 \begin_layout Standard
 346 Another basic introductory guide may be found at
 347 \begin_inset Flex URL
 348 status collapsed
 349
 350 \begin_layout Plain Layout
 351
 352 www.bilkent.edu.tr/~robin/lyxguide.pdf
 353 \end_layout
 354
 355 \end_inset
 356
 357
 358 \end_layout
 359
 360 \begin_layout Subsection
 361 Does LyX run on my computer?
 362 \end_layout
 363
 364 \begin_layout Standard
 365 LyX is known to run on the following platforms (and probably a zillion others):
 366 \end_layout
 367
 368 \begin_layout Itemize
 369 Linux distributions: Debian, RedHat, SUSE, Mandrake, Fedora, Ubuntu, Gentoo,
 370  etc
 371 \end_layout
 372
 373 \begin_layout Itemize
 374 Microsoft Window NT, 2000, XP, Vista (Windows 95/98/Me editions are not
 375  supported)
 376 \end_layout
 377
 378 \begin_layout Itemize
 379 MacOSX (starting from 10.1)
 380 \end_layout
 381
 382 \begin_layout Itemize
 383 SparcLinux: RedHat 6.0
 384 \end_layout
 385
 386 \begin_layout Itemize
 387 Sun Solaris 2.6, 2.7
 388 \end_layout
 389
 390 \begin_layout Itemize
 391 Tru64 Unix 4.0f
 392 \end_layout
 393
 394 \begin_layout Itemize
 395 HP-UX
 396 \end_layout
 397
 398 \begin_layout Itemize
 399 OSF1 flore V4.0 1091 alpha
 400 \end_layout
 401
 402 \begin_layout Subsection
 403 How much hard disk space does LyX need?
 404 \end_layout
 405
 406 \begin_layout Standard
 407 Binary size depends on the system, the LyX binary consumes 13 MB of disk
 408  space on Windows, while the supporting files occupy another 25 MB (17 MB
 409  of which is consumed by the docs! You can delete the languages you don't
 410  care about to save some space).
 411  Of course, you do need to have something like teTeX installed which consumes
 412  a mere 115 MB, as well as ghostscript, which is another 10 MB!
 413 \end_layout
 414
 415 \begin_layout Subsection
 416 Is LyX really Open Source?
 417 \end_layout
 418
 419 \begin_layout Standard
 420 Yes.
 421  The freely available GUI toolkit that LyX uses, Qt, although a proprietary
 422  product of Troll Tech, is used in its open source GPL variant.
 423  The LyX source itself is also available under the GPL, so it qualifies.
 424 \end_layout
 425
 426 \begin_layout Section
 427 Internet Resources
 428 \end_layout
 429
 430 \begin_layout Subsection
 431 Where should I look on the World Wide Web for LyX stuff?
 432 \end_layout
 433
 434 \begin_layout Itemize
 435 \begin_inset Flex URL
 436 status open
 437
 438 \begin_layout Plain Layout
 439
 440 www.lyx.org
 441 \end_layout
 442
 443 \end_inset
 444
 445
 446 \end_layout
 447
 448 \begin_layout Itemize
 449 \begin_inset Flex URL
 450 status open
 451
 452 \begin_layout Plain Layout
 453
 454 bugzilla.lyx.org
 455 \end_layout
 456
 457 \end_inset
 458
 459 , if you want to report a bug in LyX.
 460 \end_layout
 461
 462 \begin_layout Subsection
 463 Where can I get LyX material by FTP?
 464 \end_layout
 465
 466 \begin_layout Itemize
 467 ftp.lyx.org in /pub/lyx (also known as ftp.via.ecp.fr)
 468 \end_layout
 469
 470 \begin_layout Subsection
 471 What mailing lists are there?
 472 \end_layout
 473
 474 \begin_layout Itemize
 475 lyx-announce@lists.lyx.org (very low volume), for announcements related to
 476  LyX
 477 \end_layout
 478
 479 \begin_layout Itemize
 480 lyx-users@lists.lyx.org (medium volume), for general usage issues
 481 \end_layout
 482
 483 \begin_layout Itemize
 484 lyx-devel@lists.lyx.org (high volume), for development and debugging issues
 485 \end_layout
 486
 487 \begin_layout Itemize
 488 lyx-docs@lists.lyx.org (excruciatingly low volume), for documentation issues
 489
 490 \end_layout
 491
 492 \begin_layout Standard
 493 Generally, you would send email to lyx-foo-subscribe@lists.lyx.org to subscribe
 494  to these lists or to lyx-foo-unsubscribe@lists.lyx.org to unsubscribe, where
 495
 496 \begin_inset Quotes eld
 497 \end_inset
 498
 499 foo
 500 \begin_inset Quotes erd
 501 \end_inset
 502
 503  is one of
 504 \begin_inset Quotes eld
 505 \end_inset
 506
 507 announce
 508 \begin_inset Quotes erd
 509 \end_inset
 510
 511 ,
 512 \begin_inset Quotes eld
 513 \end_inset
 514
 515 users
 516 \begin_inset Quotes erd
 517 \end_inset
 518
 519 ,
 520 \begin_inset Quotes eld
 521 \end_inset
 522
 523 devel
 524 \begin_inset Quotes erd
 525 \end_inset
 526
 527 , or
 528 \begin_inset Quotes eld
 529 \end_inset
 530
 531 docs
 532 \begin_inset Quotes erd
 533 \end_inset
 534
 535 ; definitely see
 536 \begin_inset Flex URL
 537 status open
 538
 539 \begin_layout Plain Layout
 540
 541 http://www.lyx.org/MailingLists
 542 \end_layout
 543
 544 \end_inset
 545
 546  for the full details.
 547 \end_layout
 548
 549 \begin_layout Subsection
 550 Are the mailing lists archived anywhere?
 551 \end_layout
 552
 553 \begin_layout Standard
 554 Yes.
 555  :-)
 556 \end_layout
 557
 558 \begin_layout Subsection
 559 Okay, wise guy! Where are they archived?
 560 \end_layout
 561
 562 \begin_layout Itemize
 563 Announce:
 564 \begin_inset Flex URL
 565 status open
 566
 567 \begin_layout Plain Layout
 568
 569 http://www.mail-archive.com/lyx-announce@lists.lyx.org/
 570 \end_layout
 571
 572 \end_inset
 573
 574
 575 \end_layout
 576
 577 \begin_layout Itemize
 578 Users:
 579 \begin_inset Flex URL
 580 status open
 581
 582 \begin_layout Plain Layout
 583
 584 http://www.mail-archive.com/lyx-users@lists.lyx.org/
 585 \end_layout
 586
 587 \end_inset
 588
 589
 590 \end_layout
 591
 592 \begin_layout Itemize
 593 Devel:
 594 \begin_inset Flex URL
 595 status open
 596
 597 \begin_layout Plain Layout
 598
 599 http://www.mail-archive.com/lyx-devel@lists.lyx.org/
 600 \end_layout
 601
 602 \end_inset
 603
 604
 605 \end_layout
 606
 607 \begin_layout Section
 608 Compatibility with other word/document processors
 609 \end_layout
 610
 611 \begin_layout Subsection
 612 Can I read/write LaTeX files?
 613 \end_layout
 614
 615 \begin_layout Standard
 616 Yes.
 617  LyX outputs LaTeX files that are either machine or human friendly.
 618  The
 619 \family typewriter
 620 tex2lyx
 621 \family default
 622  program that comes with LyX does a decent job of converting LaTeX into
 623  LyX.
 624  It's not perfect, but it will usually get at least 95% of the job done
 625  for you.
 626 \end_layout
 627
 628 \begin_layout Subsection
 629 Can I read/write Word files?
 630 \end_layout
 631
 632 \begin_layout Standard
 633 Not trivially.
 634  See these page:
 635 \begin_inset Flex URL
 636 status open
 637
 638 \begin_layout Plain Layout
 639
 640 http://wiki.lyx.org/LyX/ConvertingFromWord
 641 \end_layout
 642
 643 \end_inset
 644
 645  and also the converters section which will give another possibilities of
 646  conversion routes:
 647 \begin_inset Flex URL
 648 status open
 649
 650 \begin_layout Plain Layout
 651
 652 http://www.lyx.org/AdditionalSoftware#toc9
 653 \end_layout
 654
 655 \end_inset
 656
 657 .
 658 \end_layout
 659
 660 \begin_layout Standard
 661 Finally, when all else fails, use any word processor (WordPerfect, StarOffice/Op
 662 enOffice, ...) which understands Word.
 663  Then export as the file as plain text and add the formatting by hand in
 664  LyX.
 665
 666 \end_layout
 667
 668 \begin_layout Subsection
 669 Can I read/write HTML files?
 670 \end_layout
 671
 672 \begin_layout Standard
 673 You can output HTML files using the
 674 \begin_inset Quotes eld
 675 \end_inset
 676
 677 tth
 678 \begin_inset Quotes erd
 679 \end_inset
 680
 681  converter program, amongst others.
 682  There is a HTML
 683 \begin_inset Formula $\rightarrow$
 684 \end_inset
 685
 686 LaTeX program available (html2latex) which allows you to convert the other
 687  direction.
 688 \end_layout
 689
 690 \begin_layout Section
 691 Obtaining and Compiling LyX
 692 \end_layout
 693
 694 \begin_layout Subsection
 695 What do I need?
 696 \end_layout
 697
 698 \begin_layout Itemize
 699 LyX source code: lyx-1.x.x.tar.gz
 700 \end_layout
 701
 702 \begin_layout Itemize
 703 Qt library: Qt-4.2.0 or higher (using the latest version available is recommended)
 704 \end_layout
 705
 706 \begin_layout Itemize
 707 A LaTeX installation: we strongly recommend teTeX/TeXLive on Linux, MikTeX
 708  on Window
 709 \end_layout
 710
 711 \begin_layout Itemize
 712 A PostScript® interpreter: ghostscript 7.0 or higher
 713 \end_layout
 714
 715 \begin_layout Itemize
 716 A modern C++ compiler.
 717  If you are using gcc, LyX requires at least version 3.2.0.
 718 \end_layout
 719
 720 \begin_layout Subsection
 721 How do I compile it?
 722 \end_layout
 723
 724 \begin_layout Itemize
 725 ./configure
 726 \end_layout
 727
 728 \begin_layout Itemize
 729 make
 730 \end_layout
 731
 732 \begin_layout Itemize
 733 make install (usually as root, though you don't have to be if you add flags
 734  to the configure command)
 735 \end_layout
 736
 737 \begin_layout Standard
 738 See the INSTALL file for more details.
 739 \end_layout
 740
 741 \begin_layout Subsection
 742 I hate compiling.
 743  Where are precompiled binaries?
 744 \end_layout
 745
 746 \begin_layout Standard
 747 Most of the above packages are available as precompiled binaries in a variety
 748  of Linux systems, perhaps others as well.
 749  The LyX binaries are available as RPMS, Windows and Mac installers, plus
 750  a few other formats and may be obtained from
 751 \begin_inset Flex URL
 752 status collapsed
 753
 754 \begin_layout Plain Layout
 755
 756 ftp://ftp.lyx.org/pub/lyx/bin/
 757 \end_layout
 758
 759 \end_inset
 760
 761 .
 762 \end_layout
 763
 764 \begin_layout Section
 765 Questions about Evil Red Text (IMPORTANT!)
 766 \end_layout
 767
 768 \begin_layout Subsection
 769 What is Evil Red Text (aka ERT)?
 770 \end_layout
 771
 772 \begin_layout Standard
 773 ERT (Evil Red Text) refers to raw LaTeX commands which are inserted into
 774  your LyX document.
 775  Certain troglodytes in the development group coined this term when they
 776  complained about the unsightly appearance it leads to in LyX documents.
 777  The more enlightened among us know that it is extremely useful, even though
 778  it does qualify as URT (Ugly Red Text), but ERT seems to have stuck.
 779
 780 \end_layout
 781
 782 \begin_layout Subsection
 783 How do I enter Evil Red Text?
 784 \end_layout
 785
 786 \begin_layout Standard
 787 Aesthetic arguments aside, many of the answers in this FAQ require that
 788  you use ERT, so whenever we say
 789 \begin_inset Quotes eld
 790 \end_inset
 791
 792 insert the following LaTeX code
 793 \begin_inset Quotes erd
 794 \end_inset
 795
 796 , do the following
 797 \end_layout
 798
 799 \begin_layout Enumerate
 800 Click the TeX toolbar button or select
 801 \family sans
 802 \bar under
 803 I
 804 \bar default
 805 nsert\SpecialChar \menuseparator
 806
 807 \bar under
 808 T
 809 \bar default
 810 eX
 811 \family default
 812 .
 813 \end_layout
 814
 815 \begin_layout Enumerate
 816 Type the command as it is written in the normal way
 817 \end_layout
 818
 819 \begin_layout Standard
 820
 821 \change_deleted 0 1223267937
 822 The new ERT inset is really inconvenient !
 823 \end_layout
 824
 825 \begin_layout Standard
 826
 827 \change_deleted 0 1223267937
 828 A lot of people have been complaining about the ERT inset introduced in
 829  version 1.2.0.
 830  However, since there is little hope of to see the old LaTeX font return
 831  from the grave (it was really a hack), here are a couple of things to ponder:
 832 \end_layout
 833
 834 \begin_layout Itemize
 835
 836 \change_deleted 0 1223267937
 837 You can collapse the ERT like any other floats by using
 838 \family sans
 839 \bar under
 840 E
 841 \bar default
 842 dit\SpecialChar \menuseparator
 843 Open/C
 844 \bar under
 845 l
 846 \bar default
 847 ose float
 848 \family default
 849  (bound to
 850 \family sans
 851 C-i
 852 \family default
 853  by default)
 854 \end_layout
 855
 856 \begin_layout Itemize
 857
 858 \change_deleted 0 1223267937
 859 You can also set it to
 860 \begin_inset Quotes eld
 861 \end_inset
 862
 863 inlined
 864 \begin_inset Quotes erd
 865 \end_inset
 866
 867  by using the properties dialog obtained by right-clicking anywhere in the
 868  inset
 869 \change_unchanged
 870
 871 \end_layout
 872
 873 \begin_layout Subsection
 874 Is there an alternative?
 875 \end_layout
 876
 877 \begin_layout Standard
 878 LaTeX commands can also be inserted in the
 879 \begin_inset Quotes eld
 880 \end_inset
 881
 882 LaTeX Preamble
 883 \begin_inset Quotes erd
 884 \end_inset
 885
 886 , a form in LyX that is inserted verbatim into the LaTeX file which is generated
 887  during processing.
 888  This is especially useful for including nonstandard LaTeX packages, defining
 889  global shortcuts to be used within the document, etc.
 890 \end_layout
 891
 892 \begin_layout Section
 893 Questions Related to Using LyX
 894 \end_layout
 895
 896 \begin_layout Standard
 897 In this section, we attempt to address the truly most frequently asked questions.
 898  For a broader range of not-so-frequently asked questions and many
 899 \begin_inset Quotes eld
 900 \end_inset
 901
 902 how do I?
 903 \begin_inset Quotes erd
 904 \end_inset
 905
 906  topics, see Herbert Voss' spectacular collection at
 907 \begin_inset Flex URL
 908 status collapsed
 909
 910 \begin_layout Plain Layout
 911
 912 http://tug.org/TeXnik/
 913 \end_layout
 914
 915 \end_inset
 916
 917 .
 918  You are doing yourself a large disservice if you don't check there before
 919  sending a message to the mailing lists!
 920 \end_layout
 921
 922 \begin_layout Subsection
 923 General questions
 924 \end_layout
 925
 926 \begin_layout Subsubsection
 927 How do I get rid of the date under the title?
 928 \end_layout
 929
 930 \begin_layout Standard
 931 The simplest solution is to open the menu
 932 \family sans
 933 \bar under
 934 L
 935 \bar default
 936 ayout\SpecialChar \menuseparator
 937 P
 938 \bar under
 939 r
 940 \bar default
 941 eamble
 942 \family default
 943  and add the line
 944 \end_layout
 945
 946 \begin_layout LyX-Code
 947
 948 \backslash
 949 date{}
 950 \end_layout
 951
 952 \begin_layout Standard
 953 in the preamble window.
 954 \end_layout
 955
 956 \begin_layout Subsubsection
 957 How do I change the spacing in an Itemize/\SpecialChar \-
 958 Enumerate/\SpecialChar \-
 959 Description list environment
 960 ?
 961 \end_layout
 962
 963 \begin_layout Standard
 964 You'll have to do this by hand: for example, for one particular list, you
 965  can add the following LaTeX code at the beginning of the list:
 966 \end_layout
 967
 968 \begin_layout Standard
 969
 970 \family typewriter
 971
 972 \backslash
 973 setlength{
 974 \backslash
 975 itemsep}{0mm}
 976 \end_layout
 977
 978 \begin_layout Subsubsection
 979 How do I number equations by section?
 980 \end_layout
 981
 982 \begin_layout Standard
 983 Add the following two lines to your LaTeX preamble:
 984 \end_layout
 985
 986 \begin_layout LyX-Code
 987
 988 \backslash
 989 @addtoreset{equation}{section}
 990 \end_layout
 991
 992 \begin_layout LyX-Code
 993
 994 \backslash
 995 renewcommand{
 996 \backslash
 997 theequation}{
 998 \backslash
 999 thesection.
1000 \backslash
1001 arabic{equation}}
1002 \end_layout
1003
1004 \begin_layout Subsubsection
1005 Is it possible to do this for figures and tables as well?
1006 \end_layout
1007
1008 \begin_layout Standard
1009 Replace the phrase
1010 \family typewriter
1011
1012 \backslash
1013 theequation
1014 \family default
1015  with
1016 \family typewriter
1017
1018 \backslash
1019 thetable
1020 \family default
1021  or
1022 \family typewriter
1023
1024 \backslash
1025 thefigure
1026 \family default
1027  and then replace
1028 \family typewriter
1029 equation
1030 \family default
1031  with
1032 \family typewriter
1033 table
1034 \family default
1035  or
1036 \family typewriter
1037 figure
1038 \family default
1039 .
1040  Don't forget to adapt the
1041 \backslash
1042 @addtoreset command, too.
1043 \end_layout
1044
1045 \begin_layout Subsubsection
1046 How do I change to footnote numbers to symbols (star, dagger, etc.)?
1047 \end_layout
1048
1049 \begin_layout Standard
1050 Add
1051 \family typewriter
1052
1053 \backslash
1054 renewcommand{
1055 \backslash
1056 thefootnote}{
1057 \backslash
1058 fnsymbol{footnote}}
1059 \family default
1060  to your LaTeX preamble.
1061 \end_layout
1062
1063 \begin_layout Subsubsection
1064 How do I kill widows and orphans?
1065 \end_layout
1066
1067 \begin_layout Standard
1068 Okay, we are not playing Duke Nukem here! To eliminate widows and orphans
1069  (first line from a paragraph at the bottom of the page and the last line
1070  from a paragraph at the top of the page), add the following to the LaTeX
1071  preamble:
1072 \end_layout
1073
1074 \begin_layout LyX-Code
1075
1076 \backslash
1077 widowpenalty=10000
1078 \end_layout
1079
1080 \begin_layout LyX-Code
1081
1082 \backslash
1083 clubpenalty=10000
1084 \end_layout
1085
1086 \begin_layout Standard
1087 and perhaps
1088 \end_layout
1089
1090 \begin_layout LyX-Code
1091
1092 \backslash
1093 raggedbottom
1094 \end_layout
1095
1096 \begin_layout LyX-Code
1097
1098 \end_layout
1099
1100 \begin_layout Subsubsection
1101 How do I get a formatted list which starts with e.g.
1102  1.
1103  a)?
1104 \end_layout
1105
1106 \begin_layout Standard
1107 If you want a list which looks like
1108 \end_layout
1109
1110 \begin_layout LyX-Code
1111 1.
1112  a) First alternative
1113 \end_layout
1114
1115 \begin_layout LyX-Code
1116    b) Second alternative
1117 \end_layout
1118
1119 \begin_layout LyX-Code
1120    c) Third alternative
1121 \end_layout
1122
1123 \begin_layout Standard
1124 then try the following
1125 \end_layout
1126
1127 \begin_layout LyX-Code
1128 1.
1129  {}
1130 \end_layout
1131
1132 \begin_layout LyX-Code
1133    a) First alternative
1134 \end_layout
1135
1136 \begin_layout LyX-Code
1137    b) Second alternative
1138 \end_layout
1139
1140 \begin_layout LyX-Code
1141    c) Third
1142 \end_layout
1143
1144 \begin_layout Standard
1145 where {} is in ERT (i.e.
1146  a placeholder not generating output.
1147  Specifically, set the style to
1148 \begin_inset Quotes eld
1149 \end_inset
1150
1151 enumerate
1152 \begin_inset Quotes erd
1153 \end_inset
1154
1155 , enter the brackets in ERT, change the environment depth, and add the three
1156  elements.
1157  LyX will auto-label the entries.
1158 \end_layout
1159
1160 \begin_layout Subsubsection
1161 How do I insert a fixed amount of horizontal space?
1162 \end_layout
1163
1164 \begin_layout Standard
1165
1166 \change_inserted 0 1223268084
1167 Use Insert>Formatting>Horizontal Space.
1168
1169 \change_deleted 0 1223268105
1170 There are various ERT commands to use:
1171 \family typewriter
1172
1173 \backslash
1174 enspace
1175 \family default
1176  (1/2 em),
1177 \family typewriter
1178
1179 \backslash
1180 thinspace
1181 \family default
1182  (1/6 em),
1183 \family typewriter
1184
1185 \backslash
1186 negthinspace
1187 \family default
1188  (-1/6 em),
1189 \family typewriter
1190
1191 \backslash
1192 quad
1193 \family default
1194  (1 em),
1195 \family typewriter
1196
1197 \backslash
1198 qquad
1199 \family default
1200  (2 em),
1201 \family typewriter
1202
1203 \backslash
1204 hspace{
1205 \emph on
1206 length
1207 \emph default
1208 }
1209 \family default
1210 , etc.
1211  An
1212 \begin_inset Quotes eld
1213 \end_inset
1214
1215 em
1216 \begin_inset Quotes erd
1217 \end_inset
1218
1219  is roughly the width of the letter
1220 \begin_inset Quotes eld
1221 \end_inset
1222
1223 m
1224 \begin_inset Quotes erd
1225 \end_inset
1226
1227  in the current font.
1228  The length argument of the
1229 \family typewriter
1230
1231 \backslash
1232 hspace
1233 \family default
1234  command is any valid TeX length; units can be
1235 \family typewriter
1236 mm
1237 \family default
1238  (millimeters),
1239 \family typewriter
1240 cm
1241 \family default
1242  (centimeters),
1243 \family typewriter
1244 in
1245 \family default
1246  (inches),
1247 \family typewriter
1248 pt
1249 \family default
1250  (points = 1/72 inch),
1251 \family typewriter
1252 em
1253 \family default
1254  (width of letter
1255 \begin_inset Quotes eld
1256 \end_inset
1257
1258 m
1259 \begin_inset Quotes erd
1260 \end_inset
1261
1262 ), or
1263 \family typewriter
1264 ex
1265 \family default
1266  (height of letter
1267 \begin_inset Quotes eld
1268 \end_inset
1269
1270 x
1271 \begin_inset Quotes erd
1272 \end_inset
1273
1274 ).
1275  Examples:
1276 \family typewriter
1277
1278 \backslash
1279 hspace{1in}
1280 \family default
1281 ,
1282 \family typewriter
1283
1284 \backslash
1285 hspace{2.5em}
1286 \family default
1287 , etc.
1288 \change_unchanged
1289
1290 \end_layout
1291
1292 \begin_layout Subsubsection
1293 How can I make citations show up as [1,2,3,6] or [1-3,6] rather than [1][2][3][6
1294 ]?
1295 \end_layout
1296
1297 \begin_layout Standard
1298 Insert
1299 \family typewriter
1300
1301 \backslash
1302 usepackage{cite}
1303 \family default
1304  into the LaTeX preamble.
1305  Most LaTeX distributions should have this package included.
1306  LyX supports this package, if you insert multiple citations separated by
1307  commas into the citation dialog, e.
1308  g.
1309  [Smalley_JCP,Jarrold_Sci], instead of just one citation after the other:
1310  [Smalley_JCP] [Jarrold_Sci].
1311 \end_layout
1312
1313 \begin_layout Subsection
1314 Figure related questions
1315 \end_layout
1316
1317 \begin_layout Subsubsection
1318 What is the difference between a
1319 \begin_inset Quotes eld
1320 \end_inset
1321
1322 figure
1323 \begin_inset Quotes erd
1324 \end_inset
1325
1326  and a
1327 \begin_inset Quotes eld
1328 \end_inset
1329
1330 figure float
1331 \begin_inset Quotes erd
1332 \end_inset
1333
1334 ?
1335 \end_layout
1336
1337 \begin_layout Standard
1338 This is an example of less-than-ideal terminology.
1339
1340 \begin_inset Quotes eld
1341 \end_inset
1342
1343 Figure
1344 \begin_inset Quotes erd
1345 \end_inset
1346
1347  is what
1348 \change_inserted 0 1223268123
1349 you might
1350 \change_deleted 0 1223268127
1351 I would really
1352 \change_unchanged
1353 call a
1354 \begin_inset Quotes eld
1355 \end_inset
1356
1357 graphic
1358 \begin_inset Quotes erd
1359 \end_inset
1360
1361 ; it basically means insert a picture file.
1362
1363 \begin_inset Quotes eld
1364 \end_inset
1365
1366 Figure float
1367 \begin_inset Quotes erd
1368 \end_inset
1369
1370  is more what one means by a figure in a paper: it includes the graphic,
1371  the caption, the figure label, etc.
1372  You should almost always insert a figure float first, then put a figure
1373  inside that.
1374 \end_layout
1375
1376 \begin_layout Standard
1377 Tables work in the same manner.
1378  Put a table float in first, then insert the table within that.
1379 \end_layout
1380
1381 \begin_layout Subsubsection
1382 How do I get LyX to put the figure exactly where I want it?
1383 \end_layout
1384
1385 \begin_layout Standard
1386
1387 \change_deleted 0 1223268182
1388 Select
1389 \family sans
1390 Layout\SpecialChar \menuseparator
1391 Document
1392 \family default
1393 .
1394  In the
1395 \family sans
1396 Float Placement
1397 \family default
1398  box, type
1399 \begin_inset Quotes eld
1400 \end_inset
1401
1402
1403 \family typewriter
1404 !htp
1405 \family default
1406
1407 \begin_inset Quotes erd
1408 \end_inset
1409
1410 .
1411  This tells LaTeX to try really hard to put the figure here first, then
1412  the top of a page, then on a page by itself.
1413  This is a global setting: all figure will then obey this rule set.
1414 \end_layout
1415
1416 \begin_layout Standard
1417 If you want to control how
1418 \change_inserted 0 1223268187
1419 an individual
1420 \change_deleted 0 1223268189
1421 each
1422 \change_unchanged
1423 figure behaves, right-click in the figure float and you will get a dialog
1424  allowing to control the figure behavior.
1425
1426 \change_inserted 0 1223268280
1427  If you want to control how they all behave, look at
1428 \family sans
1429 Document\SpecialChar \menuseparator
1430 Settings\SpecialChar \menuseparator
1431 Float Placement
1432 \family default
1433 .
1434 \change_unchanged
1435
1436 \end_layout
1437
1438 \begin_layout Subsubsection
1439 What does
1440 \begin_inset Quotes eld
1441 \end_inset
1442
1443 Too many unprocessed floats
1444 \begin_inset Quotes erd
1445 \end_inset
1446
1447  mean?
1448 \end_layout
1449
1450 \begin_layout Standard
1451 LaTeX can handle only a limited number of floating elements floating at
1452  a given time.
1453  For example, if Figure 4 can't be fit in a good location (using the default
1454  rules of top of the page, then bottom, then a page of its own) and Figure
1455  5 comes along, they will both continue to float toward the end of the document
1456  until a good location can be found.
1457  If nothing good turns up, they will just be placed at the end of the document.
1458  If there are too many of these, LaTeX overruns a counter and emits the
1459
1460 \begin_inset Quotes eld
1461 \end_inset
1462
1463 too many unprocessed floats
1464 \begin_inset Quotes erd
1465 \end_inset
1466
1467  error.
1468  This is not a bug in LaTeX, this is simply too many figures with too little
1469  text :-)
1470 \end_layout
1471
1472 \begin_layout Standard
1473 The easiest way to work around this is to insert a
1474 \family typewriter
1475
1476 \backslash
1477 clearpage
1478 \family default
1479  command somewhere in the document where a pagebreak would be appropriate.
1480  While a pagebreak would simply start a new page,
1481 \family typewriter
1482
1483 \backslash
1484 clearpage
1485 \family default
1486  processes all remaining floats, then begins a new page.
1487  This may lead to an unsightly stack of figures in the middle of your document;
1488  you may need to use several
1489 \family typewriter
1490
1491 \backslash
1492 clearpages
1493 \family default
1494  to make things balance nicely.
1495 \end_layout
1496
1497 \begin_layout Subsection
1498 Math related questions
1499 \end_layout
1500
1501 \begin_layout Subsubsection
1502 How do I put normal text inside a mathematical equation?
1503 \end_layout
1504
1505 \begin_layout Standard
1506 Type
1507 \begin_inset Quotes eld
1508 \end_inset
1509
1510
1511 \family typewriter
1512 M-m m
1513 \family default
1514
1515 \begin_inset Quotes erd
1516 \end_inset
1517
1518  while inside the equation to enter
1519 \begin_inset Quotes eld
1520 \end_inset
1521
1522 math text mode
1523 \begin_inset Quotes erd
1524 \end_inset
1525
1526 .
1527 \end_layout
1528
1529 \begin_layout Subsubsection
1530 How do I make a cube root (or higher)?
1531 \end_layout
1532
1533 \begin_layout Standard
1534 Type
1535 \begin_inset Quotes eld
1536 \end_inset
1537
1538
1539 \family typewriter
1540 M-m r
1541 \family default
1542
1543 \begin_inset Quotes erd
1544 \end_inset
1545
1546  to insert a nifty
1547 \begin_inset Quotes eld
1548 \end_inset
1549
1550 root box
1551 \begin_inset Quotes erd
1552 \end_inset
1553
1554 .
1555  Use the cursor keys to navigate the entry boxes.
1556 \end_layout
1557
1558 \begin_layout Section
1559 Questions Related to Running LyX
1560 \end_layout
1561
1562 \begin_layout Subsection
1563 How do I convert LyX files to LaTeX from the command line?
1564 \end_layout
1565
1566 \begin_layout Standard
1567
1568 \change_deleted 0 1223268310
1569 File export was vastly improved in version 1.1.6.
1570
1571 \change_unchanged
1572 Simply say
1573 \end_layout
1574
1575 \begin_layout LyX-Code
1576 lyx --export latex <yourfile>.lyx
1577 \end_layout
1578
1579 \begin_layout Standard
1580 and that is all you need to do.
1581
1582 \change_inserted 0 1223268347
1583  Other formats can be exported in the same way.
1584 \change_unchanged
1585
1586 \end_layout
1587
1588 \begin_layout Standard
1589
1590 \change_deleted 0 1223268332
1591 If you have an older version of LyX, you can use the same syntax if you
1592  are running X, because it will cause LyX windows to pop up onto your screen.
1593  If you have the Xvfb command available, you can resort to a deeper level
1594  of subterfuge (under
1595 \family typewriter
1596 bash
1597 \family default
1598 ):
1599 \end_layout
1600
1601 \begin_layout Standard
1602
1603 \change_deleted 0 1223268332
1604
1605 \family typewriter
1606 (Xvfb :1 -once -terminate &); rm <file>.tex; lyx -display :1 --export latex
1607  <file>.lyx
1608 \end_layout
1609
1610 \begin_layout Standard
1611 \noindent
1612
1613 \change_deleted 0 1223268332
1614 Under csh/tcsh it is simply
1615 \end_layout
1616
1617 \begin_layout Standard
1618
1619 \change_deleted 0 1223268332
1620
1621 \family typewriter
1622 Xvfb :1 -once -terminate &; rm <file>.tex; lyx -display :1 --export latex
1623  <file>.lyx
1624 \end_layout
1625
1626 \begin_layout Standard
1627 \noindent
1628
1629 \change_deleted 0 1223268332
1630 This should work anywhere, whether or not X is actually running.
1631 \change_unchanged
1632
1633 \end_layout
1634
1635 \begin_layout Subsection
1636 Why do the fonts in my document look so bad in
1637 \family typewriter
1638 acroread
1639 \family default
1640  ?
1641 \end_layout
1642
1643 \begin_layout Standard
1644 The problem and the solution are also discussed in Section 5.3.6 of the
1645 \emph on
1646 Extended Features
1647 \emph default
1648  manual.
1649 \end_layout
1650
1651 \begin_layout Section
1652 Questions Related to LyX on Windows
1653 \end_layout
1654
1655 \begin_layout Subsection
1656 Why do the menus and the toolbar flicker ?
1657 \end_layout
1658
1659 \begin_layout Standard
1660 You are probably using the XWin32 X server.
1661  This is a bug in XWin32: you can work around the problem by disabling the
1662
1663 \begin_inset Quotes eld
1664 \end_inset
1665
1666 Use Reserved Colors
1667 \begin_inset Quotes erd
1668 \end_inset
1669
1670  option of XWin32, and using a color mode other than PseudoColor.
1671 \end_layout
1672
1673 \begin_layout Section
1674 How to get further assistance
1675 \end_layout
1676
1677 \begin_layout Subsection
1678 You still haven't answered my question!
1679 \end_layout
1680
1681 \begin_layout Standard
1682 Then RTFM, especially the Tutorial.
1683  The documentation really is quite good.
1684  (Besides, I helped write parts of it :-) If you think your problem may
1685  be LaTeX related, then look in
1686 \emph on
1687 LaTeX, A Document Preparation System, 2nd Ed.
1688
1689 \emph default
1690  by Leslie Lamport (1994).
1691  There are also numerous example files included with LyX.
1692  Try
1693 \family sans
1694 File\SpecialChar \menuseparator
1695 Open\SpecialChar \menuseparator
1696 Examples
1697 \family default
1698 .
1699  Don't forget we have Tips and Tricks database in LyX wiki.
1700 \end_layout
1701
1702 \begin_layout Subsection
1703 I want to mail someone about my problem.
1704
1705 \end_layout
1706
1707 \begin_layout Standard
1708 Send email to the LyX Users list lyx-users@lists.lyx.org.
1709  If LyX is actually crashing or otherwise non-functional, then try the developer
1710 s' list at lyx-devel@lists.lyx.org.
1711 \end_layout
1712
1713 \begin_layout Subsection
1714 What to put in a request for help.
1715 \end_layout
1716
1717 \begin_layout Standard
1718 Include your version of LyX and a description of what you are trying to
1719  do, along with evidence that you've actually read the docs.
1720 \end_layout
1721
1722 \begin_layout Standard
1723 If LyX has crashed, include the version of LyX, the operating system, the
1724  version of xforms (if it seems to be a screen drawing problem), and a precise
1725  description of the events that lead to the crash.
1726  The easier it is for the developers to reproduce your crash, the more likely
1727  it will get fixed.
1728  If you're brave and like to hack, use gdb to generate a backtrace and include
1729  the results with your mail.
1730  If you have no clue what I'm talking about, just describe what you did
1731  as completely as you can.
1732 \end_layout
1733
1734 \begin_layout Section
1735 Administrative information and acknowledgments
1736 \end_layout
1737
1738 \begin_layout Subsection
1739 Feedback is invited.
1740
1741 \end_layout
1742
1743 \begin_layout Standard
1744 Send comments, suggested additions, world record document claims, etc.
1745  to
1746 \emph on
1747 lyx-docs@lists.lyx.org.
1748 \end_layout
1749
1750 \begin_layout Subsection
1751 Formats in which this FAQ is available.
1752
1753 \end_layout
1754
1755 \begin_layout Standard
1756 The LyX file original is included in the LyX source distribution, converted
1757  versions in HTML and ASCII should soon be available at the website.
1758  A German version is also available with the distribution.
1759 \end_layout
1760
1761 \begin_layout Subsection
1762 Authorship and acknowledgments.
1763 \end_layout
1764
1765 \begin_layout Standard
1766 Bernhard Iselborn, David Johnson, and Paul Evans were responsible for the
1767  FAQ through version 0.2.2 which covered LyX-0.10.7.
1768  The FAQ as of version 0.3.0 was written from scratch and covers LyX-1.0 and
1769  higher.
1770  Many people contributed pieces to the current version; Mike Ressler of
1771  the Doc Team collected them into this file.
1772 \end_layout
1773
1774 \begin_layout Subsection
1775 Disclaimer and Copyright.
1776
1777 \end_layout
1778
1779 \begin_layout Standard
1780 I don't claim anything in this document is accurate to within a factor of
1781
1782 \begin_inset Formula $\pi$
1783 \end_inset
1784
1785 ; after all, I'm just an astronomer, and we like to set
1786 \begin_inset Formula $c=h=k=\pi=1$
1787 \end_inset
1788
1789 .
1790  When the answer is wrong, we just redefine the units.
1791  This file is distributed in the hope that it will be useful, but WITHOUT
1792  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
1793  FOR A PARTICULAR PURPOSE.
1794  See the GNU General Public License for more details.
1795  In other words, it's not my fault if you lose your dissertation the night
1796  before your doctoral defense because you forgot to save it before the power
1797  failed while wondering how a fundamental physical constant expressed in
1798  units of
1799 \begin_inset Formula $\textrm{m s}^{-1}$
1800 \end_inset
1801
1802  could possibly be equal to one expressed as
1803 \begin_inset Formula $\textrm{kg m s}^{-2}\textrm{ K}^{-1}$
1804 \end_inset
1805
1806 .
1807  This file is Copyright © 2000 by Michael E.
1808  Ressler on behalf of the LyX Documentation Team.
1809 \end_layout
1810
1811 \end_body
1812 \end_document