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
Pluto is designed to be accessible to all users. We follow web accessibility standards and continuously work to improve the experience for everyone. If you find any accessibility issues, please get in touch!
11
+
12
+
Here is an overview of the accessibility features of Pluto:
13
+
14
+
## Keyboard Navigation and Shortcuts
15
+
**Pluto is fully usable without a mouse.** You can navigate and control everything using only your keyboard:
16
+
17
+
- Keyboard shortcuts: Execute cells, navigate between cells, and access common functions quickly. You can find a list of all our shortcuts [here](https://plutojl.org/en/docs/keyboard-shortcuts/)
18
+
- Tab navigation: Move through all interactive elements on the page using the Tab key
19
+
- Code editor navigation: Special tab handling inside code cells lets you indent code with Tab while still being able to navigate out of the editor with keyboard-only controls. This video shows an example:
You can find a fuller overview of the keyboard shortcuts and between-cell navigation [here](https://plutojl.org/en/docs/keyboard-shortcuts/)
24
+
25
+
Pluto also supports touch-only use with your device's on-screen keyboard (OSK): the virtual keyboard that appears on your screen when you tap a text field on tablets, touchscreen laptops, or any device without a physical keyboard.
26
+
27
+
This makes Pluto accessible for users who rely on keyboard-only navigation, whether due to motor disabilities, personal preference, or assistive technology requirements.
28
+
29
+
## Visual Accessibility
30
+
### High Contrast Text
31
+
We design almost everything with enough visual contrast in light and dark mode. This way:
32
+
33
+
- All text meets WCAG 2.0 Level AA contrast standards (minimum ratio of 4.5:1)
34
+
- Ensures readability for users with low vision or color blindness
35
+
36
+
### Dark Mode Support
37
+
38
+
- Pluto automatically follows your operating system or browser's light/dark mode preference
39
+
- No manual switching needed, it adapts to your system settings
40
+
41
+
### Font Size and Zoom
42
+
43
+
- Use your browser's zoom function (`Ctrl/Cmd + ±`) to adjust the size of Pluto's interface
44
+
- Your zoom preference automatically saves between sessions
45
+
- Text and UI elements scale proportionally for consistent readability
46
+
47
+
### Reduced Motion
48
+
49
+
- Pluto respects the `prefers-reduced-motion` CSS setting. If you've enabled "Reduce motion" or "Prefers reduced motion" in your browser or OS accessibility settings, Pluto will minimize animations
50
+
- Helps users with vestibular disorders or motion sensitivity
51
+
52
+
## Screen Reader Support
53
+
Pluto uses semantic HTML and ARIA (Accessible Rich Internet Applications) labels to work with popular screen readers including JAWS, NVDA, VoiceOver, TalkBack, and Narrator. We follow WAI-ARIA best practices to ensure interactive elements are properly announced and navigable.
54
+
**Current screen reader experience:**
55
+
56
+
- HTML exports are very screen reader friendly
57
+
- Live notebook editing has basic screen reader support, but we're actively working to improve this experience
58
+
59
+
**We need your feedback!** If you use a screen reader with Pluto, please share your experience - what works well and what could be better. Your input is essential for helping us prioritize improvements. See [this issue](https://github.com/fonsp/Pluto.jl/issues/2768) to join the conversation or use our feedback tool to report accessibility barriers.
60
+
61
+
## Language Support
62
+
Pluto is available in multiple languages, making it accessible to non-English speakers. You can:
63
+
64
+
- Switch languages at the bottom of each notebook
65
+
- Contribute translations to help make Pluto available in your language
66
+
67
+
You can read more on about it in [this section](https://plutojl.org/en/docs/language/).
68
+
69
+
**Found an accessibility issue?** Let us know through our feedback tool or community channels!
description: "How to open and move files from your computer or from the web"
4
+
tags: ["docs", "file", "navigation"]
5
+
layout: "md.jlmd"
6
+
order: 3
7
+
---
8
+
{#files}
9
+
# Pluto notebook files
10
+
Pluto notebooks are stored as `.jl` files on your computer, and Pluto needs to know the exact location of each file to open, save, and manage it.
11
+
12
+
When you create a new notebook, the notebook is stored temporarily in the `~/.julia/pluto_notebooks/` folder with a random name (something like `Wild experiment 4.jl`). This is a hidden folder, and we recommend saving your notebooks somewhere else (like your Documents folder) if you want to keep your work.
13
+
14
+
!!! info "The .jl extension"
15
+
The `.jl` extension is used because Pluto notebooks are valid Julia files – you can run them as Julia scripts, or use the `include` function in the REPL to start a REPL session with the notebook.
16
+
17
+
You are free to use a different extension (like `.plutojl`), the extension is not required to open the file.
18
+
19
+
{#open}
20
+
# How to open a notebook from your computer
21
+
First, go to the [Pluto main menu](../launch-pluto/#main-menu). Now you can type a notebook path in the textbox, and press Enter or click the "Open" button. You would need to enter the _full path_ of the notebook into the blue bow. While you type, there will be autocompletion suggestions with folders and files.
22
+
23
+
<img src="$(root_url)/assets/img/main menu open autocomplete.png" alt="screenshot of the Open button in the Pluto main menu, with a textbox for the notebook path and autocompletion suggestions" width="1774" height="558">
24
+
25
+
!!! info "Finding file paths on your computer"
26
+
To open a notebook, Pluto needs to know the _full path_ of your `.jl` file — this is the complete address that tells your computer exactly where the file is located. The format of file paths differs depending on your operating system:
27
+
28
+
**On Windows:**
29
+
30
+
- Paths start with a drive letter and use backslashes:
31
+
- An example is: `C:\\Users\\fons\\Documents\\my_notebook.jl`
32
+
- To copy a file's path: hold Shift, right-click the file in File Explorer, and select "Copy as path"
33
+
- For a detailed step-by-step guide, check out [this Windows tutorial](https://www.top-password.com/blog/copy-full-path-of-a-folder-file-in-windows/)
34
+
35
+
**On macOS:**
36
+
37
+
- Paths start with a forward slash `/`
38
+
- A path may look like: `/Users/fons/Documents/my_notebook.jl`
39
+
- To copy a file's path: right-click the file in Finder, hold Option (⌥), and select "Copy ... as Pathname"
40
+
- For a detailed step-by-step guide, check out [this MacOS tutorial](https://www.josharcher.uk/code/find-path-to-folder-on-mac/)
41
+
42
+
**On Ubuntu (and other Linux distributions):**
43
+
44
+
- Paths start with a forward slash `/`
45
+
- They look like: `/home/fons/Documents/my_notebook.jl`
46
+
- To copy a file's path: right-click the file in your file manager (e.g., Nautilus), and select "Copy" or use the keyboard shortcut Ctrl+Shift+C in the file manager's address bar
47
+
- Alternatively, you can drag and drop the file into a terminal window to paste its full path
48
+
49
+
### Why so difficult?
50
+
It would be really nice if you could just pick the notebook file from your file browser, instead of having to type the path. But this is not possible, because Pluto is a web application, which does not have access to your file system for security reasons. See [this issue](https://github.com/fonsp/Pluto.jl/issues/350). BUT this feature _is_ possible in the [Pluto Desktop app](https://github.com/JuliaPluto/PlutoDesktop) (WIP)
51
+
52
+
{#open-existing}
53
+
# How to open an existing notebook file
54
+
When you launch Pluto for the second time, your recent notebooks will appear in the main menu. You can click on them to continue where you left off.
55
+
56
+
<img src="$(root_url)/assets/img/existing-notebooks.png" alt="screenshot of the existing notebooks already open in the Pluto main menu" width="1874" height="658">
57
+
58
+
!!! tip "To open this temporary folder"
59
+
You can quickly navigate to the temporary notebooks folder by running this command in Julia:
60
+
61
+
```julia
62
+
run(`open ~/.julia/pluto_notebooks/`) # macOS
63
+
run(`explorer ~/.julia/pluto_notebooks/`) # Windows
64
+
run(`xdg-open ~/.julia/pluto_notebooks/`) # Linux
65
+
```
66
+
67
+
{#open-from-url}
68
+
# How to open a notebook from the web
69
+
You can use Pluto to open a notebook from the web, using the URL of the notebook file. First, **copy the URL** of the notebook file. This URL probably ends with `.jl`. For example:
Next, go to the [Pluto main menu](../launch-pluto/#main-menu). Now you can **paste the URL** in the textbox, and press Enter or click the "Open" button.
74
+
75
+
The notebook will open in "Safe Preview" mode, which means that no code will be executed until you give permission.
76
+
77
+
<img src="$(root_url)/assets/img/open notebook path or url.png" alt="screenshot of the url bar for url or full paths" width="1774" height="558">
78
+
79
+
80
+
{#open-from-clipboard}
81
+
# Open a notebook using the Clipboard
82
+
You can copy the **complete contents** of a `.jl` Pluto notebook file, and open it with Pluto. With the contents of a notebook file in your clipboard, go to the [Pluto main menu](../launch-pluto/#main-menu). Now simply paste the contents anywhere on the page using `Ctrl+V` or `Cmd+V`, and it will be opened as a new notebook.
83
+
84
+
The notebook will open in "Safe Preview" mode, which means that no code will be executed until you give permission.
85
+
86
+
{#move}
87
+
# How to move files
88
+
89
+
The path of your current notebook is displayed at the top of the Pluto interface. You can **click on it to change the path** — this allows you to:
90
+
91
+
- Move the notebook to a different folder
92
+
- Rename the notebook file
93
+
- Save a copy in a new location
94
+
95
+
After typing a new path, press Enter or click the save button to confirm the change. The notebook will be moved or renamed accordingly.
96
+
97
+
<img src="$(root_url)/assets/img/change-move-files.png" alt="screenshot of how to change, move the open notebook files using the upper bar" width="1432" height="558">
98
+
99
+
{#featured}
100
+
# Running featured notebooks
101
+
On the bottom of the [Pluto main menu](../launch-pluto/#main-menu), you will find a large collection of **featured notebooks** – notebooks written by the Julia community, featured by the Pluto developers. These notebooks are a great resource to get inspired about new ways to use Julia and Pluto!
102
+
103
+
Click on any featured notebook to read it. This will instantly load the notebook (prerendered on our servers), and interactive elements will work (this is done using [PlutoSliderServer.jl](https://github.com/JuliaPluto/PlutoSliderServer.jl)). If you want to change code and run the notebook, simply click the "Edit or run" button in the top right of the screen. This will **make a copy of the notebook** on your computer that you can edit.
0 commit comments