also looking at this
fix(site): derive the structured data, and give every head the same colours
#61
8 files
+14
-68
| @@ -1,62 +0,0 @@ | ||
| 1 | # Error Illustrations | |
| 2 | ||
| 3 | Four desert scenes, one per HTTP status they were drawn for: | |
| 4 | ||
| 5 | | File | Scene | | |
| 6 | | --- | --- | | |
| 7 | | `403.svg` | A fortress keeping watch over moonlit dunes | | |
| 8 | | `404.svg` | A lone camel on an endless ridge at dusk | | |
| 9 | | `500.svg` | Footprints trailing off under a midday sun | | |
| 10 | | `503.svg` | A domed village at twilight | | |
| 11 | ||
| 12 | ## Where they come from | |
| 13 | ||
| 14 | Steve Schoger drew them for Laravel 5.7, which shipped them in `public/svg/` and | |
| 15 | rendered them through the `errors::illustrated-layout` view. Laravel 5.8 moved | |
| 16 | its error views onto the minimal layout and the artwork was dropped from the | |
| 17 | framework. These files are that artwork, vendored under Laravel's MIT licence: | |
| 18 | <https://github.com/laravel/laravel/tree/v5.7.0/public/svg>. Three of the four | |
| 19 | have been through SVGO since; the drawings themselves are untouched. | |
| 20 | ||
| 21 | ## You probably do not need them | |
| 22 | ||
| 23 | Stacks renders illustrated production error pages out of the box. The built-in | |
| 24 | page inlines its own copy of these four scenes from `@stacksjs/error-handling`, | |
| 25 | so it keeps working whether or not this directory exists. | |
| 26 | ||
| 27 | Reach for the files here when you write your own error page. Anything you drop | |
| 28 | at `resources/views/errors/<status>.html` (or `error.html` as a catch-all) | |
| 29 | replaces the built-in page entirely, and `{{status}}`, `{{title}}` and | |
| 30 | `{{message}}` are substituted into it: | |
| 31 | ||
| 32 | ```html | |
| 33 | <!DOCTYPE html> | |
| 34 | <html lang="en"> | |
| 35 | <head> | |
| 36 | <meta charset="utf-8"> | |
| 37 | <title>{{status}} {{title}}</title> | |
| 38 | <style> | |
| 39 | body { margin: 0; font-family: system-ui, sans-serif; } | |
| 40 | .scene { height: 40vh; background: url("/svgs/404.svg") center / cover; } | |
| 41 | .copy { padding: 2rem; } | |
| 42 | </style> | |
| 43 | </head> | |
| 44 | <body> | |
| 45 | <div class="scene"></div> | |
| 46 | <div class="copy"> | |
| 47 | <h1>{{title}}</h1> | |
| 48 | <p>{{message}}</p> | |
| 49 | </div> | |
| 50 | </body> | |
| 51 | </html> | |
| 52 | ``` | |
| 53 | ||
| 54 | They are ordinary static assets, so they are equally usable anywhere else in | |
| 55 | your app. `public/assets/images/coming-soon-dawn.svg` is `503.svg` recolored to | |
| 56 | the Stacks blue palette, if you want a worked example. | |
| 57 | ||
| 58 | ## 📄 License | |
| 59 | ||
| 60 | The MIT License (MIT). Please see [LICENSE](https://github.com/stacksjs/stacks/tree/main/LICENSE.md) for more information. | |
| 61 | ||
| 62 | Made with �� | |