manpagez: man pages & more
info emacs
Home | html | info | man
[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

39.12 Importing and Exporting Diary Entries

You can transfer diary entries between Emacs diary files and a variety of other formats.

You can import diary entries from Outlook-generated appointment messages. While viewing such a message in Rmail or Gnus, do M-x diary-from-outlook to import the entry. You can make this command recognize additional appointment message formats by customizing the variable diary-outlook-formats.

The icalendar package allows you to transfer data between your Emacs diary file and iCalendar files, which are defined in “RFC 2445—Internet Calendaring and Scheduling Core Object Specification (iCalendar)” (as well as the earlier vCalendar format).

Importing works for “ordinary” (i.e. non-recurring) events, but (at present) may not work correctly (if at all) for recurring events. Exporting of diary files into iCalendar files should work correctly for most diary entries. This feature is a work in progress, so the commands may evolve in future.

The command icalendar-import-buffer extracts iCalendar data from the current buffer and adds it to your (default) diary file. This function is also suitable for automatic extraction of iCalendar data; for example with the Rmail mail client one could use:

(add-hook 'rmail-show-message-hook 'icalendar-import-buffer)

The command icalendar-import-file imports an iCalendar file and adds the results to an Emacs diary file. For example:

(icalendar-import-file "/here/is/calendar.ics"

You can use an #include directive to add the import file contents to the main diary file, if these are different files. See section Fancy Diary Display.

Use icalendar-export-file to interactively export an entire Emacs diary file to iCalendar format. To export only a part of a diary file, mark the relevant area, and call icalendar-export-region. In both cases the result is appended to the target file.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]
© 2000-2024
Individual documents may contain additional copyright information.