Páginas e roteamento

A descoberta é recursiva sob Content/Pages/ e aceita somente nomes terminados em .mdx ou .blade.php.

Arquivo	Rota
Pages/index.blade.php	/
Pages/sobre.mdx	/sobre
Pages/blog/index.blade.php	/blog
Pages/blog/arquivo/index.mdx	/blog/arquivo
Pages/blog/post.mdx	/blog/post

Todo segmento de arquivo chamado index é removido. Não há transliteração, normalização de caixa ou slug definido por metadata.

sobre.mdx e sobre/index.blade.php produzem a mesma rota e causam erro de colisão. A mensagem lista todos os arquivos candidatos ao caminho duplicado.

Metadata de páginas Blade

Página	Sidecar obrigatório
pasta/index.blade.php	pasta/meta.yaml
pasta/nome.blade.php	pasta/nome.meta.yaml

Sidecars precisam ser mapas YAML e não recebem _defaults.yaml. Sidecars PHP não são reconhecidos.

MDX

MDX usa front matter no próprio arquivo e pode receber _defaults.yaml. O corpo suporta GitHub Flavored Markdown, HTML permitido e componentes Blade <x-...>.

Tags script, style, iframe, textarea, title e demais itens do blocklist GFM são escapadas. Markdown dentro de componentes não é reprocessado. Echo e diretivas Blade são escapados como texto; componentes são a integração Blade suportada em MDX.

Depois da conversão, a view gerada estende extra.layout ou layouts.app e envolve o conteúdo em <x-blocks.prose>. Títulos h2 e h3 recebem IDs únicos; a lista correspondente é exposta à view para navegação contextual.

Nomes iniciados por _

_errors possui tratamento próprio. Qualquer outra pasta iniciada por _ é uma Collection e exige _collection.yaml e página-mãe. Evite também arquivos de página iniciados por _, pois o reconhecedor de caminho os interpreta como marcador de Collection.

Erros

Arquivos em Content/Pages/_errors/<código>/ geram a rota /<código> para qualquer código HTTP numérico de três dígitos entre 100 e 599. Isso inclui todos os códigos de erro 4xx e 5xx — atuais ou adicionados futuramente — sem uma lista fechada no builder:

Classe	Códigos de erro HTTP documentados
Cliente (4xx)	400 Bad Request, 401 Unauthorized, 402 Payment Required, 403 Forbidden, 404 Not Found, 405 Method Not Allowed, 406 Not Acceptable, 407 Proxy Authentication Required, 408 Request Timeout, 409 Conflict, 410 Gone, 411 Length Required, 412 Precondition Failed, 413 Content Too Large, 414 URI Too Long, 415 Unsupported Media Type, 416 Range Not Satisfiable, 417 Expectation Failed, 418 I'm a teapot, 421 Misdirected Request, 422 Unprocessable Content, 423 Locked, 424 Failed Dependency, 425 Too Early, 426 Upgrade Required, 428 Precondition Required, 429 Too Many Requests, 431 Request Header Fields Too Large, 451 Unavailable For Legal Reasons
Servidor (5xx)	500 Internal Server Error, 501 Not Implemented, 502 Bad Gateway, 503 Service Unavailable, 504 Gateway Timeout, 505 HTTP Version Not Supported, 506 Variant Also Negotiates, 507 Insufficient Storage, 508 Loop Detected, 510 Not Extended, 511 Network Authentication Required

Os códigos 419, 420, 430 e 440, entre outros usados por produtos específicos, também podem ser publicados porque o framework aceita a faixa numérica inteira; eles não são códigos HTTP padronizados pelo registro geral. O fallback do servidor procura especificamente /404.

No build, todas as páginas de erro são gravadas como arquivos na raiz de dist: /404 vira dist/404.html, /403 vira dist/403.html e assim por diante. Páginas de erro nunca são indexáveis, mas recebem capa como as demais rotas salvo cover: false. Se /404 não existir, o fallback falha.