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, SeedDMS has support for WebDAV which allows to easily add, delete,
move, copy and modify documents. All operating systems have support 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 and consequently you may run into various problems. If this happens
just file a bug report at https://sourceforge.net/projects/seeddms 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 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 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 http://seeddms.your-domain.com/webdav/index.php /media/webdav davfs noauto,user,rw,uid=1000,gid=1000
```
and mount it as root with and mount it as root with
```
mount /media/webdav davfs mount /media/webdav davfs
```
You may as well want to configure davfs2 in /etc/davfs2/davfs2.conf by setting You may as well want to configure davfs2 in /etc/davfs2/davfs2.conf by setting
```
[/media/webdav] [/media/webdav]
use_locks 0 use_locks 0
gui_optimize 1 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 /media/webdav admin secret
```
Making applications work with WebDAV Making applications work with WebDAV
------------------------------------- -------------------------------------
Various programms have differnt strategies to save files to disc and 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 work very well an a WebDAV-Server. The following will list some of those
strategies. 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 to not create the backup file. You can do that by either passing additional
parameters to vim parameters to vim
```
vi "+set nobackup" "+set nowritebackup" -n test.txt vi "+set nobackup" "+set nowritebackup" -n test.txt
```
or by setting them in your .vimrc or by setting them in your .vimrc
```
set nobackup set nobackup
set nowritebackup set nowritebackup
set noswapfile set noswapfile
```
If you want to restrict the settings to the directory where the dms 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 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 autocmd BufNewFile,BufRead /media/webdav/* set nobackup nowritebackup noswapfile
```
Creating the backup file in a directory outside of WebDAV doesn't help in 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 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 Just run
```
cadaver https://<your-domain>/<your-basedir>/webdav/index.php cadaver https://<your-domain>/<your-basedir>/webdav/index.php
```
It will ask for the user name and password. Once you are logged in just It will ask for the user name and password. Once you are logged in just
type `help` for a list of commands. 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. SeedDMS stores a lot more properties not covered by the webdav standard.
Those have its own namespace called 'SeedDMS:'. Just type Those have its own namespace called 'SeedDMS:'. Just type
```
propget <resource> propget <resource>
```
with `resource` being either the name of a folder or document. You will 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 get a list of all properties stored for this resource. Setting a property
requires to set the namespace first requires to set the namespace first
```
set namespace SeedDMS: set namespace SeedDMS:
```
Afterwards, you may set a property, e.g. the comment, with Afterwards, you may set a property, e.g. the comment, with
```
propset <resource> comment 'Just a comment' propset <resource> comment 'Just a comment'
```
or even delete a property or even delete a property
```
propdel <resource> comment propdel <resource> comment
```