Esta tradução já não está a ser actualizada, por favor visite documento em inglês.

Configurar Monaco

Ambiente: client
Esta função de configuração só será executada no lado do cliente. Verifique a compatibilidade do navegador quando importar pacotes.

Crie o arquivo ./setup/monaco.ts com o seguinte conteúdo:

import { defineMonacoSetup } from '@slidev/types'

export default defineMonacoSetup(async (monaco) => {
  // use `monaco` to configure
})

Saiba mais sobre como configurar o Monaco.

Uso

Para usar o Monaco nos seus slides, simplesmente acrescente {monaco} aos seus blocos de código:

//```js
const count = ref(1)
const plusOne = computed(() => count.value + 1)

console.log(plusOne.value) // 2

plusOne.value++ // error
//```

Para

//```js {monaco}
const count = ref(1)
const plusOne = computed(() => count.value + 1)

console.log(plusOne.value) // 2

plusOne.value++ // error
//```

Exportando

Por padrão, Monaco só vai funcionar no modo dev. Se quiser tê-lo na aplicação SPA exportada, configure isso no seu frontmatter:

---
monaco: true # padrão "dev"
---

Instalação Automática dos Tipos

Quando é usado TypeScript com o Monaco, os tipos para as dependências serão instalados automaticamente no lado do cliente.

//```ts {monaco}
import { ref } from 'vue'
import { useMouse } from '@vueuse/core'

const counter = ref(0)
//```

Neste exemplo acima, verifique que tanto o vue quanto o @vueuse/core estão instalados localmente assim como as dependências / dependências dev, o Slidev vai lidar com o resto para obter os tipos para o editor automaticamente!

Configurar Temas

O tema é controlado pelo Slidev baseado no modo claro/escuro. Se você quiser customizar-lo, é só passar o id do tema na função de configuração:

// ./setup/monaco.ts
import { defineMonacoSetup } from '@slidev/types'

export default defineMonacoSetup(() => {
  return {
    theme: {
      dark: 'vs-dark',
      light: 'vs',
    },
  }
})

Se você quiser carregar temas customizados:

import { defineMonacoSetup } from '@slidev/types'

// change to your themes
import dark from 'theme-vitesse/themes/vitesse-dark.json'
import light from 'theme-vitesse/themes/vitesse-light.json'

export default defineMonacoSetup((monaco) => {
  monaco.editor.defineTheme('vitesse-light', light as any)
  monaco.editor.defineTheme('vitesse-dark', dark as any)

  return {
    theme: {
      light: 'vitesse-light',
      dark: 'vitesse-dark',
    },
  }
})

Se você estiver criando um tema para o Slidev, use o import() dinâmico na função de configuração para obter resultados melhores.