עזרה:קוד מקור
קפיצה לניווט
קפיצה לחיפוש
דף זה מסביר כיצד ניתן לעצב ולהציג קוד מקור של תוכנה.
תג syntaxhighlight (או source)
השימוש בתגי syntaxhighlight נוח במיוחד בעת הצגת קוד מקור בשפות מחשב שונות. להלן אופן השימוש:
<syntaxhighlight lang="text">
טקסט
</syntaxhighlight>
כאשר את המילה "טקסט" ניתן להחליף בזיהוי השפה. לדוגמה:
| קוד ויקי | תוצאה |
|---|---|
<syntaxhighlight lang="csharp">
// Hello World program in Microsoft C#
using System;
class HelloWorld
{
public static int Main(String[] args)
{
Console.WriteLine("Hello, World!");
return 0;
}
}
</syntaxhighlight>
|
// Hello World program in Microsoft C#
using System;
class HelloWorld
{
public static int Main(String[] args)
{
Console.WriteLine("Hello, World!");
return 0;
}
}
|
| רשימת השפות הנתמכות |
|---|
שפות תכנות
שפות תבניות
סוגי מרקאפ אחרים
|
הערות
- במידה ונעשה שימוש בשפה לא קיימת או פרמטר lang חסר, הדף ישויך אוטומטית לקטגוריה:דפים עם שגיאות בצביעת קוד.
- התג
<syntaxhighlight>נכנס לשימוש לאחרונה. עד כה היה שימוש זהה בתג<source>, אך הוא עובר מן העולם מכיוון שניתן להתבלבל בקלות בין</source>של צביעת קוד, לתג זהה בתוך הקוד, למשל בשפת html. - ניתן להוסיף צביעה באמצעות כפתור
. - שפת הוויקי לא נתמכת. אם הטקסט כולל תגים (למשל,
<div>), ניתן להשתמש בשפת html, אחרת מומלץ להשתמש בשפת text.
עיצוב תגי syntaxhighlight
בנוסף לפרמטר lang שבו נעשה שימוש לעיל, לתגי syntaxhighlight מספר פרמטרים נוספים:
- פרמטר line: הוספת הפרמטר (בלי ערך) מוסיפה מספרי שורות לכל שורה. למשל,
| קוד ויקי | תוצאה |
|---|---|
<syntaxhighlight lang="csharp" line>
class HelloWorld
{
public static int Main(String[] args)
{
Console.WriteLine("Hello, World!");
return 0;
}
}
</syntaxhighlight>
|
class HelloWorld
{
public static int Main(String[] args)
{
Console.WriteLine("Hello, World!");
return 0;
}
}
|
- פרמטר start: בעת השימוש בפרמטר line לעיל, ניתן להשתמש גם בפרמטר start לציון מספר השורה הראשונה. למשל, ניתן להתחיל את המספור בספרה 6, והשורות הבאות יהיו 7, 8 וכולי.
- פרמטר highlight: הדגשת שורה אחת מתוך כלל הקוד. למשל, העברת הספרה "4" בפרמטר זה תוסיף הדגשה כתומה לשורה הרביעית (בלי קשר למספר שנקבע בפרמטר start).
| קוד ויקי | תוצאה |
|---|---|
<syntaxhighlight lang="csharp" line start=33 highlight="1,4,8">
class HelloWorld
{
public static int Main(String[] args)
{
Console.WriteLine("Hello, World!");
return 0;
}
}
</syntaxhighlight>
|
class HelloWorld
{
public static int Main(String[] args)
{
Console.WriteLine("Hello, World!");
return 0;
}
}
|
- פרמטר inline מאפשר שילוב הקוד בתוך הטקסט. למשל, הקוד
<syntaxhighlight lang=java inline>return a.b[35] + 114</syntaxhighlight>ישלב את הטקסטreturn a.b[35] + 114בתוך השורה. במקרה כזה פרמטר line לא יעבוד, ופרמטר highlight ימנע את ההכנסה התקינה לתוך השורה. כדאי לשקול שימוש בפרמטר|class=nowrap, למשל<syntaxhighlight lang=java inline class=nowrap>return a.b[35] + 114</syntaxhighlight>. זה ימנע את שבירת הקוד לשתי שורות במידה ואין מספיק מקום, ויתחיל במקרה כזה הישר בשורה החדשה. - ניתן להוסיף פרמטרים רגילים של שפת html, למשל style או class (ראו דוגמה בסעיף הקודם).
תגי code
כאשר עולה הצורך להציג קוד מקור בגוף הטקסט (ולא בשורה חדשה), רצוי להבליט את הקוד ולהבדילו מהטקסט עצמו. ניתן לעשות זאת באמצעות תגי code. להלן אופן השימוש:
<code>טקסט</code>
השורה הנ"ל עצמה מוקפת בתגי קוד וניתן להבחין בשינוי הגופן וברקע האפרפר.
ניתן לשלב תגי code עם תגי nowiki כאשר עולה הצורך להציג קוד ויקי. למשל, הקוד
- "ניתן להוסיף קישורים לערכים באופן הבא: <code><nowiki>[[קישור]]</nowiki></code>".
יביא לתוצאה הבאה:
- "ניתן להוסיף קישורים לערכים באופן הבא:
[[קישור]]".
שימו לב שתגי nowiki הם הפנימיים, ומחוצה להם יש תגי code.
- ראו גם
- חלופה לתגי code: תבנית {{קוד}}
קישורים חיצוניים
- ההרחבה SyntaxHighlight GeSHi, המאפשרת שימוש בתגי syntaxhighlight (מוטמעת בתוך MediaWiki).
