O editor

Incorporando um circuito em outro site

Coloque um projeto salvo, rodando, dentro de um post de blog, um site de turma ou um README, com o código da linha Incorporar da tela de compartilhamento.

Pegar o código

  1. Entre na sua conta e salve o projeto. Uma incorporação aponta para um projeto da sua conta, então um projeto guardado só neste navegador não pode ser incorporado.
  2. Aperte Compartilhar e depois Incorporar no rodapé da folha.
  3. Defina o tamanho e as opções. A prévia abaixo delas é a própria incorporação.
  4. Escolha HTML, Markdown ou Link, aperte Copiar código e cole na sua página.

Uma incorporação precisa de um projeto que qualquer pessoa com o link possa abrir. Num projeto privado seu, a linha Incorporar diz o que ela fará antes: Abre para qualquer pessoa com o link e depois copia o código. Compartilhar um link é grátis em todos os planos. Sem sessão iniciada, a linha diz Com uma conta grátis e pede para você entrar. Um aluno de uma turma não pode incorporar: projetos da turma ficam privados.

As opções

Opção Escolhas
Espessura Largura da coluna (o padrão), 480, 600 ou 800 px
Altura (px) 200 a 1200; 400 por padrão
Tema Sistema do leitor, Claro ou Escuro
Abre em O circuito, O código, ou Ambos, lado a lado
Código abre em O arquivo principal ou outra aba, para um projeto com vários arquivos
Começar a rodar quando entrar na tela Ligado por padrão
Esconder o código Desligado por padrão; ligado, a aba Código desaparece por completo
Mostrar "Remixar no Mokxi" Ligado por padrão

Os três formatos:

  • HTML é um <iframe> para WordPress, Ghost, Notion, o campo de incorporação do Medium e qualquer página web.
  • Markdown é para um README do GitHub, que não mostra frames: uma imagem do projeto que leva à sua página, onde ele roda.
  • Link é o endereço simples da incorporação, para qualquer serviço que incorpora por link.

O HTML fica assim:

<iframe src="https://mokxi.com/embed/abc123" width="100%" height="400"
  style="border:0;max-width:100%;border-radius:8px" loading="lazy"
  title="Traffic light, running in Mokxi"></iframe>

As opções são gravadas no endereço, então você também pode mudá-las à mão: theme=dark, view=code ou view=split, autorun=0, height=480, hideCode=1, start=notes.h e edit=0. Qualquer coisa que a incorporação não entende volta ao padrão, então uma incorporação colada continua funcionando.

O que seus leitores veem

  • O circuito, com um botão Rodar que vira Parar enquanto roda.
  • Abas Circuito e Código, ou ambas lado a lado, a menos que você tenha escondido o código.
  • Remixar no Mokxi, que abre uma cópia própria no editor.

O circuito roda o seu próprio sketch. Quando você abre o criador de incorporação, o Mokxi compila e armazena o programa de cada placa, e a linha embaixo da prévia diz Pronto: a incorporação roda o seu próprio código. Uma placa que não pôde ser compilada mostra Abrir no Mokxi para rodar na incorporação em vez de rodar outra coisa. Aperte Rodar no editor para verificar o sketch e depois abra Incorporar de novo.

A incorporação mostra o circuito rodando. Para apertar os botões dele, ler a saída serial ou mudar o código, o leitor abre no Mokxi.

Com Começar a rodar quando entrar na tela ligado, o circuito inicia assim que o quadro rola até a tela, e o simulador só é baixado nesse momento. Uma página com várias incorporações continua rápida. Um leitor cujo sistema pede menos movimento recebe o botão Rodar.

Planos e o selo

Incorporar está em todos os planos. No Grátis, a incorporação carrega uma linha discreta embaixo do circuito, Feito com Mokxi · Monte o seu. Pro, o preço de estudante e Sala de aula incorporam sem a linha, e o teste do Pro também. O trabalho de um aluno de turma ou de uma criança nunca mostra a linha nem Remixar no Mokxi.

Os projetos prontos também podem ser incorporados, em /embed/example/<name>, por exemplo https://mokxi.com/embed/example/traffic-light. A incorporação de um projeto pronto carrega a mesma linha em todos os sites, menos no próprio Mokxi.

A própria página de um projeto público tem o código de incorporação pronto para copiar, embaixo da lista de componentes: Coloque este circuito na sua página.

Se não funcionar

  • "Este projeto é privado ou não existe mais." O projeto ficou privado ou foi apagado. Volte o nível de acesso dele para Link ou Galeria na folha de compartilhamento e o mesmo código volta a funcionar.
  • "Abrir no Mokxi para rodar" numa placa. O código foi editado e não tem compilação armazenada. Abra o projeto, aperte Rodar e depois abra Compartilhar e Incorporar de novo.
  • O quadro fica em branco num README. O GitHub não mostra frames: use o formato Markdown.
  • As mudanças não aparecem. A incorporação mostra o projeto como está salvo agora. Salve e depois recarregue a página com a incorporação.