</Gisto>

Documentation

Tag gist

Every gist can be tagged by adding hash-tag to it's title.

For example: You have a gist titled

TEXTSimple html template

and you'd like to tag it with "template" and "html" tags. All you need to do, is to add these tags as hash-tags to the end of the title like so:

TEXTSimple html template #html #template

Gisto will then use the hash-tags to display tags in the gist list and search by this tags.

Change gist state secret / public

Gist state can be changed from "secret" to public and vise-versa via the or on the top panel when viewing gist.

Note! That all comments and revisions of this gist will be lost upon this action.
Update: recently GitHub added this functionality via web interface (with no data loss), but it is not yet available to use via Gist API.

Sharing gists between Gisto users

In order to share a gist with another Gisto user all you need to do is open a gist and click share on the top bar and type in the github username of the recipient.

The recipient will receive a notification that a gist has been sent by you and will be able to view and fork the gist.

Setting up for development

Pre-installed requirements:

  • GIT - distributed version control
  • Node.js - server-side software system written in JavaScript
  • Node-webkit - app runtime based on Chromium and node.js
  • gulp.js - The streaming build system
  • MongoDB - NoSQL Database (Optional - used only by notification server)

Set it all to work together:

Clone the latest source (and submodules) with the following command to a directory of your choice:

SHELLgit clone --recursive https://github.com/Gisto/Gisto.git

Enter into the newly created directory:

SHELLcd Gisto

Run:

SHELLnpm install

this will install all necessary npm and bower dependencies.

See gulpfile.js fore more details, usage is documented in comments.

Rename app/config.json.sample file to app/config.json and fill required fields

JSON{
    "client_id":"",
    "client_secret":""
}

This needed in order to use GitHub Gist API (Register a new OAuth application)

Run Gisto

SHELLnpm start

This will run Gisto via node-webkit (pre-installed by npm as dependency)

Run the notifications server: (optional)

Configure the notification server connection string: you will find config.js.sample sample file, in the server directory. Rename it to config.js and fill in the "connectionString" which is the full connection string of mongo e.g. mongodb://server/collection and OAuth application "clientId".

JavaScriptexports.connectionString = '';
exports.clientId = '';

Start a mongoDB instance

Run:

SHELLmongod

Start the nodejs notifications server

SHELLnode server/app.js

Even better, run it with forever or PM2 (both available as NPM packages) on persistent server.

Congratulations! If all went well, you are now have set-up local version of Gisto in your machine.

Build

View build script help/usage:

SHELL./build/script/nwjs-build.sh --help