]> git.lyx.org Git - lyx.git/blob - lib/doc/FAQ.lyx
FAQ is way out of date!
[lyx.git] / lib / doc / FAQ.lyx
1 #LyX 1.6svn 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, etc
370 \end_layout
371
372 \begin_layout Itemize
373 Microsoft Window NT, 2000, XP, Vista (Windows 95/98/Me editions are not
374  supported)
375 \end_layout
376
377 \begin_layout Itemize
378 MacOSX (starting from 10.1)
379 \end_layout
380
381 \begin_layout Itemize
382 SparcLinux: RedHat 6.0
383 \end_layout
384
385 \begin_layout Itemize
386 Sun Solaris 2.6, 2.7
387 \end_layout
388
389 \begin_layout Itemize
390 Tru64 Unix 4.0f
391 \end_layout
392
393 \begin_layout Itemize
394 HP-UX
395 \end_layout
396
397 \begin_layout Itemize
398 OSF1 flore V4.0 1091 alpha
399 \end_layout
400
401 \begin_layout Subsection
402 How much hard disk space does LyX need? 
403 \end_layout
404
405 \begin_layout Standard
406 Binary size depends on the system, the LyX binary consumes 13 MB of disk
407  space on Windows, while the supporting files occupy another 25 MB (17 MB
408  of which is consumed by the docs! You can delete the languages you don't
409  care about to save some space).
410  Of course, you do need to have something like teTeX installed which consumes
411  a mere 115 MB, as well as ghostscript, which is another 10 MB!
412 \end_layout
413
414 \begin_layout Subsection
415 Is LyX really Open Source? 
416 \end_layout
417
418 \begin_layout Standard
419 Yes.
420  The freely available GUI toolkit that LyX uses, Qt, although a proprietary
421  product of Troll Tech, is used in its open source GPL variant.
422  The LyX source itself is also available under the GPL, so it qualifies.
423 \end_layout
424
425 \begin_layout Section
426 Internet Resources
427 \end_layout
428
429 \begin_layout Subsection
430 Where should I look on the World Wide Web for LyX stuff? 
431 \end_layout
432
433 \begin_layout Itemize
434 \begin_inset Flex URL
435 status collapsed
436
437 \begin_layout Plain Layout
438
439 www.lyx.org
440 \end_layout
441
442 \end_inset
443
444
445 \end_layout
446
447 \begin_layout Itemize
448 \begin_inset Flex URL
449 status collapsed
450
451 \begin_layout Plain Layout
452
453 bugzilla.lyx.org
454 \end_layout
455
456 \end_inset
457
458 , if you want to report a bug in LyX.
459 \end_layout
460
461 \begin_layout Itemize
462 \begin_inset Flex URL
463 status collapsed
464
465 \begin_layout Plain Layout
466
467 www.devel.lyx.org
468 \end_layout
469
470 \end_inset
471
472 , if you are interested in the real blood and guts.
473 \end_layout
474
475 \begin_layout Itemize
476 Known mirror sites include:
477 \end_layout
478
479 \begin_deeper
480 \begin_layout Itemize
481 \begin_inset Flex URL
482 status collapsed
483
484 \begin_layout Plain Layout
485
486 www.mx.lyx.org
487 \end_layout
488
489 \end_inset
490
491
492 \end_layout
493
494 \begin_layout Itemize
495 \begin_inset Flex URL
496 status collapsed
497
498 \begin_layout Plain Layout
499
500 www.no.lyx.org
501 \end_layout
502
503 \end_inset
504
505
506 \end_layout
507
508 \begin_layout Itemize
509 \begin_inset Flex URL
510 status collapsed
511
512 \begin_layout Plain Layout
513
514 www.it.lyx.org
515 \end_layout
516
517 \end_inset
518
519
520 \end_layout
521
522 \end_deeper
523 \begin_layout Subsection
524 Where can I get LyX material by FTP? 
525 \end_layout
526
527 \begin_layout Itemize
528 ftp.lyx.org in /pub/lyx (also known as ftp.via.ecp.fr)
529 \end_layout
530
531 \begin_layout Subsection
532 What mailing lists are there? 
533 \end_layout
534
535 \begin_layout Itemize
536 lyx-announce@lists.lyx.org (very low volume), for announcements related to
537  LyX
538 \end_layout
539
540 \begin_layout Itemize
541 lyx-users@lists.lyx.org (medium volume), for general usage issues
542 \end_layout
543
544 \begin_layout Itemize
545 lyx-devel@lists.lyx.org (high volume), for development and debugging issues
546 \end_layout
547
548 \begin_layout Itemize
549 lyx-docs@lists.lyx.org (excruciatingly low volume), for documentation issues
550  
551 \end_layout
552
553 \begin_layout Standard
554 Generally, you would send email to lyx-foo-subscribe@lists.lyx.org to subscribe
555  to these lists or to lyx-foo-unsubscribe@lists.lyx.org to unsubscribe, where
556  
557 \begin_inset Quotes eld
558 \end_inset
559
560 foo
561 \begin_inset Quotes erd
562 \end_inset
563
564  is one of 
565 \begin_inset Quotes eld
566 \end_inset
567
568 announce
569 \begin_inset Quotes erd
570 \end_inset
571
572
573 \begin_inset Quotes eld
574 \end_inset
575
576 users
577 \begin_inset Quotes erd
578 \end_inset
579
580
581 \begin_inset Quotes eld
582 \end_inset
583
584 devel
585 \begin_inset Quotes erd
586 \end_inset
587
588 , or 
589 \begin_inset Quotes eld
590 \end_inset
591
592 docs
593 \begin_inset Quotes erd
594 \end_inset
595
596 ; definitely see 
597 \begin_inset Flex URL
598 status collapsed
599
600 \begin_layout Plain Layout
601
602 http://www.lyx.org/internet/mailing.php3
603 \end_layout
604
605 \end_inset
606
607  for the full details.
608 \end_layout
609
610 \begin_layout Subsection
611 Are the mailing lists archived anywhere? 
612 \end_layout
613
614 \begin_layout Standard
615 Yes.
616  :-)
617 \end_layout
618
619 \begin_layout Subsection
620 Okay, wise guy! Where are they archived?
621 \end_layout
622
623 \begin_layout Itemize
624 Announce: 
625 \begin_inset Flex URL
626 status collapsed
627
628 \begin_layout Plain Layout
629
630 http://www.mail-archive.com/lyx-announce@lists.lyx.org/
631 \end_layout
632
633 \end_inset
634
635
636 \end_layout
637
638 \begin_layout Itemize
639 Users: 
640 \begin_inset Flex URL
641 status collapsed
642
643 \begin_layout Plain Layout
644
645 http://www.mail-archive.com/lyx-users@lists.lyx.org/
646 \end_layout
647
648 \end_inset
649
650
651 \end_layout
652
653 \begin_layout Itemize
654 Devel: 
655 \begin_inset Flex URL
656 status collapsed
657
658 \begin_layout Plain Layout
659
660 http://www.mail-archive.com/lyx-devel@lists.lyx.org/
661 \end_layout
662
663 \end_inset
664
665
666 \end_layout
667
668 \begin_layout Section
669 Compatibility with other word/document processors
670 \end_layout
671
672 \begin_layout Subsection
673 Can I read/write LaTeX files?
674 \end_layout
675
676 \begin_layout Standard
677 Yes.
678  LyX outputs LaTeX files that are either machine or human friendly.
679  The 
680 \family typewriter
681 tex2lyx
682 \family default
683  program that comes with LyX does a decent job of converting LaTeX into
684  LyX.
685  It's not perfect, but it will usually get at least 95% of the job done
686  for you.
687 \end_layout
688
689 \begin_layout Subsection
690 Can I read/write Word files?
691 \end_layout
692
693 \begin_layout Standard
694 Not trivially.
695  People have had some level of success with the following sequence: LyX
696 \begin_inset Formula $\rightarrow$
697 \end_inset
698
699 LaTeX
700 \begin_inset Formula $\rightarrow$
701 \end_inset
702
703 RTF
704 \begin_inset Formula $\rightarrow$
705 \end_inset
706
707 Word, and vice versa.
708  However, Word is inherently not a markup language like LyX and LaTeX are,
709  so conversions are usually difficult and almost meaningless.
710 \end_layout
711
712 \begin_layout Standard
713 However, here are a few suggestions which were sent in:
714 \end_layout
715
716 \begin_layout Description
717 word2x produces LaTeX, HTML and plain text output.
718  The LaTeX is importable in principle (and is rather clean) but I often
719  prefer plain text and add the formatting back in.
720  (This requires that you have knowledge on the original formatting).
721  On last writing did not yet handle Office 2000 Word.
722 \end_layout
723
724 \begin_layout Description
725 wvware (found at www.wvware.com, or the abisource CVS repository for the latest).
726  This was previously called msWordView.
727  Very good, only tends to produce visually formatted LaTeX/HTML.
728  Is however highly configurable: a config file 
729 \family typewriter
730 wvLaTeX.xml
731 \family default
732  guides the translation process.
733  Handles also the newest Office formats.
734 \end_layout
735
736 \begin_layout Description
737 Ted This is the editor to use when someone sends you an RTF file created
738  by Word.
739  Fine product.
740  Mail yourself the converted version (plain text or HTML).
741 \end_layout
742
743 \begin_layout Standard
744 Finally, when all else fails, use any word processor (WordPerfect, StarOffice/Op
745 enOffice, ...) which understands Word.
746  Then export as the file as plain text and add the formatting by hand in
747  LyX.
748  
749 \end_layout
750
751 \begin_layout Standard
752 For me personally, at least, it's faster doing this than cleaning up attempts
753  at a conversion, though it is certainly unsatisfactory if you need to go
754  back and forth a lot.
755 \end_layout
756
757 \begin_layout Subsection
758 Can I read/write HTML files?
759 \end_layout
760
761 \begin_layout Standard
762 You can output HTML files using the 
763 \begin_inset Quotes eld
764 \end_inset
765
766 tth
767 \begin_inset Quotes erd
768 \end_inset
769
770  converter program, amongst others.
771  There may be a HTML
772 \begin_inset Formula $\rightarrow$
773 \end_inset
774
775 LaTeX program available which allows you to convert the other direction.
776 \end_layout
777
778 \begin_layout Section
779 Obtaining and Compiling LyX 
780 \end_layout
781
782 \begin_layout Subsection
783 What do I need?
784 \end_layout
785
786 \begin_layout Itemize
787 LyX source code: lyx-1.x.x.tar.gz
788 \end_layout
789
790 \begin_layout Itemize
791 Qt library: Qt-4.2.0 or higher (using the latest version available is recommended)
792 \end_layout
793
794 \begin_layout Itemize
795 A LaTeX installation: we strongly recommend teTeX-1.0 or higher on Linux,
796  MikTeX on Window
797 \end_layout
798
799 \begin_layout Itemize
800 A PostScript® interpreter: ghostscript 7.0 or higher
801 \end_layout
802
803 \begin_layout Itemize
804 A modern C++ compiler.
805  If you are using gcc, LyX requires at least version 3.2.0.
806 \end_layout
807
808 \begin_layout Subsection
809 How do I compile it?
810 \end_layout
811
812 \begin_layout Itemize
813 ./configure
814 \end_layout
815
816 \begin_layout Itemize
817 make
818 \end_layout
819
820 \begin_layout Itemize
821 make install (usually as root, though you don't have to be if you add flags
822  to the configure command)
823 \end_layout
824
825 \begin_layout Standard
826 See the INSTALL file for more details.
827 \end_layout
828
829 \begin_layout Subsection
830 I hate compiling.
831  Where are precompiled binaries?
832 \end_layout
833
834 \begin_layout Standard
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, Windows and Mac installers, plus
838  a few other formats and may be obtained from 
839 \begin_inset Flex URL
840 status collapsed
841
842 \begin_layout Plain Layout
843
844 ftp://ftp.lyx.org/pub/lyx/bin/
845 \end_layout
846
847 \end_inset
848
849 .
850 \end_layout
851
852 \begin_layout Section
853 Questions about Evil Red Text (IMPORTANT!)
854 \end_layout
855
856 \begin_layout Subsection
857 What is Evil Red Text (aka ERT)?
858 \end_layout
859
860 \begin_layout Standard
861 ERT (Evil Red Text) refers to raw LaTeX commands which are inserted into
862  your LyX document.
863  Certain troglodytes in the development group coined this term when they
864  complained about the unsightly appearance it leads to in LyX documents.
865  The more enlightened among us know that it is extremely useful, even though
866  it does qualify as URT (Ugly Red Text), but ERT seems to have stuck.
867  
868 \end_layout
869
870 \begin_layout Subsection
871 How do I enter Evil Red Text?
872 \end_layout
873
874 \begin_layout Standard
875 Aesthetic arguments aside, many of the answers in this FAQ require that
876  you use ERT, so whenever we say 
877 \begin_inset Quotes eld
878 \end_inset
879
880 insert the following LaTeX code
881 \begin_inset Quotes erd
882 \end_inset
883
884 , do the following
885 \end_layout
886
887 \begin_layout Enumerate
888 Click the TeX toolbar button or select 
889 \family sans
890 \bar under
891 I
892 \bar default
893 nsert\SpecialChar \menuseparator
894
895 \bar under
896 T
897 \bar default
898 eX
899 \family default
900 .
901 \end_layout
902
903 \begin_layout Enumerate
904 Type the command as it is written in the normal way
905 \end_layout
906
907 \begin_layout Subsection
908 The new ERT inset is really inconvenient !
909 \end_layout
910
911 \begin_layout Standard
912 A lot of people have been complaining about the ERT inset introduced in
913  version 1.2.0.
914  However, since there is little hope of to see the old LaTeX font return
915  from the grave (it was really a hack), here are a couple of things to ponder:
916 \end_layout
917
918 \begin_layout Itemize
919 You can collapse the ERT like any other floats by using 
920 \family sans
921 \bar under
922 E
923 \bar default
924 dit\SpecialChar \menuseparator
925 Open/C
926 \bar under
927 l
928 \bar default
929 ose float
930 \family default
931  (bound to 
932 \family sans
933 C-i
934 \family default
935  by default)
936 \end_layout
937
938 \begin_layout Itemize
939 You can also set it to 
940 \begin_inset Quotes eld
941 \end_inset
942
943 inlined
944 \begin_inset Quotes erd
945 \end_inset
946
947  by using the properties dialog obtained by right-clicking anywhere in the
948  inset
949 \end_layout
950
951 \begin_layout Subsection
952 Is there an alternative?
953 \end_layout
954
955 \begin_layout Standard
956 LaTeX commands can also be inserted in the 
957 \begin_inset Quotes eld
958 \end_inset
959
960 LaTeX Preamble
961 \begin_inset Quotes erd
962 \end_inset
963
964 , a form in LyX that is inserted verbatim into the LaTeX file which is generated
965  during processing.
966  This is especially useful for including nonstandard LaTeX packages, defining
967  global shortcuts to be used within the document, etc.
968 \end_layout
969
970 \begin_layout Section
971 Questions Related to Using LyX
972 \end_layout
973
974 \begin_layout Standard
975 In this section, we attempt to address the truly most frequently asked questions.
976  For a broader range of not-so-frequently asked questions and many 
977 \begin_inset Quotes eld
978 \end_inset
979
980 how do I?
981 \begin_inset Quotes erd
982 \end_inset
983
984  topics, see Herbert Voss' spectacular collection at 
985 \begin_inset Flex URL
986 status collapsed
987
988 \begin_layout Plain Layout
989
990 http://tug.org/TeXnik/
991 \end_layout
992
993 \end_inset
994
995 .
996  You are doing yourself a large disservice if you don't check there before
997  sending a message to the mailing lists!
998 \end_layout
999
1000 \begin_layout Subsection
1001 General questions
1002 \end_layout
1003
1004 \begin_layout Subsubsection
1005 How do I get rid of the date under the title?
1006 \end_layout
1007
1008 \begin_layout Standard
1009 The simplest solution is to open the menu 
1010 \family sans
1011 \bar under
1012 L
1013 \bar default
1014 ayout\SpecialChar \menuseparator
1015 P
1016 \bar under
1017 r
1018 \bar default
1019 eamble
1020 \family default
1021  and add the line
1022 \end_layout
1023
1024 \begin_layout LyX-Code
1025
1026 \backslash
1027 date{}
1028 \end_layout
1029
1030 \begin_layout Standard
1031 in the preamble window.
1032 \end_layout
1033
1034 \begin_layout Subsubsection
1035 How do I change the spacing in an Itemize/\SpecialChar \-
1036 Enumerate/\SpecialChar \-
1037 Description list environment
1038 ?
1039 \end_layout
1040
1041 \begin_layout Standard
1042 You'll have to do this by hand: for example, for one particular list, you
1043  can add the following LaTeX code at the beginning of the list: 
1044 \end_layout
1045
1046 \begin_layout Standard
1047
1048 \family typewriter
1049
1050 \backslash
1051 setlength{
1052 \backslash
1053 itemsep}{0mm}
1054 \end_layout
1055
1056 \begin_layout Subsubsection
1057 How do I number equations by section?
1058 \end_layout
1059
1060 \begin_layout Standard
1061 Add the following two lines to your LaTeX preamble:
1062 \end_layout
1063
1064 \begin_layout LyX-Code
1065
1066 \backslash
1067 @addtoreset{equation}{section} 
1068 \end_layout
1069
1070 \begin_layout LyX-Code
1071
1072 \backslash
1073 renewcommand{
1074 \backslash
1075 theequation}{
1076 \backslash
1077 thesection.
1078 \backslash
1079 arabic{equation}}
1080 \end_layout
1081
1082 \begin_layout Subsubsection
1083 Is it possible to do this for figures and tables as well?
1084 \end_layout
1085
1086 \begin_layout Standard
1087 Replace the phrase 
1088 \family typewriter
1089
1090 \backslash
1091 theequation
1092 \family default
1093  with 
1094 \family typewriter
1095
1096 \backslash
1097 thetable
1098 \family default
1099  or 
1100 \family typewriter
1101
1102 \backslash
1103 thefigure
1104 \family default
1105  and then replace 
1106 \family typewriter
1107 equation
1108 \family default
1109  with 
1110 \family typewriter
1111 table
1112 \family default
1113  or 
1114 \family typewriter
1115 figure
1116 \family default
1117 .
1118  Don't forget to adapt the 
1119 \backslash
1120 @addtoreset command, too.
1121 \end_layout
1122
1123 \begin_layout Subsubsection
1124 How do I change to footnote numbers to symbols (star, dagger, etc.)?
1125 \end_layout
1126
1127 \begin_layout Standard
1128 Add 
1129 \family typewriter
1130
1131 \backslash
1132 renewcommand{
1133 \backslash
1134 thefootnote}{
1135 \backslash
1136 fnsymbol{footnote}}
1137 \family default
1138  to your LaTeX preamble.
1139 \end_layout
1140
1141 \begin_layout Subsubsection
1142 How do I kill widows and orphans?
1143 \end_layout
1144
1145 \begin_layout Standard
1146 Okay, we are not playing Duke Nukem here! To eliminate widows and orphans
1147  (first line from a paragraph at the bottom of the page and the last line
1148  from a paragraph at the top of the page), add the following to the LaTeX
1149  preamble:
1150 \end_layout
1151
1152 \begin_layout LyX-Code
1153
1154 \backslash
1155 widowpenalty=10000 
1156 \end_layout
1157
1158 \begin_layout LyX-Code
1159
1160 \backslash
1161 clubpenalty=10000 
1162 \end_layout
1163
1164 \begin_layout Standard
1165 and perhaps
1166 \end_layout
1167
1168 \begin_layout LyX-Code
1169
1170 \backslash
1171 raggedbottom
1172 \end_layout
1173
1174 \begin_layout LyX-Code
1175
1176 \end_layout
1177
1178 \begin_layout Subsubsection
1179 How do I get a formatted list which starts with e.g.
1180  1.
1181  a)?
1182 \end_layout
1183
1184 \begin_layout Standard
1185 If you want a list which looks like
1186 \end_layout
1187
1188 \begin_layout LyX-Code
1189 1.
1190  a) First alternative 
1191 \end_layout
1192
1193 \begin_layout LyX-Code
1194    b) Second alternative 
1195 \end_layout
1196
1197 \begin_layout LyX-Code
1198    c) Third alternative
1199 \end_layout
1200
1201 \begin_layout Standard
1202 then try the following
1203 \end_layout
1204
1205 \begin_layout LyX-Code
1206 1.
1207  {} 
1208 \end_layout
1209
1210 \begin_layout LyX-Code
1211    a) First alternative 
1212 \end_layout
1213
1214 \begin_layout LyX-Code
1215    b) Second alternative 
1216 \end_layout
1217
1218 \begin_layout LyX-Code
1219    c) Third
1220 \end_layout
1221
1222 \begin_layout Standard
1223 where {} is in ERT (i.e.
1224  a placeholder not generating output.
1225  Specifically, set the style to 
1226 \begin_inset Quotes eld
1227 \end_inset
1228
1229 enumerate
1230 \begin_inset Quotes erd
1231 \end_inset
1232
1233 , enter the brackets in ERT, change the environment depth, and add the three
1234  elements.
1235  LyX will auto-label the entries.
1236 \end_layout
1237
1238 \begin_layout Subsubsection
1239 How do I count words in LyX?
1240 \end_layout
1241
1242 \begin_layout Standard
1243 Run a spellcheck; it will display the total number of words checked.
1244  Make sure the cursor is at the top of the document when you start the spellchec
1245 ker so that everything is counted.
1246 \end_layout
1247
1248 \begin_layout Subsubsection
1249 How do I insert a fixed amount of horizontal space?
1250 \end_layout
1251
1252 \begin_layout Standard
1253 There are various ERT commands to use: 
1254 \family typewriter
1255
1256 \backslash
1257 enspace
1258 \family default
1259  (1/2 em), 
1260 \family typewriter
1261
1262 \backslash
1263 thinspace
1264 \family default
1265  (1/6 em), 
1266 \family typewriter
1267
1268 \backslash
1269 negthinspace
1270 \family default
1271  (-1/6 em), 
1272 \family typewriter
1273
1274 \backslash
1275 quad
1276 \family default
1277  (1 em), 
1278 \family typewriter
1279
1280 \backslash
1281 qquad
1282 \family default
1283  (2 em), 
1284 \family typewriter
1285
1286 \backslash
1287 hspace{
1288 \emph on
1289 length
1290 \emph default
1291 }
1292 \family default
1293 , etc.
1294  An 
1295 \begin_inset Quotes eld
1296 \end_inset
1297
1298 em
1299 \begin_inset Quotes erd
1300 \end_inset
1301
1302  is roughly the width of the letter 
1303 \begin_inset Quotes eld
1304 \end_inset
1305
1306 m
1307 \begin_inset Quotes erd
1308 \end_inset
1309
1310  in the current font.
1311  The length argument of the 
1312 \family typewriter
1313
1314 \backslash
1315 hspace
1316 \family default
1317  command is any valid TeX length; units can be 
1318 \family typewriter
1319 mm
1320 \family default
1321  (millimeters), 
1322 \family typewriter
1323 cm
1324 \family default
1325  (centimeters), 
1326 \family typewriter
1327 in
1328 \family default
1329  (inches), 
1330 \family typewriter
1331 pt
1332 \family default
1333  (points = 1/72 inch), 
1334 \family typewriter
1335 em
1336 \family default
1337  (width of letter 
1338 \begin_inset Quotes eld
1339 \end_inset
1340
1341 m
1342 \begin_inset Quotes erd
1343 \end_inset
1344
1345 ), or 
1346 \family typewriter
1347 ex
1348 \family default
1349  (height of letter 
1350 \begin_inset Quotes eld
1351 \end_inset
1352
1353 x
1354 \begin_inset Quotes erd
1355 \end_inset
1356
1357 ).
1358  Examples: 
1359 \family typewriter
1360
1361 \backslash
1362 hspace{1in}
1363 \family default
1364
1365 \family typewriter
1366
1367 \backslash
1368 hspace{2.5em}
1369 \family default
1370 , etc.
1371 \end_layout
1372
1373 \begin_layout Subsubsection
1374 How can I make citations show up as [1,2,3,6] or [1-3,6] rather than [1][2][3][6
1375 ]?
1376 \end_layout
1377
1378 \begin_layout Standard
1379 Insert 
1380 \family typewriter
1381
1382 \backslash
1383 usepackage{cite}
1384 \family default
1385  into the LaTeX preamble.
1386  Most LaTeX distributions should have this package included.
1387  LyX supports this package, if you insert multiple citations separated by
1388  commas into the citation dialog, e.
1389  g.
1390  [Smalley_JCP,Jarrold_Sci], instead of just one citation after the other:
1391  [Smalley_JCP] [Jarrold_Sci].
1392 \end_layout
1393
1394 \begin_layout Subsection
1395 Figure related questions
1396 \end_layout
1397
1398 \begin_layout Subsubsection
1399 What is the difference between a 
1400 \begin_inset Quotes eld
1401 \end_inset
1402
1403 figure
1404 \begin_inset Quotes erd
1405 \end_inset
1406
1407  and a 
1408 \begin_inset Quotes eld
1409 \end_inset
1410
1411 figure float
1412 \begin_inset Quotes erd
1413 \end_inset
1414
1415 ?
1416 \end_layout
1417
1418 \begin_layout Standard
1419 This is an example of less-than-ideal terminology.
1420  
1421 \begin_inset Quotes eld
1422 \end_inset
1423
1424 Figure
1425 \begin_inset Quotes erd
1426 \end_inset
1427
1428  is what I would really call a 
1429 \begin_inset Quotes eld
1430 \end_inset
1431
1432 graphic
1433 \begin_inset Quotes erd
1434 \end_inset
1435
1436 ; it basically means insert a picture file.
1437  
1438 \begin_inset Quotes eld
1439 \end_inset
1440
1441 Figure float
1442 \begin_inset Quotes erd
1443 \end_inset
1444
1445  is more what one means by a figure in a paper: it includes the graphic,
1446  the caption, the figure label, etc.
1447  You should almost always insert a figure float first, then put a figure
1448  inside that.
1449 \end_layout
1450
1451 \begin_layout Standard
1452 Tables work in the same manner.
1453  Put a table float in first, then insert the table within that.
1454 \end_layout
1455
1456 \begin_layout Subsubsection
1457 How do I get LyX to put the figure exactly where I want it?
1458 \end_layout
1459
1460 \begin_layout Standard
1461 Select 
1462 \family sans
1463 Layout\SpecialChar \menuseparator
1464 Document
1465 \family default
1466 .
1467  In the 
1468 \family sans
1469 Float Placement
1470 \family default
1471  box, type 
1472 \begin_inset Quotes eld
1473 \end_inset
1474
1475
1476 \family typewriter
1477 !htp
1478 \family default
1479
1480 \begin_inset Quotes erd
1481 \end_inset
1482
1483 .
1484  This tells LaTeX to try really hard to put the figure here first, then
1485  the top of a page, then on a page by itself.
1486  This is a global setting: all figure will then obey this rule set.
1487 \end_layout
1488
1489 \begin_layout Standard
1490 If you want to control how each figure behaves, right-click in the figure
1491  float and you will get a dialog allowing to control the figure behavior.
1492 \end_layout
1493
1494 \begin_layout Subsubsection
1495 What does 
1496 \begin_inset Quotes eld
1497 \end_inset
1498
1499 Too many unprocessed floats
1500 \begin_inset Quotes erd
1501 \end_inset
1502
1503  mean?
1504 \end_layout
1505
1506 \begin_layout Standard
1507 LaTeX can handle only a limited number of floating elements floating at
1508  a given time.
1509  For example, if Figure 4 can't be fit in a good location (using the default
1510  rules of top of the page, then bottom, then a page of its own) and Figure
1511  5 comes along, they will both continue to float toward the end of the document
1512  until a good location can be found.
1513  If nothing good turns up, they will just be placed at the end of the document.
1514  If there are too many of these, LaTeX overruns a counter and emits the
1515  
1516 \begin_inset Quotes eld
1517 \end_inset
1518
1519 too many unprocessed floats
1520 \begin_inset Quotes erd
1521 \end_inset
1522
1523  error.
1524  This is not a bug in LaTeX, this is simply too many figures with too little
1525  text :-)
1526 \end_layout
1527
1528 \begin_layout Standard
1529 The easiest way to work around this is to insert a 
1530 \family typewriter
1531
1532 \backslash
1533 clearpage
1534 \family default
1535  command somewhere in the document where a pagebreak would be appropriate.
1536  While a pagebreak would simply start a new page, 
1537 \family typewriter
1538
1539 \backslash
1540 clearpage
1541 \family default
1542  processes all remaining floats, then begins a new page.
1543  This may lead to an unsightly stack of figures in the middle of your document;
1544  you may need to use several 
1545 \family typewriter
1546
1547 \backslash
1548 clearpages
1549 \family default
1550  to make things balance nicely.
1551 \end_layout
1552
1553 \begin_layout Subsection
1554 Math related questions
1555 \end_layout
1556
1557 \begin_layout Subsubsection
1558 How do I put normal text inside a mathematical equation?
1559 \end_layout
1560
1561 \begin_layout Standard
1562 Type 
1563 \begin_inset Quotes eld
1564 \end_inset
1565
1566
1567 \family typewriter
1568 M-m m
1569 \family default
1570
1571 \begin_inset Quotes erd
1572 \end_inset
1573
1574  while inside the equation to enter 
1575 \begin_inset Quotes eld
1576 \end_inset
1577
1578 math text mode
1579 \begin_inset Quotes erd
1580 \end_inset
1581
1582 .
1583 \end_layout
1584
1585 \begin_layout Subsubsection
1586 How do I make a cube root (or higher)?
1587 \end_layout
1588
1589 \begin_layout Standard
1590 Type 
1591 \begin_inset Quotes eld
1592 \end_inset
1593
1594
1595 \family typewriter
1596 M-m r
1597 \family default
1598
1599 \begin_inset Quotes erd
1600 \end_inset
1601
1602  to insert a nifty 
1603 \begin_inset Quotes eld
1604 \end_inset
1605
1606 root box
1607 \begin_inset Quotes erd
1608 \end_inset
1609
1610 .
1611  Use the cursor keys to navigate the entry boxes.
1612 \end_layout
1613
1614 \begin_layout Section
1615 Questions Related to Running LyX
1616 \end_layout
1617
1618 \begin_layout Subsection
1619 How do I convert LyX files to LaTeX from the command line?
1620 \end_layout
1621
1622 \begin_layout Standard
1623 File export was vastly improved in version 1.1.6.
1624  Simply say
1625 \end_layout
1626
1627 \begin_layout LyX-Code
1628 lyx --export latex <yourfile>.lyx
1629 \end_layout
1630
1631 \begin_layout Standard
1632 and that is all you need to do.
1633 \end_layout
1634
1635 \begin_layout Standard
1636 If you have an older version of LyX, you can use the same syntax if you
1637  are running X, because it will cause LyX windows to pop up onto your screen.
1638  If you have the Xvfb command available, you can resort to a deeper level
1639  of subterfuge (under 
1640 \family typewriter
1641 bash
1642 \family default
1643 ):
1644 \end_layout
1645
1646 \begin_layout Standard
1647
1648 \family typewriter
1649 (Xvfb :1 -once -terminate &); rm <file>.tex; lyx -display :1 --export latex
1650  <file>.lyx
1651 \end_layout
1652
1653 \begin_layout Standard
1654 \noindent
1655 Under csh/tcsh it is simply
1656 \end_layout
1657
1658 \begin_layout Standard
1659
1660 \family typewriter
1661 Xvfb :1 -once -terminate &; rm <file>.tex; lyx -display :1 --export latex
1662  <file>.lyx
1663 \end_layout
1664
1665 \begin_layout Standard
1666 \noindent
1667 This should work anywhere, whether or not X is actually running.
1668 \end_layout
1669
1670 \begin_layout Subsection
1671 How do I create PDF files from my LyX document?
1672 \end_layout
1673
1674 \begin_layout Standard
1675 Read Section 5.3.6 of the 
1676 \emph on
1677 Extended Features
1678 \emph default
1679  manual.
1680 \end_layout
1681
1682 \begin_layout Subsection
1683 Why do the fonts in my document look so bad in 
1684 \family typewriter
1685 acroread
1686 \family default
1687  ?
1688 \end_layout
1689
1690 \begin_layout Standard
1691 The problem and the solution are also discussed in Section 5.3.6 of the 
1692 \emph on
1693 Extended Features
1694 \emph default
1695  manual.
1696 \end_layout
1697
1698 \begin_layout Subsection
1699 Why doesn't my latest and greatest version of Ghostscript render EPS inline
1700  figures properly?
1701 \end_layout
1702
1703 \begin_layout Standard
1704 [Note: this only applies to versions of LyX older than 1.2.0, since the graphics
1705  rendering code has been rewritten in this version]
1706 \end_layout
1707
1708 \begin_layout Standard
1709 A couple of users reported that they couldn't get recent Ghostscript versions
1710  to display inline figures in LyX.
1711  It transpires that this is a Ghostscript bug:
1712 \end_layout
1713
1714 \begin_layout Standard
1715 \begin_inset Flex URL
1716 status collapsed
1717
1718 \begin_layout Plain Layout
1719
1720 http://sourceforge.net/bugs/?func=detailbug&bug_id=124957&group_id=1897
1721 \end_layout
1722
1723 \end_inset
1724
1725
1726 \end_layout
1727
1728 \begin_layout Standard
1729 \noindent
1730 This bug appears to affect Ghostscript 6.22 and upwards.
1731  After applying the above mentioned patch, rendering in Lyx works fine again.
1732  GNU Ghostscript 6.53 and above include this fix.
1733 \end_layout
1734
1735 \begin_layout Section
1736 Questions Related to LyX on Windows
1737 \end_layout
1738
1739 \begin_layout Subsection
1740 Why do the menus and the toolbar flicker ?
1741 \end_layout
1742
1743 \begin_layout Standard
1744 You are probably using the XWin32 X server.
1745  This is a bug in XWin32: you can work around the problem by disabling the
1746  
1747 \begin_inset Quotes eld
1748 \end_inset
1749
1750 Use Reserved Colors
1751 \begin_inset Quotes erd
1752 \end_inset
1753
1754  option of XWin32, and using a color mode other than PseudoColor.
1755 \end_layout
1756
1757 \begin_layout Section
1758 How to get further assistance
1759 \end_layout
1760
1761 \begin_layout Subsection
1762 You still haven't answered my question! 
1763 \end_layout
1764
1765 \begin_layout Standard
1766 Then RTFM, especially the Tutorial.
1767  The documentation really is quite good.
1768  (Besides, I helped write parts of it :-) If you think your problem may
1769  be LaTeX related, then look in 
1770 \emph on
1771 LaTeX, A Document Preparation System, 2nd Ed.
1772
1773 \emph default
1774  by Leslie Lamport (1994).
1775  There are also numerous example files included with LyX.
1776  Try 
1777 \family sans
1778 File\SpecialChar \menuseparator
1779 Open\SpecialChar \menuseparator
1780 Examples
1781 \family default
1782 .
1783 \end_layout
1784
1785 \begin_layout Subsection
1786 I want to mail someone about my problem.
1787  
1788 \end_layout
1789
1790 \begin_layout Standard
1791 Send email to the LyX Users list lyx-users@lists.lyx.org.
1792  If LyX is actually crashing or otherwise non-functional, then try the developer
1793 s' list at lyx-devel@lists.lyx.org.
1794 \end_layout
1795
1796 \begin_layout Subsection
1797 What to put in a request for help.
1798 \end_layout
1799
1800 \begin_layout Standard
1801 Include your version of LyX and a description of what you are trying to
1802  do, along with evidence that you've actually read the docs.
1803 \end_layout
1804
1805 \begin_layout Standard
1806 If LyX has crashed, include the version of LyX, the operating system, the
1807  version of xforms (if it seems to be a screen drawing problem), and a precise
1808  description of the events that lead to the crash.
1809  The easier it is for the developers to reproduce your crash, the more likely
1810  it will get fixed.
1811  If you're brave and like to hack, use gdb to generate a backtrace and include
1812  the results with your mail.
1813  If you have no clue what I'm talking about, just describe what you did
1814  as completely as you can.
1815 \end_layout
1816
1817 \begin_layout Section
1818 Administrative information and acknowledgments
1819 \end_layout
1820
1821 \begin_layout Subsection
1822 Feedback is invited.
1823  
1824 \end_layout
1825
1826 \begin_layout Standard
1827 Send comments, suggested additions, world record document claims, etc.
1828  to 
1829 \emph on
1830 lyx-docs@lists.lyx.org.
1831 \end_layout
1832
1833 \begin_layout Subsection
1834 Formats in which this FAQ is available.
1835  
1836 \end_layout
1837
1838 \begin_layout Standard
1839 The LyX file original is included in the LyX source distribution, converted
1840  versions in HTML and ASCII should soon be available at the website.
1841  A German version is also available with the distribution.
1842 \end_layout
1843
1844 \begin_layout Subsection
1845 Authorship and acknowledgments.
1846 \end_layout
1847
1848 \begin_layout Standard
1849 Bernhard Iselborn, David Johnson, and Paul Evans were responsible for the
1850  FAQ through version 0.2.2 which covered LyX-0.10.7.
1851  The FAQ as of version 0.3.0 was written from scratch and covers LyX-1.0 and
1852  higher.
1853  Many people contributed pieces to the current version; Mike Ressler of
1854  the Doc Team collected them into this file.
1855 \end_layout
1856
1857 \begin_layout Subsection
1858 Disclaimer and Copyright.
1859  
1860 \end_layout
1861
1862 \begin_layout Standard
1863 I don't claim anything in this document is accurate to within a factor of
1864  
1865 \begin_inset Formula $\pi$
1866 \end_inset
1867
1868 ; after all, I'm just an astronomer, and we like to set 
1869 \begin_inset Formula $c=h=k=\pi=1$
1870 \end_inset
1871
1872 .
1873  When the answer is wrong, we just redefine the units.
1874  This file is distributed in the hope that it will be useful, but WITHOUT
1875  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
1876  FOR A PARTICULAR PURPOSE.
1877  See the GNU General Public License for more details.
1878  In other words, it's not my fault if you lose your dissertation the night
1879  before your doctoral defense because you forgot to save it before the power
1880  failed while wondering how a fundamental physical constant expressed in
1881  units of 
1882 \begin_inset Formula $\textrm{m s}^{-1}$
1883 \end_inset
1884
1885  could possibly be equal to one expressed as 
1886 \begin_inset Formula $\textrm{kg m s}^{-2}\textrm{ K}^{-1}$
1887 \end_inset
1888
1889 .
1890  This file is Copyright © 2000 by Michael E.
1891  Ressler on behalf of the LyX Documentation Team.
1892 \end_layout
1893
1894 \end_body
1895 \end_document