lib/doc/FAQ.lyx

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