Was Ist die Syntaxhervorhebung?

Mit der Syntaxhervorhebung kann Code in Posts basierend auf der Sprache, in der er geschrieben wurde, hervorgehoben werden, um das Lesen zu erleichtern.

Wie funktioniert das?

Stack Exchange verfügt nicht über eine eigene Syntaxhervorhebungs-Engine. Es wird Highlight.js und verwendet möglicherweise nicht unbedingt die neueste Version dieser Bibliothek. Daher können Fehler und Funktionsanforderungen bezüglich der Syntaxhervorhebung nicht von Stack Exchange behandelt werden.

Die Syntaxhervorhebung wird basierend auf -Tags der Vorschau beim Erstellen oder Bearbeiten von Posts zugewiesen, sobald Sie die Eingabe für 5 Sekunden beenden.

Warum wird mein Code nicht richtig hervorgehoben?

1. Überprüfen Sie, ob auf der von Ihnen verwendeten Site die Syntaxhervorhebung aktiviert ist.

Die vollständige Liste ist auf Meta verfügbar. Wenn die Syntaxhervorhebung nicht aktiviert ist Befolgen Sie auf einer Site die Anweisungen in dieser Frage.

2. Überprüfen Sie, ob die Sprache von Highlight unterstützt wird. js

Sehen Sie sich die an Liste der unterstützten Highlights.js-Sprachen . Wenn Ihre Sprache nicht in der Liste enthalten ist, muss sie im Projekt „light.js „erstellt werden, bevor sie von Stack Exchange bereitgestellt werden kann.

Wenn a Die Sprache ist bereits in der Liste enthalten, wird jedoch in Stack Exchange nicht verwendet. Bitte stellen Sie hier in Meta eine Funktionsanforderung, um sie im Netzwerk bereitzustellen.

3. Überprüfen Sie, ob die Sprache von Stack Exchange

Sehen Sie sich die Datei Highlight-loader.js auf dem Entwicklungs-CDN an, öffnen Sie sie in Ihrem bevorzugten Editor und suchen Sie nach dem Sprachhinweis. Wenn Sie nach " dart " suchen, gelangen Sie zu a Zeile bestehend aus hljs.registerLanguage("dart", .... Dies bedeutet, dass lang-dart ein verfügbarer Sprachhinweis ist. Suchen nach " psh " oder " Powershell " gibt keine Ergebnisse zurück, was bedeutet, dass psh von der Stack Exchange-Version von Highlight.js nicht unterstützt wird.

4. Überprüfen Sie, ob für die Tags in der Frage die Syntaxhervorhebung aktiviert ist

Hinter den Kulissen verwendet Stack Exchanges die Tags in der Frage , um die von Ihnen verwendete Sprache zu bestimmen. Jedes Tag verfügt über eine Hervorhebungssprache, die in seinen Eigenschaften angegeben ist. oder keine Sprache. Wenn es mehr als ein Tag gibt, für das eine Hervorhebungssprache angegeben ist, oder wenn für keines der Tags eine angegeben ist, wird eine Standardeinstellung verwendet und Highlight.js wird abgeleitet, welche Sprache am besten zu verwenden ist Das Hervorheben der Sprache, die für die Frage verwendet wird, wird auch für die Antworten verwendet.

Besuchen Sie das Tag „s Wiki Seite. Klicken Sie auf ein Tag (z. B. Javascript ") und klicken Sie dann auf " Weitere Informationen … " und der Sprachhinweis (falls vorhanden), der derzeit für dieses Tag verwendet wird, werden unter angezeigt Ganz unten unterhalb der Schaltflächen für das Wiki:

Wenn für das Tag keine Hervorhebungssprache angegeben ist, erstellen Sie diese eine Feature-Anfrage im Meta pro Site, damit Ihre Site sie anfordert. (Nur Moderatoren können die Hervorhebungssprache für ein Tag ändern.)

Wie melde ich einen Fehler oder fordere eine neue Sprache an?

Wenn es sich tatsächlich um einen Fehler im Syntax-Textmarker selbst handelt, suchen Sie nach vorhandenen Berichten Überprüfen Sie zuerst, ob es bereits gemeldet wurde. Wenn dies nicht der Fall ist, melden Sie es dort. Für Fehlerkorrekturen und Funktionen, die bereits von Highlight.js implementiert wurden, aber hier nicht funktionieren, warten Sie bitte, da neue Versionen von Highlight.js auf den Websites planmäßig bereitgestellt werden Die neueste Version wurde noch nicht bereitgestellt. (Wenn es nach langer Zeit nicht mehr bereitgestellt wurde, können Sie eine Funktionsanforderung für Meta auslösen, um die Bereitstellung einer neuen Version von Highlight.js anzufordern.)

Beachten Sie, dass Stack Exchange behält diesen Syntax-Textmarker nicht bei (abgesehen von der Installation neuerer Versionen), und durch das Posten von Fehlerberichten oder Funktionsanforderungen hier auf Meta werden diese nicht behoben oder implementiert.

Vor Ihnen Stellen Sie sicher, dass die richtige Hervorhebung aktiviert ist.

Wie verwende ich die Syntaxhervorhebung?

Solange alle Bedingungen erfüllt sind Wenn im Abschnitt Warum wird mein Code nicht korrekt hervorgehoben? erfüllt ist, wird die Hervorhebung automatisch in Codeblöcken aktiviert, die auf den Tags in der Frage basieren. (Siehe 4. Überprüfen Sie, ob die Bei Tags in Ihrer Frage ist die Syntaxhervorhebung oben aktiviert, damit dies funktioniert.) Inline -Code (z. B. this) wird nicht hervorgehoben.

Es ist möglich, Überschreiben Sie explizit die Standard-Hervorhebungssprache, die im Beitrag verwendet wird, mit der Sprache Ihrer Wahl in einem bestimmten Codeblock, indem Sie einen Sprachhinweis über dem Codeblock angeben. Beachten Sie, dass dies nur bei Verwendung der Code-Zaun-Formatierungsmethode (```) unterstützt wird. Ab der -Implementierung von CommonMark wird dies für Codeblöcke mit der Einrückungsmethode mit vier Leerzeichen nicht mehr unterstützt *:

```lang-or-tag-here code goes here ``` 

Sie können entweder einen Sprachcode oder einen tag -Namen im Sprachhinweis zum Aktivieren der Syntaxhervorhebung. Unten finden Sie eine vollständige Liste der von align.js unterstützten Sprachcodes.

Here is a code block with language code (with "lang-" prefix) as a hint: ```lang-js function greet(person) { return "Hello " + person; } var user = "John Doe"; alert(greet(user)); ``` Here is a code block with tag name (no "lang-" prefix) as a hint: ```typescript var arr = [0, 1, 2]; // will highlight if typescript tag exists ``` 

```lang-none [code here] ``` 

<!-- language-all: lang-or-tag-here -->