Skip to content

Commit 1cc258b

Browse files
Merge pull request #61 from DudeBro249/documentation
Change documentation to reflect new cli syntax
2 parents 708120a + 88ca8f3 commit 1cc258b

File tree

10 files changed

+51
-195
lines changed

10 files changed

+51
-195
lines changed

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
Apache License
1+
Apache License
22
Version 2.0, January 2004
33
http://www.apache.org/licenses/
44

website/docs/general-commands/init.md renamed to website/docs/commands/init.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
## Usage
22
```
3-
docrunner init [OPTIONS]
3+
docrunner run [arguments]
44
```
55

66
```
77
$ docrunner init --help
8-
Usage: docrunner init [OPTIONS]
8+
Create a `docrunner.toml` configuration file in the root directory
99
10-
Creates a `docrunner.toml` configuration file in the root directory
10+
Usage: docrunner init [arguments]
11+
-h, --help Print this usage information.
1112
12-
Options:
13-
--help Show this message and exit.
13+
Run "docrunner help" to see global options.
1414
```
1515

1616
## What it does
17-
Creates a `docrunner.toml` configuration file with some default options:
17+
Creates a `docrunner.toml` configuration file with some default options in the root directory:
1818

1919
```toml
2020
[docrunner]

website/docs/commands/run.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
## Usage
2+
```cmd
3+
docrunner run [arguments]
4+
```
5+
6+
```
7+
$ docrunner run --help
8+
Runs all code belonging to a specific language within a markdown '.md' file
9+
10+
Usage: docrunner run [arguments]
11+
-h, --help Print this usage information.
12+
-l, --language The language that will be located and run within your '.md' files
13+
-m, --markdown-path The path to the markdown file you would like to run code from
14+
-d, --directory-path The path to the directory where your code should be stored and run
15+
You can install dependencies, for example, in this directory
16+
-s, --startup-command The command you would like to run in order to run
17+
your code. Put the command in between quotes "node index.js"
18+
-f, --[no-]multi-file Whether each snippet (denoted by ```) should be placed and run in a
19+
different file
20+
21+
Run "docrunner help" to see global options.
22+
```
23+
24+
## What it Does
25+
Runs your documentation using both configuration found in your `docrunner.toml`
26+
file and cli arguments shown here
27+
28+
You can learn more about docrunner configuration [here](/docs/configuration)
29+
30+
## Supported Languages
31+
32+
- Python - `docrunner run --language python`
33+
- Javascript - `docrunner run --language javascript`
34+
- Typescript - `docrunner run --language typescript`
35+
- Dart - `docrunner run --language dart`

website/docs/general-commands/run.md

Lines changed: 0 additions & 19 deletions
This file was deleted.

website/docs/getting-started.md

Lines changed: 7 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,25 @@
11
# Getting started
22

3-
## Installation
4-
_Prerequisite: [Install Python 3.6.1+](https://www.python.org/) on your local environment._
3+
<!-- ## Installation
54
65
Use the package manager [pip](https://pip.pypa.io/en/stable/) to install docrunner.
76
87
```cmd
98
pip install docrunner
10-
```
9+
``` -->
1110

1211
## QuickStart
1312

14-
```powershell
13+
```shell
1514
docrunner --help
1615
```
1716

18-
## Language Specific Help
19-
For help on a specific language, run:
20-
```powershell
21-
docrunner <language> --help
22-
```
23-
2417
## Python Example
2518

2619
```powershell
27-
docrunner python --markdown-path README.md --multi-file
20+
docrunner run --language python --markdown-path README.md --multi-file
2821
```
2922

30-
- This command executes all python within `README.md` and does so by putting each snippet of python into a separate file, and running each file. If you don't want each snippet in a separate python file, just remove the --multi-file option.
23+
- This command executes all python within `README.md` and does so by putting each snippet of python into a
24+
separate file, and running each file. If you don't want each snippet in a separate python file, just
25+
remove the --multi-file option.

website/docs/language/dart.md

Lines changed: 0 additions & 35 deletions
This file was deleted.

website/docs/language/javascript.md

Lines changed: 0 additions & 35 deletions
This file was deleted.

website/docs/language/python.md

Lines changed: 0 additions & 35 deletions
This file was deleted.

website/docs/language/typescript.md

Lines changed: 0 additions & 35 deletions
This file was deleted.

website/sidebars.js

Lines changed: 2 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -19,23 +19,8 @@ module.exports = {
1919
'getting-started',
2020
{
2121
type: 'category',
22-
label: 'General Commands',
23-
items: [
24-
{
25-
type: 'autogenerated',
26-
dirName: 'general-commands',
27-
},
28-
],
29-
},
30-
{
31-
type: 'category',
32-
label: 'Language Specific Commands',
33-
items: [
34-
{
35-
type: 'autogenerated',
36-
dirName: 'language',
37-
},
38-
],
22+
label: 'Commands',
23+
items: ['commands/run', 'commands/init'],
3924
},
4025
'comments',
4126
'configuration',

0 commit comments

Comments
 (0)