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 chapter thoroughly,
1028  since it contains a lot of useful information and commentary that can save you some time.
1029 \end_layout
1030
1031 \begin_layout Standard
1032 Hopefully,
1033  the development of \SpecialChar LyX
1034  will never stop;
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
1038 ,
1039  the manuals are the work of a group of volunteers who have
1040 \begin_inset Quotes eld
1041 \end_inset
1042
1043 Real Jobs
1044 \begin_inset Quotes erd
1045 \end_inset
1046
1047 ,
1048  families,
1049  dishes to clean,
1050
1051 \emph on
1052 et cetera
1053 \emph default
1054 .
1055  If you want to help out,
1056  be sure to read Section
1057 \begin_inset space ~
1058 \end_inset
1059
1060
1061 \begin_inset CommandInset ref
1062 LatexCommand ref
1063 reference "sec:Contrib"
1064 nolink "false"
1065
1066 \end_inset
1067
1068  in addition to the rest of this document.
1069 \end_layout
1070
1071 \begin_layout Standard
1072 Also,
1073  please do us a favor:
1074  if anything in these manuals confuses you,
1075  is unclear,
1076  or wrong,
1077  don't hesitate to let us know!
1078  You can reach the current document
1079 \change_inserted -1463541724 1692963407
1080 ation
1081 \change_unchanged
1082  maintainers by emailing
1083 \begin_inset CommandInset href
1084 LatexCommand href
1085 target "lyx-docs@lists.lyx.org"
1086 type "mailto:"
1087 literal "false"
1088
1089 \end_inset
1090
1091 .
1092
1093 \change_deleted -1463541724 1692922571
1094
1095 \change_inserted -584632292 1610248366
1096
1097 \end_layout
1098
1099 \begin_layout Subsection
1100
1101 \change_inserted -584632292 1610248375
1102 Where To Get Help
1103 \end_layout
1104
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
1109 LatexCommand href
1110 target "lyx-users@lists.lyx.org"
1111 type "mailto:"
1112 literal "false"
1113
1114 \end_inset
1115
1116 .
1117
1118 \change_inserted -584632292 1610248524
1119  You do not have to register to post,
1120  but you may wish to do so.
1121  See
1122 \begin_inset CommandInset href
1123 LatexCommand href
1124 name "the LyX website"
1125 target "https://www.lyx.org/MailingLists"
1126 literal "false"
1127
1128 \end_inset
1129
1130  for further information.
1131  LyX also has a
1132 \begin_inset CommandInset href
1133 LatexCommand href
1134 target "http://wiki.lyx.org/"
1135 literal "false"
1136
1137 \end_inset
1138
1139  that will answer many questions about how to get LyX to do various things.
1140 \change_unchanged
1141
1142 \end_layout
1143
1144 \begin_layout Subsection
1145 The Format of the Manuals
1146 \end_layout
1147
1148 \begin_layout Standard
1149 Some of you may have printed out the manuals.
1150  Others may be reading them within \SpecialChar LyX
1151 .
1152  There are some differences between the \SpecialChar LyX
1153 -file and the printed version.
1154  In \SpecialChar LyX
1155 ,
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.
1159  To open a footnote,
1160  which looks like this:
1161
1162 \begin_inset Graphics
1163         filename clipart/footnote.png
1164         scale 95
1165
1166 \end_inset
1167
1168 ,
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
1172 \family sans
1173 Navigate
1174 \family default
1175  menu,
1176  where the contents are displayed automatically\SpecialChar endofsentence
1177
1178 \end_layout
1179
1180 \begin_layout Standard
1181 In the printed manuals,
1182  all cross-references appear as the actual numbers for a chapter,
1183  section,
1184  subsection,
1185  and so on.
1186  In the \SpecialChar LyX
1187 -file,
1188  however,
1189  all cross-references appear as light-grey boxes like the following:
1190
1191 \begin_inset Graphics
1192         filename clipart/reference.png
1193         scale 95
1194
1195 \end_inset
1196
1197 .
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
1201 \family sans
1202 Go
1203 \begin_inset space ~
1204 \end_inset
1205
1206 to
1207 \begin_inset space ~
1208 \end_inset
1209
1210 Label
1211 \family default
1212  in the opened dialog.
1213  Going back to where you came from is just as easy.
1214  Click on
1215 \family sans
1216 Go
1217 \begin_inset space ~
1218 \end_inset
1219
1220 Back
1221 \family default
1222  to go back to your earlier location.
1223 \end_layout
1224
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:
1230 \end_layout
1231
1232 \begin_layout Itemize
1233
1234 \emph on
1235 Emphasized Style
1236 \emph default
1237  is used for general emphasis,
1238  generic arguments,
1239  book
1240 \change_inserted -1463541724 1692964248
1241  and manual
1242 \change_unchanged
1243  titles,
1244  names of sections of other manuals,
1245  and notes from the authors.
1246 \end_layout
1247
1248 \begin_layout Itemize
1249
1250 \family typewriter
1251 Typewriter
1252 \family default
1253  is used for program and file names,
1254  \SpecialChar LyX
1255  code and functions.
1256 \end_layout
1257
1258 \begin_layout Itemize
1259
1260 \family sans
1261 Sans Serif
1262 \family default
1263  is used for menu,
1264  button
1265 \change_deleted -1463541724 1692964370
1266 ,
1267
1268 \change_unchanged
1269  or dialog box names,
1270  and the names of keyboard keys.
1271 \end_layout
1272
1273 \begin_layout Itemize
1274
1275 \noun on
1276 Noun Style
1277 \noun default
1278  is used for people's names.
1279 \change_deleted 5863208 1692989367
1280
1281 \begin_inset Note Note
1282 status open
1283
1284 \begin_layout Plain Layout
1285
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
1290 e
1291 \change_inserted -1463541724 1692964472
1292 set with this font face.
1293  Shall we change them?
1294 \change_inserted 5863208 1692989346
1295
1296 \end_layout
1297
1298 \begin_layout Plain Layout
1299
1300 \change_inserted 5863208 1692989349
1301 Done.
1302 \change_unchanged
1303
1304 \end_layout
1305
1306 \end_inset
1307
1308
1309 \change_unchanged
1310
1311 \end_layout
1312
1313 \begin_layout Itemize
1314
1315 \series bold
1316 Bold
1317 \series default
1318  is used for \SpecialChar LaTeX
1319  code
1320 \change_inserted -1463541724 1692842469
1321 .
1322 \change_unchanged
1323
1324 \end_layout
1325
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
1330
1331 \begin_inset Note Note
1332 status collapsed
1333
1334 \begin_layout Plain Layout
1335
1336 \change_inserted -1463541724 1692842873
1337 Do not think quotation marks are necessary when already using a different font face to differentiate the text.
1338 \change_unchanged
1339
1340 \end_layout
1341
1342 \end_inset
1343
1344
1345 \change_unchanged
1346
1347 \end_layout
1348
1349 \begin_layout Itemize
1350
1351 \change_deleted -1463541724 1692842633
1352 \begin_inset Quotes eld
1353 \end_inset
1354
1355
1356 \change_unchanged
1357
1358 \family sans
1359 Ctrl+
1360 \change_deleted -1463541724 1692842626
1361
1362 \family default
1363
1364 \begin_inset Quotes erd
1365 \end_inset
1366
1367
1368 \change_unchanged
1369  indicates the
1370 \family sans
1371 Control
1372 \family default
1373  key.
1374 \end_layout
1375
1376 \begin_layout Itemize
1377
1378 \change_deleted -1463541724 1692842634
1379 \begin_inset Quotes eld
1380 \end_inset
1381
1382
1383 \change_unchanged
1384
1385 \family sans
1386 Shift+
1387 \change_deleted -1463541724 1692842636
1388
1389 \family default
1390
1391 \begin_inset Quotes erd
1392 \end_inset
1393
1394
1395 \change_unchanged
1396  indicates the
1397 \family sans
1398 Shift
1399 \family default
1400  key.
1401 \end_layout
1402
1403 \begin_layout Itemize
1404
1405 \change_deleted -1463541724 1692842640
1406 \begin_inset Quotes eld
1407 \end_inset
1408
1409
1410 \change_unchanged
1411
1412 \family sans
1413 Alt+
1414 \change_deleted -1463541724 1692842639
1415
1416 \family default
1417
1418 \begin_inset Quotes erd
1419 \end_inset
1420
1421
1422 \change_unchanged
1423  indicates the
1424 \family sans
1425 Alt
1426 \family default
1427  (
1428 \family sans
1429 Meta
1430 \family default
1431 ) key.
1432 \end_layout
1433
1434 \begin_layout Itemize
1435
1436 \change_deleted -1463541724 1692842642
1437 \begin_inset Quotes eld
1438 \end_inset
1439
1440
1441 \change_unchanged
1442
1443 \family sans
1444 F1
1445 \change_deleted -1463541724 1692842642
1446
1447 \family default
1448
1449 \begin_inset Quotes erd
1450 \end_inset
1451
1452
1453 \change_unchanged
1454  \SpecialChar ldots
1455
1456 \change_deleted -1463541724 1692842644
1457
1458 \begin_inset Quotes eld
1459 \end_inset
1460
1461
1462 \change_unchanged
1463
1464 \family sans
1465 F12
1466 \change_deleted -1463541724 1692842646
1467
1468 \family default
1469
1470 \begin_inset Quotes erd
1471 \end_inset
1472
1473
1474 \change_unchanged
1475  are the function keys.
1476 \end_layout
1477
1478 \begin_layout Itemize
1479
1480 \change_deleted -1463541724 1692842662
1481 \begin_inset Quotes eld
1482 \end_inset
1483
1484
1485 \change_unchanged
1486
1487 \family sans
1488 Esc
1489 \change_deleted -1463541724 1692842663
1490
1491 \family default
1492
1493 \begin_inset Quotes erd
1494 \end_inset
1495
1496
1497 \change_unchanged
1498  is the escape key.
1499 \end_layout
1500
1501 \begin_layout Itemize
1502
1503 \change_deleted -1463541724 1692842660
1504 \begin_inset Quotes eld
1505 \end_inset
1506
1507
1508 \change_unchanged
1509
1510 \family sans
1511 Left
1512 \change_deleted -1463541724 1692842658
1513
1514 \family default
1515
1516 \begin_inset Quotes erd
1517 \end_inset
1518
1519
1520 \change_inserted -1463541724 1692964502
1521 ,
1522
1523 \change_unchanged
1524
1525 \change_deleted -1463541724 1692842658
1526
1527 \begin_inset Quotes eld
1528 \end_inset
1529
1530
1531 \change_unchanged
1532
1533 \family sans
1534 Right
1535 \change_deleted -1463541724 1692842648
1536
1537 \family default
1538
1539 \begin_inset Quotes erd
1540 \end_inset
1541
1542
1543 \change_inserted -1463541724 1692964504
1544 ,
1545
1546 \change_unchanged
1547
1548 \change_deleted -1463541724 1692842649
1549
1550 \begin_inset Quotes eld
1551 \end_inset
1552
1553
1554 \change_unchanged
1555
1556 \family sans
1557 Up
1558 \change_deleted -1463541724 1692842651
1559
1560 \family default
1561
1562 \begin_inset Quotes erd
1563 \end_inset
1564
1565
1566 \change_inserted -1463541724 1692964516
1567  and
1568 \change_unchanged
1569
1570 \change_deleted -1463541724 1692842650
1571
1572 \begin_inset Quotes eld
1573 \end_inset
1574
1575
1576 \change_unchanged
1577
1578 \family sans
1579 Down
1580 \change_deleted -1463541724 1692842655
1581
1582 \family default
1583
1584 \begin_inset Quotes erd
1585 \end_inset
1586
1587
1588 \change_unchanged
1589 :
1590  self-explanatory.
1591 \end_layout
1592
1593 \begin_layout Itemize
1594
1595 \change_deleted -1463541724 1692842666
1596
1597 \family sans
1598 \begin_inset Quotes eld
1599 \end_inset
1600
1601
1602 \change_unchanged
1603 Insert
1604 \change_deleted -1463541724 1692842664
1605
1606 \family default
1607
1608 \begin_inset Quotes erd
1609 \end_inset
1610
1611
1612 \change_inserted -1463541724 1692964521
1613 ,
1614
1615 \change_unchanged
1616
1617 \change_deleted -1463541724 1692842665
1618
1619 \begin_inset Quotes eld
1620 \end_inset
1621
1622
1623 \change_unchanged
1624
1625 \family sans
1626 Delete
1627 \change_deleted -1463541724 1692842667
1628
1629 \family default
1630
1631 \begin_inset Quotes erd
1632 \end_inset
1633
1634
1635 \change_inserted -1463541724 1692964524
1636 ,
1637
1638 \change_unchanged
1639
1640 \change_deleted -1463541724 1692842668
1641
1642 \begin_inset Quotes eld
1643 \end_inset
1644
1645
1646 \change_unchanged
1647
1648 \family sans
1649 Home
1650 \change_deleted -1463541724 1692842670
1651
1652 \family default
1653
1654 \begin_inset Quotes erd
1655 \end_inset
1656
1657
1658 \change_inserted -1463541724 1692964525
1659 ,
1660
1661 \change_unchanged
1662
1663 \change_deleted -1463541724 1692842671
1664
1665 \begin_inset Quotes eld
1666 \end_inset
1667
1668
1669 \change_unchanged
1670
1671 \family sans
1672 End
1673 \change_deleted -1463541724 1692842672
1674
1675 \family default
1676
1677 \begin_inset Quotes erd
1678 \end_inset
1679
1680
1681 \change_inserted -1463541724 1692964527
1682 ,
1683
1684 \change_unchanged
1685
1686 \change_deleted -1463541724 1692842673
1687
1688 \begin_inset Quotes eld
1689 \end_inset
1690
1691
1692 \change_unchanged
1693
1694 \family sans
1695 PageUp
1696 \change_deleted -1463541724 1692842674
1697
1698 \family default
1699
1700 \begin_inset Quotes erd
1701 \end_inset
1702
1703
1704 \change_inserted -1463541724 1692964535
1705  and
1706 \change_unchanged
1707
1708 \change_deleted -1463541724 1692842675
1709
1710 \begin_inset Quotes eld
1711 \end_inset
1712
1713
1714 \change_unchanged
1715
1716 \family sans
1717 PageDown
1718 \change_deleted -1463541724 1692842677
1719
1720 \family default
1721
1722 \begin_inset Quotes erd
1723 \end_inset
1724
1725
1726 \change_unchanged
1727 :
1728  these are the 6
1729 \begin_inset space ~
1730 \end_inset
1731
1732 keys that appear above the cursor keys on many PC keyboards.
1733
1734 \change_deleted -1463541724 1692842683
1735
1736 \begin_inset Quotes eld
1737 \end_inset
1738
1739
1740 \change_unchanged
1741
1742 \family sans
1743 PageUp
1744 \change_deleted -1463541724 1692842681
1745
1746 \family default
1747
1748 \begin_inset Quotes erd
1749 \end_inset
1750
1751
1752 \change_unchanged
1753  and
1754 \change_deleted -1463541724 1692842756
1755
1756 \begin_inset Quotes eld
1757 \end_inset
1758
1759
1760 \change_unchanged
1761
1762 \family sans
1763 PageDown
1764 \change_deleted -1463541724 1692842758
1765
1766 \family default
1767
1768 \begin_inset Quotes erd
1769 \end_inset
1770
1771
1772 \change_unchanged
1773  are called
1774 \change_deleted -1463541724 1692842752
1775
1776 \begin_inset Quotes eld
1777 \end_inset
1778
1779
1780 \change_unchanged
1781
1782 \family sans
1783 Prior
1784 \change_deleted -1463541724 1692842750
1785
1786 \family default
1787
1788 \begin_inset Quotes erd
1789 \end_inset
1790
1791
1792 \change_unchanged
1793  and
1794 \change_deleted -1463541724 1692842754
1795
1796 \begin_inset Quotes eld
1797 \end_inset
1798
1799
1800 \change_unchanged
1801
1802 \family sans
1803 Next
1804 \change_deleted -1463541724 1692842755
1805
1806 \family default
1807
1808 \begin_inset Quotes erd
1809 \end_inset
1810
1811
1812 \change_unchanged
1813  on some keyboards.
1814 \end_layout
1815
1816 \begin_layout Itemize
1817
1818 \family sans
1819 Return
1820 \family default
1821  and
1822 \family sans
1823 Enter
1824 \family default
1825  both refer to the same key.
1826  Some keyboards label the
1827 \family sans
1828 Return
1829 \family default
1830  key as
1831 \begin_inset Quotes eld
1832 \end_inset
1833
1834 Return
1835 \change_deleted -1463541724 1692842976
1836 ,
1837 \change_unchanged
1838
1839 \begin_inset Quotes erd
1840 \end_inset
1841
1842
1843 \change_inserted -1463541724 1692842978
1844 ,
1845
1846 \change_unchanged
1847  others as
1848 \begin_inset Quotes eld
1849 \end_inset
1850
1851 Enter
1852 \change_deleted -1463541724 1692842982
1853 ,
1854 \change_unchanged
1855
1856 \begin_inset Quotes erd
1857 \end_inset
1858
1859
1860 \change_inserted -1463541724 1692842991
1861 ,
1862 \change_deleted 5863208 1692989468
1863
1864 \begin_inset Note Note
1865 status collapsed
1866
1867 \begin_layout Plain Layout
1868
1869 \change_inserted -1463541724 1692966623
1870 Not direct speech,
1871  so punctuation goes out of the quoted text.
1872  See
1873 \begin_inset CommandInset href
1874 LatexCommand href
1875 name "Cambridge grammar (punctuation)"
1876 target "https://dictionary.cambridge.org/grammar/british-grammar/punctuation"
1877 literal "false"
1878
1879 \end_inset
1880
1881  or Collins grammar,
1882  to name a couple.
1883 \change_unchanged
1884
1885 \end_layout
1886
1887 \end_inset
1888
1889
1890 \change_unchanged
1891  still others have two keys.
1892  \SpecialChar LyX
1893  treats all of them as the same key,
1894  so we'll use
1895 \family sans
1896 Return
1897 \family default
1898  and
1899 \family sans
1900 Enter
1901 \family default
1902  interchangeably.
1903 \end_layout
1904
1905 \begin_layout Standard
1906 The list with the currently set shortcuts can be found in the
1907 \family sans
1908 Help
1909 \family default
1910  menu under
1911 \family sans
1912 Shortcuts
1913 \family default
1914 .
1915 \end_layout
1916
1917 \begin_layout Subsection
1918 Units used in the Manuals
1919 \end_layout
1920
1921 \begin_layout Standard
1922 To understand the units described in this documentation,
1923  Table
1924 \begin_inset space ~
1925 \end_inset
1926
1927
1928 \begin_inset CommandInset ref
1929 LatexCommand ref
1930 reference "tab:Units"
1931 nolink "false"
1932
1933 \end_inset
1934
1935  explains all units available in \SpecialChar LyX
1936 .
1937 \end_layout
1938
1939 \begin_layout Standard
1940 \begin_inset Float table
1941 placement document
1942 alignment document
1943 wide false
1944 sideways false
1945 status open
1946
1947 \begin_layout Plain Layout
1948 \begin_inset Caption Standard
1949
1950 \begin_layout Plain Layout
1951 \begin_inset CommandInset label
1952 LatexCommand label
1953 name "tab:Units"
1954
1955 \end_inset
1956
1957 Units
1958 \end_layout
1959
1960 \end_inset
1961
1962
1963 \end_layout
1964
1965 \begin_layout Plain Layout
1966 \begin_inset VSpace medskip
1967 \end_inset
1968
1969
1970 \end_layout
1971
1972 \begin_layout Plain Layout
1973 \align center
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">
1979 <row>
1980 <cell alignment="center" valignment="top" topline="true" bottomline="true" usebox="none">
1981 \begin_inset Text
1982
1983 \begin_layout Plain Layout
1984 unit
1985 \end_layout
1986
1987 \end_inset
1988 </cell>
1989 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
1990 \begin_inset Text
1991
1992 \begin_layout Plain Layout
1993 name/description
1994 \end_layout
1995
1996 \end_inset
1997 </cell>
1998 </row>
1999 <row>
2000 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2001 \begin_inset Text
2002
2003 \begin_layout Plain Layout
2004 mm
2005 \end_layout
2006
2007 \end_inset
2008 </cell>
2009 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2010 \begin_inset Text
2011
2012 \begin_layout Plain Layout
2013 millimeter
2014 \end_layout
2015
2016 \end_inset
2017 </cell>
2018 </row>
2019 <row>
2020 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2021 \begin_inset Text
2022
2023 \begin_layout Plain Layout
2024 cm
2025 \end_layout
2026
2027 \end_inset
2028 </cell>
2029 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2030 \begin_inset Text
2031
2032 \begin_layout Plain Layout
2033 centimeter
2034 \end_layout
2035
2036 \end_inset
2037 </cell>
2038 </row>
2039 <row>
2040 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2041 \begin_inset Text
2042
2043 \begin_layout Plain Layout
2044 in
2045 \end_layout
2046
2047 \end_inset
2048 </cell>
2049 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2050 \begin_inset Text
2051
2052 \begin_layout Plain Layout
2053 inch (1
2054 \begin_inset space \thinspace{}
2055 \end_inset
2056
2057 in = 2.54
2058 \begin_inset space \thinspace{}
2059 \end_inset
2060
2061 cm)
2062 \end_layout
2063
2064 \end_inset
2065 </cell>
2066 </row>
2067 <row>
2068 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2069 \begin_inset Text
2070
2071 \begin_layout Plain Layout
2072 pt
2073 \end_layout
2074
2075 \end_inset
2076 </cell>
2077 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2078 \begin_inset Text
2079
2080 \begin_layout Plain Layout
2081 point (72.27
2082 \begin_inset space \thinspace{}
2083 \end_inset
2084
2085 pt = 1
2086 \begin_inset space \thinspace{}
2087 \end_inset
2088
2089 in)
2090 \end_layout
2091
2092 \end_inset
2093 </cell>
2094 </row>
2095 <row>
2096 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2097 \begin_inset Text
2098
2099 \begin_layout Plain Layout
2100 pc
2101 \end_layout
2102
2103 \end_inset
2104 </cell>
2105 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2106 \begin_inset Text
2107
2108 \begin_layout Plain Layout
2109 pica (1
2110 \begin_inset space \thinspace{}
2111 \end_inset
2112
2113 pc = 12
2114 \begin_inset space \thinspace{}
2115 \end_inset
2116
2117 pt)
2118 \end_layout
2119
2120 \end_inset
2121 </cell>
2122 </row>
2123 <row>
2124 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2125 \begin_inset Text
2126
2127 \begin_layout Plain Layout
2128 sp
2129 \end_layout
2130
2131 \end_inset
2132 </cell>
2133 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2134 \begin_inset Text
2135
2136 \begin_layout Plain Layout
2137 scaled point (65536
2138 \begin_inset space \thinspace{}
2139 \end_inset
2140
2141 sp = 1
2142 \begin_inset space \thinspace{}
2143 \end_inset
2144
2145 pt)
2146 \end_layout
2147
2148 \end_inset
2149 </cell>
2150 </row>
2151 <row>
2152 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2153 \begin_inset Text
2154
2155 \begin_layout Plain Layout
2156 bp
2157 \end_layout
2158
2159 \end_inset
2160 </cell>
2161 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2162 \begin_inset Text
2163
2164 \begin_layout Plain Layout
2165 big point (72
2166 \begin_inset space \thinspace{}
2167 \end_inset
2168
2169 bp = 1
2170 \begin_inset space \thinspace{}
2171 \end_inset
2172
2173 in)
2174 \end_layout
2175
2176 \end_inset
2177 </cell>
2178 </row>
2179 <row>
2180 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2181 \begin_inset Text
2182
2183 \begin_layout Plain Layout
2184 dd
2185 \end_layout
2186
2187 \end_inset
2188 </cell>
2189 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2190 \begin_inset Text
2191
2192 \begin_layout Plain Layout
2193 didot (72
2194 \begin_inset space \thinspace{}
2195 \end_inset
2196
2197 dd
2198 \begin_inset Formula $\approx$
2199 \end_inset
2200
2201  37.6
2202 \begin_inset space \thinspace{}
2203 \end_inset
2204
2205 mm)
2206 \end_layout
2207
2208 \end_inset
2209 </cell>
2210 </row>
2211 <row>
2212 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2213 \begin_inset Text
2214
2215 \begin_layout Plain Layout
2216 cc
2217 \end_layout
2218
2219 \end_inset
2220 </cell>
2221 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2222 \begin_inset Text
2223
2224 \begin_layout Plain Layout
2225 cicero (1
2226 \begin_inset space \thinspace{}
2227 \end_inset
2228
2229 cc = 12
2230 \begin_inset space \thinspace{}
2231 \end_inset
2232
2233 dd)
2234 \end_layout
2235
2236 \end_inset
2237 </cell>
2238 </row>
2239 <row>
2240 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2241 \begin_inset Text
2242
2243 \begin_layout Plain Layout
2244 Scale%
2245 \end_layout
2246
2247 \end_inset
2248 </cell>
2249 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2250 \begin_inset Text
2251
2252 \begin_layout Plain Layout
2253 % of original image width
2254 \end_layout
2255
2256 \end_inset
2257 </cell>
2258 </row>
2259 <row>
2260 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2261 \begin_inset Text
2262
2263 \begin_layout Plain Layout
2264 text%
2265 \end_layout
2266
2267 \end_inset
2268 </cell>
2269 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2270 \begin_inset Text
2271
2272 \begin_layout Plain Layout
2273 % of text width
2274 \end_layout
2275
2276 \end_inset
2277 </cell>
2278 </row>
2279 <row>
2280 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2281 \begin_inset Text
2282
2283 \begin_layout Plain Layout
2284 col%
2285 \end_layout
2286
2287 \end_inset
2288 </cell>
2289 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2290 \begin_inset Text
2291
2292 \begin_layout Plain Layout
2293 % of column width
2294 \end_layout
2295
2296 \end_inset
2297 </cell>
2298 </row>
2299 <row>
2300 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2301 \begin_inset Text
2302
2303 \begin_layout Plain Layout
2304 page%
2305 \end_layout
2306
2307 \end_inset
2308 </cell>
2309 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2310 \begin_inset Text
2311
2312 \begin_layout Plain Layout
2313 % of paper width
2314 \end_layout
2315
2316 \end_inset
2317 </cell>
2318 </row>
2319 <row>
2320 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2321 \begin_inset Text
2322
2323 \begin_layout Plain Layout
2324 line%
2325 \end_layout
2326
2327 \end_inset
2328 </cell>
2329 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2330 \begin_inset Text
2331
2332 \begin_layout Plain Layout
2333 % of line width
2334 \end_layout
2335
2336 \end_inset
2337 </cell>
2338 </row>
2339 <row>
2340 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2341 \begin_inset Text
2342
2343 \begin_layout Plain Layout
2344 theight%
2345 \end_layout
2346
2347 \end_inset
2348 </cell>
2349 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2350 \begin_inset Text
2351
2352 \begin_layout Plain Layout
2353 % of text height
2354 \end_layout
2355
2356 \end_inset
2357 </cell>
2358 </row>
2359 <row>
2360 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2361 \begin_inset Text
2362
2363 \begin_layout Plain Layout
2364 pheight%
2365 \end_layout
2366
2367 \end_inset
2368 </cell>
2369 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2370 \begin_inset Text
2371
2372 \begin_layout Plain Layout
2373 % of paper height
2374 \end_layout
2375
2376 \end_inset
2377 </cell>
2378 </row>
2379 <row>
2380 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2381 \begin_inset Text
2382
2383 \begin_layout Plain Layout
2384 ex
2385 \end_layout
2386
2387 \end_inset
2388 </cell>
2389 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2390 \begin_inset Text
2391
2392 \begin_layout Plain Layout
2393 height of letter
2394 \emph on
2395 x
2396 \emph default
2397  in current font
2398 \end_layout
2399
2400 \end_inset
2401 </cell>
2402 </row>
2403 <row>
2404 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2405 \begin_inset Text
2406
2407 \begin_layout Plain Layout
2408 em
2409 \end_layout
2410
2411 \end_inset
2412 </cell>
2413 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2414 \begin_inset Text
2415
2416 \begin_layout Plain Layout
2417 width of letter
2418 \emph on
2419 M
2420 \emph default
2421  in current font
2422 \end_layout
2423
2424 \end_inset
2425 </cell>
2426 </row>
2427 <row>
2428 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
2429 \begin_inset Text
2430
2431 \begin_layout Plain Layout
2432 mu
2433 \end_layout
2434
2435 \end_inset
2436 </cell>
2437 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
2438 \begin_inset Text
2439
2440 \begin_layout Plain Layout
2441 math unit (1
2442 \begin_inset space \thinspace{}
2443 \end_inset
2444
2445 mu = 1/18
2446 \begin_inset space \thinspace{}
2447 \end_inset
2448
2449 em)
2450 \end_layout
2451
2452 \end_inset
2453 </cell>
2454 </row>
2455 </lyxtabular>
2456
2457 \end_inset
2458
2459
2460 \end_layout
2461
2462 \end_inset
2463
2464
2465 \end_layout
2466
2467 \begin_layout Subsection
2468 The Manuals
2469 \end_layout
2470
2471 \begin_layout Standard
2472 The following list describes the contents of the basic documentation files that you find in the
2473 \family sans
2474 Help
2475 \family default
2476  menu:
2477 \end_layout
2478
2479 \begin_layout Description
2480 Introduction This file.
2481 \end_layout
2482
2483 \begin_layout Description
2484 Tutorial If you are new to \SpecialChar LyX
2485 ,
2486  and have never used \SpecialChar LaTeX
2487  before,
2488  you should start here.
2489  If you have used \SpecialChar LaTeX
2490  before,
2491  you should still read the
2492 \emph on
2493 Tutorial
2494 \emph default
2495 ,
2496  starting with the section on
2497 \change_deleted -1463541724 1692917771
2498
2499 \begin_inset Quotes eld
2500 \end_inset
2501
2502
2503 \change_unchanged
2504
2505 \emph on
2506 \SpecialChar LyX
2507  for \SpecialChar LaTeX
2508  users
2509 \change_deleted -1463541724 1692917763
2510
2511 \emph default
2512 .
2513 \begin_inset Quotes erd
2514 \end_inset
2515
2516
2517 \change_inserted -1463541724 1692917775
2518 .
2519 \change_deleted 5863208 1692989483
2520
2521 \begin_inset Note Note
2522 status collapsed
2523
2524 \begin_layout Plain Layout
2525
2526 \change_inserted -1463541724 1692918131
2527 Again,
2528  don't see the point in quoting text already using a different font face.
2529  Additionally,
2530  was not complying to the use of font faces in the manuals stated in section 2.2.
2531 \change_unchanged
2532
2533 \end_layout
2534
2535 \end_inset
2536
2537
2538 \change_unchanged
2539  (Skimming through the rest of the document wouldn't hurt,
2540  either.)
2541 \end_layout
2542
2543 \begin_layout Description
2544 User's
2545 \begin_inset space ~
2546 \end_inset
2547
2548 Guide The primary documentation.
2549  We'll cover
2550 \emph on
2551 most
2552 \emph default
2553  of the basic operation and available features of \SpecialChar LyX
2554  here.
2555  The main manual assumes that you have read the
2556 \emph on
2557 Tutorial
2558 \emph default
2559 .
2560 \end_layout
2561
2562 \begin_layout Description
2563 Embedded
2564 \begin_inset space ~
2565 \end_inset
2566
2567 Objects Extension of the
2568 \emph on
2569 User's Guide
2570 \emph default
2571 .
2572  Documents in detail how to use tables,
2573  graphics,
2574  floats,
2575  notes,
2576  program listings and boxes.
2577  It also includes many tricks of the \SpecialChar LaTeX
2578  masters.
2579 \end_layout
2580
2581 \begin_layout Description
2582 Math Extension of the
2583 \emph on
2584 User's Guide
2585 \emph default
2586 .
2587  Documents in detail how to typeset any kind of formula.
2588 \end_layout
2589
2590 \begin_layout Description
2591 Additional
2592 \begin_inset space ~
2593 \end_inset
2594
2595 Features Extension of the
2596 \emph on
2597 User's Guide
2598 \emph default
2599 .
2600  Documents how to use raw \SpecialChar LaTeX
2601  commands,
2602  additional layouts and special-purpose editing features.
2603 \end_layout
2604
2605 \begin_layout Description
2606 Customization A description of advanced \SpecialChar LyX
2607  features,
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.
2616 \end_layout
2617
2618 \begin_layout Description
2619 Shortcuts Tables of the currently defined \SpecialChar LyX
2620  shortcuts.
2621 \end_layout
2622
2623 \begin_layout Description
2624 \SpecialChar LaTeX
2625
2626 \begin_inset space ~
2627 \end_inset
2628
2629 Configuration A report produced by \SpecialChar LyX
2630  about your system.
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.
2634 \end_layout
2635
2636 \begin_layout Standard
2637 These files will reference one another as necessary.
2638  For example,
2639  the
2640 \emph on
2641 User's Guide
2642 \emph default
2643  contains
2644 \emph on
2645 some
2646 \emph default
2647  information on installation and customization,
2648  but refers the reader to the
2649 \emph on
2650 Customization
2651 \emph default
2652
2653 \change_deleted -1463541724 1692964787
2654 M
2655 \change_inserted -1463541724 1692964788
2656 m
2657 \change_unchanged
2658 anual for more information.
2659 \end_layout
2660
2661 \begin_layout Standard
2662 We'll state again an important point:
2663 \end_layout
2664
2665 \begin_layout Standard
2666 \begin_inset VSpace bigskip
2667 \end_inset
2668
2669
2670 \end_layout
2671
2672 \begin_layout Standard
2673 \align center
2674 If you are new to \SpecialChar LyX
2675 ,
2676  read the
2677 \emph on
2678 Tutorial
2679 \emph default
2680 .
2681  Now\SpecialChar endofsentence
2682
2683 \end_layout
2684
2685 \begin_layout Standard
2686 \begin_inset VSpace bigskip
2687 \end_inset
2688
2689
2690 \end_layout
2691
2692 \begin_layout Standard
2693 Otherwise,
2694  you could needlessly frustrate yourself.
2695 \end_layout
2696
2697 \begin_layout Section
2698 Contributing to the \SpecialChar LyX
2699  Project
2700 \begin_inset CommandInset label
2701 LatexCommand label
2702 name "sec:Contrib"
2703
2704 \end_inset
2705
2706
2707 \end_layout
2708
2709 \begin_layout Subsection
2710 Contributing to \SpecialChar LyX
2711
2712 \end_layout
2713
2714 \begin_layout Standard
2715 \SpecialChar LyX
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.
2721 \end_layout
2722
2723 \begin_layout Subsubsection
2724 Reporting a bug
2725 \end_layout
2726
2727 \begin_layout Standard
2728 While using \SpecialChar LyX
2729 ,
2730  you may find behavior which you consider a bug.
2731  Crashes,
2732  though rare,
2733  can happen.
2734  User interface problems are considered major bugs by the \SpecialChar LyX
2735  team:
2736  especially helpful are indications of parts of the \SpecialChar LyX
2737  interface you find confusing,
2738  or unclear.
2739 \end_layout
2740
2741 \begin_layout Standard
2742 \SpecialChar LyX
2743  has a bug tracking system,
2744  which you can find at
2745 \begin_inset Newline newline
2746 \end_inset
2747
2748
2749 \begin_inset CommandInset href
2750 LatexCommand href
2751 target "https://www.lyx.org/trac/wiki/BugTrackerHome"
2752
2753 \end_inset
2754
2755 .
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,
2762
2763 \begin_inset CommandInset href
2764 LatexCommand href
2765 target "lyx-devel@lists.lyx.org"
2766 type "mailto:"
2767 literal "false"
2768
2769 \end_inset
2770
2771 .
2772  Archives of this list are linked from the main \SpecialChar LyX
2773  website,
2774
2775 \change_deleted 5863208 1692989524
2776
2777 \begin_inset CommandInset href
2778 LatexCommand href
2779 target "http://www.lyx.org"
2780
2781 \end_inset
2782
2783
2784 \change_inserted 5863208 1692989534
2785
2786 \begin_inset CommandInset href
2787 LatexCommand href
2788 target "https://www.lyx.org/MailingLists"
2789 literal "false"
2790
2791 \end_inset
2792
2793
2794 \change_deleted 5863208 1692989524
2795
2796 \begin_inset Note Note
2797 status open
2798
2799 \begin_layout Plain Layout
2800
2801 \change_inserted -1463541724 1692966662
2802 Substitute this link for the more specific
2803 \begin_inset CommandInset href
2804 LatexCommand href
2805 target "https://www.lyx.org/MailingLists#toc3"
2806
2807 \end_inset
2808
2809  or maybe just
2810 \change_deleted 5863208 1692989514
2811
2812 \begin_inset CommandInset href
2813 LatexCommand href
2814 target "https://www.lyx.org/MailingLists"
2815 literal "false"
2816
2817 \end_inset
2818
2819
2820 \change_inserted -1463541724 1692966662
2821 ?
2822 \change_unchanged
2823
2824 \end_layout
2825
2826 \end_inset
2827
2828
2829 \change_unchanged
2830 .
2831 \end_layout
2832
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.
2836  Accurate,
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
2841 .
2842  Give the versions of the libraries you have installed on your system,
2843  and,
2844  if relevant,
2845  the versions of external programs that \SpecialChar LyX
2846  uses.
2847  If it's a compilation or configuration problem,
2848  include the file
2849 \family typewriter
2850 config.log
2851 \family default
2852 ,
2853  and mention which compiler you are using.
2854
2855 \change_inserted 5863208 1692989585
2856
2857 \begin_inset Quotes eld
2858 \end_inset
2859
2860 Part of this information can be found in
2861 \family sans
2862 Help\SpecialChar menuseparator
2863 About
2864 \family default
2865 .
2866 \begin_inset Quotes erd
2867 \end_inset
2868
2869
2870 \change_deleted 5863208 1692989598
2871
2872 \begin_inset Note Note
2873 status collapsed
2874
2875 \begin_layout Plain Layout
2876
2877 \change_inserted -1463541724 1692957260
2878 Shall we mention this information can be found in
2879 \family sans
2880 Help\SpecialChar menuseparator
2881 About
2882 \family default
2883 ?
2884  For instance:
2885 \end_layout
2886
2887 \begin_layout Plain Layout
2888
2889 \change_inserted -1463541724 1692966675
2890 \begin_inset Quotes eld
2891 \end_inset
2892
2893 Most of this information can be found in
2894 \family sans
2895 Help\SpecialChar menuseparator
2896 About
2897 \family default
2898 .
2899 \begin_inset Quotes erd
2900 \end_inset
2901
2902  or
2903 \end_layout
2904
2905 \begin_layout Plain Layout
2906
2907 \change_inserted -1463541724 1692966688
2908 \begin_inset Quotes eld
2909 \end_inset
2910
2911 Part of this information can be found in
2912 \family sans
2913 Help\SpecialChar menuseparator
2914 About
2915 \family default
2916 .
2917 \begin_inset Quotes erd
2918 \end_inset
2919
2920
2921 \change_unchanged
2922
2923 \end_layout
2924
2925 \end_inset
2926
2927
2928 \change_unchanged
2929
2930 \end_layout
2931
2932 \begin_layout Subsubsection
2933 Contributing fixes and new features
2934 \end_layout
2935
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
2939 ,
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.
2943 \end_layout
2944
2945 \begin_layout Subsection
2946 Contributing to the Documentation
2947 \end_layout
2948
2949 \begin_layout Standard
2950 \SpecialChar LyX
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.
2958 \end_layout
2959
2960 \begin_layout Subsubsection
2961 Reporting Errors in the Manuals
2962 \end_layout
2963
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
2968 LatexCommand href
2969 target "lyx-docs@lists.lyx.org"
2970 type "mailto:"
2971 literal "false"
2972
2973 \end_inset
2974
2975 .
2976  The documentation team will make any necessary fixes.
2977 \end_layout
2978
2979 \begin_layout Subsubsection
2980 Joining the Documentation Team.
2981 \end_layout
2982
2983 \begin_layout Standard
2984 The \SpecialChar LyX
2985  Documentation Project,
2986  like anything else in the \SpecialChar LyX
2987  project,
2988  can always use assistance!
2989  If you're interested in contributing to the Documentation Project,
2990  you need to do the following:
2991 \end_layout
2992
2993 \begin_layout Enumerate
2994 Get the latest \SpecialChar LyX
2995  source code from
2996 \begin_inset Newline newline
2997 \end_inset
2998
2999
3000 \begin_inset CommandInset href
3001 LatexCommand href
3002 target "https://www.lyx.org/trac/browser/lyxgit/lib/doc?rev=master "
3003
3004 \end_inset
3005
3006
3007 \end_layout
3008
3009 \begin_layout Enumerate
3010 Next,
3011  read the
3012 \emph on
3013 User's Guide
3014 \emph default
3015  and the
3016 \emph on
3017 Tutorial
3018 \change_inserted -1463541724 1692966436
3019
3020 \emph default
3021 \SpecialChar endofsentence
3022
3023 \change_unchanged
3024
3025 \begin_inset Newline newline
3026 \end_inset
3027
3028 The point of this exercise is to give you ideas.
3029  The
3030 \emph on
3031 Tutorial
3032 \emph default
3033  and
3034 \emph on
3035 User's Guide
3036 \emph default
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.
3039 \end_layout
3040
3041 \begin_layout Enumerate
3042 Contact the team at:
3043 \begin_inset Newline newline
3044 \end_inset
3045
3046
3047 \begin_inset CommandInset href
3048 LatexCommand href
3049 target "lyx-docs@lists.lyx.org"
3050 type "mailto:"
3051 literal "false"
3052
3053 \end_inset
3054
3055
3056 \begin_inset Newline newline
3057 \end_inset
3058
3059 to discuss your intended changes and to get some feedback on them.
3060 \end_layout
3061
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.
3066 \end_layout
3067
3068 \end_body
3069 \end_document