Skip to content

Commit 8be1a77

Browse files
rokbotgithub-actions[bot]
authored andcommitted
chore(docs): Auto generate docs
1 parent 26b0f70 commit 8be1a77

File tree

1 file changed

+61
-41
lines changed

1 file changed

+61
-41
lines changed

doc/code_runner.txt

Lines changed: 61 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -3,22 +3,30 @@
33
==============================================================================
44
Table of Contents *code_runner-table-of-contents*
55

6-
- Introduction |code_runner-introduction|
7-
- Requirements |code_runner-requirements|
8-
- Install |code_runner-install|
9-
- Features |code_runner-features|
10-
- Setup |code_runner-setup|
11-
- Commands |code_runner-commands|
12-
- Parameters |code_runner-parameters|
13-
- Hooks |code_runner-hooks|
14-
- Integration with other plugins|code_runner-integration-with-other-plugins|
15-
- Inspirations and thanks |code_runner-inspirations-and-thanks|
16-
- Screenshots |code_runner-screenshots|
17-
- Contributing |code_runner-contributing|
18-
1. LICENCE |code_runner-licence|
19-
2. Links |code_runner-links|
20-
Code_Runner  Code Runner for Neovim written in pure lua 󰢱
21-
INTRODUCTION *code_runner-introduction*
6+
1. code_runner.nvim |code_runner-code_runner.nvim|
7+
- Introduction |code_runner-code_runner.nvim-introduction|
8+
- Requirements |code_runner-code_runner.nvim-requirements|
9+
- Install |code_runner-code_runner.nvim-install|
10+
- Features |code_runner-code_runner.nvim-features|
11+
- Setup |code_runner-code_runner.nvim-setup|
12+
- Commands |code_runner-code_runner.nvim-commands|
13+
- Parameters |code_runner-code_runner.nvim-parameters|
14+
- Hooks |code_runner-code_runner.nvim-hooks|
15+
- Integration with other plugins|code_runner-code_runner.nvim-integration-with-other-plugins|
16+
- Inspirations and thanks|code_runner-code_runner.nvim-inspirations-and-thanks|
17+
- Screenshots |code_runner-code_runner.nvim-screenshots|
18+
- Contributing |code_runner-code_runner.nvim-contributing|
19+
- Similar Projects |code_runner-code_runner.nvim-similar-projects|
20+
2. LICENCE |code_runner-licence|
21+
3. Links |code_runner-links|
22+
23+
==============================================================================
24+
1. code_runner.nvim *code_runner-code_runner.nvim*
25+
26+
🏃‍♂️ Code Runner for Neovim written in pure lua 🌙
27+
28+
29+
INTRODUCTION *code_runner-code_runner.nvim-introduction*
2230

2331
When I was still in college it was common to try multiple programming
2432
languages, at that time I used vscode that with a single plugin allowed me to
@@ -33,18 +41,18 @@ Currently I don’t test many languages anymore and work in the professional
3341
environment, but this plugin is still my swiss army knife.
3442

3543

36-
REQUIREMENTS *code_runner-requirements*
44+
REQUIREMENTS *code_runner-code_runner.nvim-requirements*
3745

3846
- Neovim (>= 0.10)
3947

4048

41-
INSTALL *code_runner-install*
49+
INSTALL *code_runner-code_runner.nvim-install*
4250

4351
- With lazy.nvim <https://github.com/folke/lazy.nvim>
4452

