torchlight / torchlight-laravel
A Laravel Client for Torchlight, the syntax highlighting API.
Installs: 218 642
Dependents: 8
Suggesters: 0
Security: 0
Stars: 113
Watchers: 2
Forks: 16
Open Issues: 14
Requires
- php: ^7.3|^8.0
- guzzlehttp/guzzle: ^7.2
- illuminate/cache: ^8.0|^9.0|^10.0|^11.0
- illuminate/console: ^8.0|^9.0|^10.0|^11.0
- illuminate/http: ^8.0|^9.0|^10.0|^11.0
- illuminate/support: ^8.0|^9.0|^10.0|^11.0
- illuminate/view: ^8.0|^9.0|^10.0|^11.0
- ramsey/uuid: ^3.7|^4.0
Requires (Dev)
- mockery/mockery: ^1.3.3
- orchestra/testbench: ^5.0|^6.0|^7.0|^9.0
- phpunit/phpunit: ^8.5.23|^9.5|^10.5
README
A Torchlight syntax highlighting extension for the Laravel framework.
Torchlight is a VS Code-compatible syntax highlighter that requires no JavaScript, supports every language, every VS Code theme, line highlighting, git diffing, and more.
Installation
To install, require the package from composer:
composer require torchlight/torchlight-laravel
Configuration
Once the package is downloaded, you can run the following command to publish your configuration file:
php artisan torchlight:install
Once run, you should see a new file torchlight.php
in you config
folder, with contents that look like this:
<?php return [ // The Torchlight client caches highlighted code blocks. Here // you can define which cache driver you'd like to use. 'cache' => env('TORCHLIGHT_CACHE_DRIVER'), // Which theme you want to use. You can find all of the themes at // https://torchlight.dev/themes, or you can provide your own. 'theme' => env('TORCHLIGHT_THEME', 'material-theme-palenight'), // Your API token from torchlight.dev. 'token' => env('TORCHLIGHT_TOKEN'), // If you want to register the blade directives, set this to true. 'blade_components' => true, // The Host of the API. 'host' => env('TORCHLIGHT_HOST', 'https://api.torchlight.dev'), ];
Cache
Set the cache driver that Torchlight will use.
Theme
You can change the theme of all your code blocks by adjusting the theme
key in your configuration.
Token
This is your API token from torchlight.dev. (Torchlight is completely free for personal and open source projects.)
Blade Components
By default Torchlight works by using a custom Laravel component. If you'd like to disable the registration of the component for whatever reason, you can turn this to false.
Host
You can change the host where your API requests are sent. Not sure why you'd ever want to do that, but you can!