lenormf / kakoune-extra

Extra scripts that implement experimental features, highlight custom files/languages

Archived

This repository is not being maintained any more, and doesn't accept further user contributions.

The highlighters have been moved to the kakoune-extra-filetypes repository, which is bigger, maintained and accept user contributions.

Commands remain here for the sake of posterity. Feel free to grave dig any files and make them work with more recent version of kakoune.

kakoune-extra

This repository contains several scripts for the kakoune code editor that were not eligible to be merged with the core scripts that kakoune ships with, but still implement useful experimental features or allow highlighting of custom file formats.

Scripts are all fairly well commented, but those whose use require more than a quick sentence in an inlined comment have their own .asciidoc documentation file (e.g. fzf.asciidoc).

Versioning

The master branch is compatible with the latest stable version of the editor, while the dev branch targets the latest HEAD, for users who use the Git version.

How to use the scripts

System wide availability

Drop the scripts relevant to your interest in the /usr/share/kak/rc directory. They will be automatically loaded everytime a new kak process is started.

Per user availability

Copy the scripts you want to have autoloaded in the $XDG_CONFIG_HOME/kak/rc directory. They will be automatically loaded everytime a new kak process is started.

Keeping scripts up to date

If you want to be able to update the scripts easily, clone this repository and create symbolic links to the scripts you want to have loaded automatically in the system/user rc directory (c.f. previous points).

Categories

The scripts that are in the root directory of the repository are general purpose, while the following categories hold scripts with particular uses.

Filetypes

Support for filetypes that are not handled by the upstream version.

Games

Small games to pass time, with minimal dependencies.

Widgets

Placed in the widgets directory, those scripts store information in variables whose prefix is modeline_. As their name suggest, they are aimed at being used in the modelinefmt variable, and hold specific information.

Example: the percent widget will update the modeline_pos_percent option with the relative position of the cursor in the buffer (using a percentage). You can use it by either inserting %opt{modeline_pos_percent}% variable in modelinefmt, or directly in a script or yours.

Contributing

Feel free to create a pull request if you want to share a useful script.

License

All the scripts in this repository are UNLICENSE'd.

kakoune-extra's Issues

Feature request: rubocop for syntastic

Please)

filetype/git.kak doesn't seem to work

It looks like the file is loaded and the highlighters are technically set but they are not actually highlighting anything even when I go beyond the limits. I'm using Kakoune v2019.07.01

Add :terminal command implementation to dvtm

comnotes.kak not working.

In *debug*

/home/wheatdog/.config/kak/autoload/comnotes.kak:1:1: 'add-highlighter' no such id: 'c'
Autoload: could not load /home/wheatdog/.config/kak/autoload/comnotes.kak

Buffer wiped by syntax errors on save

If there's a syntax error in a Go file and syntastic_autoformat is set to yes, the buffer will be wiped as gofmt replaces its normal output of the source with the error message. I assume I'm not alone, but must be missing some kind of workflow or extra .kakrc scaffolding.

idsession.kak

Use autogenerated sessionid for generating the human-friendly one instead of rand.

grepmenu fails with certain inputs

The :grepmenu command seems to fail on certain inputs. Seems to be an issue with escaping quotes. For example, with the file:

'--pass'

:grepmenu pass gives the error:

Error: 1:1: 'grepmenu' 1:2: 'evaluate-commands' parse error: unterminated string '...'

I don't really know awk and haven't tried to debug this much further, but hopefully that's enough information to start with.