4553
>lua
4654
require("lazy").setup({
47-
{ "CRAG666/code_runner.nvim",
55+
{ "CRAG666/code_runner.nvim",
4856
event= "VeryLazy",
4957
},
5058
}
@@ -66,7 +74,7 @@ Please see my config code_runner.lua
6674
<https://github.com/CRAG666/dotfiles/blob/main/config/nvim/lua/plugins/dev/code_runner.lua>
6775

6876

69-
FEATURES *code_runner-features*
77+
FEATURES *code_runner-code_runner.nvim-features*
7078

7179

7280
**Note** If you want implement a new feature open an issue to know if it is
@@ -83,11 +91,11 @@ FEATURES *code_runner-features*
8391
- Run project commands in different modes for a per projects base
8492

8593

86-
SETUP *code_runner-setup*
94+
SETUP *code_runner-code_runner.nvim-setup*
8795

8896
This plugin can be configured either in lua, with the `setup` function, or with
89-
json files for interopability between this plugin and the original code runner
90-
<https://github.com/formulahendry/vscode-code-runner> vscode plugin.
97+
json files for interoperability between this plugin and the original code
98+
runner <https://github.com/formulahendry/vscode-code-runner> vscode plugin.
9199

92100

93101
MINIMAL EXAMPLE ~
@@ -150,7 +158,7 @@ JSON
150158
<
151159

152160

153-
COMMANDS *code_runner-commands*
161+
COMMANDS *code_runner-code_runner.nvim-commands*
154162

155163

156164
**Note** To check what modes ore supported see |code_runner-mode-parameter|.
@@ -177,7 +185,7 @@ Recommended mappings:
177185
<
178186

179187

180-
PARAMETERS *code_runner-parameters*
188+
PARAMETERS *code_runner-code_runner.nvim-parameters*
181189

182190

183191
SETUP GLOBAL ~
@@ -188,10 +196,14 @@ see the default values see: `code_runner.nvim/lua/code_runner/options`
188196

189197
Parameters:
190198

191-
- `mode`: Display Mode in which you want to run. Supported: "term", "float", "tab","better_term", "toggleterm" (type: `string`, default: "term")
192-
- `focus`: Focus on runner window. Only works on "term" and "tab" display modes (type: `bool`, default: false)
193-
- `startinsert`: init in insert mode. Only works on "term" and "tab" display modes (type: `bool`, default: false)
194-
- `hot_reload`: Run automatically on buffer save, only works in "term" or similar (type: `bool`, default: true)
199+
- `mode`: Display Mode in which you want to run. Supported: "term", "float",
200+
"tab","better_term", "toggleterm" (type: `string`, default: "term")
201+
- `focus`: Focus on runner window. Only works on "term" and "tab" display modes
202+
(type: `bool`, default: false)
203+
- `startinsert`: init in insert mode. Only works on "term" and "tab" display
204+
modes (type: `bool`, default: false)
205+
- `hot_reload`: Run automatically on buffer save, only works in "term" or similar
206+
(type: `bool`, default: true)
195207
- `term`: Configurations for the integrated terminal (type: `table`)
196208
- `position`: terminal position consult |windows| for options (type: `string`)
197209
- `size`: Size of the terminal window (type: `uint` | `float`)
@@ -208,15 +220,18 @@ Parameters:
208220
- `x`: (type: `float`)
209221
- `y`: (type: `float`)
210222
- `border_hl`: (type: `string`)
211-
- `better_term`: Toggle mode replacement(Install CRAG666/betterTerm.nvim <https://github.com/CRAG666/betterTerm.nvim>)
223+
- `better_term`: Toggle mode replacement(Install CRAG666/betterTerm.nvim
224+
<https://github.com/CRAG666/betterTerm.nvim>)
212225
- `clean`: Clean terminal before launch(type: `bool`)
213226
- `number`: Use nil for dynamic number and set init(type: `uint?`)
214227
- `init`: Set a start number for executions, each execution will go to a different terminal(type: `uint?`)
215228
},
216229
- `before_run_filetype`: Execute before executing a file (type: `func`)
217-
- `filetype`: If you prefer to use lua instead of json files, you can add your settings by file type here (type: `table`)
230+
- `filetype`: If you prefer to use lua instead of json files, you can add your
231+
settings by file type here (type: `table`)
218232
- `filetype_path`: Absolute path to json file config (type: `absolute paths`)
219-
- `project`: If you prefer to use lua instead of json files, you can add your settings by project here (type: `table`)
233+
- `project`: If you prefer to use lua instead of json files, you can add your
234+
settings by project here (type: `table`)
220235
- `project_path`: Absolute path to json file config (type: `absolute paths`)
221236

222237

@@ -248,7 +263,7 @@ The filetype table can take either a `string`, a `table` or a `function`.
248263
<
249264

250265
If you want to add some other language or some other command follow this
251-
structure `key = commans`.
266+
structure `key = commands`.
252267

253268

254269
JSON
@@ -379,7 +394,7 @@ PARAMETERS
379394
**Note** Don’t forget to name your projects because if you don’t do so code
380395
runner will fail as it uses the name for the buffer name
381396

382-
HOOKS *code_runner-hooks*
397+
HOOKS *code_runner-code_runner.nvim-hooks*
383398

384399
These elements are intended to help with those commands that require more
385400
complexity. For example, implement hot reload on markup documents.
@@ -540,7 +555,7 @@ a new vertical windows and reload on save. Read the comments for more info.
540555
<
541556

542557

543-
INTEGRATION WITH OTHER PLUGINS *code_runner-integration-with-other-plugins*
558+
INTEGRATION WITH OTHER PLUGINS*code_runner-code_runner.nvim-integration-with-other-plugins*
544559

545560

546561
API ~
@@ -567,7 +582,7 @@ how to use harpoon term together with code_runner.nvim:
567582
<
568583

569584

570-
INSPIRATIONS AND THANKS *code_runner-inspirations-and-thanks*
585+
INSPIRATIONS AND THANKS *code_runner-code_runner.nvim-inspirations-and-thanks*
571586

572587
- The idea of this project comes from the vscode plugin code_runner <https://marketplace.visualstudio.com/items?itemName=formulahendry.code-runner> You can even copy your configuration and pass it to this plugin, as they are the same in the way of defining commands associated with filetypes <https://github.com/CRAG666/code_runner.nvim#add-support-for-more-file-types>
573588
- jaq-nvim <https://github.com/is0n/jaq-nvim> some ideas of how to execute commands were taken from this plugin, thank you very much.
@@ -578,10 +593,10 @@ INSPIRATIONS AND THANKS *code_runner-inspirations-and-thanks*
578593
- Thanks to all current and future collaborators, without their contributions this plugin would not be what it is today
579594

580595

581-
SCREENSHOTS *code_runner-screenshots*
596+
SCREENSHOTS *code_runner-code_runner.nvim-screenshots*
582597

583598

584-
CONTRIBUTING *code_runner-contributing*
599+
CONTRIBUTING *code_runner-code_runner.nvim-contributing*
585600

586601

587602
**Note** If you have any ideas to improve this project, do not hesitate to make
@@ -592,14 +607,19 @@ contribute, criticize (don’t be soft) or contribute ideas. All PRs are
592607
welcome.
593608

594609

610+
SIMILAR PROJECTS *code_runner-code_runner.nvim-similar-projects*
611+
612+
- SnipRun <https://github.com/michaelb/sniprun>
613+
- iron.nvim <https://github.com/Vigemus/iron.nvim>
614+
615+
595616
==============================================================================
596-
1. LICENCE *code_runner-licence*
617+
2. LICENCE *code_runner-licence*
597618

598-
------------------------------------------------------------------------------
599619
MIT <https://github.com/CRAG666/code_runner.nvim/blob/main/LICENSE>
600620

601621
==============================================================================
602-
2. Links *code_runner-links*
622+
3. Links *code_runner-links*
603623

604624
1. *preview*: https://github.com/CRAG666/dotfiles/blob/main/config/nvim/lua/plugins/dev/code_runner.lua
605625
2. *@adalessa*:

0 commit comments

Comments
 (0)