Simplifying and Unifying Static File Handling

[ia3andy]

This PR introduces changes to make static file management more consistent, intuitive, and easier to understand.

Before this, it wasn't possible to add static files directly to the root directory, which could cause issues (e.g., adding an HTML file for Google Search registration). This update addresses that limitation while unifying and simplifying related behaviours.

Key Changes:

• Breaking Changes:
  • page.attachment() and site.staticFile() have been renamed to page.file() and site.file() for simplicity and consistency.
• Static Files Directory:
  • Use public/ as the directory for static files.
  • Files in public/static/ will reproduce the same behavior as /static.
  • The static/ directory is still scanned for compatibility.
• Default Image Directory:
  • The default image directory is now images (e.g., public/images/foo.png) instead of static/assets/images for simplicity.
  • The static/assets/images directory is still checked to support older sites.
• QRCode Plugin:
  • Removed hardcoded values for QR codes in the AsciiDoc plugin. QR codes now use Base64, aligning to non asciidoc handing
• Error Handling:
  • Using page.file() on non-directory pages now throws an error.
  • Using page.image() on a directory page will no longer fallback to site images if the image is not found; it will now throw an error.

These changes aim to simplify static file handling while maintaining backward compatibility where possible.

[github-actions]

🙈 The PR is closed and the preview is expired.