oss/Radicale
oss/Radicale
1
0
Fork 0
mirror of https://github.com/Kozea/Radicale.git synced 2025-07-23 17:48:30 +00:00
Code Wiki Activity

Update the iCal documentation, add theme for warning admonitions

Browse source
This commit is contained in:
Guillaume Ayoub 2012-01-05 00:48:42 +01:00
parent c895455897
commit de35027cab
2 changed files with 33 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

25
pages/user_documentation.rst
View file

@ -178,7 +178,7 @@ iCal
This description assumes you do not have any authentication or encryption This description assumes you do not have any authentication or encryption
configured. The procedure will change accordingly if you do. configured. The procedure will change accordingly if you do.
In iCal 4.0: In iCal 4.0 or iCal 5.0:
1. Open the ``Preferences`` dialog and select the ``Accounts`` tab 1. Open the ``Preferences`` dialog and select the ``Accounts`` tab
2. Click the ``+`` button at the lower left to open the account creation wizard 2. Click the ``+`` button at the lower left to open the account creation wizard
@ -194,6 +194,10 @@ Click ``Create``. The wizard will now tell you, that no encryption is in place
(``Unsecured Connection``). This is expected and will change if you configure (``Unsecured Connection``). This is expected and will change if you configure
radicale to use SSL. Click ``Continue``. radicale to use SSL. Click ``Continue``.
.. warning::
In iCal 5.0, please check twice that the ``Sync all entries`` option is
activated, otherwise some events may not be shown in your calendar.
The wizard will close, leaving you in the ``Account`` tab again. The account is The wizard will close, leaving you in the ``Account`` tab again. The account is
now set-up. You can close the ``Preferences`` window. now set-up. You can close the ``Preferences`` window.
@ -443,18 +447,29 @@ to your environment):
</Directory> </Directory>
</VirtualHost> </VirtualHost>
.. note:: .. warning::
You should use the root of the (sub)domain (``WSGIScriptAlias /``), else You should use the root of the (sub)domain (``WSGIScriptAlias /``), else
some CalDAV features may not work. some CalDAV features may not work.
.. important:: .. important::
If you want to use authentication with Apache, you *really* should use one If you want to use authentication with Apache, you *really* should use one
of the Apache authentication modules, instead of the ones from Radicale: of the Apache authentication modules, instead of the ones from Radicale:
they're just better. If you're still convinced that access control is better they're just better.
with Radicale, you have to add ``WSGIPassAuthorization On`` in your Apache
configuration files, as explained in `the mod_wsgi documentation Deactivate any ACL module in Radicale and use your favourite Apache
authentication backend. You can then restrict the access: allow the
``alice`` user to access ``/alice/*`` URLs, and everything should work as
expected.
If you're still convinced that access control is better with Radicale, you
have to add ``WSGIPassAuthorization On`` in your Apache configuration files,
as explained in `the mod_wsgi documentation
<http://code.google.com/p/modwsgi/wiki/ConfigurationGuidelines#User_Authentication>`_. <http://code.google.com/p/modwsgi/wiki/ConfigurationGuidelines#User_Authentication>`_.
.. note::
Read-only calendars can also be served by a simple Apache HTTP server, as
Radicale stores full-text icalendar files.
Authentication and URLs Authentication and URLs
----------------------- -----------------------

16
static/css/style.css
View file

@ -216,7 +216,7 @@ article {
padding: 20px; padding: 20px;
} }
.important, .note { .important, .warning, .note {
border-radius: 3px; border-radius: 3px;
font-size: 0.9em; font-size: 0.9em;
margin: 1em 10%; margin: 1em 10%;
@ -224,15 +224,25 @@ article {
} }
.important { .important {
background:rgba(180, 0, 0, 0.1); background: rgba(180, 0, 0, 0.1);
border: 1px dotted #a40000; border: 1px dotted #a40000;
} }
.warning {
background: rgba(220, 120, 0, 0.1);
border: 1px dotted #a46600;
}
.note { .note {
background:rgba(78, 154, 6, 0.1); background: rgba(78, 154, 6, 0.1);
border: 1px dotted #4e9a06; border: 1px dotted #4e9a06;
} }
.admonition-title {
font-variant: small-caps;
text-decoration: underline;
}
.footnote { .footnote {
font-size: 0.8em; font-size: 0.8em;
opacity: 0.7; opacity: 0.7;