1 #LyX 2.4 created this file. For more info see https://www.lyx.org/
5 \save_transient_properties true
6 \origin /systemlyxdir/doc/
9 % DO NOT ALTER THIS PREAMBLE!!!
11 %This preamble is designed to ensure that the document prints
12 % out as advertised. If you mess with this preamble,
13 % parts of the document may not print out as expected. If you
14 % have problems LaTeXing this file, please contact
15 % the documentation team
16 % email: lyx-docs@lists.lyx.org
18 % the pages of the TOC is numbered roman
19 % and a pdf-bookmark for the TOC is added
21 \let\myTOC\tableofcontents
22 \renewcommand\tableofcontents{%
23 \pdfbookmark[1]{\contentsname}{}
26 \pagenumbering{arabic} }
28 \use_default_options false
29 \maintain_unincluded_children no
31 \language_package default
34 \font_roman "palatino" "default"
35 \font_sans "helvet" "default"
36 \font_typewriter "courier" "default"
37 \font_math "auto" "auto"
38 \font_default_family default
39 \use_non_tex_fonts false
43 \font_typewriter_osf false
44 \font_sf_scale 100 100
45 \font_tt_scale 100 100
47 \use_dash_ligatures false
49 \default_output_format pdf2
51 \bibtex_command default
52 \index_command default
56 \pdf_title "Introduction to LyX"
57 \pdf_author "LyX Team"
58 \pdf_subject "LyX-documentation Intro"
59 \pdf_keywords "LyX, documentation"
61 \pdf_bookmarksnumbered true
62 \pdf_bookmarksopen true
63 \pdf_bookmarksopenlevel 2
68 \pdf_pdfusetitle false
69 \pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false"
72 \use_package amsmath 1
73 \use_package amssymb 1
76 \use_package mathdots 1
77 \use_package mathtools 1
79 \use_package stackrel 1
80 \use_package stmaryrd 1
81 \use_package undertilde 1
83 \cite_engine_type default
87 \paperorientation portrait
100 \paragraph_separation indent
101 \paragraph_indentation default
103 \math_numbering_side default
104 \quotes_style english
108 \paperpagestyle default
110 \tracking_changes true
111 \output_changes false
113 \postpone_fragile_content false
116 \html_be_strict false
117 \docbook_table_output 0
118 \docbook_mathml_prefix 1
119 \author -1463541724 "Daniel" d3vf4n@tutanota.com
120 \author -584632292 "Richard Kimberly Heck"
127 Introduction to \SpecialChar LyX
132 by the \SpecialChar LyX
137 \begin_layout Plain Layout
139 If you have comments on or corrections to this documentation,
140 please send them to the \SpecialChar LyX
141 Documentation mailing list:
143 \begin_inset CommandInset href
145 target "lyx-docs@lists.lyx.org"
159 \begin_layout Standard
160 \begin_inset CommandInset toc
161 LatexCommand tableofcontents
168 \begin_layout Section
169 The Philosophy of \SpecialChar LyX
173 \begin_layout Subsection
174 What is \SpecialChar LyX
178 \begin_layout Standard
180 is a document preparation system.
181 It excels at letting you create complex technical and scientific articles with mathematics,
186 It is very good for working with documents of any length in which the usual processing abilities are required:
187 automatic sectioning and pagination,
188 spell checking and so forth.
189 It can also be used to write a letter to your mom,
191 there are probably simpler programs available for that.
192 It is definitely not the best tool for creating banners,
194 or advertisements (we'll explain why later),
195 though with some effort all these can be done,
197 Here are some examples of what it is used for:
200 dissertations and theses,
203 conference proceedings,
204 software documentation,
206 articles in refereed scientific journals,
207 scripts for plays and movies,
210 \change_deleted -1463541724 1692922495
217 \begin_layout Standard
219 is a program that provides a modern approach to writing documents with a computer by using a markup language paradigm,
220 an approach that breaks with the obsolete tradition of the
221 \begin_inset Quotes eld
225 \begin_inset Quotes erd
229 It is designed for authors who want professional output quickly with a minimum of effort and without becoming specialists in typesetting.
230 The job of typesetting is done mostly by the computer,
232 with \SpecialChar LyX
234 the author can concentrate on the contents of his writing.
237 \begin_layout Standard
238 Part of the initial challenge of using \SpecialChar LyX
239 comes from the change in thinking that you,
243 all we had for creating documents were typewriters,
244 so we all learned certain tricks to get around their limitations.
246 which is little more than overstriking with the
247 \begin_inset Quotes eld
251 \begin_inset Quotes erd
255 became a way to emphasize text.
256 You were forced to figure out column sizes and tab stops,
258 before creating a table.
259 The same applied for letters and other right justified text.
260 Hyphenation at the end of a line required a careful eye and a lot of foresight.
263 \begin_layout Standard
265 we've all been trained to worry about the little details of which character goes where.
267 almost all word processors have this mentality.
268 They still use tab stops for adding whitespace.
269 You still need to worry about exactly where on the page something will appear.
270 Emphasizing text means changing a font,
271 similar to changing the typewriter wheel.
272 This is the underlying philosophy of a WYSIWYG word processor:
274 \begin_inset Quotes eld
277 What You See Is What You Get
278 \begin_inset Quotes erd
283 that paradigm often results in
284 \begin_inset Quotes eld
287 What You See Is All You Get
288 \begin_inset Quotes erd
294 \begin_layout Standard
295 This is where \SpecialChar LyX
296 differs from an ordinary word processor.
297 You don't concern yourself with what character goes where.
298 You tell \SpecialChar LyX
304 takes care of the rest,
305 following a set of rules called a
313 \begin_layout Plain Layout
315 most recent versions of the most popular office suites now have some sort of style sheets which follow a similar markup method.
317 our experience is that they are still rarely used in practice.
322 Let's look at a little example:
325 \begin_layout Standard
326 Suppose you are writing a report.
327 To begin your report,
328 you want a section called
329 \begin_inset Quotes eld
333 \change_deleted -1463541724 1692922782
334 \SpecialChar endofsentence
338 \begin_inset Quotes erd
342 \change_inserted -1463541724 1692922792
343 \SpecialChar endofsentence
347 you go into whatever menu it is in your word processor that changes font sizes and decide on a new font size.
348 Then you turn on bold face.
351 \begin_inset Quotes eld
363 \begin_inset Quotes erd
368 if you later decide that this section belongs someplace else in the document or if you insert a new section before it,
369 you need to change the numbering for this and all following sections,
370 as well as any entry in the table of contents.
373 \begin_layout Standard
376 you go to the pull-down on the far left of the button bar and select
382 \begin_inset Quotes eld
386 \begin_inset Quotes erd
392 \begin_layout Standard
395 If you cut and paste the section,
396 it will automatically be renumbered —
398 And if you enter references to that section correctly (by inserting cross-reference tags),
400 will automatically update them all throughout the file so that you never,
401 ever type a section number.
404 \begin_layout Standard
405 Now let's look at the problem of consistency.
407 you reopen your report and start Section
413 you forget that you were using 18
414 \begin_inset space \thinspace{}
417 pt bold instead of 16
418 \begin_inset space \thinspace{}
422 so you type in the heading for Section
426 4 in a different font from the one you used for Section
431 That problem doesn't even exist in \SpecialChar LyX
433 The computer takes care of all that silly bookkeeping about which thing has what size font,
436 that's what a computer is good at.
439 \begin_layout Standard
440 Here's another example.
441 Suppose you're making a list.
442 In other word processors,
443 a list is just a bunch of tab stops and newlines.
444 You need to figure out where to put the label for each list item,
445 what that label should be,
446 how many blank lines to put between each item,
448 Under \SpecialChar LyX
450 you have only two concerns:
451 what kind of list is this,
452 and what do I want to put in it?
456 \begin_layout Standard
458 the basic idea behind \SpecialChar LyX
471 \begin_inset Quotes eld
474 What You See Is What You Get
475 \change_deleted -1463541724 1692922450
479 \begin_inset Quotes erd
483 \change_inserted -1463541724 1692923936
489 \begin_inset Quotes eld
492 What You See Is What You
497 \begin_inset Quotes erd
501 \change_deleted -1463541724 1692923839
503 \begin_inset Quotes eld
509 \change_deleted -1463541724 1692923836
511 \begin_inset Quotes erd
515 \change_inserted -1463541724 1692923925
519 It's a powerful idea that greatly simplifies the mechanics of writing documents.
520 This is also why \SpecialChar LyX
521 isn't so good for creating posters and flyers.
527 want to specify exactly where everything goes,
528 because there are no functional units like paragraphs,
531 This doesn't mean \SpecialChar LyX
532 is missing some cool function.
533 It simply means that it isn't the right tool for the job —
534 you don't use a screwdriver to drive in nails.
537 \begin_layout Subsection
538 Differences between \SpecialChar LyX
539 and Other Word Processors
542 \begin_layout Standard
543 Here's a list of things you won't find in \SpecialChar LyX
547 \begin_layout Itemize
551 \begin_layout Itemize
555 \begin_layout Itemize
557 \begin_inset space \thinspace{}
561 \begin_inset space \space{}
575 \begin_layout Standard
577 along with a ruler showing you the position of things on the page,
578 are useless in \SpecialChar LyX
580 The program worries about where things go on the page,
582 Extra whitespace is similar;
584 adds it where necessary,
585 depending on context.
586 Not being able to type two blank lines in a row will be annoying at first,
587 but it makes more sense once you're thinking in WYSIWYM terms.
590 \begin_layout Standard
591 Here are some things that exist in \SpecialChar LyX
593 but aren't used as you might think:
596 \begin_layout Itemize
600 \begin_layout Itemize
604 \begin_layout Itemize
606 \begin_inset space \thinspace{}
610 \begin_inset space \space{}
618 \begin_layout Itemize
620 horizontal and vertical
623 \begin_layout Itemize
627 \begin_layout Itemize
634 \begin_layout Standard
635 Although they exist in \SpecialChar LyX
637 you generally don't need them.
639 will take care of these things for you,
640 depending on what you're doing.
641 Different parts of the document are automatically set in a different typeface and font size.
642 Paragraph indenting is context dependent;
643 different types of paragraphs get indented differently.
644 Page breaks get handled automatically,
647 the space between lines,
649 and between paragraphs is variable,
650 set by \SpecialChar LyX
655 \begin_layout Plain Layout
656 There are ways to adjust all of these (only some of which require knowledge of \SpecialChar LaTeX
658 either for a whole document or for a specific location in a document.
675 \begin_layout Standard
677 there are a few areas where we believe \SpecialChar LyX
678 (and \SpecialChar LaTeX
679 ) surpasses many word processors:
682 \begin_layout Itemize
686 \begin_layout Itemize
690 \begin_layout Itemize
694 \begin_layout Itemize
698 \begin_layout Itemize
702 \begin_layout Standard
704 many modern word processors can handle mathematical symbols,
707 and many have moved towards style definitions and the WYSIWYM concept.
709 they've only recently been able to do so,
710 whereas \SpecialChar LyX
711 is built upon the \SpecialChar LaTeX
712 document preparation system.
714 has been around since 1985,
722 \begin_layout Subsection
723 What is \SpecialChar LaTeX
727 \begin_layout Standard
729 is a document preparation system designed by
737 \begin_layout Plain Layout
738 The source for the info in this section is
740 A Guide to \SpecialChar LaTeX2e
753 which has an entry in the bibliography of the
757 \SpecialChar endofsentence
759 \change_deleted 5863208 1693593461
761 \begin_inset Note Note
764 \begin_layout Plain Layout
766 \change_inserted -1463541724 1693568855
767 Changed the fontface of the names in this footnote according to section 2.2.
770 \begin_layout Plain Layout
772 \change_inserted -1463541724 1693568875
773 Now ALL names in this document use the same fontface.
787 It was built up from a typesetting language called \SpecialChar TeX
795 takes a sequence of typesetting commands,
796 written in a script in an ASCII file,
799 \begin_inset Quotes eld
803 \begin_inset Quotes erd
806 of the printing trade were modeled by
810 as computer algorithms and incorporated into \SpecialChar TeX
812 hence its excellent printed appearance.
813 What comes directly out of \SpecialChar TeX
815 \change_inserted -1463541724 1692922633
817 \begin_inset Quotes eld
822 portable document format
823 \change_inserted -1463541724 1692922640
825 \begin_inset Quotes erd
835 \begin_inset Quotes eld
839 \begin_inset Quotes erd
851 format is often used for previews and can later be converted to other formats like PostScript.
855 \begin_layout Standard
857 isn't only a typesetting engine;
858 it also allows you to define macros.
859 Most people who use \SpecialChar TeX
860 are actually using a macro package which
864 created to hide a lot of the typesetting details.
870 He wanted a macro package that was more user- and less typesetter-oriented,
871 with a set of commands that consistently typeset things like sections,
872 tables or math formulas in a uniform,
874 This is how \SpecialChar LaTeX
878 \begin_layout Standard
880 in parallel with the development and growth of \SpecialChar LaTeX
882 other folks were creating their own custom macro packages for \SpecialChar TeX
884 ones to make slides or articles for math journals and so on.
885 Some used the raw \SpecialChar TeX
886 facilities to do this,
887 others began modifying \SpecialChar LaTeX
889 To try and unify this mess,
890 a team of \SpecialChar LaTeX
891 -nicians began to work on \SpecialChar LaTeX2e
893 the current version of \SpecialChar LaTeX
895 during the late 1980's.
896 This new version of \SpecialChar LaTeX
897 has commands which provide an easier-to-use interface to \SpecialChar TeX
898 's macro-creating commands,
899 aid in the use of new fonts,
903 is quite an extensive language in its own right!
904 Users around the world have been creating their own add-ons for \SpecialChar LaTeX
905 beyond the standard ones.
908 \begin_layout Standard
909 There are two ways to extend \SpecialChar LaTeX
916 is a set of \SpecialChar LaTeX
917 macros describing a new type of document,
920 There are classes for slides,
921 for physics and math journals\SpecialChar ldots
922 many universities even have a class for their thesis format.
927 differs from a class in that it doesn't define a new type of document,
928 but a different type of
932 that any document can use.
935 controls page margins and line spacing using two different \SpecialChar LaTeX
936 style-files designed for these purposes.
937 There are style-files for a whole slew of things:
938 printing labels or envelopes,
939 changing indentation behavior,
941 manipulating graphics,
942 designing fancy page headings,
943 customizing bibliographies,
944 altering the location and appearance of footnotes,
951 \begin_layout Standard
955 \begin_layout Description
958 Typesetting language with macro capability.
961 \begin_layout Description
964 Macro package built upon \SpecialChar TeX
965 \SpecialChar endofsentence
969 \begin_layout Description
971 Descriptions of types of document used with \SpecialChar LaTeX
972 \SpecialChar endofsentence
976 \begin_layout Description
978 Descriptions of the default behavior of particular elements of \SpecialChar LaTeX
982 \begin_layout Description
986 WYSIWYM document processor that uses \SpecialChar LaTeX
987 to do its typesetting.
990 \begin_layout Standard
991 This section attempts to explain the difference between \SpecialChar LyX
992 and a word processor.
996 By using \SpecialChar LaTeX
999 helps you to think more about
1008 The computer then handles
1015 \begin_layout Section
1016 Navigating the Documentation
1019 \begin_layout Standard
1020 To make it easier to answer your questions and describe all of the features of \SpecialChar LyX
1022 the documentation has been split up into several different files.
1023 Each one has its own purpose,
1025 Before you go ploughing into any of those files,
1027 you should read this
1028 \change_deleted -1463541724 1693810883
1030 \change_inserted -1463541724 1693810888
1032 \change_deleted 5863208 1693855500
1034 \begin_inset Note Note
1037 \begin_layout Plain Layout
1039 \change_inserted -1463541724 1693810943
1040 Does it refer to this section or the whole document?
1041 I am going with the former.
1051 since it contains a lot of useful information and commentary that can save you some time.
1054 \begin_layout Standard
1056 the development of \SpecialChar LyX
1058 so some of the documentation may be incomplete or a bit out of date,
1059 though we try to keep up-to-date.
1060 Like the rest of \SpecialChar LyX
1062 the manuals are the work of a group of volunteers who have
1063 \begin_inset Quotes eld
1067 \begin_inset Quotes erd
1078 If you want to help out,
1079 be sure to read Section
1080 \begin_inset space ~
1084 \begin_inset CommandInset ref
1086 reference "sec:Contrib"
1091 in addition to the rest of this document.
1094 \begin_layout Standard
1096 please do us a favor:
1097 if anything in these manuals confuses you,
1100 don't hesitate to let us know!
1101 You can reach the current document
1102 \change_inserted -1463541724 1692963407
1105 maintainers by emailing
1106 \begin_inset CommandInset href
1108 target "lyx-docs@lists.lyx.org"
1116 \change_deleted -1463541724 1692922571
1118 \change_inserted -584632292 1610248366
1122 \begin_layout Subsection
1124 \change_inserted -584632292 1610248375
1128 \begin_layout Standard
1129 If you have questions that are not obviously answered in the documentation and need help fast,
1130 there is an active users' mailing list which you can reach at
1131 \begin_inset CommandInset href
1133 target "lyx-users@lists.lyx.org"
1141 \change_inserted -584632292 1610248524
1142 You do not have to register to post,
1143 but you may wish to do so.
1145 \begin_inset CommandInset href
1147 name "the LyX website"
1148 target "https://www.lyx.org/MailingLists"
1153 for further information.
1155 \begin_inset CommandInset href
1157 target "http://wiki.lyx.org/"
1162 that will answer many questions about how to get LyX to do various things.
1167 \begin_layout Subsection
1168 The Format of the Manuals
1171 \begin_layout Standard
1172 Some of you may have printed out the manuals.
1173 Others may be reading them within \SpecialChar LyX
1175 There are some differences between the \SpecialChar LyX
1176 -file and the printed version.
1179 the title is simply at the top of the document,
1180 not formatted on a separate page as in some of the printed versions.
1181 Nor are any of the footnotes or the Table of Contents fully visible.
1183 which looks like this:
1185 \begin_inset Graphics
1186 filename clipart/footnote.png
1192 click on it with the left mouse button.
1193 For the Table of Contents,
1194 either click on the grey box or click on the
1199 where the contents are displayed automatically\SpecialChar endofsentence
1203 \begin_layout Standard
1204 In the printed manuals,
1205 all cross-references appear as the actual numbers for a chapter,
1209 In the \SpecialChar LyX
1212 all cross-references appear as light-grey boxes like the following:
1214 \begin_inset Graphics
1215 filename clipart/reference.png
1221 If you click on such a box with the left mouse button,
1222 a dialog box will appear containing a list of all the cross-references in the document.
1223 You can go to the referenced
1224 \change_deleted -1463541724 1693811119
1226 \change_inserted -1463541724 1693811124
1228 \change_deleted 5863208 1693855665
1230 \begin_inset Note Note
1233 \begin_layout Plain Layout
1235 \change_inserted -1463541724 1693811295
1236 This seems to be a leftover of past versions of this document in which the section cross-reference in this document was explicitly mentioned,
1238 Spanish and Catalan translations still had those explicit mentions.
1241 \begin_layout Plain Layout
1243 \change_inserted -1463541724 1693811291
1244 Other possible replacement:
1246 \begin_inset Quotes eld
1250 \begin_inset Quotes erd
1262 by right-clicking on the box or by clicking the button
1265 \begin_inset space ~
1269 \begin_inset space ~
1274 in the opened dialog.
1275 Going back to where you came from is just as easy.
1279 \begin_inset space ~
1284 to go back to your earlier location.
1287 \begin_layout Standard
1288 Now that we've cleared up some of the differences between the printed and \SpecialChar LyX
1289 -file versions of this file,
1290 we can start looking at the format of this document.
1291 You'll occasionally notice things in different fonts:
1294 \begin_layout Itemize
1299 is used for general emphasis,
1302 \change_inserted -1463541724 1692964248
1306 names of sections of other manuals,
1307 and notes from the authors.
1310 \begin_layout Itemize
1315 is used for program and file names,
1320 \begin_layout Itemize
1327 \change_deleted -1463541724 1692964370
1331 or dialog box names,
1332 and the names of keyboard keys.
1335 \begin_layout Itemize
1340 is used for people's names.
1341 \change_deleted 5863208 1692989367
1343 \begin_inset Note Note
1346 \begin_layout Plain Layout
1348 \change_inserted -1463541724 1692964472
1349 This document has some person names (Leslie Lamport,
1350 Donald Knuth) and none of them is typ
1351 \change_inserted 5863208 1692989355
1353 \change_inserted -1463541724 1692964472
1354 set with this font face.
1355 Shall we change them?
1356 \change_inserted 5863208 1692989346
1360 \begin_layout Plain Layout
1362 \change_inserted 5863208 1692989349
1375 \begin_layout Itemize
1380 is used for \SpecialChar LaTeX
1382 \change_inserted -1463541724 1692842469
1388 \begin_layout Standard
1389 When we do need to reference keys,
1390 we'll use the following prefixing convention:
1391 \change_deleted 5863208 1692989463
1393 \begin_inset Note Note
1396 \begin_layout Plain Layout
1398 \change_inserted -1463541724 1692842873
1399 Do not think quotation marks are necessary when already using a different font face to differentiate the text.
1411 \begin_layout Itemize
1413 \change_deleted -1463541724 1692842633
1414 \begin_inset Quotes eld
1422 \change_deleted -1463541724 1692842626
1426 \begin_inset Quotes erd
1438 \begin_layout Itemize
1440 \change_deleted -1463541724 1692842634
1441 \begin_inset Quotes eld
1449 \change_deleted -1463541724 1692842636
1453 \begin_inset Quotes erd
1465 \begin_layout Itemize
1467 \change_deleted -1463541724 1692842640
1468 \begin_inset Quotes eld
1476 \change_deleted -1463541724 1692842639
1480 \begin_inset Quotes erd
1496 \begin_layout Itemize
1498 \change_deleted -1463541724 1692842642
1499 \begin_inset Quotes eld
1507 \change_deleted -1463541724 1692842642
1511 \begin_inset Quotes erd
1518 \change_deleted -1463541724 1692842644
1520 \begin_inset Quotes eld
1528 \change_deleted -1463541724 1692842646
1532 \begin_inset Quotes erd
1537 are the function keys.
1540 \begin_layout Itemize
1542 \change_deleted -1463541724 1692842662
1543 \begin_inset Quotes eld
1551 \change_deleted -1463541724 1692842663
1555 \begin_inset Quotes erd
1563 \begin_layout Itemize
1565 \change_deleted -1463541724 1692842660
1566 \begin_inset Quotes eld
1574 \change_deleted -1463541724 1692842658
1578 \begin_inset Quotes erd
1582 \change_inserted -1463541724 1692964502
1587 \change_deleted -1463541724 1692842658
1589 \begin_inset Quotes eld
1597 \change_deleted -1463541724 1692842648
1601 \begin_inset Quotes erd
1605 \change_inserted -1463541724 1692964504
1610 \change_deleted -1463541724 1692842649
1612 \begin_inset Quotes eld
1620 \change_deleted -1463541724 1692842651
1624 \begin_inset Quotes erd
1628 \change_inserted -1463541724 1692964516
1632 \change_deleted -1463541724 1692842650
1634 \begin_inset Quotes eld
1642 \change_deleted -1463541724 1692842655
1646 \begin_inset Quotes erd
1655 \begin_layout Itemize
1657 \change_deleted -1463541724 1692842666
1660 \begin_inset Quotes eld
1666 \change_deleted -1463541724 1692842664
1670 \begin_inset Quotes erd
1674 \change_inserted -1463541724 1692964521
1679 \change_deleted -1463541724 1692842665
1681 \begin_inset Quotes eld
1689 \change_deleted -1463541724 1692842667
1693 \begin_inset Quotes erd
1697 \change_inserted -1463541724 1692964524
1702 \change_deleted -1463541724 1692842668
1704 \begin_inset Quotes eld
1712 \change_deleted -1463541724 1692842670
1716 \begin_inset Quotes erd
1720 \change_inserted -1463541724 1692964525
1725 \change_deleted -1463541724 1692842671
1727 \begin_inset Quotes eld
1735 \change_deleted -1463541724 1692842672
1739 \begin_inset Quotes erd
1743 \change_inserted -1463541724 1692964527
1748 \change_deleted -1463541724 1692842673
1750 \begin_inset Quotes eld
1758 \change_deleted -1463541724 1692842674
1762 \begin_inset Quotes erd
1766 \change_inserted -1463541724 1692964535
1770 \change_deleted -1463541724 1692842675
1772 \begin_inset Quotes eld
1780 \change_deleted -1463541724 1692842677
1784 \begin_inset Quotes erd
1791 \begin_inset space ~
1794 keys that appear above the cursor keys on many PC keyboards.
1796 \change_deleted -1463541724 1692842683
1798 \begin_inset Quotes eld
1806 \change_deleted -1463541724 1692842681
1810 \begin_inset Quotes erd
1816 \change_deleted -1463541724 1692842756
1818 \begin_inset Quotes eld
1826 \change_deleted -1463541724 1692842758
1830 \begin_inset Quotes erd
1836 \change_deleted -1463541724 1692842752
1838 \begin_inset Quotes eld
1846 \change_deleted -1463541724 1692842750
1850 \begin_inset Quotes erd
1856 \change_deleted -1463541724 1692842754
1858 \begin_inset Quotes eld
1866 \change_deleted -1463541724 1692842755
1870 \begin_inset Quotes erd
1878 \begin_layout Itemize
1887 both refer to the same key.
1888 Some keyboards label the
1893 \begin_inset Quotes eld
1897 \change_deleted -1463541724 1692842976
1901 \begin_inset Quotes erd
1905 \change_inserted -1463541724 1692842978
1910 \begin_inset Quotes eld
1914 \change_deleted -1463541724 1692842982
1918 \begin_inset Quotes erd
1922 \change_inserted -1463541724 1692842991
1924 \change_deleted 5863208 1692989468
1926 \begin_inset Note Note
1929 \begin_layout Plain Layout
1931 \change_inserted -1463541724 1692966623
1933 so punctuation goes out of the quoted text.
1935 \begin_inset CommandInset href
1937 name "Cambridge grammar (punctuation)"
1938 target "https://dictionary.cambridge.org/grammar/british-grammar/punctuation"
1953 still others have two keys.
1955 treats all of them as the same key,
1967 \begin_layout Standard
1968 The list with the currently set shortcuts can be found in the
1979 \begin_layout Subsection
1980 Units used in the Manuals
1983 \begin_layout Standard
1984 To understand the units described in this documentation,
1986 \begin_inset space ~
1990 \begin_inset CommandInset ref
1992 reference "tab:Units"
1997 explains all units available in \SpecialChar LyX
2001 \begin_layout Standard
2002 \begin_inset Float table
2009 \begin_layout Plain Layout
2010 \begin_inset Caption Standard
2012 \begin_layout Plain Layout
2013 \begin_inset CommandInset label
2027 \begin_layout Plain Layout
2028 \begin_inset VSpace medskip
2034 \begin_layout Plain Layout
2036 \begin_inset Tabular
2037 <lyxtabular version="3" rows="20" columns="2">
2038 <features booktabs="true" tabularvalignment="middle">
2039 <column alignment="center" valignment="top" width="0pt">
2040 <column alignment="center" valignment="top">
2042 <cell alignment="center" valignment="top" topline="true" bottomline="true" usebox="none">
2045 \begin_layout Plain Layout
2051 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
2054 \begin_layout Plain Layout
2062 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2065 \begin_layout Plain Layout
2071 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2074 \begin_layout Plain Layout
2082 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2085 \begin_layout Plain Layout
2091 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2094 \begin_layout Plain Layout
2102 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2105 \begin_layout Plain Layout
2111 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2114 \begin_layout Plain Layout
2116 \begin_inset space \thinspace{}
2120 \begin_inset space \thinspace{}
2130 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2133 \begin_layout Plain Layout
2139 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2142 \begin_layout Plain Layout
2144 \begin_inset space \thinspace{}
2148 \begin_inset space \thinspace{}
2158 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2161 \begin_layout Plain Layout
2167 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2170 \begin_layout Plain Layout
2172 \begin_inset space \thinspace{}
2176 \begin_inset space \thinspace{}
2186 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2189 \begin_layout Plain Layout
2195 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2198 \begin_layout Plain Layout
2200 \begin_inset space \thinspace{}
2204 \begin_inset space \thinspace{}
2214 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2217 \begin_layout Plain Layout
2223 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2226 \begin_layout Plain Layout
2228 \begin_inset space \thinspace{}
2232 \begin_inset space \thinspace{}
2242 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2245 \begin_layout Plain Layout
2251 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2254 \begin_layout Plain Layout
2256 \begin_inset space \thinspace{}
2260 \begin_inset Formula $\approx$
2264 \begin_inset space \thinspace{}
2274 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2277 \begin_layout Plain Layout
2283 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2286 \begin_layout Plain Layout
2288 \begin_inset space \thinspace{}
2292 \begin_inset space \thinspace{}
2302 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2305 \begin_layout Plain Layout
2311 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2314 \begin_layout Plain Layout
2315 % of original image width
2322 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2325 \begin_layout Plain Layout
2331 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2334 \begin_layout Plain Layout
2342 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2345 \begin_layout Plain Layout
2351 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2354 \begin_layout Plain Layout
2362 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2365 \begin_layout Plain Layout
2371 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2374 \begin_layout Plain Layout
2382 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2385 \begin_layout Plain Layout
2391 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2394 \begin_layout Plain Layout
2402 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2405 \begin_layout Plain Layout
2411 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2414 \begin_layout Plain Layout
2422 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2425 \begin_layout Plain Layout
2431 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2434 \begin_layout Plain Layout
2442 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2445 \begin_layout Plain Layout
2451 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2454 \begin_layout Plain Layout
2466 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2469 \begin_layout Plain Layout
2475 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2478 \begin_layout Plain Layout
2490 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
2493 \begin_layout Plain Layout
2499 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
2502 \begin_layout Plain Layout
2504 \begin_inset space \thinspace{}
2508 \begin_inset space \thinspace{}
2529 \begin_layout Subsection
2533 \begin_layout Standard
2534 The following list describes the contents of the basic documentation files that you find in the
2541 \begin_layout Description
2542 Introduction This file.
2545 \begin_layout Description
2546 Tutorial If you are new to \SpecialChar LyX
2548 and have never used \SpecialChar LaTeX
2550 you should start here.
2551 If you have used \SpecialChar LaTeX
2553 you should still read the
2558 starting with the section on
2559 \change_deleted -1463541724 1692917771
2561 \begin_inset Quotes eld
2569 for \SpecialChar LaTeX
2571 \change_deleted -1463541724 1692917763
2575 \begin_inset Quotes erd
2579 \change_inserted -1463541724 1692917775
2581 \change_deleted 5863208 1692989483
2583 \begin_inset Note Note
2586 \begin_layout Plain Layout
2588 \change_inserted -1463541724 1692918131
2590 don't see the point in quoting text already using a different font face.
2592 was not complying to the use of font faces in the manuals stated in section 2.2.
2601 (Skimming through the rest of the document wouldn't hurt,
2605 \begin_layout Description
2607 \begin_inset space ~
2610 Guide The primary documentation.
2615 of the basic operation and available features of \SpecialChar LyX
2617 The main manual assumes that you have read the
2624 \begin_layout Description
2626 \begin_inset space ~
2629 Objects Extension of the
2634 Documents in detail how to use tables,
2638 program listings and boxes.
2639 It also includes many tricks of the \SpecialChar LaTeX
2643 \begin_layout Description
2644 Math Extension of the
2649 Documents in detail how to typeset any kind of formula.
2652 \begin_layout Description
2654 \begin_inset space ~
2657 Features Extension of the
2662 Documents how to use raw \SpecialChar LaTeX
2664 additional layouts and special-purpose editing features.
2667 \begin_layout Description
2668 Customization A description of advanced \SpecialChar LyX
2670 including how to customize the overall behavior of \SpecialChar LyX
2671 \SpecialChar endofsentence
2672 This includes such things as keybindings,
2673 internationalization and configuration files.
2674 It also includes information about layout files,
2675 which are needed to get \SpecialChar LyX
2676 to support \SpecialChar LaTeX
2677 classes or packages.
2680 \begin_layout Description
2681 Shortcuts Tables of the currently defined \SpecialChar LyX
2685 \begin_layout Description
2688 \begin_inset space ~
2691 Configuration A report produced by \SpecialChar LyX
2693 This file contains information on what \SpecialChar LyX
2694 learned about your installation.
2695 Check it to see if you're missing something you might like to have.
2698 \begin_layout Standard
2699 These files will reference one another as necessary.
2709 information on installation and customization,
2710 but refers the reader to the
2715 \change_deleted -1463541724 1692964787
2717 \change_inserted -1463541724 1692964788
2720 anual for more information.
2723 \begin_layout Standard
2724 We'll state again an important point:
2727 \begin_layout Standard
2728 \begin_inset VSpace bigskip
2734 \begin_layout Standard
2736 If you are new to \SpecialChar LyX
2743 Now\SpecialChar endofsentence
2747 \begin_layout Standard
2748 \begin_inset VSpace bigskip
2754 \begin_layout Standard
2756 you could needlessly frustrate yourself.
2759 \begin_layout Section
2760 Contributing to the \SpecialChar LyX
2762 \begin_inset CommandInset label
2771 \begin_layout Subsection
2772 Contributing to \SpecialChar LyX
2776 \begin_layout Standard
2778 is mostly written in C++ (the \SpecialChar LaTeX
2779 importer is written in Python).
2780 It is a large project,
2781 and as a result it is not free from bugs,
2782 or the need for improvements in the source code.
2785 \begin_layout Subsubsection
2789 \begin_layout Standard
2790 While using \SpecialChar LyX
2792 you may find behavior which you consider a bug.
2796 User interface problems are considered major bugs by the \SpecialChar LyX
2798 especially helpful are indications of parts of the \SpecialChar LyX
2799 interface you find confusing,
2803 \begin_layout Standard
2805 has a bug tracking system,
2806 which you can find at
2807 \begin_inset Newline newline
2811 \begin_inset CommandInset href
2813 target "https://www.lyx.org/trac/wiki/BugTrackerHome"
2818 You should check the bug tracker before reporting any bugs,
2819 in case it has already been reported.
2820 If you have a comment on an existing bug,
2821 or wish to report a new bug,
2822 you may either use the bug tracker,
2823 or send an e-mail to the development mailing list,
2825 \begin_inset CommandInset href
2827 target "lyx-devel@lists.lyx.org"
2834 Archives of this list are linked from the main \SpecialChar LyX
2837 \change_deleted 5863208 1692989524
2839 \begin_inset CommandInset href
2841 target "http://www.lyx.org"
2846 \change_inserted 5863208 1692989534
2848 \begin_inset CommandInset href
2850 target "https://www.lyx.org/MailingLists"
2856 \change_deleted 5863208 1692989524
2858 \begin_inset Note Note
2861 \begin_layout Plain Layout
2863 \change_inserted -1463541724 1692966662
2864 Substitute this link for the more specific
2865 \begin_inset CommandInset href
2867 target "https://www.lyx.org/MailingLists#toc3"
2872 \change_deleted 5863208 1692989514
2874 \begin_inset CommandInset href
2876 target "https://www.lyx.org/MailingLists"
2882 \change_inserted -1463541724 1692966662
2895 \begin_layout Standard
2896 A useful bug report will at a minimum include the version of \SpecialChar LyX
2897 you are having the problem with.
2899 detailed descriptions are preferred —
2900 the more time developers have to spend to pinpoint the source of a bug,
2901 the less time they have for other improvements.
2902 Mention the system and system version on which you are running \SpecialChar LyX
2904 Give the versions of the libraries you have installed on your system,
2907 the versions of external programs that \SpecialChar LyX
2909 If it's a compilation or configuration problem,
2915 and mention which compiler you are using.
2917 \change_inserted 5863208 1692989585
2919 \change_deleted -1463541724 1693810816
2921 \begin_inset Quotes eld
2925 \change_inserted 5863208 1692989585
2926 Part of this information can be found in
2928 Help\SpecialChar menuseparator
2932 \change_deleted -1463541724 1693810814
2934 \begin_inset Quotes erd
2938 \change_deleted 5863208 1692989598
2940 \begin_inset Note Note
2943 \begin_layout Plain Layout
2945 \change_inserted -1463541724 1692957260
2946 Shall we mention this information can be found in
2948 Help\SpecialChar menuseparator
2955 \begin_layout Plain Layout
2957 \change_inserted -1463541724 1692966675
2958 \begin_inset Quotes eld
2961 Most of this information can be found in
2963 Help\SpecialChar menuseparator
2967 \begin_inset Quotes erd
2973 \begin_layout Plain Layout
2975 \change_inserted -1463541724 1692966688
2976 \begin_inset Quotes eld
2979 Part of this information can be found in
2981 Help\SpecialChar menuseparator
2985 \begin_inset Quotes erd
3000 \begin_layout Subsubsection
3001 Contributing fixes and new features
3004 \begin_layout Standard
3005 If you have made changes to \SpecialChar LyX
3006 's source that you think should become part of \SpecialChar LyX
3008 send your changes as a diff file (in unified format) to the development list referenced above,
3009 along with a change log,
3010 and a description of what your patch does.
3013 \begin_layout Subsection
3014 Contributing to the Documentation
3017 \begin_layout Standard
3019 's documentation is extensive;
3020 however \SpecialChar LyX
3021 is under constant development,
3022 and each new release adds new features.
3023 You may find some documentation needs improvement.
3024 This section describes what to do if you find an error,
3025 or have some suggestions for improving the documentation.
3028 \begin_layout Subsubsection
3029 Reporting Errors in the Manuals
3032 \begin_layout Standard
3033 If you find a problem with the documentation,
3034 send a message to the mailing list
3035 \begin_inset CommandInset href
3037 target "lyx-docs@lists.lyx.org"
3044 The documentation team will make any necessary fixes.
3047 \begin_layout Subsubsection
3048 Joining the Documentation Team.
3051 \begin_layout Standard
3052 The \SpecialChar LyX
3053 Documentation Project,
3054 like anything else in the \SpecialChar LyX
3056 can always use assistance!
3057 If you're interested in contributing to the Documentation Project,
3058 you need to do the following:
3061 \begin_layout Enumerate
3062 Get the latest \SpecialChar LyX
3064 \begin_inset Newline newline
3068 \begin_inset CommandInset href
3070 target "https://www.lyx.org/trac/browser/lyxgit/lib/doc?rev=master "
3077 \begin_layout Enumerate
3086 \change_inserted -1463541724 1692966436
3089 \SpecialChar endofsentence
3093 \begin_inset Newline newline
3096 The point of this exercise is to give you ideas.
3105 are likely to be the most up-to-date of all of the documentation.
3106 You should be able to glean some insights into how we want the manuals to read and to look.
3109 \begin_layout Enumerate
3110 Contact the team at:
3111 \begin_inset Newline newline
3115 \begin_inset CommandInset href
3117 target "lyx-docs@lists.lyx.org"
3124 \begin_inset Newline newline
3127 to discuss your intended changes and to get some feedback on them.
3130 \begin_layout Standard
3131 The changes you wish to make may range from improving clarity of the text,
3132 to doing major re-structuring of the documentation.
3133 Any and all improvements are gladly received.