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 chapter thoroughly,
1028 since it contains a lot of useful information and commentary that can save you some time.
1031 \begin_layout Standard
1033 the development of \SpecialChar LyX
1035 so some of the documentation may be incomplete or a bit out of date,
1036 though we try to keep up-to-date.
1037 Like the rest of \SpecialChar LyX
1039 the manuals are the work of a group of volunteers who have
1040 \begin_inset Quotes eld
1044 \begin_inset Quotes erd
1055 If you want to help out,
1056 be sure to read Section
1057 \begin_inset space ~
1061 \begin_inset CommandInset ref
1063 reference "sec:Contrib"
1068 in addition to the rest of this document.
1071 \begin_layout Standard
1073 please do us a favor:
1074 if anything in these manuals confuses you,
1077 don't hesitate to let us know!
1078 You can reach the current document
1079 \change_inserted -1463541724 1692963407
1082 maintainers by emailing
1083 \begin_inset CommandInset href
1085 target "lyx-docs@lists.lyx.org"
1093 \change_deleted -1463541724 1692922571
1095 \change_inserted -584632292 1610248366
1099 \begin_layout Subsection
1101 \change_inserted -584632292 1610248375
1105 \begin_layout Standard
1106 If you have questions that are not obviously answered in the documentation and need help fast,
1107 there is an active users' mailing list which you can reach at
1108 \begin_inset CommandInset href
1110 target "lyx-users@lists.lyx.org"
1118 \change_inserted -584632292 1610248524
1119 You do not have to register to post,
1120 but you may wish to do so.
1122 \begin_inset CommandInset href
1124 name "the LyX website"
1125 target "https://www.lyx.org/MailingLists"
1130 for further information.
1132 \begin_inset CommandInset href
1134 target "http://wiki.lyx.org/"
1139 that will answer many questions about how to get LyX to do various things.
1144 \begin_layout Subsection
1145 The Format of the Manuals
1148 \begin_layout Standard
1149 Some of you may have printed out the manuals.
1150 Others may be reading them within \SpecialChar LyX
1152 There are some differences between the \SpecialChar LyX
1153 -file and the printed version.
1156 the title is simply at the top of the document,
1157 not formatted on a separate page as in some of the printed versions.
1158 Nor are any of the footnotes or the Table of Contents fully visible.
1160 which looks like this:
1162 \begin_inset Graphics
1163 filename clipart/footnote.png
1169 click on it with the left mouse button.
1170 For the Table of Contents,
1171 either click on the grey box or click on the
1176 where the contents are displayed automatically\SpecialChar endofsentence
1180 \begin_layout Standard
1181 In the printed manuals,
1182 all cross-references appear as the actual numbers for a chapter,
1186 In the \SpecialChar LyX
1189 all cross-references appear as light-grey boxes like the following:
1191 \begin_inset Graphics
1192 filename clipart/reference.png
1198 If you click on such a box with the left mouse button,
1199 a dialog box will appear containing a list of all the cross-references in the document.
1200 You can go to the referenced section by right-clicking on the box or by clicking the button
1203 \begin_inset space ~
1207 \begin_inset space ~
1212 in the opened dialog.
1213 Going back to where you came from is just as easy.
1217 \begin_inset space ~
1222 to go back to your earlier location.
1225 \begin_layout Standard
1226 Now that we've cleared up some of the differences between the printed and \SpecialChar LyX
1227 -file versions of this file,
1228 we can start looking at the format of this document.
1229 You'll occasionally notice things in different fonts:
1232 \begin_layout Itemize
1237 is used for general emphasis,
1240 \change_inserted -1463541724 1692964248
1244 names of sections of other manuals,
1245 and notes from the authors.
1248 \begin_layout Itemize
1253 is used for program and file names,
1258 \begin_layout Itemize
1265 \change_deleted -1463541724 1692964370
1269 or dialog box names,
1270 and the names of keyboard keys.
1273 \begin_layout Itemize
1278 is used for people's names.
1279 \change_deleted 5863208 1692989367
1281 \begin_inset Note Note
1284 \begin_layout Plain Layout
1286 \change_inserted -1463541724 1692964472
1287 This document has some person names (Leslie Lamport,
1288 Donald Knuth) and none of them is typ
1289 \change_inserted 5863208 1692989355
1291 \change_inserted -1463541724 1692964472
1292 set with this font face.
1293 Shall we change them?
1294 \change_inserted 5863208 1692989346
1298 \begin_layout Plain Layout
1300 \change_inserted 5863208 1692989349
1313 \begin_layout Itemize
1318 is used for \SpecialChar LaTeX
1320 \change_inserted -1463541724 1692842469
1326 \begin_layout Standard
1327 When we do need to reference keys,
1328 we'll use the following prefixing convention:
1329 \change_deleted 5863208 1692989463
1331 \begin_inset Note Note
1334 \begin_layout Plain Layout
1336 \change_inserted -1463541724 1692842873
1337 Do not think quotation marks are necessary when already using a different font face to differentiate the text.
1349 \begin_layout Itemize
1351 \change_deleted -1463541724 1692842633
1352 \begin_inset Quotes eld
1360 \change_deleted -1463541724 1692842626
1364 \begin_inset Quotes erd
1376 \begin_layout Itemize
1378 \change_deleted -1463541724 1692842634
1379 \begin_inset Quotes eld
1387 \change_deleted -1463541724 1692842636
1391 \begin_inset Quotes erd
1403 \begin_layout Itemize
1405 \change_deleted -1463541724 1692842640
1406 \begin_inset Quotes eld
1414 \change_deleted -1463541724 1692842639
1418 \begin_inset Quotes erd
1434 \begin_layout Itemize
1436 \change_deleted -1463541724 1692842642
1437 \begin_inset Quotes eld
1445 \change_deleted -1463541724 1692842642
1449 \begin_inset Quotes erd
1456 \change_deleted -1463541724 1692842644
1458 \begin_inset Quotes eld
1466 \change_deleted -1463541724 1692842646
1470 \begin_inset Quotes erd
1475 are the function keys.
1478 \begin_layout Itemize
1480 \change_deleted -1463541724 1692842662
1481 \begin_inset Quotes eld
1489 \change_deleted -1463541724 1692842663
1493 \begin_inset Quotes erd
1501 \begin_layout Itemize
1503 \change_deleted -1463541724 1692842660
1504 \begin_inset Quotes eld
1512 \change_deleted -1463541724 1692842658
1516 \begin_inset Quotes erd
1520 \change_inserted -1463541724 1692964502
1525 \change_deleted -1463541724 1692842658
1527 \begin_inset Quotes eld
1535 \change_deleted -1463541724 1692842648
1539 \begin_inset Quotes erd
1543 \change_inserted -1463541724 1692964504
1548 \change_deleted -1463541724 1692842649
1550 \begin_inset Quotes eld
1558 \change_deleted -1463541724 1692842651
1562 \begin_inset Quotes erd
1566 \change_inserted -1463541724 1692964516
1570 \change_deleted -1463541724 1692842650
1572 \begin_inset Quotes eld
1580 \change_deleted -1463541724 1692842655
1584 \begin_inset Quotes erd
1593 \begin_layout Itemize
1595 \change_deleted -1463541724 1692842666
1598 \begin_inset Quotes eld
1604 \change_deleted -1463541724 1692842664
1608 \begin_inset Quotes erd
1612 \change_inserted -1463541724 1692964521
1617 \change_deleted -1463541724 1692842665
1619 \begin_inset Quotes eld
1627 \change_deleted -1463541724 1692842667
1631 \begin_inset Quotes erd
1635 \change_inserted -1463541724 1692964524
1640 \change_deleted -1463541724 1692842668
1642 \begin_inset Quotes eld
1650 \change_deleted -1463541724 1692842670
1654 \begin_inset Quotes erd
1658 \change_inserted -1463541724 1692964525
1663 \change_deleted -1463541724 1692842671
1665 \begin_inset Quotes eld
1673 \change_deleted -1463541724 1692842672
1677 \begin_inset Quotes erd
1681 \change_inserted -1463541724 1692964527
1686 \change_deleted -1463541724 1692842673
1688 \begin_inset Quotes eld
1696 \change_deleted -1463541724 1692842674
1700 \begin_inset Quotes erd
1704 \change_inserted -1463541724 1692964535
1708 \change_deleted -1463541724 1692842675
1710 \begin_inset Quotes eld
1718 \change_deleted -1463541724 1692842677
1722 \begin_inset Quotes erd
1729 \begin_inset space ~
1732 keys that appear above the cursor keys on many PC keyboards.
1734 \change_deleted -1463541724 1692842683
1736 \begin_inset Quotes eld
1744 \change_deleted -1463541724 1692842681
1748 \begin_inset Quotes erd
1754 \change_deleted -1463541724 1692842756
1756 \begin_inset Quotes eld
1764 \change_deleted -1463541724 1692842758
1768 \begin_inset Quotes erd
1774 \change_deleted -1463541724 1692842752
1776 \begin_inset Quotes eld
1784 \change_deleted -1463541724 1692842750
1788 \begin_inset Quotes erd
1794 \change_deleted -1463541724 1692842754
1796 \begin_inset Quotes eld
1804 \change_deleted -1463541724 1692842755
1808 \begin_inset Quotes erd
1816 \begin_layout Itemize
1825 both refer to the same key.
1826 Some keyboards label the
1831 \begin_inset Quotes eld
1835 \change_deleted -1463541724 1692842976
1839 \begin_inset Quotes erd
1843 \change_inserted -1463541724 1692842978
1848 \begin_inset Quotes eld
1852 \change_deleted -1463541724 1692842982
1856 \begin_inset Quotes erd
1860 \change_inserted -1463541724 1692842991
1862 \change_deleted 5863208 1692989468
1864 \begin_inset Note Note
1867 \begin_layout Plain Layout
1869 \change_inserted -1463541724 1692966623
1871 so punctuation goes out of the quoted text.
1873 \begin_inset CommandInset href
1875 name "Cambridge grammar (punctuation)"
1876 target "https://dictionary.cambridge.org/grammar/british-grammar/punctuation"
1891 still others have two keys.
1893 treats all of them as the same key,
1905 \begin_layout Standard
1906 The list with the currently set shortcuts can be found in the
1917 \begin_layout Subsection
1918 Units used in the Manuals
1921 \begin_layout Standard
1922 To understand the units described in this documentation,
1924 \begin_inset space ~
1928 \begin_inset CommandInset ref
1930 reference "tab:Units"
1935 explains all units available in \SpecialChar LyX
1939 \begin_layout Standard
1940 \begin_inset Float table
1947 \begin_layout Plain Layout
1948 \begin_inset Caption Standard
1950 \begin_layout Plain Layout
1951 \begin_inset CommandInset label
1965 \begin_layout Plain Layout
1966 \begin_inset VSpace medskip
1972 \begin_layout Plain Layout
1974 \begin_inset Tabular
1975 <lyxtabular version="3" rows="20" columns="2">
1976 <features booktabs="true" tabularvalignment="middle">
1977 <column alignment="center" valignment="top" width="0pt">
1978 <column alignment="center" valignment="top">
1980 <cell alignment="center" valignment="top" topline="true" bottomline="true" usebox="none">
1983 \begin_layout Plain Layout
1989 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
1992 \begin_layout Plain Layout
2000 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2003 \begin_layout Plain Layout
2009 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2012 \begin_layout Plain Layout
2020 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2023 \begin_layout Plain Layout
2029 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2032 \begin_layout Plain Layout
2040 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2043 \begin_layout Plain Layout
2049 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2052 \begin_layout Plain Layout
2054 \begin_inset space \thinspace{}
2058 \begin_inset space \thinspace{}
2068 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2071 \begin_layout Plain Layout
2077 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2080 \begin_layout Plain Layout
2082 \begin_inset space \thinspace{}
2086 \begin_inset space \thinspace{}
2096 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2099 \begin_layout Plain Layout
2105 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2108 \begin_layout Plain Layout
2110 \begin_inset space \thinspace{}
2114 \begin_inset space \thinspace{}
2124 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2127 \begin_layout Plain Layout
2133 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2136 \begin_layout Plain Layout
2138 \begin_inset space \thinspace{}
2142 \begin_inset space \thinspace{}
2152 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2155 \begin_layout Plain Layout
2161 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2164 \begin_layout Plain Layout
2166 \begin_inset space \thinspace{}
2170 \begin_inset space \thinspace{}
2180 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2183 \begin_layout Plain Layout
2189 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2192 \begin_layout Plain Layout
2194 \begin_inset space \thinspace{}
2198 \begin_inset Formula $\approx$
2202 \begin_inset space \thinspace{}
2212 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2215 \begin_layout Plain Layout
2221 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2224 \begin_layout Plain Layout
2226 \begin_inset space \thinspace{}
2230 \begin_inset space \thinspace{}
2240 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2243 \begin_layout Plain Layout
2249 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2252 \begin_layout Plain Layout
2253 % of original image width
2260 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2263 \begin_layout Plain Layout
2269 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2272 \begin_layout Plain Layout
2280 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2283 \begin_layout Plain Layout
2289 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2292 \begin_layout Plain Layout
2300 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2303 \begin_layout Plain Layout
2309 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2312 \begin_layout Plain Layout
2320 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2323 \begin_layout Plain Layout
2329 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2332 \begin_layout Plain Layout
2340 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2343 \begin_layout Plain Layout
2349 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2352 \begin_layout Plain Layout
2360 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2363 \begin_layout Plain Layout
2369 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2372 \begin_layout Plain Layout
2380 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2383 \begin_layout Plain Layout
2389 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2392 \begin_layout Plain Layout
2404 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2407 \begin_layout Plain Layout
2413 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2416 \begin_layout Plain Layout
2428 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
2431 \begin_layout Plain Layout
2437 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
2440 \begin_layout Plain Layout
2442 \begin_inset space \thinspace{}
2446 \begin_inset space \thinspace{}
2467 \begin_layout Subsection
2471 \begin_layout Standard
2472 The following list describes the contents of the basic documentation files that you find in the
2479 \begin_layout Description
2480 Introduction This file.
2483 \begin_layout Description
2484 Tutorial If you are new to \SpecialChar LyX
2486 and have never used \SpecialChar LaTeX
2488 you should start here.
2489 If you have used \SpecialChar LaTeX
2491 you should still read the
2496 starting with the section on
2497 \change_deleted -1463541724 1692917771
2499 \begin_inset Quotes eld
2507 for \SpecialChar LaTeX
2509 \change_deleted -1463541724 1692917763
2513 \begin_inset Quotes erd
2517 \change_inserted -1463541724 1692917775
2519 \change_deleted 5863208 1692989483
2521 \begin_inset Note Note
2524 \begin_layout Plain Layout
2526 \change_inserted -1463541724 1692918131
2528 don't see the point in quoting text already using a different font face.
2530 was not complying to the use of font faces in the manuals stated in section 2.2.
2539 (Skimming through the rest of the document wouldn't hurt,
2543 \begin_layout Description
2545 \begin_inset space ~
2548 Guide The primary documentation.
2553 of the basic operation and available features of \SpecialChar LyX
2555 The main manual assumes that you have read the
2562 \begin_layout Description
2564 \begin_inset space ~
2567 Objects Extension of the
2572 Documents in detail how to use tables,
2576 program listings and boxes.
2577 It also includes many tricks of the \SpecialChar LaTeX
2581 \begin_layout Description
2582 Math Extension of the
2587 Documents in detail how to typeset any kind of formula.
2590 \begin_layout Description
2592 \begin_inset space ~
2595 Features Extension of the
2600 Documents how to use raw \SpecialChar LaTeX
2602 additional layouts and special-purpose editing features.
2605 \begin_layout Description
2606 Customization A description of advanced \SpecialChar LyX
2608 including how to customize the overall behavior of \SpecialChar LyX
2609 \SpecialChar endofsentence
2610 This includes such things as keybindings,
2611 internationalization and configuration files.
2612 It also includes information about layout files,
2613 which are needed to get \SpecialChar LyX
2614 to support \SpecialChar LaTeX
2615 classes or packages.
2618 \begin_layout Description
2619 Shortcuts Tables of the currently defined \SpecialChar LyX
2623 \begin_layout Description
2626 \begin_inset space ~
2629 Configuration A report produced by \SpecialChar LyX
2631 This file contains information on what \SpecialChar LyX
2632 learned about your installation.
2633 Check it to see if you're missing something you might like to have.
2636 \begin_layout Standard
2637 These files will reference one another as necessary.
2647 information on installation and customization,
2648 but refers the reader to the
2653 \change_deleted -1463541724 1692964787
2655 \change_inserted -1463541724 1692964788
2658 anual for more information.
2661 \begin_layout Standard
2662 We'll state again an important point:
2665 \begin_layout Standard
2666 \begin_inset VSpace bigskip
2672 \begin_layout Standard
2674 If you are new to \SpecialChar LyX
2681 Now\SpecialChar endofsentence
2685 \begin_layout Standard
2686 \begin_inset VSpace bigskip
2692 \begin_layout Standard
2694 you could needlessly frustrate yourself.
2697 \begin_layout Section
2698 Contributing to the \SpecialChar LyX
2700 \begin_inset CommandInset label
2709 \begin_layout Subsection
2710 Contributing to \SpecialChar LyX
2714 \begin_layout Standard
2716 is mostly written in C++ (the \SpecialChar LaTeX
2717 importer is written in Python).
2718 It is a large project,
2719 and as a result it is not free from bugs,
2720 or the need for improvements in the source code.
2723 \begin_layout Subsubsection
2727 \begin_layout Standard
2728 While using \SpecialChar LyX
2730 you may find behavior which you consider a bug.
2734 User interface problems are considered major bugs by the \SpecialChar LyX
2736 especially helpful are indications of parts of the \SpecialChar LyX
2737 interface you find confusing,
2741 \begin_layout Standard
2743 has a bug tracking system,
2744 which you can find at
2745 \begin_inset Newline newline
2749 \begin_inset CommandInset href
2751 target "https://www.lyx.org/trac/wiki/BugTrackerHome"
2756 You should check the bug tracker before reporting any bugs,
2757 in case it has already been reported.
2758 If you have a comment on an existing bug,
2759 or wish to report a new bug,
2760 you may either use the bug tracker,
2761 or send an e-mail to the development mailing list,
2763 \begin_inset CommandInset href
2765 target "lyx-devel@lists.lyx.org"
2772 Archives of this list are linked from the main \SpecialChar LyX
2775 \change_deleted 5863208 1692989524
2777 \begin_inset CommandInset href
2779 target "http://www.lyx.org"
2784 \change_inserted 5863208 1692989534
2786 \begin_inset CommandInset href
2788 target "https://www.lyx.org/MailingLists"
2794 \change_deleted 5863208 1692989524
2796 \begin_inset Note Note
2799 \begin_layout Plain Layout
2801 \change_inserted -1463541724 1692966662
2802 Substitute this link for the more specific
2803 \begin_inset CommandInset href
2805 target "https://www.lyx.org/MailingLists#toc3"
2810 \change_deleted 5863208 1692989514
2812 \begin_inset CommandInset href
2814 target "https://www.lyx.org/MailingLists"
2820 \change_inserted -1463541724 1692966662
2833 \begin_layout Standard
2834 A useful bug report will at a minimum include the version of \SpecialChar LyX
2835 you are having the problem with.
2837 detailed descriptions are preferred —
2838 the more time developers have to spend to pinpoint the source of a bug,
2839 the less time they have for other improvements.
2840 Mention the system and system version on which you are running \SpecialChar LyX
2842 Give the versions of the libraries you have installed on your system,
2845 the versions of external programs that \SpecialChar LyX
2847 If it's a compilation or configuration problem,
2853 and mention which compiler you are using.
2855 \change_inserted 5863208 1692989585
2857 \begin_inset Quotes eld
2860 Part of this information can be found in
2862 Help\SpecialChar menuseparator
2866 \begin_inset Quotes erd
2870 \change_deleted 5863208 1692989598
2872 \begin_inset Note Note
2875 \begin_layout Plain Layout
2877 \change_inserted -1463541724 1692957260
2878 Shall we mention this information can be found in
2880 Help\SpecialChar menuseparator
2887 \begin_layout Plain Layout
2889 \change_inserted -1463541724 1692966675
2890 \begin_inset Quotes eld
2893 Most of this information can be found in
2895 Help\SpecialChar menuseparator
2899 \begin_inset Quotes erd
2905 \begin_layout Plain Layout
2907 \change_inserted -1463541724 1692966688
2908 \begin_inset Quotes eld
2911 Part of this information can be found in
2913 Help\SpecialChar menuseparator
2917 \begin_inset Quotes erd
2932 \begin_layout Subsubsection
2933 Contributing fixes and new features
2936 \begin_layout Standard
2937 If you have made changes to \SpecialChar LyX
2938 's source that you think should become part of \SpecialChar LyX
2940 send your changes as a diff file (in unified format) to the development list referenced above,
2941 along with a change log,
2942 and a description of what your patch does.
2945 \begin_layout Subsection
2946 Contributing to the Documentation
2949 \begin_layout Standard
2951 's documentation is extensive;
2952 however \SpecialChar LyX
2953 is under constant development,
2954 and each new release adds new features.
2955 You may find some documentation needs improvement.
2956 This section describes what to do if you find an error,
2957 or have some suggestions for improving the documentation.
2960 \begin_layout Subsubsection
2961 Reporting Errors in the Manuals
2964 \begin_layout Standard
2965 If you find a problem with the documentation,
2966 send a message to the mailing list
2967 \begin_inset CommandInset href
2969 target "lyx-docs@lists.lyx.org"
2976 The documentation team will make any necessary fixes.
2979 \begin_layout Subsubsection
2980 Joining the Documentation Team.
2983 \begin_layout Standard
2984 The \SpecialChar LyX
2985 Documentation Project,
2986 like anything else in the \SpecialChar LyX
2988 can always use assistance!
2989 If you're interested in contributing to the Documentation Project,
2990 you need to do the following:
2993 \begin_layout Enumerate
2994 Get the latest \SpecialChar LyX
2996 \begin_inset Newline newline
3000 \begin_inset CommandInset href
3002 target "https://www.lyx.org/trac/browser/lyxgit/lib/doc?rev=master "
3009 \begin_layout Enumerate
3018 \change_inserted -1463541724 1692966436
3021 \SpecialChar endofsentence
3025 \begin_inset Newline newline
3028 The point of this exercise is to give you ideas.
3037 are likely to be the most up-to-date of all of the documentation.
3038 You should be able to glean some insights into how we want the manuals to read and to look.
3041 \begin_layout Enumerate
3042 Contact the team at:
3043 \begin_inset Newline newline
3047 \begin_inset CommandInset href
3049 target "lyx-docs@lists.lyx.org"
3056 \begin_inset Newline newline
3059 to discuss your intended changes and to get some feedback on them.
3062 \begin_layout Standard
3063 The changes you wish to make may range from improving clarity of the text,
3064 to doing major re-structuring of the documentation.
3065 Any and all improvements are gladly received.