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