Files
note/config/noterc

281 lines
6.9 KiB
Plaintext
Raw Normal View History

# note 1.4.1 -*- conf -*-
#
# This is a sample config for the note script There are useful
# defaults set in note itself.
#
# Copy it to your $HOME as .noterc
#
# Comments start with #, empty lines will be ignored.
#
# To turn on an option, set it to: 1, on or yes
# To turn off an option, set it to: 0, off or no
#
# An option consists of an atribute-value pair separated by minimum
# one space (more spaces and/or tabs are allowed) and an optional
# equal sign in between.
#
# Variable names are case in-sensitive.
#
# Refer to the manpage to learn more about the config
2012-02-10 20:30:38 +01:00
#
# you need to decide which database backend you want to use. Please
# refer to the corresponding documentation for closer information
# about the certain backend! Currently supported types: "binary",
# "dbm", "mysql", "general", "dumper", "pwsafe3" or "text". You must
# also edit/uncomment one section below for the backend you want to
# use!
2012-02-10 20:30:38 +01:00
dbdriver = binary
#
# BINARY backend (the default)
2012-02-10 20:30:38 +01:00
binary::dbname = ~/.notedb # filename
binary::MaxNoteByte = 4096 # max bytes per note entry
binary::MaxTimeByte = 64 # max bytes for the date
#
# MYSQL backend
2012-02-10 20:30:38 +01:00
mysql::dbhost = localhost # hostname
mysql::dbport = 3306 # tcp port
mysql::dbuser = you # db login
mysql::dbpasswd = # db password
mysql::dbname = # database name (default: note)
mysql::encrypt_passwd = 0 # mysql::dbpasswd is
# encrypted (note --encrypt)
#
# DBM backend
dbm::directory = ~/.notedb.dbm
#
# GENERAL backend
general::dbname = ~/.notedb.txt
#
# TEXT backend
text::dbname = ~/.notedb.storable
#
# DUMPER backend
dumper::dbname = ~/.notedb.dumper
#
# Password Safe v3 backend Some notes on this one: This backend
# maintains encryption itself, which is mandatory as well. So you'll
# have to disable encryption (UseEncryption = NO)!
#
# The Password Safe v3 file has its own fields for password and
# username, which note doesn't have. To be compatible, the pwsafe3
# backend parses the note text for those fields and stores them
# accordignly to the db:
#
# For username field: user|username|login|account|benutzer
# For passwd field: password|pass|passwd|kennwort|pw
#
# If it doesn't find it, it will put empty strings into the pwsafe3
# database.
#
# The pwsafe3 database can be accessed by Password Safe (see:
# http://passwordsafe.sourceforge.net/) or other tools which support
# the format (see:
# http://passwordsafe.sourceforge.net/relatedprojects.shtml)
pwsafe3::dbname = ~/.notedb.psafe3
#
# You can use encryption with note, that means notes and timestamps
# will be stored encrypted. This is supported by every db-backend, but
# not the pwsafe3 backend because this one has builtin encryption
# support.
2012-02-10 20:30:38 +01:00
UseEncryption = NO
2012-02-10 20:30:38 +01:00
#
# Specify the encryption protocol. The appropriate perl module needs
# to be installed. Possible velues are IDEA, DES or Blowfish, the
# default is IDEA.
2012-02-10 20:30:38 +01:00
CryptMethod = IDEA
2012-02-10 20:30:38 +01:00
#
# You can run note always in interactive mode by simply
# typing "note". The default is: YES.
2012-02-10 20:30:38 +01:00
AlwaysInteractive = YES
#
# In interactive mode, note issues a list command if you simply hit
# enter. By turning this on, it will issue a longlist command instead
# if you hit just enter. The default is: NO
2012-02-10 20:30:38 +01:00
DefaultLong = NO
#
# You can use an external editor everytime from note instead of STDIN
# for creating new notes. The default is: YES
AlwaysEditor = YES
#
# By default, note looks in the environment for a variable $EDITOR or,
# if this is not the case, for $VISUAL and as fallback it uses 'vi'.
# You can override this by setting this variable here.
2012-02-10 20:30:38 +01:00
PreferredEditor =
#
# If you don't prefer that note updates the timestamp of a note after
# editing, turn this on. It will keep the original timestamp if this
# option is set. The default is: NO
2012-02-10 20:30:38 +01:00
KeepTimeStamp = NO
#
# You can specify your own topic separator here. The default topic
# separator is a normal slash: "/"
2012-02-10 20:30:38 +01:00
TopicSeparator = /
#
# The maximum width for displaying a note, in CHARS. Depends on your
# screen-size. You can set it to "auto", if you wish that note should
# determine the available size automatically.
2012-02-10 20:30:38 +01:00
MaxLen = auto
#
# Turn this off if you dont want note to automatically clear the
# screen after displaying something and after exit. The default is: NO
AutoClear = NO
#
# note can use colors for output, turn this of, if you don't like it,
# or if your terminal does not support it. The default is: YES
UseColors = NO
2012-02-10 20:30:38 +01:00
#
# Color-definitions of the various items. Will only take effect, if
# "UseColors" is turned on!
#
# The following colors are available: black, red, green, yellow, blue,
# magenta, cyan and white.
#
# For bold color write it uppercase (BLACK will be bold black). For
# underlined color append an underscore (blue_ will be underlined
# blue). For inverted color append an "I" (greenI will be inverted
# green).
BorderColor BLACK
NumberColor blue
NoteColor green
TimeColor black
TopicColor BLACK
2012-02-10 20:30:38 +01:00
#
# Additional to colors, you can also do a little bit of formatting
# your notes (bold, underlined, italic) text. The default is: YES.
FormatText = NO
2012-02-10 20:22:14 +01:00
#
# You might specify your own directory for temporary files. note
# needs to create some temp files during editing of notes. You could
# protect this directory using the command: chmod 700 directory. The
# default is: /tmp
2012-02-10 20:30:38 +01:00
TempDirectory = ~/tmp
2012-02-10 20:22:14 +01:00
#
# You can jump to a topic by typing "cd 13" in interactive mode. The
# deault is: NO
ShortCd = YES
2012-02-10 20:22:14 +01:00
CHANGED: does no more use the external touch command to create a new file, use perls open() instead. CHANGED: excluded some of the help texts from the usage message and the interactive help command to a manpage. ADDED: new commandline flag "--encrypt" which one can use to encrypt the mysql database password. This will be decrypted before connecting to the db. There is also a new config file option "encrypt_passwd" which indicates an encrypted db-password. ADDED: another new config option "ShortCd", which can be set to "yes" or 1 and if set, then a command like "cd 13" would jump directly to the topic of the note with the number 13. ADDED: now you can at any time cd back to the "root" of the topic-structure using the command "cd /". CHANGED: mysql.pm does now only do a table-lock on single write accesses, no more on the whole session. This allows one to access the same db twice or more. FIXED: Changed README and Changelog for readability on 80 by 25 displays. And changed indentation of the note script itself. ADDED: NOTEDB.pm - a generic module, which holds some methods, which are used by binary.pm, mysql.pm and dbm.pm. ADDED: NOTEDB.pm generate_search(), which allows one to use AND, OR and various combinations of them using ( and ). ADDED: a search does now return the 2nd line of a note if a matching note's first line is a topic. CHANGED: use "unshift" instead of push to add $libpath to @INC. ADDED: a new feature, Caching of notes. supported by binary.pm and mysql.pm. To turn it on, one need to set "Cache" in the config to a true value.
2012-02-10 20:22:49 +01:00
#
# note can use a cached copy of the note database for list/tree/search
# this is currently only supported by the binary and the mysql
# backends, the general and text backends have an internal cache. The
# default is: NO
2012-02-10 20:30:38 +01:00
Cache = NO
CHANGED: does no more use the external touch command to create a new file, use perls open() instead. CHANGED: excluded some of the help texts from the usage message and the interactive help command to a manpage. ADDED: new commandline flag "--encrypt" which one can use to encrypt the mysql database password. This will be decrypted before connecting to the db. There is also a new config file option "encrypt_passwd" which indicates an encrypted db-password. ADDED: another new config option "ShortCd", which can be set to "yes" or 1 and if set, then a command like "cd 13" would jump directly to the topic of the note with the number 13. ADDED: now you can at any time cd back to the "root" of the topic-structure using the command "cd /". CHANGED: mysql.pm does now only do a table-lock on single write accesses, no more on the whole session. This allows one to access the same db twice or more. FIXED: Changed README and Changelog for readability on 80 by 25 displays. And changed indentation of the note script itself. ADDED: NOTEDB.pm - a generic module, which holds some methods, which are used by binary.pm, mysql.pm and dbm.pm. ADDED: NOTEDB.pm generate_search(), which allows one to use AND, OR and various combinations of them using ( and ). ADDED: a search does now return the 2nd line of a note if a matching note's first line is a topic. CHANGED: use "unshift" instead of push to add $libpath to @INC. ADDED: a new feature, Caching of notes. supported by binary.pm and mysql.pm. To turn it on, one need to set "Cache" in the config to a true value.
2012-02-10 20:22:49 +01:00
2012-02-10 20:24:51 +01:00
#
# You can define your very own time format for time stamps
# YY - the last 2 digits of a year
# YYYY - year
# MM - month
# DD - day
# hh - hours
# mm - minutes
# ss - seconds
# This is the default: (18.10.2000 21:32:08)
2012-02-10 20:30:38 +01:00
TimeFormat = DD.MM.YYYY hh:mm:ss
2012-02-10 20:24:51 +01:00
CHANGED: using Makemaker instead of self-written code in Makefile.PL for installation. No more dependency checks built-in because note runs out-of-the-box without additional modules, as a matter fact. ADDED: if a search matches exactly on one note it will be displayed directly, which avoids typing. CHANGED: the main if-else contruct for calling the several subs has been replaced by a simple closure call. CHANGED: notes will now displayed in a slightly simpler fashion in interactive mode, without the separator line between the title and the note. ADDED: note can now determine automatically the width and height of the terminal window it runs in (in interactive mode only) and sets the width/height of what it prints accordingly. the config variable "MaxLen" must be set to "auto" (which is the default from now on) to get this to work. ADDED: any interactive command will now clear the screen before it does anything. this look much more uncluttered. ADDED: if multiple notes are printed at once (i.e. note 1,2) then the separator line between them will no more being printed because every notes title is preceded by a line anyway. CHANGED: by default the default operation mode is now interactive mode, which is somewhat kindlier to new users. CHANGED: changed to order which editor note tries to find. vi got now higher precedence, because it is likely installed on almost any unix system. CHANGED: cosmetics. NOTE: increased minor version number from 1 to 2 to indicate that development begun after 2 1/2 years pause again :-)
2012-02-10 20:27:05 +01:00
#
# You can make note readonly which is useful for database copies The
# default is: NO
2012-02-10 20:30:38 +01:00
ReadOnly = NO
CHANGED: using Makemaker instead of self-written code in Makefile.PL for installation. No more dependency checks built-in because note runs out-of-the-box without additional modules, as a matter fact. ADDED: if a search matches exactly on one note it will be displayed directly, which avoids typing. CHANGED: the main if-else contruct for calling the several subs has been replaced by a simple closure call. CHANGED: notes will now displayed in a slightly simpler fashion in interactive mode, without the separator line between the title and the note. ADDED: note can now determine automatically the width and height of the terminal window it runs in (in interactive mode only) and sets the width/height of what it prints accordingly. the config variable "MaxLen" must be set to "auto" (which is the default from now on) to get this to work. ADDED: any interactive command will now clear the screen before it does anything. this look much more uncluttered. ADDED: if multiple notes are printed at once (i.e. note 1,2) then the separator line between them will no more being printed because every notes title is preceded by a line anyway. CHANGED: by default the default operation mode is now interactive mode, which is somewhat kindlier to new users. CHANGED: changed to order which editor note tries to find. vi got now higher precedence, because it is likely installed on almost any unix system. CHANGED: cosmetics. NOTE: increased minor version number from 1 to 2 to indicate that development begun after 2 1/2 years pause again :-)
2012-02-10 20:27:05 +01:00
#
# Note may separate titles and topics using horizontal lines when
# listing them. You can turn on this behavior by setting PrintLines to
# YES. The default is: NO
PrintLines = NO
#
# Add a hash to identify notes. Such a hash will persist several
# importy/export cycles and makes each single note unique.
AddTicket = NO
#
# Show an entry on startup. If you want it, create such an entry and
# supply its number here
motd =
CHANGED: using Makemaker instead of self-written code in Makefile.PL for installation. No more dependency checks built-in because note runs out-of-the-box without additional modules, as a matter fact. ADDED: if a search matches exactly on one note it will be displayed directly, which avoids typing. CHANGED: the main if-else contruct for calling the several subs has been replaced by a simple closure call. CHANGED: notes will now displayed in a slightly simpler fashion in interactive mode, without the separator line between the title and the note. ADDED: note can now determine automatically the width and height of the terminal window it runs in (in interactive mode only) and sets the width/height of what it prints accordingly. the config variable "MaxLen" must be set to "auto" (which is the default from now on) to get this to work. ADDED: any interactive command will now clear the screen before it does anything. this look much more uncluttered. ADDED: if multiple notes are printed at once (i.e. note 1,2) then the separator line between them will no more being printed because every notes title is preceded by a line anyway. CHANGED: by default the default operation mode is now interactive mode, which is somewhat kindlier to new users. CHANGED: changed to order which editor note tries to find. vi got now higher precedence, because it is likely installed on almost any unix system. CHANGED: cosmetics. NOTE: increased minor version number from 1 to 2 to indicate that development begun after 2 1/2 years pause again :-)
2012-02-10 20:27:05 +01:00
#
# Enable JSON formatted backups. The option will be removed in version
# 1.5 and become the only available option. In earlier versions: if
# unset or set to NO, YAML will be used.
UseJSON = YES