Publicar artigos no Bitbucket

Conecte o Bitbucket uma vez e você poderá publicar qualquer artigo do Clevera em um repositório do Bitbucket como um arquivo Markdown, pronto para um site de documentação ou uma docs/ pasta ao lado do seu código. Este artigo aborda a conexão, a escolha do repositório e da pasta, a aparência do arquivo e como as atualizações funcionam.

Antes de começar#

• Plano: a publicação no Bitbucket faz parte dos planos Pro e Custom. Nos planos Free e Starter, a aba Publicar exibe "A publicação em suas ferramentas está incluída no Pro". Veja Escolher um plano.
• Função no Clevera: apenas o proprietário do workspace ou um Administrador pode conectar ou desconectar o Bitbucket. Uma vez conectado, qualquer pessoa que possa editar um artigo pode publicá-lo.
• Apenas Bitbucket Cloud: o Clevera conecta-se ao bitbucket.org. O Bitbucket Data Center e Server não são suportados.
• Acesso no Bitbucket: a conta que realiza a conexão deve ter permissão para contribuir nos repositórios nos quais você deseja publicar, com acesso de escrita à branch principal.
• Um artigo: você publica o artigo que pertence a um vídeo ou gravação. Gere-o primeiro; veja Transformar uma gravação em um artigo.

A publicação não utiliza créditos.

Conectar o Bitbucket#

1. Abrir Integrações#

   Na barra lateral, abra o menu do workspace e escolha Integrações. Encontre o Bitbucket em Integrações disponíveis (ou na aba Desenvolvimento) e clique em Conectar.

2. Conceder acesso no Bitbucket#

   Faça login no Bitbucket, caso ainda não tenha feito. O Bitbucket solicitará que você conceda acesso ao Clevera:

   Permissão do Bitbucket	Por que
   Conta: leitura	Para exibir seu nome do Bitbucket no Clevera
   Repositórios: leitura	Para listar repositórios e verificar se um arquivo já existe
   Repositórios: escrita	Para fazer commit do arquivo Markdown e suas imagens

   Clique em Conceder acesso.

3. Verificar a conexão#

   Você retornará para Integrações com a mensagem "Bitbucket conectado com sucesso a" seguida pelo seu nome no Bitbucket. O Bitbucket será movido para a lista Conectado com um selo Conectado. Antes de publicar qualquer coisa, a mensagem exibida será "Nada publicado ainda".

Publicar um artigo#

1. Abrir a aba Publicar#

   No editor, clique em Compartilhar e abra a aba Publicar. Em Publicar o artigo, clique no bloco Bitbucket em Pronto para publicar.

   O artigo é publicado no idioma que você está usando no editor. Alterne o idioma na barra superior primeiro para publicar uma tradução.

2. Escolher o repositório e a pasta#

   Em Onde será publicado, escolha:

   Campo	O que escolher	Notas
   Repositório	O repositório do Bitbucket para o arquivo	Repositórios nos quais você pode contribuir, em seus workspaces do Bitbucket, com os atualizados mais recentemente primeiro. O primeiro é selecionado para você
   Pasta	Um caminho como docs ou articles/guides	"O arquivo Markdown é criado aqui. Deixe vazio para a raiz do repositório." Começa como docs. Pastas que ainda não existem são criadas

   O Clevera lembra o que você escolheu para a próxima vez.

   

3. Publicar#

   Clique em Publicar no Bitbucket. Você verá "Procurando uma cópia existente no Bitbucket", seguido de Escrevendo a página. Quando terminar, você verá "Publicado no Bitbucket." Clique em Abrir no Bitbucket para ver o arquivo.

   Você pode fechar a janela Compartilhar enquanto o processo é executado; uma notificação informará quando estiver concluído.

Onde o arquivo vai parar#

