diff --git a/doc/README.WebDAV b/doc/README.WebDAV index 81ce83a1d..c8be57809 100644 --- a/doc/README.WebDAV +++ b/doc/README.WebDAV @@ -3,7 +3,7 @@ WebDAV SeedDMS has support for WebDAV which allows to easily add, delete, move, copy and modify documents. All operating systems have support -for WebDAV as well, but the implemtations and their behaviour varys +for WebDAV, but the implemtation and their behaviour varys and consequently you may run into various problems. If this happens just file a bug report at https://sourceforge.net/projects/seeddms @@ -34,27 +34,35 @@ Configuring davfs2 On Linux it is quite simple to mount the SeedDMS WebDAV server with davfs2. Just place a line like the following in your /etc/fstab +``` http://seeddms.your-domain.com/webdav/index.php /media/webdav davfs noauto,user,rw,uid=1000,gid=1000 +``` and mount it as root with +``` mount /media/webdav davfs +``` You may as well want to configure davfs2 in /etc/davfs2/davfs2.conf by setting +``` [/media/webdav] use_locks 0 gui_optimize 1 +``` -and possibly add your login data to /etc/davfs2/secrets +and possibly add your login data to `/etc/davfs2/secrets` +``` /media/webdav admin secret +``` Making applications work with WebDAV ------------------------------------- Various programms have differnt strategies to save files to disc and -prevent data lost under all circumstances. Those strategies often don't +to prevent data lost under all circumstances. Those strategies often don't work very well an a WebDAV-Server. The following will list some of those strategies. @@ -79,19 +87,25 @@ the old document. If you don't want this behaviour, then tell vim to not create the backup file. You can do that by either passing additional parameters to vim +``` vi "+set nobackup" "+set nowritebackup" -n test.txt +``` or by setting them in your .vimrc +``` set nobackup set nowritebackup set noswapfile +``` If you want to restrict the settings to the directory where the dms is mounted by webdav, e.g. /media/webdav, you can set an auto command -in .vimrc +in `.vimrc` +``` autocmd BufNewFile,BufRead /media/webdav/* set nobackup nowritebackup noswapfile +``` Creating the backup file in a directory outside of WebDAV doesn't help in this case, because it still does the file renaming which is turned off by @@ -107,7 +121,9 @@ If webdav access isn't working, this client is probably the best for testing. Just run +``` cadaver https:////webdav/index.php +``` It will ask for the user name and password. Once you are logged in just type `help` for a list of commands. @@ -115,19 +131,27 @@ type `help` for a list of commands. SeedDMS stores a lot more properties not covered by the webdav standard. Those have its own namespace called 'SeedDMS:'. Just type +``` propget +``` with `resource` being either the name of a folder or document. You will get a list of all properties stored for this resource. Setting a property requires to set the namespace first +``` set namespace SeedDMS: +``` Afterwards, you may set a property, e.g. the comment, with +``` propset comment 'Just a comment' +``` or even delete a property +``` propdel comment +```