better formatting

This commit is contained in:
Uwe Steinmann 2025-10-23 19:06:27 +02:00
parent a77519cfd6
commit 027acbfd3b

View File

@ -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://<your-domain>/<your-basedir>/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 <resource>
```
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 <resource> comment 'Just a comment'
```
or even delete a property
```
propdel <resource> comment
```