Advanced Use of Markdown

קטע זה מרחיב על המידע הבסיסי הניתן בכותרת הקטע 'Enhancing Text With Markdown' בכדי להעניק לאלו בעלי הדרישות המיוחדות את המידע ההנצרך בכדי לקיים את ה-Markdown. אם אינך מכיר זאת, או אין לך צורך בכך, את תבנית הרשימה הנמצאת למטה תוכל לדלג על קטע זה ולחזור אליו כשתצטרך זאת.

Line Breaks

בכמה טקסטים , למשל בשירה ופיוטים, בד"כ רצוי להכניס שורות חדשות. כאשר תנסה לעשות זאת עם מקש החזרה לא תינתן לך אותה תוצאה כך שכברירת מחדל השורות יראו מחוברות לשם יצירת פיסקה.

The best laid schemes o' Mice an' Men,
Gang aft agley,
An' lea'e us nought but grief an' pain,
For promis'd joy!

The above input, using the enter key to insert line breaks will give the following output as such breaks are ignored:

The best laid schemes o' Mice an' Men, Gang aft agley, An' lea'e us nought but grief an' pain, For promis'd joy!

But by ending each line with two spaces you can force a line break as follows:

The best laid schemes o' Mice an' Men,
Gang aft agley,
An' lea'e us nought but grief an' pain,
For promis'd joy!

Horizontal Rules

Horizontal rules יכול להיווצר ע"י הכנסת שלושה כוכביות (*) או יותר, מקף (-) או מקף תחתון (_) בשורה ביחידות.

הדבר הבא יעבוד:

***

.אך תוכל להוסיף רווחים או תווים נוספים להיראות יותר כמו קו הפרדה בחלון עריכת הטקסט למשל:

* * * * *

-------------------------

_ _ _ _ _

כל שיטות אלו נותנות את אותה תוצאה בדיוק.


קישור היפרטקסט עבור תמונות

מסמך ה-Enhancing Text With Markdown מקנה הקדמה עבור יצירת קישורי רשת והכנסת תמונות. פעולות אלו עדיין לא ברורות כאשר רוצים לשלבם יחד בכדי ליצור תמונות אשר משמשות גם כקישור וניתן ללחוץ עליהן.

[the google search engine][google]

![the google logo][logo]

כאן קיים קישור רשת ותמונה רגילים,. כאשר מרווחים תמונה כאשר טקסט הקישור נמצא נראה את הדבר הבא:

[![the google logo][logo]][google]

השורה למעלה, בשילוב עם הקישורים הבאים במקום אחר במסמך

[logo]: http://www.google.com/images/logo.gif
[google]: http://www.google.com/ "click to visit Google.com"

אחד בכדי להציג את תמונת הקישור הבאה הניתנת ללחיצה (ע"י tooltip אם תרחף מעליה):

the google logo

דוגמה היכן טכניקה זו שימושית ניתן למצוא בקישור לתמונות קטנות וממוזערות ('thumbnail') אשרמורידות דרכן את אותן תמונות גדולות יותר.

שיבוץ HTML

אם הינך מיומן עם Html יתכן שיהיו קיימים מקרים אשר ה-Markdown לא תאפשר לך שליטה רבה כפי שהיית רגיל אליה. למרבה המזל Markdown מיועדת לאפשרות זו ומאפשרת לך לשבץ HTML ישירות במסגרת Markdown formatetd text.

* <small>small text</small>
* <big>big text</big>

  • small text
  • big text

דע כי תגי ה-HTML

Displaying HTML or Preformatted Text

If, unlike in the section above, you wish the HTML you enter to be displayed exactly as you typed it, rather than processed as HTML then you can start each line with four space characters.

<p>A paragraph in <b>HTML</b> displayed as code</p>

This also works for displaying computer code:

print "Command-line arguments: (@ARGV)\n";

As this formatting is often used for computer program listings and other text which may plausibly contain the characters that Markdown uses to indicate different types of formatting, Markdown's formatting is switched off for these lines:

Normally this word would be **bold**.

To include such characters within normal text, see the section below.

Using Special Characters

If you wish to use any of the special characters that trigger Markdown formatting without them being processed simply precede them with a backslash character (\). This is known as 'escaping' a character. The backslash is not displayed but the character immediately following it is shown, exactly as entered.

\*asterisks, not emphasis\*

becomes

*asterisks, not emphasis*

rather than

*emphasis, not asterisks*

which gives

emphasis, not asterisks

Further Reading

The Markdown system is not unique to Moodle, it is used in an ever increasing number of web publishing tools. You can find out more about it at http://daringfireball.net/projects/markdown/

אינדקס של כל קבצי העזרה