diff --git a/src/assets/img/create-cell.png b/src/assets/img/create-cell.png new file mode 100644 index 0000000..a57b358 Binary files /dev/null and b/src/assets/img/create-cell.png differ diff --git a/src/assets/img/hide-cell.png b/src/assets/img/hide-cell.png new file mode 100644 index 0000000..d5f9ce8 Binary files /dev/null and b/src/assets/img/hide-cell.png differ diff --git a/src/assets/img/pluto-error-msg.png b/src/assets/img/pluto-error-msg.png new file mode 100644 index 0000000..409c81e Binary files /dev/null and b/src/assets/img/pluto-error-msg.png differ diff --git a/src/assets/img/run-button.png b/src/assets/img/run-button.png new file mode 100644 index 0000000..c68cf2b Binary files /dev/null and b/src/assets/img/run-button.png differ diff --git a/src/assets/img/show-cell.png b/src/assets/img/show-cell.png new file mode 100644 index 0000000..518dfe2 Binary files /dev/null and b/src/assets/img/show-cell.png differ diff --git a/src/en/docs/basics.jlmd b/src/en/docs/basics.jlmd new file mode 100644 index 0000000..e2c98d5 --- /dev/null +++ b/src/en/docs/basics.jlmd @@ -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`. + +screenshot of creating a cell + +!!! 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 check icon or use the shortcut `Shift+Enter`. + +screenshot of running a cell + +## 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 circle icon **Cell context menu** menu in the top right of a cell input then clicking on close icon **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 eye icon icon to the left of the cell. + +screenshot of hiding a cell + +To show the cell again, just click on the same icon again! + +screenshot of hiding a cell + +!!! 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 circle icon **Cell context menu** menu in the top right of a cell input and select **Copy output** then paste it wherever you want. \ No newline at end of file diff --git a/src/en/docs/featured-notebooks.jlmd b/src/en/docs/featured-notebooks.jlmd index dc15d9d..90d8e93 100644 --- a/src/en/docs/featured-notebooks.jlmd +++ b/src/en/docs/featured-notebooks.jlmd @@ -2,7 +2,7 @@ title: "⭐️ Featured notebooks" tags: ["docs", "introduction"] layout: "md.jlmd" -order: 2 +order: 4 --- # ⭐️ Featured notebooks