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