Implantação no Vercel

Publicamos o pacote @waline/vercel como pacote de servidor, e a implantação no Vercel também é a forma que mais recomendamos.

Como implantar

Vercel

1. Clique no botão azul acima; ele redirecionará você para o Vercel para implantar com o template do Waline.

   Note

   Se você ainda não entrou na sua conta, recomendamos entrar com o GitHub.

2. Informe o nome do seu projeto no Vercel e clique em Create.

   

   Create Project

3. O repositório com o nome que você informou será criado e inicializado automaticamente pelo Vercel com base no template de exemplo do Waline.

   

   new project

   Após um ou dois minutos, o Vercel deve concluir a implantação. Clique no botão Go to Dashboard para ir ao dashboard da sua aplicação.

   

   dashboard

Criar o banco de dados

1. Clique em Storage na parte superior para entrar na página de serviços de armazenamento e escolha Create Database. Em Marketplace Database Providers, selecione Neon e clique em Continue.

   

   storage

2. Você será solicitado a criar uma conta no Neon. Escolha Accept and Create. Em seguida, selecione a configuração do plano do banco de dados, incluindo região e cota. Você pode manter os padrões e clicar em Continue.

   

   neon

3. Defina o nome do banco de dados. Você pode manter o padrão e clicar em Continue.

   

   neon

4. Agora o banco de dados aparece em Storage. Clique nele e escolha Open in Neon para ir ao Neon. No Neon, selecione SQL Editor à esquerda, cole no editor o SQL de waline.pgsql e clique em Run para criar as tabelas.

   

   neon

   

   neon

5. Depois de um curto intervalo, você deve ver uma mensagem de sucesso. Volte ao Vercel, clique em Deployments e então em Redeploy na implantação mais recente para que a nova configuração do banco de dados entre em vigor.

   

   redeploy success

6. O Vercel redirecionará para Overview e iniciará a implantação. Quando STATUS se tornar Ready, clique em Visit para abrir o site implantado. Essa URL é o endereço do seu servidor.

   

   visit

Atribuir um domínio

1. Clique em Settings - Domains para ir à página de configuração de domínio.

2. Informe o domínio que você deseja atribuir e clique no botão Add.

   

   Add domain

3. Adicione um novo registro CNAME no servidor de domínio.

   Tipo	Nome	Valor
   CNAME	example	cname.vercel-dns.com

4. Depois que entrar em vigor, você pode usar seu próprio domínio para visitar o Waline. 🎉

   • Sistema de comentários: example.your-domain.com
   • Painel administrativo: example.your-domain.com/ui

   

   success

Importar via HTML

Configure o seguinte na sua página web:

1. Importe os estilos do Waline de https://unpkg.com/@waline/client@v3/dist/waline.css.
2. Crie uma tag <script> que use init() de https://unpkg.com/@waline/client@v3/dist/waline.js e passe as opções obrigatórias el e serverURL.
   • el é o elemento usado para renderizar o Waline. Pode ser uma string de seletor CSS ou um HTMLElement.
   • serverURL é o endereço do seu servidor obtido na etapa anterior.

<head>
  <!-- ... -->
  <link rel="stylesheet" href="https://unpkg.com/@waline/client@v3/dist/waline.css" />
  <!-- ... -->
</head>
<body>
  <!-- ... -->
  <div id="waline"></div>
  <script type="module">
    import { init } from 'https://unpkg.com/@waline/client@v3/dist/waline.js';

    init({
      el: '#waline',
      serverURL: 'https://your-domain.vercel.app',
    });
  </script>
</body>

Administração de comentários

1. Após a implantação, acesse <serverURL>/ui/register para se cadastrar. O primeiro usuário cadastrado se torna o administrador.
2. Depois de entrar, o administrador pode gerenciar os comentários: editar, marcar ou excluir.
3. Os usuários também podem se cadastrar pela caixa de comentários. Após entrar, eles serão redirecionados para a página de perfil.