Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation improvement: Stress importance of URI endings #322

Closed
problame opened this issue Oct 9, 2015 · 1 comment
Closed

Documentation improvement: Stress importance of URI endings #322

problame opened this issue Oct 9, 2015 · 1 comment
Milestone

Comments

@problame
Copy link

problame commented Oct 9, 2015

I cannot find the source for the online documentation which itself is a thing that should be fixed.

It took me a while to figure out that the specific URI endings .ics and .vcf are mandatory. While a hint about this is in the current documentation, it is

  • buried in the client-specific configuration subsections
  • inline
  • hence not very visible

Furthermore, I found that the "full" URL scheme as described below works in more clients than mentioned in the docs.

Hence, as told in IRC, a little enhancement to the documentation text:

Section Starting the Client, new sub-section: General Configuration

Starting the Client

General Configuration

URL Schemes

Protocol URL
CalDAV https://[hostname]:[port]/[username]/[calendarname].ics/
CardDAV https://[hostname]:[port]/[username]/[addressbookname].vcf/

Default for port is 5232.
Radicale will create the appropriate collection (e.g. calendarname.ics) automatically in the configured directory.
Important: The specific file endings (.ics, .vcf) and the trailing slash are required by some clients.

Lightning

[...]

@liZe liZe modified the milestone: 2.0 Mar 14, 2016
@liZe liZe mentioned this issue Apr 4, 2016
39 tasks
@liZe
Copy link
Member

liZe commented May 6, 2016

The trailing slash is not needed anymore!

@liZe liZe closed this as completed May 6, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants