1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
|
<html> <head>
<title>howm: note-taking tool on Emacs</title>
</head>
<body>
<a href="index-j.html">Japanese</a>
<hr>
<h1><a href="https://kaorahi.github.io/howm/">howm</a>: Write fragmentarily and read collectively.</h1>
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.
<ul>
<li> <a href="https://github.com/kaorahi/howm?tab=readme-ov-file#quick-start">Quick start</a>,
<a href="https://github.com/kaorahi/howm/releases">Download</a>
(snapshot:
<a href="https://melpa.org/#/howm">howm(melpa></a>
/
<a href="https://github.com/kaorahi/howm">git</a>
)
<li> <a href="https://leahneukirchen.org/blog/archive/2022/03/note-taking-in-emacs-with-howm.html">Introduction by Leah Neukirchen</a> (thx!)
<li> <a href="https://emacs101.github.io/howm.html">Detailed tutorial by Andrei Sukhovskii</a> (thx!)
<li> <a href="https://www.youtube.com/watch?v=RHxYMF1wsmk">1-minute introduction on YouTube by Raoul Comninos</a> (thx!)
<li> <a href="https://www.emacswiki.org/emacs/HowmMode">Tips</a>, <a href="https://github.com/kaorahi/howm/issues">Bug reports & discussions</a>
<li style="opacity: 0.5;"> <a href="README.html">old tutorial</a>, <a href="https://lists.osdn.me/mailman/listinfo/howm-eng">old mailing list</a> (may be broken. <a href="https://osdn.net/projects/howm/lists/archive/eng/">archives</a>)
</ul>
<hr>
The following screenshot illustrates the Howm linking system:
<p><img alt="screen shot" src="screenshot.png" style="max-height: 90%; max-width: 90%; height: auto; width: auto;"></p>
(Colorscheme: <a href="https://protesilaos.com/emacs/modus-themes">Modus themes</a>.)
<hr>
<h2>Hyperlinks</h2>
<ul>
<li>goto link: file name or keyword
<pre>
>>> ~/BabyloniaWave.txt
>>> highway planet
</pre>
<li> come-from link:
If you write
<pre>
<<< crystal star cluster
</pre>
in file A,
all strings 'crystal star cluster' in other files are automatically linked to A.
</ul>
<img src="go.png" alt="goto link">
<img src="come.png" alt="come-from link">
<h2>Full-text search</h2>
<ul>
<li>Everything is based on full-text search (grep);
the above 'links' are shortcuts to grep.
<li>Write fragmentarily and read collectively;
you can concatenate all matched notes into a single buffer.
</ul>
<h2>No conversion</h2>
You can keep your favorite style. :-)
<ul>
<li>text file and free format
<li>implemented as a minor mode; can be combined with other modes.
</ul>
<h2>Todo list with magic sorting</h2>
<ul>
<li>Reminder: sinks slowly.
<li>Todo: floats slowly.
<li>Deadline: floats rapidly when the date is approaching.
</ul>
<hr>
<h2>Manual installation</h2>
<ul>
<li> './configure', 'make', and 'make install'.
Files are installed to /usr/share/emacs/site-lisp/howm/
and /usr/local/share/howm/.
<li> Write below in your .emacs.
<pre>
(require 'howm)
</pre>
<li> If you see 'cannot open load file' error, put this before
the above description.
<pre>
(add-to-list 'load-path "/usr/share/emacs/site-lisp/howm/")
</pre>
<li> (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.
<pre>
(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*
</pre>
</ul>
<h2>Customization</h2>
For customization, try 'M-x customize-group RET howm RET'.
<h2><a name="changes"></a>Updates</h2>
<h3>1.5.5 to 1.5.6</h3>
<p>
<a href="https://github.com/kaorahi/howm/commits/master?since=2025-08-06&until=2025-12-31">Minor updates.</a>
</p>
<h3>1.5.4 to 1.5.5</h3>
<ul>
<li>Changes
<ul>
<li>
In the summary buffer, "f contents RET" now performs pure filtering (it simply retains only the matched entries).
The previous behavior (filter and list matching lines) is available via "G" or "f grep RET".
Similarly, "f Keyword-in-contents RET" has changed; the previous behavior is now available via "f Grep-keyword RET".
Also, "F" and "K" now serve as shortcuts for these pure filtering commands.
<a href="https://github.com/kaorahi/howm/issues/79">thx</a>
<ul>
<li>
If you really want to restore the previous behavior, add the following after loading howm:
<pre><code>;; Restore the behavior of "f contents RET" etc. in the list view
;; to how it was in howm-1.5.4 or earlier
(setf (alist-get "contents" howm-view-filter-methods nil nil #'equal)
;; Use the old name intentionally for safety in older versions
'howm-view-filter-by-contents)
(setf (alist-get "Keyword-in-contents" howm-view-filter-methods nil nil #'equal)
'howm-view-filter-by-keyword-in-contents)
(define-key howm-view-summary-mode-map "K" 'howm-keyword-to-kill-ring)
(define-key howm-view-contents-mode-map "K" 'howm-keyword-to-kill-ring)</code></pre>
</li>
</ul>
</li>
</ul>
</li>
<li>Improvements
<ul>
<li>
List view can now open in a new frame or tab, and pressing "q" closes it
(Run "M-x customize-group RET howm-list-bufwin RET", then set "howm-view-window-location" and "howm-view-close-frame/tab-on-exit")
<a href="https://github.com/kaorahi/howm/issues/70">thx</a>
</li>
<li>
Remove mistakenly registered come-from keywords using "M-x howm-keyword-remove"
<a href="https://github.com/kaorahi/howm/issues/74">thx</a>
</li>
<li>
Extended quick-shift functionality for dates (RET on a date → "[" and "]" keys)
<ul>
<li>"." key jumps to today's date</li>
<li>Also supported in the menu</li>
</ul>
</li>
<li>
The theme functionality (cf. howm-follow-theme) is now customizable via howm-auto-theme-custom-entries
<a href="https://github.com/kaorahi/howm/issues/82">thx</a>
</li>
<li>(Removed "cheats" from cheat-font-lock.el)</li>
</ul>
</li>
<li>Fixes
<ul>
<li>
Org-related issues
<a href="https://github.com/kaorahi/howm/issues/29">thx</a>
<a href="https://github.com/kaorahi/howm/issues/62">thx</a>
<a href="https://github.com/kaorahi/howm/issues/64">thx</a>
<a href="https://github.com/kaorahi/howm/issues/65">thx</a>
<a href="https://github.com/kaorahi/howm/issues/66">thx</a>
<a href="https://github.com/kaorahi/howm/issues/68">thx</a>
</li>
<li>
Fonts could be too large in the summary buffer if howm-follow-theme was enabled
<a href="https://github.com/kaorahi/howm/issues/82">thx</a>
</li>
<li>
Notes without titles now appear in %recent and %random in the menu
<a href="https://github.com/kaorahi/howm/issues/68">thx</a>
</li>
<li>
howm-dup now respects howm-prepend settings
<a href="https://github.com/kaorahi/howm/issues/76">thx</a>
</li>
<li>
Prevented potential infinite loop in howm-view-dired-goto
<a href="https://github.com/kaorahi/howm/issues/60">thx</a>
</li>
<li>
(Fixed warning "Missing lexical-binding cookie" during "make test")
</li>
</ul>
</li>
</ul>
<h3>1.5.3 to 1.5.4</h3>
<ul>
<li>Make getting started convenient (see "Quick start" in README.md)
<ul>
<li>Integrate with Markdown and Org
<a href="https://github.com/kaorahi/howm/issues/17">thx</a>
<a href="https://github.com/kaorahi/howm/issues/29">thx</a>
<a href="https://github.com/kaorahi/howm/issues/50">thx</a>
</li>
<li>Apply theme functionality
<a href="https://github.com/kaorahi/howm/issues/34">thx</a></li>
<li>Improve the menu
<ul>
<li>Align items and enhance colors
<a href="https://github.com/kaorahi/howm/issues/38">thx</a>
<a href="https://github.com/kaorahi/howm/issues/54">thx</a>
<a href="https://github.com/kaorahi/howm/issues/57">thx</a>
</li>
<li>Display update timestamps
<a href="https://github.com/kaorahi/howm/issues/44">thx</a></li>
<li>Configure headers according to settings
<a href="https://github.com/kaorahi/howm/issues/42">thx</a></li>
<li>Fix bugs and inconsistencies
<a href="https://github.com/kaorahi/howm/issues/38">thx</a></li>
</ul>
</li>
<li>Update the documentation
<a href="https://github.com/kaorahi/howm/issues/38">thx</a>
<a href="https://github.com/kaorahi/howm/issues/47">thx</a>
</li>
</ul>
</li>
<li>RET on a date to switch to the previous/next day using "[]" keys
<a href="https://github.com/kaorahi/howm/issues/51">thx</a></li>
<li>Use the grep command by default on Linux and Mac
<a href="https://github.com/kaorahi/howm/issues/44">thx</a>
<a href="https://github.com/kaorahi/howm/issues/6">thx</a></li>
<li>Exclude backup files from the count of search results
<a href="https://github.com/kaorahi/howm/issues/55">thx</a></li>
<li>Minor bug fixes</li>
</ul>
<h3>1.5.2 to 1.5.3</h3>
<p>
<a href="https://github.com/kaorahi/howm/commits/master?since=2025-01-01T00:00:00Z&until=2025-01-29T23:59:59Z">Minor fixes.</a>
</p>
<h3>1.5.1 to 1.5.2</h3>
<p>
Improvements:
<ul>
<li>Added simulation for the todo list on a specific date (M-x howm-simulate-todo).
<a href="https://github.com/kaorahi/howm/issues/4">ref</a></li>
<li>Added filter-by-keyword to support aliases.
<a href="https://github.com/kaorahi/howm/issues/19">thx</a></li>
<li>Added a user-option to exclude certain files from the recent-note lists (howm-recent-excluded-files-regexp).
<a href="https://github.com/kaorahi/howm/pull/23">thx</a></li>
<li>Improved screenshots and English documents.
<a href="https://github.com/kaorahi/howm/pull/8">thx</a>
<a href="https://github.com/kaorahi/howm/issues/13#issuecomment-2358456865">thx</a>
<a href="https://github.com/kaorahi/howm/pull/20">thx</a></li>
<li>Added a hint to avoid typical misuse of the menu.
<a href="https://github.com/kaorahi/howm/issues/18">thx</a></li>
</ul>
Fixes:
<ul>
<li>The summary/contents buffers now inherit from text-mode.
<a href="https://github.com/kaorahi/howm/issues/11">thx</a></li>
<li>Removed obsolete C-h binding.
<a href="https://github.com/kaorahi/howm/issues/15">thx</a></li>
<li>Fixed broken back-scrolling by BS key in terminals.
<a href="https://github.com/kaorahi/howm/issues/15">thx</a></li>
<li>Fixed unintended "M-x ..." in describe-mode.
<a href="https://github.com/kaorahi/howm/pull/16">thx</a></li>
<li>Prevented double-splitting windows when display-buffer-base-action is non-nil.
<a href="https://github.com/kaorahi/howm/pull/21">thx</a></li>
</ul>
</p>
<h3>1.5.0 to 1.5.1</h3>
<p>
<ul>
<li>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".</li>
<li>Added links. (English & Russian tutorials, introduction video)</li>
<li>Fixed several minor bugs.</li>
</ul>
</p>
<a href="old_changes.html">(older changes)</a>
<hr>
<h2>Contact</h2>
My email address is written at the beginning of source files.
<hr>
</body> </html>
|
