Static Files
Static files are files that should be copied directly to the output root without any processing.
Overview
๐จ Favicons
Browser icons in various formats for desktop and mobile.
๐ค robots.txt
Search engine crawler instructions.
๐ CNAME
Custom domain configuration for GitHub Pages.
๐ Other Files
sitemap.xml, ads.txt, security.txt, and more.
Convention
Place static files in the source/_static/ folder. They will be copied 1:1 to the output root.
source/
โโโ _static/ # Static files folder
โ โโโ favicon/ # Favicon files
โ โ โโโ favicon.ico
โ โ โโโ favicon.svg
โ โ โโโ apple-touch-icon.png
โ โโโ CNAME # GitHub Pages domain
โ โโโ .nojekyll # Disable Jekyll
โ โโโ robots.txt # Crawler instructions
โโโ _index.revela
โโโ gallery/
Output:
output/
โโโ favicon/
โ โโโ favicon.ico
โ โโโ favicon.svg
โ โโโ apple-touch-icon.png
โโโ CNAME
โโโ .nojekyll
โโโ robots.txt
โโโ index.html
Favicon Setup
Step 1: Generate Favicons
Use a favicon generator like realfavicongenerator.net:
- Upload your logo/image
- Configure platform-specific icons
- Download the generated package
- Copy files to
source/_static/favicon/
Step 2: Create Favicon Partial
Create a theme override to include the favicon HTML.
File: themes/Lumina/Partials/Favicon.revela
<link rel="icon" type="image/png" href="/favicon/favicon-96x96.png" sizes="96x96" />
<link rel="icon" type="image/svg+xml" href="/favicon/favicon.svg" />
<link rel="shortcut icon" href="/favicon/favicon.ico" />
<link rel="apple-touch-icon" sizes="180x180" href="/favicon/apple-touch-icon.png" />
<meta name="apple-mobile-web-app-title" content="Your Site" />
<link rel="manifest" href="/favicon/site.webmanifest" />
Tip: Copy the exact HTML provided by your favicon generator.
Step 3: Generate
revela generate all
Common Static Files
robots.txt
User-agent: *
Allow: /
CNAME (GitHub Pages)
example.com
.nojekyll
Empty file - just create it, no content needed. Prevents GitHub Pages from processing files with Jekyll.
How It Works
- Scanning: Folders starting with
_are skipped (no galleries created) - Copying: After page rendering, files from
_static/are copied to output - Structure: Directory structure is preserved
- Overwrite: Existing files are overwritten silently
Best Practices
- โ
Keep favicon files in
_static/favicon/for organization - โ
Place root files (CNAME, robots.txt) directly in
_static/ - โ Commit static files to version control
- โ Save favicon generator output for future updates