From 19935b5b03654704bce5d580f5fa7c3a61862a8a Mon Sep 17 00:00:00 2001 From: Michele Nottoli <michele.nottoli@gmail.com> Date: Tue, 10 Oct 2023 13:49:47 +0200 Subject: [PATCH] Updated readme according to notebook 0. --- README.md | 34 +++++++++++++--------------------- 1 file changed, 13 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index 4415f68..ed95335 100644 --- a/README.md +++ b/README.md @@ -8,29 +8,18 @@ The course material is adapted from two sources: ## Software and material What you need for the workshop (quick overview): -- [Julia 1.8](https://julialang.org/downloads/) +- [Julia 1.9](https://julialang.org/downloads/) - [Jupyter](https://jupyter.org/) and [IJulia.jl](https://github.com/JuliaLang/IJulia.jl) - This repository of workshop materials - All required dependencies (Julia packages) for the workshop ### Getting Julia -For following the course you will need at least **Julia 1.8**. +For following the course you will need **Julia 1.9**. Julia can be easily obtained in binary form from [Julia downloads](https://julialang.org/downloads/). ### Getting all the rest -To get the remaining files and dependencies -start up `julia` and in the resulting REPL shell, -copy and paste the following: - -```julia -import Downloads -script = Downloads.download("https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/-/raw/main/install.jl?ref_type=heads") -include(script) -``` -This [downloads the install.jl script](https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/-/raw/main/install.jl?ref_type=heads) -and runs it from julia. -Follow the instructions on the screen and start the Jupyter notebook server -with the command that will be printed. +The easiest way to get the remaining files and dependencies +is to [download the install.jl script](https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/-/blob/main/install.jl?ref_type=heads) and run it from julia. See the instructions [on the github repository](https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/). As an alternative you can also also run the following commands manually (this requires to have `git` and `julia` available from the commandline): @@ -40,15 +29,18 @@ cd Julia-seminar julia install-manual.jl ``` +### Starting the notebook +To start the notebook make sure to be in the folder `Julia-seminar` and then run `julia`: an interactive Julia command line will open. In there run this command + +``` +using IJulia; notebook(dir=pwd()) +``` +and the notebook will automatically open in a browser. + ### Troubleshooting If you are facing issues, check out the [great troubleshooting section](https://carstenbauer.github.io/WorkshopWizard.jl/dev/troubleshooting/) -from the WorkshopWizard package by Carsten Bauer (which `install.jl` is using). - -### Check everything works -There is a section in the [00_Installation](00_Installation.ipynb) notebook -with a few quick commands to check everything works as expected. -Please run these **before the course**. +from the WorkshopWizard package by Carsten Bauer (which is being used by `install.jl`). ### For Developers: Setting Up `pre-commit` -- GitLab