WP-Syntax

Beschrijving

WP-Syntax biedt schone syntax highlighting met behulp van
GeSHi — en ondersteunt een groot aantal populairecrltalen. het ondersteunt markeren met of zonder regelnummers en behoudt de opmaak tijdens het kopiëren van stukjes codecrl van de browser.

Het vermijdt conflicten met andere plugins van derden door een early
pre-filter en een late post-filter te gebruiken die de code snippets
Out eerst vervangt en ze er dan terug in duwt met markering aan het einde. het
Resultaat is broncode geformatteerd en gemarkeerd zoals je het bedoeld hebt.

Gebruik, ondersteunde talen, stijlrichtlijnen en release notes zijn beschikbaar in de sectie Other notes.

Wil je bijdragen? WP-Syntax is te vinden op gitHub. Fork en dien je pull requests vandaag nog in!

Basisgebruik

Pak codeblokken in met <pre lang="LANGUAGE" line="1"> en </pre> waarbij “LANGUAGE”
een door GeSHi ondersteunde taalsyntaxis is.
Het regelattribuut is optioneel. Meer gebruiksvoorbeelden

Gebruik

Pak codeblokken in met <pre lang="LANGUAGE" line="1"> en </pre> waarbij “LANGUAGE” een door GeSHi ondersteunde crltaal is. Zie hieronder voor een volledige lijst van ondersteunde talen.
Het regelattribuut is optioneel.

Voorbeeld 1: PHP, geen regelnummers

<pre lang="php">
<div id="foo">
<?php
  function foo() {
    echo "Hello World!\\n";
  }
?>
</div>
</pre>

Voorbeeld 2: Java, met regelnummers

<pre lang="java" line="1">
public class Hello {
  public static void main(String[] args) {
    System.out.println("Hello World!");
  }
}
</pre>

Voorbeeld 3: Ruby, met regelnummers vanaf 18

<pre lang="ruby" line="18">
class Example
  def example(arg1)
    return "Hello: " + arg1.to_s
  end
end
</pre>

Voorbeeld 4: als je code al html entiteiten geëscaped heeft, gebruik dan escaped="true" als optie

<pre lang="xml" escaped="true">
&lt;xml&gt;Hello&lt;/xml&gt;
</pre>

Voorbeeld 5: PHP, met regelnummers en het markeren van een specifieke regel

<pre lang="php" line="1" highlight="3">
<div id="foo">
<?php
  function foo() {
    echo "Hello World!\\n";
  }
?>
</div>
</pre>

Voorbeeld 6: PHP, met een bijschrift (bestand en/of bestandspad van het bronbestand)

<pre lang="php" src"https://github.com/shazahm1/Connections/blob/master/connections.php">
<div id="foo">
<?php
  function foo() {
    echo "Hello World!\\n";
  }
?>
</div>
</pre><h3>Supported Languages</h3>

De volgende talen worden het meest ondersteund in het lang attribuut:

abap, actionscript, actionscript3, ada, apache, applescript, apt_sources, asm,
asp, autoit, avisynth, bash, bf, bibtex, blitzbasic, bnf, boo, c,
c_mac, caddcl, cadlisp, cil, cfdg, cfm, cmake, cobol, cpp-qt, cpp,
csharp, css, d, dcs, delphi, diff, div, dos, dot, eiffel, email, erlang,
fo, fortran, freebasic, genero, gettext, glsl, gml, bnuplot, groovy, haskell,
hq9plus, html4strict, idl, ini, inno, intercal, io, java, java5,
javascript, kixtart, klonec, klonecpp, latex, lisp, locobasic, lolcode
lotusformulas, lotusscript, lscript, lsl2, lua, m68k, make, matlab, mirc,
modula3, mpasm, mxml, mysql, nsis, oberon2, objc, ocaml-brief, ocaml,
oobas, oracle11, oracle8, pascal, per, pic16, pixelbender, perl,
php-brief, php, plsql, povray, powershell, progress, prolog, properties,
providex, python, qbasic, rails, rebol, reg, robots, ruby, sas,
scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, tcl, teraterm,
text, thinbasic, tsql, typoscript, vb, vbnet, verilog, vhdl, vim,
visualfoxpro, visualprolog, whitespace, whois, winbatch, xml, xorg_conf,
xpp, z80

Zie de GeSHi documentatie
Fvoor
een volledige lijst van ondersteunde talen.

(Vetgedrukte talen benadrukken alleen de populairste.)

Richtlijnen voor styling

WP-Syntax kleurt code met behulp van de standaard geSHi-kleuren. het gebruikt ook inline
Styling om ervoor te zorgen dat code highlights nog steeds werken in RSS feeds. het gebruikt a
Default wp-syntax.css stylesheet voor basis lay-out. om je styling aan te passen, kopieer je de standaard wp-content/plugins/wp-syntax/wp-syntax.css naar de s
Template map van je thema en pas je deze aan. als er een bestand met de naam wp-syntax.css bestaat in de template folder van je thema, wordt dit stylesheet gebruikt in plaats van de standaard.
Dit geeft thema auteurs de mogelijkheid om hun eigen aanpassingen toe te voegen.

