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

עריכת ערכים

מדריכי עריכה

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

אחרים:

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

תג 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: תבנית {{קוד}}

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

עריכה