You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Note: You will need NodeJS to install the extension for JupterLab 2.x.
74
+
75
+
## Contributing
76
+
77
+
### Development install
78
+
79
+
Note: You will need NodeJS to build the extension package.
68
80
69
81
The `jlpm` command is JupyterLab's pinned version of
70
82
[yarn](https://yarnpkg.com/) that is installed with JupyterLab. You may use
71
83
`yarn` or `npm` in lieu of `jlpm` below.
72
84
73
85
```bash
74
86
# Clone the repo to your local environment
75
-
# Move to jupyterlab-interactive-dashboard-editor directory
76
-
77
-
# Install dependencies
78
-
jlpm
79
-
# Build Typescript source
80
-
jlpm build
87
+
# Change directory to the {{ cookiecutter.python_name }} directory
88
+
# Install package in development mode
89
+
pip install -e .
81
90
# Link your development version of the extension with JupyterLab
82
-
jupyter labextension install .
83
-
# Rebuild Typescript source after making changes
84
-
jlpm build
85
-
# Rebuild JupyterLab after making any changes
86
-
jupyter lab build
91
+
jupyter labextension develop . --overwrite
92
+
# Rebuild extension Typescript source after making changes
93
+
jlpm run build
87
94
```
88
95
89
-
You can watch the source directory and run JupyterLab in watch mode to watch for changes in the extension's source and automatically rebuild the extension and application.
96
+
You can watch the source directory and run JupyterLab at the same time in different terminals to watch for changes in the extension's source and automatically rebuild the extension.
90
97
91
98
```bash
92
-
# Watch the source directory in another terminal tab
93
-
jlpm watch
94
-
# Run jupyterlab in watch mode in one terminal tab
95
-
jupyter lab --watch
99
+
# Watch the source directory in one terminal, automatically rebuilding when needed
100
+
jlpm run watch
101
+
# Run JupyterLab in another terminal
102
+
jupyter lab
96
103
```
97
104
98
-
Now every change will be built locally and bundled into JupyterLab. Be sure to refresh your browser page after saving file changes to reload the extension (note: you'll need to wait for webpack to finish, which can take 10s+ at times).
105
+
With the watch command running, every saved change will immediately be built locally and available in your running JupyterLab. Refresh JupyterLab to load the change in your browser (you may need to wait several seconds for the extension to be rebuilt).
106
+
107
+
By default, the `jlpm run build` command generates the source maps for this extension to make it easier to debug using the browser dev tools. To also generate source maps for the JupyterLab core extensions, you can run the following command:
0 commit comments