Skip to content

Commit

Permalink
Starting rework of development environment section
Browse files Browse the repository at this point in the history
Starting with new install guide for Atom Proton with ProtoREPL.  Using
collapsible sections for operating system specific instructions.
  • Loading branch information
practicalli-johnny committed Oct 10, 2018
1 parent 2b0b727 commit 4880048
Show file tree
Hide file tree
Showing 3 changed files with 96 additions and 19 deletions.
33 changes: 14 additions & 19 deletions SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -101,26 +101,21 @@
* [Development Enviromment](development-environment/index.md)
* [Java](development-environment/java.md)
* [Leiningen](development-environment/leiningen.md)
* [Editor Guides](development-environment/editor-guides/index.md)
* [LightTable](development-environment/editor-guides/lighttable.md)
* [Linux](development-environment/editor-guides/lighttable-linux.md)
* [MacOSX](development-environment/editor-guides/lighttable-macosx.md)
* [Windows](development-environment/editor-guides/lighttable-windows.md)
* [Editor install guides](development-environment/install-guides/index.md)
* [Atom.io and ProtoREPL](development-environment/install-guides/protorepl.md)
* [Atom.io and Proton](development-environment/install-guides/proton.md)
* [VS Code and Calva](development-environment/install-guides/vscode-calva.md)
* [Emacs and Spacemacs](development-environment/install-guides/emacs-spacemacs.md)
* [IntelliJ and Cursive](development-environment/install-guides/intellij-cursive.md)
* [LightTable](development-environment/install-guides/lighttable.md)
* [LightTable InstaREPL](introducing-clojure/lighttable-instarepl.md)
* [Using LightTable Instarepl](introducing-clojure/trying-the-instarepl.md)
* [Evaluate ClojureBridge Project](introducing-clojure/evaluate-turtle-project.md)
* [Spacemacs](development-environment/editor-guides/spacemacs.md)
* [Linux](development-environment/editor-guides/spacemacs-linux.md)
* [MacOSX](development-environment/editor-guides/spacemacs-macosx.md)
* [Windows](development-environment/editor-guides/spacemacs-windows.md)
* [Protorepl](development-environment/editor-guides/protorepl.md)
* [Linux](development-environment/editor-guides/protorepl-linux.md)
* [MacOSX](development-environment/editor-guides/protorepl-macosx.md)
* [Windows](development-environment/editor-guides/protorepl-windows.md)
* [Microsoft Code](development-environment/editor-guides/microsoft-code.md)
* [Linux](development-environment/editor-guides/microsoft-code-linux.md)
* [MacOSX](development-environment/editor-guides/microsoft-code-macosx.md)
* [Windows](development-environment/editor-guides/microsoft-code-windows.md)
* [Test your Editor](introducing-clojure/evaluate-turtle-project.md)
* [Editor User Guides](development-environment/editor-guides/index.md)
* [Atom.io and Protorepl](development-environment/editor-guides/protorepl.md)
* [Emacs and Spacemacs](development-environment/editor-guides/spacemacs.md)
* [VS Code and Calva](development-environment/editor-guides/vscode-calva.md)
* [LightTable](development-environment/editor-guides/lighttable.md)
* [Using LightTable Instarepl](introducing-clojure/trying-the-instarepl.md)
* [Contribute](contribute.md)
* [Fancy Keyboard Keys](fancy-keyboard-keys.md)
* [Klipse](klipse/index.md)
Expand Down
3 changes: 3 additions & 0 deletions development-environment/install-guides/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Editor Install Guides

To continue working on Clojure after the event, we recommend installing one of the following editors:
79 changes: 79 additions & 0 deletions development-environment/install-guides/proton.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
# Atom Proton

> #### TODO:: work in progress, corrections and pull requests welcome
[Proton-mode](https://github.com/dvcrn/proton) gives a Spacemacs-like experience to the Atom editor

Proton-mode provides a mnemonic menu and set of keybindings that offer an effective alternative to the interesting keybindings with Atom and ProtoREPL. It also provides modal editing features, simplifying keybindings.

[![Proton-mode](/images/proton-mode.gif)](/images/proton-mode.gif)

## Install Atom.io

Follow the instructions for your operating system


<!--sec data-title="Ubuntu Linux" data-id="ubuntulinux" data-collapse=true ces-->
Download the latest `.deb` file from Atom.io

Once downloaded, double-click the `.deb` file to install.

To run atom, press the `Super` key and type `atom`, or open a terminal and type the command `atom`.
<!--endsec-->

<!--sec data-title="RedHat Linux" data-id="redhatlinux" data-collapse=true ces-->
Download the latest `.rpm` file from Atom.io

Once downloaded, double-click the `.rpm` file to install.

To run atom, press the `Super` key and type `atom`, or open a terminal and type the command `atom`.
<!--endsec-->

<!--sec data-title="MacOSX" data-id="macosx" data-collapse=true ces-->
Pull request welcome
<!--endsec-->

<!--sec data-title="Windows" data-id="windows" data-collapse=true ces-->
Pull request welcome
<!--endsec-->


## Install Proton

Required packages

* [ink](https://atom.io/packages/ink) - Proto REPL dependency used for inline display and the REPL output.
* [proto-repl](https://github.com/jasongilman/proto-repl) - Clojure REPL, autocompletion, etc.
* [Proton-mode](https://github.com/dvcrn/proton) - Spacemacs style menu and keybindings to make Atom easier to use (included Vim / Emacs keybinding support)

Recommended packages

* [lisp-paredit](https://atom.io/packages/lisp-paredit) - to manage your `()`
* [proto-repl-charts](https://github.com/jasongilman/proto-repl-charts) - graphs and charts
* tool-bar - displays a REPL tool bar
* highlight-selected - highlights selected keywords throughout an editor


## Download the sample project

We have created an example Clojure project called "Welcome To ClojureBridge" to test your development tools.

<!--sec data-title="Download project as a zip file" data-id="gitzip" data-collapse=true ces-->

[Download the "Welcome To ClojureBridge" zip file](https://github.com/ClojureBridgeLondon/welcometoclojurebridge/archive/master.zip) and extract all the files.
<!--endsec-->

<!--sec data-title="Clone the project from Github" data-id="gitclone" data-collapse=true ces-->
If you are comfortable using the git version control tool and the command line, then you can clone the project using git

```bash
git clone https://github.com/ClojureBridge/welcometoclojurebridge
```
<!--endsec-->


## Test your editor with a clojure project

`SPC f f` and navigate to the `core.clj` file in the `welcometoclojurebridge` project.

`, s i` to start a Clojure REPL and display the REPL in a new window.

0 comments on commit 4880048

Please sign in to comment.