%% LyX 2.2.0dev created this file.  For more info, see http://www.lyx.org/.
%% Do not edit unless you really know what you are doing.
\documentclass[12pt,english,hebrew]{article}
\usepackage[T1]{fontenc}
\usepackage[utf8]{luainputenc}
\setcounter{tocdepth}{2}
\usepackage{url}
\PassOptionsToPackage{normalem}{ulem}
\usepackage{ulem}

\makeatletter

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% LyX specific LaTeX commands.
\providecommand{\LyX}{L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX\@}
\newcommand{\noun}[1]{\textsc{#1}}
\DeclareRobustCommand{\cyrtext}{%
  \fontencoding{T2A}\selectfont\def\encodingdefault{T2A}}
\DeclareRobustCommand{\textcyr}[1]{\leavevmode{\cyrtext #1}}

%% Because html converters don't know tabularnewline
\providecommand{\tabularnewline}{\\}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Textclass specific LaTeX commands.
\newenvironment{lyxlist}[1]
{\begin{list}{}
{\settowidth{\labelwidth}{#1}
 \setlength{\leftmargin}{\labelwidth}
 \addtolength{\leftmargin}{\labelsep}
 \renewcommand{\makelabel}[1]{##1\hfil}}}
{\end{list}}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% User specified LaTeX commands.
% DO NOT ALTER THIS PREAMBLE!!!
%
%This preamble is designed to ensure that the document prints
% out as advertised. If you mess with this preamble,
% parts of the document may not print out as expected.  If you
% have problems LaTeXing this file, please contact 
% the documentation team
% email: lyx-docs@lists.lyx.org

\usepackage{ifpdf} % part of the hyperref bundle
\ifpdf % if pdflatex is used

 % set fonts for nicer pdf view
 \IfFileExists{lmodern.sty}{\usepackage{lmodern}}{}

% XeTeX with Hebrew does not like this bookmark code
% so it is in the conditional.
% 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} }

\fi % end if pdflatex is used

%disable hyphenation (breaking words at end of line)
\usepackage[none]{hyphenat}

%disable double space after end-of-sentence period
\frenchspacing

\makeatother

\usepackage{babel}
\begin{document}

\title{מבוא ל- \L{\LyX{}}\thanks{המסמך מנוסח בלשון זכר אך מיועד כמובן לקוראים ולקוראות כאחד.}}

\author{מאת צוות \L{\LyX{}}\thanks{תורגם ע\char`\"{}י רן רוטנברג, {\beginL 2006\endL}. הערות לגבי התרגום
ניתן לשלוח לכתובת: \texttt{\L{\protect\url{hebrew.lyx@gmail.com}}}}}

\maketitle
\tableofcontents{}

\section{הפילוסופיה של \L{\protect\LyX{}}}
\begin{quote}
\char`\"{}דוד קוסמו, למה קוראים לזה מעבד תמלילים?\char`\"{}

\char`\"{}זה פשוט סקיילר, ראית מה עושה מעבד מזון למזון?\char`\"{}

\hfill{})ג'ף מקנלי \char`\"{}\L{Shoe}\char`\"{}(
\end{quote}
\selectlanguage{english}%
In case you can read only this paragraph, probably you did not set
the Hebrew language correctly. Please refer to the instructions on
(for Windows machines): \url{http://wiki.lyx.org/Windows/Hebrew}
or on (for Linux): \url{http://wiki.lyx.org/LyX/HebrewOnLinux}.
\selectlanguage{hebrew}%

\subsection{מה זה \L{\protect\LyX{}}?}

\L{\LyX{}} )ליקס( הוא מערכת להכנת מסמכים. הוא מצטיין בכתיבת מאמרים
טכניים ומדעיים מורכבים המכילים נוסחאות מתמטיות, הפניות, ביבליוגרפיות,
אינדקסים וכו'. \L{\LyX{}} מתאים היטב למסמכים בכל אורך, אשר בהם נדרשת
יכולת עיבוד התמלילים הרגילות: עימוד וחלוקה לקטעים אוטומטיים, בדיקת
איות וכדומה. אמנם תוכל לכתוב באמצעותו מכתב לאמא, אך סביר להניח שניתן
למצוא תוכנות פשוטות יותר לביצוע מטלה זו. אף על פי כן, \L{\LyX{}}
הוא בהחלט לא התוכנה ליצירת כרזות, עלונים ופרסומות )ההסבר לכך יבוא
בהמשך(, למרות שעם מאמץ מסויים ניתן להכין גם את כל אלה. דוגמאות אחדות
למה שניתן לעשות עם ליקס הן: תזכירים, עבודות גמר, דיסרטציות, תקצירי
הרצאות, מחברות סמינריוניות, פרוטוקולים מישיבות, תיעוד תוכנות, ספרים
)על \L{PostgreSQL}, חישה מרחוק, הצפנה, רומני סיפורת, שירה ואפילו ספרי
ילדים(, מאמרים בכתבי עת מדעיים מוערכים, תסריטים למחזות וסרטים, הצעות
עסקיות\ldots{} הבנתם את הרעיון.

\L{\LyX{}} מספק גישה מודרנית לכתיבת מסמכים בעזרת מחשב על ידי שימוש
במערכת של שפת סימני עריכה \L{(markup language)}, גישה שאינה תואמת
למסורת המיושנת של \char`\"{}עקרון מכונת הכתיבה\char`\"{}. \L{\LyX{}}
מיועד למחברים שרוצים לקבל תוצר מקצועי במהירות, תוך השקעת מאמץ מינימלי,
ומבלי להתמחות בסידור-דפוס. עבודת סידור-הדפוס נעשית ברובה על ידי המחשב,
לא ע\char`\"{}י הכותב; עם \L{\LyX{}} המחבר יכול להתרכז בתוכן כתיבתו.

חלק מהאתגר הראשוני בשימוש ב- \L{\LyX{}} נובע מהשינוי המחשבתי שאתה,
המשתמש, צריך לעבור. בעבר, האמצעי היחיד לכתיבת מסמכים היה מכונת הכתיבה,
ולכן למדו האנשים תחבולות שונות כדי להתמודד עם המגבלות של מכונות הכתיבה.
מתיחת קו תחתי, שהיא למעשה לא יותר מאשר לחיצה מרובה על תו ה- \char`\"{}\_\char`\"{},
הפכה לדרך להדגיש טקסט. לפני יצירת טבלה המשתמש נדרש לתכנן מראש ולקבוע
את גודל העמודות ואת עצירות הטאבים \L{(tab stops)}. הדבר נכון גם לגבי
מכתבים וטקסטים אחרים המיושרים לימין {]}\emph{הערת המתרגם: הדבר נכון
בלועזית. בעברית הבעיה ארעה כאשר הכותב רצה ליישר את הטקסט משמאל לימין
במקום מימין לשמאל – ר.ר}{[}. מיקוף \L{(hyphenation)} בסוף שורה )המשמש
לשבירת מילה ארוכה( דרש עין חדה ויכולת להבחין מראש מתי ידרש.

במילים אחרות, כולנו דואגים לפרטים הקטנים כמו מיקומוכל תו ותו. כתוצאה
מכך, כמעט כל מעבדי התמלילים בנויים לפי שיטה זו. בכל אלה עדיין משתמשים
בלחצן ה\char`\"{}טאב\char`\"{} כדי להוסיף מרווח. המשתמש עדיין צריך
להקדיש תשומת לב למיקום של קטע מסויים בדף. דברים אלה מאפיינים את הפילוסופיה
המונחת ביסוד של מעבד תמלילים מסוג הדפסתו-כראיתו\footnote{זהו תרגום שקבעה האקדמיה ללשון לקיצור \L{WYSIWYG} שפירושו \L{``What
you see is what you get''}}: לרוע המזל, שיטה זו מתבטאת לעיתים קרובות בכך שמה שרואים על המסך הוא
כל מה שנוכל לקבל בתוצר המודפס.

בנקודה זו \L{\LyX{}} שונה ממעבד תמלילים רגיל. המשתמש אינו צריך להעסיק
את עצמו בזוטות כגון איפה כל תו מופיע. אתה, המשתמש, מציין ל- \L{\LyX{}}
\emph{מה אתה עושה} ו- \L{\LyX{}} יהיה אחראי לכל השאר, בהתאם למערכת
של חוקים הנקראת סגנון\footnote{למען ההגינות, נציין שבגרסאות החדשות של חבילות האופיס המקובלות ישנם
גליונות סגנון שפועלים לפי שיטה דומה של סמני עריכה. אף על פי כן, הניסיון
מצביע על כך שעדיין אפשרות זו היא בשימוש מועט ונדיר.}. הבה ונבחן דוגמא קצרה:

נניח שאתה כותב דו\char`\"{}ח. כדי להתחילו אתה רוצה חלק שייקרא \char`\"{}מבוא\char`\"{}.
לכן, אתה פותח תפריט כלשהו במעבד התמלילים ומגיע למקום בו ניתן לשנות
את גודל הגופן ובוחר גודל חדש. לאחר מכן אתה לוחץ על לחצן ההדגשה וכותב
\char`\"{}{\beginL 1\endL}.~~מבוא\char`\"{}. כמובן, במידה ותחליט
לשנות את מיקום חלק זה למקום אחר, או לחלופין להכניס חלק אחר לפני המבוא
תדרש למספר מחדש את כל החלקים ולשנות את תוכן העניינים.

ב- \L{\LyX{}}, המשתמש פשוט ייבחר בתפריט הנגלל הממוקם בצד שמאל את
האפשרות \textsf{קטע} ואז יקליד \char`\"{}מבוא\char`\"{}.

כן, זה הכל. אם תגזור ותדביק את החלק, הוא ימוספר אוטומטית – בכל מקום.
אם תכניס במסמך הפניות לחלק זה בצורה נכונה )ע\char`\"{}י הכנסת תגיות
הפנייה(, \L{\LyX{}} יעדכן אותן כך שלעולם לא תצטרך להקיש את מספר החלק.

כעת, נסתכל על בעיית העקביות. חמישה ימים מאוחר יותר, אתה פותח מחדש
את הדו\char`\"{}ח ומתחיל לעבוד על חלק {\beginL 4\endL}. אולם, שכחת
שהשתמשת בגופן מודגש בגודל {\beginL 18\endL}, ואתה כותב כעת בגודל {\beginL 16\endL}.
כתוצאה מכך הכותרת של חלק {\beginL 4\endL} שונה בגופן מהכותרת של חלק
{\beginL 1\endL}. בעייה זו אינה קיימת ב- \L{\LyX{}}. המחשב דואג לשמור
את כל אותן ההגדרות כמו גודל הגופן של כל דבר, ולא אתה. הרי, בכך מחשבים
טובים.

דוגמה נוספת היא הכנת רשימה. במעבדי תמלילים אחרים, רשימה הינה בסך הכל
אוסף של שורות וטאבים. אתה צריך להבין היכן למקם את התווית לכל איבר
ברשימה, מה התווית צריכה להיות, וכמה שורות ריקות יש להשאיר בין כל איבר
ואיבר וכך הלאה. כשאתה משתמש ב- \L{\LyX{}} יש לך רק שני דברים להתייחס
אליהם: איזה סוג רשימה אתה צריך, ומה אתה רוצה להכניס אליה. זהו זה.

אז זהו הרעיון הבסיסי המונח ביסוד של \L{\LyX{}}: לציין \emph{מה} אתה
עושה ולא \emph{איך} לעשות זאת. במקום הדפסתו-כראיתו, המודל של \L{\LyX{}}
הוא הדפסתו-ככוונתו\footnote{במקור מופיע הקיצור \L{WYSIWYM} שפירושו \char`\"{}\L{What You See Is
What You Mean}''.}. זהו רעיון רב עוצמה, שמפשט במידה רבה את כתיבת המסמכים. זאת גם הסיבה
מדוע \L{\LyX{}} אינו כל-כך טוב ליצירת עלונים ופוסטרים – במקרה זה
אתה \emph{כן} רוצה לציין היכן כל דבר יימצא בדיוק, בגלל שאין יחידות
תחביריות כגון פיסקאות וחלקים. זה לא אומר ש- \L{\LyX{}} חסר תכונה
מגניבה כלשהי. זה פשוט אומר ש- \L{\LyX{}} אינו הכלי הנכון לעבודה –
אינך משתמש במברג כדי לדפוק מסמרים )אלא אם כן המברג בא עם אחריות לכל
החיים(.

\subsection{ההבדלים בין \L{\protect\LyX{}} ומעבדי תמלילים אחרים}

הנה כמה דברים שלא תמצאו ב- \L{\LyX{}}:
\begin{itemize}
\item שורת הסרגל
\item טאבים
\item מרווחים כפולים )כלומר לחיצה יותר מפעם אחת על מקש הרווח או ה- \L{\textsf{Enter}}(
\end{itemize}
טאבים, ביחד עם שורת הסרגל, המראה את מיקומם של עצמים בעמוד, הם חסרי
שימוש ב- \L{\LyX{}}. התוכנה דואגת למיקום של עצמים בעמוד ולא המשתמש.
מרווחים כפולים הם דבר דומה; \L{\LyX{}} מוסיפם כאשר יש צורך, ובהתאם
להקשר. חוסר היכולת להוסיף שורות ריקות ייתכן וירגיז קצת בהתחלה, אבל
יהיה הגיוני יותר ויותר ככל שתתחיל לחשוב בגישת הדפסתו-ככוונתו.

הנה כמה דברים שישנם ב- \L{\LyX{}} אבל אין משתשמשים בהם בדרך הרגילה:
\begin{itemize}
\item שליטה בהזחה )אינדנטציה(.
\item מעברי עמוד
\item מרווח בין שורות
\item מרווח לרוחב ולגובה
\item גופנים וגדלי גופנים
\item סגנון דפוס )אותיות דגושות, נטויות, עם קו תחתי וכו'(
\end{itemize}
אף על פי שדברים אלה קיימים ב- \L{\LyX{}}, על פי רוב אין המשתמש נזקק
להם. \L{\LyX{}} יטפל בהם בשבילך, בהתאם למה שאתה עושה. חלקים שונים
של המסמך מוגדרים אוטומטית בסגנון דפוס וגודל גופן שונים. הזחת פיסקאות
היא תלויית הקשר; פיסקאות שונות מוזחות בצורה שונה. מעברי עמוד נעשים
גם הם אוטומטית. באופן כללי, המרווח בין שורות, מילים ופיסקאות הוא משתנה
אך נקבע על ידי \L{\LyX{}}\footnote{המשתמש יכול לשנות את כל אלה )חלק מהשינויים דורש ידע ב- \L{(\LaTeX{}}.}.

לבסוף, ישנם מספר תחומים בהם אנו מאמינים ש- \L{\LyX{}} )ו- \L{\LaTeX{}}(
מתעלה מעל למעבדי תמלילים רבים:
\begin{itemize}
\item מיקוף
\item רשימות מכל סוג
\item מתמטיקה
\item טבלאות
\item הפניות
\end{itemize}
אמנם למעבדי תמלילים מודרניים רבים ניתן להכניס ביטויים מתמטיים, טבלאות
ומיקוף, ורבים נעו לכיוון הגדרות סגנון ורעיון ההדפסתו-ככוונתו, אבל
הם יכולים לעשות זאת מזה זמן לא רב, בעוד ש- \L{\LyX{}} בנוי על מערכת
הכנת המסמכים \L{\LaTeX{}}. \L{\LaTeX{}} קיימת כבר מספר עשורים והיא
\emph{פועלת}.

\subsection{מה זה לעזאזל \L{\protect\LaTeX{}} ומה זה מעניין אותי?}

\L{\LaTeX{}} היא מערכת הכנת מסמכים שתוכננה על ידי \L{\noun{Leslie
Lamport}} בשנת {\beginL 1985\endL}\footnote{המקור למידע בחלק זה הוא \L{\textquotedbl{}\emph{A~Guide~to~\LaTeXe{}\textquotedbl{}}}
מאת \L{\noun{Helmut Kopaka}} ו- \L{\noun{Patrick Daly}}, המופיע בבבליוגרפיה
של \char`\"{}המדריך למשתמש\char`\"{}.}. \L{\LaTeX{}} הייתה בנוייה על בסיס שפת הדפוס הנקראת \L{\TeX{}}
)טך( שנכתבה על ידי \L{\noun{Donald Knuth}} בשנת {\beginL 1984\endL}.
\L{\TeX{}} לוקחת רצף של פקודות דפוס, הרשומות בתור קוד בקובץ \L{ASCII},
ומבצעת אותן. זה קצת יותר מסובך ממכונת כתיבה אך הרבה פחות מסובך ממכבש
דפוס אמיתי. אף על פי כן, תחבולות רבות של תעשיית הדפוס הוכנסו על ידי
\L{\noun{Knuth}} כאלגוריטמי מחשב ל- \L{\TeX{}}, ומכאן המראה המודפס
המצויין. בכל מקרה, הפלט של \L{\TeX{}} הוא קובץ מסוג \char`\"{}\L{device
independent}'', או \L{\texttt{dvi}}. ניתן להזין קובץ זה לכל מכשיר
שמסוגל לפענחו או לחלופין להמירו לפורמטים אחרים כגון \L{PostScript®},
\L{PDF}, ועוד.

אלמלא תכונה אחת, \L{\TeX{}} לא היה שונה מכל תוכנת דפוס אחרת, אבל
\L{\TeX{}} מאפשר בנוסף לכל להגדיר מאקרו-ים )\L{macro}(. כאן כל הכיף
מתחיל.

רוב האנשים שמשתמשים ב- \L{\TeX{}} משתמשים למעשה בחבילת מאקרו-ים שפיתח
\L{\noun{Knuth}} במטרה להסתיר רבים מפרטי הדפוס. זה מה שרוב האנשים
חושבים עליו כאשר הם חושבים על \L{\TeX{}}. משתמשים מן השורה לא משתמשים
ב- \L{\TeX{}} גולמי שהוא למעשה אוסף של פקודות דפוס חשופות. עושים
זאת אנשים שיוצרים חבילות מאקרו חדשות. כאן נכנס לתמונה \L{\noun{Leslie}
\noun{Lamport}}. הוא רצה חבילת מאקרו שתהיה מותאמת יותר למשתמשים ולא
לסדרי דפוס. אוסף של פקודות שידפיסו דברים כמו פרקים, טבלאות, ונוסחאות
מתמטיות באופן אחיד ועקבי, בלי שיהיה צורך להתעסק בהן יותר מידי. כך
נולדה \L{\LaTeX{}}.

באותה עת, במקביל להתפתחות של \L{\LaTeX{}}, אנשים אחרים החלו ליצור
חבילות מאקרו משל עצמם ל- \L{\TeX{}}, כדי ליצור מצגות או מאמרים לכתבי
עט מתמטיים וכו'. חלק השתמשו ב- \L{\TeX{}} גולמי כדי לעשות זאת ואחרים
החלו לשנות את \L{\LaTeX{}}. כדי לנסות ולעשות סדר בבלגן, קבוצה של
אנשי \L{\LaTeX{}} )וביניהם למפורט( החלו לעבוד בשלהי שנות השמונים
על \L{\LaTeXe{}} שהיא הגרסה העכשווית של \L{\LaTeX{}}. גרסה חדשה
זו מכילה פקודות שמספקות ממשק משתמש קל יותר לשימוש לפקודות יצירת המאקרו
של טך, ומספקות סיוע בשימוש בגופנים חדשים וכו'. למעשה, \L{\LaTeX{}}
היא שפה נרחבת בזכות עצמה! משתמשים מרחבי העולם יוצרים את התוספים שלהם
ל- \L{\LaTeX{}} בנוסף לאלו הרגילים.

ישנן שתי דרכים להרחיב את \L{\LaTeX{}}: מחלקות וסגנונות. \emph{מחלקה}
היא מערכת של מאקרו-ים של \L{\LaTeX{}} )ושל \L{\TeX{}}(, המתארים
סוג מסמך חדש, כמו ספר או מאמר. ישנן מחלקות עבור מצגות, כתבי עת פיסיקליים
ומתמטיים\ldots{} לאוניברסיטאות רבות יש אפילו מחלקה מיוחדת לעבודות
תזה! \emph{סגנון} שונה ממחלקה, בכך שאינו מגדיר סוג מסמך חדש, אלא סוג
אחר של \emph{התנהגות} שכל מסמך יכול להשתמש בה. לדוגמא, \L{\LyX{}}
שולט בגודל שולי הדף והמרווח בין השורות על ידי שימוש בשני קבצי סגנון
שונים של \L{\LaTeX{}} המיועדים למטרה זו. ישנם קבצי סגנון למגוון רחב
של דברים: הדפסת תוויות או מעטפות, שינוי הזחת הפיסקאות, הוספת גופנים
חדשים, שליטה בתמונות, עיצוב כותרות עמוד מקושטות, התאמת ביבליוגרפיות,
שינוי המיקום והמראה של הערות תחתית, טבלאות ואיורים, התאמת רשימות וכו'.

הנה סיכום הדברים:
\begin{lyxlist}{00.00.0000}
\item [{~\L{\TeX{}}}] שפת דפוס עם יכולות מאקרו.
\item [{\L{\LaTeX{}}}] חבילת מאקרו הבנויה על \L{\TeX{}}.
\item [{מחלקה}] תיאור של סוג מסמך חדש תוך שימוש ב- \L{\LaTeX{}}.
\item [{סגנון}] שינוי ההתנהגות הרגילה של \L{\LaTeX{}} בדרך כלשהי.
\item [{\L{\LyX{}}}] מעבד תמלילים גרפי מסוג הדפסתו-ככוונתו שמשתמש ב-
\L{\LaTeX{}} בכל תפארתה כדי להדפיס.
\end{lyxlist}
הרעיון מאחורי חלק זה הוא לנסות להסביר \emph{מדוע} \L{\LyX{}} עובד
בצורה שונה ממעבדי תמלילים אחרים. הסיבה לכך פשוטה: \L{\LyX{}} משתמש
ב- \L{\LaTeX{}} כמנוע ההדפסה. בדיוק כמו \L{\LaTeX{}}, \L{\LyX{}}
מתמקד על ההקשר של כתביך – \emph{על מה} שאתה כותב. המחשב מתעסק באיך
זה אמור להראות.

דבר אחד אחרון, \L{\TeX{}} מבוטא כ\char`\"{}טך\char`\"{} )האות טי\char`\"{}ת
מנוקדת בסגול(, ולכן \L{\LaTeX{}} מבוטאת כ\char`\"{}לאטך\char`\"{}
)האות למ\char`\"{}ד בקמץ, טי\char`\"{}ת בסגול(. אבל \L{\LyX{}} מבוטא
כ\char`\"{}ליקס\char`\"{} )למ\char`\"{}ד בחיריק, קו\char`\"{}ף בשווא(.

\section{השימוש בתיעוד}

כדי להקל על המשתמש למצוא תשובות לשאלותיו ולתאר את כל תכונותיו של \L{\LyX{}},
התיעוד חולק למספר קבצים שונים. לכל אחד מהם מטרה משלו, כפי שיתואר בהמשך.
לפני שאתה הולך ו\char`\"{}חורש\char`\"{} אחד ממסמכי התיעוד רצוי שתקרא
פרק זה היטב, כיוון שהוא מכיל מידע והערות רבות שיכולים לחסוך לך זמן
בהמשך.

אף על פי ש- \L{\LyX{}} עבר מזמן את גרסה {\beginL 1.0\endL} חלק מהתיעוד
אינו שלם או קצת מיושן למרות שאנחנו מנסים לשמור על הקצב. כמו שאר חלקיו
של \L{\LyX{}}, גם המדריכים הם פרי עבודתם של מתנדבים בעלי \char`\"{}עבודות
אמיתיות\char`\"{}, בעלי משפחות, כלים שצריך לשטוף אחרי הארוחה, כלבים
שצריך להוציא לטיול וכו'. אם אתה מעוניין לעזור, קרא את פרק~\L{\ref{=0005E4=0005E8=0005E7:=0005EA=0005E8=0005D5=0005DE=0005D4}}
בנוסף לשאר המסמך.

כמו כן, עשה לנו טובה – אם משהו בקבצי הדרכה מבלבל, לא ברור, או שגוי,
אל תהסס ליידע אותנו על כך! ניתן להשיג את מתחזקי התיעוד הנוכחיים ע\char`\"{}י
שליחת דוא\char`\"{}ל ל- \L{\texttt{lyx-docs@lists.lyx.org}}. אם יש
לך שאלה שלא נמצאה לה תשובה ברורה בתיעוד ואתה צריך עזרה במהירות, ישנה
קבוצת דיוור פעילה של משתמשים בכתובת:\\
 \L{\texttt{lyx-users@lists.lyx.org}} .

\subsection{מבנה המדריכים}

ייתכן וחלקכם הדפיס את קובץ/י ההדרכה, ואילו אחרים יכולים לקרוא באופן
מקוון, דרך ה- \L{\LyX{}}. הקוראים באופן מקוון, דעו שישנם מספר הבדלים
בין הגירסה על המחשב לגירסה המודפסת. ראשית, הכותרת ממוקמת בראש המסמך
ולא נמצאת על דף נפרד כמו בחלק מהגרסאות המודפסות. שנית, לא תוכן העניינים
ולא הערות התחתית גלויים לעין. כדי לפתוח הערת תחתית, אשר נראית כך\footnote{שלום},
לחץ עליה עם הלחצן השמאלי של העכבר. בשביל תוכן העניינים, לחץ על המלבן
האפור, או לחץ על תפריט ה- \textsf{\uline{נ}}\textsf{יווט}, היכן
שהתוכן מוצג אוטומטית )נסה זאת!(.

במדריכים המודפסים, כל ההפניות מופיעות כמספרים אמיתיים השייכים לפרק,
חלק, תת חלק וכו', אך על המחשב כל ההפניות מופיעות ככמלבן אפור כמו זה:
\L{\ref{=0005E4=0005E8=0005E7:=0005EA=0005E8=0005D5=0005DE=0005D4}}
)בגרסא המודפסת מופיע במקום המלבן מספר(. אם תלחץ על המלבן עם הלחצן
השמאלי של העכבר, תופיע תיבת דיאלוג המכילה רשימה של כל ההפניות במסמך.
במבוא זה ישנה הפניה אחת בלבד ששמה \char`\"{}פרק:תרומה\char`\"{}. אתה
יכול להגיע לחלק אליו מתייחסת ההפניה על ידי לחיצה על הלחצן \char`\"{}\textsf{לך
לתווית}\char`\"{}. כדי לחזור למקום ממנו הגעת יש ללחוץ על \char`\"{}\textsf{חזור\char`\"{}}
או לחלופין להקיש \L{\textsf{C-<}} )מה הפירוש של \char`\"{}\L{\textsf{C-<}}''?
ראה בהמשך(.

כעת, אחרי שסקרנו את ההבדלים בין הגירסה המודפסת לגירסה המקוונת, אפשר
להתחיל לבחון את העיצוב של מסמך זה. מדי פעם תבחין בכיתוב בגופן שונה:
\begin{itemize}
\item \emph{סגנון מודגש} משמש להדגשה כללית, משתנים גנריים, שמות של ספרים,
שמות של חלקים משאר המדריכים\footnote{\begin{itemize}
\item \emph{הערת המתרגם: }שמות של ספרים ושל מדריכים בעברית יכתבו כמקובל
בטקסט רגיל המוקף מרכאות – ר.ר.
\end{itemize}
}, והערות מהמחברים והמתרגמים.
\item שמות של תוכניות וקבצים, קוד \L{\LyX{}} ופונקציות יופיעו בגופן מסוג
\texttt{מכונת כתיבה}.
\item גופן\textsf{ נטול תגים} משמש לציון תפריטים, לחצנים, תיבות דיאלוג ושמות
לחצני מקלדת.
\item הגופן \L{\noun{Noun Style}}\noun{ משמש לשמו}ת של אנשים באנגלית.
\item גופן \textbf{מובלט} משמש לציון קוד \L{\LaTeX{}}.
\end{itemize}
עבור מקשי קיצור לתפריטים ומקשי קיצור אחרים, סביר להניח שתופנה לחלק
\char`\"{}מקשי קיצור\char`\"{} )\L{\emph{Key Bindings}}( של \char`\"{}מדריך
התכונות הנוספות\char`\"{} )\L{\emph{Additional Features Manual}}(
)שם הקובץ הוא \L{\texttt{Additional.lyx}}(. בכל מקרה, כאשר נצטרך לציין
קיצורי דרך נשתמש בסימנים הבאים לייצוג המקשים:
\begin{itemize}
\item \char`\"{}\L{\textsf{C-}}'' מציין את מקש ה- \L{\textsf{Control}}.
\item \char`\"{}\L{\textsf{S-}}'' מציין את מקש ה- \L{\textsf{Shift}}.
\item \char`\"{}\L{\textsf{M-}}'' מציין את מקש ה- \L{\textsf{Meta}} אשר
על חלק מהמקלדות יופיע כמקש \L{\textsf{Alt}}.
\item \char`\"{}\L{\textsf{F1}}''\ldots{}\char`\"{}\L{\textsf{F12}}''
הם מקשי הפונקציות.
\item \char`\"{}\L{\textsf{Esc}}'' מציין את מקש \L{\textsf{Escape}}.
\item \char`\"{}\L{\textsf{Left}}'', \char`\"{}\L{\textsf{Right}}'', \char`\"{}\L{\textsf{Up}}''
ו- \char`\"{}\L{\textsf{Down}}'' \L{–} מקשי החיצים שמאלה, ימינה,
מעלה ומטה בהתאמה.
\item \char`\"{}\L{\textsf{Insert}}'', \char`\"{}\L{\textsf{Delete}}'',
\char`\"{}\L{\textsf{Home}}'', \char`\"{}\L{\textsf{End}}'', \char`\"{}\L{\textsf{PageUp}}''
ו- \char`\"{}\L{\textsf{PageDown}}'': אלה ששת המקשים המופיעים מעל
למקשי החיצים על מרבית המקלדות. לפעמים במקום \char`\"{}\L{\textsf{PageUp}}''
ו- \char`\"{}\L{\textsf{PageDown}}'' מופיעים \char`\"{}\L{\textsf{Prior}}''
ו- \char`\"{}\L{\textsf{Next}}'' בהתאמה.
\item \char`\"{}\L{\textsf{Return}}'' ו- \char`\"{}\L{\textsf{Enter}}''
מתייחסים לאותו מקש. בחלק מהמקלדות מופיע אחד מהם, או שניהם גם יחד,
אך \L{\LyX{}} מתייחס אליהם כאל אותו מקש, ולכן נשתמש בהם לסירוגין.
\end{itemize}
מידי פעם תראה משהו בסגנון \char`\"{})ראה 'נוספות'(\char`\"{}. כל ברירות
המחדל של מקשי הקיצור לאפשרות מסויימת נרשמו ב\char`\"{}מדריך התכונות
הנוספות\char`\"{} – אז בדוק גם שם. שים לב שישנן שתי מערכות של מקשי
קיצור בשימוש קהילת \L{\LyX{}}: סגנון ה- \L{CUA} המוכר למשתמשי \L{PC},
וסגנון \char`\"{}\L{emacs}'' הנפוץ אצל משתמשי יוניקס. בכל מקרה ללא
הודעה אחרת, מקשי הקיצור מתייחסים למערכת ה- \L{CUA}. אם אתה אוהב את
\L{emacs} אתה אמור להיות מנוסה מספיק כדי לקרוא את קבצי ההדרכה ולהבין
לבד את מקשי הקיצור.

\subsection{יחידות מדידה המופיעות במדריכים}

על מנת שתכירו את יחידות המדידה בהן משתמש נעשה שימוש בתיעוד, טבלה~\L{\ref{tab:=0005D9=0005D7=0005D9=0005D3=0005D5=0005EA-=0005DE=0005D3=0005D9=0005D3=0005D4}}
מכילה את כל היחידות הזמינות ב- \L{\LyX{}}.

\begin{table}[t]

\caption{יחידות מדידה\label{tab:=0005D9=0005D7=0005D9=0005D3=0005D5=0005EA-=0005DE=0005D3=0005D9=0005D3=0005D4}}

\medskip{}

\L{\selectlanguage{english}%
\centering{}%
\begin{tabular}{|c|c|}
\hline 
\R{\R{\selectlanguage{hebrew}%
שם או תיאור\selectlanguage{english}}%
} & \R{\R{\selectlanguage{hebrew}%
יחידה\selectlanguage{english}}%
}\tabularnewline
\hline 
\hline 
\R{\R{\selectlanguage{hebrew}%
מילימטר\selectlanguage{english}}%
} & mm\tabularnewline
\hline 
\R{\R{\selectlanguage{hebrew}%
סנטימטר\selectlanguage{english}}%
} & cm\tabularnewline
\hline 
\R{\R{\selectlanguage{hebrew}%
אינטש\selectlanguage{english}}%
} & in\tabularnewline
\hline 
\R{\R{\selectlanguage{hebrew}%
נקודה/\L{point} )\L{28.45~pt=1~cm}(\selectlanguage{english}}%
} & pt\tabularnewline
\hline 
\R{\R{\selectlanguage{hebrew}%
פיקה/\L{pica} )\L{1~pc = 12~pt}(\selectlanguage{english}}%
} & pc\tabularnewline
\hline 
\R{\R{\selectlanguage{hebrew}%
נקודה קטנה/\L{scaled point} )\L{65536~sp = 1~pt}(\selectlanguage{english}}%
} & sp\tabularnewline
\hline 
bp & big point (72$\,$bp = 1$\,$in)\tabularnewline
\hline 
dd & didot (72$\,$dd $\approx$ 37.6$\,$mm)\tabularnewline
\hline 
cc & cicero (1$\,$cc = 12$\,$dd)\tabularnewline
\hline 
Scale\% & \% of original image width\tabularnewline
\hline 
text\% & \% of text width\tabularnewline
\hline 
col\% & \% of column width\tabularnewline
\hline 
page\% & \% of paper width\tabularnewline
\hline 
line\% & \% of line width\tabularnewline
\hline 
theight\% & \% of text height\tabularnewline
\hline 
pheight\% & \% of paper height\tabularnewline
\hline 
ex & height of letter \emph{x} in current font\tabularnewline
\hline 
em & width of letter \emph{M} in current font\tabularnewline
\hline 
mu & math unit (1$\,$mu = 1/18$\,$em)\tabularnewline
\hline 
\end{tabular}\selectlanguage{hebrew}}%
\end{table}


\subsection{המדריכים}

הרשימה להלן מתארת כל אחד ואחד מקבצי התיעוד\footnote{עדיין לא כל הקבצים תורגמו, סבלנות\ldots{}}:
\begin{description}
\item [{מבוא~)\L{\emph{Introduction}}(}] ~\\
 הקובץ הזה.
\item [{שיעור~מודרך~)\L{\emph{Tutorial}}(}] ~\\
אם אתה חדש ל- \L{\LyX{}}, ואף פעם לא השתמשת ב- \L{\LaTeX{}}, אתה
צריך להתחיל כאן. אם עדיין אין לך שמץ של מושג מה זה \L{\LaTeX{}} וחושב
שזה סוג של גומי, אז אתה חייב לחזור ולקרוא את פרק {\beginL 1\endL},
ואז קרא את \char`\"{}השיעור המודרך\char`\"{}. שים לב שאחרי שתקרא את
\char`\"{}השיעור המודרך\char`\"{}, ייתכן שעדיין תחשוב ש- \L{\LaTeX{}}
זה חומר גמיש, אבל לפחות תדע להשתמש ב- \L{\LyX{}}.\\
אם \emph{כבר} השתמשת בעבר ב- \L{\LaTeX{}}, עדיין כדאי שתקרא את \char`\"{}השיעור
המודרך\char`\"{}, החל מהחלק על \char`\"{}\L{\LyX{}} למשתמשי \L{\LaTeX{}}\char`\"{}
)לקרוא ברפרוף את שאר המסמך בוודאי לא יזיק(.\\
אם באיזשהו שלב תרגיש קצת \char`\"{}אבוד\char`\"{} בנוגע ל- \L{\LyX{}},
נסה לבדוק את \char`\"{}השיעור המודרך\char`\"{} לפני שתשקע בשאר המדריכים.
זהו קרש קפיצה מצויין.
\item [{המדריך~למשתמש~)\L{\emph{Guide}}~\L{\emph{User's}}(}] ~\\
 קובץ ההדרכה הראשי. כאן נכסה את \emph{רוב} הפעולות הבסיסיות והתכונות
המוצעות ב- \L{\LyX{}}. \char`\"{}המדריך למשתמש\char`\"{} יוצא מנקודת
הנחה שקראת את \char`\"{}השיעור המודרך\char`\"{} קודם לכן.
\item [{תכונות~נוספות~)\L{Additional~Features}(}] ~\\
הרחבה של \char`\"{}המדריך למשתמש\char`\"{}. פה יש תיעוד של פקודות
\L{\LaTeX{}} גולמיות, מחלקות נוספות, ואפשרויות עריכה מיוחדות. כמו
כן, הוא מכיל חלק מה\char`\"{}טריקים\char`\"{} )קצת מוזרים, אבל מגניבים(,
של אמני ה- \L{\LaTeX{}}.
\item [{התאמה~אישית~)\L{\emph{Customization}}(}] \textbf{~}\\
 תיאור של תכונות מתקדמות ב- \L{\LyX{}}, כולל התאמה אישית של ההתנהגות
של \L{\LyX{}}. זאת אומרת שכאן יש דברים כמו מערכות של מקשי קיצור,
הפיכת התוכנה לבין לאומית )\L{Internationalization}(, וקבצי הגדרות.
אל תעלה על דעתך להגיע הנה לפני שתקרא את \char`\"{}השיעור המודרך\char`\"{}.
\item [{תצורת~\L{\LaTeX{}}~)\L{\LaTeX{}~configuration}(}] ~\\
\L{\LyX{}} בוחן את המחשב שלך בזמן ההתקנה. קובץ זה מכיל את מה ש-
\L{\LyX{}} מצא בנוגע להתקנה. בדוק אותו כדי לראות אם אתה מחסיר משהו
שייתכן ותצטרך.
\end{description}
מסמכים אלו יפנו אחד אל השני במידת הצורך. לדוגמא, \char`\"{}המדריך
למשתמש\char`\"{} מכיל קצת מידע על ההתקנה והתאמה של \L{\LyX{}}, אך
יפנה את הקורא למדריך \char`\"{}התאמה אישית\char`\"{} למידע נוסף.

נדגיש פעם נוספת נקודה חשובה:

\bigskip{}

\hfill{}אם אתה חדש ל- \L{\LyX{}}, קרא את \char`\"{}השיעור המודרך\char`\"{}
עכשיו.\hfill{}

\bigskip{}

אחרת, סתם תייגע את עצמך. \L{\LyX{}} עושה כל מה שאתה צריך שמעבד תמלילים
יעשה, אבל משתמש לשם כך בגישה שונה.

\section{\label{=0005E4=0005E8=0005E7:=0005EA=0005E8=0005D5=0005DE=0005D4}תרומה
לפרוייקט \L{\protect\LyX{}}}

\subsection{תרומה ל- \L{\protect\LyX{}}}

\L{\LyX{}} כתוב ברובו ב- \L{C++}. זהו פרוייקט גדול, וכתוצאה מכך
אינו חופשי מתקלות, או מהצורך בשיפורים בקוד המקור.

\subsubsection{דיווח על תקלה}

תוך כדי השימוש ב- \L{\LyX{}}, ייתכן ותמצא התנהגות מסויימת שתחשוב
שהיא לקויה. קריסות, למרות שהן נדירות, קורות. בעיות בממשק המשתמש נחשבות
לתקלות חמורות על ידי קבוצת ליקס: לקבוצה עוזרות בייחוד אינדיקציות עלחלקים
מהממשק שהם מבלבלים או אינם ברורים.

ל- \L{\LyX{}} יש מערכת עקיבה אחר תקלות )באגים(, אותה תוכל למצוא בכתובת
\L{\url{http://www.lyx.org/trac/wiki/BugTrackerHome}}. אתה אמור לבדוק
במערכת התקלות לפני דיווח על תקלה, ולראות האם היא כבר נמצאת שם. אם
יש לך הערה כלשהי על בעיה קיימת, או אם אתה רוצה לדווח על תקלה חדשה,
אתה יכול להשתמש במערכת התקלות, או לשלוח דוא\char`\"{}ל לרשימת הדיוור
של המפתחים: \L{\url{lyx-devel@lists.lyx.org}}. קישור לארכיון ההודעות
נמצא באתר הראשי של \L{\LyX{}}: \L{\url{http://www.lyx.org}}.

דיווח טוב )שימושי( על תקלה יכיל לכל הפחות את הגרסה של ליקס בה נתגלתה
הבעיה. תיאורים מדוייקים ומפורטים עדיפים \L{–} ככל שהמפתחים משקיעים
זמן רב יותר בלזהות את מקור התקלה, כך נותר להם פחות זמן לשיפורים אחרים.
ציין את מערכת ההפעלה ואת גרסתה. מסור את הגרסאות של הספריות השונות
המותקנות על המחשב ובמידת הצורך את הגרסאות של תוכנות חיצוניות בשימושו
של \L{\LyX{}}. אם הבעיה היא בעיית הידור )קומפילציה( או בעיה בהגדרות,
צרף את הקובץ \L{\texttt{config.log}}, וציין באיזה מהדר )קומפיילר(
אתה משתמש.

אם הצלחת לגרום ל- \L{\LyX{}} לקרוס, אנא טרח ליצר \L{backtrace} בעזרת
גרסת \L{\LyX{}} שאינה \L{stripped}. כברירת מחדל, קובץ ה- \L{\LyX{}}
בתיקיית המקור מכיל מידע ל- \L{debugging}, בעוד הגרסה המותקנת היא \L{stripped},
כלומר אינה כוללת מידע זה. לפיכך, הרץ את \L{\LyX{}} מתוך \L{gdb} בעזרת
הקלדת הפקודה, לדוגמא, \L{\texttt{gdb~/users/steve/1.2.0pre4/src/lyx}}
ולאחר מכן \L{\texttt{run}}. גרום ל- \L{\LyX{}} לקרוס ואז תחזור ל-
\L{\texttt{gdb}}. הפקודה \L{\texttt{bt}} תייצר \L{backtrace}. הוסף
אותו לדיווח התקלה\footnote{אם ברצונך להיות יסודי, השתמש בפקודות \L{\texttt{info locals}} ו- \L{\texttt{up}}
כדי להדפיס את הערכים של המשתנים המקומים בכמה רמות של המחסנית.}. במידת האפשר, תיאור של איך ניתן לגרום לתקלה עדיף על פני \L{backtrace}
מפני שהוא יאפשר לנו ליצור את ה- \L{backtrace} בעצמנו. אם קשה לשחזר
את התקלה, ה- \L{backtrace} הוא חיוני, מפני שזה כל מה שיש בידינו.

\subsubsection{תרומת תיקונים ותכונות חדשות}

אם ביצעת שינויים לקוד המקור של \L{\LyX{}} ואתה חושב שהם צריכים להפוך
לחלק בלתי נפרד מ- \L{\LyX{}}, שלח את שינוייך בתור קובץ \L{diff} )\L{unified}(
אל רשימת הדיוור של המפתחים הרשומה למעלה, ביחד עם רשימת השינויים שביצעת
ותיאור של מה שהטלאי )\L{patch}( שלך עושה.

\subsection{תרומה לתיעוד}

התיעוד של \L{\LyX{}} הוא נרחב; אף על פי כן, \L{\LyX{}} הוא תחת פיתוח
מתמיד, וכל מהדורה חדשה שלו מוסיפה אפשרויות נוספות. ייתכן ותמצא כמה
מקבצי התיעוד שזקוקים לשיפור. חלק זה מתאר מה אתה צריך לעשות במידה ותמצא
טעות, או שיהיו לך הצעות כלשהן לשיפור התיעוד.

\subsubsection{דיווח על טעויות במדריכים}

אם אתה מוצא שגיאה או טעות כלשהי בתיעוד, שלח הודעה לרשימת הדיוור \L{\url{lyx-docs@lists.lyx.org}}.
צוות התיעוד יבצע את השינויים הדרושים.

\subsubsection{הצטרפות לצוות התיעוד}

פרוייקט התיעוד של \L{\LyX{}}, כמו כל דבר אחר בפרוייקט \L{\LyX{}},
תמיד יכול להעזר בעוד משתמש עם רצון טוב! אם אתה מעוניין לתרום לפרוייקט
התיעוד, משימתך הראשונה היא:
\begin{enumerate}
\item השג את קוד המקור העדכני. פתח אותו\footnote{ניתן להשיג את התיעוד הכי עדכני ממאגר ה- \L{CVS} של ליקס באופן אנונימי
\L{–} התיעוד נמצא במודול ה- \L{\texttt{lyxdoc}}.}. בתוכו תמצא תיקיה הנקראת \L{\texttt{lib/doc/}}.
\item לאחר מכן, קרא את \char`\"{}השיעור המודרך\char`\"{} ואת \char`\"{}המדריך
למשתמש\char`\"{}.\\
המטרה של תרגיל זה היא להעניק לך רעיונות. \char`\"{}השיעור המודרך\char`\"{}
ו\char`\"{}המדריך למשתמש\char`\"{} הם כנראה המעודכנים ביותר מבין קבצי
התיעוד. בעזרתם תוכל לקבל את התובנה של כיצד אנו מעוניינים שהמדריכים
יראו וגם כיצד אנחנו רוצים שהם יקראו.
\item צור קשר עם הצוות:\\
\L{\url{lyx-docs@lists.lyx.org}}\\
על מנת לדון בשינויים המוצעים ולקבל משוב עליהם.
\end{enumerate}
השינויים אותם אתה מציע, יכולים להיות כל דבר החל משיפור הבהירות של
הטקסט ועד לכתיבה מחדש של חלקים נרחבים מהתיעוד. כל שיפור יתקבל בשמחה.
\end{document}
