etherpad-lite/README.md

131 lines
7.3 KiB
Markdown
Raw Normal View History

2011-08-21 18:23:04 +02:00
# Our goal is to make collaborative editing the standard on the web
2011-04-07 16:17:40 +02:00
# About
2011-04-07 15:35:13 +02:00
Etherpad lite is a really-real time collaborative editor spawned from the Hell fire of Etherpad.
We're reusing the well tested Etherpad easysync library to make it really realtime. Etherpad Lite
2011-08-21 18:23:04 +02:00
is based on node.js ergo is much lighter and more stable than the original Etherpad. Our hope
2011-08-21 18:58:12 +02:00
is that this will encourage more users to use and install a realtime collaborative editor. A smaller, manageable and well
2011-08-21 18:23:04 +02:00
documented codebase makes it easier for developers to improve the code and contribute towards the project.
Etherpad Lite is optimized to be easy embeddable. It provides a [HTTP API](https://github.com/Pita/etherpad-lite/wiki/HTTP-API)
that allows your web application to manage pads, users and groups.
2011-11-18 22:56:26 +01:00
There are several clients in for this API:
* [PHP](https://github.com/TomNomNom/etherpad-lite-client), thx to [TomNomNom](https://github.com/TomNomNom)
* [.Net](https://github.com/ja-jo/EtherpadLiteDotNet), thx to [ja-jo](https://github.com/ja-jo)
* [Node.js](https://github.com/tomassedovic/etherpad-lite-client-js), thx to [tomassedovic](https://github.com/tomassedovic)
* [Ruby](https://github.com/jhollinger/ruby-etherpad-lite), thx to [jhollinger](https://github.com/jhollinger)
* [Python](https://github.com/devjones/PyEtherpadLite), thx to [devjones](https://github.com/devjones)
2011-08-21 18:23:04 +02:00
There is also a [jQuery plugin](https://github.com/johnyma22/etherpad-lite-jquery-plugin) that helps you to embed Pads into your website
2011-04-07 15:35:13 +02:00
2011-06-02 13:29:09 +02:00
**Online demo**<br>
2011-08-23 18:56:54 +02:00
Visit <http://beta.etherpad.org> to test it live
2011-08-21 18:23:04 +02:00
Here is the **[FAQ](https://github.com/Pita/etherpad-lite/wiki/FAQ)**
2011-05-23 21:15:45 +02:00
2011-06-30 19:43:27 +02:00
# Etherpad vs Etherpad Lite
<table>
<tr>
2011-07-07 19:21:20 +02:00
<td>&nbsp;</td><td><b>Etherpad</b></td><td><b>Etherpad Lite</b></td>
2011-06-30 19:43:27 +02:00
</tr>
<tr>
2011-07-07 19:21:20 +02:00
<td align="right">Size of the folder (without git history)</td><td>30 MB</td><td>1.5 MB</td>
2011-06-30 19:43:27 +02:00
</tr>
<tr>
2011-07-07 19:21:20 +02:00
<td align="right">Languages used server side</td><td>Javascript (Rhino), Java, Scala</td><td>Javascript (node.js)</td>
2011-06-30 19:43:27 +02:00
</tr>
<tr>
2011-08-23 18:56:54 +02:00
<td align="right">Lines of server side Javascript code</td><td>~101k</td><td>~9k</td>
2011-06-30 19:43:27 +02:00
</tr>
<tr>
2011-08-23 18:56:54 +02:00
<td align="right">RAM Usage immediately after start</td><td>257 MB (grows to ~1GB)</td><td>16 MB (grows to ~30MB)</td>
2011-06-30 19:43:27 +02:00
</tr>
</table>
2011-04-07 15:35:13 +02:00
# Installation
2011-08-21 18:23:04 +02:00
## Windows
2011-08-12 16:08:27 +02:00
1. Download <http://etherpad.org/etherpad-lite-win.zip>
2. Extract the file
3. Open the extracted folder and double click `start.bat`
2011-08-21 18:23:04 +02:00
4. Open your web browser and browse to <http://localhost:9001>. You like it? Look at the 'Next Steps' section below
2011-08-21 18:23:04 +02:00
## Linux
2011-08-02 23:15:59 +02:00
**As root:**
2011-08-04 21:33:39 +02:00
<ol>
2012-03-10 07:23:05 +01:00
<li>Install the dependencies. We need gzip, git, curl, libssl develop libraries, python and gcc. <br><i>For Debian/Ubuntu</i> <code>apt-get install gzip git-core curl python libssl-dev pkg-config build-essential</code><br>
<i>For Fedora/CentOS</i> <code>yum install gzip git-core curl python openssl-devel && yum groupinstall "Development Tools"</code>
2011-11-18 22:56:26 +01:00
</li><br>
2011-08-04 21:33:39 +02:00
<li>Install node.js
<ol type="a">
2011-11-18 22:56:26 +01:00
<li>Download the latest <b>0.6.x</b> node.js release from <a href="http://nodejs.org/#download">http://nodejs.org/#download</a></li>
<li>Extract it with <code>tar xf node-v0.6*</code></li>
<li>Move into the node folder <code>cd node-v0.6*</code> and build node with <code>./configure && make && make install</code></li>
2011-08-04 21:33:39 +02:00
</ol>
</li>
</ol>
2011-08-02 23:15:59 +02:00
2011-08-09 23:44:33 +02:00
**As any user (we recommend creating a separate user called etherpad-lite):**
2011-08-02 23:15:59 +02:00
2011-12-04 20:11:31 +01:00
<ol start="3">
2011-08-21 18:23:04 +02:00
<li>Move to a folder where you want to install Etherpad Lite. Clone the git repository <code>git clone 'git://github.com/Pita/etherpad-lite.git'</code><br>&nbsp;</li>
2012-03-10 07:23:05 +01:00
<li>Change into the directory containing the Etherpad Lite source code clone with <code>cd etherpad-lite</code><br> </li>
2011-08-21 18:23:04 +02:00
<li>Install the dependencies with <code>bin/installDeps.sh</code><br>&nbsp;</li>
<li>Start it with <code>bin/run.sh</code><br>&nbsp;</li>
<li>Open your web browser and visit <a href="http://localhost:9001">http://localhost:9001</a>. You like it? Look at the 'Next Steps' section below</li>
2011-08-04 21:33:39 +02:00
</ol>
2011-04-07 15:35:13 +02:00
2011-08-02 23:15:59 +02:00
## Next Steps
2011-08-21 18:23:04 +02:00
You can modify the settings in the file `settings.json`
2011-04-07 16:17:40 +02:00
If you have multiple settings files, you may pass one to `bin/run.sh` using the `-s|--settings` option. This allows you to run multiple Etherpad Lite instances from the same installation.
You should use a dedicated database such as "mysql" if you are planning on using etherpad-lite in a production environment, the "dirty" database driver is only for testing and/or development purposes.
2011-08-01 20:24:11 +02:00
You can update to the latest version with `git pull origin`. The next start with bin/run.sh will update the dependencies
2011-06-02 13:29:09 +02:00
2011-08-02 23:15:59 +02:00
Look at this wiki pages:
2011-08-04 21:33:39 +02:00
2011-08-02 23:15:59 +02:00
* [How to deploy Etherpad Lite as a service](https://github.com/Pita/etherpad-lite/wiki/How-to-deploy-Etherpad-Lite-as-a-service)
* [How to put Etherpad Lite behind a reverse Proxy](https://github.com/Pita/etherpad-lite/wiki/How-to-put-Etherpad-Lite-behind-a-reverse-Proxy)
* [How to customize your Etherpad Lite installation](https://github.com/Pita/etherpad-lite/wiki/How-to-customize-your-Etherpad-Lite-installation)
2011-08-21 18:23:04 +02:00
* [How to use Etherpad-Lite with jQuery](https://github.com/Pita/etherpad-lite/wiki/How-to-use-Etherpad-Lite-with-jQuery)
* [How to use Etherpad Lite with MySQL](https://github.com/Pita/etherpad-lite/wiki/How-to-use-Etherpad-Lite-with-MySQL)
2011-08-21 18:58:12 +02:00
* [Sites that run Etherpad Lite](https://github.com/Pita/etherpad-lite/wiki/Sites-that-run-Etherpad-Lite)
* [How to migrate the database from Etherpad to Etherpad Lite](https://github.com/Pita/etherpad-lite/wiki/How-to-migrate-the-database-from-Etherpad-to-Etherpad-Lite)
2011-06-02 13:29:09 +02:00
2011-08-01 20:24:11 +02:00
You can find more information in the [wiki](https://github.com/Pita/etherpad-lite/wiki). Feel free to improve these wiki pages
2011-07-11 22:45:19 +02:00
2011-06-02 13:29:09 +02:00
# Develop
If you're new to git and github, start by watching [this video](http://youtu.be/67-Q26YH97E) then read this [git guide](http://learn.github.com/p/intro.html).
2011-06-02 13:29:09 +02:00
If you're new to node.js, start with this video <http://youtu.be/jo_B4LTHi3I>.
2011-08-02 23:15:59 +02:00
You can debug with `bin/debugRun.sh`
2011-08-21 18:23:04 +02:00
If you want to find out how Etherpads Easysync works (the library that makes it really realtime), start with this [PDF](https://github.com/Pita/etherpad-lite/raw/master/doc/easysync/easysync-full-description.pdf) (complex, but worth reading).
2011-06-02 13:29:09 +02:00
You know all this and just want to know how you can help? Look at the [TODO list](https://github.com/Pita/etherpad-lite/wiki/TODO).
You can join the [mailinglist](http://groups.google.com/group/etherpad-lite-dev) or go to the freenode irc channel [#etherpad-lite-dev](http://webchat.freenode.net?channels=#etherpad-lite-dev)
2011-08-02 23:15:59 +02:00
You also help the project, if you only host a Etherpad Lite instance and share your experience with us.
2011-08-01 20:24:11 +02:00
2011-12-21 21:32:17 +01:00
Please consider using [jshint](http://www.jshint.com/about/) if you plan to
contribute to Etherpad Lite.
2011-08-01 20:24:11 +02:00
# Modules created for this project
* [ueberDB](https://github.com/Pita/ueberDB) "transforms every database into a object key value store" - manages all database access
* [channels](https://github.com/Pita/channels) "Event channels in node.js" - ensures that ueberDB operations are atomic and in series for each key
* [async-stacktrace](https://github.com/Pita/async-stacktrace) "Improves node.js stacktraces and makes it easier to handle errors"
2011-08-01 20:24:11 +02:00
2012-02-26 15:22:32 +01:00
# Donations
2012-02-26 15:24:21 +01:00
* [Etherpad Foundation Flattr] (http://flattr.com/thing/71378/Etherpad-Foundation)
2012-02-29 14:45:42 +01:00
* [Paypal] (http://etherpad.org) <-- Click the donate button
2012-02-26 15:20:50 +01:00
2012-02-26 15:22:32 +01:00
# License
[Apache License v2](http://www.apache.org/licenses/LICENSE-2.0.html)