diff --git a/README.md b/README.md index 1afdc04..e5542fe 100644 --- a/README.md +++ b/README.md @@ -1,315 +1,17 @@ === Crayon Syntax Highlighter === -Contributors: akarmenia -Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=AW99EMEPQ4CFE&lc=AU&item_name=Crayon%20Syntax%20Highlighter%20Donation&item_number=crayon%2ddonate¤cy_code=AUD&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted -License: GPLv2 or later -Tags: syntax highlighter, syntax, highlighter, highlighting, crayon, code highlighter, bbpress -Requires at least: 3.0 -Tested up to: 4.2.0 -Stable tag: trunk Syntax Highlighter supporting multiple languages, themes, fonts, highlighting from a URL, or post text. +This is a fork with applied PRs and bumped semantic versioning. == Description == A Syntax Highlighter built in PHP and jQuery that supports customizable languages and themes. It can highlight from a URL, or Wordpress post text. Crayon makes it easy to manage Language files and define custom language elements with regular expressions. -It also supports some neat features like: - -* Integrated Theme Editor! -* Tag Editor in both Visual & HTML editors -* Toggled plain code -* Toggled line numbers -* Copy/paste code -* Open code in a new window (popup) -* Line wrapping -* Code expanding -* Minimizing -* bbPress 2 support -* Converting legacy code in blog posts/comments to <pre> -* Remote request caching -* Mixed Language Highlighting in a single Crayon -* Mini Tags like [php][/php] -* Inline Tags floating in sentences -* Crayons in comments -* `Backquotes` become <code> -* <pre> tag support, option to use setting-value in the class attribute -* Valid HTML 5 markup -* Visual & HTML editor compatible -* Mobile/touchscreen device detection -* Mouse event interaction (showing plain code on double click, toolbar on mouseover) -* Tab sizes -* Code title -* Toggled toolbar -* Retina buttons -* Striped lines -* Line marking (for important lines) -* Line ranges (showing only parts of the code) -* Starting line number (default is 1) -* File extension detection -* Live Preview in settings -* Dimensions, margins, alignment, font-size, line-height, float -* Extensive error logging - -**Links** - -* Beta Releases -* Themes Demo -* GitHub Project **Contributions** -There are many ways you can help! - -* Make a Theme and share -* Add support for your favourite Language -* Write a post about your pastel experiences and share -* Donate to the project - -**Supported Languages** - -Languages are defined in language files using Regular Expressions to capture elements. -See the Crayon Language File Specification to learn how to make your own. - -* Default Language (one size fits all, highlights generic code) -* C1 (thanks to Oparin Pavel) -* ABAP -* ActionScript -* AmigaDOS (thanks to amigalog.com) -* Apache -* AppleScript -* Arduino -* Assembly (x86) -* AutoIt -* C -* C# -* C++ -* Clojure (thanks to ) -* CoffeeScript (thanks to Dai Akatsuka) -* CSS -* Delphi/Pascal (thanks to Chris McClenny) -* Delphi Web Script (thanks to smartmobilestudio) -* Diff (thanks to omniavin) -* Erlang (thanks to Daniel) -* Fabric Engine KL (thanks to Andrew Hazelden) -* Go -* Haskell -* HTML (XML/XHTML) -* INI -* Lisp -* Lua -* Maya MEL (thanks to Andrew Hazelden) -* Microsoft Registry (thanks to techexplored.com) -* MIVA Script -* Monkey (thanks to Devolonter) -* MS-DOS (thanks to http://www.amigalog.com/?p=334) -* MySQL (thanks to AssemblySys.com and ansas-meyer.de) -* Java -* JavaScript -* Objective-C -* Papyrus -* Perl -* PHP -* PL/SQL -* PostgreSQL (thanks to Bitorchestra) -* PowerShell -* Python -* R -* Ruby -* Rust (thanks to Stibbons) -* Scheme (thanks to Harry75369) -* Shell (Unix) -* Swift (thanks to weyhan) -* Transact-SQL -* TeX -* Vim -* Visual Basic -* Visual Basic .NET (thanks to Kevin Gardthausen) -* YAML -* ZSH (thanks to Stibbons) -* Others will be added when requested - -**International Languages** - -* Arabic (thanks to Djennad Hamza) -* Chinese Simplified (thanks to Dezhi Liu & Jash Yin) -* Chinese Traditional (thanks to Arefly) -* Dutch (thanks to Robin Roelofsen & Chilion Snoek) -* Finnish (thanks to vahalan) -* French (thanks to Victor Felder) -* German (thanks to Stephan Knauß) -* Italian (thanks to Federico Bellucci) -* Japanese (thanks to @west_323) -* Korean (thanks to dokenzy) -* Lithuanian (thanks to Vincent G) -* Norwegian (thanks to Jackalworks) -* Persian (thanks to MahdiY) -* Polish (thanks to Bartosz Romanowski, Robert Korulczyk) -* Portuguese (thanks to Adonai S. Canez) -* Russian (thanks to Minimus & Di_Skyer) -* Slovak (thanks to Branco, webhostgeeks/) -* Slovenian (thanks to Jan Sušnik, http://jodlajodla.si/) -* Spanish (thanks to Hermann Bravo) -* Tamil (thanks to KKS21199) -* Turkish (thanks to Hakan) -* Ukrainian (thanks to Michael Yunat) -* Help from translators at improving/adding to this list greatly appreciated! - -**Articles** - -These are helpful for discovering new features. - -* Internal Post Management in Crayon -* Converting Legacy Tags to <pre> -* Crayon with bbPress -* Line Ranges in Crayon -* Crayon Tag Editor -* Mixed Language Highlighting in Crayon -* Mini Tags And Plain Tags In Crayon -* Inline Tags -* Enqueuing Themes and Fonts in Crayon - -**The Press** - -A handful of articles from others written about Crayon, thanks guys! - -* Crayon Syntax Highlighter Plugin Theme Color Previews -* Using Crayon Syntax Highlighter WordPress plugin to post code snippets on your blog -* How to post source code on WordPress -* Syntax highlighter switched to Crayon -* 5 Best Syntax Highlighter Plugins for WordPress -* How To Post Source Code In Wordpress -* Top 5 Syntax Highlighter WordPress Plugins -* Crayon Syntax Highlighter � Plugin -* State of syntax highlighter support in bbPress 2 -* The ultimate plugin for displaying code in WordPress (French) -* Finally!, A WordPress code syntax highlighting that works -* Crayon Syntax Highlighter (and its studly author) -* Add Code To Your WordPress Posts With Crayon Syntax Highlighter -* 15 Best Syntax Highlighter WordPress Plugins -* Displaying Code in WordPress with Crayon -* ABAP Syntax Highlighting in WordPress (German) -* Crayon Syntax Highlighter plugin -* Crayon Syntax Highlighter (Russian) -* Crayon Syntax Highlighter (also Russian) -* How To Post Source Code -* http://wp-best-practices.asdf573189.com/home/good-plugins/crayon-syntax-highlighter/ -* http://www.wplover.com/2155/crayon-syntax-highlighter-plugin/ -* http://www.htmlandphp.com/scripts/crayon-syntax-highlighter.html - -**Donations** - -Thanks to all those who donate to the project: - -* Joe Sabate, Spain -* Kai Chen, Canada -* Chen Kaiyuan, China -* Kamarul Musa, Malaysia -* WallyWare, Inc., (https://pi-plates.com), USA -* Stéphane Rochat, (http://stephanerochat.ch), Switzerland -* Brennan Hale-Matthews, Canada -* Robert Giczewski, (http://www.lazydaemon.de/), Germany -* Hoke Media, (http://hoke.media/), USA -* Matthew Hood, Australia -* Brian Williams, USA -* Christian Martens, (http://insgesamt.net/), Germany -* Nilesh Govindrajan, (http://nileshgr.com/), India -* ZengChun Yang, China -* Alan Kaplan, (http://www.akaplan.com/blog), USA -* Christopher Yarbrough, (http://chrisyarbrough.com/), Germany -* Johann Weiher, (http://codequartett.de/), Germany -* Samuel Deering, Australia -* Billiard Greg, (http://billiardgreg.com/), USA -* Performance Simulations, (http://www.performancesimulations.com/), USA -* Lindsay Ross, (http://gravelrash.com), New Zealand -* Ruperto Coronado Muñoz, Mexico -* Stefan Onderka, (http://www.onderka.com), Germany -* Peter Kellner, (http://peterkellner.net), USA -* Open Hardware Design Group LLC, (http://opensourcehardwaregroup.com/), USA -* Helen McManus, (http://invisiblepixels.org/InvisibleWords/), Netherlands -* Thomas Fee, UK -* Julie Knowles, (http://knowlesfamily.com/), USA -* Peter Kriegel, (http://www.powershell-group.eu/), Germany -* Geo My WP, (http://geomywp.com), USA -* Raffael Vogler, Germany -* Erdal Cicek, Turkey -* Cloud-VPS, Poland -* Łukasz Bereza, Poland -* Laurence Scotford, UK -* Goretity Árpád László, (http://h2co3.org/blog), Hungary -* AdsProvider, USA -* Alicia Ramirez, (http://aliciaramirez.com/), Canada -* William Eisert, USA -* Inappix Development, (http://www.inappix.com/), Switzerland -* Stephen Sant, (http://thesantfamily.net/), UK -* David Rodriguez, (http://davidarodriguez.com/), USA -* Chris Moore, (http://moorecreativeideas.com/), USA -* Sohail Ahmed, (http://sohail.io.com/), USA -* Vanessa Garcia Espin, Spain -* Samad Malik, (http://samadmalik.com/), USA -* Wabbit Wanch Design, (http://www.wabbitwanch.com/), Canada -* Inopox Ltd, (http://inopox.com/), Cyprus -* Kho Minh Vi, (http://khominhvi.com/), UK -* Ivan Churakov, Russia -* Carla Macías González, Mexico -* Saulius Stonys, Lithuania -* Konstantin Sabel, Germany -* Luigi Massa, (http://bwlab.it/), Italy -* Anthony Steiner, (http://steinerd.com/), USA -* Alexander Harvey, (http://alexharvey.eu/), UK -* Minhazul Haque Shawon, Cyprus -* Raam Dev, (http://raamdev.com/), USA -* Scot Ranney, (http://scotsscripts.com/), USA -* Nico Hartung, (http://www.loggn.de/), Germany -* Joseph DeVenuta, USA -* Iván Prego García, Spain -* Johannes Luijten, (http://www.tweaking4all.com/, http://www.weethet.nl/), USA -* Jack Fruh, (http://basementjack.com/), USA -* Ross Barbieri, USA -* Will, Simple Phishing Toolkit (http://www.sptoolkit.com/), USA -* Tricia Aanderud, USA -* Tarek Sakr, (http://centrivision.com/), USA -* Jeff Benshetler, (http://branchpoint.net/), USA -* Oldrich Strachota, (http://www.strachota.net/), Czech Republic -* Dividend Ninja, (http://dividendninja.com/), Canada -* Chris Wiegman, (http://bit51.com/), USA -* Sven Meier, (http://www.codesix.net/), Germany -* Christy Wiggins, (http://www.jinxyisms.com/), USA -* eSnipe, Inc. (http://esnipe.com/), USA (again!) -* Aliseya Wright, (http://blog.xoxothemes.com/), USA -* Jeremy Worboys (http://complexcompulsions.com/), Australia -* Steve McGough, Spider Creations, LLC. (http://spidercreations.net/), USA -* eSnipe, Inc. (http://esnipe.com/), USA -* Gerald Drouillard (http://www.drouillard.biz/), USA -* Greg Pettit (http://blog.monkey-house.ca/), Canada -* Waimanu Solutions (http://daveblog.waimanu.web44.net/), USA -* Andrew McDonnell (http://blog.oldcomputerjunk.net/), Australia -* Perry Bonewell (http://pointatthemoon.co.uk/), United Kingdom -* Nick Weisser (http://www.openstream.ch/), Switzerland - -== Installation == - -* Download the .zip of the plugin and extract the contents. -* Upload it to the Wordpress plugin directory and activate the plugin. -* Even easier, just go to Plugins > Add New and search for "Crayon". -* You can change settings and view help under Settings > Crayon in the Wordpress Admin. -* Make sure your theme either manually specifies jQuery, or uses the version shipped with Wordpress (recommended). You should NOT print out jQuery manually in the header as a script tag. Enqueueing it in Wordpresss will prevent duplicate jQuery includes (also bad) and will allow other scripts to be placed AFTER jQuery in the head tag so they can use it. If you're uncertain, just let Wordpress handle it and remove any jQuery script tags you find in your theme's header.php. - -== Frequently Asked Questions == - -Please see the documentation for all the details. - -= Support = - -Contact me at http://twitter.com/crayonsyntax or crayon.syntax@gmail.com. - -== Screenshots == - -1. Classic theme. -2. Twilight theme. -3. Mixed Language Highlighting. -4. Tag Editor. -5. Theme Editor. +Open for PRs. Please see the original repository for credits. == Changelog ==