Advanced Usage¶
Applying custom CSS¶
The content_style and content_css TinyMCE configuration options allow to define custom Cascading Style Sheets for the content in TinyMCE editor window.
The contents_style
option defines inline styles and the content_css
option defines a URL or a list of URLs
for CSS files. For large Style Sheets the latter option is preferable because a browser can cache CSS files.
For example, if your website uses Bootstrap styles, you can apply those styles to edited content in the TinyMCE widget:
TINYMCE_DEFAULT_CONFIG = {
...
'content_css': 'https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css',
...
}
Code Samples¶
TinyMCE v.4.3 and later includes codesample plugin that allows to insert the samples of programming code
into edited content with pretty syntax highlighting. The codesample
plugin uses Prism library
for syntax highlighting (default theme). The plugin supports the following languages:
HTML/XML, JavaScript, CSS, PHP, Ruby, Python, Java, C# and C/C++.
The codesample
plugin already includes the necessary Prism components to correctly display code samples
in TinyMCE, but to make code samples correctly appear on webpages authored with TinyMCE you need to include
the links to Prism JavaScript/CSS files into the HTML code of your pages. The tinymce4-lite application already
includes prism.js
and prism.css
files that can be referenced in your Django templates.
For example:
{% load static from staticfiles %}
<!DOCTYPE html>
<html>
<head>
...
<!-- Prism CSS -->
<link href="{% static "tinymce/css/prism.css" %}" rel="stylesheet">
</head>
<body>
...
<!-- Prism JS -->
<script src="{% static "tinymce/js/prism.js" %}"></script>
</body>
</html>
You can use different Prism themes for your webpages but in TinyMCE the content is always displayed with the default Prism theme.
The Preview Button¶
The preview plugin in TinyMCE 4, unlike in TinyMCE 3, does not support custom preview dialogs. Use custom Style Sheets as described in the first subsection on this page. They work for the preview window too.