Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
quarto-dev
GitHub Repository: quarto-dev/quarto-cli
Path: blob/main/src/resources/create/extensions/engine/README.ejs.md
12923 views

<%= title %> Extension For Quarto

TODO: Add a short description of your extension.

Installing

TODO: Replace the <github-organization> with your GitHub organization.

quarto add <github-organization>/<%= filesafename %>

This will install the extension under the _extensions subdirectory. If you're using version control, you will want to check in this directory.

Developing

This extension is written in TypeScript. The source code is in the src/ directory.

Building

To build the extension, you need to set up the build configuration and then run the build command:

# Build the TypeScript source to JavaScript quarto dev-call build-ts-extension

This will:

  • Type-check your TypeScript code against Quarto's API types

  • Bundle the extension into _extensions/<%= filesafename %>/<%= filesafename %>.js

The built JavaScript file should be committed to version control along with the source.

Optionally, you can create a deno.json to further customize the build:

# First time setup - creates deno.json with import map configuration quarto dev-call build-ts-extension --init-config

Using

TODO: Describe how to use your extension.

Example

Here is the source code for a minimal example: example.qmd.