Use o admin do EmDash para levar uma entrada do primeiro rascunho a uma página publicada. O editor mantém as alterações do rascunho separadas da versão que os visitantes podem ver, de modo que salvar e publicar são duas ações distintas.
Abrir uma coleção
Abra /_emdash/admin no seu site e entre. Selecione uma coleção, como Posts ou Pages,
na barra lateral.
A página da coleção lista suas entradas. Daqui você pode:
- selecionar Add New para criar uma entrada;
- pesquisar pelo título da entrada, slug e campos marcados como searchable;
- filtrar por estado de publicação, autor, byline, data e locale;
- selecionar entradas para publicação em massa, retorno ao rascunho ou envio para a Lixeira; e
- abrir Trash para restaurar ou excluir permanentemente uma entrada.
Os campos e os recursos de publicação disponíveis no editor dependem do modelo de conteúdo da coleção. Por exemplo, uma coleção pode oferecer suporte a revisões, prévias, taxonomias ou busca.
Criar e publicar uma entrada
-
Selecione Add New na página da coleção.
-
Preencha os campos obrigatórios. Se a coleção tiver um campo de título, o EmDash o usa para sugerir um slug. Você pode editar o slug antes de publicar.
-
Adicione o corpo e quaisquer campos de apoio, como um trecho, imagem em destaque, byline, categorias ou tags.
-
Selecione Save. O primeiro salvamento cria a entrada como rascunho e abre sua URL permanente do editor.
-
Revise o rascunho. Se a coleção oferecer suporte a prévias, selecione Preview para ver a página renderizada antes de publicar.
-
Selecione Publish now e confirme. O rascunho salvo se torna a versão live que as consultas de conteúdo públicas retornam.
A entrada tem um ID de conteúdo estável e um slug separado. O ID continua a identificar a mesma entrada
se o slug mudar. Templates normalmente usam o identificador voltado à URL retornado por
getEmDashCollection(); o guia Consultar conteúdo
explica ambos os valores.
Escrever texto rico
Campos Portable Text fornecem um editor de blocos para títulos, parágrafos, citações, listas, links, imagens, galerias, blocos de código, tabelas, blocos HTML e seções reutilizáveis. Plugins instalados podem adicionar mais blocos.
Use a barra de ferramentas para formatar o texto selecionado. Para inserir um bloco, selecione o controle de adicionar bloco ao lado
de um parágrafo ou digite / e pesquise um bloco pelo nome. Blocos de imagem e galeria abrem o mesmo seletor de
mídia usado pelos campos de imagem.
Quando você seleciona um bloco de imagem, suas configurações permitem substituir ou remover esse uso da imagem e definir seu tamanho de exibição, alinhamento, texto alt, legenda e tooltip opcional. Edit asset abre o item subjacente da biblioteca de mídia, onde alterar ou substituir o asset pode afetar outras entradas que o usam. Veja Biblioteca de mídia para essa distinção.
Salvar alterações do rascunho
Após o primeiro salvamento, o editor salva automaticamente as alterações dois segundos depois que você para de digitar. O botão Save passa por Saving… até Saved para que você possa confirmar que o servidor aceitou o rascunho. O salvamento automático substitui a revisão de salvamento automático atual em vez de preencher o histórico de revisões com um checkpoint a cada pausa.
Selecione Save quando quiser que um ponto da sequência de edição permaneça no histórico de revisões. Se um salvamento falhar, o editor mantém os campos não salvos e mostra o erro. Não saia da página até o botão voltar a Saved ou você ter copiado o trabalho não salvo para outro lugar.
Para uma entrada publicada, salvar alterações atualiza apenas o rascunho. Os visitantes continuam a receber a revisão live anterior. Use Preview draft para verificar a versão pendente, Live View para verificar a versão pública e Publish changes quando o rascunho estiver pronto para substituí-la.
Alterar o slug de uma entrada publicada segue o mesmo fluxo de rascunho. A URL pública muda quando você publica o rascunho, não quando o salvamento automático é executado.
Trabalhar com outro editor
Abrir uma entrada toma um bloqueio de edição para essa entrada e locale. Se outra pessoa já a tiver aberta, o EmDash identifica o titular do bloqueio e oferece duas opções:
- Open read-only mostra a entrada sem aceitar edições, para que você não digite trabalho que será descartado.
- Take over dá a você o bloqueio. A outra pessoa mantém o que digitou, mas em dois minutos o editor dela informa que você detém a entrada. O próximo salvamento dela é recusado.
O bloqueio é renovado enquanto a entrada está aberta e liberado quando você sai do editor ou fecha a aba. Se o navegador ou o computador fechar sem liberá-lo, o bloqueio expira sete minutos após sua última renovação.
Os bloqueios são independentes para cada locale, de modo que duas pessoas podem editar traduções diferentes da mesma entrada. Um script ou cliente de API também é recusado enquanto outro editor detém o bloqueio, a menos que use o override documentado. Veja Bloqueio de edição de entrada para o comportamento completo da API.
Um administrador pode desativar o bloqueio de uma coleção em Content Types, depois a coleção, depois Edit locking.
Publicar ou agendar alterações
Publicar e agendar usam controles separados:
- Publish now torna um novo rascunho live após a confirmação.
- Publish changes torna live as alterações pendentes de uma entrada publicada após a confirmação.
- Schedule define quando uma nova entrada ou alterações pendentes se tornam live.
- Change schedule atualiza um agendamento existente.
- Remove schedule cancela um agendamento existente.
- Unpublish remove a revisão live das consultas públicas, cancela qualquer agendamento e mantém um rascunho editável.
Para agendar uma entrada, salve-a primeiro, selecione Schedule abaixo do resumo de publicação e escolha uma data e hora futuras. O editor exibe o fuso horário usado para o agendamento. Até esse momento, a revisão live atual permanece pública; para uma nova entrada, ainda não há nada público.
Implantações Node.js executam a varredura de publicação agendada automaticamente. Cloudflare Workers exigem um Cron Trigger. Os modelos iniciais do Cloudflare o incluem; implantações existentes podem seguir Publicação agendada para verificar o gatilho.
Restaurar uma revisão
Coleções com suporte a revisões mostram Revisions no painel de configurações. Expanda-o para ver versões salvas e os campos que mudaram entre elas. Selecione uma revisão para inspecionar seu conteúdo e então selecione Restore se quiser usar essa versão de novo.
Restaurar cria uma nova revisão contendo o conteúdo selecionado. Não apaga as revisões anteriores, de modo que você ainda pode inspecionar a sequência completa depois.
Traduzir uma entrada
Quando a internacionalização está habilitada, o painel Translations mostra os locales configurados para a entrada atual.
-
Abra a entrada de origem e encontre Translations no painel de configurações.
-
Selecione Translate para um locale que ainda não tenha uma entrada.
-
Edite o título, slug, corpo e outros campos traduzíveis copiados.
-
Selecione Save e então publique ou agende a tradução quando estiver pronta.
Cada tradução tem seu próprio slug, estado de publicação, agendamento e histórico de revisões. Use o seletor de locale na página da coleção para ver um idioma de cada vez.
Mover conteúdo para a Lixeira
Abra as ações de uma entrada ou selecione uma ou mais linhas na página da coleção e então escolha Move to Trash. Entradas na lixeira deixam de aparecer em consultas ordinárias de conteúdo, mas permanecem disponíveis na aba Trash da coleção.
Em Trash, selecione Restore para devolver uma entrada à coleção. Uma entrada restaurada volta como rascunho sem agendamento. Publique-a para torná-la pública.
Automatizar o trabalho de conteúdo
A API REST e a CLI do EmDash oferecem suporte ao mesmo fluxo de rascunho e publicação. Campos de coleção pertencem
ao objeto data da solicitação. Uma atualização salva uma revisão de rascunho; publicar é uma ação separada.
Passe o valor _rev mais recente ao atualizar ou publicar para que o servidor rejeite uma gravação obsoleta em vez
de substituir trabalho mais recente.
Use a referência do ciclo de vida do conteúdo para transições de estado, permissões, conflitos e hooks. A referência da API REST define corpos de solicitação e resposta, e a referência da CLI cobre comandos de terminal equivalentes.
Continue com Consultar conteúdo para renderizar entradas publicadas em um site Astro, ou Biblioteca de mídia para adicionar e gerenciar arquivos reutilizáveis.