Skip to content

Commit ecd2810

Browse files
authored
Merge pull request #9 from tensor4all/shinaoka/restructuretutorial
Add missing file
2 parents 2d8ba2f + 443c92c commit ecd2810

File tree

1 file changed

+50
-0
lines changed

1 file changed

+50
-0
lines changed

juliatutorials/advanced.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
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+
![](https://raw.githubusercontent.com/tensor4all/T4APlutoExamples/refs/heads/main/assets/open_welcome.png)
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

Comments
 (0)