Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/brianhicks/elm-workshop-arthur
workshop results from Elm Europe
https://github.com/brianhicks/elm-workshop-arthur
Last synced: 6 days ago
JSON representation
workshop results from Elm Europe
- Host: GitHub
- URL: https://github.com/brianhicks/elm-workshop-arthur
- Owner: BrianHicks
- License: other
- Created: 2017-06-07T15:19:46.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2017-06-07T16:14:08.000Z (over 7 years ago)
- Last Synced: 2024-12-09T19:53:33.983Z (14 days ago)
- Language: Elm
- Size: 367 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
This work is licensed under a Creative Commons Attribution 4.0 International License. Enjoy!
Getting Started
===============
## Installation
1. Install [Node.js](http://nodejs.org) 6.9.2 or higher
2. Add a plugin for your editor of choice: [Atom](https://atom.io/packages/language-elm), [Sublime Text](https://packagecontrol.io/packages/Elm%20Language%20Support), [VS Code](https://github.com/sbrink/vscode-elm), [Light Table](https://github.com/rundis/elm-light), [Vim](https://github.com/lambdatoast/elm.vim), [Emacs](https://github.com/jcollard/elm-mode), [Brackets](https://github.com/lepinay/elm-brackets)
3. Not required, but **highly** recommended: [install elm-format](https://github.com/avh4/elm-format#installation-) and integrate it into your editor so that it runs on save. You want the one [for Elm 0.18](https://github.com/avh4/elm-format#for-elm-018).
4. Run the following command to install everything else:
```bash
npm install -g elm elm-test elm-css [email protected]
```
**Note to macOS users:** If step 4 gives you an `EACCESS` error, try [this fix](https://docs.npmjs.com/getting-started/fixing-npm-permissions):
```
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
```
Then re-run step 4.
## Clone this repository
Run this at the terminal:
```bash
git clone https://github.com/rtfeldman/elm-workshop.git
cd elm-workshop
```
**Note:** Tab characters are syntax errors in Elm code, so if your editor uses them for indentation, definitely switch it to spaces for this workshop!
## Create a GitHub Personal Access Token
We'll be using GitHub's [Search API](https://developer.github.com/v3/search/), and authenticated API access lets us experiment without worrying about the default rate limit. Since we'll only be accessing the Search API, these steps can be done either on your personal GitHub account or on a throwaway account created for this workshop; either way will work just as well.
1. Visit https://github.com/settings/tokens/new
2. Enter "Elm Workshop" under "Token description" and leave everything else blank.
3. Create the token and copy it into a new file called `Auth.elm`:
#### Auth.elm
```elm
module Auth exposing (token)
token =
-- Your token should go here instead of this sample token:
"abcdef1234567890abcdef1234567890abcdef12"
```
**Note:** Even for a token that has no permissions, good security habits are
still important! `Auth.elm` is in `.gitignore` to avoid accidentally checking in
an API secret, and you should [delete this token](https://github.com/settings/tokens) when the workshop is over.
## Verify Setup
Run this to install packages:
```bash
elm-package install --yes
```
Once that succeeds, run this to verify everything:
```bash
elm-live Main.elm --open --pushstate --output=elm.js
```
A browser should open, and you should see this in it:
If things aren't working, the instructor will be happy to help!
## Start with Part 1
Run this at the terminal:
```bash
cd part1
```
Now head over to the [README for Part 1](https://github.com/rtfeldman/elm-workshop/tree/master/part1)!