Hvad er syntaksfremhævning?

Syntaksfremhævning gør det muligt at fremhæve kode i indlæg baseret på det sprog, det er skrevet på, for at gøre det lettere at læse.

Hvordan fungerer det?

Stack Exchange har ikke sin egen syntaks-fremhævningsmotor. Den bruger highlight.js og bruger muligvis ikke nødvendigvis den seneste udgivelse af dette bibliotek. Derfor kan eventuelle bugs og funktionsanmodninger vedrørende syntaksfremhævning ikke håndteres af Stack Exchange.

Syntaksfremhævning tildeles, baseret på tags , til eksempelvisningen, når du opretter eller redigerer indlæg, så snart du holder op med at skrive i 5 sekunder.

Hvorfor fremhæves ikke min kode korrekt?

1. Kontroller, at det websted, du bruger, har syntaksfremhævning aktiveret

Den fulde liste er tilgængelig på Meta . Hvis syntaksfremhævning ikke er aktiveret den et websted følger instruktionerne i dette spørgsmål.

2. Kontroller at sproget understøttes af highlight.js

Se på liste over understøttede sprog.js-understøttede sprog . Hvis dit sprog ikke er på listen, skal det oprettes inden for projektet highlight.js, før det kan implementeres af Stack Exchange.

Hvis en sprog er allerede på listen, men ikke brugt på Stack Exchange, vær venlig at hæve en funktionsanmodning her på Meta for at få den implementeret på netværket.

3. Kontroller at sproget bruges af Stack Exchange

Se på filen highlight-loader.js på dev CDN, åbn i din yndlingseditor og søg efter sproghint. For eksempel søger efter " pil " bringer dig til en linje bestående af hljs.registerLanguage("dart", .... Dette betyder, at lang-dart er et tilgængeligt sproghint. Søger efter " psh " eller " powershell " returnerer ikke nogen resultater, hvilket betyder at psh ikke understøttes af Stack Exchange-versionen af highlight.js.

4. Kontroller, at tags på spørgsmålet har syntaksfremhævning aktiveret

Bag kulisserne bruger Stack Exchanges tags på spørgsmålet til at bestemme det sprog, du bruger. Hvert tag har et fremhævningssprog, der er angivet i dets egenskaber, eller intet sprog. Hvis der er mere end et tag, der har angivet et fremhævningssprog, eller hvis ingen af tags har et angivet, bruger det en standard og lader highlight.js udlede, hvad der er det bedste sprog at bruge. Det samme fremhævning af sprog, der bruges på spørgsmålet, bruges også på svarene.

Besøg det mærke “s wiki side. Klik på et tag (f.eks. " javascript "), og klik derefter på " Lær mere … ", og det sproghint (hvis nogen), der i øjeblikket bruges til dette tag, vises på meget nederst , under knapperne til wiki:

Hvis tagget ikke har et fremhævningssprog angivet, når det skal, skal du oprette en funktionsanmodning på metaen per sted for dit websted til at anmode om det (kun moderatorer kan ændre fremhævningssproget for et tag.)

Hvordan rapporterer jeg en fejl eller anmoder om et nyt sprog?

Hvis det virkelig er en fejl i selve syntaksmarkøren, skal du kontrollere, om eksisterende rapporter først for at se, om det allerede er rapporteret, hvis det ikke er tilfældet, skal du fortsætte og rapportere det der. For fejlrettelser og funktioner, der allerede er implementeret af highlight.js men ikke fungerer her, vent venligst, da nye versioner af highlight.js distribueres på webstederne på en planlagt basis, og den nyeste version er endnu ikke implementeret. (Hvis den ikke er blevet implementeret efter lang tid, kan du rejse en funktionsanmodning på Meta for at anmode om, at en ny version af highlight.js distribueres.)

Husk, at Stack Exchange opretholder ikke denne syntaks-highlighter (bortset fra at installere nyere versioner af den), og at sende fejlrapporter eller funktionsanmodninger vedrørende det her på Meta får dem ikke løst eller implementeret.

Før du gør hvad som helst, sørg for at at du har aktiveret den korrekte fremhævning.

Hvordan bruger jeg syntaksfremhævning?

Så længe alle betingelser i Hvorfor bliver min kode ikke fremhævet korrekt? ovenfor er opfyldt, fremhævning vil automatisk sparke på kodeblokke baseret på tags på spørgsmålet. (Se 4. Kontroller, at tags på dit spørgsmål har syntaksfremhævning aktiveret ovenfor for, hvordan dette fungerer.) Inline kode (f.eks. this) er ikke fremhævet.

Det er muligt at tilsidesætter eksplicit det standardfremhævningssprog, der bruges på indlægget, med dit valgte sprog i en bestemt kodeblok ved at angive et sproghint over kodeblokken. Bemærk, at dette kun understøttes, når du bruger kodehegn (```) metode til kodeformatering; fra implementeringen af CommonMark understøttes ikke længere dette på kodeblokke ved hjælp af metoden med fire mellemrum *:

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

Du kan enten bruge en sprogkode eller et tag navn i sproghintet for at aktivere syntaksfremhævning. Se nedenfor for den komplette liste over highlight.js-understøttede sprogkoder.

For eksempel:

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

Hvis du ikke vil have for at have en hvilken som helst syntaksfremhævning kan du bruge lang-none sprog:

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

Du kan også anvende et sproghint til alle kodeblokke i dit indlæg, så du behøver ikke tilføje et tip før hver enkelt ved at tilføje en HTML-kommentar øverst i dit indlæg. Tipet bliver derefter anvendt på alle kodeblokke i dit indlæg, inklusive dem, der bruger fire mellemrumsindryk eller HTML <pre><code>:

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