Página inicial Explorar Ajuda
Registrar Entrar
ylproj
/
jupyterlab
2
0
Fork 0
Arquivos Issues 0 Pull Requests 0 Wiki
Tree: 571f294560
Branches Tags
jupyterlab
/
docs
/
source
/
getting_started
/
issue.rst

issue.rst 4.0 KB
Histórico Raw

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970 
  1. .. _issue:
    2. 

  2. 

  3. Reporting an issue
    4. 

  4. ==================
    5. 

  5. 

  6. Thank you for providing feedback about JupyterLab.
    7. 

  7. 

  8. Diagnosing an Issue
    9. 

  9. -------------------
    10. 

  10. 

  11. If you find a problem in JupyterLab, please follow the steps below to diagnose and report the issue. Following these steps helps you diagnose if the problem is likely from JupyterLab or from a different project.
    12. 

  12. 

  13. 1. Try to reproduce the issue in a new environment with the latest official JupyterLab installed and no extra packages.
    14. 

  14. 

  15.    If you are using conda:
    16. 

  16. 

  17.      1. create a new environment::
    18. 

  18. 

  19.          conda create -n jlab-test --override-channels --strict-channel-priority -c conda-forge -c nodefaults jupyterlab
    20. 

  20. 

  21.      2. Activate the environment::
    22. 

  22. 

  23.          conda activate jlab-test
    24. 

  24. 

  25.      3. Start JupyterLab::
    26. 

  26. 

  27.          jupyter lab
    28. 

  28. 

  29.    - I cannot reproduce this issue in a clean environment: The problem is probably not in JupyterLab itself. Go to step 2.
    30. 

  30.    - I can reproduce this issue in a clean environment: Go to step 3.
    31. 

  31. 2. Perhaps the issue is in one of the JupyterLab extensions you had installed. Install any JupyterLab extensions you had one at a time, checking for the issue after each one.
    32. 

  32. 

  33.    - I can reproduce the issue after installing a particular extension: That extension may be causing the problem. File an issue with that extension's issue tracker. Be sure to mention what you have done here to narrow the problem down.
    34. 

  34.    - I cannot reproduce the issue after installing all my extensions: Good news! Likely all you have to do is update your JupyterLab and extensions. If that fixes the issue, great! If it doesn't fix the issue, you may have a more complicated issue. Go directly to :ref:`create-issue`.
    35. 

  35. 3. Try to reproduce the issue in the classic Jupyter Notebook. Launch the classic notebook from the JupyterLab help menu to ensure you are getting exactly the same notebook server that JupyterLab is using.
    36. 

  36. 

  37.    - I can reproduce the issue with the classic Jupyter Notebook: The problem is probably not from JupyterLab. It may be in the `Jupyter Notebook server <https://github.com/jupyter/notebook>`__, your kernel, etc. Use your best judgement to file an issue with the appropriate project.
    38. 

  38.    - I cannot reproduce the issue in classic Jupyter Notebook: Go to step 4.
    39. 

  39. 4. Try to reproduce the issue in your browser incognito or private browsing mode. Running in private browser mode ensures your browser state is clean.
    40. 

  40. 

  41.    - I cannot reproduce the issue in private browsing mode: Perhaps resetting your cookies or other browser state would help.
    42. 

  42.    - I can reproduce the issue in private browsing mode: Go to :ref:`create-issue`.
    43. 

  43. 

  44. You might also check your system for:
    45. 

  45. 

  46. - Security software that might be preventing access to files or network interfaces
    47. 

  47. - Network equipment, routers, or proxies that might be preventing communication between the browser and the server
    48. 

  48. - Browser extensions that might be changing the JupyterLab code or application page
    49. 

  49. 

  50. .. _create-issue:
    51. 

  51. 

  52. Creating an issue
    53. 

  53. -----------------
    54. 

  54. 

  55. Before creating an issue, search in the issue tracker for relevant issues. If you find an issue describing your problem, comment there with the following information instead of creating a new issue. If you find a relevant resolved issue (closed and locked for discussion), create a new issue and reference the resolved issue.
    56. 

  56. 

  57. To create an issue, collect the following contextual information:
    58. 

  58. 

  59. - relevant package versions, including:
    60. 

  60. 

  61.   - ``jupyterlab`` and ``notebook`` versions
    62. 

  62.   - browser versions affected (please try to reproduce in Chrome and Firefox at least)
    63. 

  63.   - operating system and version
    64. 

  64. 

  65. - relevant server and JavaScript error messages
    66. 

  66. - screenshots or short screencasts illustrating the issue
    67. 

  67. 

  68. `Create a new issue <https://github.com/jupyterlab/jupyterlab/issues/new>`__. Include the contextual information from above. Describe how you followed the diagnosis steps above to conclude this was a JupyterLab issue.
    69. 

  69. 

  70. Communication in JupyterLab follows the Jupyter `Community Guides <https://jupyter.readthedocs.io/en/latest/community/content-community.html>`__.
    71.