Wat is syntaxisaccentuering?

Syntaxisaccentuering maakt het mogelijk dat code in berichten wordt gemarkeerd op basis van de taal waarin deze is geschreven, om het lezen gemakkelijker te maken.

Hoe werkt het?

Stack Exchange heeft geen eigen engine voor het markeren van syntaxis. Het gebruikt highlight.js , en maakt niet noodzakelijkerwijs gebruik van de nieuwste release van die bibliotheek. Daarom kunnen eventuele bugs en functieverzoeken met betrekking tot syntaxisaccentuering niet worden afgehandeld door Stack Exchange.

Syntaxisaccentuering wordt toegewezen, op basis van -tags , aan het voorbeeld bij het maken of bewerken van berichten zodra u gedurende 5 seconden stopt met typen.

Waarom wordt mijn code niet correct gemarkeerd?

1. Controleer of de site die u gebruikt syntaxisaccentuering heeft ingeschakeld.

De volledige lijst is beschikbaar op Meta . Als syntaxisaccentuering niet is ingeschakeld op een site volgt u de instructies in deze vraag.

2. Controleer of de taal wordt ondersteund door highlight.js

Kijk naar de lijst met door highlight.js ondersteunde talen . Als uw taal niet op de lijst staat, moet deze worden gemaakt binnen het highlight.js-project voordat deze kan worden geïmplementeerd door Stack Exchange.

Als een taal staat al op de lijst maar wordt niet gebruikt op Stack Exchange. Dien hier een functieverzoek in op Meta om deze op het netwerk te laten implementeren.

3. Controleer of de taal wordt gebruikt door Stack Exchange

Bekijk het bestand highlight-loader.js op het dev CDN, open het in je favoriete editor en zoek naar de taalhint. Bijvoorbeeld: zoeken naar " dart " brengt je naar een regel bestaande uit hljs.registerLanguage("dart", .... Dit betekent dat lang-dart een beschikbare taalhint is. Zoeken naar " psh " of " powershell " retourneert geen resultaten, wat betekent dat psh niet wordt ondersteund door de Stack Exchange-versie van highlight.js.

4. Controleer of voor de tags op de vraag syntaxisaccentuering is ingeschakeld

Achter de schermen gebruikt Stack Exchanges de tags op de vraag om de taal te bepalen die u gebruikt. Elke tag heeft een accentueringstaal die is gespecificeerd in de eigenschappen, of geen taal. Als er meer dan één tag is waarvoor een accentueringstaal is gespecificeerd, of als geen van de tags er een heeft gespecificeerd, wordt een standaard gebruikt en laat highlight.js afleiden wat de beste taal is om te gebruiken. Dezelfde accentuerende taal die wordt gebruikt voor de vraag, wordt ook gebruikt voor de antwoorden.

Bezoek die tag “s wiki -pagina. Klik op een tag (zoals " javascript ") en klik vervolgens op " Meer informatie … ", en de taalhint (indien aanwezig) die momenteel voor die tag wordt gebruikt, wordt weergegeven op de helemaal onderaan , onder de knoppen voor de wiki:

Als de tag geen accentueringstaal heeft opgegeven wanneer dat zou moeten, maak dan een feature-request op de meta per site voor uw site om deze aan te vragen. (Alleen moderators kunnen de accentueringstaal voor een tag wijzigen.)

Hoe meld ik een bug of vraag ik een nieuwe taal aan?

Als het inderdaad een bug is in de syntaxis markeerstift zelf, controleer dan op bestaande rapporten om eerst te kijken of het al is gerapporteerd; als dit niet het geval is, kunt u het daar melden. Voor bugfixes en functies die al zijn geïmplementeerd door highlight.js maar hier niet werken, wacht even, aangezien nieuwe versies van highlight.js op een geplande basis op de sites worden geïmplementeerd, en de de laatste versie is nog niet geïmplementeerd. (Als het na een lange tijd niet is geïmplementeerd, kunt u een functieverzoek indienen bij Meta om te vragen dat een nieuwe versie van highlight.js wordt geïmplementeerd.)

Houd er rekening mee dat Stack Exchange onderhoudt deze syntaxis markeerstift niet (afgezien van het installeren van nieuwere versies ervan), en het plaatsen van bugrapporten of functieverzoeken hierover hier op Meta zal ze niet laten repareren of implementeren.

Voor je iets doen, zeker dat u “de juiste accentuering hebt ingeschakeld.

Hoe gebruik ik syntaxisaccentuering?

Zolang alle voorwaarden in het Waarom wordt mijn code niet correct gemarkeerd? sectie hierboven is voldaan, zal accentuering automatisch starten op codeblokken op basis van de tags op de vraag. (Zie 4. Controleer of de tags op uw vraag hebben syntaxisaccentuering ingeschakeld hierboven voor hoe dit werkt.) Inline code (bijv. this) is niet gemarkeerd.

Het is mogelijk om overschrijf expliciet de standaard accentueringstaal die in het bericht wordt gebruikt met uw taal naar keuze in een specifiek codeblok, door een taalhint boven het codeblok te specificeren. Merk op dat dit alleen wordt ondersteund bij gebruik van de code fence (```) methode van code-opmaak; vanaf de implementatie van CommonMark , wordt dit op codeblokken met behulp van de indent-methode met vier spaties niet langer ondersteund *:

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

Je mag een taalcode of een tag naam in de taalhint om syntaxisaccentuering te activeren. Zie hieronder voor de volledige lijst met door highlight.js ondersteunde taalcodes.

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 -->