Skip to content

Create README.md with Installation instructions #56

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jan 6, 2020
Merged

Create README.md with Installation instructions #56

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
d6cc1a3
Create README.md with Installation instructions
NHDaly Jan 3, 2020
d376d0e
Add installation instructions
NHDaly Jan 3, 2020
fdb9e9c
Update README.md
NHDaly Jan 3, 2020
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
30 changes: 30 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# JuliaBoxTutorials

This repository contains introductory tutorials for the [Julia language](http://julialang.org/) in the form of [Jupyter Notebooks](https://jupyter.org/about).

## JuliaBox

These tutorials are installed by default on the [JuliaBox](https://juliabox.com/) environment, where you can run Julia in your browser
through a hosted notebook server. This service what these tutorials were built for!

Go to https://juliabox.com/ and make an account to start running Julia in your browser.

## Installing on your Computer

You can also do these tutorials by installing `julia` on your computer, setting up Jupyter, and downloading this tutorial repository to your computer.
If you're new to Julia, you can do that by following these steps:

1. Download julia from https://julialang.org/downloads/ (download the latest "stable" version).
- Follow the instructions to install it on your computer (e.g. On macOS, drag it to Applications. On Windows, run the installer.)
2. Install julia's Jupyter Notebooks integration: IJulia.jl
- Open the installed julia application, and you are presented with a "REPL" prompt. This is the main Julia interface. There, type this closing bracket
character: <kbd>]</kbd> to open the package manager. Then type `add IJulia` to install the jupyter notebook interface for julia.
- Then exit the package manager by pressing <kbd>delete</kbd> (as if you're deleting the `]` you typed to enter package mode)
- Now you can open the jupyter notebooks by entering `using IJulia`, then once that loads, entering `IJulia.notebook()`, which should
open a Jupyter tab in your browser.
3. Last, download the tutorials from this repository, via the github Clone/Download button above, or clicking this link:
- https://github.com/JuliaComputing/JuliaBoxTutorials/archive/master.zip
- (If you've never used GitHub before, it's a place to collaborate on open source software. Julia itself is also [developed on github!](https://github.com/JuliaLang/julia))

And now from the Jupyter tab in your browser, you can navigate to the folder where you downloaded the tutorials, and then click
on the name of one of them to get started! Enjoy!