howm: note-taking tool on Emacs

Japanese

# howm: Write fragmentarily and read collectively.

Howm is a note-taking tool on Emacs. It is similar to emacs-wiki.el; you can enjoy hyperlinks and full-text search easily. It is not similar to emacs-wiki.el; it can be combined with any format.

- Quick start, Download (snapshot: / git )
- Introduction by Leah Neukirchen (thx!)
- Detailed English & Russian tutorials by Andrei Sukhovskii (thx!)
- Tips, Bug reports & discussions
- old tutorial, old mailing list (may be broken. archives)

The following screenshot illustrates the Howm linking system:

(Colorscheme: Modus themes.)

## Hyperlinks

- goto link: file name or keyword

            >>> ~/BabyloniaWave.txt
            >>> highway planet

- come-from link: If you write

            <<< crystal star cluster

  in file A, all strings 'crystal star cluster' in other files are automatically linked to A.

## Full-text search

- Everything is based on full-text search (grep); the above 'links' are shortcuts to grep.
- Write fragmentarily and read collectively; you can concatenate all matched notes into a single buffer.

## No conversion

You can keep your favorite style. :-)

- text file and free format
- implemented as a minor mode; can be combined with other modes.

## Todo list with magic sorting

- Reminder: sinks slowly.
- Todo: floats slowly.
- Deadline: floats rapidly when the date is approaching.

## Manual installation

- './configure', 'make', and 'make install'. Files are installed to /usr/share/emacs/site-lisp/howm/ and /usr/local/share/howm/.
- Write below in your .emacs.

              (require 'howm)

- If you see 'cannot open load file' error, put this before the above description.

              (add-to-list 'load-path "/usr/share/emacs/site-lisp/howm/")

- (Optional) When howm runs too slow, try 'M-x customize-group RET howm-efficiency RET'. In particular, the below settings will be necessary for heavy users.

              (setq howm-view-use-grep t)  ;; use external grep
              (setq howm-menu-refresh-after-save nil)
              (setq howm-menu-expiry-hours 6)  ;; cache menu N hours
              (setq howm-menu-file "0000-00-00-000000.txt")  ;; don't *search*

## Customization

For customization, try 'M-x customize-group RET howm RET'.

## Updates

### 1.5.2 to 1.5.3

Minor fixes.

### 1.5.1 to 1.5.2

Improvements:

- Added simulation for the todo list on a specific date (M-x howm-simulate-todo). ref
- Added filter-by-keyword to support aliases. thx
- Added a user-option to exclude certain files from the recent-note lists (howm-recent-excluded-files-regexp). thx
- Improved screenshots and English documents. thx thx thx
- Added a hint to avoid typical misuse of the menu. thx

Fixes:

- The summary/contents buffers now inherit from text-mode. thx
- Removed obsolete C-h binding. thx
- Fixed broken back-scrolling by BS key in terminals. thx
- Fixed unintended "M-x ..." in describe-mode. thx
- Prevented double-splitting windows when display-buffer-base-action is non-nil. thx

### 1.5.0 to 1.5.1

- The incremental search is enabled by default. See M-x customize-group RET howm-iigrep RET. This feature only works if M-x customize-variable RET howm-view-use-grep RET is set to "On".
- Added links. (English & Russian tutorials, introduction video)
- Fixed several minor bugs.

(older changes)

## Contact

My email address is written at the beginning of source files.