גירסה 0.1, 25-Jan-2003
מסמך זה נועד לעזור למתחילים להבין איך כותבים מסמכי LaTeX בעברית. הוא עדיין לא גמור
המסמך הראשון, minimal-doc.tex הוא מסמך מינימלי. רק עברית, (בלי שום אנגלית ומספרים).
1 \documentclass{article} 2 % Everything after an '%' is a remark, and ignored by TeX 3 \usepackage[hebrew]{babel} 4 5 \begin{document} 6 פסקה ראשונה: 1 7 8 % paragraphs are separated by an empty line: 9 פסקה שניה ואחרונה )באמת(. 10 \end{document}
כדי לקבל מהמסמך פלט קריא יש להריץ:
elatex minimal-doc.texהתוצאה תהיה הקובץ minimal-doc.dvi . כדי לקבל ממנו קובץ פוסטסקריפט:
dvips -o minimal-doc.ps minimal-doc.dviואם אתם רוצים ליצור מקובץ הפוסטסקריפט קובץ PDF:
ps2pdf minimal-doc.ps
נשים לב:
המסמך הבא, minimal-eng.tex, מדגים איך משלבים עברית ואנגלית במסמך אחד
1 \documentclass{article}
2 % There may be a number of languages. The main document language is
3 % the *last* of them
4 \usepackage[english,hebrew]{babel}
5
6 \begin{document}
7 כדי לכתוב משהו באנגלית חייבים להשתמש במקרו הבא: \L{Hello, world}. וכאן
8 ממשיכים לכתוב בעברית. טקסט נוסחאות תמיד יהיה בכיוון שמאל-לימין:
9 $a_1+a_{2}=c^{2}$ .
10
11 כעת נתחיל חלק באנגלית:
12
13 \begin{otherlanguage}{english}
14 Hello, World. Hebrew text inside English paragraph must come inside the
15 macro R: \R{בוקר טוב עולם}.
16
17 This is the preffered way to set the language.
18 \end{otherlanguage}
19
20 דרך אחרת לעבור לאנגלית:
21
22 \unsethebrew
23 Yet Another English Paragraph
24
25 And another paragraph
26 \sethebrew
27
28 פסקה שמינית ואחרונה )באמת(.
29 \end{document}
אם יש בעיה במסמך, latex יעצור ויבקש הסבר. בדרך-כלל בשלב זה אין מה לעשו, וצריך לעצור ע"י X או Ctrl-c. הודעות השגיאה של LaTeX הן די לא מובנות בהרבה מקרים. ננסה לתת דוגמאות לכמה מצבים בעייתיים נפוצים:
To avoid this error message, run TeX--XeT or e-TeX engine instead of regular TeX. ! Right-to-Left Support Error: use TeX--XeT or e-TeX engine. l.77 engine} %ההודעה הזו נגרמת בד"כ בגלל שהורצה הפקודה latex במקום הפקודה elatex. כל אחת מהפקודות הללו מריצה גרסה שונה במקצת של TeX, ותמיכה בסיסית בהיפוך עברית קיימת ב-e-TeX, אך לא ב-TeX הבסיסי.
! LaTeX Error: Command \hebresh unavailable in encoding OT1.)במקום \hebresh יכול להופיע שם אות עברית אחר.(. השגיאה הזו נגרמת בגלל שבקידוד הרגיל של תווי LaTeX אין תווים עבריים. צריכים לעבור למצב עברית (ע"י \R{} או ע"י הסביבה otherlanguage) כדי שתווים עבריים יזוהו.