Vue 3, TypeScript e Vite. A aplicação fica na raiz do repositório.
Use Node ^22.18.0 || >=24.12.0 e npm:
npm ci
npm run devValidação e build:
npm test
npm run lint:check
npm run build
npm run previewO build gera os dados YAML, verifica tipos, compila o cliente e um bundle SSR temporário em
dist-ssr/, e renderiza as páginas estáticas em dist/. Publique somente dist/.
Não é necessário executar um servidor Node em produção.
Este repositório é matbdev/matbdev: README.md apresenta o perfil em português e
README-en.md oferece a versão em inglês. Este arquivo contém a documentação técnica do site.
Os dois READMEs de perfil são gerados por scripts/profileReadme.ts durante
npm run build:data, npm run dev e npm run build, usando os mesmos dados YAML do portfólio.
Edite os fatos nos módulos correspondentes de metadata/; os títulos e links de apresentação
ficam em profile.content.<idioma>.readme no arquivo metadata/profile.yml.
Depois de editar os YAMLs, execute npm run build:data e inclua os READMEs atualizados no mesmo
commit. npm test verifica se os arquivos continuam sincronizados. O gerador não publica nem
faz commits automaticamente. Os READMEs de perfil não devem ser editados manualmente.
Edite metadata/resumes.yml para ajustar o conteúdo das duas áreas, as traduções,
os projetos selecionados, as habilidades e as premiações. Contato, formação e
certificações vêm dos seus próprios YAMLs. A prévia, o Markdown e os PDFs usam o
mesmo modelo. npm run dev e npm run build geram os quatro PDFs nos URLs existentes.
Os arquivos para publicação ficam em dist/assets/resumes/.
Os arquivos-fonte ficam em src/assets/. O Vite empacota imagens, ícones e fontes
importados pelo site. src/assets/static/ contém os arquivos com URL fixa, como o
favicon e a imagem de compartilhamento.
/en/e/pt-BR/têm HTML completo antes de executar JavaScript./apresenta a versão padrão em inglês, com canonical para/en/.- Cada idioma tem título, descrição, canonical, hreflang, Open Graph, Twitter e JSON-LD próprios.
robots.txt,sitemap.xml,llms.txte as versões Markdown são gerados no build./en/index.mde/pt-BR/index.mdcontêm o perfil, experiência, projetos, formação, credenciais e links dos currículos a partir dos mesmos dados YAML.llms.txté uma convenção complementar para descoberta por agentes, sem garantia de adoção ou posicionamento. O conteúdo HTML indexável continua sendo a base.- Os links anteriores
/?lang=ene/?lang=pt-BRcontinuam sendo interpretados pela aplicação. Novos links usam as rotas estáticas.
Edite domínio e textos de SEO em metadata/site.yml. O perfil e os fatos profissionais permanecem
nos módulos YAML correspondentes. Nunca edite os artefatos gerados manualmente.
O diretório de trabalho do provedor deve ser a raiz do repositório, o comando de build deve ser
npm run build e o diretório publicado deve ser dist. O servidor
estático deve resolver /en/ para /en/index.html e /pt-BR/ para /pt-BR/index.html,
preservando seus arquivos distintos. Evite uma regra que substitua todas as rotas pelo
index.html da raiz. Configure respostas 404 reais para URLs inexistentes.
Depois da publicação, envie https://matbdev.com/sitemap.xml ao Google Search Console e ao
Bing Webmaster Tools e confira as URLs localizadas. A indexação e a presença em respostas de
IA dependem de rastreamento e dos critérios de cada serviço.
Veja AGENTS.md e o guia de dados e idiomas.