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