GithubHelp home page GithubHelp logo

biojs.net's Introduction

BioJS 2.0


88888888ba  88                     88  ad88888ba      ad888888b,  
88      "8b ""                     88 d8"     "8b    d8"     "88  
88      ,8P                        88 Y8,                    a8P  
88aaaaaa8P' 88  ,adPPYba,          88 `Y8aaaaa,           ,d8P"   
88""""""8b, 88 a8"     "8a         88   `"""""8b,       a8P"      
88      `8b 88 8b       d8         88         `8b     a8P'        
88      a8P 88 "8a,   ,a8" 88,   ,d88 Y8a     a8P    d8i"          
88888888P"  88  `"YbbdP"'   "Y8888P"   "Y88888P"     88888888888 

Version Build Status License: Apache 2 DOI

Slack Gitter IRC

TL;DR: you can browse the registry at biojs.net.

Guy Yachdav, Tatyana Goldberg, Sebastian Wilzbach, David Dao, Iris Shih, Saket Choudhary, Steve Crouch, Max Franz, Alexander García, Leyla J García, Björn A Grüning, Devasena Inupakutika, Ian Sillitoe, Anil S Thanki, Bruno Vieira, José M Villaveces, Maria V Schneider, Suzanna Lewis, Steve Pettifer, Burkhard Rost, and Manuel Corpas
[Anatomy of BioJS, an open source community for the life sciences][BioJS-elife]
eLife 2015;4:e07009 [BioJS-elife]: http://elifesciences.org/content/4/e07009

Contents

  1. Essentials
    1.1. Objectives
    1.2. What is BioJS
    1.3. Why is there nothing in this repo?
  1. Essentials

1.1. Objectives

  • Represent consistently biological information across different projects
  • Ease discovery, test and integration of graphical components
  • Standardize and facilitate components development

1.2. What is BioJS?

BioJS builds a infrastructure, guidelines and tools to avoid the reinvention of the wheel in life sciences (= "Docker for Bio web components"). Our community builds modules than can be reused by anyone and makes them available for download via a centralised registry.

1.3. Why is there nothing in this repo?

For BioJS 2.0 every component is a separate github repository. To search for a package, visit our registry. This repo is kept as intro guide and discussion repo. Feel free to open an issue (questions, suggestions, proposal or bug reports here) or to submit a component wish.

However you are still invited to show your interest in this project by starring this repo.

  1. Packages

2.1. What is a package?

A tiny building block like a FASTA parser or a visualization piece. If it obeys the rule "do one thing and do it well" , then it is (most likely) a package. The BioJS packages are published on the JavaScript package manager npm.

2.2. How to search for a package

Visit the biojs.net registry to search for components.

(Find it on github: Frontend repo, backend repo).

  1. Developing packages

3.1. What do I need to develop?

Detailed installation instructions.

Even tough you can easily install node on Windows, a Unix-like OS is generally a more productive development enviroment.

3.2. How to create a package?

↝ read our guide

To bootstrap a new project you can use the BioJS slush generator.

npm install -g slush slush-biojs
mkdir biojsAWesome && cd biojsAwesome
slush biojs

3.3. How to use snippets/examples?

↝ read our sniper.

3.4 Guidelines

Especially the snippets should give one a quick start on how to use a component.

3.5. I need the functionality X

You are now ready to enjoy the benefits of npm. For common use cases (requests, drag and drop, promises) you will always find plenty of npm modules.

Learn more

3.6. Gold standards

Our gold standards are conventions we highly encourage you to follow (especially for JS beginners). They will help you to create a great package!

3.7. How to publish a package?

Just publish it on npm.

Learn more

3.8. How can I report defective components?

We'd recommend opening an issue in their repository directly.

  1. Support

4.1. Get involved

Whether you want to write your own component and just submit it onto our BioJS registry or help to increase our ecosystem - we value your contribution(s)!

Get involved

Here are some general ideas:

more information

4.2. Contact

There are many ways to contact us

For technical queries (questions, suggestions, proposal or bug reports) Github issues are preferred.

4.3. More questions

↝ We have a community-based wiki. Some topics include:

4.4. Documentation

