{"id":13409278,"url":"https://vega.github.io/voyager2/","last_synced_at":"2025-03-14T14:31:05.970Z","repository":{"id":66074826,"uuid":"62337152","full_name":"vega/voyager2","owner":"vega","description":"Deprecated version of Voyager 2 (in Angular), please use https://github.com/vega/voyager.","archived":true,"fork":false,"pushed_at":"2017-11-08T01:22:42.000Z","size":5351,"stargazers_count":33,"open_issues_count":13,"forks_count":16,"subscribers_count":20,"default_branch":"vy2-master","last_synced_at":"2024-07-31T20:35:56.655Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://vega.github.io/voyager2/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vega.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-06-30T19:29:43.000Z","updated_at":"2024-06-04T16:08:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"a87ee5a1-c757-4e08-98c4-a870dbcf855b","html_url":"https://github.com/vega/voyager2","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vega%2Fvoyager2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vega%2Fvoyager2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vega%2Fvoyager2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vega%2Fvoyager2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vega","download_url":"https://codeload.github.com/vega/voyager2/tar.gz/refs/heads/vy2-master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243593329,"owners_count":20316168,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-30T20:00:59.518Z","updated_at":"2025-03-14T14:31:05.960Z","avatar_url":"https://github.com/vega.png","language":"JavaScript","funding_links":[],"categories":["Graphics and charts"],"sub_categories":[],"readme":"# Voyager 2 (OLDER ANGULAR VERSION)\n\nVoyager2 is Tableau-style User Interface for visual analysis with support for partial specification, building on top\nof [Vega-Lite](https://github.com/vega/vega-lite) and [CompassQL](https://github.com/vega/compassql). \n\n**This project hosts an older prototype of Voyager 2.  The newer version of Voyager 2 in React.js is hosted at https://github.com/vega/voyager.**\nPlease subscribe to our [mailing list](https://groups.google.com/forum/#!forum/data-voyager) to follow our updates.**\n\n\nFeedbacks are also welcomed. If you find a bug or have a feature request, please [create an issue](https://github.com/uwdata/voyager2/issues/new).\n\n\n## Team\n\nVoyager2's development is led by Kanit Wongsuphasawat and Jeffrey Heer at the University of Washington [Interactive Data Lab](http://idl.cs.washington.edu), in collaboration with [UW eScience Institute](http://escience.washington.edu/) and [Tableau Research](http://research.tableau.com)\n\n## Setup Instruction\n\n### Install Dependencies\n\nMake sure you have node.js. (We recommend using [homebrew](http://brew.sh) and simply run `brew install node`.)\n\n`cd` into your local clone of the repository, and install all the npm and bower dependencies (bower will auto-run when npm finishes):\n\n```sh\ncd voyager2\nnpm install\n```\n\nNow you should have all dependencies and should be ready to work.\n\n### Running\n\nYou can run `npm start`, which serves the site as well as running tests in the background.\nIf you edit any file, our [gulp](http://gulpjs.com) task runner should automatically refresh the browser and re-run tests.\n\nTo execute other tasks, either use the npm script aliases `npm run lint`, `npm test`, or `npm run build`, or else install gulp globally with `npm install -g gulp` and run the tasks directly from gulp.\n\n## Development Guide\n\n### Folder Structure\n\nWe try to follow [Google's Angular Best Practice for Angular App Structure](https://docs.google.com/document/d/1XXMvReO8-Awi1EZXAXS4PzDzdNvV6pGcuaF4Q9821Es/pub) and use [generator-gulp-angular](https://github.com/Swiip/generator-gulp-angular) to setup the project.\n\nAll source code are under `src/`\n\n- `src/app/` contains our main classes\n- `src/components` contains our other components\n- `src/assets/images/` contains relevant images\n- `src/data/` contains all data that we use in the application\n- `src/vendor` contains\n\n@kanitw created [`gulp/gen.js`](https://github.com/uwdata/voyager2/blob/master/gulp/gen.js) for help generating angular components.\nFor example, you can run `gulp gen -d directiveName` and this would create all relevant files including the javascript file, the template file, the stylesheet file and the test spec.\n\n#### Coding Style\n\nWe use jshint as our linter for coding in the project.\n\n#### Stylesheets\n\nWe use [sass](http://sass-lang.com) as it is a better syntax for css.\n\n#### Dependencies\n\nManaging front-end dependencies with [Bower](http://bower.io) requires the `bower` package to be globally installed:\n```sh\nnpm install -g bower\n```\n\nThis project depends on [Datalib](https://github.com/vega/datalib) for data processing, [Vega-Lite](https://github.com/vega/vega-lite) as a formal model for visualization, and [Vega-Lite-ui](https://github.com/vega/vega-lite-ui), which contains shared components between Voyager2 and Voyager.\n\nIf you plan to make changes to these dependencies and observe the changes without publishing / copying compiled libraries all the time, use [`bower link`](https://oncletom.io/2013/live-development-bower-component/).\n\nIn each of your dependency repository, run\n\n```sh\ncd path/to/dependency-repo\nbower link\n```\n\nThen go to this project's directory and run\n\n```sh\nbower link datalib\nbower link vega-lite\nbower link vega-lite-ui\n```\n\nNow all the changes you make in each repo will be reflected in your Vega-Lite automatically.\n\nSince bower uses the compiled main file, make sure that each repos is compiled everytime you run `npm start`.\nOtherwise, you will get errors for missing libraries.\n\n### Releasing / Github Pages\n\n`gh-pages` branch is for releasing a stable version.\n`gh-pages` should only contain the dist folder.\n\nUse `publish.sh` to:\n\n1. publish the current version to npm\n2. deploy the current branch to gh-pages and\n3. create a release tag for github and bower.\n\n\n## Acknowledgement\n\nWe used [generator-gulp-angular](https://github.com/Swiip/generator-gulp-angular) for bootstraping our project.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/vega.github.io%2Fvoyager2%2F","html_url":"https://awesome.ecosyste.ms/projects/vega.github.io%2Fvoyager2%2F","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/vega.github.io%2Fvoyager2%2F/lists"}