037b018cdd
These optional dotfiles indicate the root of a module or module group (:lang), and will later contain module metadata. They will also serve as an alternative to packages.el and doctor.el, and will aide the parts of the v3.0 module API concerned with resolving the current module from a path (`doom-module-from-path`), which currently rely too heavily on parsing path strings. For now, however, they're simply placeholders. |
||
|---|---|---|
| .. | ||
| .doommodule | ||
| autoload.el | ||
| config.el | ||
| doctor.el | ||
| packages.el | ||
| README.org | ||
:lang julia
Description unfold
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-module::tools lsp
-
if doom-module::tools lsp +eglot
-
Hacks
No hacks documented for this module.
TODO 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))TODO 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
| Keybind | Command |
|---|---|
| <localleader> ' | julia-snail |
| <localleader> a | julia-snail-package-activate |
| <localleader> r | julia-snail-update-module-cache |
| <localleader> d | julia-snail-doc-lookup |
| <localleader> e b | julia-snail-send-buffer-file |
| <localleader> e l | julia-snail-send-line |
| <localleader> e r | julia-snail-send-region |
| <localleader> e e | julia-snail-send-dwim |
TODO 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?
TODO Appendix
This module has no appendix yet. Write one?