1
0
mirror of https://github.com/helix-editor/helix synced 2024-11-10 10:34:45 +01:00
A post-modern modal text editor. https://helix-editor.com
Go to file
dependabot[bot] cdfa0dfa36
build(deps): bump chardetng from 0.1.14 to 0.1.15 (#879)
Bumps [chardetng](https://github.com/hsivonen/chardetng) from 0.1.14 to 0.1.15.
- [Release notes](https://github.com/hsivonen/chardetng/releases)
- [Commits](https://github.com/hsivonen/chardetng/commits)

---
updated-dependencies:
- dependency-name: chardetng
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2021-10-19 09:36:25 +09:00
.github fix: Cross compile tests as well 2021-08-14 13:32:29 +09:00
book Improve completion trigger (#838) 2021-10-18 15:14:50 +09:00
contrib
docs Add a "vision" document, to help give people a sense of Helix's direction. (#657) 2021-09-02 00:18:56 +09:00
helix-core Update mdbook style and fix unreadable table head (#806) 2021-10-09 20:35:27 +09:00
helix-lsp Allow language.config (in languages.toml) to be passed in as a toml object (#807) 2021-10-08 11:14:12 +09:00
helix-syntax use latest tree-sitter-elixir with 'not in' query support 2021-10-17 10:50:20 -05:00
helix-term Improve completion trigger (#838) 2021-10-18 15:14:50 +09:00
helix-tui Bump crossterm from 0.20.0 to 0.21.0 (#644) 2021-08-24 09:17:57 +09:00
helix-view Improve completion trigger (#838) 2021-10-18 15:14:50 +09:00
runtime improve menu selected color for nord (#873) 2021-10-18 16:39:54 +09:00
.envrc
.gitignore Dynamically load grammar libraries at runtime 2021-07-14 10:00:05 +09:00
.gitmodules prefer elixir-lang/tree-sitter-elixir 2021-10-17 10:50:19 -05:00
Cargo.lock build(deps): bump chardetng from 0.1.14 to 0.1.15 (#879) 2021-10-19 09:36:25 +09:00
Cargo.toml
CHANGELOG.md Update CHANGELOG.md (#606) 2021-08-18 09:39:52 +09:00
flake.lock chore(nix): update flake inputs and submodule 2021-09-12 20:11:04 +08:00
flake.nix flake: remove hack to fix helix version (#762) 2021-09-18 09:59:26 +09:00
languages.toml Enable c-sharp language and highlights (#861) 2021-10-17 13:45:09 +09:00
LICENSE
README.md Add note about FAQ to README.md (#848) 2021-10-16 10:05:29 +09:00
rust-toolchain.toml Switch rust-toolchain.toml over to stable 2021-09-08 16:34:04 +09:00
rustfmt.toml Add rustfmt.toml to force formatting to use rustfmt defaults 2021-07-23 18:11:22 +09:00
screenshot.png
shell.nix
theme.toml Revert parameter underlining on default theme 2021-09-17 14:43:06 +09:00
TODO.md enable smart case regex search by default (#761) 2021-09-20 13:45:07 +09:00

Helix

Build status

Screenshot

A kakoune / neovim inspired editor, written in Rust.

The editing model is very heavily based on kakoune; during development I found myself agreeing with most of kakoune's design decisions.

For more information, see the website or documentation.

All shortcuts/keymaps can be found in the documentation on the website.

Troubleshooting

Features

  • Vim-like modal editing
  • Multiple selections
  • Built-in language server support
  • Smart, incremental syntax highlighting and code editing via tree-sitter

It's a terminal-based editor first, but I'd like to explore a custom renderer (similar to emacs) in wgpu or skulpin.

Installation

Note: Only certain languages have indentation definitions at the moment. Check runtime/queries/<lang>/ for indents.toml.

We provide packaging for various distributions, but here's a quick method to build from source.

git clone --recurse-submodules --shallow-submodules -j8 https://github.com/helix-editor/helix
cd helix
cargo install --path helix-term

This will install the hx binary to $HOME/.cargo/bin.

Helix also needs its runtime files so make sure to copy/symlink the runtime/ directory into the config directory (for example ~/.config/helix/runtime on Linux/macOS). This location can be overriden via the HELIX_RUNTIME environment variable.

Packages already solve this for you by wrapping the hx binary with a wrapper that sets the variable to the install dir.

NOTE: running via cargo also doesn't require setting explicit HELIX_RUNTIME path, it will automatically detect the runtime directory in the project root.

Packaging status

MacOS

Helix can be installed on MacOS through homebrew via:

brew tap helix-editor/helix
brew install helix

Contributing

Contributors are very welcome! No contribution is too small and all contributions are valued.

Some suggestions to get started:

  • You can look at the good first issue label on the issue tracker.
  • Help with packaging on various distributions needed!
  • To use print debugging to the ~/.cache/helix/helix.log file, you must:
    • Print using log::info!, warn!, or error!. (log::info!("helix!"))
    • Pass the appropriate verbosity level option for the desired log level. (hx -v <file> for info, more vs for higher severity inclusive)
  • If your preferred language is missing, integrating a tree-sitter grammar for it and defining syntax highlight queries for it is straight forward and doesn't require much knowledge of the internals.

We provide an architecture.md that should give you a good overview of the internals.

Getting help

Your question might already be answered on the FAQ.

Discuss the project on the community Matrix Space (make sure to join #helix-editor:matrix.org if you're on a client that doesn't support Matrix Spaces yet).