Interactive Layout-Aware Construction of Bespoke Charts
Перейти к файлу
microsoft-github-policy-service[bot] c6d21bdd4e
Auto merge mandatory file pr
This pr is auto merged as it contains a mandatory file and is opened for more than 10 days.
2023-06-27 13:03:40 +00:00
.github GitHub workflow config (#393) 2021-02-02 06:29:21 -08:00
.vscode Run prettify for all files (#290) 2020-07-29 09:54:41 -07:00
docs/images Internal tech documentation (#237) 2020-07-01 06:37:03 -07:00
public Update about 2022-01-28 18:10:45 +03:00
public_test Unify solver interface to create configurable application (#475) 2021-03-30 05:05:58 -07:00
resources/icons Added links arrow property (#912) 2022-02-15 06:22:03 -08:00
sass Fixed 'Show derived fields' icon (#957) 2022-03-09 07:17:23 -08:00
src Reuse hex code from dataset for scales (#1071) 2023-06-02 10:11:18 -07:00
.dockerignore Apply unit testing to the latest master (#747) 2022-01-17 06:11:18 -08:00
.eslintignore Fluent UI (#541) 2021-05-20 08:07:23 -07:00
.eslintrc.js Fluent UI (#541) 2021-05-20 08:07:23 -07:00
.gitignore Fixed legend ordering button 2021-09-03 14:28:22 +03:00
.prettierignore Allow to move panels to right (#332) 2020-10-22 12:01:01 -07:00
Dockerfile Apply unit testing to the latest master (#747) 2022-01-17 06:11:18 -08:00
LICENSE Add licenses (#39) 2018-09-06 12:02:35 -07:00
README.md Internal tech documentation (#237) 2020-07-01 06:37:03 -07:00
SECURITY.md Microsoft mandatory file 2023-06-12 19:05:20 +00:00
THIRD_PARTY.yml Added some basic polish, and added some theming 2018-07-24 17:01:38 -07:00
build.js Apply unit testing to the latest master (#747) 2022-01-17 06:11:18 -08:00
config.template.yml Update Copyright year 2022-01-28 18:00:26 +03:00
config.test.yml Update config test year 2022-01-28 18:12:32 +03:00
header.txt Add licenses (#39) 2018-09-06 12:02:35 -07:00
karma.conf.ts Apply unit testing to the latest master (#747) 2022-01-17 06:11:18 -08:00
package.json Update version (#952) 2022-03-04 07:26:50 -08:00
tsconfig.json Updated tsconfig (#896) 2022-01-19 06:49:56 -08:00
tsconfig.test.json Apply unit testing to the latest master (#747) 2022-01-17 06:11:18 -08:00
tslint.json Fluent UI (#541) 2021-05-20 08:07:23 -07:00
typedoc.json Internal tech documentation (#237) 2020-07-01 06:37:03 -07:00
webpack.config.js Apply unit testing to the latest master (#747) 2022-01-17 06:11:18 -08:00
webpack.config.test.js Apply unit testing to the latest master (#747) 2022-01-17 06:11:18 -08:00
yarn.lock Bump shelljs from 0.8.4 to 0.8.5 2022-02-15 09:13:50 +00:00

README.md

Build Status

Charticulator

Charticulator is a new charting tool that allows you to design charts by interactively specifying constraints.

Project Team

Build

Follow the following steps to prepare a development environment:

Install node modules:

yarn

Copy the template configuration file and edit its contents:

cp config.template.yml config.yml
# (on windows, use copy instead of cp)

Run the following command to build Charticulator, which will create a self contained bundle in the dist folder:

yarn build

Run a local web server to test Charticulator:

# Serve Charticulator at http://localhost:4000
yarn server

# Serve Charticulator publicly at http://0.0.0.0:4000
# Use this if you want to enable access from another computer
yarn public_server

Development

For a live development environment, keep the following command running:

yarn start

This command watches for any change in src/ and sass/, and recompiles Charticulator automatically. Once this up, open http://localhost:4000/ to launch Charticulator. Now when you change the source code, the app can be updated by simply refreshing the browser page (you may need to disable browser cache).

In development mode, there is a test application for UI components, which can be accessed at http://localhost:4000/test.html.

The watch mode won't update when you change the following:

  • config.yml
  • THIRD_PARTY.yml
  • webpack.config.js

When you update these, please do yarn build again.

Sample Datasets

You can add custom sample datasets that can be used with Charticulator. To do so, create a datasets folder at the root of the repository(if it doesn't exist), add your .csv (or .tsv) to that folder, and finally create a files.json file in the folder with the following contents:

[
    {
        "name": "<Your dataset display name>",
        "description": "<Your dataset desription>",
        "tables": [
            {
                "name": "<Your dataset file name without extension>",
                "type": "<csv || tsv>",
                "url": "<Your dataset file name with extension>"
            }
        ]
    }
]

Testing

Charticulator currently include a rudimentary test code:

yarn test

More test cases are needed.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Documentation

Run yarn typedoc to generate documentation pages. The page will be awailable in ./docs/charticulator

Start point of documentation is index page {@link "index"}