pad.pub0.org/README.md

63 lines
3.4 KiB
Markdown
Raw Normal View History

2011-04-07 14:17:40 +00:00
# About
2011-04-07 13:35:13 +00: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-07-25 22:41:14 +00:00
is based on node.js what makes it much ligther and more stable than the original Etherpad. Our hope
2011-04-07 13:35:13 +00:00
is that this will encourage more users to install a realtime collaborative editor. A smaller and well
2011-06-30 17:43:27 +00:00
documented codebase makes it easier for developers to improve the code. Etherpad Lite is optimized
to be easy embeddable
2011-04-07 13:35:13 +00:00
2011-06-02 11:29:09 +00:00
**Online demo**<br>
2011-07-11 20:50:08 +00:00
Visit <http://pitapoison.de:9001> to test it live. You can find the same instance behind a nginx, with ssl and in a subpath here -> [https://pad.pitapoison.de/pad/](https://pad.pitapoison.de/pad/)
2011-05-23 19:15:45 +00:00
2011-06-30 17:43:27 +00:00
# Etherpad vs Etherpad Lite
<table>
<tr>
2011-07-07 17:21:20 +00:00
<td>&nbsp;</td><td><b>Etherpad</b></td><td><b>Etherpad Lite</b></td>
2011-06-30 17:43:27 +00:00
</tr>
<tr>
2011-07-07 17:21:20 +00:00
<td align="right">Size of the folder (without git history)</td><td>30 MB</td><td>1.5 MB</td>
2011-06-30 17:43:27 +00:00
</tr>
<tr>
2011-07-07 17:21:20 +00:00
<td align="right">Languages used server side</td><td>Javascript (Rhino), Java, Scala</td><td>Javascript (node.js)</td>
2011-06-30 17:43:27 +00:00
</tr>
<tr>
2011-07-07 17:21:20 +00:00
<td align="right">Lines of server side Javascript code</td><td>101410</td><td>5330</td>
2011-06-30 17:43:27 +00:00
</tr>
<tr>
2011-07-07 17:21:20 +00:00
<td align="right">RAM Usage immediately after start</td><td>257 MB</td><td>16 MB</td>
2011-06-30 17:43:27 +00:00
</tr>
</table>
2011-04-07 13:35:13 +00:00
# Installation
2011-07-07 17:21:20 +00:00
1. Download latest node.js version from <http://nodejs.org/> and build it with this instructions <https://github.com/joyent/node/wiki/Installation>. <br>
The Node.js version of your Linux repository might be too old/new. Please compile from the source to get sure you have the correct version. We support node.js version 0.4.*
2011-06-02 11:29:09 +00:00
2. Install npm `curl http://npmjs.org/install.sh | sh`
3. Ensure you have installed the sqlite develob libraries, gzip and git `apt-get install libsqlite3-dev gzip git-core`
4. Clone the git repository `git clone 'git://github.com/Pita/etherpad-lite.git'`
5. Install the dependencies `cd etherpad-lite && npm install`
2011-06-02 11:29:09 +00:00
6. Start it with `bin/run.sh`
7. Open your web browser and visit <http://localhost:9001>
2011-04-07 13:35:13 +00:00
2011-06-02 11:29:09 +00:00
# Next Steps
You can modify the settings in the file settings.json
2011-04-07 14:17:40 +00:00
You can update to the latest version with `git pull origin && npm install`
2011-06-02 11:29:09 +00:00
You can debug with `bin/runDebug.sh`
2011-07-11 20:45:19 +00:00
Look at the Wiki: [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 deploy Etherpad Lite as a service](https://github.com/Pita/etherpad-lite/wiki/How-to-deploy-Etherpad-Lite-as-a-service). Feel free to improve these wiki pages
2011-06-02 11:29:09 +00:00
# Develop
If you're new to git and github, start here <http://learn.github.com/p/intro.html>.
If you're new to node.js, start with this video <http://youtu.be/jo_B4LTHi3I>.
2011-07-24 17:39:25 +00:00
If you wanna 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 it).
2011-06-02 11:29:09 +00: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)
You also help the project, if you only host a ep-lite instance and share your experience with us.
2011-04-07 14:17:40 +00:00
# License
2011-07-25 22:41:14 +00:00
[Apache License v2](http://www.apache.org/licenses/LICENSE-2.0.html)