GithubHelp home page GithubHelp logo

jupyterlab / jupyter-renderers Goto Github PK

View Code? Open in Web Editor NEW
485.0 33.0 78.0 5.47 MB

Renderers and renderer extensions for JupyterLab

License: BSD 3-Clause "New" or "Revised" License

TypeScript 11.74% CSS 0.59% Jupyter Notebook 23.68% Shell 0.02% JavaScript 0.21% Python 0.33% HTML 63.44%
jupyterlab plotly geojson katex fasta vega vega-lite jupyterlab-extension

jupyter-renderers's Introduction

Jupyter Renderers

Github Actions Status Binder

This is a monorepo that consists of JupyterLab mimerender extensions for common file and MIME types.

Packages

Name Mime types File extensions Info
fasta-extension application/vnd.fasta.fasta .fasta Version
geojson-extension application/geo+json .geojson, .geo.json Version
katex-extension N/A N/A Version
mathjax2-extension N/A N/A Version
vega3-extension application/vnd.vega.v3+json, application/vnd.vegalite.v2+json .vg, .vl, .vg.json, .vl.json, .vega, .vegalite Version

Looking for plotly-extension?

@jupyterlab/plotly-extension is being deprecated. Please use the Plotly-supported jupyterlab-plotly. See the plotly.py README for more info.

Install

With JupyterLab 3.0 and above, it is possible to install the prebuilt extensions with pip:

pip install jupyterlab-fasta
pip install jupyterlab-geojson
pip install jupyterlab-katex
pip install jupyterlab-mathjax2
pip install jupyterlab-vega3

Contributing

If you would like to contribute to the project, please read our contributor documentation.

JupyterLab follows the official Jupyter Code of Conduct.

Requirements

Install

The jlpm command is JupyterLab's pinned version of yarn that is installed with JupyterLab. You may use yarn or npm in lieu of jlpm below.

# Clone the repo to your local environment
git clone https://github.com/jupyterlab/jupyter-renderers.git
cd jupyter-renderers

# install the fasta extension
cd packages/fasta-extension

# Install package in development mode
pip install -e .

# Link your development version of the extension with JupyterLab
jupyter labextension develop . --overwrite

# Rebuild the extensions TypeScript source after making changes
jlpm run build

Rebuilding extensions

After making changes to the source packages, the packages must be rebuilt:

# Rebuild all the extensions at once
jlpm run build

# To rebuilt a particular extension, for example the fasta extension
cd packages/fasta-extension
jlpm run build

You may also watch a particular extension directory for changes and automatically rebuild:

# In one terminal tab, watch the jupyter-fasta directory
cd packages/fasta-extension
jlpm run watch

# Run JupyterLab in another terminal
jupyter lab

Publishing packages

Build all Python packages:

rm -rf dist/*
jlpm build-py
twine upload dist/jupyterlab*

Creating icons

To create a JupyterLab icon for a new MIME or file type, you can use the Sketch file in this repo or fork the file on Figma and export your icon as an SVG. See the GeoJSON icon for reference.

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.