libframe | ||
scripts | ||
.clang-format | ||
.gitignore | ||
acme.c | ||
addr.c | ||
buff.c | ||
build.sh | ||
cols.c | ||
config.def.h | ||
dat.h | ||
disk.c | ||
ecmd.c | ||
edit.c | ||
edit.h | ||
elog.c | ||
exec.c | ||
file.c | ||
fns.h | ||
fsys.c | ||
install.sh | ||
LICENSE | ||
logf.c | ||
look.c | ||
mkfile | ||
README.md | ||
regx.c | ||
rows.c | ||
scrl.c | ||
scrot.png | ||
text.c | ||
time.c | ||
Toolbox | ||
util.c | ||
wind.c | ||
xfid.c |
acme9k
This is a fork of the acme
text editor from the plan9port
distribution. It combines the customizability of lumar/sminez's forks and acme2k with upstream fixes from 9fans and some custom work.
Namely, when click-to-focus is enabled, the active text frame renders the tick (aka the text cursor) with the hilight color (COLOR_<TAG|BODY>_HI
); otherwise the tick is rendered with the text color (COLOR_<TAG|BODY>_TX
). This is all done with a fork of libframe
which is included in the distribution and compiled into the program, and some simple logic that selects the proper ticks for each frame when the focus changes and forces a redraw.
See the config.def.h
for out of the box customizations that can be done. Below is a screenshot of my typical setup (note I use compositing rules to make the window transparent, this is not in the scope of acme
itself).
usage
Keybindings are as follows:
- Ctrl
- c: copy
- x: cut
- v: paste
- z: undo
- y: redo
- s: save
- e: move to end of line
- a: move to begining of line
- f: filename completion
- u: kill line
- w: kill word (backwords)
- Up/Down: move cursor
- PgUp/PgDown: the obvious
- Esc: cut if there is a selection, otherwise hilight the most recently edited text
Users unfamiliar with acme
in general should check the following resources:
- Acme: A User Interface for Programmers - the definitive guide from Rob Pike
- A Tour of Acme - Russ Cox giving a tour of acme on plan9port (video)
- acme(1) - manual page
build
- Clone this repository
- From the repo root, if desired, copy
config.def.h
toconfig.h
and make your modifications (you will almost certainly want to change the fonts; my default primary font is Sauce Code Pro Nerd Font) - Run
./build.sh
from the repo root.
install
After building, run ./install.sh
; If run as a regular user, it will install to ~/bin/9
; if run as root, it will overwrite the systemwide acme
in $PLAN9/bin
helpers
The scripts
directory contains some helpers, mostly just shortcuts for acme-lsp. Copy them to your $PATH
and let 'em rip.
Of particular interest:
agols
: pass a colon-separated list of workspaces to startacme-lsp
for go developmentatsls
: run without arguments to startacme-lsp
for javascript/typescript developmentacls
: run without arguments to startacme-lsp
for C/C++ development
For acls
to work right with plan9port C stuff you will need to add your $PLAN9/include
directory to the compile flags in either the project .clangd
file or your ~/.config/clangd/config.yaml
:
CompileFlags:
Add:
- "-I/usr/lib/plan9/include"
See also:
- plumbing rules - my plumbing rules, includes opening headers by right-click on the filename in an include directive
The Toolbox
file contains a compilation of sam
command language (Edit
scripts) that may be useful.
thanks
- rob pike - author of the original
acme
for Plan9 - russ cox and the rest of the 9fans for plan9port
- lumar - looks like they deleted their github repos but I originally pulled my keybinds from there
- sminez - possibly the original source of lumar's keybindings
- karahobny - creator of acme2k, a big inspiration for this project
- aksr - source of the missing tag border pixel fix