X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=lib%2Fdoc%2FIntro.lyx;h=a7244907092cb7a1c0c6def8a503e57a616657ad;hb=abcada9e13b72f57df00815d6a9f4a54a67009d3;hp=b17c45359b04df5f2f27435218d9857d27908f4b;hpb=f702ec6eda297b4491dd67ac5778a26e581b8645;p=lyx.git diff --git a/lib/doc/Intro.lyx b/lib/doc/Intro.lyx index b17c45359b..a724490709 100644 --- a/lib/doc/Intro.lyx +++ b/lib/doc/Intro.lyx @@ -1,5 +1,5 @@ -#LyX 1.5.3svn created this file. For more info see http://www.lyx.org/ -\lyxformat 276 +#LyX 1.6.0svn created this file. For more info see http://www.lyx.org/ +\lyxformat 338 \begin_document \begin_header \textclass article @@ -17,37 +17,19 @@ \ifpdf % if pdflatex is used % set fonts for nicer pdf view - \IfFileExists{lmodern.sty}{\usepackage{lmodern}} - {\usepackage[scaled=0.92]{helvet} - \usepackage{mathptmx} - \usepackage{courier} } - - % link all cross references and URLs in pdf output - \usepackage[colorlinks=true, bookmarks, bookmarksnumbered, - bookmarksopen, bookmarksopenlevel=2, - linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, - pdfpagelayout=OneColumn, pdfnewwindow=true, - pdfstartview=XYZ, plainpages=false, pdfpagelabels, - pdfauthor={LyX Team}, pdftex, - pdftitle={Introduction to LyX},pdfsubject={LyX-documentation Intro}, - pdfkeywords={LyX, documentation}]{hyperref} - -\else % if dvi or ps is produced - - % link all cross references and URLs in dvi output - \usepackage[ps2pdf]{hyperref} + \IfFileExists{lmodern.sty}{\usepackage{lmodern}}{} \fi % end if pdflatex is used - % the pages of the TOC are numbered roman - % and a pdf-bookmark for the TOC is added - \pagenumbering{roman} - \let\myTOC\tableofcontents - \renewcommand\tableofcontents{% - \pdfbookmark[1]{Contents}{} - \myTOC - \cleardoublepage - \pagenumbering{arabic} } +% the pages of the TOC is numbered roman +% and a pdf-bookmark for the TOC is added +\pagenumbering{roman} +\let\myTOC\tableofcontents +\renewcommand\tableofcontents{% + \pdfbookmark[1]{\contentsname}{} + \myTOC + \cleardoublepage + \pagenumbering{arabic} } % redefine the \LyX macro for PDF bookmarks \def\LyX{\texorpdfstring{% @@ -64,9 +46,26 @@ \font_osf false \font_sf_scale 100 \font_tt_scale 100 + \graphics default \paperfontsize 12 \spacing single +\use_hyperref true +\pdf_title "Introduction to LyX" +\pdf_author "LyX Team" +\pdf_subject "LyX-documentation Intro" +\pdf_keywords "LyX, documentation" +\pdf_bookmarks true +\pdf_bookmarksnumbered true +\pdf_bookmarksopen true +\pdf_bookmarksopenlevel 2 +\pdf_breaklinks false +\pdf_pdfborder false +\pdf_colorlinks true +\pdf_backref false +\pdf_pagebackref false +\pdf_pdfusetitle false +\pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false, pdfpagelabels" \papersize a4paper \use_geometry false \use_amsmath 1 @@ -99,12 +98,18 @@ by the LyX Team \begin_inset Foot status collapsed -\begin_layout Standard +\begin_layout Plain Layout \noindent If you have comments or error corrections, please send them to the LyX Documenta tion mailing list: -\family typewriter -lyx-docs@lists.lyx.org +\begin_inset CommandInset href +LatexCommand href +target "lyx-docs@lists.lyx.org" +type "mailto:" + +\end_inset + + \end_layout \end_inset @@ -113,7 +118,8 @@ lyx-docs@lists.lyx.org \end_layout \begin_layout Standard -\begin_inset LatexCommand tableofcontents +\begin_inset CommandInset toc +LatexCommand tableofcontents \end_inset @@ -229,7 +235,7 @@ style. \begin_inset Foot status collapsed -\begin_layout Standard +\begin_layout Plain Layout To be fair, most recent versions of the most popular office suites now have some sort of style sheets which follow a similar markup method. However, our experience is that they are still rarely used in practice. @@ -258,8 +264,14 @@ Introduction\SpecialChar \@. \begin_inset Quotes eld \end_inset -1.\InsetSpace ~ -\InsetSpace ~ +1. +\begin_inset space ~ +\end_inset + + +\begin_inset space ~ +\end_inset + Introduction \begin_inset Quotes erd \end_inset @@ -301,12 +313,20 @@ ence tags), LyX will automatically update them all throughout the file so \begin_layout Standard Now let's look at the problem of consistency. - Five days later, you reopen your report and start Section\InsetSpace ~ + Five days later, you reopen your report and start Section +\begin_inset space ~ +\end_inset + 4. However, you forget that you were using 18pt bold instead of 16pt, so you - type in the heading for Section\InsetSpace ~ -4 in a different font that what you used - for Section\InsetSpace ~ + type in the heading for Section +\begin_inset space ~ +\end_inset + +4 in a different font that what you used for Section +\begin_inset space ~ +\end_inset + 1. That problem doesn't even exist in LyX. The computer takes care of all that silly bookkeeping about which thing @@ -382,11 +402,11 @@ Differences between LyX and Other Word Processors \begin_inset OptArg status collapsed -\begin_layout Standard +\begin_layout Plain Layout \begin_inset ERT status collapsed -\begin_layout Standard +\begin_layout Plain Layout \backslash @@ -399,7 +419,7 @@ LyX \begin_inset ERT status collapsed -\begin_layout Standard +\begin_layout Plain Layout }{LyX} \end_layout @@ -491,7 +511,7 @@ Although they exist in LyX, you generally don't need them. \begin_inset Foot status collapsed -\begin_layout Standard +\begin_layout Plain Layout There are ways to adjust all of these (only some of which require knowledge of LaTeX), either for a whole document or for a specific location in a document. @@ -558,7 +578,7 @@ LaTeX is a document preparation system designed by Leslie Lamport in 1985. \begin_inset Foot status collapsed -\begin_layout Standard +\begin_layout Plain Layout The source for the info in this section is \begin_inset Quotes eld \end_inset @@ -695,25 +715,27 @@ styles: Alters the default behavior of LaTeX in some way. \end_layout \begin_layout Description -LyX: Visual, WYSIWYM word-processor that uses LaTeX to do its printing. +LyX: Visual, WYSIWYM word-processor that uses LaTeX to do its typesetting. \end_layout \begin_layout Standard -LaTeX makes LyX different from other word processors. - LyX is a graphical user interface (GUI) frontend for LaTeX, designed to - typeset documents without knowing LaTeX's macro commands. - LyX does not provide graphical support for all the countless existing LaTeX - macros, but can parse all of them. - Thus LyX is every bit as functional as LaTeX. -\end_layout - -\begin_layout Standard -Just like LaTeX, LyX focuses on the context of your writing --- +This section attempts to account for the difference between LyX and other + word processors. + Simply put, LaTeX is the difference. + By using LaTeX as its backend, LyX helps you think more about \emph on -what + what \emph default - you are typing. - The computer then handles how it should look. + (as in the +\emph on +words +\emph default +) you write. + The computer then handles +\emph on +how +\emph default + they should look. \end_layout \begin_layout Section @@ -742,30 +764,42 @@ Real Jobs \end_inset , families, dishes to clean, kitty litter to dispose of, et cetera. - If you want to help out, be sure to read Section\InsetSpace ~ + If you want to help out, be sure to read Section +\begin_inset space ~ +\end_inset + -\begin_inset LatexCommand ref +\begin_inset CommandInset ref +LatexCommand ref reference "sec:Contrib" \end_inset - in addition to the rest of this document.) + in addition to the rest of this document. \end_layout \begin_layout Standard Also, please do us a favor -- if anything in these manuals confuses you, is unclear, or wrong, don't hesitate to let us know! You can reach the current document maintainers by mailing to -\family typewriter -lyx-docs@lists.lyx.org -\family default +\begin_inset CommandInset href +LatexCommand href +target "lyx-docs@lists.lyx.org" +type "mailto:" + +\end_inset + . If you have questions which are not obviously answered in the documentation, and need help fast, there is an active users' mailing list which you can reach at -\family typewriter -lyx-users@lists.lyx.org -\family default +\begin_inset CommandInset href +LatexCommand href +target "lyx-users@lists.lyx.org" +type "mailto:" + +\end_inset + . \end_layout @@ -823,8 +857,14 @@ sec:Contrib You can go to the referred section by right-clicking on the box or by clicking the button \family sans -Go\InsetSpace ~ -to\InsetSpace ~ +Go +\begin_inset space ~ +\end_inset + +to +\begin_inset space ~ +\end_inset + Label \family default in the opened dialog. @@ -1307,9 +1347,13 @@ Units used in the Manuals \end_layout \begin_layout Standard -To understand the units described in this documentation, Table\InsetSpace ~ +To understand the units described in this documentation, Table +\begin_inset space ~ +\end_inset -\begin_inset LatexCommand ref + +\begin_inset CommandInset ref +LatexCommand ref reference "cap:Units-for-image" \end_inset @@ -1324,11 +1368,12 @@ wide false sideways false status open -\begin_layout Standard +\begin_layout Plain Layout \begin_inset Caption -\begin_layout Standard -\begin_inset LatexCommand label +\begin_layout Plain Layout +\begin_inset CommandInset label +LatexCommand label name "cap:Units-for-image" \end_inset @@ -1341,45 +1386,45 @@ Units \end_layout -\begin_layout Standard +\begin_layout Plain Layout \begin_inset VSpace medskip \end_inset \end_layout -\begin_layout Standard +\begin_layout Plain Layout \align center \begin_inset Tabular - - - - + + + + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout unit \end_layout \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout name/description \end_layout \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout mm \end_layout @@ -1388,18 +1433,18 @@ mm \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout millimeter \end_layout \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout cm \end_layout @@ -1408,18 +1453,18 @@ cm \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout centimeter \end_layout \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout in \end_layout @@ -1428,18 +1473,18 @@ in \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout inch \end_layout \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout pt \end_layout @@ -1448,7 +1493,7 @@ pt \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout point (72.27 \begin_inset Formula $\,$ \end_inset @@ -1463,11 +1508,11 @@ in) \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout pc \end_layout @@ -1476,7 +1521,7 @@ pc \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout pica (1 \begin_inset Formula $\,$ \end_inset @@ -1491,11 +1536,11 @@ pt) \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout sp \end_layout @@ -1504,7 +1549,7 @@ sp \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout scaled point (65536 \begin_inset Formula $\,$ \end_inset @@ -1519,11 +1564,11 @@ pt) \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout bp \end_layout @@ -1532,7 +1577,7 @@ bp \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout big point (72 \begin_inset Formula $\,$ \end_inset @@ -1547,11 +1592,11 @@ in) \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout dd \end_layout @@ -1560,7 +1605,7 @@ dd \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout didot (72 \begin_inset Formula $\,$ \end_inset @@ -1579,11 +1624,11 @@ mm) \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout cc \end_layout @@ -1592,7 +1637,7 @@ cc \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout cicero (1 \begin_inset Formula $\,$ \end_inset @@ -1607,11 +1652,11 @@ dd) \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout Scale% \end_layout @@ -1620,18 +1665,18 @@ Scale% \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout % of original image width \end_layout \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout text% \end_layout @@ -1640,18 +1685,18 @@ text% \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout % of text width \end_layout \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout col% \end_layout @@ -1660,18 +1705,18 @@ col% \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout % of column width \end_layout \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout page% \end_layout @@ -1680,18 +1725,18 @@ page% \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout % of paper width \end_layout \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout line% \end_layout @@ -1700,18 +1745,18 @@ line% \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout % of line width \end_layout \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout theight% \end_layout @@ -1720,18 +1765,18 @@ theight% \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout % of text height \end_layout \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout pheight% \end_layout @@ -1740,18 +1785,18 @@ pheight% \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout % of paper height \end_layout \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout ex \end_layout @@ -1760,7 +1805,7 @@ ex \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout height of letter \emph on x @@ -1771,11 +1816,11 @@ x \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout em \end_layout @@ -1784,7 +1829,7 @@ em \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout width of letter \emph on M @@ -1795,20 +1840,20 @@ M \end_inset - - + + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout mu \end_layout \end_inset - + \begin_inset Text -\begin_layout Standard +\begin_layout Plain Layout math unit (1 \begin_inset Formula $\,$ \end_inset @@ -1867,7 +1912,10 @@ LyX for LaTeX users. \end_layout \begin_layout Description -User's\InsetSpace ~ +User's +\begin_inset space ~ +\end_inset + Guide The primary documentation. We'll cover \emph on @@ -1882,7 +1930,10 @@ Tutorial \end_layout \begin_layout Description -Embedded\InsetSpace ~ +Embedded +\begin_inset space ~ +\end_inset + Objects Extension of the \emph on User's Guide @@ -1893,7 +1944,10 @@ User's Guide \end_layout \begin_layout Description -Extended\InsetSpace ~ +Extended +\begin_inset space ~ +\end_inset + Features Extension of the \emph on User's Guide @@ -1911,7 +1965,10 @@ onalization, and configuration files. \end_layout \begin_layout Description -LaTeX\InsetSpace ~ +LaTeX +\begin_inset space ~ +\end_inset + configuration LyX investigates your system upon installation. This file contains info on what LyX learned about your installation. Check it to see if you're missing something you might like to have. @@ -1971,7 +2028,8 @@ Otherwise, you could needlessly frustrate yourself. \end_layout \begin_layout Section -\begin_inset LatexCommand label +\begin_inset CommandInset label +LatexCommand label name "sec:Contrib" \end_inset @@ -2005,8 +2063,13 @@ While using LyX, you may find behavior which you consider a bug. LyX has a bug tracking system, which you can find at \family typewriter -\begin_inset LatexCommand url -target "http://bugzilla.lyx.org/" +\begin_inset Flex URL +status collapsed + +\begin_layout Plain Layout + +http://bugzilla.lyx.org/ +\end_layout \end_inset @@ -2018,15 +2081,24 @@ target "http://bugzilla.lyx.org/" If you have a comment on an existing bug, or wish to report a new bug, you may either use the bug tracker, or send an e-mail to the development mailing list, -\family typewriter -lyx-devel@lists.lyx.org -\family default +\begin_inset CommandInset href +LatexCommand href +target "lyx-devel@lists.lyx.org" +type "mailto:" + +\end_inset + . Archives of this list are linked from the main LyX website, \family typewriter -\begin_inset LatexCommand url -target "http://www.lyx.org/" +\begin_inset Flex URL +status collapsed + +\begin_layout Plain Layout + +http://www.lyx.org/ +\end_layout \end_inset @@ -2082,9 +2154,13 @@ Reporting Errors in the Manuals \begin_layout Standard If you find a problem with the documentation, send a message to the mailing list -\family typewriter -lyx-docs@lists.lyx.org -\family default +\begin_inset CommandInset href +LatexCommand href +target "lyx-docs@lists.lyx.org" +type "mailto:" + +\end_inset + . The documentation team will make any necessary fixes. \end_layout @@ -2101,15 +2177,24 @@ n Project, you need to do the following: \begin_layout Enumerate Get the latest LyX source code from -\newline +\begin_inset Newline newline +\end_inset -\begin_inset LatexCommand url -target "http://www.lyx.org/trac/browser/lyx-devel/trunk/lib/doc" + +\begin_inset Flex URL +status collapsed + +\begin_layout Plain Layout + +http://www.lyx.org/trac/browser/lyx-devel/trunk/lib/doc +\end_layout \end_inset -\newline +\begin_inset Newline newline +\end_inset + Inside that directory is a file called \family typewriter DocStyle.lyx @@ -2128,7 +2213,9 @@ User's Guide Tutorial \emph default -\newline +\begin_inset Newline newline +\end_inset + The point of this exercise is to give you ideas. The \emph on @@ -2145,13 +2232,21 @@ User's Guide \begin_layout Enumerate Contact the team at: -\newline - -\family typewriter -lyx-docs@lists.lyx.org -\family default +\begin_inset Newline newline +\end_inset + + +\begin_inset CommandInset href +LatexCommand href +target "lyx-docs@lists.lyx.org" +type "mailto:" + +\end_inset + + +\begin_inset Newline newline +\end_inset -\newline to discuss your intended changes, and get some feedback on them. \end_layout