Index: lams_build/conf/etherpad/readme.txt =================================================================== diff -u -rf9dafe60150e1899c37200977b198e0546ced60c -r9d6c19af8dac107258a3d8de9907784bc357a249 --- lams_build/conf/etherpad/readme.txt (.../readme.txt) (revision f9dafe60150e1899c37200977b198e0546ced60c) +++ lams_build/conf/etherpad/readme.txt (.../readme.txt) (revision 9d6c19af8dac107258a3d8de9907784bc357a249) @@ -1,28 +1,41 @@ Etherpad is required for Dokumaran tool and for Etherpad tag -1) Modifications are required for Etherpad server version 1.8.5, available at - https://github.com/ether/etherpad-lite/tree/1.8.5 +1) Download Etherpad at 1.8.14, available at + https://github.com/ether/etherpad-lite/tree/1.8.14 + + For Windows 10 installation, follow + https://github.com/ether/etherpad-lite/issues/4800#issuecomment-780780133 + Then in node_modules folder create a symbolic link with + mklink /D ep_etherpad-lite ..\src 2) In order to hide Etherpad index page make the following file empty: /${etherpad-lite-server-folder}/src/templates/index.html. Besides, one can turn on "editOnly" option in /${etherpad-lite-server-folder}/settings.json. This option's description: "Users may edit pads but not create new ones. Pad creation is only via the API. This applies both to group pads and regular pads." 3) Install plugins with exact version using this example command - npm install ep_resize@0.0.7 - Newer versions of plugins can be incompatible with Etherpad 1.8.5. + npm install --no-save --legacy-peer-deps ep_resize@0.0.7 + Newer versions of plugins can be incompatible with Etherpad 1.8.14. - adminpads2: plugin to list and delete pads in /admin 2.1.16 + adminpads2: plugin to list and delete pads in /admin 2.1.38 authornames: Adds author names to span titles (shows on hover) 0.2.0 - author_neat: Neat author display 0.0.31 - comments_page: Adds comments on sidebar and link it to the text 0.1.47 + author_neat2: Neat author display 2.0.1 + comments_page: Adds comments on sidebar and link it to the text 0.1.63 export_authors: Etherpad plugin to add author information to the html export 0.1.1 - headings2: Adds heading support 0.2.7 - message_all: Use the Etherpad admin backend to send a message to all connected users 1.1.0 - resize Notifies about pad size 0.0.7 - stats: See pad Stats 0.0.6 + headings2: Adds heading support 0.2.30 + resize: Notifies about pad size 0.0.15 + stats: See pad Stats 0.0.11 -4) Copy contents of folder /lams_tool_doku/conf/etherpad-lite/ over to /${etherpad-lite-server-folder}/ +4) Copy contents of folder /lams_buil/conf/etherpad/etherpad-lite/ over to /${etherpad-lite-server-folder}/ It customises Etherpad and the plugins + +5) To run Etherpad in iframes SSL is required. On localhost for development follow this guide + https://github.com/ether/etherpad-lite/wiki/Providing-encrypted-web-access-to-Etherpad-Lite-using-SSL-certificates + Then set up "ssl" secion in settings.json. + Then set up Etherpad in sysadmin panel to use HTTPS. +----------Known issues--------------- + +https://github.com/ether/etherpad-lite/issues/5041 +https://github.com/ether/etherpad-lite/issues/4525 ----------Same domain policy--------- Etherpad server should be installed on the same domain as LAMS server.