We maintain a learning platform edu.biojs.net.

Pull requests are welcome.

Contents:

  1. License

Apache 2

biojs.net's People

Contributors

ayusharma avatar benediktrauscher avatar benhwhite avatar carloshorro avatar carlostgac avatar daviddao avatar ddtxra avatar dennisschwartz avatar devasenainupakutika avatar dsblank avatar goldbergtatyana avatar gyachdav avatar ianmulvany avatar jajodiaraghav avatar jayjayjpg avatar manuelcorpas avatar mhelvens avatar saketkc avatar sillitoe avatar simonjupp avatar tatyanagoldberg avatar timruffles avatar wilzbach avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

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

biojs.net's Issues

Create new images for biojs.net main page

As discussed a couple of new images for the BioJS homepage would be necessary for our header and benefits section. Recent image ideas:

  • close-up of a laptop with different BioJS components on screen
  • people discussing in front of laptop
  • presentation in seminar room with BioJS visualizations on screen

Update citation

Please update citation to BioJS 2.0:

Guy Yachdav, Tatyana Goldberg, Sebastian Wilzbach, David Dao, Iris Shih, Saket Choudhary, Steve Crouch, Max Franz, Alexander García, Leyla J García, Björn A Grüning, Devasena Inupakutika, Ian Sillitoe, Anil S Thanki, Bruno Vieira, José M Villaveces, Maria V Schneider, Suzanna Lewis, Steve Pettifer, Burkhard Rost, and Manuel Corpas
Anatomy of BioJS, an open source community for the life sciences. eLife 2015;4:e07009

Setup CI

We need a continuous integration setup that allows deployment of the site when a pull request is merged.

Examples: TravisCI, CodeShip, CircleCI.

Some of those offer free accounts for open source project or a low number of deployments.

Proposal: turning links to components into actual links

The current version of the site doesn't allow the user to open components in a new tab. The div is clicked and the browser loads the component page.

We could have a better user experience by allowing the user to ctrl+click (or right click) and open components in new tabs. Maybe turning the component name into a link and leaving the div behavior as it is would be enough.

REDESIGN-16 - Re-Organize Contents on Home Page

Restructure the contents on the Biojs.net Homepage

The new design should focus on the two main conversion goals:

    1. Getting started/Tutorials
    1. Contributing
  • create 4 semantic sections:
    1. What is it (Header area)?
    2. What can it do (Benefits / Video / Demo)?
    3. How can I start (links to Tutorials/Getting started guide)?
    4. How can I contribute (link to git / twitter / googlegroups or its own community page)?

Please include a couple of crosslinkings in the design to section 3) and 4) (maybe add smooth scrolling functionality later in the implementation)

REDESIGN-16 - Re-Organize Menu Navigation

  • Home (BioJS Logo)
  • Getting Started
  • Contribute
  • Best Practices for more Advanced Users (Guarantee for Interoparibility, Documentation Guidelines)
  • Community ( contact info, list of BioJS groups on the web or locally, recent conferences)
  • About (info why BioJS exists, Mission idea)

Create header section with changing BioJS background images

Please create a header section with dynamically changing background images on the main page. Change of images may be accomplished by

  • showing a set of 3-5 static background images sequentially
  • showing a set of 3-5 animated gifs / videos sequentially

Please also add a suitable transition animation for the different image steps

REDESIGN-16 - Switch to another css framework

Although Bootstrap is very common easy-to-use nowadays, we could think about switching to another css framework to give the site a new fresh design from scratch.

A couple of interesting frameworks I can suggest are

  • Materialize - offers similar to BS its own composable css classes and js components for common UI elements. Features Google Material Design like styling, Flexbox styled elements and precompilation with SASS
  • Foundation quite extensive, and well-developed CSS framework with strong focus on responsive layouts

REDESIGN-16 - Move Site to A New Drupal Install

To make content management even more approachable to its editors we plan to use a CMS solution for biojs.net.

One option would be to install Drupal and build biojs.net on top of that.
There might be a possibility to rather easily create a new Drupal instance for biojs.net once the new TGAC page (which will also be Drupal based) is up.

Let's discuss the time point when to migrate the page to Drupal.

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.