כלים של משתמש

כלים של אתר


ויקי:תחביר

תחביר

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

תחביר בסיסי

דוקו-ויקי תומך בטקסט מודגש, נטוי, מסומן בקו תחתון ומוקטן. ניתן גם לשלב בין ההדגשים.

דוקו-ויקי תומך בטקסט **מודגש**, //נטוי//, __מסומן בקו תחתון__ ו''מוקטן''.
ניתן גם **__//''לשלב''//__** בין ההדגשים.

ניתן גם להשתמש ב טקסט תחתון וגם בטקסט עליון.

ניתן גם להשתמש ב<sub> טקסט תחתון</sub> וגם ב<sup>טקסט עליון</sub>.

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

הנה טקסט עם שבירת שורות
שימו לב שהקווים האלכסוניים מזוהים רק בסוף שורה
או על ידי רווח אחריהם
אבל אם אין רווח \\הם לא יזוהו

הנה טקסט עם שבירת שורות \\ שימו לב שהקווים האלכסוניים מזוהים רק בסוף שורה\\
או על ידי רווח  אחריהם\\ אבל אם אין רווח \\הם לא יזוהו 

קישורים

דוקו-ויקי תומך במגוון דרכים ליצירת קישורים.

חיצוניים

דוקו-ויקי מזהה קישורים חיצוניים לבד: http://www.google.com , או פשוט www.google.com - אפשר להוסיף גם טקסט לקישור: הקישור הזה מצביע על גוגל. כתובות דואר אלקטרוני כמו למשל andi@splitbrain.org מזוהים גם הם.

