Skip to content

Commit

Permalink
Updates to getPushkin.
Browse files Browse the repository at this point in the history
  • Loading branch information
jkhartshorne committed Apr 10, 2019
1 parent a166553 commit a77f271
Showing 1 changed file with 39 additions and 8 deletions.
47 changes: 39 additions & 8 deletions docs/source/setup/getPushkin.rst
Original file line number Diff line number Diff line change
@@ -1,15 +1,11 @@
.. _get-pushkin:

Get Pushkin
=========================
Starting a Pushkin Project
############

To install Pushkin, you will need `wget`, which is easily installed using Homebrew or another package manager.
To start a new Pushkin website, you can install everything you need through the node project manager (npm). You will need to `install Node.js and npm <https://www.npmjs.com/get-npm>`.

If you simply want to use Pushkin, you should visit https://github.com/pushkin-consortium/pushkin_quickinstall and follow the instructions. This will download everything you need and set up the Command Line Tools (CLT).

If you are planning on contributing to pushkin, clone (or better yet, fork) the version from GitHub::

git clone https://github.com/l3atbc-datadog/pushkin.git
FUBAR - UPDATE FOLLOWING

You will then need to set up the CLT. To do that, after you have cloned pushkin, move to pushkin's root directory and run:

Expand All @@ -30,3 +26,38 @@ Pushkin relies on the following programs, which can easily be installed with Hom
Once these are installed, run ``pushkin init`` to automated installing packages and setting up the Pushkin environment.

Once you've got Pushkin downloaded and installed, see :ref:`new-quiz` to make a quiz.

END FUBAR

Updating Pushkin
############

FUBAR


Pushkin Development
############


We don't recommend editing core Pushkin code locally, since this will make it difficult to update your distribution of Pushkin to take advantage of security patches, bug fixes, or new features. Instead, we recommend you fork the repository for the Pushkin tool in question. You can make a private npm package based on that repository. (If your changes are ones that others might want to make sure of as well, please submit a pull request!)

The main Pushkin repositories are:
`pushkin-client` <https://github.com/pushkin-consortium/pushkin-client>`
-----------
A module that wraps around local-axios and provides simplified methods for making calls to a Pushkin API. Note that these built-in requests assume the API has default routes enabled. Documentation for the Pushkin Client is currently absent, however the experiment template available via the generate command from the CLI provides a showing of almost all the features in action.

`pushkin-api` <https://github.com/pushkin-consortium/pushkin-api>`
-----------
Essentially a mini-server designed mainly with the use case of interfacing with Pushkin Client and Pushkin Worker. Once again, documentation is absent, but there is an example.

`pushkin-worker` <https://github.com/pushkin-consortium/pushkin-worker>`
-----------
Installable via NPM. Adds a "pushkin" command to the path. No documentation available yet

`pushkin-cli` <https://github.com/pushkin-consortium/pushkin-cli>`
-----------
Receives messages from RabbitMQ and runs whatever functionality it's told to run, sending the result back through the queue it came from. Designed to be on the receiving end of a Pushkin API. Comes with built-in simple functions that most users will probably want, like "getAllStimuli". Currently no explicit documentation, just an example.

`pushkin-jspsych` <https://github.com/pushkin-consortium/pushkin-jspsych>`
-----------
The Pushkin fork of JSPsych makes a few small changes to the real JSPsych so that it can be bundled together as if it's an NPM module. In order for it to be globally accessible to plugins as they expect, the import must be assigned to window.jsPsych. No documentation, present in example.

0 comments on commit a77f271

Please sign in to comment.