tufte layout files:
[lyx.git] / development / attic / olddocs / FAQ.lyx
blob61fc11a5ff5e22e9b42e4a7631104c10c1df4e11
1 #LyX 1.6.0svn created this file. For more info see http://www.lyx.org/
2 \lyxformat 344
3 \begin_document
4 \begin_header
5 \textclass article
6 \use_default_options false
7 \language english
8 \inputencoding latin1
9 \font_roman default
10 \font_sans default
11 \font_typewriter default
12 \font_default_family default
13 \font_sc false
14 \font_osf false
15 \font_sf_scale 100
16 \font_tt_scale 100
18 \graphics default
19 \paperfontsize default
20 \spacing single
21 \use_hyperref false
22 \papersize default
23 \use_geometry true
24 \use_amsmath 0
25 \use_esint 0
26 \cite_engine basic
27 \use_bibtopic false
28 \paperorientation portrait
29 \leftmargin 3cm
30 \topmargin 2cm
31 \rightmargin 3cm
32 \bottommargin 3cm
33 \secnumdepth 3
34 \tocdepth 3
35 \paragraph_separation indent
36 \defskip medskip
37 \quotes_language english
38 \papercolumns 1
39 \papersides 1
40 \paperpagestyle default
41 \tracking_changes false
42 \output_changes false
43 \author "" 
44 \author "" 
45 \end_header
47 \begin_body
49 \begin_layout Title
50 LyX Frequently Asked Questions with Answers 
51 \end_layout
53 \begin_layout Author
54 by the LyX Team
55 \begin_inset Foot
56 status collapsed
58 \begin_layout Plain Layout
59 \noindent
60 If you have comments or error corrections, please send them to the LyX Documenta
61 tion mailing list, <
62 \begin_inset CommandInset href
63 LatexCommand href
64 target "lyx-docs@lists.lyx.org"
65 type "mailto:"
67 \end_inset
70 \end_layout
72 \end_inset
75 \end_layout
77 \begin_layout Abstract
78 This is the list of Frequently Asked Questions for LyX, the Open Source
79  document processor that provides a What-You-See-Is-What-You-Mean environment
80  for producing high quality documents.
81  For further help, you may wish to contact the LyX User Group mailing list
82  at 
83 \family typewriter
85 \begin_inset CommandInset href
86 LatexCommand href
87 target "lyx-users@lists.lyx.org"
88 type "mailto:"
90 \end_inset
93 \family default
95 \emph on
96 after
97 \emph default
98  you have read through the docs.
100 \end_layout
102 \begin_layout Abstract
103 \begin_inset CommandInset toc
104 LatexCommand tableofcontents
106 \end_inset
109 \end_layout
111 \begin_layout Section
112 Introduction and General Information 
113 \end_layout
115 \begin_layout Subsection
116 What is LyX? 
117 \end_layout
119 \begin_layout Standard
120 LyX is a program that provides a more modern approach to writing documents
121  with a computer, an approach that breaks with the obsolete tradition of
122  the 
123 \begin_inset Quotes eld
124 \end_inset
126 typewriter concept.
127 \begin_inset Quotes erd
128 \end_inset
130  It is designed for authors who want professional output quickly with a
131  minimum of effort without becoming specialists in typesetting.
132  The job of typesetting is done mostly by the computer, not the author;
133  with LyX, the author can concentrate on the contents of her writing.
134 \end_layout
136 \begin_layout Standard
137 LyX provides an 
138 \begin_inset Quotes eld
139 \end_inset
141 almost-WYSIWYG
142 \begin_inset Quotes erd
143 \end_inset
145  view of the document.
147 \begin_inset Quotes eld
148 \end_inset
150 Almost
151 \begin_inset Quotes erd
152 \end_inset
154  means that the line- and page-breaks are not displayed exactly as they
155  will appear in the printed document.
156  However, that's not really necessary, since LyX uses a separate typesetter
157  program (called LaTeX) to perform the final formatting of your text.
158  While LyX contains everything it needs to be a comfortable user interface,
159  the typesetting program contains everything necessary to format text, and
160  do so very, very well.
162 \end_layout
164 \begin_layout Standard
165 So, line- and page-breaks aren't your problem anymore.
166  Remembering which number to use for the next subsection isn't your problem
167  anymore.
168  Recalling what font you used for all of your section headings isn't your
169  problem anymore.
170  You tell LyX (and LaTeX) what 
171 \emph on
172 kind
173 \emph default
174  of document you're editing and what 
175 \emph on
176 type
177 \emph default
178  of paragraph this-or-that text is, the computer can typeset it accordingly.
179  Of course you can also still do some low-level formatting for fine-tuning.
180  However, the proper way with LyX is to tell the computer what the text
182 \emph on
184 \emph default
185 , not what it should look like.
186  So, we like to say that LyX gives you WYSIWYM editing (What You See Is
187  What You 
188 \emph on
189 Mean
190 \emph default
192 \end_layout
194 \begin_layout Subsection
195 That's fine, but is it useful?
196 \end_layout
198 \begin_layout Standard
199 Absolutely.
200  The following type of documents have been produced with LyX:
201 \end_layout
203 \begin_layout Itemize
204 Memos
205 \end_layout
207 \begin_layout Itemize
208 Letters
209 \end_layout
211 \begin_layout Itemize
212 Dissertations (260 pages in a single document, longer using include files)
213 \end_layout
215 \begin_deeper
216 \begin_layout Itemize
217 for example, 
218 \begin_inset Flex URL
219 status collapsed
221 \begin_layout Plain Layout
223 http://www.fee.uva.nl/scholar/mdw/leuven/thesis.pdf
224 \end_layout
226 \end_inset
229 \end_layout
231 \end_deeper
232 \begin_layout Itemize
233 Lecture notes (133 pages, 27 figures on a 33 MHz 486 machine!) 
234 \end_layout
236 \begin_layout Itemize
237 Seminar notebooks (500+ pages)
238 \end_layout
240 \begin_layout Itemize
241 Conference proceedings (Proceedings of the Second Continental Workshop on
242  the Geoid in Europe, (Finnish Geodetic Institute Report 98:4), 292 pages)
243 \end_layout
245 \begin_layout Itemize
246 Software Documentation (the LyX User Guide is about 120 pages) 
247 \end_layout
249 \begin_layout Itemize
250 Books 
251 \end_layout
253 \begin_deeper
254 \begin_layout Itemize
255 see 
256 \begin_inset Flex URL
257 status collapsed
259 \begin_layout Plain Layout
261 http://www.postgresql.org/docs/awbook.html
262 \end_layout
264 \end_inset
266  for an example on PostgreSQL
267 \end_layout
269 \begin_layout Itemize
270 Donnay, J-P., Barnsley, M.J., and Longley, P.A., eds., 2001, Remote Sensing and
271  Urban Analysis (Taylor and Francis: London).
272 \end_layout
274 \begin_layout Itemize
275 Herbert Voss: Praktische Kryptologie mit Java 286 pages, lots of equations,
276  tables, figures.
277  ISBN 3-8311-1458-7
278 \end_layout
280 \begin_layout Itemize
281 Yann Collette and Patrick Siarry, Optimisation multiobjectifs, 2002, Eyrolles
282 \end_layout
284 \end_deeper
285 \begin_layout Itemize
286 Papers published in the following refereed journals:
287 \end_layout
289 \begin_deeper
290 \begin_layout Itemize
291 Astronomy & Astrophysics (Suetterlin, P.
292  1998, A&A, 333, 305; Suetterlin, P.
293  & Wiehr, E.
294  1998, A&A, 336, 367)
295 \end_layout
297 \begin_layout Itemize
298 Astronomical Journal (Ressler, M.
299  E.
300  & Barsony, M.
301  2001, AJ, 121, 1098)
302 \end_layout
304 \end_deeper
305 \begin_layout Itemize
306 Novels (400+ page novel due out in September 2000; an 836 page novel is
307  currently with an agent)
308 \end_layout
310 \begin_layout Itemize
311 Scripts for plays and movies
312 \end_layout
314 \begin_layout Itemize
315 Business proposals for > $1 M (US)
316 \end_layout
318 \begin_layout Subsection
319 Where do I start? 
320 \end_layout
322 \begin_layout Standard
323 The website 
324 \begin_inset Flex URL
325 status collapsed
327 \begin_layout Plain Layout
329 www.lyx.org
330 \end_layout
332 \end_inset
334  is the first place to go for anything related to LyX.
335  News, examples, downloads, and lots of other stuff is available there.
336  After you have installed LyX and started it the first time, read the Tutorial
338 \family sans
339 Help\SpecialChar \menuseparator
340 Tutorial
341 \family default
343  Yes, I really mean that.
344 \end_layout
346 \begin_layout Standard
347 Another basic introductory guide may be found at 
348 \begin_inset Flex URL
349 status collapsed
351 \begin_layout Plain Layout
353 www.bilkent.edu.tr/~robin/lyxguide.pdf
354 \end_layout
356 \end_inset
359 \end_layout
361 \begin_layout Subsection
362 Does LyX run on my computer?
363 \end_layout
365 \begin_layout Standard
366 LyX is known to run on the following platforms (and probably a zillion others):
367 \end_layout
369 \begin_layout Itemize
370 Linux distributions: Debian, RedHat, SUSE, Mandrake, Fedora, Ubuntu, Gentoo,
371  etc
372 \end_layout
374 \begin_layout Itemize
375 Microsoft Window NT, 2000, XP, Vista (Windows 95/98/Me editions are not
376  supported)
377 \end_layout
379 \begin_layout Itemize
380 MacOSX (starting from 10.1)
381 \end_layout
383 \begin_layout Itemize
384 SparcLinux: RedHat 6.0
385 \end_layout
387 \begin_layout Itemize
388 Sun Solaris 2.6, 2.7
389 \end_layout
391 \begin_layout Itemize
392 Tru64 Unix 4.0f
393 \end_layout
395 \begin_layout Itemize
396 HP-UX
397 \end_layout
399 \begin_layout Itemize
400 OSF1 flore V4.0 1091 alpha
401 \end_layout
403 \begin_layout Subsection
404 How much hard disk space does LyX need? 
405 \end_layout
407 \begin_layout Standard
408 Binary size depends on the system, the LyX binary consumes 13 MB of disk
409  space on Windows, while the supporting files occupy another 25 MB (17 MB
410  of which is consumed by the docs! You can delete the languages you don't
411  care about to save some space).
412  Of course, you do need to have something like teTeX installed which consumes
413  a mere 115 MB, as well as ghostscript, which is another 10 MB!
414 \end_layout
416 \begin_layout Subsection
417 Is LyX really Open Source? 
418 \end_layout
420 \begin_layout Standard
421 Yes.
422  The freely available GUI toolkit that LyX uses, Qt, although a proprietary
423  product of Troll Tech, is used in its open source GPL variant.
424  The LyX source itself is also available under the GPL, so it qualifies.
425 \end_layout
427 \begin_layout Section
428 Internet Resources
429 \end_layout
431 \begin_layout Subsection
432 Where should I look on the World Wide Web for LyX stuff? 
433 \end_layout
435 \begin_layout Itemize
436 \begin_inset Flex URL
437 status open
439 \begin_layout Plain Layout
441 www.lyx.org
442 \end_layout
444 \end_inset
447 \end_layout
449 \begin_layout Itemize
450 \begin_inset Flex URL
451 status open
453 \begin_layout Plain Layout
455 bugzilla.lyx.org
456 \end_layout
458 \end_inset
460 , if you want to report a bug in LyX.
461 \end_layout
463 \begin_layout Subsection
464 Where can I get LyX material by FTP? 
465 \end_layout
467 \begin_layout Itemize
468 ftp.lyx.org in /pub/lyx (also known as ftp.via.ecp.fr)
469 \end_layout
471 \begin_layout Subsection
472 What mailing lists are there? 
473 \end_layout
475 \begin_layout Itemize
476 lyx-announce@lists.lyx.org (very low volume), for announcements related to
477  LyX
478 \end_layout
480 \begin_layout Itemize
481 lyx-users@lists.lyx.org (medium volume), for general usage issues
482 \end_layout
484 \begin_layout Itemize
485 lyx-devel@lists.lyx.org (high volume), for development and debugging issues
486 \end_layout
488 \begin_layout Itemize
489 lyx-docs@lists.lyx.org (excruciatingly low volume), for documentation issues
491 \end_layout
493 \begin_layout Standard
494 Generally, you would send email to lyx-foo-subscribe@lists.lyx.org to subscribe
495  to these lists or to lyx-foo-unsubscribe@lists.lyx.org to unsubscribe, where
497 \begin_inset Quotes eld
498 \end_inset
501 \begin_inset Quotes erd
502 \end_inset
504  is one of 
505 \begin_inset Quotes eld
506 \end_inset
508 announce
509 \begin_inset Quotes erd
510 \end_inset
513 \begin_inset Quotes eld
514 \end_inset
516 users
517 \begin_inset Quotes erd
518 \end_inset
521 \begin_inset Quotes eld
522 \end_inset
524 devel
525 \begin_inset Quotes erd
526 \end_inset
528 , or 
529 \begin_inset Quotes eld
530 \end_inset
532 docs
533 \begin_inset Quotes erd
534 \end_inset
536 ; definitely see 
537 \begin_inset Flex URL
538 status open
540 \begin_layout Plain Layout
542 http://www.lyx.org/MailingLists
543 \end_layout
545 \end_inset
547  for the full details.
548 \end_layout
550 \begin_layout Subsection
551 Are the mailing lists archived anywhere? 
552 \end_layout
554 \begin_layout Standard
555 Yes.
556  :-)
557 \end_layout
559 \begin_layout Subsection
560 Okay, wise guy! Where are they archived?
561 \end_layout
563 \begin_layout Itemize
564 Announce: 
565 \begin_inset Flex URL
566 status open
568 \begin_layout Plain Layout
570 http://www.mail-archive.com/lyx-announce@lists.lyx.org/
571 \end_layout
573 \end_inset
576 \end_layout
578 \begin_layout Itemize
579 Users: 
580 \begin_inset Flex URL
581 status open
583 \begin_layout Plain Layout
585 http://www.mail-archive.com/lyx-users@lists.lyx.org/
586 \end_layout
588 \end_inset
591 \end_layout
593 \begin_layout Itemize
594 Devel: 
595 \begin_inset Flex URL
596 status open
598 \begin_layout Plain Layout
600 http://www.mail-archive.com/lyx-devel@lists.lyx.org/
601 \end_layout
603 \end_inset
606 \end_layout
608 \begin_layout Section
609 Compatibility with other word/document processors
610 \end_layout
612 \begin_layout Subsection
613 Can I read/write LaTeX files?
614 \end_layout
616 \begin_layout Standard
617 Yes.
618  LyX outputs LaTeX files that are either machine or human friendly.
619  The 
620 \family typewriter
621 tex2lyx
622 \family default
623  program that comes with LyX does a decent job of converting LaTeX into
624  LyX.
625  It's not perfect, but it will usually get at least 95% of the job done
626  for you.
627 \end_layout
629 \begin_layout Subsection
630 Can I read/write Word files?
631 \end_layout
633 \begin_layout Standard
634 Not trivially.
635  See these page: 
636 \begin_inset Flex URL
637 status open
639 \begin_layout Plain Layout
641 http://wiki.lyx.org/LyX/ConvertingFromWord
642 \end_layout
644 \end_inset
646  and also the converters section which will give another possibilities of
647  conversion routes: 
648 \begin_inset Flex URL
649 status open
651 \begin_layout Plain Layout
653 http://www.lyx.org/AdditionalSoftware#toc9
654 \end_layout
656 \end_inset
659 \end_layout
661 \begin_layout Standard
662 Finally, when all else fails, use any word processor (WordPerfect, StarOffice/Op
663 enOffice, ...) which understands Word.
664  Then export as the file as plain text and add the formatting by hand in
665  LyX.
667 \end_layout
669 \begin_layout Subsection
670 Can I read/write HTML files?
671 \end_layout
673 \begin_layout Standard
674 You can output HTML files using the 
675 \begin_inset Quotes eld
676 \end_inset
679 \begin_inset Quotes erd
680 \end_inset
682  converter program, amongst others.
683  There is a HTML
684 \begin_inset Formula $\rightarrow$
685 \end_inset
687 LaTeX program available (html2latex) which allows you to convert the other
688  direction.
689 \end_layout
691 \begin_layout Section
692 Obtaining and Compiling LyX 
693 \end_layout
695 \begin_layout Subsection
696 What do I need?
697 \end_layout
699 \begin_layout Itemize
700 LyX source code: lyx-1.x.x.tar.gz
701 \end_layout
703 \begin_layout Itemize
704 Qt library: Qt-4.2.0 or higher (using the latest version available is recommended)
705 \end_layout
707 \begin_layout Itemize
708 A LaTeX installation: we strongly recommend teTeX/TeXLive on Linux, MikTeX
709  on Window
710 \end_layout
712 \begin_layout Itemize
713 A PostScript® interpreter: ghostscript 7.0 or higher
714 \end_layout
716 \begin_layout Itemize
717 A modern C++ compiler.
718  If you are using gcc, LyX requires at least version 3.2.0.
719 \end_layout
721 \begin_layout Subsection
722 How do I compile it?
723 \end_layout
725 \begin_layout Itemize
726 ./configure
727 \end_layout
729 \begin_layout Itemize
730 make
731 \end_layout
733 \begin_layout Itemize
734 make install (usually as root, though you don't have to be if you add flags
735  to the configure command)
736 \end_layout
738 \begin_layout Standard
739 See the INSTALL file for more details.
740 \end_layout
742 \begin_layout Subsection
743 I hate compiling.
744  Where are precompiled binaries?
745 \end_layout
747 \begin_layout Standard
748 Most of the above packages are available as precompiled binaries in a variety
749  of Linux systems, perhaps others as well.
750  The LyX binaries are available as RPMS, Windows and Mac installers, plus
751  a few other formats and may be obtained from 
752 \begin_inset Flex URL
753 status collapsed
755 \begin_layout Plain Layout
757 ftp://ftp.lyx.org/pub/lyx/bin/
758 \end_layout
760 \end_inset
763 \end_layout
765 \begin_layout Section
766 Questions about Evil Red Text (IMPORTANT!)
767 \end_layout
769 \begin_layout Subsection
770 What is Evil Red Text (aka ERT)?
771 \end_layout
773 \begin_layout Standard
774 ERT (Evil Red Text) refers to raw LaTeX commands which are inserted into
775  your LyX document.
776  Certain troglodytes in the development group coined this term when they
777  complained about the unsightly appearance it leads to in LyX documents.
778  The more enlightened among us know that it is extremely useful, even though
779  it does qualify as URT (Ugly Red Text), but ERT seems to have stuck.
781 \end_layout
783 \begin_layout Subsection
784 How do I enter Evil Red Text?
785 \end_layout
787 \begin_layout Standard
788 Aesthetic arguments aside, many of the answers in this FAQ require that
789  you use ERT, so whenever we say 
790 \begin_inset Quotes eld
791 \end_inset
793 insert the following LaTeX code
794 \begin_inset Quotes erd
795 \end_inset
797 , do the following
798 \end_layout
800 \begin_layout Enumerate
801 Click the TeX toolbar button or select 
802 \family sans
803 \bar under
805 \bar default
806 nsert\SpecialChar \menuseparator
808 \bar under
810 \bar default
812 \family default
814 \end_layout
816 \begin_layout Enumerate
817 Type the command as it is written in the normal way
818 \end_layout
820 \begin_layout Subsection
821 Is there an alternative?
822 \end_layout
824 \begin_layout Standard
825 LaTeX commands can also be inserted in the 
826 \begin_inset Quotes eld
827 \end_inset
829 LaTeX Preamble
830 \begin_inset Quotes erd
831 \end_inset
833 , a form in LyX that is inserted verbatim into the LaTeX file which is generated
834  during processing.
835  This is especially useful for including nonstandard LaTeX packages, defining
836  global shortcuts to be used within the document, etc.
837 \end_layout
839 \begin_layout Section
840 Questions Related to Using LyX
841 \end_layout
843 \begin_layout Standard
844 In this section, we attempt to address the truly most frequently asked questions.
845  For a broader range of not-so-frequently asked questions and many 
846 \begin_inset Quotes eld
847 \end_inset
849 how do I?
850 \begin_inset Quotes erd
851 \end_inset
853  topics, see Herbert Voss' spectacular collection at 
854 \begin_inset Flex URL
855 status collapsed
857 \begin_layout Plain Layout
859 http://tug.org/TeXnik/
860 \end_layout
862 \end_inset
865  You are doing yourself a large disservice if you don't check there before
866  sending a message to the mailing lists!
867 \end_layout
869 \begin_layout Subsection
870 General questions
871 \end_layout
873 \begin_layout Subsubsection
874 How do I get rid of the date under the title?
875 \end_layout
877 \begin_layout Standard
878 The simplest solution is to open the menu 
879 \family sans
880 \bar under
882 \bar default
883 ayout\SpecialChar \menuseparator
885 \bar under
887 \bar default
888 eamble
889 \family default
890  and add the line
891 \end_layout
893 \begin_layout LyX-Code
895 \backslash
896 date{}
897 \end_layout
899 \begin_layout Standard
900 in the preamble window.
901 \end_layout
903 \begin_layout Subsubsection
904 How do I change the spacing in an Itemize/\SpecialChar \-
905 Enumerate/\SpecialChar \-
906 Description list environment
908 \end_layout
910 \begin_layout Standard
911 You'll have to do this by hand: for example, for one particular list, you
912  can add the following LaTeX code at the beginning of the list: 
913 \end_layout
915 \begin_layout Standard
917 \family typewriter
919 \backslash
920 setlength{
921 \backslash
922 itemsep}{0mm}
923 \end_layout
925 \begin_layout Subsubsection
926 How do I number equations by section?
927 \end_layout
929 \begin_layout Standard
930 Add the following two lines to your LaTeX preamble:
931 \end_layout
933 \begin_layout LyX-Code
935 \backslash
936 @addtoreset{equation}{section} 
937 \end_layout
939 \begin_layout LyX-Code
941 \backslash
942 renewcommand{
943 \backslash
944 theequation}{
945 \backslash
946 thesection.
947 \backslash
948 arabic{equation}}
949 \end_layout
951 \begin_layout Subsubsection
952 Is it possible to do this for figures and tables as well?
953 \end_layout
955 \begin_layout Standard
956 Replace the phrase 
957 \family typewriter
959 \backslash
960 theequation
961 \family default
962  with 
963 \family typewriter
965 \backslash
966 thetable
967 \family default
968  or 
969 \family typewriter
971 \backslash
972 thefigure
973 \family default
974  and then replace 
975 \family typewriter
976 equation
977 \family default
978  with 
979 \family typewriter
980 table
981 \family default
982  or 
983 \family typewriter
984 figure
985 \family default
987  Don't forget to adapt the 
988 \backslash
989 @addtoreset command, too.
990 \end_layout
992 \begin_layout Subsubsection
993 How do I change to footnote numbers to symbols (star, dagger, etc.)?
994 \end_layout
996 \begin_layout Standard
997 Add 
998 \family typewriter
1000 \backslash
1001 renewcommand{
1002 \backslash
1003 thefootnote}{
1004 \backslash
1005 fnsymbol{footnote}}
1006 \family default
1007  to your LaTeX preamble.
1008 \end_layout
1010 \begin_layout Subsubsection
1011 How do I kill widows and orphans?
1012 \end_layout
1014 \begin_layout Standard
1015 Okay, we are not playing Duke Nukem here! To eliminate widows and orphans
1016  (first line from a paragraph at the bottom of the page and the last line
1017  from a paragraph at the top of the page), add the following to the LaTeX
1018  preamble:
1019 \end_layout
1021 \begin_layout LyX-Code
1023 \backslash
1024 widowpenalty=10000 
1025 \end_layout
1027 \begin_layout LyX-Code
1029 \backslash
1030 clubpenalty=10000 
1031 \end_layout
1033 \begin_layout Standard
1034 and perhaps
1035 \end_layout
1037 \begin_layout LyX-Code
1039 \backslash
1040 raggedbottom
1041 \end_layout
1043 \begin_layout LyX-Code
1045 \end_layout
1047 \begin_layout Subsubsection
1048 How do I get a formatted list which starts with e.g.
1049  1.
1050  a)?
1051 \end_layout
1053 \begin_layout Standard
1054 If you want a list which looks like
1055 \end_layout
1057 \begin_layout LyX-Code
1059  a) First alternative 
1060 \end_layout
1062 \begin_layout LyX-Code
1063    b) Second alternative 
1064 \end_layout
1066 \begin_layout LyX-Code
1067    c) Third alternative
1068 \end_layout
1070 \begin_layout Standard
1071 then try the following
1072 \end_layout
1074 \begin_layout LyX-Code
1076  {} 
1077 \end_layout
1079 \begin_layout LyX-Code
1080    a) First alternative 
1081 \end_layout
1083 \begin_layout LyX-Code
1084    b) Second alternative 
1085 \end_layout
1087 \begin_layout LyX-Code
1088    c) Third
1089 \end_layout
1091 \begin_layout Standard
1092 where {} is in ERT (i.e.
1093  a placeholder not generating output.
1094  Specifically, set the style to 
1095 \begin_inset Quotes eld
1096 \end_inset
1098 enumerate
1099 \begin_inset Quotes erd
1100 \end_inset
1102 , enter the brackets in ERT, change the environment depth, and add the three
1103  elements.
1104  LyX will auto-label the entries.
1105 \end_layout
1107 \begin_layout Subsubsection
1108 How do I insert a fixed amount of horizontal space?
1109 \end_layout
1111 \begin_layout Standard
1112 Use Insert>Formatting>Horizontal Space.
1114 \end_layout
1116 \begin_layout Subsubsection
1117 How can I make citations show up as [1,2,3,6] or [1-3,6] rather than [1][2][3][6
1119 \end_layout
1121 \begin_layout Standard
1122 Insert 
1123 \family typewriter
1125 \backslash
1126 usepackage{cite}
1127 \family default
1128  into the LaTeX preamble.
1129  Most LaTeX distributions should have this package included.
1130  LyX supports this package, if you insert multiple citations separated by
1131  commas into the citation dialog, e.
1132  g.
1133  [Smalley_JCP,Jarrold_Sci], instead of just one citation after the other:
1134  [Smalley_JCP] [Jarrold_Sci].
1135 \end_layout
1137 \begin_layout Subsection
1138 Figure related questions
1139 \end_layout
1141 \begin_layout Subsubsection
1142 What is the difference between a 
1143 \begin_inset Quotes eld
1144 \end_inset
1146 figure
1147 \begin_inset Quotes erd
1148 \end_inset
1150  and a 
1151 \begin_inset Quotes eld
1152 \end_inset
1154 figure float
1155 \begin_inset Quotes erd
1156 \end_inset
1159 \end_layout
1161 \begin_layout Standard
1162 This is an example of less-than-ideal terminology.
1164 \begin_inset Quotes eld
1165 \end_inset
1167 Figure
1168 \begin_inset Quotes erd
1169 \end_inset
1171  is what you might call a 
1172 \begin_inset Quotes eld
1173 \end_inset
1175 graphic
1176 \begin_inset Quotes erd
1177 \end_inset
1179 ; it basically means insert a picture file.
1181 \begin_inset Quotes eld
1182 \end_inset
1184 Figure float
1185 \begin_inset Quotes erd
1186 \end_inset
1188  is more what one means by a figure in a paper: it includes the graphic,
1189  the caption, the figure label, etc.
1190  You should almost always insert a figure float first, then put a figure
1191  inside that.
1192 \end_layout
1194 \begin_layout Standard
1195 Tables work in the same manner.
1196  Put a table float in first, then insert the table within that.
1197 \end_layout
1199 \begin_layout Subsubsection
1200 How do I get LyX to put the figure exactly where I want it?
1201 \end_layout
1203 \begin_layout Standard
1204 If you want to control how an individual figure behaves, right-click in
1205  the figure float and you will get a dialog allowing to control the figure
1206  behavior.
1207  If you want to control how they all behave, look at 
1208 \family sans
1209 Document\SpecialChar \menuseparator
1210 Settings\SpecialChar \menuseparator
1211 Float Placement
1212 \family default
1214 \end_layout
1216 \begin_layout Subsubsection
1217 What does 
1218 \begin_inset Quotes eld
1219 \end_inset
1221 Too many unprocessed floats
1222 \begin_inset Quotes erd
1223 \end_inset
1225  mean?
1226 \end_layout
1228 \begin_layout Standard
1229 LaTeX can handle only a limited number of floating elements floating at
1230  a given time.
1231  For example, if Figure 4 can't be fit in a good location (using the default
1232  rules of top of the page, then bottom, then a page of its own) and Figure
1233  5 comes along, they will both continue to float toward the end of the document
1234  until a good location can be found.
1235  If nothing good turns up, they will just be placed at the end of the document.
1236  If there are too many of these, LaTeX overruns a counter and emits the
1238 \begin_inset Quotes eld
1239 \end_inset
1241 too many unprocessed floats
1242 \begin_inset Quotes erd
1243 \end_inset
1245  error.
1246  This is not a bug in LaTeX, this is simply too many figures with too little
1247  text :-)
1248 \end_layout
1250 \begin_layout Standard
1251 The easiest way to work around this is to insert a 
1252 \family typewriter
1254 \backslash
1255 clearpage
1256 \family default
1257  command somewhere in the document where a pagebreak would be appropriate.
1258  While a pagebreak would simply start a new page, 
1259 \family typewriter
1261 \backslash
1262 clearpage
1263 \family default
1264  processes all remaining floats, then begins a new page.
1265  This may lead to an unsightly stack of figures in the middle of your document;
1266  you may need to use several 
1267 \family typewriter
1269 \backslash
1270 clearpages
1271 \family default
1272  to make things balance nicely.
1273 \end_layout
1275 \begin_layout Subsection
1276 Math related questions
1277 \end_layout
1279 \begin_layout Subsubsection
1280 How do I put normal text inside a mathematical equation?
1281 \end_layout
1283 \begin_layout Standard
1284 Type 
1285 \begin_inset Quotes eld
1286 \end_inset
1289 \family typewriter
1290 M-m m
1291 \family default
1293 \begin_inset Quotes erd
1294 \end_inset
1296  while inside the equation to enter 
1297 \begin_inset Quotes eld
1298 \end_inset
1300 math text mode
1301 \begin_inset Quotes erd
1302 \end_inset
1305 \end_layout
1307 \begin_layout Subsubsection
1308 How do I make a cube root (or higher)?
1309 \end_layout
1311 \begin_layout Standard
1312 Type 
1313 \begin_inset Quotes eld
1314 \end_inset
1317 \family typewriter
1318 M-m r
1319 \family default
1321 \begin_inset Quotes erd
1322 \end_inset
1324  to insert a nifty 
1325 \begin_inset Quotes eld
1326 \end_inset
1328 root box
1329 \begin_inset Quotes erd
1330 \end_inset
1333  Use the cursor keys to navigate the entry boxes.
1334 \end_layout
1336 \begin_layout Section
1337 Questions Related to Running LyX
1338 \end_layout
1340 \begin_layout Subsection
1341 How do I convert LyX files to LaTeX from the command line?
1342 \end_layout
1344 \begin_layout Standard
1345 Simply say
1346 \end_layout
1348 \begin_layout LyX-Code
1349 lyx --export latex <yourfile>.lyx
1350 \end_layout
1352 \begin_layout Standard
1353 and that is all you need to do.
1354  Other formats can be exported in the same way.
1355 \end_layout
1357 \begin_layout Subsection
1358 Why do the fonts in my document look so bad in 
1359 \family typewriter
1360 acroread
1361 \family default
1363 \end_layout
1365 \begin_layout Standard
1366 The problem and the solution are also discussed in Section 5.3.6 of the 
1367 \emph on
1368 Extended Features
1369 \emph default
1370  manual.
1371 \end_layout
1373 \begin_layout Section
1374 Questions Related to LyX on Windows
1375 \end_layout
1377 \begin_layout Subsection
1378 Why do the menus and the toolbar flicker ?
1379 \end_layout
1381 \begin_layout Standard
1382 You are probably using the XWin32 X server.
1383  This is a bug in XWin32: you can work around the problem by disabling the
1385 \begin_inset Quotes eld
1386 \end_inset
1388 Use Reserved Colors
1389 \begin_inset Quotes erd
1390 \end_inset
1392  option of XWin32, and using a color mode other than PseudoColor.
1393 \end_layout
1395 \begin_layout Section
1396 How to get further assistance
1397 \end_layout
1399 \begin_layout Subsection
1400 You still haven't answered my question! 
1401 \end_layout
1403 \begin_layout Standard
1404 Then RTFM, especially the Tutorial.
1405  The documentation really is quite good.
1406  (Besides, I helped write parts of it :-) If you think your problem may
1407  be LaTeX related, then look in 
1408 \emph on
1409 LaTeX, A Document Preparation System, 2nd Ed.
1411 \emph default
1412  by Leslie Lamport (1994).
1413  There are also numerous example files included with LyX.
1414  Try 
1415 \family sans
1416 File\SpecialChar \menuseparator
1417 Open\SpecialChar \menuseparator
1418 Examples
1419 \family default
1421  Don't forget we have Tips and Tricks database in LyX wiki.
1422 \end_layout
1424 \begin_layout Subsection
1425 I want to mail someone about my problem.
1427 \end_layout
1429 \begin_layout Standard
1430 Send email to the LyX Users list lyx-users@lists.lyx.org.
1431  If LyX is actually crashing or otherwise non-functional, then try the developer
1432 s' list at lyx-devel@lists.lyx.org.
1433 \end_layout
1435 \begin_layout Subsection
1436 What to put in a request for help.
1437 \end_layout
1439 \begin_layout Standard
1440 Include your version of LyX and a description of what you are trying to
1441  do, along with evidence that you've actually read the docs.
1442 \end_layout
1444 \begin_layout Standard
1445 If LyX has crashed, include the version of LyX, the operating system, the
1446  version of xforms (if it seems to be a screen drawing problem), and a precise
1447  description of the events that lead to the crash.
1448  The easier it is for the developers to reproduce your crash, the more likely
1449  it will get fixed.
1450  If you're brave and like to hack, use gdb to generate a backtrace and include
1451  the results with your mail.
1452  If you have no clue what I'm talking about, just describe what you did
1453  as completely as you can.
1454 \end_layout
1456 \begin_layout Section
1457 Administrative information and acknowledgments
1458 \end_layout
1460 \begin_layout Subsection
1461 Feedback is invited.
1463 \end_layout
1465 \begin_layout Standard
1466 Send comments, suggested additions, world record document claims, etc.
1467  to 
1468 \emph on
1469 lyx-docs@lists.lyx.org.
1470 \end_layout
1472 \begin_layout Subsection
1473 Formats in which this FAQ is available.
1475 \end_layout
1477 \begin_layout Standard
1478 The LyX file original is included in the LyX source distribution, converted
1479  versions in HTML and ASCII should soon be available at the website.
1480  A German version is also available with the distribution.
1481 \end_layout
1483 \begin_layout Subsection
1484 Authorship and acknowledgments.
1485 \end_layout
1487 \begin_layout Standard
1488 Bernhard Iselborn, David Johnson, and Paul Evans were responsible for the
1489  FAQ through version 0.2.2 which covered LyX-0.10.7.
1490  The FAQ as of version 0.3.0 was written from scratch and covers LyX-1.0 and
1491  higher.
1492  Many people contributed pieces to the current version; Mike Ressler of
1493  the Doc Team collected them into this file.
1494 \end_layout
1496 \begin_layout Subsection
1497 Disclaimer and Copyright.
1499 \end_layout
1501 \begin_layout Standard
1502 I don't claim anything in this document is accurate to within a factor of
1504 \begin_inset Formula $\pi$
1505 \end_inset
1507 ; after all, I'm just an astronomer, and we like to set 
1508 \begin_inset Formula $c=h=k=\pi=1$
1509 \end_inset
1512  When the answer is wrong, we just redefine the units.
1513  This file is distributed in the hope that it will be useful, but WITHOUT
1514  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
1515  FOR A PARTICULAR PURPOSE.
1516  See the GNU General Public License for more details.
1517  In other words, it's not my fault if you lose your dissertation the night
1518  before your doctoral defense because you forgot to save it before the power
1519  failed while wondering how a fundamental physical constant expressed in
1520  units of 
1521 \begin_inset Formula $\textrm{m s}^{-1}$
1522 \end_inset
1524  could possibly be equal to one expressed as 
1525 \begin_inset Formula $\textrm{kg m s}^{-2}\textrm{ K}^{-1}$
1526 \end_inset
1529  This file is Copyright © 2000 by Michael E.
1530  Ressler on behalf of the LyX Documentation Team.
1531 \end_layout
1533 \end_body
1534 \end_document