Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/GetmeUK/ContentTools
A JS library for building WYSIWYG editors for HTML content.
https://github.com/GetmeUK/ContentTools
contenttools wysiwyg-editors
Last synced: about 2 months ago
JSON representation
A JS library for building WYSIWYG editors for HTML content.
- Host: GitHub
- URL: https://github.com/GetmeUK/ContentTools
- Owner: GetmeUK
- License: mit
- Created: 2015-08-09T12:44:12.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2022-11-05T18:32:06.000Z (almost 2 years ago)
- Last Synced: 2024-07-17T09:08:08.930Z (2 months ago)
- Topics: contenttools, wysiwyg-editors
- Language: JavaScript
- Homepage: http://getcontenttools.com
- Size: 1.9 MB
- Stars: 3,947
- Watchers: 132
- Forks: 393
- Open Issues: 101
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-wysiwyg - Content Tools - A JS library for building WYSIWYG editors for HTML content. (Standalone)
- awesome-wysiwyg-editors - Content Tools - 一个用于构建 HTML 内容的所见即所得编辑器的 JS 库。  (独立的)
- starred-awesome - ContentTools - A JS library for building WYSIWYG editors for HTML content. (JavaScript)
- jimsghstars - GetmeUK/ContentTools - A JS library for building WYSIWYG editors for HTML content. (JavaScript)
README
> *For information on the ContentTools 2.x roadmap please view the: [Roadmap repo](https://github.com/GetmeUK/contenttools-2-roadmap)*
---
# ContentTools
[](https://travis-ci.org/GetmeUK/ContentTools)
> A JS library for building WYSIWYG editors for HTML content.
## Install
**Using bower**
```
bower install --save ContentTools
```
**Using npm**
```
npm install --save ContentTools
```
## Building
To build the library you'll need to use Grunt. First install the required node modules ([grunt-cli](http://gruntjs.com/getting-started) must be installed):
```
git clone https://github.com/GetmeUK/ContentTools.git
cd ContentTools
npm install
```
Install Sass (if not already installed):
```
gem install sass
```
Then run `grunt build` to build the project.
## Testing
To test the library you'll need to use Jasmine. First install Jasmine:
```
git clone https://github.com/pivotal/jasmine.git
mkdir ContentTools/jasmine
mv jasmine/dist/jasmine-standalone-2.0.3.zip ContentTools/jasmine
cd ContentTools/jasmine
unzip jasmine-standalone-2.0.3.zip
```
Then open `ContentTools/SpecRunner.html` in a browser to run the tests.
Alternatively you can use `grunt jasmine` to run the tests from the command line.
## ContentTools via jsdelivr
ContentTools is available via the [jsdelivr open source CDN](http://www.jsdelivr.com/), to reference a file from the ContentTools build directory use the following URL format:
`http://cdn.jsdelivr.net/npm/ContenTools@{version}/{file}`
For example to access the current primary JavaScript file the URL would be:
`https://cdn.jsdelivr.net/npm/[email protected]/build/content-tools.min.js`
As the project's CSS uses relative file paths you will need to either role your own version of CSS from the SASS files (recommended) or [override references to fonts/images within your local CSS](https://gist.github.com/anthonyjb/a6aec8ecfbfe6f875d5c6691687ba43d).
## Documentation
Full documentation is available at http://getcontenttools.com/api/content-tools
## Where to post...
- How do I? -- StackOverflow
- I got this error, why? -- StackOverflow
- I got this error and I'm sure it's a bug -- post an issue
- I have an idea/request -- post an issue
- Why do you? -- chat with me on gitter (I may then post it as an issue)
- When will you? -- chat with me on gitter (I may then post it as an issue)
- You suck and I hate you -- contact us privately at [email protected]!
- You're awesome -- please find a megaphone and suitably high rooftop (but seriously any help spreading the word about ContentTools is much appreciated)
> Stolen almost in it's entirety from this [post](http://meta.stackexchange.com/questions/3966/is-it-okay-to-use-stack-overflow-as-the-support-forum-for-a-product-or-project) on meta.stackexchange.com
## Browser support
The current aim is for all the libraries to support IE9+, Chrome and Firefox. Test suites are complete for all the libraries except ContentTools and I'm using Jasmine to check that the tests pass in those browsers.
There will be some visual differences for ContentTools in IE9 as I use CSS animations for some of the UI feedback.
## Helpful organizations
ContentTools is developed using a number of tools & services provided for free by nice folks at organizations committed to supporting open-source projects including [BrowserStack](http://www.browserstack.com), [GitHub](https://github.com) and [jsdelivr](http://www.jsdelivr.com/), [Travis CI](https://travis-ci.org).