דוקו-ויקי מזהה קישורים חיצוניים לבד: http://www.google.com , או פשוט www.google.com -
אפשר להוסיף גם טקסט לקישור: [[http://www.google.com| הקישור הזה מצביע על גוגל]].
כתובות דואר אלקטרוני כמו למשל <andi@splitbrain.org> מזוהים גם הם.

פנימיים

יצירת קישורים פנימיים מתבצעת על-ידי שני סוגריים מרובעים. אפשר פשוט לתת את שם דף או להוסיף טקסט נוסף.

יצירת קישורים פנימיים מתבצעת על-ידי שני סוגריים מרובעים.
אפשר פשוט לתת את [[שם דף]] או להוסיף [[שם דף | טקסט נוסף]].

יצירת קישור לחלק מסוים בדף מתבצעת על ידי כתיבת שם הדף והוספת # עם הכותרת הרצויה. למשל תחביר בסיסי או משמעות השם מידברן.

יצירת קישור לחלק מסוים בדף מתבצעת על ידי כתיבת שם הדף והוספת # עם הכותרת הרצויה.
למשל [[תחביר#תחביר בסיסי]] או [[:מידברן#משמעות השם | משמעות השם מידברן]].

אפשר ליצור תיקיות משנה על-ידי נקודותיים.

אפשר ליצור [[ויקי:תיקיות משנה]] על-ידי נקודותיים.

מידע נוסף אפשר למצוא ב- wiki:namespaces

הערות:

  • קישורים לדפים קיימים מוצגים אחרת מדפים לא קיימים.
  • דוקו-ויקי אינו תומך ב- CamelCase ליצור קישורים.
  • יש צורך בכתיבת הנתיב המלא לדף (להשתמש בנקודתיים לציון תיקיות) במקרה בו הדף המפנה והדף אליו מפנים נמצאים בתיקיות שונות.

בין וויקים

דוקו-ויקי תומך בקישורים ביו-ויקים. כלומר קישורים מהירים לויקים אחרים. לדוגמא הנה קישור לויקיפדיה האנגלית שמסביר את משמעות המילה Wiki.

דוקו-ויקי תומך בקישורים ביו-ויקים.
כלומר קישורים מהירים לויקים אחרים. לדוגמא הנה קישור לויקיפדיה האנגלית שמסביר את משמעות המילה [[wp>Wiki]].

קישור שהוא תמונה

יש אפשרות ליצור קישור שהוא תמונה בצורה הבאה:

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

הערות שוליים

ניתן להוסיף הערות שוליים 1) בסוף הדף על-ידי שימוש בסוגריים כפולות.

ניתן להוסיף הערות שוליים ((זאת הערת שוליים)) בסוף הדף על-ידי שימוש בסוגריים כפולות.

כותרות

קיימות 5 רמות שונות של כותרות. אם בדף יש יותר משלוש כותרות יתווסף אוטומטית תוכן עניינים לדף. ניתן לבטל את תוכן העניינים על-ידי הצבת המחרוזת ~~NOTOC~~ בדף.

כותרת רמה 3

כותרת רמה 4

כותרת רמה 5
==== כותרת רמה 3 ====
=== כותרת רמה 4 ===
== כותרת רמה 5 ==

חוצץ

אפשר ליצור חוצץ (קו אופקי) בעזרת 4 מקפים.

 ----

תמונות וקבצים נוספים

ניתן להוסיף תמונות פנימיות וחיצוניות נוספות על-ידי סוגריים מסולסלות. ניתן גם לכלול את גודל התמונה.

גודל מקורי

תמונה עם שינוי הגודל האופקי

שינוי כל מימדי התמונה

שינוי מימדי תמונה חיצונית

גודל מקורי {{wiki:dokuwiki-128.png}}
תמונה עם שינוי הגודל האופקי {{wiki:dokuwiki-128.png?50}}
שינוי כל מימדי התמונה {{wiki:dokuwiki-128.png?200x50}}
שינוי מימדי תמונה חיצונית {{http://de3.php.net/images/php.gif?200x50}}

על-ידי שימוש ברווחים בתוך הסוגריים בצד ימין או שמאל ניתן לבחור את יישור התמונה:

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

ניתן גם להוסיף טקסט לתמונה (העביר/י את הסמן מעל התמונה לצפות בטקסט):

 זה הסבר נוסף לתמונה

{{ wiki:dokuwiki-128.png | זה הסבר נוסף לתמונה}}

אם סיומת לא תהיה סיומת תמונה (gif,jpeg,png) הקובץ ייווצר כקישור.

ניתן גם להוסיף מסגרת לתמונה עם כיתוב מתחתיה על-ידי שימוש בסוגריים מרובעים:

כיתוב לתמונה
[{{ wiki:dokuwiki-128.png | כיתוב לתמונה}}]

רשימות

דוקו-ויקי תומך ברשימות ממוספרות ורשימות לא ממוספרות. שני רווחים ו* לרשימה לא ממוספרת או - לרשימה ממוספרת:

  • זו רשימה.
  • איבר שני ברשימה.
    • אפשר להוסיף רמות שונות.
  • עוד נקודה.
  1. אותה רשימה רק ממוספרת.
  2. עוד איבר.
    1. רק להראות רמות שונות ברשימה.
  3. וזהו זה.
  *זו רשימה.
  *איבר שני ברשימה.
    *אפשר להוסיף רמות שונות.
  *עוד נקודה.

  -אותה רשימה רק ממוספרת.
  -עוד איבר.
    -רק להראות רמות שונות ברשימה.
  -וזהו זה.

מחוות

דוקו-ויקי תומך בתרגום מחוות לגרסאות הגרפיות שלהם:

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME
  • DELETEME DELETEME

המרת תווים מיוחדים

דוקו-ויקי מסוגל לתרגם מחרוזות תווים לסימן הטקסט שאותה הם מייצגים.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480

“למה שאני כותב משהו פשוט המחשב אומר לי 'אתה כתבת משהו הרבה יותר מסובך'…”

-> <- <-> => <= <=> >> << -- --- 640x480

"למה שאני כותב משהו פשוט המחשב אומר לי 'אתה כתבת משהו הרבה יותר מסובך'..."

ציטוטים

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

אני חושב שאנחנו צריכים לעשות את זה

> לא אנחנו לא צריכים

>>וכן, אני חושב שאנחנו צריכים

> באמת?

>>כן!

>>> בוא נעשה את זה!

אני חושב שאנחנו צריכים לעשות את זה

לא אנחנו לא צריכים
וכן, אני חושב שאנחנו צריכים
באמת?
כן!
בוא נעשה את זה!

טבלאות

דוקו-ויקי תומך בתחביר פשוט ליצירת טבלאות:

כותרת 1 כותרת 2 כותרת 3
שורה1 תא1 שורה1 תא2 שורה1 תא3
שורה2 תא1 שורה2 תא2 (קצת חיבור)
שורה3 תא1 שורה3 תא2 שורה3 תא3
כלי ליצירת טבלאות ריקות או עם נתונים קיימים Markdown Tables Generator

כדי ליצור טבלה צריך להתחיל ולסיים עם | , בשביל כותרות צריך להתחיל את התא עם ^ .

^  כותרת 1  ^  כותרת 2  ^  כותרת 3  ^
| שורה1 תא1 | שורה1 תא2 | שורה1 תא3 |
| שורה2 תא1 | שורה2 תא2 (קצת חיבור)||
| שורה3 תא1 | שורה3 תא2 | שורה3 תא3 |

כדי ליצור טבלאות עם עמודה ראשונה מודגשת פשוט צריך ליצור תא ריק ראשון:

כותרת 1 כותרת 2
כותרת 3 שורה1 תא2 שורה1 תא3
כותרת 4 שורה2 תא2 שורה2 תא3
כותרת 5 שורה3 תא2 שורה3 תא3

קל לזהות את סוג התא לפי תו שקודם לו.

|           ^  כותרת 1  ^  כותרת 2  ^
^ כותרת 3   | שורה1 תא2 | שורה1 תא3 |
^ כותרת 4   | שורה2 תא2 | שורה2 תא3 |
^ כותרת 5   | שורה3 תא2 | שורה3 תא3 |

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

טבלה עם יישור
שמאל מרכז ימין
מרכז ימין שמאל
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

כך נראה המקור:

^                 טבלה עם יישור            ^^^
|          שמאל|     מרכז     |ימין          |
|    מרכז      |ימין          |          שמאל|
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

טקסט לא מעוצב ושורות קוד

ניתן להוסיף שורות קוד בקוביות שלא יעברו עיבוד לסימונים בדף. אפשר לעשות זאת בעזרת יותר משני רווחים לפני תחילת השורה, או בעזרת תגיות <code> או <file>.

כאן אפשר לראות שכל הרווחים נשמרים                   <- בצורה כזו
התגית הזו מבצעת אותה פעולה אבל היא מציגה את הטקסט מימין לשמאל ולא משמאל לימין.

אם יש צורך להציג טקסט בדיוק כפי שנרשם אפשר להשתמש בתגית <nowiki>, או בסימני אחוזים כפולים %%.

זה איזור בטקסט שמכיל קישורים לדוגמא http://www.splitbrain.org או **הדגשים**. אבל הויקי לא משנה אותו.

<nowiki>
זה איזור בטקסט שמכיל קישורים לדוגמא http://www.splitbrain.org או **הדגשים**.
אבל הויקי לא משנה אותו.
</nowiki>

וידאו

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

{{videosite>videoid?size|title}}

לדוגמה, להוספת סרט וידאו שכתובתו ב- YouTube https://www.youtube.com/watch?v=5pUTKNGpu1s יש להשתמש בקוד הבא:

{{youtube>5pUTKNGpu1s?medium|Burning Man 2013}}

להוספת וידאו מאתרים אחרים ולהסבר מפורט על אפשרויות עיצוב וידאו, יש לפנות לכאן: https://www.dokuwiki.org/plugin:vshare

להוספת קישור לנקודת זמן מסוימת בקטע וידאו, קיימת אפשרות מובנית ב-YouTube
שימו לב - קישור כזה לא יעבוד עם הקוד להטמעה כפי שמופיע לעיל

הטמעת טקסט באנגלית

בכדי לסמן טקסט כטקסט באנגלית ולגרום למערכת לעמד אותו כפי צריך, ניתן להשתמש בתגים <WRAP :en></WRAP>

English text, aligned to the left.

<WRAP :en>
English text, aligned to the left.
</WRAP>

הוספת מסגרות

ניתן להוסיף מסגרות לטקסט ולסמן אותו כטקסט חשוב, כטקסט אזהרה ועוד. ישנן מספר רב של אפשרויות אשר מפורטות כאן: https://www.dokuwiki.org/plugin:wrap

אפשרויות עיצוב נוספות

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

הרחבות שהותקנו במערכת ומוסיפות אפשרויות עיצוב נוספות:

1) זאת הערת שוליים
ויקי/תחביר.txt · מועד השינוי האחרון: 2015/04/16 12:41 (עריכה חיצונית)