A Django app to easyily integrate highlight.js syntax highlighter.
Project description
Use Highlight.js (https://highlightjs.org) in your Django templates, the Django way.
Installation
Install using pip:
pip install django-highlightjs
Alternatively, you can install download or clone this repo and call pip install -e ..
Add to INSTALLED_APPS in your settings.py:
'highlightjs',
In your templates, load the highlightjs library and use the highlightjs_* tags:
Settings
The django-highlightjs has some pre-configured settings. They can be modified by adding a dict variable called HIGHLIGHTJS in your settings.py and customizing the values you want. The HIGHLIGHTJS dict variable is contains these settings and defaults:
HIGHLIGHTJS = { # The URL to the jQuery JavaScript file 'jquery_url': '//code.jquery.com/jquery.min.js', # The highlight.js base URL 'base_url': '//cdnjs.cloudflare.com/ajax/libs/highlight.js/11.7.0/highlight.min.js', # The complete URL to the highlight.js CSS file 'css_url': '//cdnjs.cloudflare.com/ajax/libs/highlight.js/11.7.0/styles/{0}.min.css', # Include jQuery with highlight.js JavaScript (affects django-highlightjs template tags) 'include_jquery': False, # The default used style. 'style': 'monokai_sublime', }
- Usage in your settings.py:
HIGHLIGHTJS = { 'style': 'github', }
All other styles available at https://github.com/isagalaev/highlight.js/tree/main/src/styles
Example template
{% load highlightjs %} <html> <head> <link href="{% highlightjs_css_url %}" rel='stylesheet' type='text/css'> </head> <body> {# Highlight Syntax using Highlightjs #} {% highlightjs_this code_to_highlight %} {% highlightjs_this code_to_highlight 'python' %} {% highlightjs_javascript jquery=1 %} </body> </html>
Requirements
Python 3.8, 3.9, 3.10 or 3.11
Django >= 3
Contributions and pull requests for other Django and Python versions are welcome.
Bugs and requests
If you have found a bug or if you have a request for additional functionality, please use the issue tracker on GitHub.
https://github.com/mounirmesselmeni/django-highlightjs/issues
License
You can use this under MIT See LICENSE file for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_highlightjs-0.2.10.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0c08adaa5488092038c1e8778de46aa8339c026d11a157eb2e52118a7d8b7bfa |
|
MD5 | 0c458b7e73c61c1f6220b4e52b76ef68 |
|
BLAKE2b-256 | a689f6acb3bb9327a3d08665eeb42394076fd67dede913582ab30a4185c6f3e2 |
Hashes for django_highlightjs-0.2.10-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e41bca06cc8b22e81d9798cc806ce00a51f39fbe125781ed5b4adef82623c005 |
|
MD5 | c234e14ee45d518d7d9286616d49f4c6 |
|
BLAKE2b-256 | 68b1bb2d358b40da231ac3345a7bc2bb65358fceb6014bc16ec0d10e0ba6672c |