Skip to content

Commit

Permalink
Create README.md with Installation instructions
Browse files Browse the repository at this point in the history
For brand new would-be julia users who want to get started with Julia, I would love to send them to this github repo to get started, but there's no information on this page explaining _what to do once you're here!_

I know that these tutorials were originally written with JuliaBox in mind, so i've tried to maintain that spirit in these instructions. But hopefully we can also include instructions here about how to get started with julia in _any capacity_, because JuliaBox may not be the preferred option for everyone, and these are great tutorials that it would be a shame to not share! :)
  • Loading branch information
NHDaly authored Jan 3, 2020
1 parent c92547d commit d6cc1a3
Showing 1 changed file with 31 additions and 0 deletions.
31 changes: 31 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# 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.
2. Install julia's Jupyter Notebooks integration: IJulia.jl
- Open julia, 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 stored 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!

0 comments on commit d6cc1a3

Please sign in to comment.