Please note that this documentation is not all-inclusive, a more detailed instruction manual will be available as openWYSIWYG matures. The good news, this document will walk you through the basics of getting started.

If you have any suggestions on how to improve this document, or feel your contributions will make it more complete, please contact us. We're always looking for ways to improve, whether it's the product itself or the accompanying documentation.

If you are just getting started with openWYSIWYG, then you've come to the right place. This
document explains what openWYSIWYG is, contains information on installing and setting up
openWYSIWYG, answers frequently asked questions, lists the program's requirements, and provides other useful information.

openWYSIWYG is a free cross-browser WYSIWYG (what you see is what you get) editor.
With just a few simple lines of JavaScript code you can easily replace a <textarea>
with a powerful WYSIWYG editor that lets your users do the following:

Format text to be bold, italicized, or underlined.

Change the face, size, style and colour.

Left, centre, or right-justify paragraphs.

Make bulleted or numbered lists.

Indent or un-indent paragraphs.

Insert hyperlinks, images, and tables.

View the HTML source code of what you're editing.

And much more...

What sets openWYSIWYG apart from other WYSIWYG editors?

It loads extremely fast and is completely written in JavaScript and DHTML. No server side code (like PHP) required.

Yes! Unlike other WYSIWYG editors out there you don't have
to fork out big dollars for openWYSIWYG. You can distribute it in your
content management system or custom web application. It's absolutely free!

openWYSIWYG is an open source application released under the
LGPL,
meaning you'll have access to the full source code to modify or customize it to your
needs. Add new features, change the styles, or even optimize the code. It's entirely
up to you.

You can learn more about openWYSIWYG and download the latest version at www.openwebware.com.
There's also an excellent user community where you can share ideas, learn various tricks,
or even post suggestions and comments.

openWYSIWYG is cross-browser compatible and will work with the most popular internet
browsers. This means your users will have no trouble making use of it. Supported browsers include:
IE 5.5+ (Windows), Firefox 1.0+, Mozilla 1.3+ and Netscape 7+.

openWYSIWYG is coded completely in JavaScript, HTML, and CSS.
It also uses images (.gif and .jpg), so if you're uploading these files to your
web server you'll want to make sure they're readable.

On Unix based servers, that means every directory has chmod permissions of 755
while the files (.html, .js, .jpg., .gif, etc) are 644. Most Unix based servers
use these settings for folders and files by default, so you most likely won't
have to change a thing.

The project goals for openWYSIWYG are designed to make it easy for developers who
contribute to the editor to know where it's going. This also lets people know
what's important to us and what we believe makes a good editor.

100% JavaScript

openWYSIWYG must always be coded entirely in JavaScript and DHTML.
This is so developers can use it in their applications regardless of the programming language
they choose to build their web applications, be it Perl, PHP, ASP, Cold Fusion, or any other
language.

That being said, add-ons or plug-ins (e.g. image/media uploading utility) can be coded in
a server side language (Perl, PHP, ASP, etc).

Fast Loading and Unbloated

openWYSIWYG must always be fast loading. Regardless of what feature
is added, it cannot slow down the loading of the editor itself. There are far too many free WYSIWYG
editors out there that take an unbelievable amount of time to load. End users (the very people who will
use your web applications) don't like this!

Also, the editor must not become bloated, filled with features that only a small minority of users
will make use of. If there's ever a doubt to which features you think should be added please
refer to the list of feature recommendations for the next version
found in this document.

Easy to Use

openWYSIWYG must be easy to use for developers to integrate into
their applications, easy for programmers to add new features, and easy for end users
to use.

Absolutely. Whether you're just starting with openWYSIWYG, are a developer or programmer,
or have your own website, almost anyone can help.

If You're a Programmer or Developer

Any code improvements you want to share are most certainly
welcome. After all, openWYSIWYG is open source, so we're always open to suggestions and
improvements.

If you notice anything that you can do better, or have an improvement you would like to make
you can always share it with others in the
openWYSIWYG forum, or send us an email with
your code improvements, new features, or suggestions.

If you're not sure where to get started you can always check out the feature
recommendations slated for the next version.

All contributions will be credited to the creator in the openWYSIWYG source code and on the
openwebware.com website.

If You're a Webmaster or Site Owner

As a webmaster, the best thing you can do to help is also the easiest thing to do;
give us a link on your website. The more people who can find out about openWYSIWYG the
better it will be.

Just copy the HTML from one of the code samples below and place it somewhere on your
website.

Probably not. If it's not listed in the feature recommendations for
the next version we just won't have the time to work on it. That doesn't mean you can't work on it
or post a message
in the forum asking if someone else could help you with it.

It's not that we don't want to, we just don't yet. Our first goal was to provide support for
the most popular browsers, those being Internet Explorer and Mozilla (Mozilla and Firefox).
Safari is definitely something we would like to support since it's gaining in popularity
within the Mac community. While not fully tested, if your users are working with Macs
they should be able to access openWYSIWYG using a Mozilla based browser (e.g. Mozilla or Firefox).

As for Opera, to be realistic, we currently don't have any plans to support it. Opera
just hasn't reached a level of popularity to justify the time required to develop support for it.

While Undo/Redo works perfectly fine in Mozilla and Mozilla
Firefox, unfortunately at the moment it doesn't work in IE. Every time a user makes a change
to text in openWYSIWYG we update the content to WYSIWYG's respective <textarea> field.
This is so you never loose any text formatting when submitting the form. It seems that Internet
Explorer's Undo/Redo cache is reset every time the WYSIWYG's respective <textarea> field
is updated. We hope to find a way to address this issue in the future.

Included below is a list of features and fixes recommended for the next update
to openWYSIWYG. We could really use your help, so if you would like to lend a hand
let us know, any additions and
enhancements will be credited in the source code and on the openwebware.com website.