@@ -164,25 +164,28 @@ Use of a python `virtualenv` or a conda env is also recommended.
164
164
or permanently by setting ` c.Completer.use_jedi = False ` in your
165
165
[ ` ipython_config.py ` file] ( https://ipython.readthedocs.io/en/stable/config/intro.html?highlight=ipython_config.py#systemwide-configuration ) .
166
166
167
- 1 . (Linux/OSX-only) As a security measure Jupyter limits file access to the Jupyter root
168
- directory (the place where you launch the Jupyter server). Thus, in order to
169
- allow ` jupyterlab-lsp ` to navigate to external files such as packages
167
+ 1 . (Optional, Linux/OSX-only) As a security measure by default Jupyter serve only allows
168
+ access to files under the Jupyter root directory (the place where you launch the Jupyter server).
169
+ Thus, in order to allow ` jupyterlab-lsp ` to navigate to external files such as packages
170
170
installed system-wide or to libraries inside a virtual environment (` conda ` ,
171
- ` pip ` , ...) this access control mechanism needs to be circumvented: Inside your Jupyter
172
- root directory create a symlink named * .lsp_symlink * pointing to your system root * / * .
171
+ ` pip ` , ...) this access control mechanism needs to be circumvented: inside your Jupyter
172
+ root directory create a symlink named _ .lsp_symlink _ pointing to your system root ` / ` .
173
173
174
174
```
175
175
ln -s / .lsp_symlink
176
176
```
177
177
178
178
As this symlink is a hidden file the Jupyter server must be instructed to
179
- serve hidden files. Either use the appropriate commandline flag:
179
+ serve hidden files. Either use the appropriate command line flag:
180
180
181
181
```
182
182
jupyter lab --ContentsManager.allow_hidden=True
183
183
```
184
184
185
- or, alternatively, set the corresponding setting inside your * jupyter_server_config.py* .
185
+ or, alternatively, set the corresponding setting inside your ` jupyter_server_config.py ` .
186
+
187
+ Help in implementing a custom [ ` ContentsManager ` ] ( https://github.com/jupyter-lsp/jupyterlab-lsp/issues/850 )
188
+ which will enable navigating to external files without the symlink is welcome.
186
189
187
190
### Configuring the servers
188
191
0 commit comments