# configuration file for hcal - Hebrew calendar program
![](/@@/translation-newline)
# part of package libhdate
![](/@@/translation-newline)
#
![](/@@/translation-newline)
# Should you mangle this file and wish to restore its default content,
![](/@@/translation-newline)
# rename or delete this file and run hcal; hcal will automatically
![](/@@/translation-newline)
# regenerate the default content.
![](/@@/translation-newline)
#
![](/@@/translation-newline)
# Your system administrator can set system-wide defaults for hcal by
![](/@@/translation-newline)
# modifying file <not yet implemented>.
![](/@@/translation-newline)
# You may override all defaults by changing the contents of this file.
![](/@@/translation-newline)
#
![](/@@/translation-newline)
# Version information
![](/@@/translation-newline)
# This may be used by updates to hcal to determine how to parse the file
![](/@@/translation-newline)
# and whether additional information and options should be appended to
![](/@@/translation-newline)
# the end of this file.
![](/@@/translation-newline)
VERSION=2.00
![](/@@/translation-newline)
# Location awareness
![](/@@/translation-newline)
# hcal wants to accurately highlight the current Hebrew day, including
![](/@@/translation-newline)
# during the hours between sunset and secular midnight. If you don't
![](/@@/translation-newline)
# provide it with latitude, longitude, and time zone information, hcal
![](/@@/translation-newline)
# will try to guess the information, based upon your system timezone,
![](/@@/translation-newline)
# and its (limited, and maybe biased) of the dominant Jewish community
![](/@@/translation-newline)
# in that timezone. When hcal is forced to guess, it alerts the user
![](/@@/translation-newline)
# with a message that includes the guessed location.
![](/@@/translation-newline)
# hcal's guesses will also affect its default behaviour for output of
![](/@@/translation-newline)
# Shabbat times, parshiot, and choice of Israel/diaspora hoidays
![](/@@/translation-newline)
#SUNSET_AWARE=TRUE
![](/@@/translation-newline)
# LATITUDE and LONGITUDE may be in decimal format or in the form
![](/@@/translation-newline)
# degrees[:minutes[:seconds]] with the characters :'" as possible
![](/@@/translation-newline)
# delimiters. Use negative values to indicate South and West, or
![](/@@/translation-newline)
# use the abbreviated compass directions N, S, E, W.
![](/@@/translation-newline)
#LATITUDE=
![](/@@/translation-newline)
#LONGITUDE=
![](/@@/translation-newline)
# TIMEZONE may may be in decimal format or in the form degrees[:minutes]
![](/@@/translation-newline)
# with the characters :'" as possible delimiters.
![](/@@/translation-newline)
#TIMEZONE=
![](/@@/translation-newline)
# Israel and the diaspora
![](/@@/translation-newline)
# If hcal guesses that you're not in Israel, the DIASPORA option will be
![](/@@/translation-newline)
# set true. This will affect holiday and parasha output. FORCE_ISRAEL
![](/@@/translation-newline)
# forces hcal to display calendar information for Israel, using hcal's
![](/@@/translation-newline)
# default coordinates foe Israel, or coordinates that you provide that
![](/@@/translation-newline)
# seem legitmately within Israel.
![](/@@/translation-newline)
# Thus, if you are living in Sao Paolo, and will be visiting Israel for
![](/@@/translation-newline)
# Sukkot, set BOTH flags true in order to see holiday information for
![](/@@/translation-newline)
# a non-resident vistor to Israel. The command line options for these
![](/@@/translation-newline)
# features are --israel, -I, --diaspora, -d.
![](/@@/translation-newline)
#FORCE_DIASPORA=FALSE;
![](/@@/translation-newline)
#FORCE_ISRAEL=FALSE;
![](/@@/translation-newline)
# Shabbat related
![](/@@/translation-newline)
# Setting SHABBAT_INFO true will output parshiot and Shabbat times.
![](/@@/translation-newline)
# The command line options for these features are -p (--parasha), and
![](/@@/translation-newline)
# -s (--shabbat). The CANDLE_LIGHTING field can accept a value of 18 - 90 (minutes
![](/@@/translation-newline)
# before sunset). The HAVDALAH field can accept a value of 20 - 90
![](/@@/translation-newline)
# (minutes after sunset).
![](/@@/translation-newline)
#PARASHA_NAMES=FALSE
![](/@@/translation-newline)
#SHABBAT_INFO=FALSE
![](/@@/translation-newline)
#CANDLE_LIGHTING=FALSE
![](/@@/translation-newline)
#HAVDALAH=FALSE
![](/@@/translation-newline)
# Holiday identification
![](/@@/translation-newline)
# hcal flags holidays by replacing the gregorian/Hebrew date separator
![](/@@/translation-newline)
# with assorted unhelpful cryptic symbols. Setting FOOTNOTES to true
![](/@@/translation-newline)
# will have hcal output after the month's calendar, a list of the month's
![](/@@/translation-newline)
# holidays along with the days on which they occur.
![](/@@/translation-newline)
#FOOTNOTE=FALSE
![](/@@/translation-newline)
# Output in hebrew characters
![](/@@/translation-newline)
# hcal defaults to output all information in your default language, so
![](/@@/translation-newline)
# if your default language is Hebrew, you're all set. Otherwise, you can
![](/@@/translation-newline)
# set FORCE_HEBREW to true to output Hebrew information in Hebrew, while
![](/@@/translation-newline)
# still outputting gregorian information in your default language. To
![](/@@/translation-newline)
# output ALL information in Hebrew, run something like this:
![](/@@/translation-newline)
# LC_TEMP=LC_ALL; LC_ALL="he_IL.UTF-8"; hcal; LC_ALL=$LC_TEMP
![](/@@/translation-newline)
# If setting FORCE_HEBREW to true results in 'garbage' or non-Hebrew
![](/@@/translation-newline)
# output, you need to install a terminal font that includes the Hebrew
![](/@@/translation-newline)
# character set (hint: unicode).
![](/@@/translation-newline)
# The command line option for FORCE_HEBREW is either --hebrew or -H
![](/@@/translation-newline)
#FORCE_HEBREW=FALSE
![](/@@/translation-newline)
# The FORCE_HEBREW option outputs data that is 'correct' and 'logical'.
![](/@@/translation-newline)
# Unfortunately, the world can not be depended upon to be either. Most
![](/@@/translation-newline)
# Xwindow applications will display the data fine with FORCE_HEBREW; most
![](/@@/translation-newline)
# xterm implementations will not. (in fact, the only xterm clone I know
![](/@@/translation-newline)
# of that comes close is mlterm). If using FORCE_HEBREW results in
![](/@@/translation-newline)
# Hebrew characters being displayed in reverse, set OUTPUT_BIDI to true.
![](/@@/translation-newline)
# This will reverse the order of the Hebrew characters, so they will
![](/@@/translation-newline)
# display 'visual'ly correct; however, such output will not be suitable
![](/@@/translation-newline)
# for piping or pasting to many other applications. Setting OUTPUT_BIDI
![](/@@/translation-newline)
# automatically forces hebrew.
![](/@@/translation-newline)
# The command line option for OUTPUT_BIDI is either --bidi, --visual, or -b
![](/@@/translation-newline)
#OUTPUT_BIDI=FALSE
![](/@@/translation-newline)
# Display enhancements
![](/@@/translation-newline)
# hcal defaults to display the current day in reverse video
![](/@@/translation-newline)
# The command line option for this feature is --no-reverse
![](/@@/translation-newline)
#SUPPRESS_REVERSE_VIDEO=FALSE;
![](/@@/translation-newline)
# hcal can display its output "calming, muted tones". Note that piping
![](/@@/translation-newline)
# colorized output may yield unexpected results.
![](/@@/translation-newline)
#COLORIZE=FALSE
![](/@@/translation-newline)
# HTML OUTPUT
![](/@@/translation-newline)
#OUTPUT_HTML=FALSE
![](/@@/translation-newline)
#USE_EXTERNAL_CSS_FILE="pathto/foo/bar"
![](/@@/translation-newline)
# Suppress alerts and warnings
![](/@@/translation-newline)
# hcal alerts the user via STDERR when it guesses the user's location.
![](/@@/translation-newline)
#QUIET_ALERTS=FALSE
![](/@@/translation-newline)
# Three month display
![](/@@/translation-newline)
# hcal can display a previous, current and next month side-by-side. hcal
![](/@@/translation-newline)
# can also display a calendar for an entire year in four rows of three
![](/@@/translation-newline)
# months each. Note that this will display properly only if your console
![](/@@/translation-newline)
# is set for at least 127 columns. Note also that setting this option to
![](/@@/translation-newline)
# will cause options FOOTNOTES, SHABBAT, and PARASHA_NAMES to false.
![](/@@/translation-newline)
#THREE_MONTH=FALSE
![](/@@/translation-newline)
# User-defined menus
![](/@@/translation-newline)
# You may specify here command-line strings to optionally be parsed
![](/@@/translation-newline)
# by hcal at execution time. To do so, use the command line option -m
![](/@@/translation-newline)
# (--menu). hcal will process first the settings of this config file,
![](/@@/translation-newline)
# then the other settings of your command line, and then will prompt
![](/@@/translation-newline)
# you for which menu item you would like to select. hcal will process
![](/@@/translation-newline)
# your menu selection as if it were a new command line, further modifying
![](/@@/translation-newline)
# all the prior settings.
![](/@@/translation-newline)
# Only the first ten "MENU=" entries will be read. Each line will be
![](/@@/translation-newline)
# truncated at one hundred characters
![](/@@/translation-newline)
#MENU= -l -23.55 -L -46.61 -z -3 # parents in Sao Paolo
![](/@@/translation-newline)
#MENU= -l 32 -L 34 -z 2 # son in bnei brak
![](/@@/translation-newline)
#MENU= -fbc -l 43.71 -L -79.43 -z -5 # me in Toronto
![](/@@/translation-newline)
#MENU= -l 22.26 -L 114.15 -z 8 # supplier in Hong Kong