2015-03-04 17:14:04 -06:00
|
|
|
LibreOffice On-Line WebSocket server
|
2015-04-21 05:48:17 -05:00
|
|
|
====================================
|
2015-03-04 17:14:04 -06:00
|
|
|
|
2015-04-21 05:48:17 -05:00
|
|
|
Installation
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
LibreOffice On-Line WebSocket server has the following dependencies:
|
|
|
|
|
|
|
|
|
|
* libpng
|
|
|
|
|
* Poco library: http://pocoproject.org/index.html.
|
|
|
|
|
|
|
|
|
|
Poco can be built with ./configure --prefix=/opt/poco && make install, but
|
|
|
|
|
distro packages exist too.
|
|
|
|
|
|
|
|
|
|
On openSUSE, you can use:
|
|
|
|
|
|
|
|
|
|
zypper ar http://download.opensuse.org/repositories/devel:/libraries:/c_c++/openSUSE_13.2/devel:libraries:c_c++.repo
|
|
|
|
|
zypper in poco
|
|
|
|
|
|
|
|
|
|
Building
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
loolwsd uses autoconf/automake, so build using the usual:
|
|
|
|
|
|
|
|
|
|
autoreconf
|
|
|
|
|
automake --add-missing
|
|
|
|
|
./configure --enable-silent-rules --with-lokit-path=<...>/include
|
|
|
|
|
make
|
2015-03-04 17:14:04 -06:00
|
|
|
|
2015-04-21 05:48:17 -05:00
|
|
|
where <...> is the location of the LibreOffice source tree.
|
2015-03-04 17:14:04 -06:00
|
|
|
|
2015-04-21 05:48:17 -05:00
|
|
|
If you have self-built Poco, add the following to ./configure:
|
2015-03-04 17:14:04 -06:00
|
|
|
|
2015-04-21 05:48:17 -05:00
|
|
|
--with-poco-includes=<...>/include --with-poco-libs=<...>/lib
|
2015-03-18 08:36:27 -05:00
|
|
|
|
2015-04-21 05:48:17 -05:00
|
|
|
If you have the Poco debugging libraries (eg. you have a self-built Poco), you
|
|
|
|
|
can add --enable-debug to the configure options for additional debugging.
|
2015-03-09 04:30:56 -05:00
|
|
|
|
|
|
|
|
For Windows, a proper VS2013 project is needed.
|
2015-03-04 17:14:04 -06:00
|
|
|
|
2015-04-14 04:54:41 -05:00
|
|
|
There is still unconditional debugging output etc. This is a work in progress.
|
2015-03-04 17:14:04 -06:00
|
|
|
|
2015-04-21 05:48:17 -05:00
|
|
|
Running
|
|
|
|
|
-------
|
2015-03-04 17:14:04 -06:00
|
|
|
|
2015-04-21 05:48:17 -05:00
|
|
|
Run the loolwsd in the daemon mode:
|
|
|
|
|
|
|
|
|
|
./loolwsd --lopath=<...>/instdir/program
|
|
|
|
|
|
|
|
|
|
and connect loleaflet to that (see loleaflet/README for more info).
|
|
|
|
|
|
|
|
|
|
Again, <...> is location of the LibreOffice source tree with a built
|
|
|
|
|
LibreOffice. This is work in progress, and consequently needs the latest
|
|
|
|
|
LibreOffice master.
|
|
|
|
|
|
|
|
|
|
For testing purposes, you can use the loolwsd testing mode:
|
|
|
|
|
|
|
|
|
|
(echo load foo.odt; echo tile width=500 height=500 tileposx=0 tileposy=0 tilewidth=10000 tileheight=10000; sleep 10) |
|
|
|
|
|
./loolwsd --lopath=<...>/instdir/program --test
|
2015-03-04 17:14:04 -06:00
|
|
|
|
|
|
|
|
The handling of termination is a bit fragile, occasionally it dumps
|
2015-04-21 05:48:17 -05:00
|
|
|
core somewhere in LO code when quitting. Don't be scared, work in progress.
|
|
|
|
|
|
|
|
|
|
Protocol description
|
|
|
|
|
--------------------
|
|
|
|
|
|
|
|
|
|
See protocol.txt for a description of the protocol to be used over the
|
|
|
|
|
websocket.
|