Geavanceerde aanpassing

WP-Syntax ondersteunt een wp_syntax_init_geshi action hook om geSHi
Initialisatie-instellingen aan te passen. blog eigenaren kunnen de hook verwerken in een handgemaakte plugin
or ergens anders zoals hier:

<?php
add_action('wp_syntax_init_geshi', 'my_custom_geshi_styles');

function my_custom_geshi_styles(&$geshi)
{
    $geshi->set_brackets_style('color: #000;');
    $geshi->set_keyword_group_style(1, 'color: #22f;');
}
?>

Dit laat een grote mogelijkheid tot verschillende aanpassingen toe. Raadpleeg zeker de GeSHi-documentatie.

Schermafdrukken

  • PHP, geen regelnummers.
  • Java, met regelnummers.
  • Ruby, met regelnummers vanaf 18.

Installatie

  1. Upload wp-syntax.zip naar je WordPress plugins directory, meestal wp-content/plugins/ en pak het bestand uit. het zal een wp-content/plugins/wp-syntax/ directory aanmaken.
  2. De plugin activeren via het ‘Plugin’ menu in WordPress.
  3. Maak een bericht/pagina die een codefragment bevat volgens de juiste gebruikssyntaxis.

FAQ

Waarom genereert de plugin onverwachte output?

Probeer codesnippers te bewerken zonder de visuele editor. om de visuele editor voor alle je bewerkingen uit te schakelen, schakel je het selectievakje voor de visuele editor in je profiel uit.
Afhankelijk van het type code dat je probeert weer te geven, moet je misschien ook WordPress’ correcties van ongeldig geneste XHTML uitschakelen (onder opties ->
Writing).

Waarom kan ik, als beheerder, wel code snippets plaatsen, maar mijn auteurs niet?

Standaard filtert WordPress HTML voor bepaalde gebruikersrollen, en dit beïnvloedt de invoer van s
WP-Syntax. als worwinkelwagenound installeert u de Role manager
Plugin
, en vinkt u “ongefilterde HTML” aan voor de rollen die code snippets willen posten.

Beoordelingen

3 december 2023
Works as documented. Easy way to have syntax highlighting for posts containing code. Thank you for developing this plugin!
12 oktober 2017
https://linux-guru.azurewebsites.net/ My site has many code based articles for developers. Not much for WP as of yet but mostly for more general ideas for a custom web site from scratch. https://linux-guru.azurewebsites.net/location-based-advertisements/ is an article on SQL that I am working on, and this plugin has been able to get around some of problems with WP mangling code cut and paste does not get rid of the escaped code which is why I like that escaped switch which allows for clean SQL code that works safely
23 augustus 2017
The Plugin installed and worked as expected, but if there were some customisation option it would be great the one i could think of is implementing the dark theme for the code preview which can be easily achieved by changing the style sheet.
29 september 2016
Its really good and easy to be used. Only thing is the style is to be improved. I am not the expert to change the default css for example to increase the padding of a line, it makes the backgroud crashed so I've given up.
3 september 2016
The plugin is light weight and simple. Its style can be customized using CSS. Those who are looking for options in menus will have to look for another plugin
Lees alle 15 beoordelingen

Bijdragers & ontwikkelaars

“WP-Syntax” is open source software. De volgende personen hebben bijgedragen aan deze plugin.

Bijdragers

“WP-Syntax” is vertaald in 5 talen. Dank voor de vertalers voor hun bijdragen.

Vertaal “WP-Syntax” naar jouw taal.

Interesse in ontwikkeling?

Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.

Changelog

1.1 12/01/2023

  • TWEAK: Ensure $content is always returned by the filter callback.
  • TWEAK: Slash the highlighted code blocks before saving cache to the post meta.
  • BUG: Cache each page of a multi-paged post separately.
  • BUG: Fix notice level error when global $comment is not available.
  • OTHER: Update GeSHi to version 1.0.9.1 at GH commit 7884d22 on Feb 19, 2023.
  • OTHER: Correct misspellings.

1.1 12/14/2016

  • NIEUW: invoeren van caching van de syntax highlighted code in plaats van deze te parseren bij het laden van de pagina.
  • NIEUW: introduceer dubbelklikken om code te kopiëren vanuit een gemarkeerd codeblok. Props zavr!
  • TWEAK: PHP 7.1 compatibiliteit.
  • TWEAK: de horizontale padding van het bijschrift verwijderen.
  • TWEAK: verwijder dubbele CSS padding eigenschap.
  • TWEAK: verwijder de overbodige px van eigenschappen die als 0 zijn ingesteld in CSS.
  • TWEAK: lettertype grootte van markeercode aanpassen voor betere verticale uitlijning.
  • BUG: zorg ervoor dat de string terugkomt in het opschrift.
  • BUG: bug met regelnummering opgelost.
  • BUG: oude plugin bestand verwijderen.
  • OVERIG: UPDATE geSHi naar de laatste dev branch.
  • DEV: phpDoc fouten corrigeren.

