Skip to content

Commit

Permalink
Merge pull request #43 from willingc/legacy
Browse files Browse the repository at this point in the history
Move monorepo install instructions to LEGACY
  • Loading branch information
willingc authored Jun 4, 2021
2 parents f065e7b + a4f7573 commit 2f05213
Show file tree
Hide file tree
Showing 2 changed files with 51 additions and 50 deletions.
51 changes: 51 additions & 0 deletions LEGACY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# Legacy (Do not use today)

## Installation Instructions

### 1. Setup the monorepo

Navigate to the base directory of the repo and install all dependencies

```bash
yarn
```

### 2. Setup Jupyter Extension

**_Note: this requires Python >= 3.6_**

Now, install the Python package

```bash
cd applications/jupyter-extension
pip install -e .
jupyter serverextension enable nteract_on_jupyter
```

### 3. Build JS assets and run a Jupyter server with hot reloading

First we need to run the webpack server to live reload javascript and html assets. Anywhere in the nteract repository, run

```bash
npx lerna run hot --scope nteract-on-jupyter --stream
```

In another terminal, go to the directory that you want to run notebooks from and run

```bash
jupyter nteract --NteractConfig.asset_url="http://localhost:8080/"
```

The --NteractConfig.asset_url flag tells the Jupyter server where the webpack server will be serving the assets.

Once the assets have been built, you won't need to refresh the page, but you may need to manually refresh the page if it loads before the assets are built.

### 4. Initialize data explorer in the notebook

In the notebook launched from step 3, run the following code in a cell before anything else :arrow_down:

```python
import pandas as pd
pd.options.display.html.table_schema = True
pd.options.display.max_rows = None
```
50 changes: 0 additions & 50 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,54 +49,4 @@ import { DataExplorer, Toolbar, Viz } from "@nteract/data-explorer";

For expedited development, you can run `npm run styleguide` and the data explorer documentation will be run live locally and you can experiment with the settings and data.

## Installation

### 1. Setup the monorepo

Navigate to the base directory of the repo and install all dependencies

```bash
yarn
```

### 2. Setup Jupyter Extension

**_Note: this requires Python >= 3.6_**

Now, install the Python package

```bash
cd applications/jupyter-extension
pip install -e .
jupyter serverextension enable nteract_on_jupyter
```

### 3. Build JS assets and run a Jupyter server with hot reloading

First we need to run the webpack server to live reload javascript and html assets. Anywhere in the nteract repository, run

```bash
npx lerna run hot --scope nteract-on-jupyter --stream
```

In another terminal, go to the directory that you want to run notebooks from and run

```bash
jupyter nteract --NteractConfig.asset_url="http://localhost:8080/"
```

The --NteractConfig.asset_url flag tells the Jupyter server where the webpack server will be serving the assets.

Once the assets have been built, you won't need to refresh the page, but you may need to manually refresh the page if it loads before the assets are built.

### 4. Initialize data explorer in the notebook

In the notebook launched from step 3, run the following code in a cell before anything else :arrow_down:

```python
import pandas as pd
pd.options.display.html.table_schema = True
pd.options.display.max_rows = None
```

### Now you are ready to contribute :tada:

0 comments on commit 2f05213

Please sign in to comment.