עזרה:קוד מקור

עריכת ערכים

מדריכי עריכה

שילוב מרכיבים בדף:

אחרים:

דף זה מסביר כיצד ניתן לעצב ולהציג קוד מקור של תוכנה.

תג 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;
    }
}

רשימת השפות הנתמכות
שפות תכנות [עריכת קוד מקור] ActionScript Ada ANTLR AppleScript Assembly Asymptote Awk Befunge Boo BrainFuck C / C++ C# Clojure CoffeeScript ColdFusion Common Lisp Coq Cryptol Crystal Cython D Dart Delphi Dylan Elm Erlang Ezhil Factor Fancy Fortran F# GAP Gherkin (Cucumber) GL shaders Groovy Haskell IDL Io Java JavaScript Lasso LLVM Logtalk Lua Matlab MiniD Modelica Modula-2 MuPad Nemerle Nimrod Objective-C Objective-J Octave OCaml PHP Perl PovRay PostScript PowerShell Prolog Python 2.x and 3.x REBOL Red Redcode Ruby Rust S, S-Plus and R Scala Scheme Scilab Smalltalk SNOBOL Tcl Vala Verilog VHDL Visual Basic.NET Visual FoxPro XQuery Zephir שפות תבניות [עריכת קוד מקור] Cheetah templates Django / Jinja templates ERB Genshi JSP Myghty Mako Smarty templates Tea סוגי מרקאפ אחרים [עריכת קוד מקור] Apache config files Bash shell scripts BBCode CMake CSS Debian control files Diff files DTD Gettext catalogs Gnuplot script Groff markup HTML HTTP sessions INI-style config files IRC logs (irssi style) Lighttpd config files Makefiles MoinMoin/Trac Wiki markup MySQL Nginx config files POV-Ray scenes Ragel Redcode ReST Robot Framework RPM spec files SQL Squid configuration TeX tcsh Vim Script Windows batch files XML XSLT YAML

הערות

במידה ונעשה שימוש בשפה לא קיימת או פרמטר 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).

תג syntaxhighlight (או source)

שפות תכנות

שפות תבניות

סוגי מרקאפ אחרים

הערות

עיצוב תגי syntaxhighlight

תגי code

קישורים חיצוניים