1.0 02/09/2013

  • NIEUW: CSS3 voor afwisselende achtergrondlijnen voor betere leesbaarheid.
  • OVERIG: volledige refactorisering van de code om de huidige beste praktijken voor plugin ontwikkeling te gebruiken, wat een solide basis zal vormen voor verdere ontwikkeling.
  • OVERIG: geSHi contrib en test mappen verwijdert.
  • OVERIG: verplaats CSS naar css sub-map.
  • OVERIG: verplaats JavaScript naar de submap js.
  • OVERIG: CSS-oplossingen om te voorkomen dat het thema de opmaak van de uitvoer afbreekt.

0.9.13 09/01/12

  • FUNCTIE: een nieuwe “src” shortcode optie toegevoegd om referentie van de bronbestandsnaam toe te staan. props: Steffen Vogel
  • BUG: het CSS-bestand correct enqueueren.
  • BUG: tinyMCE allow list geüpdatet om verplichte tags toe te staan. props: Steffen Vogel
  • ANDERE: geSHi geüpdatet naar 1.0.8.11
  • ANDERE: oude ongebruikte code verwijderen.
  • OVERIG: verbeterde lijnmarkering. rekwisieten: Steffen Vogel
  • OVERIG: enkele extra CSS-stijlen toegevoegd om te voorkomen dat thema’s de presentatie van de code verstoren.

0.9.12: bug in de nieuwe highlight functie opgelost.

0.9.11: ondersteuning voor lijnmarkering toegevoegd. Door gebruiker ingediende patch. Bedankt flynsarmy && chimo

0.9.10: oplossing voor beveiligingslek wanneer register_globals in php is ingeschakeld.

0.9.9: oplossing om subthema’s te ondersteunen. WP-Syntax vereist nu WP >= 3.0.
credit to OddOneOut
geüpdatet om 1.0.8.9 te gebruiken.

0.9.8: oplossing voor optionele regelattributen; getest op WP 2.8

0.9.7: geSHi v1.0.8.3 teruggedraaid om een hoop problemen te voorkomen;

0.9.6: geüpdatet om geSHi v1.0.8.4 te gebruiken;

0.9.5: kleine style override om te voorkomen dat thema’s de structuur van de code omzeilen

0.9.4: geüpdatet om geSHi v1.0.8.3 te gebruiken;

0.9.3: fixed hard-coded plugin path
(#964 );

0.9.2: geüpdatet om geSHi v1.0.8.2 te gebruiken; optionele escaped="true"
ondersteuning toegevoegd voor het geval code snippets al geëscaped zijn met html entiteiten.

0.9.1: geüpdatet om geSHi v1.0.8 te gebruiken; verbeterd de FAQ;

0.9: ondersteuning toegevoegd voor anonieme abonnees om pre-tags te gebruiken in hun
commentaren waardoor ze hun eigen gekleurde code snippets kunnen gebruiken [Fernando Briano];

0.8: geüpdatet om geSHi v1.0.7.22 te gebruiken (dit zou normaal een revisie
release zijn, maar de kleuren zijn veranderd en er worden 9 nieuwe talen ondersteund); a
font-size instelling toegevoegd in de standaard css om klachten over kleine afmetingenes
veroorzaakt door andere standaard WP thema’s tegen te gaan;

0.7: automatisch opgenomen algemene stijlen zonder dat handmatige aanpassing van thema
nodig is [Christian Heim]; ondersteuning toegevoegd voor het toevoegen van een aangepaste
wp-syntax.css stylesheet aan een thema;

0.6.1: geüpdatet om geSHi v1.0.7.21te gebruiken; de WP-compatibiliteitsversie geüpdatet;

0.6: ondersteuning init hook voor geshi instellingen (wp_syntax_init_geshi);
(#667)
[reedom]

0.5.4: geüpdatet om geSHi v1.0.7.20te gebruiken;

0.5.3: probleem met styling richtlijnen voor IE 6 opgelost [kimuraco];

0.5.2: geüpdatet om geSHi v1.0.7.19 te gebruiken;

0.5.1: Geshi folder export veranderd naar utilize
piston in plaats van svn:externals properties;

0.5: ondersteuning toegevoegd voor enkelvoudig geciteerde attributen;
(#624 )

0.4: opschoning en documentatie voor WordPress.org plugin
lijsten
;

0.3: eerste officiële publieke release; ondersteuning voor regelnummers toegevoegd; gebruikt geSHi v1.0.7.18;
(#532 )

0.2: interne release; voegt “voor en na” filterondersteuning toe om
conflicten met andere plugins te vermijden;
(#531 )

0.1: eerste interne release; gebruikt geSHi v1.0.7.16;