Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added src/assets/img/create-cell.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/img/hide-cell.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/img/pluto-error-msg.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/img/run-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/img/show-cell.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
66 changes: 66 additions & 0 deletions src/en/docs/basics.jlmd
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
---
title: "🤓 Getting Started"
description: "Introduction to basic features in Pluto!"
tags: ["docs", "introduction"]
layout: "md.jlmd"
order: 3
---

# Getting Start: Your First Notebook ! 🤓

## Step 1: Installing Pluto
To get started, check out how to install Pluto [here](../install).

## Step 2: Opening a Notebook
Once Pluto is installed, you can either choose to open your own notebook or start a fresh empty notebook. If you need help with this, check [this guide](../files-open/).

## Step 3: Creating and Running a Cell
To add code, you need to first add a cell. This can be done with clicking on the `+` icon as shown below or by using the shortcut `Ctrl+Enter`.

<img alt="screenshot of creating a cell" src="$(root_url)/assets/img/create-cell.png" width="1796" height="216"></a>

!!! tip
Once a cell is created, you can add either one code expression or wrap your code in a `begin ... end` block to allow multiple expressions.

To run the cell, you can either click on the Run Icon <img src="https://cdn.jsdelivr.net/gh/ionic-team/ionicons@5.5.1/src/svg/caret-forward-circle-outline.svg" alt="check icon" class="ionicon"> or use the shortcut `Shift+Enter`.

<img alt="screenshot of running a cell" src="$(root_url)/assets/img/run-button.png" width="1780" height="174"></a>

## Step 4: Start Coding :)

Pluto offers a lot of features to make your workflow smoother.

### Creating Markdown Cells
Pluto lets you mix code and Markdown in the same notebook and the best thing? You can use the **same** cell type for this! You can add titles, headings, and commentary to bring your work to life. Learn more in the [Markdown](../markdown) section.

### Adding Math Formulas in LaTeX
Pluto supports LaTeX for adding formulas and math expressions that may be relevant to your code. You can find out how to do this under [LaTeX](../latex).

### Adding Images
You can also add images from different sources. You can learn about this in [Images](../images).

### Creating Plots
To create plots, you can use all kinds of plotting libraries directly in Pluto. Check out an example on how to do this under [Plots](../plot), it's super easy!

### Hiding Cell Outputs
You can hide cell output by adding `;` at the end of the cell code. If the cell is multiple lines with a block, like `begin ... end`, then place the `;` after `end`.

### Deleting Cells
If a cell is no longer relevant to your workflow, you can simply delete it by going to the <img src="https://cdn.jsdelivr.net/gh/ionic-team/ionicons@5.5.1/src/svg/ellipsis-vertical-circle-outline.svg" alt="circle icon" class="ionicon"> **Cell context menu** menu in the top right of a cell input then clicking on <img alt="close icon" src="https://unpkg.com/ionicons@7.1.0/dist/svg/close-circle.svg" width="12"> **Delete cell**.

If you want to preserve the code in case you need it later, the cell can be temporarily disabled instead. [This guide](../disable-cell) shows how to do this.

### Hiding Cells
Pluto also lets you hide a cell's code while keeping it running and its output visible, pretty neat! To do this, just click on the <img alt="eye icon" src="https://unpkg.com/ionicons@7.1.0/dist/svg/eye-outline.svg" width="12"> icon to the left of the cell.

<img alt="screenshot of hiding a cell" src="$(root_url)/assets/img/hide-cell.png" width="1784" height="210"></a>

To show the cell again, just click on the same icon again!

<img alt="screenshot of hiding a cell" src="$(root_url)/assets/img/show-cell.png" width="1784" height="128"></a>

!!! tip
This can be super useful for keeping things tidy! If you've got a chunky block of code (like one that generates a plot) that's not really the star of the show, just hide it and just leave the output. Check out more use cases in [Featured Notebooks](../featured-notebooks/) and see how we use it for education [here](../education-showcase).

### Copy Output Button
If you need to use the output of a cell in another context, you can go to the <img src="https://cdn.jsdelivr.net/gh/ionic-team/ionicons@5.5.1/src/svg/ellipsis-vertical-circle-outline.svg" alt="circle icon" class="ionicon"> **Cell context menu** menu in the top right of a cell input and select **Copy output** then paste it wherever you want.
2 changes: 1 addition & 1 deletion src/en/docs/featured-notebooks.jlmd
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "⭐️ Featured notebooks"
tags: ["docs", "introduction"]
layout: "md.jlmd"
order: 2
order: 4
---

# ⭐️ Featured notebooks
Expand Down