• Branch: a branch principal do repositório (geralmente main ou master). O Clevera faz o commit diretamente nela; ele não abre um pull request e você não pode escolher outra branch.
• Nome do arquivo: o título em letras minúsculas, com espaços transformados em hifens, terminando em .md. "Create your first invoice" torna-se create-your-first-invoice.md. Títulos em outros alfabetos ou com acentos são escritos primeiro em letras latinas ("Créer une facture" torna-se creer-une-facture.md). Um título sem nada para converter, como um feito apenas de emojis, recebe um código fixo curto (article- mais 8 caracteres). Nomes são cortados em 80 caracteres.
• Imagens: as capturas de tela do artigo vão para assets/<file name>/ dentro da mesma pasta, no mesmo commit.
• Mensagem de commit: Add article: <title>, ou Update article: <title> quando você atualiza um arquivo existente.
• Autor do commit: a conta do Bitbucket que conectou a integração.

Restrições de branch#

Se o repositório tiver uma restrição de branch na sua branch principal (por exemplo, alterações apenas via pull requests, ou escritas limitadas a certas pessoas), o commit do Clevera será recusado, por exemplo, com "Você precisa de acesso de escrita para fazer commit neste repositório do Bitbucket." Adicione a conta conectada às pessoas que podem escrever na branch em Configurações do repositório → Restrições de branch, ou publique em um repositório sem essa regra.

Como o arquivo fica#

O Clevera escreve Markdown simples que a visualização de arquivos do Bitbucket pode exibir, com um pequeno bloco de front matter no topo. Ele não contém HTML bruto, pois o Bitbucket não o renderiza.

---
title: "Create your first invoice"
created_at: "2026-10-12T09:30:00+00:00"
updated_at: "2026-10-12T10:05:00+00:00"
source: "Clevera"
---

O vídeo do qual o artigo se originou não é adicionado ao arquivo. Um vídeo do Clevera colocado dentro do artigo torna-se um link para seu player, apenas quando o link de compartilhamento desse vídeo estiver ativado. Veja Exibir um vídeo em um artigo.

Imagens#

As capturas de tela são commitadas no seu repositório ao lado do arquivo, e o Markdown faz o link para elas por caminho relativo (assets/<file name>/…). Elas continuam funcionando sem o Clevera, e em um repositório privado elas permanecem tão privadas quanto o restante dele.

Um arquivo de vídeo que você carregou no artigo não é commitado. Ele permanece um link para o Clevera que expira após algum tempo; publique novamente para renová-lo.

Usar com um site de documentação#

Se um gerador de site estático (como MkDocs, Docusaurus ou Hugo) constrói sua documentação a partir do repositório, aponte a Pasta para a pasta que ele lê. Cada publicação é um commit normal, então o Bitbucket Pipelines ou suas outras execuções de build funcionam como de costume. A maioria dos geradores lê title do front matter e ignora campos que não conhece.

Atualizar um artigo que você já publicou#

A publicação é um processo de mão única. As edições que você faz no Clevera permanecem no Clevera até que você publique novamente, e as alterações feitas no arquivo no Bitbucket nunca retornam ao Clevera.

Ao publicar no mesmo repositório e pasta, o Clevera encontra o arquivo com o mesmo nome e exibe "Este artigo já está no Bitbucket." Clique em Visualizar para abrir o arquivo existente, então escolha:

Se o título mudou no Clevera, o nome do arquivo também muda, então a publicação cria um novo arquivo ao lado do antigo. Exclua ou renomeie o arquivo antigo no Bitbucket você mesmo. Nada no Clevera exclui arquivos do seu repositório.

Desconectar o Bitbucket#

1. Abra Integrações, clique no menu ⋯ na linha do Bitbucket e escolha Desconectar (ou clique em Bitbucket e depois em Desconectar).
2. Confirme. "Você não pode mais publicar nele a partir do editor. O conteúdo que você já publicou permanece no Bitbucket."

Desconectar exclui os tokens do Clevera. Para revogar o acesso do Clevera no Bitbucket também, abra suas Configurações pessoais do Bitbucket, vá para Autorizações de aplicativos e revogue o Clevera.

Solução de problemas#

Relacionado#