Quill composer for NodeBB
This plugin activates the WYSIWYG Quill composer for NodeBB. Please ensure that:
- The markdown plugin is disabled (see note below, re: markdown)
- Any other composers (i.e. nodebb-plugin-composer-default) are disabled
- Warning This composer saves its data in a unique format that is only compatible with Quill. If you switch to Quill, any posts made with Quill cannot be migrated back to Markdown.
If you used the default composer, chances are you also had the markdown plugin active. If that is the case, any posts made before the switch are still in markdown format, and are not saved into html (in a manner than quill can digest). A migrator tool has been bundled with v1.1 of the Quill Composer, which you can use to migrate posts in markdown and html into the Quill-compatible format.
Your posts should automatically work with Quill. Redactor saves HTML into the database, and the Quill plugin is set up so it can digest that html and backport it to Quill's internal format if the post is edited. That said, when you edit a post originally made in Redactor, you'll see the html tags, which are now extraneous. You can remove them as part of your edit. Alternatively, you can use the bundled migrator to convert posts to the Quill-compatible format.
This plugin is in its early stages. If you'd like to look at the documentation and add a feature, or take a look at the GitHub Issues and do something from there then please do. All pull requests lovingly reviewed.
When this plugin is linked...
If you use (npm|yarn) link to connect this plugin to your local development environment, you may run into an issue with CSS being missing because NodeBB cannot find the stylesheet.
The reason is because when checked out from the repository, the subdependency
quill is installed in
node_modules/ inside your folder. Whereas when installed via the forum,
quill is put side-by-side with
nodebb-plugin-composer-quill and thus the location of the CSS file is different.
To resolve this, run the following commands:
cd /path/to/nodebb/node_modules ln -s /path/to/quill/node_modules/quill ./quill