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