|
| 1 | +# Advanced topics |
| 2 | + |
| 3 | +## How to open Pluto notebooks locally |
| 4 | + |
| 5 | +Our tutorials are written in [Pluto.jl](https://plutojl.org/) notebook. To open Pluto notebooks locally, clone our [tutorial repository T4APlutoExamples](https://github.com/tensor4all/T4APlutoExamples) and navigate to directory `T4APlutoExamples`: |
| 6 | + |
| 7 | +```sh |
| 8 | +$ git clone https://github.com/tensor4all/T4APlutoExamples.git |
| 9 | +$ cd T4APlutoExamples |
| 10 | +$ Manifest.toml Project.toml README.md pluto_notebooks scripts |
| 11 | +``` |
| 12 | + |
| 13 | +Then we also need to install Pluto.jl. To do this, type `julia --project` in a terminal to open Julia REPL and run the following julia code: |
| 14 | + |
| 15 | +```julia-repl |
| 16 | +$ julia --project |
| 17 | + _ |
| 18 | + _ _ _(_)_ | Documentation: https://docs.julialang.org |
| 19 | + (_) | (_) (_) | |
| 20 | + _ _ _| |_ __ _ | Type "?" for help, "]?" for Pkg help. |
| 21 | + | | | | | | |/ _` | | |
| 22 | + | | |_| | | | (_| | | Version 1.10.5 (2024-08-27) |
| 23 | + _/ |\__'_|_|_|\__'_| | Official https://julialang.org/ release |
| 24 | +|__/ | |
| 25 | +
|
| 26 | +julia> using Pkg; Pkg.instantiate() |
| 27 | + Activating project at `~/tensor4all/T4APlutoExamples` |
| 28 | +``` |
| 29 | + |
| 30 | +Continued from previous REPL session, launch Pluto server locally via: |
| 31 | + |
| 32 | +```julia-repl |
| 33 | +julia> using Pluto; Pluto.run() |
| 34 | +[ Info: Loading... |
| 35 | +┌ Info: |
| 36 | +└ Opening http://localhost:1234/?secret=xxxxxx in your default browser... ~ have fun! |
| 37 | +┌ Info: |
| 38 | +│ Press Ctrl+C in this terminal to stop Pluto |
| 39 | +└ |
| 40 | +``` |
| 41 | + |
| 42 | +This will open http://localhost:1234/?secret=xxxxxx in your default browser and you will see the following main menu of Pluto notebook: |
| 43 | + |
| 44 | + |
| 45 | + |
| 46 | +To open notebooks under `pluto_notebooks` directory, type `pluto_notebooks/welcome.jl` to text area under `Open a notebook` section. Then, press `Open` button. |
| 47 | + |
| 48 | +## Developer guide (T4AJuliaTutorials wiki) |
| 49 | + |
| 50 | +[T4AJuliaTutorials/wiki](https://github.com/tensor4all/T4AJuliaTutorials/wiki) provides basic tutorials about software development. For example How to set up a development environment on [Windows](https://github.com/tensor4all/T4AJuliaTutorials/wiki/Instructions-for-setting-up-a-development-environment-on-Windows(PowerShell,-winget)), [macOS](https://github.com/tensor4all/T4AJuliaTutorials/wiki/Instructions-for-setting-up-a-development-environment-on-macOS) and [Linux and WSL2](https://github.com/tensor4all/T4AJuliaTutorials/wiki/Instructions-for-setting-up-a-development-environment-on-Linux(Ubuntu,-WSL2)). |
0 commit comments