lib/doc/Intro.lyx

   1 #LyX 2.4 created this file. For more info see https://www.lyx.org/
   2 \lyxformat 618
   3 \begin_document
   4 \begin_header
   5 \save_transient_properties true
   6 \origin /systemlyxdir/doc/
   7 \textclass article
   8 \begin_preamble
   9 % DO NOT ALTER THIS PREAMBLE!!!
  10 %
  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
  17
  18 % the pages of the TOC is numbered roman
  19 % and a pdf-bookmark for the TOC is added
  20 \pagenumbering{roman}
  21 \let\myTOC\tableofcontents
  22 \renewcommand\tableofcontents{%
  23   \pdfbookmark[1]{\contentsname}{}
  24   \myTOC
  25   \cleardoublepage
  26   \pagenumbering{arabic} }
  27 \end_preamble
  28 \use_default_options false
  29 \maintain_unincluded_children no
  30 \language english
  31 \language_package default
  32 \inputencoding utf8
  33 \fontencoding auto
  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
  40 \font_sc true
  41 \font_roman_osf false
  42 \font_sans_osf false
  43 \font_typewriter_osf false
  44 \font_sf_scale 100 100
  45 \font_tt_scale 100 100
  46 \use_microtype false
  47 \use_dash_ligatures false
  48 \graphics default
  49 \default_output_format pdf2
  50 \output_sync 0
  51 \bibtex_command default
  52 \index_command default
  53 \paperfontsize 12
  54 \spacing single
  55 \use_hyperref true
  56 \pdf_title "Introduction to LyX"
  57 \pdf_author "LyX Team"
  58 \pdf_subject "LyX-documentation Intro"
  59 \pdf_keywords "LyX, documentation"
  60 \pdf_bookmarks true
  61 \pdf_bookmarksnumbered true
  62 \pdf_bookmarksopen true
  63 \pdf_bookmarksopenlevel 2
  64 \pdf_breaklinks true
  65 \pdf_pdfborder false
  66 \pdf_colorlinks true
  67 \pdf_backref false
  68 \pdf_pdfusetitle false
  69 \pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false"
  70 \papersize a4
  71 \use_geometry false
  72 \use_package amsmath 1
  73 \use_package amssymb 1
  74 \use_package cancel 1
  75 \use_package esint 1
  76 \use_package mathdots 1
  77 \use_package mathtools 1
  78 \use_package mhchem 1
  79 \use_package stackrel 1
  80 \use_package stmaryrd 1
  81 \use_package undertilde 1
  82 \cite_engine basic
  83 \cite_engine_type default
  84 \biblio_style plain
  85 \use_bibtopic false
  86 \use_indices false
  87 \paperorientation portrait
  88 \suppress_date false
  89 \justification true
  90 \use_refstyle 0
  91 \use_formatted_ref 0
  92 \use_minted 0
  93 \use_lineno 0
  94 \index Index
  95 \shortcut idx
  96 \color #008000
  97 \end_index
  98 \secnumdepth 3
  99 \tocdepth 2
 100 \paragraph_separation indent
 101 \paragraph_indentation default
 102 \is_math_indent 0
 103 \math_numbering_side default
 104 \quotes_style english
 105 \dynamic_quotes 0
 106 \papercolumns 1
 107 \papersides 1
 108 \paperpagestyle default
 109 \tablestyle default
 110 \tracking_changes true
 111 \output_changes false
 112 \change_bars false
 113 \postpone_fragile_content false
 114 \html_math_output 0
 115 \html_css_as_file 0
 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"
 121 \author 5863208 "ab"
 122 \end_header
 123
 124 \begin_body
 125
 126 \begin_layout Title
 127 Introduction to \SpecialChar LyX
 128
 129 \end_layout
 130
 131 \begin_layout Author
 132 by the \SpecialChar LyX
 133  Team
 134 \begin_inset Foot
 135 status collapsed
 136
 137 \begin_layout Plain Layout
 138 \noindent
 139 If you have comments on or corrections to this documentation,
 140  please send them to the \SpecialChar LyX
 141  Documentation mailing list:
 142
 143 \begin_inset CommandInset href
 144 LatexCommand href
 145 target "lyx-docs@lists.lyx.org"
 146 type "mailto:"
 147 literal "false"
 148
 149 \end_inset
 150
 151
 152 \end_layout
 153
 154 \end_inset
 155
 156
 157 \end_layout
 158
 159 \begin_layout Standard
 160 \begin_inset CommandInset toc
 161 LatexCommand tableofcontents
 162
 163 \end_inset
 164
 165
 166 \end_layout
 167
 168 \begin_layout Section
 169 The Philosophy of \SpecialChar LyX
 170
 171 \end_layout
 172
 173 \begin_layout Subsection
 174 What is \SpecialChar LyX
 175 ?
 176 \end_layout
 177
 178 \begin_layout Standard
 179 \SpecialChar LyX
 180  is a document preparation system.
 181  It excels at letting you create complex technical and scientific articles with mathematics,
 182  cross-references,
 183  bibliographies,
 184  indexes,
 185  etc.
 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,
 190  though granted,
 191  there are probably simpler programs available for that.
 192  It is definitely not the best tool for creating banners,
 193  flyers,
 194  or advertisements (we'll explain why later),
 195  though with some effort all these can be done,
 196  too.
 197  Here are some examples of what it is used for:
 198  memos,
 199  letters,
 200  dissertations and theses,
 201  lecture notes,
 202  seminar notebooks,
 203  conference proceedings,
 204  software documentation,
 205  books,
 206  articles in refereed scientific journals,
 207  scripts for plays and movies,
 208  business proposals,
 209  presentations
 210 \change_deleted -1463541724 1692922495
 211
 212 \change_unchanged
 213 \SpecialChar ldots
 214
 215 \end_layout
 216
 217 \begin_layout Standard
 218 \SpecialChar LyX
 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
 222 \end_inset
 223
 224 typewriter concept
 225 \begin_inset Quotes erd
 226 \end_inset
 227
 228 .
 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,
 231  not the author;
 232  with \SpecialChar LyX
 233 ,
 234  the author can concentrate on the contents of his writing.
 235 \end_layout
 236
 237 \begin_layout Standard
 238 Part of the initial challenge of using \SpecialChar LyX
 239  comes from the change in thinking that you,
 240  the user,
 241  must make.
 242  At one time,
 243  all we had for creating documents were typewriters,
 244  so we all learned certain tricks to get around their limitations.
 245  Underlining,
 246  which is little more than overstriking with the
 247 \begin_inset Quotes eld
 248 \end_inset
 249
 250 _
 251 \begin_inset Quotes erd
 252 \end_inset
 253
 254  character,
 255  became a way to emphasize text.
 256  You were forced to figure out column sizes and tab stops,
 257  and set them,
 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.
 261 \end_layout
 262
 263 \begin_layout Standard
 264 In other words,
 265  we've all been trained to worry about the little details of which character goes where.
 266  Consequently,
 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:
 273
 274 \begin_inset Quotes eld
 275 \end_inset
 276
 277 What You See Is What You Get
 278 \begin_inset Quotes erd
 279 \end_inset
 280
 281 .
 282  Unfortunately,
 283  that paradigm often results in
 284 \begin_inset Quotes eld
 285 \end_inset
 286
 287 What You See Is All You Get
 288 \begin_inset Quotes erd
 289 \end_inset
 290
 291 .
 292 \end_layout
 293
 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
 299
 300 \emph on
 301 what you're doing
 302 \emph default
 303  and \SpecialChar LyX
 304  takes care of the rest,
 305  following a set of rules called a
 306 \emph on
 307 style
 308 \emph default
 309 .
 310 \begin_inset Foot
 311 status collapsed
 312
 313 \begin_layout Plain Layout
 314 To be fair,
 315  most recent versions of the most popular office suites now have some sort of style sheets which follow a similar markup method.
 316  However,
 317  our experience is that they are still rarely used in practice.
 318 \end_layout
 319
 320 \end_inset
 321
 322  Let's look at a little example:
 323 \end_layout
 324
 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
 330 \end_inset
 331
 332 Introduction
 333 \change_deleted -1463541724 1692922782
 334 \SpecialChar endofsentence
 335
 336 \change_unchanged
 337
 338 \begin_inset Quotes erd
 339 \end_inset
 340
 341
 342 \change_inserted -1463541724 1692922792
 343 \SpecialChar endofsentence
 344
 345 \change_unchanged
 346  So,
 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.
 349  Then you type,
 350
 351 \begin_inset Quotes eld
 352 \end_inset
 353
 354 1.
 355 \begin_inset space ~
 356 \end_inset
 357
 358
 359 \begin_inset space ~
 360 \end_inset
 361
 362 Introduction
 363 \begin_inset Quotes erd
 364 \end_inset
 365
 366 .
 367  Of course,
 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.
 371 \end_layout
 372
 373 \begin_layout Standard
 374 In \SpecialChar LyX
 375 ,
 376  you go to the pull-down on the far left of the button bar and select
 377 \family sans
 378 Section
 379 \family default
 380 ,
 381  and type
 382 \begin_inset Quotes eld
 383 \end_inset
 384
 385 Introduction
 386 \begin_inset Quotes erd
 387 \end_inset
 388
 389 .
 390 \end_layout
 391
 392 \begin_layout Standard
 393 Yes,
 394  that's all.
 395  If you cut and paste the section,
 396  it will automatically be renumbered —
 397  everywhere.
 398  And if you enter references to that section correctly (by inserting cross-reference tags),
 399  \SpecialChar LyX
 400  will automatically update them all throughout the file so that you never,
 401  ever type a section number.
 402 \end_layout
 403
 404 \begin_layout Standard
 405 Now let's look at the problem of consistency.
 406  Five days later,
 407  you reopen your report and start Section
 408 \begin_inset space ~
 409 \end_inset
 410
 411 4.
 412  However,
 413  you forget that you were using 18
 414 \begin_inset space \thinspace{}
 415 \end_inset
 416
 417 pt bold instead of 16
 418 \begin_inset space \thinspace{}
 419 \end_inset
 420
 421 pt,
 422  so you type in the heading for Section
 423 \begin_inset space ~
 424 \end_inset
 425
 426 4 in a different font from the one you used for Section
 427 \begin_inset space ~
 428 \end_inset
 429
 430 1.
 431  That problem doesn't even exist in \SpecialChar LyX
 432 .
 433  The computer takes care of all that silly bookkeeping about which thing has what size font,
 434  not you.
 435  After all,
 436  that's what a computer is good at.
 437 \end_layout
 438
 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,
 447  and so on.
 448  Under \SpecialChar LyX
 449 ,
 450  you have only two concerns:
 451  what kind of list is this,
 452  and what do I want to put in it?
 453  That is it.
 454 \end_layout
 455
 456 \begin_layout Standard
 457 So,
 458  the basic idea behind \SpecialChar LyX
 459  is:
 460  specify
 461 \emph on
 462 what
 463 \emph default
 464  you're doing,
 465  not
 466 \emph on
 467 how
 468 \emph default
 469  to do it.
 470  Instead of
 471 \begin_inset Quotes eld
 472 \end_inset
 473
 474 What You See Is What You Get
 475 \change_deleted -1463541724 1692922450
 476 ,
 477 \change_unchanged
 478
 479 \begin_inset Quotes erd
 480 \end_inset
 481
 482
 483 \change_inserted -1463541724 1692923936
 484 ,
 485
 486 \change_unchanged
 487  the \SpecialChar LyX
 488  model is
 489 \begin_inset Quotes eld
 490 \end_inset
 491
 492 What You See Is What You
 493 \emph on
 494 Mean
 495 \emph default
 496
 497 \begin_inset Quotes erd
 498 \end_inset
 499
 500  or
 501 \change_deleted -1463541724 1692923839
 502
 503 \begin_inset Quotes eld
 504 \end_inset
 505
 506
 507 \change_unchanged
 508 WYSIWYM
 509 \change_deleted -1463541724 1692923836
 510 .
 511 \begin_inset Quotes erd
 512 \end_inset
 513
 514
 515 \change_inserted -1463541724 1692923925
 516 .
 517
 518 \change_unchanged
 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.
 522  In this case,
 523  you
 524 \emph on
 525 do
 526 \emph default
 527  want to specify exactly where everything goes,
 528  because there are no functional units like paragraphs,
 529  sections,
 530  etc.
 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.
 535 \end_layout
 536
 537 \begin_layout Subsection
 538 Differences between \SpecialChar LyX
 539  and Other Word Processors
 540 \end_layout
 541
 542 \begin_layout Standard
 543 Here's a list of things you won't find in \SpecialChar LyX
 544 :
 545 \end_layout
 546
 547 \begin_layout Itemize
 548 The document ruler
 549 \end_layout
 550
 551 \begin_layout Itemize
 552 Tab stops
 553 \end_layout
 554
 555 \begin_layout Itemize
 556 Extra whitespace (e.
 557 \begin_inset space \thinspace{}
 558 \end_inset
 559
 560 g.
 561 \begin_inset space \space{}
 562 \end_inset
 563
 564 hitting
 565 \family sans
 566 Enter
 567 \family default
 568  or
 569 \family sans
 570 Space
 571 \family default
 572  two or more times)
 573 \end_layout
 574
 575 \begin_layout Standard
 576 Tab stops,
 577  along with a ruler showing you the position of things on the page,
 578  are useless in \SpecialChar LyX
 579 .
 580  The program worries about where things go on the page,
 581  not you.
 582  Extra whitespace is similar;
 583  \SpecialChar LyX
 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.
 588 \end_layout
 589
 590 \begin_layout Standard
 591 Here are some things that exist in \SpecialChar LyX
 592 ,
 593  but aren't used as you might think:
 594 \end_layout
 595
 596 \begin_layout Itemize
 597 Indenting controls
 598 \end_layout
 599
 600 \begin_layout Itemize
 601 Page breaks
 602 \end_layout
 603
 604 \begin_layout Itemize
 605 Line spacing (e.
 606 \begin_inset space \thinspace{}
 607 \end_inset
 608
 609 g.
 610 \begin_inset space \space{}
 611 \end_inset
 612
 613 single spaced,
 614  double spaced,
 615  etc.)
 616 \end_layout
 617
 618 \begin_layout Itemize
 619 Whitespace,
 620  horizontal and vertical
 621 \end_layout
 622
 623 \begin_layout Itemize
 624 Fonts and font sizes
 625 \end_layout
 626
 627 \begin_layout Itemize
 628 Typefaces (bold,
 629  italic,
 630  underline,
 631  etc.)
 632 \end_layout
 633
 634 \begin_layout Standard
 635 Although they exist in \SpecialChar LyX
 636 ,
 637  you generally don't need them.
 638  \SpecialChar LyX
 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,
 645  as well.
 646  In general,
 647  the space between lines,
 648  between words,
 649  and between paragraphs is variable,
 650  set by \SpecialChar LyX
 651 .
 652 \begin_inset Foot
 653 status collapsed
 654
 655 \begin_layout Plain Layout
 656 There are ways to adjust all of these (only some of which require knowledge of \SpecialChar LaTeX
 657 ),
 658  either for a whole document or for a specific location in a document.
 659  See the
 660 \emph on
 661 User's Guide
 662 \emph default
 663  and/or the
 664 \emph on
 665 Additional Features
 666 \emph default
 667  manual for details.
 668 \end_layout
 669
 670 \end_inset
 671
 672
 673 \end_layout
 674
 675 \begin_layout Standard
 676 Lastly,
 677  there are a few areas where we believe \SpecialChar LyX
 678  (and \SpecialChar LaTeX
 679 ) surpasses many word processors:
 680 \end_layout
 681
 682 \begin_layout Itemize
 683 Hyphenation
 684 \end_layout
 685
 686 \begin_layout Itemize
 687 Lists of any type
 688 \end_layout
 689
 690 \begin_layout Itemize
 691 Mathematics
 692 \end_layout
 693
 694 \begin_layout Itemize
 695 Tables
 696 \end_layout
 697
 698 \begin_layout Itemize
 699 Cross-referencing
 700 \end_layout
 701
 702 \begin_layout Standard
 703 Granted,
 704  many modern word processors can handle mathematical symbols,
 705  tables,
 706  and hyphenation,
 707  and many have moved towards style definitions and the WYSIWYM concept.
 708  However,
 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.
 713  \SpecialChar LaTeX
 714  has been around since 1985,
 715  and
 716 \emph on
 717 works
 718 \emph default
 719 .
 720 \end_layout
 721
 722 \begin_layout Subsection
 723 What is \SpecialChar LaTeX
 724 ?
 725 \end_layout
 726
 727 \begin_layout Standard
 728 \SpecialChar LaTeX
 729  is a document preparation system designed by
 730 \noun on
 731 Leslie Lamport
 732 \noun default
 733  in 1985.
 734 \begin_inset Foot
 735 status collapsed
 736
 737 \begin_layout Plain Layout
 738 The source for the info in this section is
 739 \emph on
 740 A Guide to \SpecialChar LaTeX2e
 741
 742 \emph default
 743 ,
 744  by
 745 \noun on
 746 Helmut Kopka
 747 \noun default
 748  and
 749 \noun on
 750 Patrick Daly
 751 \noun default
 752 ,
 753  which has an entry in the bibliography of the
 754 \emph on
 755 User's Guide
 756 \emph default
 757 \SpecialChar endofsentence
 758
 759 \change_deleted 5863208 1693593461
 760
 761 \begin_inset Note Note
 762 status open
 763
 764 \begin_layout Plain Layout
 765
 766 \change_inserted -1463541724 1693568855
 767 Changed the fontface of the names in this footnote according to section 2.2.
 768 \end_layout
 769
 770 \begin_layout Plain Layout
 771
 772 \change_inserted -1463541724 1693568875
 773 Now ALL names in this document use the same fontface.
 774 \change_unchanged
 775
 776 \end_layout
 777
 778 \end_inset
 779
 780
 781 \change_unchanged
 782
 783 \end_layout
 784
 785 \end_inset
 786
 787  It was built up from a typesetting language called \SpecialChar TeX
 788 ,
 789  created by
 790 \shape smallcaps
 791 Donald Knuth
 792 \shape default
 793  in 1984.
 794  \SpecialChar TeX
 795  takes a sequence of typesetting commands,
 796  written in a script in an ASCII file,
 797  and executes them.
 798  Many of the
 799 \begin_inset Quotes eld
 800 \end_inset
 801
 802 tricks
 803 \begin_inset Quotes erd
 804 \end_inset
 805
 806  of the printing trade were modeled by
 807 \shape smallcaps
 808 Knuth
 809 \shape default
 810  as computer algorithms and incorporated into \SpecialChar TeX
 811 ,
 812  hence its excellent printed appearance.
 813  What comes directly out of \SpecialChar TeX
 814  is the
 815 \change_inserted -1463541724 1692922633
 816
 817 \begin_inset Quotes eld
 818 \end_inset
 819
 820
 821 \change_unchanged
 822 portable document format
 823 \change_inserted -1463541724 1692922640
 824
 825 \begin_inset Quotes erd
 826 \end_inset
 827
 828
 829 \change_unchanged
 830
 831 \emph on
 832 pdf
 833 \emph default
 834  or the so-called
 835 \begin_inset Quotes eld
 836 \end_inset
 837
 838 device independent
 839 \begin_inset Quotes erd
 840 \end_inset
 841
 842  format file
 843 \emph on
 844 dvi
 845 \emph default
 846 .
 847  The
 848 \family typewriter
 849 dvi
 850 \family default
 851  format is often used for previews and can later be converted to other formats like PostScript.
 852
 853 \end_layout
 854
 855 \begin_layout Standard
 856 \SpecialChar TeX
 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
 861 \noun on
 862 Knuth
 863 \noun default
 864  created to hide a lot of the typesetting details.
 865  This is where
 866 \noun on
 867 Leslie Lamport
 868 \noun default
 869  enters our story.
 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,
 873  consistent fashion.
 874  This is how \SpecialChar LaTeX
 875  was born.
 876 \end_layout
 877
 878 \begin_layout Standard
 879 Now,
 880  in parallel with the development and growth of \SpecialChar LaTeX
 881 ,
 882  other folks were creating their own custom macro packages for \SpecialChar TeX
 883 ,
 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
 888 .
 889  To try and unify this mess,
 890  a team of \SpecialChar LaTeX
 891 -nicians began to work on \SpecialChar LaTeX2e
 892 ,
 893  the current version of \SpecialChar LaTeX
 894 ,
 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,
 900  and so on.
 901  In fact,
 902  \SpecialChar LaTeX
 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.
 906 \end_layout
 907
 908 \begin_layout Standard
 909 There are two ways to extend \SpecialChar LaTeX
 910 :
 911  classes and styles.
 912  A
 913 \emph on
 914 class
 915 \emph default
 916  is a set of \SpecialChar LaTeX
 917  macros describing a new type of document,
 918  like a book,
 919  or an article.
 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.
 923  A
 924 \emph on
 925 style
 926 \emph default
 927  differs from a class in that it doesn't define a new type of document,
 928  but a different type of
 929 \emph on
 930 behavior
 931 \emph default
 932  that any document can use.
 933  For example,
 934  \SpecialChar LyX
 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,
 940  adding new fonts,
 941  manipulating graphics,
 942  designing fancy page headings,
 943  customizing bibliographies,
 944  altering the location and appearance of footnotes,
 945  tables,
 946  and figures,
 947  customizing lists,
 948  etc.
 949 \end_layout
 950
 951 \begin_layout Standard
 952 Here is a summary:
 953 \end_layout
 954
 955 \begin_layout Description
 956 \SpecialChar TeX
 957 :
 958  Typesetting language with macro capability.
 959 \end_layout
 960
 961 \begin_layout Description
 962 \SpecialChar LaTeX
 963 :
 964  Macro package built upon \SpecialChar TeX
 965 \SpecialChar endofsentence
 966
 967 \end_layout
 968
 969 \begin_layout Description
 970 classes:
 971  Descriptions of types of document used with \SpecialChar LaTeX
 972 \SpecialChar endofsentence
 973
 974 \end_layout
 975
 976 \begin_layout Description
 977 styles:
 978  Descriptions of the default behavior of particular elements of \SpecialChar LaTeX
 979 .
 980 \end_layout
 981
 982 \begin_layout Description
 983 \SpecialChar LyX
 984 :
 985  Visual,
 986  WYSIWYM document processor that uses \SpecialChar LaTeX
 987  to do its typesetting.
 988 \end_layout
 989
 990 \begin_layout Standard
 991 This section attempts to explain the difference between \SpecialChar LyX
 992  and a word processor.
 993  Simply put,
 994  \SpecialChar LaTeX
 995  is the difference.
 996  By using \SpecialChar LaTeX
 997  as its backend,
 998  \SpecialChar LyX
 999  helps you to think more about
1000 \emph on
1001  what
1002 \emph default
1003  (as in the
1004 \emph on
1005 words
1006 \emph default
1007 ) you write.
1008  The computer then handles
1009 \emph on
1010 how
1011 \emph default
1012  they should look.
1013 \end_layout
1014
1015 \begin_layout Section
1016 Navigating the Documentation
1017 \end_layout
1018
1019 \begin_layout Standard
1020 To make it easier to answer your questions and describe all of the features of \SpecialChar LyX
1021 ,
1022  the documentation has been split up into several different files.
1023  Each one has its own purpose,
1024  as described below.
1025  Before you go ploughing into any of those files,
1026  however,
1027  you should read this
1028 \change_deleted -1463541724 1693810883
1029 chapter
1030 \change_inserted -1463541724 1693810888
1031 section
1032 \change_deleted 5863208 1693855500
1033
1034 \begin_inset Note Note
1035 status collapsed
1036
1037 \begin_layout Plain Layout
1038
1039 \change_inserted -1463541724 1693810943
1040 Does it refer to this section or the whole document?
1041  I am going with the former.
1042 \change_unchanged
1043
1044 \end_layout
1045
1046 \end_inset
1047
1048
1049 \change_unchanged
1050  thoroughly,
1051  since it contains a lot of useful information and commentary that can save you some time.
1052 \end_layout
1053
1054 \begin_layout Standard
1055 Hopefully,
1056  the development of \SpecialChar LyX
1057  will never stop;
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
1061 ,
1062  the manuals are the work of a group of volunteers who have
1063 \begin_inset Quotes eld
1064 \end_inset
1065
1066 Real Jobs
1067 \begin_inset Quotes erd
1068 \end_inset
1069
1070 ,
1071  families,
1072  dishes to clean,
1073
1074 \emph on
1075 et cetera
1076 \emph default
1077 .
1078  If you want to help out,
1079  be sure to read Section
1080 \begin_inset space ~
1081 \end_inset
1082
1083
1084 \begin_inset CommandInset ref
1085 LatexCommand ref
1086 reference "sec:Contrib"
1087 nolink "false"
1088
1089 \end_inset
1090
1091  in addition to the rest of this document.
1092 \end_layout
1093
1094 \begin_layout Standard
1095 Also,
1096  please do us a favor:
1097  if anything in these manuals confuses you,
1098  is unclear,
1099  or wrong,
1100  don't hesitate to let us know!
1101  You can reach the current document
1102 \change_inserted -1463541724 1692963407
1103 ation
1104 \change_unchanged
1105  maintainers by emailing
1106 \begin_inset CommandInset href
1107 LatexCommand href
1108 target "lyx-docs@lists.lyx.org"
1109 type "mailto:"
1110 literal "false"
1111
1112 \end_inset
1113
1114 .
1115
1116 \change_deleted -1463541724 1692922571
1117
1118 \change_inserted -584632292 1610248366
1119
1120 \end_layout
1121
1122 \begin_layout Subsection
1123
1124 \change_inserted -584632292 1610248375
1125 Where To Get Help
1126 \end_layout
1127
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
1132 LatexCommand href
1133 target "lyx-users@lists.lyx.org"
1134 type "mailto:"
1135 literal "false"
1136
1137 \end_inset
1138
1139 .
1140
1141 \change_inserted -584632292 1610248524
1142  You do not have to register to post,
1143  but you may wish to do so.
1144  See
1145 \begin_inset CommandInset href
1146 LatexCommand href
1147 name "the LyX website"
1148 target "https://www.lyx.org/MailingLists"
1149 literal "false"
1150
1151 \end_inset
1152
1153  for further information.
1154  LyX also has a
1155 \begin_inset CommandInset href
1156 LatexCommand href
1157 target "http://wiki.lyx.org/"
1158 literal "false"
1159
1160 \end_inset
1161
1162  that will answer many questions about how to get LyX to do various things.
1163 \change_unchanged
1164
1165 \end_layout
1166
1167 \begin_layout Subsection
1168 The Format of the Manuals
1169 \end_layout
1170
1171 \begin_layout Standard
1172 Some of you may have printed out the manuals.
1173  Others may be reading them within \SpecialChar LyX
1174 .
1175  There are some differences between the \SpecialChar LyX
1176 -file and the printed version.
1177  In \SpecialChar LyX
1178 ,
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.
1182  To open a footnote,
1183  which looks like this:
1184
1185 \begin_inset Graphics
1186         filename clipart/footnote.png
1187         scale 95
1188
1189 \end_inset
1190
1191 ,
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
1195 \family sans
1196 Navigate
1197 \family default
1198  menu,
1199  where the contents are displayed automatically\SpecialChar endofsentence
1200
1201 \end_layout
1202
1203 \begin_layout Standard
1204 In the printed manuals,
1205  all cross-references appear as the actual numbers for a chapter,
1206  section,
1207  subsection,
1208  and so on.
1209  In the \SpecialChar LyX
1210 -file,
1211  however,
1212  all cross-references appear as light-grey boxes like the following:
1213
1214 \begin_inset Graphics
1215         filename clipart/reference.png
1216         scale 95
1217
1218 \end_inset
1219
1220 .
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
1225 section
1226 \change_inserted -1463541724 1693811124
1227 element
1228 \change_deleted 5863208 1693855665
1229
1230 \begin_inset Note Note
1231 status collapsed
1232
1233 \begin_layout Plain Layout
1234
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,
1237  now erased:
1238  Spanish and Catalan translations still had those explicit mentions.
1239 \end_layout
1240
1241 \begin_layout Plain Layout
1242
1243 \change_inserted -1463541724 1693811291
1244 Other possible replacement:
1245
1246 \begin_inset Quotes eld
1247 \end_inset
1248
1249 item
1250 \begin_inset Quotes erd
1251 \end_inset
1252
1253 .
1254 \change_unchanged
1255
1256 \end_layout
1257
1258 \end_inset
1259
1260
1261 \change_unchanged
1262  by right-clicking on the box or by clicking the button
1263 \family sans
1264 Go
1265 \begin_inset space ~
1266 \end_inset
1267
1268 to
1269 \begin_inset space ~
1270 \end_inset
1271
1272 Label
1273 \family default
1274  in the opened dialog.
1275  Going back to where you came from is just as easy.
1276  Click on
1277 \family sans
1278 Go
1279 \begin_inset space ~
1280 \end_inset
1281
1282 Back
1283 \family default
1284  to go back to your earlier location.
1285 \end_layout
1286
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:
1292 \end_layout
1293
1294 \begin_layout Itemize
1295
1296 \emph on
1297 Emphasized Style
1298 \emph default
1299  is used for general emphasis,
1300  generic arguments,
1301  book
1302 \change_inserted -1463541724 1692964248
1303  and manual
1304 \change_unchanged
1305  titles,
1306  names of sections of other manuals,
1307  and notes from the authors.
1308 \end_layout
1309
1310 \begin_layout Itemize
1311
1312 \family typewriter
1313 Typewriter
1314 \family default
1315  is used for program and file names,
1316  \SpecialChar LyX
1317  code and functions.
1318 \end_layout
1319
1320 \begin_layout Itemize
1321
1322 \family sans
1323 Sans Serif
1324 \family default
1325  is used for menu,
1326  button
1327 \change_deleted -1463541724 1692964370
1328 ,
1329
1330 \change_unchanged
1331  or dialog box names,
1332  and the names of keyboard keys.
1333 \end_layout
1334
1335 \begin_layout Itemize
1336
1337 \noun on
1338 Noun Style
1339 \noun default
1340  is used for people's names.
1341 \change_deleted 5863208 1692989367
1342
1343 \begin_inset Note Note
1344 status collapsed
1345
1346 \begin_layout Plain Layout
1347
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
1352 e
1353 \change_inserted -1463541724 1692964472
1354 set with this font face.
1355  Shall we change them?
1356 \change_inserted 5863208 1692989346
1357
1358 \end_layout
1359
1360 \begin_layout Plain Layout
1361
1362 \change_inserted 5863208 1692989349
1363 Done.
1364 \change_unchanged
1365
1366 \end_layout
1367
1368 \end_inset
1369
1370
1371 \change_unchanged
1372
1373 \end_layout
1374
1375 \begin_layout Itemize
1376
1377 \series bold
1378 Bold
1379 \series default
1380  is used for \SpecialChar LaTeX
1381  code
1382 \change_inserted -1463541724 1692842469
1383 .
1384 \change_unchanged
1385
1386 \end_layout
1387
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
1392
1393 \begin_inset Note Note
1394 status collapsed
1395
1396 \begin_layout Plain Layout
1397
1398 \change_inserted -1463541724 1692842873
1399 Do not think quotation marks are necessary when already using a different font face to differentiate the text.
1400 \change_unchanged
1401
1402 \end_layout
1403
1404 \end_inset
1405
1406
1407 \change_unchanged
1408
1409 \end_layout
1410
1411 \begin_layout Itemize
1412
1413 \change_deleted -1463541724 1692842633
1414 \begin_inset Quotes eld
1415 \end_inset
1416
1417
1418 \change_unchanged
1419
1420 \family sans
1421 Ctrl+
1422 \change_deleted -1463541724 1692842626
1423
1424 \family default
1425
1426 \begin_inset Quotes erd
1427 \end_inset
1428
1429
1430 \change_unchanged
1431  indicates the
1432 \family sans
1433 Control
1434 \family default
1435  key.
1436 \end_layout
1437
1438 \begin_layout Itemize
1439
1440 \change_deleted -1463541724 1692842634
1441 \begin_inset Quotes eld
1442 \end_inset
1443
1444
1445 \change_unchanged
1446
1447 \family sans
1448 Shift+
1449 \change_deleted -1463541724 1692842636
1450
1451 \family default
1452
1453 \begin_inset Quotes erd
1454 \end_inset
1455
1456
1457 \change_unchanged
1458  indicates the
1459 \family sans
1460 Shift
1461 \family default
1462  key.
1463 \end_layout
1464
1465 \begin_layout Itemize
1466
1467 \change_deleted -1463541724 1692842640
1468 \begin_inset Quotes eld
1469 \end_inset
1470
1471
1472 \change_unchanged
1473
1474 \family sans
1475 Alt+
1476 \change_deleted -1463541724 1692842639
1477
1478 \family default
1479
1480 \begin_inset Quotes erd
1481 \end_inset
1482
1483
1484 \change_unchanged
1485  indicates the
1486 \family sans
1487 Alt
1488 \family default
1489  (
1490 \family sans
1491 Meta
1492 \family default
1493 ) key.
1494 \end_layout
1495
1496 \begin_layout Itemize
1497
1498 \change_deleted -1463541724 1692842642
1499 \begin_inset Quotes eld
1500 \end_inset
1501
1502
1503 \change_unchanged
1504
1505 \family sans
1506 F1
1507 \change_deleted -1463541724 1692842642
1508
1509 \family default
1510
1511 \begin_inset Quotes erd
1512 \end_inset
1513
1514
1515 \change_unchanged
1516  \SpecialChar ldots
1517
1518 \change_deleted -1463541724 1692842644
1519
1520 \begin_inset Quotes eld
1521 \end_inset
1522
1523
1524 \change_unchanged
1525
1526 \family sans
1527 F12
1528 \change_deleted -1463541724 1692842646
1529
1530 \family default
1531
1532 \begin_inset Quotes erd
1533 \end_inset
1534
1535
1536 \change_unchanged
1537  are the function keys.
1538 \end_layout
1539
1540 \begin_layout Itemize
1541
1542 \change_deleted -1463541724 1692842662
1543 \begin_inset Quotes eld
1544 \end_inset
1545
1546
1547 \change_unchanged
1548
1549 \family sans
1550 Esc
1551 \change_deleted -1463541724 1692842663
1552
1553 \family default
1554
1555 \begin_inset Quotes erd
1556 \end_inset
1557
1558
1559 \change_unchanged
1560  is the escape key.
1561 \end_layout
1562
1563 \begin_layout Itemize
1564
1565 \change_deleted -1463541724 1692842660
1566 \begin_inset Quotes eld
1567 \end_inset
1568
1569
1570 \change_unchanged
1571
1572 \family sans
1573 Left
1574 \change_deleted -1463541724 1692842658
1575
1576 \family default
1577
1578 \begin_inset Quotes erd
1579 \end_inset
1580
1581
1582 \change_inserted -1463541724 1692964502
1583 ,
1584
1585 \change_unchanged
1586
1587 \change_deleted -1463541724 1692842658
1588
1589 \begin_inset Quotes eld
1590 \end_inset
1591
1592
1593 \change_unchanged
1594
1595 \family sans
1596 Right
1597 \change_deleted -1463541724 1692842648
1598
1599 \family default
1600
1601 \begin_inset Quotes erd
1602 \end_inset
1603
1604
1605 \change_inserted -1463541724 1692964504
1606 ,
1607
1608 \change_unchanged
1609
1610 \change_deleted -1463541724 1692842649
1611
1612 \begin_inset Quotes eld
1613 \end_inset
1614
1615
1616 \change_unchanged
1617
1618 \family sans
1619 Up
1620 \change_deleted -1463541724 1692842651
1621
1622 \family default
1623
1624 \begin_inset Quotes erd
1625 \end_inset
1626
1627
1628 \change_inserted -1463541724 1692964516
1629  and
1630 \change_unchanged
1631
1632 \change_deleted -1463541724 1692842650
1633
1634 \begin_inset Quotes eld
1635 \end_inset
1636
1637
1638 \change_unchanged
1639
1640 \family sans
1641 Down
1642 \change_deleted -1463541724 1692842655
1643
1644 \family default
1645
1646 \begin_inset Quotes erd
1647 \end_inset
1648
1649
1650 \change_unchanged
1651 :
1652  self-explanatory.
1653 \end_layout
1654
1655 \begin_layout Itemize
1656
1657 \change_deleted -1463541724 1692842666
1658
1659 \family sans
1660 \begin_inset Quotes eld
1661 \end_inset
1662
1663
1664 \change_unchanged
1665 Insert
1666 \change_deleted -1463541724 1692842664
1667
1668 \family default
1669
1670 \begin_inset Quotes erd
1671 \end_inset
1672
1673
1674 \change_inserted -1463541724 1692964521
1675 ,
1676
1677 \change_unchanged
1678
1679 \change_deleted -1463541724 1692842665
1680
1681 \begin_inset Quotes eld
1682 \end_inset
1683
1684
1685 \change_unchanged
1686
1687 \family sans
1688 Delete
1689 \change_deleted -1463541724 1692842667
1690
1691 \family default
1692
1693 \begin_inset Quotes erd
1694 \end_inset
1695
1696
1697 \change_inserted -1463541724 1692964524
1698 ,
1699
1700 \change_unchanged
1701
1702 \change_deleted -1463541724 1692842668
1703
1704 \begin_inset Quotes eld
1705 \end_inset
1706
1707
1708 \change_unchanged
1709
1710 \family sans
1711 Home
1712 \change_deleted -1463541724 1692842670
1713
1714 \family default
1715
1716 \begin_inset Quotes erd
1717 \end_inset
1718
1719
1720 \change_inserted -1463541724 1692964525
1721 ,
1722
1723 \change_unchanged
1724
1725 \change_deleted -1463541724 1692842671
1726
1727 \begin_inset Quotes eld
1728 \end_inset
1729
1730
1731 \change_unchanged
1732
1733 \family sans
1734 End
1735 \change_deleted -1463541724 1692842672
1736
1737 \family default
1738
1739 \begin_inset Quotes erd
1740 \end_inset
1741
1742
1743 \change_inserted -1463541724 1692964527
1744 ,
1745
1746 \change_unchanged
1747
1748 \change_deleted -1463541724 1692842673
1749
1750 \begin_inset Quotes eld
1751 \end_inset
1752
1753
1754 \change_unchanged
1755
1756 \family sans
1757 PageUp
1758 \change_deleted -1463541724 1692842674
1759
1760 \family default
1761
1762 \begin_inset Quotes erd
1763 \end_inset
1764
1765
1766 \change_inserted -1463541724 1692964535
1767  and
1768 \change_unchanged
1769
1770 \change_deleted -1463541724 1692842675
1771
1772 \begin_inset Quotes eld
1773 \end_inset
1774
1775
1776 \change_unchanged
1777
1778 \family sans
1779 PageDown
1780 \change_deleted -1463541724 1692842677
1781
1782 \family default
1783
1784 \begin_inset Quotes erd
1785 \end_inset
1786
1787
1788 \change_unchanged
1789 :
1790  these are the 6
1791 \begin_inset space ~
1792 \end_inset
1793
1794 keys that appear above the cursor keys on many PC keyboards.
1795
1796 \change_deleted -1463541724 1692842683
1797
1798 \begin_inset Quotes eld
1799 \end_inset
1800
1801
1802 \change_unchanged
1803
1804 \family sans
1805 PageUp
1806 \change_deleted -1463541724 1692842681
1807
1808 \family default
1809
1810 \begin_inset Quotes erd
1811 \end_inset
1812
1813
1814 \change_unchanged
1815  and
1816 \change_deleted -1463541724 1692842756
1817
1818 \begin_inset Quotes eld
1819 \end_inset
1820
1821
1822 \change_unchanged
1823
1824 \family sans
1825 PageDown
1826 \change_deleted -1463541724 1692842758
1827
1828 \family default
1829
1830 \begin_inset Quotes erd
1831 \end_inset
1832
1833
1834 \change_unchanged
1835  are called
1836 \change_deleted -1463541724 1692842752
1837
1838 \begin_inset Quotes eld
1839 \end_inset
1840
1841
1842 \change_unchanged
1843
1844 \family sans
1845 Prior
1846 \change_deleted -1463541724 1692842750
1847
1848 \family default
1849
1850 \begin_inset Quotes erd
1851 \end_inset
1852
1853
1854 \change_unchanged
1855  and
1856 \change_deleted -1463541724 1692842754
1857
1858 \begin_inset Quotes eld
1859 \end_inset
1860
1861
1862 \change_unchanged
1863
1864 \family sans
1865 Next
1866 \change_deleted -1463541724 1692842755
1867
1868 \family default
1869
1870 \begin_inset Quotes erd
1871 \end_inset
1872
1873
1874 \change_unchanged
1875  on some keyboards.
1876 \end_layout
1877
1878 \begin_layout Itemize
1879
1880 \family sans
1881 Return
1882 \family default
1883  and
1884 \family sans
1885 Enter
1886 \family default
1887  both refer to the same key.
1888  Some keyboards label the
1889 \family sans
1890 Return
1891 \family default
1892  key as
1893 \begin_inset Quotes eld
1894 \end_inset
1895
1896 Return
1897 \change_deleted -1463541724 1692842976
1898 ,
1899 \change_unchanged
1900
1901 \begin_inset Quotes erd
1902 \end_inset
1903
1904
1905 \change_inserted -1463541724 1692842978
1906 ,
1907
1908 \change_unchanged
1909  others as
1910 \begin_inset Quotes eld
1911 \end_inset
1912
1913 Enter
1914 \change_deleted -1463541724 1692842982
1915 ,
1916 \change_unchanged
1917
1918 \begin_inset Quotes erd
1919 \end_inset
1920
1921
1922 \change_inserted -1463541724 1692842991
1923 ,
1924 \change_deleted 5863208 1692989468
1925
1926 \begin_inset Note Note
1927 status collapsed
1928
1929 \begin_layout Plain Layout
1930
1931 \change_inserted -1463541724 1692966623
1932 Not direct speech,
1933  so punctuation goes out of the quoted text.
1934  See
1935 \begin_inset CommandInset href
1936 LatexCommand href
1937 name "Cambridge grammar (punctuation)"
1938 target "https://dictionary.cambridge.org/grammar/british-grammar/punctuation"
1939 literal "false"
1940
1941 \end_inset
1942
1943  or Collins grammar,
1944  to name a couple.
1945 \change_unchanged
1946
1947 \end_layout
1948
1949 \end_inset
1950
1951
1952 \change_unchanged
1953  still others have two keys.
1954  \SpecialChar LyX
1955  treats all of them as the same key,
1956  so we'll use
1957 \family sans
1958 Return
1959 \family default
1960  and
1961 \family sans
1962 Enter
1963 \family default
1964  interchangeably.
1965 \end_layout
1966
1967 \begin_layout Standard
1968 The list with the currently set shortcuts can be found in the
1969 \family sans
1970 Help
1971 \family default
1972  menu under
1973 \family sans
1974 Shortcuts
1975 \family default
1976 .
1977 \end_layout
1978
1979 \begin_layout Subsection
1980 Units used in the Manuals
1981 \end_layout
1982
1983 \begin_layout Standard
1984 To understand the units described in this documentation,
1985  Table
1986 \begin_inset space ~
1987 \end_inset
1988
1989
1990 \begin_inset CommandInset ref
1991 LatexCommand ref
1992 reference "tab:Units"
1993 nolink "false"
1994
1995 \end_inset
1996
1997  explains all units available in \SpecialChar LyX
1998 .
1999 \end_layout
2000
2001 \begin_layout Standard
2002 \begin_inset Float table
2003 placement document
2004 alignment document
2005 wide false
2006 sideways false
2007 status open
2008
2009 \begin_layout Plain Layout
2010 \begin_inset Caption Standard
2011
2012 \begin_layout Plain Layout
2013 \begin_inset CommandInset label
2014 LatexCommand label
2015 name "tab:Units"
2016
2017 \end_inset
2018
2019 Units
2020 \end_layout
2021
2022 \end_inset
2023
2024
2025 \end_layout
2026
2027 \begin_layout Plain Layout
2028 \begin_inset VSpace medskip
2029 \end_inset
2030
2031
2032 \end_layout
2033
2034 \begin_layout Plain Layout
2035 \align center
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">
2041 <row>
2042 <cell alignment="center" valignment="top" topline="true" bottomline="true" usebox="none">
2043 \begin_inset Text
2044
2045 \begin_layout Plain Layout
2046 unit
2047 \end_layout
2048
2049 \end_inset
2050 </cell>
2051 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
2052 \begin_inset Text
2053
2054 \begin_layout Plain Layout
2055 name/description
2056 \end_layout
2057
2058 \end_inset
2059 </cell>
2060 </row>
2061 <row>
2062 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2063 \begin_inset Text
2064
2065 \begin_layout Plain Layout
2066 mm
2067 \end_layout
2068
2069 \end_inset
2070 </cell>
2071 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2072 \begin_inset Text
2073
2074 \begin_layout Plain Layout
2075 millimeter
2076 \end_layout
2077
2078 \end_inset
2079 </cell>
2080 </row>
2081 <row>
2082 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2083 \begin_inset Text
2084
2085 \begin_layout Plain Layout
2086 cm
2087 \end_layout
2088
2089 \end_inset
2090 </cell>
2091 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2092 \begin_inset Text
2093
2094 \begin_layout Plain Layout
2095 centimeter
2096 \end_layout
2097
2098 \end_inset
2099 </cell>
2100 </row>
2101 <row>
2102 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2103 \begin_inset Text
2104
2105 \begin_layout Plain Layout
2106 in
2107 \end_layout
2108
2109 \end_inset
2110 </cell>
2111 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2112 \begin_inset Text
2113
2114 \begin_layout Plain Layout
2115 inch (1
2116 \begin_inset space \thinspace{}
2117 \end_inset
2118
2119 in = 2.54
2120 \begin_inset space \thinspace{}
2121 \end_inset
2122
2123 cm)
2124 \end_layout
2125
2126 \end_inset
2127 </cell>
2128 </row>
2129 <row>
2130 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2131 \begin_inset Text
2132
2133 \begin_layout Plain Layout
2134 pt
2135 \end_layout
2136
2137 \end_inset
2138 </cell>
2139 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2140 \begin_inset Text
2141
2142 \begin_layout Plain Layout
2143 point (72.27
2144 \begin_inset space \thinspace{}
2145 \end_inset
2146
2147 pt = 1
2148 \begin_inset space \thinspace{}
2149 \end_inset
2150
2151 in)
2152 \end_layout
2153
2154 \end_inset
2155 </cell>
2156 </row>
2157 <row>
2158 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2159 \begin_inset Text
2160
2161 \begin_layout Plain Layout
2162 pc
2163 \end_layout
2164
2165 \end_inset
2166 </cell>
2167 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2168 \begin_inset Text
2169
2170 \begin_layout Plain Layout
2171 pica (1
2172 \begin_inset space \thinspace{}
2173 \end_inset
2174
2175 pc = 12
2176 \begin_inset space \thinspace{}
2177 \end_inset
2178
2179 pt)
2180 \end_layout
2181
2182 \end_inset
2183 </cell>
2184 </row>
2185 <row>
2186 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2187 \begin_inset Text
2188
2189 \begin_layout Plain Layout
2190 sp
2191 \end_layout
2192
2193 \end_inset
2194 </cell>
2195 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2196 \begin_inset Text
2197
2198 \begin_layout Plain Layout
2199 scaled point (65536
2200 \begin_inset space \thinspace{}
2201 \end_inset
2202
2203 sp = 1
2204 \begin_inset space \thinspace{}
2205 \end_inset
2206
2207 pt)
2208 \end_layout
2209
2210 \end_inset
2211 </cell>
2212 </row>
2213 <row>
2214 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2215 \begin_inset Text
2216
2217 \begin_layout Plain Layout
2218 bp
2219 \end_layout
2220
2221 \end_inset
2222 </cell>
2223 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2224 \begin_inset Text
2225
2226 \begin_layout Plain Layout
2227 big point (72
2228 \begin_inset space \thinspace{}
2229 \end_inset
2230
2231 bp = 1
2232 \begin_inset space \thinspace{}
2233 \end_inset
2234
2235 in)
2236 \end_layout
2237
2238 \end_inset
2239 </cell>
2240 </row>
2241 <row>
2242 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2243 \begin_inset Text
2244
2245 \begin_layout Plain Layout
2246 dd
2247 \end_layout
2248
2249 \end_inset
2250 </cell>
2251 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2252 \begin_inset Text
2253
2254 \begin_layout Plain Layout
2255 didot (72
2256 \begin_inset space \thinspace{}
2257 \end_inset
2258
2259 dd
2260 \begin_inset Formula $\approx$
2261 \end_inset
2262
2263  37.6
2264 \begin_inset space \thinspace{}
2265 \end_inset
2266
2267 mm)
2268 \end_layout
2269
2270 \end_inset
2271 </cell>
2272 </row>
2273 <row>
2274 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2275 \begin_inset Text
2276
2277 \begin_layout Plain Layout
2278 cc
2279 \end_layout
2280
2281 \end_inset
2282 </cell>
2283 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2284 \begin_inset Text
2285
2286 \begin_layout Plain Layout
2287 cicero (1
2288 \begin_inset space \thinspace{}
2289 \end_inset
2290
2291 cc = 12
2292 \begin_inset space \thinspace{}
2293 \end_inset
2294
2295 dd)
2296 \end_layout
2297
2298 \end_inset
2299 </cell>
2300 </row>
2301 <row>
2302 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2303 \begin_inset Text
2304
2305 \begin_layout Plain Layout
2306 Scale%
2307 \end_layout
2308
2309 \end_inset
2310 </cell>
2311 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2312 \begin_inset Text
2313
2314 \begin_layout Plain Layout
2315 % of original image width
2316 \end_layout
2317
2318 \end_inset
2319 </cell>
2320 </row>
2321 <row>
2322 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2323 \begin_inset Text
2324
2325 \begin_layout Plain Layout
2326 text%
2327 \end_layout
2328
2329 \end_inset
2330 </cell>
2331 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2332 \begin_inset Text
2333
2334 \begin_layout Plain Layout
2335 % of text width
2336 \end_layout
2337
2338 \end_inset
2339 </cell>
2340 </row>
2341 <row>
2342 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2343 \begin_inset Text
2344
2345 \begin_layout Plain Layout
2346 col%
2347 \end_layout
2348
2349 \end_inset
2350 </cell>
2351 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2352 \begin_inset Text
2353
2354 \begin_layout Plain Layout
2355 % of column width
2356 \end_layout
2357
2358 \end_inset
2359 </cell>
2360 </row>
2361 <row>
2362 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2363 \begin_inset Text
2364
2365 \begin_layout Plain Layout
2366 page%
2367 \end_layout
2368
2369 \end_inset
2370 </cell>
2371 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2372 \begin_inset Text
2373
2374 \begin_layout Plain Layout
2375 % of paper width
2376 \end_layout
2377
2378 \end_inset
2379 </cell>
2380 </row>
2381 <row>
2382 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2383 \begin_inset Text
2384
2385 \begin_layout Plain Layout
2386 line%
2387 \end_layout
2388
2389 \end_inset
2390 </cell>
2391 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2392 \begin_inset Text
2393
2394 \begin_layout Plain Layout
2395 % of line width
2396 \end_layout
2397
2398 \end_inset
2399 </cell>
2400 </row>
2401 <row>
2402 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2403 \begin_inset Text
2404
2405 \begin_layout Plain Layout
2406 theight%
2407 \end_layout
2408
2409 \end_inset
2410 </cell>
2411 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2412 \begin_inset Text
2413
2414 \begin_layout Plain Layout
2415 % of text height
2416 \end_layout
2417
2418 \end_inset
2419 </cell>
2420 </row>
2421 <row>
2422 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2423 \begin_inset Text
2424
2425 \begin_layout Plain Layout
2426 pheight%
2427 \end_layout
2428
2429 \end_inset
2430 </cell>
2431 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2432 \begin_inset Text
2433
2434 \begin_layout Plain Layout
2435 % of paper height
2436 \end_layout
2437
2438 \end_inset
2439 </cell>
2440 </row>
2441 <row>
2442 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2443 \begin_inset Text
2444
2445 \begin_layout Plain Layout
2446 ex
2447 \end_layout
2448
2449 \end_inset
2450 </cell>
2451 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2452 \begin_inset Text
2453
2454 \begin_layout Plain Layout
2455 height of letter
2456 \emph on
2457 x
2458 \emph default
2459  in current font
2460 \end_layout
2461
2462 \end_inset
2463 </cell>
2464 </row>
2465 <row>
2466 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2467 \begin_inset Text
2468
2469 \begin_layout Plain Layout
2470 em
2471 \end_layout
2472
2473 \end_inset
2474 </cell>
2475 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2476 \begin_inset Text
2477
2478 \begin_layout Plain Layout
2479 width of letter
2480 \emph on
2481 M
2482 \emph default
2483  in current font
2484 \end_layout
2485
2486 \end_inset
2487 </cell>
2488 </row>
2489 <row>
2490 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
2491 \begin_inset Text
2492
2493 \begin_layout Plain Layout
2494 mu
2495 \end_layout
2496
2497 \end_inset
2498 </cell>
2499 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
2500 \begin_inset Text
2501
2502 \begin_layout Plain Layout
2503 math unit (1
2504 \begin_inset space \thinspace{}
2505 \end_inset
2506
2507 mu = 1/18
2508 \begin_inset space \thinspace{}
2509 \end_inset
2510
2511 em)
2512 \end_layout
2513
2514 \end_inset
2515 </cell>
2516 </row>
2517 </lyxtabular>
2518
2519 \end_inset
2520
2521
2522 \end_layout
2523
2524 \end_inset
2525
2526
2527 \end_layout
2528
2529 \begin_layout Subsection
2530 The Manuals
2531 \end_layout
2532
2533 \begin_layout Standard
2534 The following list describes the contents of the basic documentation files that you find in the
2535 \family sans
2536 Help
2537 \family default
2538  menu:
2539 \end_layout
2540
2541 \begin_layout Description
2542 Introduction This file.
2543 \end_layout
2544
2545 \begin_layout Description
2546 Tutorial If you are new to \SpecialChar LyX
2547 ,
2548  and have never used \SpecialChar LaTeX
2549  before,
2550  you should start here.
2551  If you have used \SpecialChar LaTeX
2552  before,
2553  you should still read the
2554 \emph on
2555 Tutorial
2556 \emph default
2557 ,
2558  starting with the section on
2559 \change_deleted -1463541724 1692917771
2560
2561 \begin_inset Quotes eld
2562 \end_inset
2563
2564
2565 \change_unchanged
2566
2567 \emph on
2568 \SpecialChar LyX
2569  for \SpecialChar LaTeX
2570  users
2571 \change_deleted -1463541724 1692917763
2572
2573 \emph default
2574 .
2575 \begin_inset Quotes erd
2576 \end_inset
2577
2578
2579 \change_inserted -1463541724 1692917775
2580 .
2581 \change_deleted 5863208 1692989483
2582
2583 \begin_inset Note Note
2584 status collapsed
2585
2586 \begin_layout Plain Layout
2587
2588 \change_inserted -1463541724 1692918131
2589 Again,
2590  don't see the point in quoting text already using a different font face.
2591  Additionally,
2592  was not complying to the use of font faces in the manuals stated in section 2.2.
2593 \change_unchanged
2594
2595 \end_layout
2596
2597 \end_inset
2598
2599
2600 \change_unchanged
2601  (Skimming through the rest of the document wouldn't hurt,
2602  either.)
2603 \end_layout
2604
2605 \begin_layout Description
2606 User's
2607 \begin_inset space ~
2608 \end_inset
2609
2610 Guide The primary documentation.
2611  We'll cover
2612 \emph on
2613 most
2614 \emph default
2615  of the basic operation and available features of \SpecialChar LyX
2616  here.
2617  The main manual assumes that you have read the
2618 \emph on
2619 Tutorial
2620 \emph default
2621 .
2622 \end_layout
2623
2624 \begin_layout Description
2625 Embedded
2626 \begin_inset space ~
2627 \end_inset
2628
2629 Objects Extension of the
2630 \emph on
2631 User's Guide
2632 \emph default
2633 .
2634  Documents in detail how to use tables,
2635  graphics,
2636  floats,
2637  notes,
2638  program listings and boxes.
2639  It also includes many tricks of the \SpecialChar LaTeX
2640  masters.
2641 \end_layout
2642
2643 \begin_layout Description
2644 Math Extension of the
2645 \emph on
2646 User's Guide
2647 \emph default
2648 .
2649  Documents in detail how to typeset any kind of formula.
2650 \end_layout
2651
2652 \begin_layout Description
2653 Additional
2654 \begin_inset space ~
2655 \end_inset
2656
2657 Features Extension of the
2658 \emph on
2659 User's Guide
2660 \emph default
2661 .
2662  Documents how to use raw \SpecialChar LaTeX
2663  commands,
2664  additional layouts and special-purpose editing features.
2665 \end_layout
2666
2667 \begin_layout Description
2668 Customization A description of advanced \SpecialChar LyX
2669  features,
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.
2678 \end_layout
2679
2680 \begin_layout Description
2681 Shortcuts Tables of the currently defined \SpecialChar LyX
2682  shortcuts.
2683 \end_layout
2684
2685 \begin_layout Description
2686 \SpecialChar LaTeX
2687
2688 \begin_inset space ~
2689 \end_inset
2690
2691 Configuration A report produced by \SpecialChar LyX
2692  about your system.
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.
2696 \end_layout
2697
2698 \begin_layout Standard
2699 These files will reference one another as necessary.
2700  For example,
2701  the
2702 \emph on
2703 User's Guide
2704 \emph default
2705  contains
2706 \emph on
2707 some
2708 \emph default
2709  information on installation and customization,
2710  but refers the reader to the
2711 \emph on
2712 Customization
2713 \emph default
2714
2715 \change_deleted -1463541724 1692964787
2716 M
2717 \change_inserted -1463541724 1692964788
2718 m
2719 \change_unchanged
2720 anual for more information.
2721 \end_layout
2722
2723 \begin_layout Standard
2724 We'll state again an important point:
2725 \end_layout
2726
2727 \begin_layout Standard
2728 \begin_inset VSpace bigskip
2729 \end_inset
2730
2731
2732 \end_layout
2733
2734 \begin_layout Standard
2735 \align center
2736 If you are new to \SpecialChar LyX
2737 ,
2738  read the
2739 \emph on
2740 Tutorial
2741 \emph default
2742 .
2743  Now\SpecialChar endofsentence
2744
2745 \end_layout
2746
2747 \begin_layout Standard
2748 \begin_inset VSpace bigskip
2749 \end_inset
2750
2751
2752 \end_layout
2753
2754 \begin_layout Standard
2755 Otherwise,
2756  you could needlessly frustrate yourself.
2757 \end_layout
2758
2759 \begin_layout Section
2760 Contributing to the \SpecialChar LyX
2761  Project
2762 \begin_inset CommandInset label
2763 LatexCommand label
2764 name "sec:Contrib"
2765
2766 \end_inset
2767
2768
2769 \end_layout
2770
2771 \begin_layout Subsection
2772 Contributing to \SpecialChar LyX
2773
2774 \end_layout
2775
2776 \begin_layout Standard
2777 \SpecialChar LyX
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.
2783 \end_layout
2784
2785 \begin_layout Subsubsection
2786 Reporting a bug
2787 \end_layout
2788
2789 \begin_layout Standard
2790 While using \SpecialChar LyX
2791 ,
2792  you may find behavior which you consider a bug.
2793  Crashes,
2794  though rare,
2795  can happen.
2796  User interface problems are considered major bugs by the \SpecialChar LyX
2797  team:
2798  especially helpful are indications of parts of the \SpecialChar LyX
2799  interface you find confusing,
2800  or unclear.
2801 \end_layout
2802
2803 \begin_layout Standard
2804 \SpecialChar LyX
2805  has a bug tracking system,
2806  which you can find at
2807 \begin_inset Newline newline
2808 \end_inset
2809
2810
2811 \begin_inset CommandInset href
2812 LatexCommand href
2813 target "https://www.lyx.org/trac/wiki/BugTrackerHome"
2814
2815 \end_inset
2816
2817 .
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,
2824
2825 \begin_inset CommandInset href
2826 LatexCommand href
2827 target "lyx-devel@lists.lyx.org"
2828 type "mailto:"
2829 literal "false"
2830
2831 \end_inset
2832
2833 .
2834  Archives of this list are linked from the main \SpecialChar LyX
2835  website,
2836
2837 \change_deleted 5863208 1692989524
2838
2839 \begin_inset CommandInset href
2840 LatexCommand href
2841 target "http://www.lyx.org"
2842
2843 \end_inset
2844
2845
2846 \change_inserted 5863208 1692989534
2847
2848 \begin_inset CommandInset href
2849 LatexCommand href
2850 target "https://www.lyx.org/MailingLists"
2851 literal "false"
2852
2853 \end_inset
2854
2855
2856 \change_deleted 5863208 1692989524
2857
2858 \begin_inset Note Note
2859 status open
2860
2861 \begin_layout Plain Layout
2862
2863 \change_inserted -1463541724 1692966662
2864 Substitute this link for the more specific
2865 \begin_inset CommandInset href
2866 LatexCommand href
2867 target "https://www.lyx.org/MailingLists#toc3"
2868
2869 \end_inset
2870
2871  or maybe just
2872 \change_deleted 5863208 1692989514
2873
2874 \begin_inset CommandInset href
2875 LatexCommand href
2876 target "https://www.lyx.org/MailingLists"
2877 literal "false"
2878
2879 \end_inset
2880
2881
2882 \change_inserted -1463541724 1692966662
2883 ?
2884 \change_unchanged
2885
2886 \end_layout
2887
2888 \end_inset
2889
2890
2891 \change_unchanged
2892 .
2893 \end_layout
2894
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.
2898  Accurate,
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
2903 .
2904  Give the versions of the libraries you have installed on your system,
2905  and,
2906  if relevant,
2907  the versions of external programs that \SpecialChar LyX
2908  uses.
2909  If it's a compilation or configuration problem,
2910  include the file
2911 \family typewriter
2912 config.log
2913 \family default
2914 ,
2915  and mention which compiler you are using.
2916
2917 \change_inserted 5863208 1692989585
2918
2919 \change_deleted -1463541724 1693810816
2920
2921 \begin_inset Quotes eld
2922 \end_inset
2923
2924
2925 \change_inserted 5863208 1692989585
2926 Part of this information can be found in
2927 \family sans
2928 Help\SpecialChar menuseparator
2929 About
2930 \family default
2931 .
2932 \change_deleted -1463541724 1693810814
2933
2934 \begin_inset Quotes erd
2935 \end_inset
2936
2937
2938 \change_deleted 5863208 1692989598
2939
2940 \begin_inset Note Note
2941 status collapsed
2942
2943 \begin_layout Plain Layout
2944
2945 \change_inserted -1463541724 1692957260
2946 Shall we mention this information can be found in
2947 \family sans
2948 Help\SpecialChar menuseparator
2949 About
2950 \family default
2951 ?
2952  For instance:
2953 \end_layout
2954
2955 \begin_layout Plain Layout
2956
2957 \change_inserted -1463541724 1692966675
2958 \begin_inset Quotes eld
2959 \end_inset
2960
2961 Most of this information can be found in
2962 \family sans
2963 Help\SpecialChar menuseparator
2964 About
2965 \family default
2966 .
2967 \begin_inset Quotes erd
2968 \end_inset
2969
2970  or
2971 \end_layout
2972
2973 \begin_layout Plain Layout
2974
2975 \change_inserted -1463541724 1692966688
2976 \begin_inset Quotes eld
2977 \end_inset
2978
2979 Part of this information can be found in
2980 \family sans
2981 Help\SpecialChar menuseparator
2982 About
2983 \family default
2984 .
2985 \begin_inset Quotes erd
2986 \end_inset
2987
2988
2989 \change_unchanged
2990
2991 \end_layout
2992
2993 \end_inset
2994
2995
2996 \change_unchanged
2997
2998 \end_layout
2999
3000 \begin_layout Subsubsection
3001 Contributing fixes and new features
3002 \end_layout
3003
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
3007 ,
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.
3011 \end_layout
3012
3013 \begin_layout Subsection
3014 Contributing to the Documentation
3015 \end_layout
3016
3017 \begin_layout Standard
3018 \SpecialChar LyX
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.
3026 \end_layout
3027
3028 \begin_layout Subsubsection
3029 Reporting Errors in the Manuals
3030 \end_layout
3031
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
3036 LatexCommand href
3037 target "lyx-docs@lists.lyx.org"
3038 type "mailto:"
3039 literal "false"
3040
3041 \end_inset
3042
3043 .
3044  The documentation team will make any necessary fixes.
3045 \end_layout
3046
3047 \begin_layout Subsubsection
3048 Joining the Documentation Team.
3049 \end_layout
3050
3051 \begin_layout Standard
3052 The \SpecialChar LyX
3053  Documentation Project,
3054  like anything else in the \SpecialChar LyX
3055  project,
3056  can always use assistance!
3057  If you're interested in contributing to the Documentation Project,
3058  you need to do the following:
3059 \end_layout
3060
3061 \begin_layout Enumerate
3062 Get the latest \SpecialChar LyX
3063  source code from
3064 \begin_inset Newline newline
3065 \end_inset
3066
3067
3068 \begin_inset CommandInset href
3069 LatexCommand href
3070 target "https://www.lyx.org/trac/browser/lyxgit/lib/doc?rev=master "
3071
3072 \end_inset
3073
3074
3075 \end_layout
3076
3077 \begin_layout Enumerate
3078 Next,
3079  read the
3080 \emph on
3081 User's Guide
3082 \emph default
3083  and the
3084 \emph on
3085 Tutorial
3086 \change_inserted -1463541724 1692966436
3087
3088 \emph default
3089 \SpecialChar endofsentence
3090
3091 \change_unchanged
3092
3093 \begin_inset Newline newline
3094 \end_inset
3095
3096 The point of this exercise is to give you ideas.
3097  The
3098 \emph on
3099 Tutorial
3100 \emph default
3101  and
3102 \emph on
3103 User's Guide
3104 \emph default
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.
3107 \end_layout
3108
3109 \begin_layout Enumerate
3110 Contact the team at:
3111 \begin_inset Newline newline
3112 \end_inset
3113
3114
3115 \begin_inset CommandInset href
3116 LatexCommand href
3117 target "lyx-docs@lists.lyx.org"
3118 type "mailto:"
3119 literal "false"
3120
3121 \end_inset
3122
3123
3124 \begin_inset Newline newline
3125 \end_inset
3126
3127 to discuss your intended changes and to get some feedback on them.
3128 \end_layout
3129
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.
3134 \end_layout
3135
3136 \end_body
3137 \end_document