Create, edit, share, and publish scientific and technical documents.
MIT License
curvenote
Create, edit, share and publish scientific documents.
curvenote
is an open source library and command line interface (CLI) to create share and publish technical documents.
In addition to being completely local, curvenote
can optionally sync content to https://curvenote.com to allow you to work with collaborators who enjoy WYSIWYG editing, commenting & real time collaboration for technical documents.
Curvenote is available through Node and NPM. Unless you already have this on your system you will have to install NodeJS. See full install instructions in the docs!
npm install -g curvenote
curvenote init
curvenote start
curvenote deploy
Curvenote allows you to easily create, edit, and publish content to the web as a fast, optimized site with interactive citations, cross-referencing, math, and dynamic figures from Jupyter Notebooks.
Curvenote can be used to create all sorts of open-access content, click the links below to see some examples!
The default website you create can have interactive Jupyter Notebook features, and live-preview of cross-references and citations.
PhD Thesis with linked references, equations, and export to PDF.
Interactive Papers with Jupyter Notebooks and interactive visualizations.
These interactive scientific sites can be easily deployed on a hosting service called curve.space or can also be hosted on your own custom domain.
The client library is entirely local, and rebuilds in ~50ms for most projects. Meaning you can preview your content as you are writing!
First login, see authentication docs to get an API token.
curvenote token set
> YOUR_API_TOKEN
Then you can directly export your curvenote documents to:
curvenote export docx https://curvenote.com/@curvenote/blog/communicating-science communicating-science.docx
curvenote export md https://curvenote.com/@curvenote/blog/version-control-for-scientists version-control.md
curvenote export tex https://curvenote.com/@curvenote/blog/version-control-for-scientists version-control.tex -template plain_latex
curvenote export pdf https://curvenote.com/@curvenote/blog/version-control-for-scientists version-control.pdf -template arxiv_nips
All dependencies for curvenote
are included in this repository (a monorepo!).
curvenote
uses npm as a package manager. It includes the following packages/apps:
Apps:
curvenote
: the Curvenote command line interface (CLI)curvespace
: the web-experience for Curvenote sites, using RemixPackages:
ui-providers
: React providers for references and site configurationmyst-to-react
: expose MyST content as an article, built with Reactsite
: components and utilities for building React and Remix sitesicons
: icons used throughout our projects, built for Reactcitation-js-utils
: utilities for using the citation-js libraryeslint-config-custom
: eslint
configurationstsconfig
: tsconfig.json
s used throughout the monorepoEach package and app is 100% TypeScript.
Curvenote uses changesets to document changes to this monorepo, call npx changeset
and follow the prompts. Later, npm run version
will be called and then npm run publish
.
curvenote
is built and developed using:
To build all apps and packages, run the following command:
cd curvenote
npm run build
To develop all apps and packages, run the following command:
cd curvenote
npm run dev