Diagrama Kanban
O quadro kanban do Mermaid permite criar uma representação visual das tarefas em diferentes estágios do fluxo de trabalho; a seguir, explica-se como usar corretamente a sintaxe do quadro kanban.
Básico
O quadro kanban começa com a sintaxe kanban e, em seguida, define as colunas e as tarefas dessas colunas.
Copiar
Incorporar
kanban
column1[Column Title]
task1[Task Description]
Definir colunas
As colunas representam os diferentes estágios do fluxo de trabalho, como "a fazer", "em andamento", "concluído" etc. Cada coluna é definida com um identificador único e um título entre colchetes.
Sintaxe:
Copiar
Incorporar
columnId[Column Title]
- columnId: o identificador único da coluna.
- [Column Title]: o título exibido no cabeçalho da coluna.
比如 id1[Todo]
Adicionar tarefas às colunas
As tarefas são exibidas em suas respectivas colunas, com indentação. Cada tarefa inclui um identificador único e uma descrição entre colchetes.
Sintaxe:
Copiar
Incorporar
taskId[Task Description]
taskId: o identificador único da tarefa.,[Task Description]: a descrição da tarefa.
Exemplo:
Copiar
Incorporar
docs[Create Documentation]
Adicionar metadados às tarefas
Você pode adicionar metadados extras a cada tarefa usando a sintaxe @{ ... }. Os metadados podem conter pares chave-valor como assigned, ticket, priority etc., que serão exibidos na renderização do nó.
Chaves de metadados suportadas
Responsável: especifica quem é responsável pela tarefa.,Ticket: vincula a tarefa a um ticket ou número de problema.,Prioridade: indica a urgência da tarefa. Valores permitidos: muito alta, alta, baixa e muito baixa.
Copiar
Incorporar
kanban
todo[Todo]
id3[Update Database Function]@{ ticket: MC-2037, assigned: 'knsv', priority: 'High' }
Opções de configuração
Você pode personalizar o quadro kanban com um bloco de configuração no início do arquivo markdown. Isso é útil para definir configurações globais (como a URL base dos tickets). Atualmente, o quadro kanban <code>ticketBaseUrl</code> Isso é muito útil para definir configurações globais, como a URL base dos tickets. Atualmente, o quadro kanban tem uma opção de configuração: ticketBaseUrl. Isso pode ser definido conforme o exemplo a seguir:
Copiar
Incorporar
---
config:
kanban:
ticketBaseUrl: 'https://yourproject.atlassian.net/browse/#TICKET#'
---
Quando uma entrada do kanban tem um número de ticket especificado, o número do ticket no diagrama incluirá um link para o sistema externo que define esse ticket. A configuração ticketBaseUrl aponta para a URL base do sistema externo, e #TICKET# é substituído pelo valor do ticket nos metadados da tarefa, para criar um link válido.
Exemplo completo
A seguir está um exemplo completo de código de quadro kanban:
Copiar
Incorporar
---
config:
kanban:
ticketBaseUrl: 'https://mermaidchart.atlassian.net/browse/#TICKET#'
---
kanban
Todo
[Create Documentation]
docs[Create Blog about the new diagram]
[In progress]
id6[Create renderer so that it works in all cases. We also add some extra text here for testing purposes. And some more just for the extra flare.]
id9[Ready for deploy]
id8[Design grammar]@{ assigned: 'knsv' }
id10[Ready for test]
id4[Create parsing tests]@{ ticket: MC-2038, assigned: 'K.Sveidqvist', priority: 'High' }
id66[last item]@{ priority: 'Very Low', assigned: 'knsv' }
id11[Done]
id5[define getData]
id2[Title of diagram is more than 100 chars when user duplicates diagram with 100 char]@{ ticket: MC-2036, priority: 'Very High'}
id3[Update DB function]@{ ticket: MC-2037, assigned: knsv, priority: 'High' }
id12[Can't reproduce]
id3[Weird flickering in Firefox]
Em resumo, criar um quadro kanban no Mermaid é um processo simples que permite visualizar seu fluxo de trabalho com eficácia.
Você pode aprimorar seu diagrama adicionando metadados opcionais às tarefas com a sintaxe @{ ... }; essa sintaxe permite incluir informações de contexto adicionais, como responsável, número do ticket e prioridade. Para personalização adicional, use o bloco de configuração no topo do arquivo para definir opções globais, como ticketBaseUrl, a fim de vincular tickets diretamente a partir do diagrama.
Seguindo estas diretrizes, garantindo identificadores únicos, indentação correta e aproveitando metadados e opções de configuração, você pode criar um quadro kanban abrangente e personalizado que mapeia com eficácia o fluxo de trabalho do projeto.
