mirroir readonly du Gitit wiki.evolix.org (attention, ne rien commiter/merger sur ce dépôt) https://wiki.evolix.org
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

HowtoEtherpad.md 3.7 KiB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141
  1. **Cette page a été importée automatiquement de notre ancien wiki mais n'a pas encore été révisée.**
  2. # HowtoEtherpad
  3. Etherpad est un éditeur texte collaboratif en ligne.
  4. On utilise désormais la version Etherpad-Lite.
  5. * <http://etherpad.org/>
  6. * <https://github.com/ether/etherpad-lite/>
  7. * Statut du package Debian officiel : <http://bugs.debian.org/576998>
  8. ## Installation
  9. Debian Jessie :
  10. ~~~
  11. # apt install gzip git curl python libssl-dev pkg-config build-essential
  12. # apt install nodejs npm
  13. # adduser --system --home=/home/etherpad-lite --group etherpad-lite
  14. $ git clone git://github.com/ether/etherpad-lite.git
  15. # vim /etc/systemd/system/etherpad-lite.service
  16. [Unit]
  17. Description=etherpad-lite (real-time collaborative document editing)
  18. After=syslog.target network.target
  19. [Service]
  20. Type=simple
  21. User=etherpad-lite
  22. Group=etherpad-lite
  23. ExecStart=/home/etherpad-lite/etherpad-lite/bin/run.sh
  24. [Install]
  25. WantedBy=multi-user.target
  26. # systemctl enable etherpad-lite
  27. Created symlink from /etc/systemd/system/multi-user.target.wants/etherpad-lite.service to /etc/systemd/system/etherpad-lite.service.
  28. # systemctl start etherpad-lite
  29. ~~~
  30. Voir <https://github.com/ether/etherpad-lite/wiki/How-to-deploy-Etherpad-Lite-as-a-service>
  31. Note : les scripts bin/run.sh et bin/installDeps.sh utilisent la commande "node" et non "nodejs", il peut donc être nécessaire de modifier ou créer un alias node=nodejs
  32. ### Installation (deprecated)
  33. En installant nodejs depuis les sources.
  34. Suivre les infos sur : <https://github.com/Pita/etherpad-lite/blob/master/README.md>
  35. ~~~
  36. # aptitude install gzip git-core curl python libssl-dev build-essential
  37. # apt-get build-dep nodejs=0.6.8~dfsg1-1
  38. $ wget <http://nodejs.org/dist/v0.6.10/node-v0.6.10.tar.gz>
  39. $ tar xvf node-v0.6.10.tar.gz
  40. $ cd node-v0.6.10
  41. $ ./configure && make
  42. # make install
  43. $ git clone <https://github.com/Pita/etherpad-lite.git>
  44. $ cd ../etherpad-lite/
  45. $ ./bin/installDeps.sh
  46. $ vim settings.json
  47. $ ./bin/run.sh
  48. ~~~
  49. Lancer bin/run.sh
  50. ## Configuration
  51. Cela ce passe dans _settings.json_
  52. ### Stockage des données
  53. Par défaut, Etherpad utilise DirtyDB (un fichier à plat) mais on peut utiliser sqlite ou MySQL.
  54. Pour DirtyDB :
  55. ~~~
  56. "dbType" : "dirty",
  57. "dbSettings" : {
  58. "filename" : "var/dirty.db"
  59. },
  60. ~~~
  61. Pour MySQL utiliser MySQL :
  62. ~~~
  63. mysql> create database etherpad;
  64. mysql> grant CREATE,ALTER,SELECT,INSERT,UPDATE,DELETE on `etherpad`.* to 'etherpad'@'localhost' identified by '<password>';
  65. ~~~
  66. puis :
  67. ~~~
  68. "dbType" : "mysql",
  69. "dbSettings" : {
  70. "user" : "etherpad",
  71. "host" : "127.0.0.1",
  72. "password": "<password>",
  73. "database": "etherpad"
  74. },
  75. ~~~
  76. puis :
  77. ~~~
  78. $ sh bin/installDeps.sh
  79. # systemctl restart etherpad-lite
  80. mysql> show tables
  81. +--------------------+
  82. | Tables_in_etherpad |
  83. +--------------------+
  84. | store |
  85. +--------------------+
  86. mysql> ALTER DATABASE `etherpad` CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
  87. mysql> ALTER TABLE `store` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
  88. ~~~
  89. Voir <https://github.com/ether/etherpad-lite/wiki/How-to-use-Etherpad-Lite-with-MySQL>
  90. ### Reverse Proxy
  91. Avec Nginx :
  92. ~~~
  93. server {
  94. listen 80;
  95. server_name pad.example.com;
  96. location / {
  97. proxy_pass <http://127.0.0.1:9001/;>
  98. proxy_set_header Host $host;
  99. proxy_pass_header Server;
  100. proxy_buffering off;
  101. proxy_set_header X-Real-IP $remote_addr;
  102. proxy_set_header Host $host;
  103. proxy_<http_version> 1.1;
  104. }
  105. }
  106. ~~~
  107. Voir <https://github.com/ether/etherpad-lite/wiki/How-to-put-Etherpad-Lite-behind-a-reverse-Proxy>