platypus

This repository is home of the new Qiskit Textbook (beta).

The previous version of the Qiskit Textbook textbook can be found here.

The textbook is intended for use as a university quantum algorithms course supplement as well as a guide for self-learners who are interested in learning quantum programming.

Tools & technologies

• Python - interpreted, interactive, object-oriented programming language
• Jupyter Notebooks - documents containing interactive code and rich text
• Node.js - JavaScript runtime
• Mathigon Studio - platform for highly interactive online courses
• Typescript - JavaScript with syntax for types
• Vue 3 - framework for building user interfaces
• Sass/SCSS - stylesheet language
• Cypress - front end testing tool

Getting Started

Pre-requisites

1. Python (3.6 or later) environment with textbook_converter requirements installed

   $ cd platypus/converter/textbook-converter
   $ pip install -r requirements.txt -r requirements-test.txt
   

2. Node.js (14.0 or later)

Setup

$ cd platypus
$ npm install
$ npm run build
$ npm start

To watch changes and rebuild automatically run with npm run watch after installing the dependencies.

After the application has started, access the site at: http://localhost:8080/

You can specify the port setting the env variable PORT. For instance PORT=5000 npm start.

Contribution Guidelines

If you'd like to contribute to Qiskit Textbook (beta), please take a look at our contributors guide and code of conduct

License

The materials and associated source code of this open-source textbook are licensed under Apache License 2.0.