Hilfe:Quelltexte: Unterschied zwischen den Versionen

161 Bytes hinzugefügt ,  23:58, 11. Feb. 2022
keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(4 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 5: Zeile 5:


; code
; code
: <code>code</code> kann benutzt werden um Textabschnitte als Quelltext auszuzeichnen und entsprechend zu formatieren. <code>code</code> Ist vor allem dazu geeignet, kurze Quelltextausschnitte (nur einzelne oder wenige Wörter) innerhalb von Fließtexten auszuzeichnen.  
: <code>code</code> kann benutzt werden, um Textabschnitte als Quelltext auszuzeichnen und entsprechend zu formatieren. <code>code</code> ist vorwiegend dazu gedacht, kurze Quelltextausschnitte (nur einzelne oder wenige Wörter) innerhalb von Fließtexten auszuzeichnen.  
{| {{exampletable}}
{| {{exampletable}}
| <<nowiki>code></nowiki>public void halloWelt()<nowiki></code</nowiki>>
| <<nowiki>code></nowiki>public void halloWelt()<nowiki></code</nowiki>>
Zeile 18: Zeile 18:
; syntaxhighlight
; syntaxhighlight
: <code>syntaxhighlight</code> ist das Tag mit der umfangreichsten Formatierung von Quelltexten. Es bietet Syntaxhervorhebungen und Zeilennummerierung, falls gewünscht. Dazu müssen die Programmiersprache (<code>lang=</code>) und ob Zeilennummern (<code>line=</code>) gewünscht sind als Argumente angegeben werden.
: <code>syntaxhighlight</code> ist das Tag mit der umfangreichsten Formatierung von Quelltexten. Es bietet Syntaxhervorhebungen und Zeilennummerierung, falls gewünscht. Dazu müssen die Programmiersprache (<code>lang=</code>) und ob Zeilennummern (<code>line=</code>) gewünscht sind als Argumente angegeben werden.
: Das Tag wird von der [[mediawikiwiki:Extension:SyntaxHighlight|Extension:SyntaxHighlight]] bereitgestellt. Eine Liste der unterstützten Programmiersprachen und weitere Details zur Nutzung sind dort dokumentiert.
: Das Tag wird von der [[mediawikiwiki:Extension:SyntaxHighlight/de|Extension:SyntaxHighlight]] bereitgestellt. Eine [[mediawikiwiki:Extension:SyntaxHighlight/de#Supported languages|Liste der unterstützten Programmiersprachen]], die [[mediawikiwiki:Extension:SyntaxHighlight/de#Parameters|möglichen Parameter]] und weitere Details zur Nutzung sind dort dokumentiert.
:; lang="java"
:; lang="java"
:: Sprache des Quellcodes. Muss immer angegeben werden. Wenn der Quelltext in einer nicht unterstützten Sprache ist sollte <code>lang="plain"</code> oder das <code>&lt;pre&gt;</code> Tag verwendet werden.  
:: Sprache des Quellcodes. Muss immer angegeben werden. Wenn der Quelltext in einer nicht unterstützten Sprache ist, sollte <code>lang="plain"</code> oder das <code>&lt;pre&gt;</code> Tag verwendet werden.  
:; line="1"
:; line="1"
:: Auf <code>1</code> setzen um Zeilennummern anzuzeigen.
:: Auf <code>1</code> setzen, um Zeilennummern anzuzeigen.
:; highlight="5,7-13"
:; highlight="5,7-13"
:: Die angegebenen Zeilennummern werden farbig hervorgehoben.  
:: Die angegebenen Zeilennummern werden farbig hervorgehoben.  
Zeile 73: Zeile 73:


== Der Quelltext Namensraum ==
== Der Quelltext Namensraum ==
Um umfangreichere Quelltexte verfügbar zu machen, deren Einbindung direkt auf einer Wikiseite zum Beispiel zu unübersichtlich wäre, gibt es den Namensraum '''Quelltext'''. Seiten in diesem speziellen Namensraum müssen dem Dateinamen der Quelltextdatei entsprechen, die sie abbilden. Vor allem muss die Dateiendung die Programmiersprache abbilden, in der der Quelltext verfasst ist. Der Inhalt der Seite darf ausschließlich den Quelltext der Klasse umfassen, sonst nichts. (Also auch keine Tags wie <code>syntaxhighlight</code>!)
Um umfangreichere Quelltexte verfügbar zu machen, deren Einbindung direkt auf einer Wikiseite zum Beispiel zu unübersichtlich wäre, gibt es den Namensraum '''Quelltext:'''. Seiten in diesem speziellen Namensraum müssen dem Dateinamen der Quelltextdatei entsprechen, die sie abbilden. Vor allem muss die Dateiendung die Programmiersprache abbilden, in der der Quelltext verfasst ist. Der Inhalt der Seite darf ausschließlich den Quelltext der Klasse umfassen, sonst nichts. (Also auch keine Tags wie <code>syntaxhighlight</code>!)


Beispiele:
Beispiele:
* [[Quelltext:Tiere.java]]
* [[Quelltext:Tiere.java]]
* [[Quelltext:Test.css]]
* [[Quelltext:Formate.css]]
* [[Quelltext:Vieleck.llogo]]
* [[Quelltext:Vieleck.llogo]]


Zeile 87: Zeile 87:
</pre>
</pre>


Beim Einbinden auf diese Weise wird der reine Quelltext eingebunden, ohne Hervorhebungen. Um den Text auch auf der einbindenden Wikiseite mit Hervorhebungen zu versehen kann nicht mit <code>&lt;syntaxhighlight&gt;</code> gearbeitet werden. Statt dessen muss <code><nowiki>{{#tag:syntaxhighlight|{{Quelltext:Tiere.java}}|lang="java"}}</nowiki></code> benutzt werden.  
Beim Einbinden auf diese Weise wird der reine Quelltext eingebunden, ohne Hervorhebungen. Um den Text auch auf der einbindenden Wikiseite mit Hervorhebungen zu versehen, kann nicht mit <code>&lt;syntaxhighlight&gt;</code> gearbeitet werden. Stattdessen muss <code><nowiki>{{#tag:syntaxhighlight|{{Quelltext:Tiere.java}}|lang="java"}}</nowiki></code> benutzt werden.  


{{Hinweis|Beim einbinden als Vorlage auf diese Weise muss die Sprache mit <code>lang=</code> immer explizit angegeben werden.}}
{{Hinweis|Beim Einbinden als Vorlage auf diese Weise muss die Sprache mit <code>lang=</code> immer explizit angegeben werden.}}


Hinter dem <code>lang</code> Attribut können auch noch weitere [[mediawikiwiki:Extension:SyntaxHighlight#Parameters|Attribute der SyntaxHighlight Erweiterung]] eingefügt werden. Vor allem bietet sich <code>highlight=</code> an, mit dem Zeilen im Quelltext farbig hervorgehoben werden. So kann zum Beispiel in einem Lernpfad immer wieder dasselbe Quelltext-Beispiel benutzt werden, aber in jedem Schritt andere Zeilen hervorgehoben werden.  
Hinter dem <code>lang</code> Attribut können auch noch weitere [[mediawikiwiki:Extension:SyntaxHighlight#Parameters|Attribute der SyntaxHighlight Erweiterung]] eingefügt werden. Vor allem bietet sich <code>highlight=</code> an, mit dem Zeilen im Quelltext farbig hervorgehoben werden. So kann zum Beispiel in einem Lernpfad immer wieder dasselbe Quelltext-Beispiel benutzt werden, aber in jedem Schritt andere Zeilen hervorgehoben werden.  
8.581

Bearbeitungen