docs: change link format

This commit is contained in:
TEC 2022-09-26 02:19:42 +08:00 committed by Henrik Lissner
parent 58fb83c98e
commit 5ac2a5258b
160 changed files with 1161 additions and 1152 deletions

View file

@ -17,24 +17,24 @@ This holy module brings the Vim editing model to Emacs.
as a foundation.
** Packages
- [[doom-package:][evil]]
- [[doom-package:][evil-args]]
- [[doom-package:][evil-collection]] if [[doom-module:][+everywhere]]
- [[doom-package:][evil-easymotion]]
- [[doom-package:][evil-embrace]]
- [[doom-package:][evil-escape]]
- [[doom-package:][evil-exchange]]
- [[doom-package:][evil-indent-plus]]
- [[doom-package:][evil-lion]]
- [[doom-package:][evil-nerd-commentary]]
- [[doom-package:][evil-numbers]]
- [[doom-package:][evil-quick-diff]]
- [[doom-package:][evil-snipe]]
- [[doom-package:][evil-surround]]
- [[doom-package:][evil-textobj-anyblock]]
- [[doom-package:][evil-vimish-fold]]
- [[doom-package:][evil-visualstar]]
- [[doom-package:][exato]]
- [[doom-package:evil]]
- [[doom-package:evil-args]]
- [[doom-package:evil-collection]] if [[doom-module:+everywhere]]
- [[doom-package:evil-easymotion]]
- [[doom-package:evil-embrace]]
- [[doom-package:evil-escape]]
- [[doom-package:evil-exchange]]
- [[doom-package:evil-indent-plus]]
- [[doom-package:evil-lion]]
- [[doom-package:evil-nerd-commentary]]
- [[doom-package:evil-numbers]]
- [[doom-package:evil-quick-diff]]
- [[doom-package:evil-snipe]]
- [[doom-package:evil-surround]]
- [[doom-package:evil-textobj-anyblock]]
- [[doom-package:evil-vimish-fold]]
- [[doom-package:evil-visualstar]]
- [[doom-package:exato]]
** Hacks
- The o/O keys will respect and continue commented lines (can be disabled by
@ -76,11 +76,11 @@ The following vim plugins have been ported to evil:
This module has also ported vim-unimpaired keybinds to Emacs.
In other modules:
- The [[doom-module:][:ui neotree]] & [[doom-module:][:ui treemacs]] modules provide a =NERDTree= equivalent.
- The [[doom-module:][:editor multiple-cursors]] module contains functionality equal to the
- The [[doom-module::ui neotree]] & [[doom-module::ui treemacs]] modules provide a =NERDTree= equivalent.
- The [[doom-module::editor multiple-cursors]] module contains functionality equal to the
following vim plugins:
- [[doom-package:][evil-multiedit]] => [[github:hlissner/vim-multiedit][vim-multiedit]]
- [[doom-package:][evil-mc]] => [[https://github.com/terryma/vim-multiple-cursors][vim-multiple-cursors]]
- [[doom-package:evil-multiedit]] => [[github:hlissner/vim-multiedit][vim-multiedit]]
- [[doom-package:evil-mc]] => [[https://github.com/terryma/vim-multiple-cursors][vim-multiple-cursors]]
** Custom Text Objects
This module provides a couple extra text objects, along with the built-in ones.
@ -157,13 +157,13 @@ To undo this, use:
#+end_src
** The [[kbd:][s]]/[[kbd:][S]] keys behave differently from Vim
Doom replaces the [[kbd:][s]] and [[kbd:][S]] keys with the [[doom-package:][evil-snipe]] package (a port of
Doom replaces the [[kbd:][s]] and [[kbd:][S]] keys with the [[doom-package:evil-snipe]] package (a port of
vim-seek/vim-sneak for 2-character versions of f/F/t/T).
To disable evil-snipe on s/S, you can either:
1. Disable ~evil-snipe-mode~ by adding ~(remove-hook 'doom-first-input-hook
#'evil-snipe-mode)~ to =$DOOMDIR/config.el=,
2. Or disable [[doom-package:][evil-snipe]] completely with ~(package! evil-snipe :disable t)~
2. Or disable [[doom-package:evil-snipe]] completely with ~(package! evil-snipe :disable t)~
added to =$DOOMDIR/packages.el=, but this will also disable incremental
highlighting for the f/F/t/T motions keys.
3. Or use [[kbd:][cl]] and [[kbd:][cc]], respectively; they do the same thing.
@ -198,7 +198,7 @@ If you prefer the old behavior, it can be reversed with:
#+end_quote
Evil-specific configuration and keybindings (defined with ~map!~) will be
ignored without [[doom-module:][:editor evil]] present (and omitted when byte-compiling).
ignored without [[doom-module::editor evil]] present (and omitted when byte-compiling).
** Include underscores in evil word motions?
A more in-depth answer and explanation for this can be found [[https://evil.readthedocs.io/en/latest/faq.html#underscore-is-not-a-word-character][in Evil's

View file

@ -4,7 +4,7 @@
#+since: 2.0.0
* Description :unfold:
This module adds file templates for blank files, powered by [[doom-package:][yasnippet]].
This module adds file templates for blank files, powered by [[doom-package:yasnippet]].
** Maintainers
- [[doom-user:][@hlissner]]
@ -18,7 +18,7 @@ This module adds file templates for blank files, powered by [[doom-package:][yas
/This module doesn't install any packages./
** Hacks
- [[doom-package:][yasnippet]]
- [[doom-package:yasnippet]]
** TODO Changelog
# This section will be machine generated. Don't edit it by hand.
@ -60,13 +60,13 @@ A special command is available for inserting software licenses: ~M-x
New file templates can be added to
=$DOOMDIR/snippets/{major-mode}/{snippet-name}=. The yasnippet documentation
covers [[https://joaotavora.github.io/yasnippet/snippet-development.html][how to write a snippet]]. You can map a snippet to a file path, major mode,
or another arbitrary predicate using [[fn:][set-file-template!]].
or another arbitrary predicate using [[fn:set-file-template!]].
Look into its documentation with [[kbd:][<help> f set-file-template\!]].
** Adding new OSS licenses
Add snippet files to =$DOOMDIR/snippets/text-mode/= with the =__licenses-=
prefix and [[fn:][+file-templates/insert-license]] will recognize them. E.g.
prefix and [[fn:+file-templates/insert-license]] will recognize them. E.g.
=$DOOMDIR/snippets/text-mode/__license-mit=.
* Troubleshooting

View file

@ -39,7 +39,7 @@ the purpose of the module and the features/technology(ies) it provides.
Display X in a [[https://www.gnu.org/software/emacs/manual/html_node/elisp/Child-Frames.html][child frame]] rather than an overlay or tooltip. *Requires GUI
Emacs.*
- +lsp ::
Enable LSP support for ~X-mode~. Requires [[doom-module:][:tools lsp]] and a
Enable LSP support for ~X-mode~. Requires [[doom-module::tools lsp]] and a
langserver (supports A, B, and C).
# If this module has no flags, then...
@ -52,13 +52,13 @@ the purpose of the module and the features/technology(ies) it provides.
#+end_quote
** Packages
- [[doom-package:][org]]
- [[doom-package:][org-contrib]] if [[doom-module:][+contrib]]
- [[doom-package:][org-bullets]] unless [[doom-module:][+bullets]]
- if [[doom-module:][+present]]
- [[doom-package:][centered-window]]
- [[doom-package:][org-tree-slide]]
- [[doom-package:][org-re-reveal]]
- [[doom-package:org]]
- [[doom-package:org-contrib]] if [[doom-module:+contrib]]
- [[doom-package:org-bullets]] unless [[doom-module:+bullets]]
- if [[doom-module:+present]]
- [[doom-package:centered-window]]
- [[doom-package:org-tree-slide]]
- [[doom-package:org-re-reveal]]
# If this module installs no packages, then...
/This module doesn't install any packages./

View file

@ -4,7 +4,7 @@
#+since: 21.12.0
* Description :unfold:
This module marries [[doom-package:][hideshow]], [[doom-package:][vimish-fold]], and ~outline-minor-mode~ to bring you
This module marries [[doom-package:hideshow]], [[doom-package:vimish-fold]], and ~outline-minor-mode~ to bring you
marker, indent and syntax-based code folding for as many languages as possible.
** Maintainers
@ -16,10 +16,10 @@ marker, indent and syntax-based code folding for as many languages as possible.
/This module has no flags./
** Packages
- [[doom-package:][evil-vimish-fold]]
- [[doom-package:][vimish-fold]]
- if [[doom-module:][:tools tree-sitter]]
- [[doom-package:][ts-fold]]
- [[doom-package:evil-vimish-fold]]
- [[doom-package:vimish-fold]]
- if [[doom-module::tools tree-sitter]]
- [[doom-package:ts-fold]]
** TODO Hacks
#+begin_quote
@ -40,7 +40,7 @@ marker, indent and syntax-based code folding for as many languages as possible.
🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
#+end_quote
Emacs keybinds when [[doom-module:][:editor evil +everywhere]] is disabled:
Emacs keybinds when [[doom-module::editor evil +everywhere]] is disabled:
| Keybind | Description |
|--------------------+---------------------------|
| [[kbd:][C-c C-f C-f]] | Fold region |

View file

@ -27,11 +27,11 @@ rustfmt, scalafmt, script shfmt, snakefmt, sqlformat, styler, swiftformat, tidy
** Module flags
- +onsave ::
Enable reformatting of a buffer when it is saved. See
[[var:][+format-on-save-enabled-modes]] to control what major modes to (or not to)
[[var:+format-on-save-enabled-modes]] to control what major modes to (or not to)
format on save.
** Packages
- [[doom-package:][format-all]]
- [[doom-package:format-all]]
** Hacks
- format-all has been heavily modified to suit Doom's goals for this module:
@ -39,7 +39,7 @@ rustfmt, scalafmt, script shfmt, snakefmt, sqlformat, styler, swiftformat, tidy
affect on cursor position.
- Adds partial formatting, i.e. you can now reformat a subset of the buffer.
- Adds the ability to use any arbitrary formatter on the current buffer if you
pass the universal argument to [[fn:][+format/buffer]] or [[fn:][+format/region]] (i.e.
pass the universal argument to [[fn:+format/buffer]] or [[fn:+format/region]] (i.e.
removes the major-mode lock on formatters).
** TODO Changelog
@ -51,7 +51,7 @@ rustfmt, scalafmt, script shfmt, snakefmt, sqlformat, styler, swiftformat, tidy
This module has no direct requirements, but each language will need one of their
supported formatter programs in order for this to work. In their absence,
[[doom-package:][format-all]] will fail silently.
[[doom-package:format-all]] will fail silently.
Supported formatters:
- Angular/Vue (prettier)
@ -137,7 +137,7 @@ default value:
If you want to format code when you save a buffer, but want more granular
control over which major modes this behavior is enabled in, there is an
alternative. Make sure [[doom-module:][+onsave]] is disabled before you try this:
alternative. Make sure [[doom-module:+onsave]] is disabled before you try this:
#+begin_src emacs-lisp
(add-hook 'python-mode-hook #'format-all-mode)
(add-hook 'js2-mode-hook #'format-all-mode)
@ -145,7 +145,7 @@ alternative. Make sure [[doom-module:][+onsave]] is disabled before you try this
** Disabling the LSP formatter
If you are in a buffer with ~lsp-mode~ enabled and a server that supports
=textDocument/formatting=, it will be used instead of [[doom-package:][format-all]]'s formatter.
=textDocument/formatting=, it will be used instead of [[doom-package:format-all]]'s formatter.
+ To disable this behavior universally use: ~(setq +format-with-lsp nil)~
+ To disable this behavior in one mode: ~(setq-hook! 'python-mode-hook

View file

@ -8,7 +8,7 @@
#+end_quote
* Description :unfold:
Adds [[doom-package:][god-mode]] support to Doom Emacs, allowing for entering commands without
Adds [[doom-package:god-mode]] support to Doom Emacs, allowing for entering commands without
modifier keys, similar to Vim's modality, separating command mode and insert
mode.
@ -19,7 +19,7 @@ mode.
/This module has no flags./
** Packages
- [[doom-package:][god-mode]]
- [[doom-package:god-mode]]
** Hacks
/No hacks documented for this module./

View file

@ -24,8 +24,8 @@ languages:
/This module has no flags./
** Packages
- [[doom-package:][lispy]]
- [[doom-package:][lispyville]] if [[doom-module:][:editor evil +everywhere]]
- [[doom-package:lispy]]
- [[doom-package:lispyville]] if [[doom-module::editor evil +everywhere]]
** Hacks
/No hacks documented for this module./
@ -44,8 +44,8 @@ languages:
🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
#+end_quote
If [[doom-module:][:editor evil]] is enabled, [[doom-package:][lispyville]] would also be activated for every mode
where [[doom-package:][lispy]] is active.
If [[doom-module::editor evil]] is enabled, [[doom-package:lispyville]] would also be activated for every mode
where [[doom-package:lispy]] is active.
* TODO Configuration
#+begin_quote

View file

@ -16,17 +16,17 @@ evil) that loosely take after multi-cursors in Atom or Sublime Text.
/This module has no flags./
** Packages
- if [[doom-module:][:editor evil]]
- [[doom-package:][evil-multiedit]]
- [[doom-package:][evil-mc]]
- if [[doom-module::editor evil]]
- [[doom-package:evil-multiedit]]
- [[doom-package:evil-mc]]
- else
- [[doom-package:][multiple-cursors]]
- [[doom-package:multiple-cursors]]
** Hacks
- Attempts to smooth over [[doom-package:][multiple-cursors]]' incompatibilities with [[doom-package:][evil]], which
- Attempts to smooth over [[doom-package:multiple-cursors]]' incompatibilities with [[doom-package:evil]], which
is used internally in some third party plugins.
- Attempts to smooth over [[doom-package:][evil-mc]]'s incompatibilities with other packages, like
[[doom-package:][lispy]].
- Attempts to smooth over [[doom-package:evil-mc]]'s incompatibilities with other packages, like
[[doom-package:lispy]].
** TODO Changelog
# This section will be machine generated. Don't edit it by hand.
@ -43,7 +43,7 @@ evil) that loosely take after multi-cursors in Atom or Sublime Text.
#+end_quote
** evil-mc
- The [[doom-package:][evil-mc]] keys are under the [[kbd:][gz]] prefix, e.g.
- The [[doom-package:evil-mc]] keys are under the [[kbd:][gz]] prefix, e.g.
- [[kbd:][gzz]] to toggle new (frozen) cursors at point.
- [[kbd:][gzt]] to toggle mirroring on and off (or switch to insert mode to activate
them).

View file

@ -4,7 +4,7 @@
#+since: 21.12.0
* Description :unfold:
This modules adds [[doom-package:][objed]], a global minor-mode for navigating and manipulating
This modules adds [[doom-package:objed]], a global minor-mode for navigating and manipulating
text objects. It combines the ideas of ~versor-mode~ and other editors like Vim
or Kakoune and tries to align them with regular Emacs conventions.
@ -15,11 +15,11 @@ or Kakoune and tries to align them with regular Emacs conventions.
** Module flags
- +manual ::
Don't activate [[doom-package:][objed]] at startup, automatically, leaving it to the user to call
[[fn:][objed-activate]] (bound to [[kbd:][M-SPC]] if using [[doom-module:][:config default +bindings]]).
Don't activate [[doom-package:objed]] at startup, automatically, leaving it to the user to call
[[fn:objed-activate]] (bound to [[kbd:][M-SPC]] if using [[doom-module::config default +bindings]]).
** Packages
- [[doom-package:][objed]]
- [[doom-package:objed]]
** Hacks
/No hacks documented for this module./
@ -34,7 +34,7 @@ or Kakoune and tries to align them with regular Emacs conventions.
/This module has no external requirements./
#+begin_quote
🚧 This module is incompatible with [[doom-module:][:editor evil]]. Do not enable them both at
🚧 This module is incompatible with [[doom-module::editor evil]]. Do not enable them both at
the same time or you will get errors.
#+end_quote

View file

@ -15,7 +15,7 @@ balanced and beautiful.
/This module has no flags./
** Packages
- [[doom-package:][parinfer-rust-mode]]
- [[doom-package:parinfer-rust-mode]]
** Hacks
/No hacks documented for this module./

View file

@ -17,7 +17,7 @@ keywords or text patterns at point, like ~true~ and ~false~, or ~public~,
/This module has no flags./
** Packages
- [[doom-package:][rotate-text]]
- [[doom-package:rotate-text]]
** Hacks
/No hacks documented for this module./

View file

@ -4,7 +4,7 @@
#+since: 2.0.0
* Description :unfold:
This module adds snippet expansions to Emacs, powered by [[doom-package:][yasnippet]].
This module adds snippet expansions to Emacs, powered by [[doom-package:yasnippet]].
** Maintainers
- [[doom-user:][@hlissner]]
@ -15,9 +15,9 @@ This module adds snippet expansions to Emacs, powered by [[doom-package:][yasnip
/This module exposes no flags./
** Packages
- [[doom-package:][yasnippet]]
- [[doom-package:][auto-yasnippet]]
- [[doom-package:][doom-snippets]]
- [[doom-package:yasnippet]]
- [[doom-package:auto-yasnippet]]
- [[doom-package:doom-snippets]]
** TODO Hacks
#+begin_quote

View file

@ -4,7 +4,7 @@
#+since: 21.12.0 (#1709)
* Description :unfold:
This module adds a minor-mode [[fn:][+word-wrap-mode]], which intelligently wraps long
This module adds a minor-mode [[fn:+word-wrap-mode]], which intelligently wraps long
lines in the buffer without modifying the buffer content.
** Maintainers
@ -16,7 +16,7 @@ lines in the buffer without modifying the buffer content.
/This module has no flags./
** Packages
- [[doom-package:][adaptive-wrap]]
- [[doom-package:adaptive-wrap]]
** Hacks
/No hacks documented for this module./