@iftex
This chapter describes the basic calendar features.
-@xref{Advanced Calendar/Diary Usage,,, emacs-xtra}, for information
+@inforef{Advanced Calendar/Diary Usage,, emacs-xtra}, for information
about more specialized features.
@end iftex
* Scroll Calendar:: Bringing earlier or later months onto the screen.
* Counting Days:: How many days are there between two dates?
* General Calendar:: Exiting or recomputing the calendar.
-* LaTeX Calendar:: Print a calendar using LaTeX.
+* Writing Calendar Files:: Writing calendars to files of various formats.
* Holidays:: Displaying dates of holidays.
* Sunrise/Sunset:: Displaying local times of sunrise and sunset.
* Lunar Phases:: Displaying phases of the moon.
(If a frame contains a dedicated calendar window, exiting from the
calendar iconifies that frame.)
-@node LaTeX Calendar
-@section LaTeX Calendar
-@cindex calendar and La@TeX{}
+@node Writing Calendar Files
+@section Writing Calendar Files
+
+ These packages produce files of various formats containing calendar
+and diary entries, for display purposes.
+
+@cindex calendar and HTML
+ The Calendar HTML commands produce files of HTML code that contain
+calendar and diary entries. Each file applies to one month, and has a
+name of the format @file{@var{yyyy}-@var{mm}.html}, where @var{yyyy} and
+@var{mm} are the four-digit year and two-digit month, respectively. The
+variable @code{cal-html-directory} specifies the default output
+directory for the HTML files.
+
+@vindex cal-html-css-default
+ Diary entries enclosed by @code{<} and @code{>} are interpreted as
+HTML tags (for example: this is a diary entry with <font
+color=''red''>some red text</font>). You can change the overall
+appearance of the displayed HTML pages (for example, the color of
+various page elements, header styles) via a stylesheet @file{cal.css} in
+the directory containing the HTML files (see the value of the variable
+@code{cal-html-css-default} for relevant style settings).
- The Calendar La@TeX{} commands produce a buffer of La@TeX{} code that
+@kindex t @r{(Calendar mode)}
+@table @kbd
+@item H m
+Generate a one-month calendar (@code{cal-html-cursor-month}).
+@item H y
+Generate a calendar file for each month of a year, as well as an index
+page (@code{cal-html-cursor-year}). By default, this command writes
+files to a @var{yyyy} subdirectory - if this is altered some hyperlinks
+between years will not work.
+@end table
+
+ If the variable @code{cal-html-print-day-number-flag} is
+non-@code{nil}, then the monthly calendars show the day-of-the-year
+number. The variable @code{cal-html-year-index-cols} specifies the
+number of columns in the yearly index page.
+
+@cindex calendar and La@TeX{}
+ The Calendar La@TeX{} commands produce a buffer of La@TeX{} code that
prints as a calendar. Depending on the command you use, the printed
calendar covers the day, week, month or year that point is in.
calendars only). If the variable @code{cal-tex-rules} is non-@code{nil}
(the default is @code{nil}), the calendar displays ruled pages
in styles that have sufficient room. You can use the variable
-@code{cal-tex-preamble-extra} to insert extra LaTeX commands in the
+@code{cal-tex-preamble-extra} to insert extra La@TeX{} commands in the
preamble of the generated document if you need to.
@node Holidays
holidays in a different face (or places a @samp{*} after these dates, if
display with multiple faces is not available).
@iftex
-@xref{Calendar Customizing, calendar-holiday-marker,, emacs-xtra}.
+@inforef{Calendar Customizing, calendar-holiday-marker, emacs-xtra}.
@end iftex
@ifnottex
@xref{Calendar Customizing, calendar-holiday-marker}.
@table @kbd
@item d
Display all diary entries for the selected date
-(@code{view-diary-entries}).
+(@code{diary-view-entries}).
@item Mouse-2 Diary
Display all diary entries for the date you click on.
@item s
-Display the entire diary file (@code{show-all-diary-entries}).
+Display the entire diary file (@code{diary-show-all-entries}).
@item m
Mark all visible dates that have diary entries
(@code{mark-diary-entries}).
@end table
@kindex d @r{(Calendar mode)}
-@findex view-diary-entries
+@findex diary-view-entries
@vindex view-diary-entries-initially
Displaying the diary entries with @kbd{d} shows in a separate window
the diary entries for the selected date in the calendar. The mode line
a different face (or places a @samp{+} after these dates, if display
with multiple faces is not available).
@iftex
-@xref{Calendar Customizing, diary-entry-marker,, emacs-xtra}.
+@inforef{Calendar Customizing, diary-entry-marker, emacs-xtra}.
@end iftex
@ifnottex
@xref{Calendar Customizing, diary-entry-marker}.
updating the calendar marks diary dates automatically.
@kindex s @r{(Calendar mode)}
-@findex show-all-diary-entries
+@findex diary-show-all-entries
To see the full diary file, rather than just some of the entries, use
the @kbd{s} command.
few days as well; the variable @code{number-of-diary-entries} specifies
how many days to include.
@iftex
-@xref{Diary Customizing,,, emacs-xtra}.
+@inforef{Diary Customizing,, emacs-xtra}.
@end iftex
@ifnottex
@xref{Diary Customizing, number-of-diary-entries}.
visible line cannot cause problems, but editing at the end of a line may
not do what you expect. Deleting a line may delete other invisible
entries that follow it. Before editing the diary, it is best to display
-the entire file with @kbd{s} (@code{show-all-diary-entries}).
+the entire file with @kbd{s} (@code{diary-show-all-entries}).
@node Date Formats
@subsection Date Formats
If you prefer the European style of writing dates---in which the day
comes before the month---type @kbd{M-x european-calendar} while in the
calendar, or set the variable @code{european-calendar-style} to @code{t}
-@emph{before} using any calendar or diary command. This mode interprets
-all dates in the diary in the European manner, and also uses European
-style for displaying diary dates. (Note that there is no comma after
-the @var{monthname} in the European style.) To go back to the (default)
-American style of writing dates, type @kbd{M-x american-calendar}.
+with @kbd{M-x customize}, or @emph{before} using any calendar or diary
+command. This mode interprets all dates in the diary in the European
+manner, and also uses European style for displaying diary dates. (Note
+that there is no comma after the @var{monthname} in the European style.)
+To go back to the (default) American style of writing dates, type
+@kbd{M-x american-calendar}.
You can use the name of a day of the week as a generic date which
applies to any date falling on that day of the week. You can abbreviate
marking the entry in the calendar. Most generally, sexp diary entries
can perform arbitrary computations to determine when they apply.
@iftex
-@xref{Sexp Diary Entries,,, emacs-xtra}.
+@inforef{Sexp Diary Entries,, emacs-xtra}.
@end iftex
@ifnottex
@inforef{Sexp Diary Entries}.
and adds the results to an Emacs diary file. For example:
@example
-(icalendar-import-file "/here/is/calendar.ics" "/there/goes/ical-diary")
+(icalendar-import-file "/here/is/calendar.ics"
+ "/there/goes/ical-diary")
@end example
@noindent
You can use an @code{#include} directive to add the import file contents
to the main diary file, if these are different files.
@iftex
-@xref{Fancy Diary Display,,, emacs-xtra}.
+@inforef{Fancy Diary Display,, emacs-xtra}.
@end iftex
@ifnottex
@xref{Fancy Diary Display}.