Commits

shl...@52c325ad-5fd0-0310-8a0f-c43feede02cc  committed 6f18495

Added the explanation of the full XHTML example.

  • Participants
  • Parent commits e606ebd

Comments (0)

Files changed (2)

File hebrew-html-tutorial/Render-TT2-to-Docbook.pl

 EOF
 }
 
+sub start_tag
+{
+    my $id = shift;
+
+    return qq{<code xml:lang="en">&lt;$id&gt;</code>};
+}
+
+sub end_tag
+{
+    my $id = shift;
+    return start_tag("/$id");
+}
+
 my $vars =
 {
     embed_sample => \&embed_sample,
+    stag => \&start_tag,
+    etag => \&end_tag,
 };
 
 $tt->process(

File hebrew-html-tutorial/hebrew-html-tutorial.xml.tt

             </imageobject>
         </mediaobject>
 
+        <para>
+            עכשיו למספר הסברים בנוגע לדוגמה:
+        </para>
+
+        <orderedlist>
+
+            <listitem>
+                <para>
+                    הצהרת ה-"DOCTYPE" בהתחלה מצהירה שסוג המסמך הוא
+                    "XHTML 1.0 Transitional". יש לשם הצהרה כזאת בהתחלה
+                    כדי שאפשר יהיה לזהות על פי איזה תקן המסמך נכתב.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    ניתן להבחין שמהסמך מתחיל מתגית פתיחה [% stag("html") %]
+                    ומסתיים בתגית [% etag("html") %]
+                    במסמך XML יש לכלול את כל התוכן בתוך תגית פתיחה ותגית
+                    סיום. במקרה של מסמך HTML מדובר בתגית
+                    [% stag ("html") %].
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    לתגית [% stag("html") %] מקבלת מספר תכונות. הראשונה שבהן
+                    היא "xmlns" המצהירה על מרחב-השמות של ברירת המחדל של המסמך.
+                    במסמכי XHTML ניתן לכלול מרחבי שמות אחרים, המאפשרים שילוב
+                    של תגיות של תחבירי XML אחרים. כרגע לא צריך להתעמק בזה
+                    יותר מדי.
+                </para>
+
+                <para>
+                    התכונות האחרות )"lang"( מצהירות על שפת המסמך, במקרה 
+                    שלנו אנגלית אמריקאית. ראוי לציין שכדאי שהן lang והן
+                    xml:lang תקבענה ביחד.
+                </para>
+
+            </listitem>
+            <listitem>
+                <para>
+                    האלמנט [% stag("head") %] מכיל כותר למסמך ומכיל
+                    מעט מטה-מידה הקשור אליו.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    האלמנט [% stag("title") %] שחייב להימצא בתוך
+                    [% stag("head") %] מכיל טקסט (מחוסר תיוג) המהווה
+                    כותרת למסמך - ניתן לראות שהוא מופיע בכותר החלון
+                    של הדפדפן.
+                </para>
+                <para>
+                    רצוי מאוד לתת כותרת בעלת משמעות למסמך כדי שאנשים ותוכניות
+                    מחשב (כמו מנועי חיפוש) יוכלו לדעת מייד מה תכליתו.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    מטרת תגית ה-[% stag("meta") %] המסוימת הזאת היא להצהיר
+                    שקידוד המסמך הוא "utf-8". יש שימושים אחרים לתגיות
+                    "meta" ואת חלקם נראה בהמשך.
+                </para>
+                <para>
+                    ניתן גם לראות שהקו הנטוי ("/") בסוף התגית אומר למפענח
+                    שהתגית סוגרת את עצמה. זה כמו לומר:
+                </para>
+<programlisting xml:lang="en">
+<![CDATA[
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
+]]>
+</programlisting>
+
+                <para>
+                אבל מאפשר תאימות טובה יותר לדפדפנים ישנים.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    האלמנט [% stag("body") %] מכיל את גוף הטקסט של המסמך
+                    ומה שיוצג למשתמש.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    האלמנט [% stag("h1") %] מכיל כותרת המוצגת בגוף הטקסט. יש
+                    גם את [% stag("h2") %], [% stag("h3") %] עד 
+                    [% stag("h6") %]. מומלץ לחלק את המסמך לחלקים על-ידי
+                    הכותרות כך שידעו מה משמעות כל חלק.
+                </para>
+            </listitem>
+        </orderedlist>
+
+        <para>
+            אז זה הכל! כעת בואו נכיר מספר תגים שימושיים נוספים.
+        </para>
     </section>
 
     </chapter>