Giter VIP home page Giter VIP logo

noflo.github.io's Introduction

NoFlo website

Sources for the NoFlo website.

Updating for new versions

  • Edit the version number in _config.yml
  • Update API documentation via grunt build (or cd _src && git pull && cd .. && grunt docco)
  • Ensure usage documentation is up-to-date

Contributing to the site

Feel free to send pull requests. Local site development is handled using Grunt.

Install the dependencies with:

$ npm install
$ bundle install --path vendor/bundle

Then to develop the site, run:

$ grunt dev

This will start a web server at http://localhost:4000. Grunt watches for any changes in the source files and triggers a rebuild as needed.

noflo.github.io's People

Contributors

alfa256 avatar aretecode avatar bergie avatar bradders avatar d4tocchini avatar dependabot[bot] avatar djdeath avatar forresto avatar greenkeeper[bot] avatar jonnor avatar llandwerlin-intel avatar paulyoung avatar thescouser89 avatar trevor avatar trustmaster avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

noflo.github.io's Issues

NoFlo graph file format specification

There's a page in NoFlo documentation describing NoFlo JSON graph format: http://noflojs.org/documentation/json/

While GoFlow is slowly progressing towards support of loading graphs at run-time, the documentation provided for NoFlo JSON is not enough for a 3rd-party implementation. It contains just a minimal example without an explanation, while a more formal and detailed specification is required for the format to be supported by 3rd-party FBP runtimes.

Example questions left after reading the current docs:

  • what is "metadata"?
  • is "metadata" related to "initial IP" concept?
  • how are initial IPs represented on the graph if it isn't?
  • what is "data" and which component is responsible for reading it?
  • etc.

Component details page

As per #31 the base reusable unit of code in NoFlo is a Component. Components are shipped in libraries that usually contain multiple of them, but the thing that will interest a developer is the components available, not the libraries.

In addition to a page where users can see and search for components for Node.js or browser, we should have a details page for each component.

This page should show the metadata of the component (name, author, library, etc), but also the annotated source code.

Here is an example of how that could look like (from the old NoFlo UI)

screenshot_2013-03-26-18-58-07

Build on Travis CI then push to Github Pages

Right now Github Pages does the page build. This means we don't get notified about failures until we merge to master, when its already too late. It also limits what we can use to what gh-pages support, and requires checking in intermediate/generated data to the git repo.

Library: list—affordance

The list of components shouldn't have a border and a slightly tighter, harsher shadow. Also, "version" text isn't italicised

live:
screen shot 2013-07-04 at 23 12 00

psd:
screen shot 2013-07-04 at 23 11 44

Slide: Noflo and FBP—image crop

Book image cropped on slide. Due to mask (needs unmasking) in psd

Sub text should also be smaller (14px with line height of 20px) or whatever is relative

screen shot 2013-07-04 at 22 36 14

Focus on components, not on libraries

A Component Library is a collection of NoFlo components, reusable pieces of software that you can use as nodes in a FBP graph.

The important part should really be the components, not the libraries they come from (though this info should also be available)

Broken HTTPS/SSL configuration

https://noflojs.org does not work, fails with a certificate error because the cert is for *.github.com.

This is especially problematic because we host software on this domain, ie for noflo-browser builds used in Flowhub and other places. These cannot be loaded on a HTTPS site, and for HTTP can be intercepted without detection.

OptionParser::InvalidOption: invalid option: --sourcemap

i try this both on branch gh-pages and kickstarter and face the same problem after running npm install and then grunt dev.

Running "connect:dev" (connect) task
Started connect web server on localhost:4000.

Running "sass:src" (sass) task
OptionParser::InvalidOption: invalid option: --sourcemap
  Use --trace for backtrace.
Warning:  Use --force to continue.

Aborted due to warnings.

Btn: blue—colour

Slightly lighter and less saturated blue is used. hex: 5396db hsb(210,62,86)

Live:
screen shot 2013-07-04 at 23 03 10

psd:
screen shot 2013-07-04 at 23 03 21

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.