Small text editor based on 'kilo' by antirez
Go to file
sloum 50e4ca9c6f Adds nimf syntax 2020-08-01 15:12:17 -07:00
.gitignore Adds r command to replace a char 2020-01-04 22:47:39 -08:00
LICENSE Got most of a paste buffer working 2020-01-01 22:51:00 -08:00
Makefile Fixes error in makefile 2020-02-09 22:59:40 -08:00
README.md Adds readme and more syntaxes to highlight 2020-01-03 15:56:40 -08:00
config.h Adds auto-indent feature 2020-02-09 22:44:16 -08:00
hermes.1 Updates man page 2020-01-04 22:48:53 -08:00
hermes.c Merge branch 'master' of https://git.rawtext.club/sloum/hermes 2020-03-14 13:58:48 -07:00
syntaxhl.h Adds nimf syntax 2020-08-01 15:12:17 -07:00

README.md

Hermes

Hermes is a a small text editor (~40k compiled), and is a fork of kilo by antirez. Hermes takes kilo and modifies the control mechanisms to give a stripped down/lo-fi vi-like experience. This is still a big work in progress but is semi-usable.

Requirements

You will need a C compiler. I believe all of the headers are pretty standard and should be present. I have built this on Debian and on OSX and did not need to install any additional headers/tooling.

Configuring

The file config.h allows for configuring a few items: width of tabs, how many times to verify quitting without saving, whether or not to use the alternate terminal screen/buffer, and configuring the colors.

Additionally, the file syntaxhl.h controls the syntax highlighting for programming languages. The format is pretty clear in the file so it should be easy enough to add basic support for languages that I have not provided.

Both files are commented and should be easily configurable.

Status

Things are buggy as I work through them, but it should be a usable experience. That said, there is no undo buffer... which is rough. The paste buffer is mostly working, so some things can be undone by pasting after deleting. Visual mode is woring... sort of: multiline selections work for deleting, but have issues adding the deleted content (or yanked content as the case may be) to the paste buffer.

I think the editor in its current state will work fine for its intended purpose: writing gopher phlogs on colorfield.space

Anything much heavier than that might be problematic. It works pretty well as a file viewer as well though and the code highlighting helps.

Reasoning

I mostly started working on this because my server community needs a more complete text editor than chalk and I still want to keep most of the userspace limited to programs that users, myself included, made or contributed to. This is my first time writing any decent amount of C code, so has also worked out as a good project to introduce me to more C. I am convinced that the C that I have added to this project is maybe the ugliest code I have ever written, lol. But everyone has to start somewhere, right? Rather than just start with a full version of Kilo, I used this tutorial to get me started and typed every character by hand. I left out some features and added some of my own in the process.

Known issues

  • Pasting in from the system clipboard works, but things get kind of weird and unpredictable. Particularly for long lines.
  • In general really long lines have some issues
  • VisualMode is buggy and cannot yank multiline selections (but can delete them)
  • Numerical multipliers work (ie. 10dw would delete the next ten words), but there are issues dealing with the paste buffer and only the last deleted item will be added to the buffer, rather than the whole group of them
  • Will not create a file when passed a filepath that does not exist. Instead, call without arguments and then save the file as whatever you want
  • Only supports ascii, NO UNICODE support whatsoever

Try things out to see what works. Save often when you know things are in a good state.

License

This project uses the same license as kilo (BSD 2-clause). If you modify or distribute it please be sure to do so with the included LICENSE file which credits antirez for kilo and myself for the modifications I have made, and describes the terms of the license.