@mikado7/ckeditor5-mathlive
v0.0.3
Published
A plugin for CKEditor 5.
Downloads
76
Maintainers
Readme
@mikado7/ckeditor5-mathlive
This package was created by the ckeditor5-package-generator package.
Table of contents
Developing the package
To read about the CKEditor 5 Framework, visit the CKEditor 5 Framework documentation.
Available scripts
NPM scripts are a convenient way to provide commands in a project. They are defined in the package.json
file and shared with people contributing to the project. It ensures developers use the same command with the same options (flags).
All the scripts can be executed by running npm run <script>
. Pre and post commands with matching names will be run for those as well.
The following scripts are available in the package.
start
Starts an HTTP server with the live-reload mechanism that allows previewing and testing of plugins available in the package.
When the server starts, the default browser will open the developer sample. This can be disabled by passing the --no-open
option to that command.
You can also define the language that will translate the created editor by specifying the --language [LANG]
option. It defaults to 'en'
.
Examples:
# Starts the server and open the browser.
npm run start
# Disable auto-opening the browser.
npm run start -- --no-open
# Create the editor with the interface in German.
npm run start -- --language=de
test
Allows executing unit tests for the package, specified in the tests/
directory. The command accepts the following modifiers:
--coverage
– to create the code coverage report,--watch
– to observe the source files (the command does not end after executing tests),--source-map
– to generate source maps of sources,--verbose
– to print additional webpack logs.
Examples:
# Execute tests.
npm run test
# Generate code coverage report after each change in the sources.
npm run test -- --coverage --test
lint
Runs ESLint, which analyzes the code (all *.ts
files) to quickly find problems.
Examples:
# Execute eslint.
npm run lint
stylelint
Similar to the lint
task, stylelint analyzes the CSS code (*.css
files in the theme/
directory) in the package.
Examples:
# Execute stylelint.
npm run stylelint
build:dist
Creates npm and browser builds of your plugin. These builds can be added to the editor by following the Configuring CKEditor 5 features guide.
Examples:
# Builds the `npm` and browser files thats are ready to publish.
npm run build:dist
translations:collect
Collects translation messages (arguments of the t()
function) and context files, then validates whether the provided values do not interfere with the values specified in the @ckeditor/ckeditor5-core
package.
The task may end with an error if one of the following conditions is met:
- Found the
Unused context
error – entries specified in thelang/contexts.json
file are not used in source files. They should be removed. - Found the
Context is duplicated for the id
error – some of the entries are duplicated. Consider removing them from thelang/contexts.json
file, or rewrite them. - Found the
Context for the message id is missing
error – entries specified in source files are not described in thelang/contexts.json
file. They should be added.
Examples:
npm run translations:collect
translations:download
Download translations from the Transifex server. Depending on users' activity in the project, it creates translation files used for building the editor.
The task requires passing the URL to Transifex API. Usually, it matches the following format: https://www.transifex.com/api/2/project/[PROJECT_SLUG]
.
To avoid passing the --transifex
option whenever you call the command, you can store it in package.json
, next to the ckeditor5-package-tools translations:download
command.
Examples:
npm run translations:download -- --transifex [API URL]
translations:upload
Uploads translation messages onto the Transifex server. It allows users to create translations into other languages using the Transifex platform.
The task requires passing the URL to the Transifex API. Usually, it matches the following format: https://www.transifex.com/api/2/project/[PROJECT_SLUG]
.
To avoid passing the --transifex
option whenever you call the command, you can store it in package.json
, next to the ckeditor5-package-tools translations:upload
command.
Examples:
npm run translations:upload -- --transifex [API URL]
ts:build
and ts:clear
These scripts compile TypeScript and remove the compiled files. They are used in the aforementioned life cycle scripts, and there is no need to call them manually.
License
The @mikado7/ckeditor5-mathlive
package is available under MIT license.
However, it is the default license of packages created by the ckeditor5-package-generator package and can be changed.