Skip to content

Latest commit

 

History

History
148 lines (123 loc) · 5.39 KB

README.org

File metadata and controls

148 lines (123 loc) · 5.39 KB

:lang julia

Description

This module adds support for the Julia language to Doom Emacs.

  • Syntax highlighting and latex symbols from doom-package:julia-mode
  • REPL integration from doom-package:julia-repl
  • Code completion and syntax checking, requires doom-module::tools lsp and doom-module:+lsp

Maintainers

This module has no dedicated maintainers. Become a maintainer?

Module flags

+lsp
Enable LSP support for julia-mode. Requires doom-module::tools lsp and a langserver (supports LanguageServer.jl).
+tree-sitter
Leverages tree-sitter for better syntax highlighting and structural text editing. Requires doom-module::tools tree-sitter.
+snail
Use Snail, a development environment and REPL interaction package for Julia in the spirit of Common Lisp’s SLIME and Clojure’s CIDER. It enables convenient and dynamic REPL-driven development.

Packages

  • doom-package:julia-mode
  • doom-package:julia-repl
  • if doom-package:+lsp
    • if doom-module::tools lsp
      • doom-package:lsp-julia
      • doom-package:lsp
    • if doom-module::tools lsp +eglot
      • doom-package:eglot-jl
      • doom-package:eglot
  • if +snail
    • julia-snail

Hacks

No hacks documented for this module.

Changelog

This module does not have a changelog yet.

Installation

Enable this module in your doom! block.

This module requires Julia and an language server if doom-module:+lsp is enabled.

Language Server

doom-module:+lsp requires LanguageServer.jl and SymbolServer.jl. The doom-package:lsp-julia and doom-package:eglot-jl packages both come bundled with their own versions of these servers, which is used by default. If you’re happy with that, no further configuration is necessary.

However, to use your own installation you will need to install then configure them. To install them, execute these commands in a Julia REPL:

using Pkg
Pkg.add("LanguageServer")
Pkg.add("SymbolServer")

Then configure doom-package:lsp-julia or doom-package:eglot-jl depending on whether you have enabled doom-module::tools lsp or doom-module::tools lsp +eglot, respectively:

lsp-julia

To instruct doom-package:lsp-julia not to use the built-in package:

;; in $DOOMDIR/config.el
(setq lsp-julia-package-dir nil)

To find your installation of LanguageServer.jl, doom-package:lsp-julia needs to know the environment in which it is installed. This is set to v1.6 by default as it is the current LTS:

;; in $DOOMDIR/config.el
(after! lsp-julia
  (setq lsp-julia-default-environment "~/.julia/environments/v1.6"))

eglot-jl

To find your installation of LanguageServer.jl, doom-package:eglot-jl must know the environment in which it is installed. This is set to v1.6 by default as it is the current LTS:

;; in $DOOMDIR/config.el
(setq eglot-jl-language-server-project "~/.julia/environments/v1.6")

But to let doom-package:eglot-jl use the environment bundled with it, set it to eglot-jl-base instead:

;; in $DOOMDIR/config.el
(after! eglot-jl
  (setq eglot-jl-language-server-project eglot-jl-base))

Usage

🔨 This module’s usage documentation is incomplete. Complete it?

Language Server

doom-module:+lsp adds code completion, syntax checking, formatting and other doom-package:lsp-mode or doom-package:eglot features. It requires LanguageServer.jl, the installation of which is described above.

Snail

KeybindCommand
<localleader> ’julia-snail
<localleader> ajulia-snail-package-activate
<localleader> rjulia-snail-update-module-cache
<localleader> djulia-snail-doc-lookup
<localleader> e bjulia-snail-send-buffer-file
<localleader> e ljulia-snail-send-line
<localleader> e rjulia-snail-send-region
<localleader> e ejulia-snail-send-dwim

Configuration

🔨 This module’s configuration documentation is incomplete. Complete it?

Change the default environment for the Julia language server

doom-package:lsp-julia requires a variable be set for the Julia environment. This is set to v1.6 by default as it is the current LTS:

;; in $DOOMDIR/config.el
(after! lsp-julia
  (setq lsp-julia-default-environment "~/.julia/environments/v1.6"))

Troubleshooting

There are no known problems with this module. Report one?

Frequently asked questions

This module has no FAQs yet. Ask one?

Appendix

🔨 This module has no appendix yet. Write one?