arcevo/README.md

Como isso aparece na tela?

O Gitea vai desenhar uma caixa amarela/branca (estilo UML) com o título "Ficha_Tecnica" e uma lista organizada dentro, separada por linhas finas. É muito mais bonito que uma lista vertical simples e parece um "Cartão de Banco de Dados".

Vantagens:

1. Digitação: Você só escreve Chave : Valor. Zero barras |, zero alinhamento.
2. Visual: Cria um elemento gráfico destacado.
3. Horizontalidade: Se você quiser dividir em dois blocos lado a lado, o Mermaid permite!

---

Quer dividir em colunas? (Visualização Horizontal)

Se você quer ver os dados de "Identidade" de um lado e "Arquivos" do outro, use este código:

classDiagram
    direction LR
    %% Isso cria uma seta invisível para forçar a horizontalidade
    Identidade --|> Arquivos : contem
    
    class Identidade {
       ID : RTJ-0042
       Origem : Congo
       Material : Osso
    }
    
    class Arquivos {
       3D : .glb
       Foto : .jpg
       Licenca : CC-BY
    }

     class Colecoes {
       Egito : .glb
       Antiguidade : .jpg
     

O Resultado: Dois cartões lado a lado.

Como o Python lê isso?

É trivial. O Python ignora que é um diagrama e lê o texto dentro do bloco mermaid.

import re

def ler_ficha_mermaid(caminho):
    with open(caminho, 'r') as f:
        texto = f.read()
    
    # Procura por linhas com "Palavra : Valor" dentro do bloco mermaid
    dados = {}
    for linha in texto.splitlines():
        if ":" in linha and "class" not in linha and "mermaid" not in linha:
            chave, valor = linha.split(":", 1)
            dados[chave.strip()] = valor.strip()
    
    return dados