עריכת הדף "עזרה:קוד מקור" (פסקה)

==תג syntaxhighlight (או {{כתב מחוק|source}})==
השימוש בתגי syntaxhighlight נוח במיוחד בעת הצגת קוד מקור בשפות מחשב שונות. להלן אופן השימוש:
{{ltr|
{{תג|syntaxhighlight|params=lang="text"|o}}

<code>טקסט</code>

{{תג|syntaxhighlight|c}}
}}
כאשר את המילה "טקסט" ניתן להחליף בזיהוי השפה. לדוגמה:

{| class="wikitable"
! קוד ויקי !! תוצאה
|-
| dir="ltr" |
<pre style="background-color: transparent; border: none;">
<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>
</pre>
|<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>
|}

{{טבלה מוסתרת|כותרת=רשימת השפות הנתמכות|תוכן={{רווח קל}}
=== שפות תכנות ===
{{ltr|{{רשימה אופקית|
* 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
}}}}
=== שפות תבניות ===
{{ltr|{{רשימה אופקית|
* Cheetah templates
* Django / Jinja templates
* ERB
* Genshi
* JSP
* Myghty
* Mako
* Smarty templates
* Tea
}}}}
=== סוגי מרקאפ אחרים ===
{{ltr|{{רשימה אופקית|
* 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|o}} נכנס לשימוש לאחרונה. עד כה היה שימוש זהה בתג {{תג|source|o}}, אך הוא עובר מן העולם מכיוון שניתן להתבלבל בקלות בין {{תג|source|c}} של צביעת קוד, לתג זהה בתוך הקוד, למשל בשפת html.
* ניתן להוסיף צביעה באמצעות כפתור {{כפתור|קוד}}.
* שפת הוויקי לא נתמכת. אם הטקסט כולל תגים (למשל, {{תג|div|פ}}), ניתן להשתמש בשפת html, אחרת מומלץ להשתמש בשפת text.

===עיצוב תגי syntaxhighlight===
בנוסף לפרמטר '''lang''' שבו נעשה שימוש לעיל, לתגי syntaxhighlight מספר פרמטרים נוספים:
* פרמטר '''line''': הוספת הפרמטר (בלי ערך) מוסיפה מספרי שורות לכל שורה. למשל,

{| class="wikitable"
! קוד ויקי !! תוצאה
|-
| dir="ltr" |
<pre style="background-color: transparent; border: none;">
<syntaxhighlight lang="csharp" line>
class HelloWorld
{
    public static int Main(String[] args)
    {
        Console.WriteLine("Hello, World!");
        return 0;
    }
}
</syntaxhighlight>
</pre>
|<syntaxhighlight lang="csharp" line>
class HelloWorld
{
    public static int Main(String[] args)
    {
        Console.WriteLine("Hello, World!");
        return 0;
    }
}
</syntaxhighlight>
|}
* פרמטר '''start''': בעת השימוש בפרמטר line לעיל, ניתן להשתמש גם בפרמטר start לציון מספר השורה הראשונה. למשל, ניתן להתחיל את המספור בספרה 6, והשורות הבאות יהיו 7, 8 וכולי.
* פרמטר '''highlight''': הדגשת שורה אחת מתוך כלל הקוד. למשל, העברת הספרה "4" בפרמטר זה תוסיף הדגשה כתומה לשורה הרביעית (בלי קשר למספר שנקבע בפרמטר start).

{| class="wikitable"
! קוד ויקי !! תוצאה
|-
| dir="ltr" |
<pre style="background-color: transparent; border: none;">
<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>
</pre>
|<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>
|}
* פרמטר '''inline''' מאפשר שילוב הקוד בתוך הטקסט. למשל, הקוד {{משמאל לימין|<code><nowiki><syntaxhighlight lang=java inline>return a.b[35] + 114</syntaxhighlight></nowiki></code>}} ישלב את הטקסט <syntaxhighlight lang="java" inline>return a.b[35] + 114</syntaxhighlight> בתוך השורה. במקרה כזה פרמטר line לא יעבוד, ופרמטר highlight ימנע את ההכנסה התקינה לתוך השורה. כדאי לשקול שימוש בפרמטר {{פרמטר|class|nowrap}}, למשל {{משמאל לימין|<code><nowiki><syntaxhighlight lang=java inline class=nowrap>return a.b[35] + 114</syntaxhighlight></nowiki></code>}}. זה ימנע את שבירת הקוד לשתי שורות במידה ואין מספיק מקום, ויתחיל במקרה כזה הישר בשורה החדשה.
* ניתן להוסיף פרמטרים רגילים של שפת html, למשל style או class (ראו דוגמה בסעיף הקודם).