docs/src/configuration.md

changeset 320
12ed560c926c
parent 307
a4419589ea26
child 700
165811ea12ab
equal deleted inserted replaced
319:2433b5969d44 320:12ed560c926c
2 title: 'Configuration' 2 title: 'Configuration'
3 --- 3 ---
4 4
5 The main configuration file for *dav* is `$HOME/.dav/config.xml` and is used for configuring repositories, proxies and encryption keys. This configuration is also used by *dav-sync*. The file is created automaticaly if it doesn't exist. 5 The main configuration file for *dav* is `$HOME/.dav/config.xml` and is used for configuring repositories, proxies and encryption keys. This configuration is also used by *dav-sync*. The file is created automaticaly if it doesn't exist.
6 6
7 The *config.xml* file is an XML file with `<configuration>` as root element. The `<configuration>` element can have the following child elements: `<repository>`, `<http-proxy>`, `<https-proxy>`, `<key>` 7 The *config.xml* file is an XML file with `<configuration>` as root element. The `<configuration>` element can have the following child elements: `<repository>`, `<http-proxy>`, `<https-proxy>`, `<key>`, `<namespace>`
8 8
9 ## repository 9 ## repository
10 10
11 This element is used to configure a repository. A repository must have a unique name to identify the repository and a url pointing to the root collection for this repository. 11 This element is used to configure a repository. A repository must have a unique name to identify the repository and a url pointing to the root collection for this repository.
12 12
174 174
175 A comma separated list of all hosts that should not be accessed through the proxy. 175 A comma separated list of all hosts that should not be accessed through the proxy.
176 176
177 Type: string \ 177 Type: string \
178 Example: `<no>host1, host2, host3</no>` 178 Example: `<no>host1, host2, host3</no>`
179
180 ## namespace
181
182 Configures an XML-namespace with prefix and uri. The prefix can be used with commands like `get-property`. The element must have the `prefix` and the `uri` attribute.
183
184 Type: no value
185 Example: `<namespace prefix="e" uri="http://example.com/" />`
179 186
180 ## Example 1: minimal repository configuration 187 ## Example 1: minimal repository configuration
181 188
182 A minimal configuration for a repository. If no user and/or password are configured, dav prompts for authentication informations if required. 189 A minimal configuration for a repository. If no user and/or password are configured, dav prompts for authentication informations if required.
183 190

mercurial