lib/doc/FAQ.lyx

   1 #LyX 1.4.0svn 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 Section
 747 Questions about Evil Red Text (IMPORTANT!)
 748 \end_layout
 749
 750 \begin_layout Subsection
 751 What is Evil Red Text (aka ERT)?
 752 \end_layout
 753
 754 \begin_layout Standard
 755 ERT (Evil Red Text) refers to raw LaTeX commands which are inserted into
 756  your LyX document.
 757  Certain troglodytes in the development group coined this term when they
 758  complained about the unsightly appearance it leads to in LyX documents.
 759  The more enlightened among us know that it is extremely useful, even though
 760  it does qualify as URT (Ugly Red Text), but ERT seems to have stuck.
 761
 762 \end_layout
 763
 764 \begin_layout Subsection
 765 How do I enter Evil Red Text?
 766 \end_layout
 767
 768 \begin_layout Standard
 769 Aesthetic arguments aside, many of the answers in this FAQ require that
 770  you use ERT, so whenever we say
 771 \begin_inset Quotes eld
 772 \end_inset
 773
 774 insert the following LaTeX code
 775 \begin_inset Quotes erd
 776 \end_inset
 777
 778 , do the following
 779 \end_layout
 780
 781 \begin_layout Enumerate
 782 Click the TeX toolbar button or select
 783 \family sans
 784 \bar under
 785 I
 786 \bar default
 787 nsert\SpecialChar \menuseparator
 788
 789 \bar under
 790 T
 791 \bar default
 792 eX
 793 \family default
 794 .
 795 \end_layout
 796
 797 \begin_layout Enumerate
 798 Type the command as it is written in the normal way
 799 \end_layout
 800
 801 \begin_layout Subsection
 802 The new ERT inset is really inconvenient !
 803 \end_layout
 804
 805 \begin_layout Standard
 806 A lot of people have been complaining about the ERT inset introduced in
 807  version 1.2.0.
 808  However, since there is little hope of to see the old LaTeX font return
 809  from the grave (it was really a hack), here are a couple of things to ponder:
 810 \end_layout
 811
 812 \begin_layout Itemize
 813 You can collapse the ERT like any other floats by using
 814 \family sans
 815 \bar under
 816 E
 817 \bar default
 818 dit\SpecialChar \menuseparator
 819 Open/C
 820 \bar under
 821 l
 822 \bar default
 823 ose float
 824 \family default
 825  (bound to
 826 \family sans
 827 C-i
 828 \family default
 829 by default)
 830 \end_layout
 831
 832 \begin_layout Itemize
 833 You can also set it to
 834 \begin_inset Quotes eld
 835 \end_inset
 836
 837 inlined
 838 \begin_inset Quotes erd
 839 \end_inset
 840
 841  by using the properties dialog obtained by right-clicking anywhere in the
 842  inset
 843 \end_layout
 844
 845 \begin_layout Subsection
 846 Is there an alternative?
 847 \end_layout
 848
 849 \begin_layout Standard
 850 LaTeX commands can also be inserted in the
 851 \begin_inset Quotes eld
 852 \end_inset
 853
 854 LaTeX Preamble
 855 \begin_inset Quotes erd
 856 \end_inset
 857
 858 , a form in LyX that is inserted verbatim into the LaTeX file which is generated
 859  during processing.
 860  This is especially useful for including nonstandard LaTeX packages, defining
 861  global shortcuts to be used within the document, etc.
 862 \end_layout
 863
 864 \begin_layout Section
 865 Questions Related to Using LyX
 866 \end_layout
 867
 868 \begin_layout Standard
 869 In this section, we attempt to address the truly most frequently asked questions.
 870  For a broader range of not-so-frequently asked questions and many
 871 \begin_inset Quotes eld
 872 \end_inset
 873
 874 how do I?
 875 \begin_inset Quotes erd
 876 \end_inset
 877
 878  topics, see Herbert Voss' spectacular collection at
 879 \begin_inset LatexCommand \url{http://tug.org/TeXnik/}
 880
 881 \end_inset
 882
 883 .
 884  You are doing yourself a large disservice if you don't check there before
 885  sending a message to the mailing lists!
 886 \end_layout
 887
 888 \begin_layout Subsection
 889 General questions
 890 \end_layout
 891
 892 \begin_layout Subsubsection
 893 How do I get rid of the date under the title?
 894 \end_layout
 895
 896 \begin_layout Standard
 897 The simplest solution is to open the menu
 898 \family sans
 899 \bar under
 900 L
 901 \bar default
 902 ayout\SpecialChar \menuseparator
 903 P
 904 \bar under
 905 r
 906 \bar default
 907 eamble
 908 \family default
 909  and add the line
 910 \end_layout
 911
 912 \begin_layout LyX-Code
 913
 914 \backslash
 915 date{}
 916 \end_layout
 917
 918 \begin_layout Standard
 919 in the preamble window.
 920 \end_layout
 921
 922 \begin_layout Subsubsection
 923 How do I change the spacing in an Itemize/\SpecialChar \-
 924 Enumerate/\SpecialChar \-
 925 Description list environment
 926 ?
 927 \end_layout
 928
 929 \begin_layout Standard
 930 You'll have to do this by hand: for example, for one particular list, you
 931  can add the following LaTeX code at the beginning of the list:
 932 \end_layout
 933
 934 \begin_layout Standard
 935
 936 \family typewriter
 937
 938 \backslash
 939 setlength{
 940 \backslash
 941 itemsep}{0mm}
 942 \end_layout
 943
 944 \begin_layout Subsubsection
 945 How do I number equations by section?
 946 \end_layout
 947
 948 \begin_layout Standard
 949 Add the following two lines to your LaTeX preamble:
 950 \end_layout
 951
 952 \begin_layout LyX-Code
 953
 954 \backslash
 955 @addtoreset{equation}{section}
 956 \end_layout
 957
 958 \begin_layout LyX-Code
 959
 960 \backslash
 961 renewcommand{
 962 \backslash
 963 theequation}{
 964 \backslash
 965 thesection.
 966 \backslash
 967 arabic{equation}}
 968 \end_layout
 969
 970 \begin_layout Subsubsection
 971 Is it possible to do this for figures and tables as well?
 972 \end_layout
 973
 974 \begin_layout Standard
 975 Replace the phrase
 976 \family typewriter
 977
 978 \backslash
 979 theequation
 980 \family default
 981  with
 982 \family typewriter
 983
 984 \backslash
 985 thetable
 986 \family default
 987  or
 988 \family typewriter
 989
 990 \backslash
 991 thefigure
 992 \family default
 993  and then replace
 994 \family typewriter
 995 equation
 996 \family default
 997  with
 998 \family typewriter
 999 table
1000 \family default
1001  or
1002 \family typewriter
1003 figure
1004 \family default
1005 .
1006  Don't forget to adapt the
1007 \backslash
1008 @addtoreset command, too.
1009 \end_layout
1010
1011 \begin_layout Subsubsection
1012 How do I change to footnote numbers to symbols (star, dagger, etc.)?
1013 \end_layout
1014
1015 \begin_layout Standard
1016 Add
1017 \family typewriter
1018
1019 \backslash
1020 renewcommand{
1021 \backslash
1022 thefootnote}{
1023 \backslash
1024 fnsymbol{footnote}}
1025 \family default
1026  to your LaTeX preamble.
1027 \end_layout
1028
1029 \begin_layout Subsubsection
1030 How do I kill widows and orphans?
1031 \end_layout
1032
1033 \begin_layout Standard
1034 Okay, we are not playing Duke Nukem here! To eliminate widows and orphans
1035  (first line from a paragraph at the bottom of the page and the last line
1036  from a paragraph at the top of the page), add the following to the LaTeX
1037  preamble:
1038 \end_layout
1039
1040 \begin_layout LyX-Code
1041
1042 \backslash
1043 widowpenalty=10000
1044 \end_layout
1045
1046 \begin_layout LyX-Code
1047
1048 \backslash
1049 clubpenalty=10000
1050 \end_layout
1051
1052 \begin_layout Standard
1053 and perhaps
1054 \end_layout
1055
1056 \begin_layout LyX-Code
1057
1058 \backslash
1059 raggedbottom
1060 \end_layout
1061
1062 \begin_layout LyX-Code
1063
1064 \end_layout
1065
1066 \begin_layout Subsubsection
1067 How do I get a formatted list which starts with e.g.
1068  1.
1069  a)?
1070 \end_layout
1071
1072 \begin_layout Standard
1073 If you want a list which looks like
1074 \end_layout
1075
1076 \begin_layout LyX-Code
1077 1.
1078  a) First alternative
1079 \end_layout
1080
1081 \begin_layout LyX-Code
1082    b) Second alternative
1083 \end_layout
1084
1085 \begin_layout LyX-Code
1086    c) Third alternative
1087 \end_layout
1088
1089 \begin_layout Standard
1090 then try the following
1091 \end_layout
1092
1093 \begin_layout LyX-Code
1094 1.
1095  {}
1096 \end_layout
1097
1098 \begin_layout LyX-Code
1099    a) First alternative
1100 \end_layout
1101
1102 \begin_layout LyX-Code
1103    b) Second alternative
1104 \end_layout
1105
1106 \begin_layout LyX-Code
1107    c) Third
1108 \end_layout
1109
1110 \begin_layout Standard
1111 where {} is in ERT (i.e.
1112  a placeholder not generating output.
1113  Specifically, set the style to
1114 \begin_inset Quotes eld
1115 \end_inset
1116
1117 enumerate
1118 \begin_inset Quotes erd
1119 \end_inset
1120
1121 , enter the brackets in ERT, change the environment depth, and add the three
1122  elements.
1123  LyX will auto-label the entries.
1124 \end_layout
1125
1126 \begin_layout Subsubsection
1127 How do I count words in LyX?
1128 \end_layout
1129
1130 \begin_layout Standard
1131 Run a spellcheck; it will display the total number of words checked.
1132  Make sure the cursor is at the top of the document when you start the spellchec
1133 ker so that everything is counted.
1134 \end_layout
1135
1136 \begin_layout Subsubsection
1137 How do I insert a fixed amount of horizontal space?
1138 \end_layout
1139
1140 \begin_layout Standard
1141 There are various ERT commands to use:
1142 \family typewriter
1143
1144 \backslash
1145 enspace
1146 \family default
1147  (1/2 em),
1148 \family typewriter
1149
1150 \backslash
1151 thinspace
1152 \family default
1153  (1/6 em),
1154 \family typewriter
1155
1156 \backslash
1157 negthinspace
1158 \family default
1159  (-1/6 em),
1160 \family typewriter
1161
1162 \backslash
1163 quad
1164 \family default
1165  (1 em),
1166 \family typewriter
1167
1168 \backslash
1169 qquad
1170 \family default
1171  (2 em),
1172 \family typewriter
1173
1174 \backslash
1175 hspace{
1176 \emph on
1177 length
1178 \emph default
1179 }
1180 \family default
1181 , etc.
1182  An
1183 \begin_inset Quotes eld
1184 \end_inset
1185
1186 em
1187 \begin_inset Quotes erd
1188 \end_inset
1189
1190  is roughly the width of the letter
1191 \begin_inset Quotes eld
1192 \end_inset
1193
1194 m
1195 \begin_inset Quotes erd
1196 \end_inset
1197
1198  in the current font.
1199  The length argument of the
1200 \family typewriter
1201
1202 \backslash
1203 hspace
1204 \family default
1205  command is any valid TeX length; units can be
1206 \family typewriter
1207 mm
1208 \family default
1209  (millimeters),
1210 \family typewriter
1211 cm
1212 \family default
1213  (centimeters),
1214 \family typewriter
1215 in
1216 \family default
1217  (inches),
1218 \family typewriter
1219 pt
1220 \family default
1221  (points = 1/72 inch),
1222 \family typewriter
1223 em
1224 \family default
1225  (width of letter
1226 \begin_inset Quotes eld
1227 \end_inset
1228
1229 m
1230 \begin_inset Quotes erd
1231 \end_inset
1232
1233 ), or
1234 \family typewriter
1235 ex
1236 \family default
1237  (height of letter
1238 \begin_inset Quotes eld
1239 \end_inset
1240
1241 x
1242 \begin_inset Quotes erd
1243 \end_inset
1244
1245 ).
1246  Examples:
1247 \family typewriter
1248
1249 \backslash
1250 hspace{1in}
1251 \family default
1252 ,
1253 \family typewriter
1254
1255 \backslash
1256 hspace{2.5em}
1257 \family default
1258 , etc.
1259 \end_layout
1260
1261 \begin_layout Subsubsection
1262 How can I make citations show up as [1,2,3,6] or [1-3,6] rather than [1][2][3][6
1263 ]?
1264 \end_layout
1265
1266 \begin_layout Standard
1267 Insert
1268 \family typewriter
1269
1270 \backslash
1271 usepackage{cite}
1272 \family default
1273  into the LaTeX preamble.
1274  Most LaTeX distributions should have this package included.
1275  LyX supports this package, if you insert multiple citations separated by
1276  commas into the citation dialog, e.
1277  g.
1278  [Smalley_JCP,Jarrold_Sci], instead of just one citation after the other:
1279  [Smalley_JCP] [Jarrold_Sci].
1280 \end_layout
1281
1282 \begin_layout Subsection
1283 Figure related questions
1284 \end_layout
1285
1286 \begin_layout Subsubsection
1287 What is the difference between a
1288 \begin_inset Quotes eld
1289 \end_inset
1290
1291 figure
1292 \begin_inset Quotes erd
1293 \end_inset
1294
1295  and a
1296 \begin_inset Quotes eld
1297 \end_inset
1298
1299 figure float
1300 \begin_inset Quotes erd
1301 \end_inset
1302
1303 ?
1304 \end_layout
1305
1306 \begin_layout Standard
1307 This is an example of less-than-ideal terminology.
1308
1309 \begin_inset Quotes eld
1310 \end_inset
1311
1312 Figure
1313 \begin_inset Quotes erd
1314 \end_inset
1315
1316  is what I would really call a
1317 \begin_inset Quotes eld
1318 \end_inset
1319
1320 graphic
1321 \begin_inset Quotes erd
1322 \end_inset
1323
1324 ; it basically means insert a picture file.
1325
1326 \begin_inset Quotes eld
1327 \end_inset
1328
1329 Figure float
1330 \begin_inset Quotes erd
1331 \end_inset
1332
1333  is more what one means by a figure in a paper: it includes the graphic,
1334  the caption, the figure label, etc.
1335  You should almost always insert a figure float first, then put a figure
1336  inside that.
1337 \end_layout
1338
1339 \begin_layout Standard
1340 Tables work in the same manner.
1341  Put a table float in first, then insert the table within that.
1342 \end_layout
1343
1344 \begin_layout Subsubsection
1345 How do I get LyX to put the figure exactly where I want it?
1346 \end_layout
1347
1348 \begin_layout Standard
1349 Select
1350 \family sans
1351 Layout\SpecialChar \menuseparator
1352 Document
1353 \family default
1354 .
1355  In the
1356 \family sans
1357 Float Placement
1358 \family default
1359  box, type
1360 \begin_inset Quotes eld
1361 \end_inset
1362
1363
1364 \family typewriter
1365 !htp
1366 \family default
1367
1368 \begin_inset Quotes erd
1369 \end_inset
1370
1371 .
1372  This tells LaTeX to try really hard to put the figure here first, then
1373  the top of a page, then on a page by itself.
1374  This is a global setting: all figure will then obey this rule set.
1375 \end_layout
1376
1377 \begin_layout Standard
1378 If you want to control how each figure behaves, right-click in the figure
1379  float and you will get a dialog allowing to control the figure behavior.
1380 \end_layout
1381
1382 \begin_layout Subsubsection
1383 What does
1384 \begin_inset Quotes eld
1385 \end_inset
1386
1387 Too many unprocessed floats
1388 \begin_inset Quotes erd
1389 \end_inset
1390
1391  mean?
1392 \end_layout
1393
1394 \begin_layout Standard
1395 LaTeX can handle only a limited number of floating elements floating at
1396  a given time.
1397  For example, if Figure 4 can't be fit in a good location (using the default
1398  rules of top of the page, then bottom, then a page of its own) and Figure
1399  5 comes along, they will both continue to float toward the end of the document
1400  until a good location can be found.
1401  If nothing good turns up, they will just be placed at the end of the document.
1402  If there are too many of these, LaTeX overruns a counter and emits the
1403
1404 \begin_inset Quotes eld
1405 \end_inset
1406
1407 too many unprocessed floats
1408 \begin_inset Quotes erd
1409 \end_inset
1410
1411  error.
1412  This is not a bug in LaTeX, this is simply too many figures with too little
1413  text :-)
1414 \end_layout
1415
1416 \begin_layout Standard
1417 The easiest way to work around this is to insert a
1418 \family typewriter
1419
1420 \backslash
1421 clearpage
1422 \family default
1423  command somewhere in the document where a pagebreak would be appropriate.
1424  While a pagebreak would simply start a new page,
1425 \family typewriter
1426
1427 \backslash
1428 clearpage
1429 \family default
1430  processes all remaining floats, then begins a new page.
1431  This may lead to an unsightly stack of figures in the middle of your document;
1432  you may need to use several
1433 \family typewriter
1434
1435 \backslash
1436 clearpages
1437 \family default
1438  to make things balance nicely.
1439 \end_layout
1440
1441 \begin_layout Subsection
1442 Math related questions
1443 \end_layout
1444
1445 \begin_layout Subsubsection
1446 How do I put normal text inside a mathematical equation?
1447 \end_layout
1448
1449 \begin_layout Standard
1450 Type
1451 \begin_inset Quotes eld
1452 \end_inset
1453
1454
1455 \family typewriter
1456 M-m m
1457 \family default
1458
1459 \begin_inset Quotes erd
1460 \end_inset
1461
1462  while inside the equation to enter
1463 \begin_inset Quotes eld
1464 \end_inset
1465
1466 math text mode
1467 \begin_inset Quotes erd
1468 \end_inset
1469
1470 .
1471 \end_layout
1472
1473 \begin_layout Subsubsection
1474 How do I make a cube root (or higher)?
1475 \end_layout
1476
1477 \begin_layout Standard
1478 Type
1479 \begin_inset Quotes eld
1480 \end_inset
1481
1482
1483 \family typewriter
1484 M-m r
1485 \family default
1486
1487 \begin_inset Quotes erd
1488 \end_inset
1489
1490  to insert a nifty
1491 \begin_inset Quotes eld
1492 \end_inset
1493
1494 root box
1495 \begin_inset Quotes erd
1496 \end_inset
1497
1498 .
1499  Use the cursor keys to navigate the entry boxes.
1500 \end_layout
1501
1502 \begin_layout Section
1503 Questions Related to Running LyX
1504 \end_layout
1505
1506 \begin_layout Subsection
1507 How do I convert LyX files to LaTeX from the command line?
1508 \end_layout
1509
1510 \begin_layout Standard
1511 File export was vastly improved in version 1.1.6.
1512  Simply say
1513 \end_layout
1514
1515 \begin_layout LyX-Code
1516 lyx --export latex <yourfile>.lyx
1517 \end_layout
1518
1519 \begin_layout Standard
1520 and that is all you need to do.
1521 \end_layout
1522
1523 \begin_layout Standard
1524 If you have an older version of LyX, you can use the same syntax if you
1525  are running X, because it will cause LyX windows to pop up onto your screen.
1526  If you have the Xvfb command available, you can resort to a deeper level
1527  of subterfuge (under
1528 \family typewriter
1529 bash
1530 \family default
1531 ):
1532 \end_layout
1533
1534 \begin_layout Standard
1535
1536 \family typewriter
1537 (Xvfb :1 -once -terminate &); rm <file>.tex; lyx -display :1 --export latex
1538  <file>.lyx
1539 \end_layout
1540
1541 \begin_layout Standard
1542 \noindent
1543 Under csh/tcsh it is simply
1544 \end_layout
1545
1546 \begin_layout Standard
1547
1548 \family typewriter
1549 Xvfb :1 -once -terminate &; rm <file>.tex; lyx -display :1 --export latex
1550  <file>.lyx
1551 \end_layout
1552
1553 \begin_layout Standard
1554 \noindent
1555 This should work anywhere, whether or not X is actually running.
1556 \end_layout
1557
1558 \begin_layout Subsection
1559 How do I create PDF files from my LyX document?
1560 \end_layout
1561
1562 \begin_layout Standard
1563 Read Section 5.3.6 of the
1564 \emph on
1565 Extended Features
1566 \emph default
1567  manual.
1568 \end_layout
1569
1570 \begin_layout Subsection
1571 Why do the fonts in my document look so bad in
1572 \family typewriter
1573 acroread
1574 \family default
1575  ?
1576 \end_layout
1577
1578 \begin_layout Standard
1579 The problem and the solution are also discussed in Section 5.3.6 of the
1580 \emph on
1581 Extended Features
1582 \emph default
1583  manual.
1584 \end_layout
1585
1586 \begin_layout Subsection
1587 Why doesn't my latest and greatest version of Ghostscript render EPS inline
1588  figures properly?
1589 \end_layout
1590
1591 \begin_layout Standard
1592 [Note: this only applies to versions of LyX older than 1.2.0, since the graphics
1593  rendering code has been rewritten in this version]
1594 \end_layout
1595
1596 \begin_layout Standard
1597 A couple of users reported that they couldn't get recent Ghostscript versions
1598  to display inline figures in LyX.
1599  It transpires that this is a Ghostscript bug:
1600 \end_layout
1601
1602 \begin_layout Standard
1603 \begin_inset LatexCommand \url{http://sourceforge.net/bugs/?func=detailbug&bug_id=124957&group_id=1897}
1604
1605 \end_inset
1606
1607
1608 \end_layout
1609
1610 \begin_layout Standard
1611 \noindent
1612 This bug appears to affect Ghostscript 6.22 and upwards.
1613  After applying the above mentioned patch, rendering in Lyx works fine again.
1614  GNU Ghostscript 6.53 and above include this fix.
1615 \end_layout
1616
1617 \begin_layout Section
1618 Questions Related to LyX on Windows
1619 \end_layout
1620
1621 \begin_layout Subsection
1622 Why do the menus and the toolbar flicker ?
1623 \end_layout
1624
1625 \begin_layout Standard
1626 You are probably using the XWin32 X server.
1627  This is a bug in XWin32: you can work around the problem by disabling the
1628
1629 \begin_inset Quotes eld
1630 \end_inset
1631
1632 Use Reserved Colors
1633 \begin_inset Quotes erd
1634 \end_inset
1635
1636  option of XWin32, and using a color mode other than PseudoColor.
1637 \end_layout
1638
1639 \begin_layout Section
1640 How to get further assistance
1641 \end_layout
1642
1643 \begin_layout Subsection
1644 You still haven't answered my question!
1645 \end_layout
1646
1647 \begin_layout Standard
1648 Then RTFM, especially the Tutorial.
1649  The documentation really is quite good.
1650  (Besides, I helped write parts of it :-) If you think your problem may
1651  be LaTeX related, then look in
1652 \emph on
1653 LaTeX, A Document Preparation System, 2nd Ed.
1654
1655 \emph default
1656  by Leslie Lamport (1994).
1657  There are also numerous example files included with LyX.
1658  Try
1659 \family sans
1660 File\SpecialChar \menuseparator
1661 Open\SpecialChar \menuseparator
1662 Examples
1663 \family default
1664 .
1665 \end_layout
1666
1667 \begin_layout Subsection
1668 I want to mail someone about my problem.
1669
1670 \end_layout
1671
1672 \begin_layout Standard
1673 Send email to the LyX Users list lyx-users@lists.lyx.org.
1674  If LyX is actually crashing or otherwise non-functional, then try the developer
1675 s' list at lyx-devel@lists.lyx.org.
1676 \end_layout
1677
1678 \begin_layout Subsection
1679 What to put in a request for help.
1680 \end_layout
1681
1682 \begin_layout Standard
1683 Include your version of LyX and a description of what you are trying to
1684  do, along with evidence that you've actually read the docs.
1685 \end_layout
1686
1687 \begin_layout Standard
1688 If LyX has crashed, include the version of LyX, the operating system, the
1689  version of xforms (if it seems to be a screen drawing problem), and a precise
1690  description of the events that lead to the crash.
1691  The easier it is for the developers to reproduce your crash, the more likely
1692  it will get fixed.
1693  If you're brave and like to hack, use gdb to generate a backtrace and include
1694  the results with your mail.
1695  If you have no clue what I'm talking about, just describe what you did
1696  as completely as you can.
1697 \end_layout
1698
1699 \begin_layout Section
1700 Administrative information and acknowledgments
1701 \end_layout
1702
1703 \begin_layout Subsection
1704 Feedback is invited.
1705
1706 \end_layout
1707
1708 \begin_layout Standard
1709 Send comments, suggested additions, world record document claims, etc.
1710  to
1711 \emph on
1712 lyx-docs@lists.lyx.org.
1713 \end_layout
1714
1715 \begin_layout Subsection
1716 Formats in which this FAQ is available.
1717
1718 \end_layout
1719
1720 \begin_layout Standard
1721 The LyX file original is included in the LyX source distribution, converted
1722  versions in HTML and ASCII should soon be available at the website.
1723  A German version is also available with the distribution.
1724 \end_layout
1725
1726 \begin_layout Subsection
1727 Authorship and acknowledgments.
1728 \end_layout
1729
1730 \begin_layout Standard
1731 Bernhard Iselborn, David Johnson, and Paul Evans were responsible for the
1732  FAQ through version 0.2.2 which covered LyX-0.10.7.
1733  The FAQ as of version 0.3.0 was written from scratch and covers LyX-1.0 and
1734  higher.
1735  Many people contributed pieces to the current version; Mike Ressler of
1736  the Doc Team collected them into this file.
1737 \end_layout
1738
1739 \begin_layout Subsection
1740 Disclaimer and Copyright.
1741
1742 \end_layout
1743
1744 \begin_layout Standard
1745 I don't claim anything in this document is accurate to within a factor of
1746
1747 \begin_inset Formula $\pi$
1748 \end_inset
1749
1750 ; after all, I'm just an astronomer, and we like to set
1751 \begin_inset Formula $c=h=k=\pi=1$
1752 \end_inset
1753
1754 .
1755  When the answer is wrong, we just redefine the units.
1756  This file is distributed in the hope that it will be useful, but WITHOUT
1757  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
1758  FOR A PARTICULAR PURPOSE.
1759  See the GNU General Public License for more details.
1760  In other words, it's not my fault if you lose your dissertation the night
1761  before your doctoral defense because you forgot to save it before the power
1762  failed while wondering how a fundamental physical constant expressed in
1763  units of
1764 \begin_inset Formula $\textrm{m s}^{-1}$
1765 \end_inset
1766
1767  could possibly be equal to one expressed as
1768 \begin_inset Formula $\textrm{kg m s}^{-2}\textrm{ K}^{-1}$
1769 \end_inset
1770
1771 .
1772  This file is Copyright © 2000 by Michael E.
1773  Ressler on behalf of the LyX Documentation Team.
1774 \end_layout
1775
1776 \end_body
1777 \end_document