Assets

O plugin Assets gerencia os arquivos de uma raiz que não são markdown: um PDF, um diagrama, uma captura de tela, um arquivo de dados. Eles vivem em toda pasta que o Framework (a estrutura) declara como do plugin (assets/ por padrão), e o plugin os lista, linka cada um aos Blueprints (os planos) e tarefas a que pertence, encontra os lugares que o referenciam e o move ou remove através do anfitrião para que o histórico e os links sigam. Desligado por padrão; eidos plugin enable assets o liga e declara a pasta.

Links e referências

Um link é declarado: este arquivo pertence a estes Blueprints (pelo id permanente), estas tarefas (por nome) e estas URLs. Os links vivem no índice do plugin, nunca ao lado do arquivo e nunca dentro de um Blueprint. Uma referência é encontrada: o corpo de um Blueprint ou de uma tarefa que carrega o caminho do arquivo. As referências são calculadas a cada leitura e não são escritas em lugar nenhum. Um arquivo sem registro e sem referência ainda é listado.

No navegador

• Assets, uma atividade na barra de atividades: as pastas e os seus arquivos, com um upload por pasta e filtros. Os arquivos são uma tabela sob /p/assets, com abrir, renomear e remover em uma linha.
• Uma página por arquivo: uma imagem mostrada como imagem, um PDF lido na página com um link para fora, qualquer outro arquivo como o seu nome, tipo e tamanho com Open no editor externo e Reveal no gerenciador de arquivos; seu título, descrição e links (os Blueprints e tarefas oferecidos enquanto você digita), e suas referências linkadas ao seu lugar.
• Attached assets, uma visão na barra lateral auxiliar: os arquivos linkados ao Blueprint aberto ou que o referenciam, a contagem na sua aba e um jeito de linkar outro.
• No editor, o menu de blocos oferece Image e File a partir de um seletor: ![…](…) incorpora uma imagem, […](…) linka um arquivo, como o markdown faz. Uma imagem colada cai na pasta de assets e no texto, redimensionada para max_image_size na entrada. O Quick Open responde arquivos por nome.

Em disco

• assets/ (ou qualquer pasta declarada owned_by: "@assets/files"): os arquivos em si, aninhados, dotfiles ignorados. A raiz →
• .eidos/plugins/assets/index.yaml: um registro por arquivo que tenha um, indexado pelo seu caminho a partir da raiz: title, description e links.
• .eidos/plugins/assets/settings.yaml, partilhado: max_file_size (megabytes, 6 por padrão), o maior arquivo que a página aceita e add escreve; max_image_size (pixels, 2000 por padrão, 0 para sem limite), o lado mais longo que uma imagem mantém.

A partir do shell

eidos assets                                    # every file per folder, with its links and reference count
eidos assets --for login                        # the files linked to one blueprint; --folder, --json
eidos assets show assets/login-flow.png         # its links (missing where the target is gone) and references
eidos assets add ~/Desktop/login-flow.png --to @login   # copied in; --folder, --name
eidos assets link assets/login-flow.png --to task:rate-limit-the-login-form --drop https://…
eidos assets set assets/login-flow.png --title "Login flow" --name login-flow-v2.png
eidos assets remove assets/login-flow.png

Um link é @<blueprint-id>, task:<name> ou uma URL. set --name move o arquivo através do anfitrião (git mv onde o Git está ligado) e reescreve todo corpo de Blueprint e de tarefa que nomeava o caminho antigo; remove o remove através do anfitrião e descarta o seu registro. Nunca renomeie ou exclua à mão um arquivo em uma pasta de assets.

Para anexar um diagrama a um Blueprint: adicione o arquivo, linke-o (--to @<id>) e linke para ele a partir do corpo do Blueprint como link relativo onde ele é discutido.

O que a verificação relata

assets/link-missing (um link para um Blueprint ou uma tarefa que a raiz não tem) e assets/record-orphaned (um registro de um arquivo que sumiu; Drop record o corrige). Com o plugin desligado, as pastas continuam declaradas e intocadas, nenhum arquivo é lido e nenhuma rota responde.