NAST

A block-based intermediate representation for document-like content.

Packages

• Stability : Stable > Experimental > Proof of Concept

Development

Clone the repo and cd into it

git clone https://github.com/dragonman225/nast.git && cd nast

Install dependencies

• yarn (required)

  npm i -g yarn
  

  We use yarn to manage package dependencies.

• lerna (required)

  npm i -g [email protected]
  

  This project is a monorepo managed with lerna. If you haven't heard of it before, this tutorial is a good starting point.

• typedoc (optional)

  npm i -g typedoc
  

  typedoc needs to be available in the command-line for reference document generation.

• Graphviz (optional)

  # For Arch Linux
  pacman -S graphviz
  
  # For macOS via Homebrew
  brew install graphviz 
  

  dot needs to available in the command-line for dependency graph generation.

Setup the project

yarn # Install and link dependencies
npx lerna run build # Build all packages

Testing

• Test the overall functionality with npdl.

  Download a Notion page and render it to HTML. Use the CSS theme at packages/nast-util-to-react/src/theme.css.

  node packages/npdl/index.js -i=<notion_page_url> output.html
  

  Use an external theme.

  node packages/npdl/index.js -i=<notion_page_url> --theme=<path_to_css> output.html
  

  Just download a Notion page without rendering to HTML.

  node packages/npdl/index.js -i=<notion_page_url> --tree output.json
  

  npdl has more features, which can be listed with

  node packages/npdl/index.js
  

  You can also install npdl globally.

  cd packages/npdl && npm i -g .
  

• Each package may have its own test suite, which is not covered here.

Contributing to NAST

• Contributing to the project

Troubleshooting

• npx nx graph to check if the packages are correctly linked.
  • If a package is published with a new version, don't forget to update other packages that are using it.