Vorlage:Codesample: Unterschied zwischen den Versionen

Aus d.hack
(Die Seite wurde neu angelegt: „{{Documentation subpage}} {{Uses TemplateStyles|Template:Codesample/style.css|Template:Codesample/dark.css|Template:Codesample/light.css|Template:Codesample/borland.css}} <templatedata> { "params": { "code": { "aliases": [ "1" ], "label": "Code", "description": "Code sample to render", "type": "string", "required": true }, "lang": { "label": "Programming language", "description": "Name of lexer to use for highlighting",…“)
 
(Die Seite wurde geleert.)
Markierung: Geleert
 
Zeile 1: Zeile 1:
{{Documentation subpage}}
{{Uses TemplateStyles|Template:Codesample/style.css|Template:Codesample/dark.css|Template:Codesample/light.css|Template:Codesample/borland.css}}
<templatedata>
{
"params": {
"code": {
"aliases": [
"1"
],
"label": "Code",
"description": "Code sample to render",
"type": "string",
"required": true
},
"lang": {
"label": "Programming language",
"description": "Name of lexer to use for highlighting",
"example": "shell-session",
"type": "string",
"default": "text",
"suggested": true
},
"name": {
"label": "Title",
"description": "Title (name) of this code sample. Often a filename",
"type": "string",
"suggested": true
},
"highlight": {
"label": "Highlighted lines",
"description": "Line(s) in example to highlight. Comma separated list of line numbers",
"type": "string"
},
"line": {
"label": "Show line numbers",
"description": "Enable line numbers for sample",
"type": "boolean"
},
"start": {
"label": "Starting line number",
"description": "Starting line number when line numbers are shown. Note: Does not effect line numbers used for highlights.",
"type": "number",
"default": "1"
},
"scheme": {
"label": "Color scheme",
"description": "Color scheme to use. \"dark\" and \"light\" will apply solarized color schemes. Anything else will use syntaxhighlight extension defaults.",
"type": "string",
"default": "dark"
}
},
"description": "This template augments a <syntaxhighlight> block with fancy colors and an optional title",
"paramOrder": [
"name",
"lang",
"code",
"highlight",
"line",
"start",
"scheme"
],
"format": "block"
}
</templatedata>


== Examples ==
{| class="wikitable"
|-
| <code><nowiki>{{Codesample |echo "hello world!"}}</nowiki></code> || {{Codesample |echo "hello world!"}}
|-
| <code><nowiki>{{Codesample |echo "hello world!" |lang=text |scheme=light}}</nowiki></code> || {{Codesample |echo "hello world!" |lang=text |scheme=light}}
|-
| <code><nowiki>{{Codesample |$ echo "hello world!" |lang=shell-session |scheme=dark}}</nowiki></code> || {{Codesample |$ echo "hello world!" |lang=shell-session |scheme=dark}}
|-
| <code><nowiki>{{Codesample |code=&lt;nowiki&gt;{{Codesample}}&lt;/nowiki&gt; |lang=wikitext}}</nowiki></code> || {{Codesample |code=<nowiki>{{Codesample}}</nowiki> |lang=wikitext}}
|-
| <pre>{{Codesample |name=ingress.yaml |lang=yaml |scheme=dark |line=1 |highlight=5,8 |code=
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: foo-redirect
  namespace: tool-foo
  labels:
    name: foo-redirect
  annotations:
    kubernetes.io/ingress.class: nginx
}}</pre> || {{Codesample |name=ingress.yaml |lang=yaml |scheme=dark |line=1 |highlight=5,8 |code=
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: foo-redirect
  namespace: tool-foo
  labels:
    name: foo-redirect
  annotations:
    kubernetes.io/ingress.class: nginx
}}
|-
| <pre>{{Codesample |name=metadata |lang=yaml |scheme=light |line=1 |start=5 |highlight=1,4 |code=
  name: foo-redirect
  namespace: tool-foo
  labels:
    name: foo-redirect
  annotations:
    kubernetes.io/ingress.class: nginx
}}</pre> || {{Codesample |name=metadata |lang=yaml |scheme=light |line=1 |start=5 |highlight=1,4 |code=
  name: foo-redirect
  namespace: tool-foo
  labels:
    name: foo-redirect
  annotations:
    kubernetes.io/ingress.class: nginx
}}
|}
== Adding a new color scheme ==
The <code>scheme=...</code> parameter will load a css sub-page to add styles matching the [https://pygments.org Pygments] markup definitions. The easiest way to introduce a new scheme is to export it from Pygments itself: <code>pygmentize -f html -S $style -a .wt-codesample-${style}</code>.
== See also ==
* {{tl|Code}}
* {{tl|Inline-code}}
* {{tl|Codesample}}
* {{tl|Terminal}}

Aktuelle Version vom 30. April 2024, 07:39 Uhr