[LyX/master] * Intro.lyx from Dan.
Pavel Sanda
sanda at lyx.org
Fri Aug 25 17:39:25 UTC 2023
commit 877582721d47bdb7969145c456aeee4a79ad7efe
Author: Pavel Sanda <sanda at lyx.org>
Date: Fri Aug 25 20:55:21 2023 +0200
* Intro.lyx from Dan.
---
lib/doc/Intro.lyx | 598 ++++++++++++++++++++++++++++++++++++++++++++++++++--
1 files changed, 575 insertions(+), 23 deletions(-)
diff --git a/lib/doc/Intro.lyx b/lib/doc/Intro.lyx
index dcbb737..e5b2141 100644
--- a/lib/doc/Intro.lyx
+++ b/lib/doc/Intro.lyx
@@ -1,5 +1,5 @@
#LyX 2.4 created this file. For more info see https://www.lyx.org/
-\lyxformat 614
+\lyxformat 618
\begin_document
\begin_header
\save_transient_properties true
@@ -88,6 +88,7 @@
\suppress_date false
\justification true
\use_refstyle 0
+\use_formatted_ref 0
\use_minted 0
\use_lineno 0
\index Index
@@ -115,7 +116,9 @@
\html_be_strict false
\docbook_table_output 0
\docbook_mathml_prefix 1
+\author -1463541724 "Daniel" d3vf4n at tutanota.com
\author -584632292 "Richard Kimberly Heck"
+\author 5863208 "ab"
\end_header
\begin_body
@@ -203,7 +206,11 @@ What is \SpecialChar LyX
articles in refereed scientific journals,
scripts for plays and movies,
business proposals,
- presentations \SpecialChar ldots
+ presentations
+\change_deleted -1463541724 1692922495
+
+\change_unchanged
+\SpecialChar ldots
\end_layout
@@ -322,11 +329,20 @@ Suppose you are writing a report.
\begin_inset Quotes eld
\end_inset
-Introduction\SpecialChar endofsentence
+Introduction
+\change_deleted -1463541724 1692922782
+\SpecialChar endofsentence
+
+\change_unchanged
\begin_inset Quotes erd
\end_inset
+
+\change_inserted -1463541724 1692922792
+\SpecialChar endofsentence
+
+\change_unchanged
So,
you go into whatever menu it is in your word processor that changes font sizes and decide on a new font size.
Then you turn on bold face.
@@ -455,10 +471,19 @@ how
\begin_inset Quotes eld
\end_inset
-What You See Is What You Get,
+What You See Is What You Get
+\change_deleted -1463541724 1692922450
+,
+\change_unchanged
+
\begin_inset Quotes erd
\end_inset
+
+\change_inserted -1463541724 1692923936
+,
+
+\change_unchanged
the \SpecialChar LyX
model is
\begin_inset Quotes eld
@@ -473,13 +498,24 @@ Mean
\end_inset
or
+\change_deleted -1463541724 1692923839
+
\begin_inset Quotes eld
\end_inset
-WYSIWYM.
+
+\change_unchanged
+WYSIWYM
+\change_deleted -1463541724 1692923836
+.
\begin_inset Quotes erd
\end_inset
+
+\change_inserted -1463541724 1692923925
+.
+
+\change_unchanged
It's a powerful idea that greatly simplifies the mechanics of writing documents.
This is also why \SpecialChar LyX
isn't so good for creating posters and flyers.
@@ -690,7 +726,11 @@ What is \SpecialChar LaTeX
\begin_layout Standard
\SpecialChar LaTeX
- is a document preparation system designed by Leslie Lamport in 1985.
+ is a document preparation system designed by
+\noun on
+Leslie Lamport
+\noun default
+ in 1985.
\begin_inset Foot
status collapsed
@@ -714,7 +754,11 @@ User's Guide
It was built up from a typesetting language called \SpecialChar TeX
,
- created by Donald Knuth in 1984.
+ created by
+\shape smallcaps
+Donald Knuth
+\shape default
+ in 1984.
\SpecialChar TeX
takes a sequence of typesetting commands,
written in a script in an ASCII file,
@@ -727,11 +771,31 @@ tricks
\begin_inset Quotes erd
\end_inset
- of the printing trade were modeled by Knuth as computer algorithms and incorporated into \SpecialChar TeX
+ of the printing trade were modeled by
+\shape smallcaps
+Knuth
+\shape default
+ as computer algorithms and incorporated into \SpecialChar TeX
,
hence its excellent printed appearance.
What comes directly out of \SpecialChar TeX
- is the portable document format
+ is the
+\change_inserted -1463541724 1692922633
+
+\begin_inset Quotes eld
+\end_inset
+
+
+\change_unchanged
+portable document format
+\change_inserted -1463541724 1692922640
+
+\begin_inset Quotes erd
+\end_inset
+
+
+\change_unchanged
+
\emph on
pdf
\emph default
@@ -748,7 +812,11 @@ device independent
dvi
\emph default
.
- The dvi format is often used for previews and can later be converted to other formats like PostScript.
+ The
+\family typewriter
+dvi
+\family default
+ format is often used for previews and can later be converted to other formats like PostScript.
\end_layout
@@ -757,8 +825,16 @@ dvi
isn't only a typesetting engine;
it also allows you to define macros.
Most people who use \SpecialChar TeX
- are actually using a macro package which Knuth created to hide a lot of the typesetting details.
- This is where Leslie Lamport enters our story.
+ are actually using a macro package which
+\noun on
+Knuth
+\noun default
+ created to hide a lot of the typesetting details.
+ This is where
+\noun on
+Leslie Lamport
+\noun default
+ enters our story.
He wanted a macro package that was more user- and less typesetter-oriented,
with a set of commands that consistently typeset things like sections,
tables or math formulas in a uniform,
@@ -932,7 +1008,19 @@ Hopefully,
\begin_inset Quotes eld
\end_inset
-Real Jobs
+
+\change_inserted -1463541724 1692917953
+r
+\change_deleted -1463541724 1692917953
+R
+\change_unchanged
+eal
+\change_inserted -1463541724 1692963264
+j
+\change_deleted -1463541724 1692963263
+J
+\change_unchanged
+obs
\begin_inset Quotes erd
\end_inset
@@ -967,7 +1055,11 @@ Also,
is unclear,
or wrong,
don't hesitate to let us know!
- You can reach the current document maintainers by emailing
+ You can reach the current document
+\change_inserted -1463541724 1692963407
+ation
+\change_unchanged
+ maintainers by emailing
\begin_inset CommandInset href
LatexCommand href
target "lyx-docs at lists.lyx.org"
@@ -977,6 +1069,8 @@ literal "false"
\end_inset
.
+
+\change_deleted -1463541724 1692922571
\change_inserted -584632292 1610248366
@@ -1046,7 +1140,7 @@ Some of you may have printed out the manuals.
which looks like this:
\begin_inset Graphics
- filename clipart/footnote.png
+ filename /home/paf/lyx/devel/lib/doc/clipart/footnote.png
scale 95
\end_inset
@@ -1075,7 +1169,7 @@ In the printed manuals,
all cross-references appear as light-grey boxes like the following:
\begin_inset Graphics
- filename clipart/reference.png
+ filename /home/paf/lyx/devel/lib/doc/clipart/reference.png
scale 95
\end_inset
@@ -1122,7 +1216,11 @@ Emphasized Style
\emph default
is used for general emphasis,
generic arguments,
- book titles,
+ book
+\change_inserted -1463541724 1692964248
+ and manual
+\change_unchanged
+ titles,
names of sections of other manuals,
and notes from the authors.
\end_layout
@@ -1143,7 +1241,11 @@ Typewriter
Sans Serif
\family default
is used for menu,
- button,
+ button
+\change_deleted -1463541724 1692964370
+,
+
+\change_unchanged
or dialog box names,
and the names of keyboard keys.
\end_layout
@@ -1154,6 +1256,38 @@ Sans Serif
Noun Style
\noun default
is used for people's names.
+\change_deleted 5863208 1692989367
+
+\begin_inset Note Note
+status open
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692964472
+This document has some person names (Leslie Lamport,
+ Donald Knuth) and none of them is typ
+\change_inserted 5863208 1692989355
+e
+\change_inserted -1463541724 1692964472
+set with this font face.
+ Shall we change them?
+\change_inserted 5863208 1692989346
+
+\end_layout
+
+\begin_layout Plain Layout
+
+\change_inserted 5863208 1692989349
+Done.
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
+
\end_layout
\begin_layout Itemize
@@ -1163,25 +1297,55 @@ Bold
\series default
is used for \SpecialChar LaTeX
code
+\change_inserted -1463541724 1692842469
+.
+\change_unchanged
+
\end_layout
\begin_layout Standard
When we do need to reference keys,
we'll use the following prefixing convention:
+\change_deleted 5863208 1692989463
+
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692842873
+Do not think quotation marks are necessary when already using a different font face to differentiate the text.
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
+
\end_layout
\begin_layout Itemize
+
+\change_deleted -1463541724 1692842633
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
Ctrl+
+\change_deleted -1463541724 1692842626
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_unchanged
indicates the
\family sans
Control
@@ -1190,17 +1354,25 @@ Control
\end_layout
\begin_layout Itemize
+
+\change_deleted -1463541724 1692842634
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
Shift+
+\change_deleted -1463541724 1692842636
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_unchanged
indicates the
\family sans
Shift
@@ -1209,17 +1381,25 @@ Shift
\end_layout
\begin_layout Itemize
+
+\change_deleted -1463541724 1692842640
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
Alt+
+\change_deleted -1463541724 1692842639
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_unchanged
indicates the
\family sans
Alt
@@ -1232,172 +1412,298 @@ Meta
\end_layout
\begin_layout Itemize
+
+\change_deleted -1463541724 1692842642
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
F1
+\change_deleted -1463541724 1692842642
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_unchanged
\SpecialChar ldots
+\change_deleted -1463541724 1692842644
+
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
F12
+\change_deleted -1463541724 1692842646
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_unchanged
are the function keys.
\end_layout
\begin_layout Itemize
+
+\change_deleted -1463541724 1692842662
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
Esc
+\change_deleted -1463541724 1692842663
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_unchanged
is the escape key.
\end_layout
\begin_layout Itemize
+
+\change_deleted -1463541724 1692842660
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
Left
+\change_deleted -1463541724 1692842658
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_inserted -1463541724 1692964502
+,
+
+\change_unchanged
+\change_deleted -1463541724 1692842658
+
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
Right
+\change_deleted -1463541724 1692842648
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_inserted -1463541724 1692964504
+,
+
+\change_unchanged
+\change_deleted -1463541724 1692842649
+
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
Up
+\change_deleted -1463541724 1692842651
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_inserted -1463541724 1692964516
+ and
+\change_unchanged
+\change_deleted -1463541724 1692842650
+
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
Down
+\change_deleted -1463541724 1692842655
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_unchanged
:
self-explanatory.
\end_layout
\begin_layout Itemize
+\change_deleted -1463541724 1692842666
+
\family sans
\begin_inset Quotes eld
\end_inset
+
+\change_unchanged
Insert
+\change_deleted -1463541724 1692842664
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_inserted -1463541724 1692964521
+,
+
+\change_unchanged
+\change_deleted -1463541724 1692842665
+
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
Delete
+\change_deleted -1463541724 1692842667
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_inserted -1463541724 1692964524
+,
+
+\change_unchanged
+\change_deleted -1463541724 1692842668
+
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
Home
+\change_deleted -1463541724 1692842670
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_inserted -1463541724 1692964525
+,
+
+\change_unchanged
+\change_deleted -1463541724 1692842671
+
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
End
+\change_deleted -1463541724 1692842672
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_inserted -1463541724 1692964527
+,
+
+\change_unchanged
+\change_deleted -1463541724 1692842673
+
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
PageUp
+\change_deleted -1463541724 1692842674
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_inserted -1463541724 1692964535
+ and
+\change_unchanged
+\change_deleted -1463541724 1692842675
+
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
PageDown
+\change_deleted -1463541724 1692842677
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_unchanged
:
these are the 6
\begin_inset space ~
@@ -1405,53 +1711,85 @@ PageDown
keys that appear above the cursor keys on many PC keyboards.
+\change_deleted -1463541724 1692842683
+
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
PageUp
+\change_deleted -1463541724 1692842681
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_unchanged
and
+\change_deleted -1463541724 1692842756
+
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
PageDown
+\change_deleted -1463541724 1692842758
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_unchanged
are called
+\change_deleted -1463541724 1692842752
+
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
Prior
+\change_deleted -1463541724 1692842750
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_unchanged
and
+\change_deleted -1463541724 1692842754
+
\begin_inset Quotes eld
\end_inset
+\change_unchanged
+
\family sans
Next
+\change_deleted -1463541724 1692842755
+
\family default
\begin_inset Quotes erd
\end_inset
+
+\change_unchanged
on some keyboards.
\end_layout
@@ -1473,18 +1811,63 @@ Return
\begin_inset Quotes eld
\end_inset
-Return,
+Return
+\change_deleted -1463541724 1692842976
+,
+\change_unchanged
+
\begin_inset Quotes erd
\end_inset
+
+\change_inserted -1463541724 1692842978
+,
+
+\change_unchanged
others as
\begin_inset Quotes eld
\end_inset
-Enter,
+Enter
+\change_deleted -1463541724 1692842982
+,
+\change_unchanged
+
\begin_inset Quotes erd
\end_inset
+
+\change_inserted -1463541724 1692842991
+,
+\change_deleted 5863208 1692989468
+
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692966623
+Not direct speech,
+ so punctuation goes out of the quoted text.
+ See
+\begin_inset CommandInset href
+LatexCommand href
+name "Cambridge grammar (punctuation)"
+target "https://dictionary.cambridge.org/grammar/british-grammar/punctuation"
+literal "false"
+
+\end_inset
+
+ or Collins grammar,
+ to name a couple.
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
still others have two keys.
\SpecialChar LyX
treats all of them as the same key,
@@ -2091,15 +2474,48 @@ Tutorial
\emph default
,
starting with the section on
+\change_deleted -1463541724 1692917771
+
\begin_inset Quotes eld
\end_inset
+
+\change_unchanged
+
+\emph on
\SpecialChar LyX
for \SpecialChar LaTeX
- users.
+ users
+\change_deleted -1463541724 1692917763
+
+\emph default
+.
\begin_inset Quotes erd
\end_inset
+
+\change_inserted -1463541724 1692917775
+.
+\change_deleted 5863208 1692989483
+
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692918131
+Again,
+ don't see the point in quoting text already using a different font face.
+ Additionally,
+ was not complying to the use of font faces in the manuals stated in section 2.2.
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
(Skimming through the rest of the document wouldn't hurt,
either.)
\end_layout
@@ -2211,9 +2627,15 @@ some
information on installation and customization,
but refers the reader to the
\emph on
-Customization Manual
+Customization
\emph default
- for more information.
+
+\change_deleted -1463541724 1692964787
+M
+\change_inserted -1463541724 1692964788
+m
+\change_unchanged
+anual for more information.
\end_layout
\begin_layout Standard
@@ -2330,12 +2752,61 @@ literal "false"
Archives of this list are linked from the main \SpecialChar LyX
website,
+\change_deleted 5863208 1692989524
+
\begin_inset CommandInset href
LatexCommand href
target "http://www.lyx.org"
\end_inset
+
+\change_inserted 5863208 1692989534
+
+\begin_inset CommandInset href
+LatexCommand href
+target "https://www.lyx.org/MailingLists"
+literal "false"
+
+\end_inset
+
+
+\change_deleted 5863208 1692989524
+
+\begin_inset Note Note
+status open
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692966662
+Substitute this link for the more specific
+\begin_inset CommandInset href
+LatexCommand href
+target "https://www.lyx.org/MailingLists#toc3"
+
+\end_inset
+
+ or maybe just
+\change_deleted 5863208 1692989514
+
+\begin_inset CommandInset href
+LatexCommand href
+target "https://www.lyx.org/MailingLists"
+literal "false"
+
+\end_inset
+
+
+\change_inserted -1463541724 1692966662
+?
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
.
\end_layout
@@ -2360,6 +2831,82 @@ config.log
\family default
,
and mention which compiler you are using.
+
+\change_inserted 5863208 1692989585
+
+\begin_inset Quotes eld
+\end_inset
+
+Part of this information can be found in
+\family sans
+Help\SpecialChar menuseparator
+About
+\family default
+.
+\begin_inset Quotes erd
+\end_inset
+
+
+\change_deleted 5863208 1692989598
+
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692957260
+Shall we mention this information can be found in
+\family sans
+Help\SpecialChar menuseparator
+About
+\family default
+?
+ For instance:
+\end_layout
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692966675
+\begin_inset Quotes eld
+\end_inset
+
+Most of this information can be found in
+\family sans
+Help\SpecialChar menuseparator
+About
+\family default
+.
+\begin_inset Quotes erd
+\end_inset
+
+ or
+\end_layout
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692966688
+\begin_inset Quotes eld
+\end_inset
+
+Part of this information can be found in
+\family sans
+Help\SpecialChar menuseparator
+About
+\family default
+.
+\begin_inset Quotes erd
+\end_inset
+
+
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
+
\end_layout
\begin_layout Subsubsection
@@ -2448,7 +2995,12 @@ User's Guide
and the
\emph on
Tutorial
+\change_inserted -1463541724 1692966436
+
\emph default
+\SpecialChar endofsentence
+
+\change_unchanged
\begin_inset Newline newline
\end_inset
More information about the lyx-cvs
mailing list