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