Commands: build
Description
build
builds a production-ready version of a Blurry static site. It outputs the site in the folder specified by the build_directory_name
setting, which defaults to ./dist/
To build the site, Blurry:
- Generates responsive image sizes
- Converts images to AVIF
- Generates HTML pages (minified)
- Generates a sitemap
For the given content
directory contents:
$ tree content
content
├── commands
│ ├── build.md
│ └── runserver.md
├── configuration
│ ├── blurry.toml.md
│ ├── environment-variables.md
│ └── settings.md
├── content
│ ├── images.md
│ └── markdown.md
├── getting-started
│ ├── introduction.md
│ └── quick-start.md
├── images
│ └── schema.org-logo.png
├── index.md
└── templates
├── context.md
└── syntax.md
7 directories, 13 files
the build
output would look something like:
$ blurry build
Gathered 14 tasks (sitemap and 13 content files)
Took 0.143583 seconds
and the dist/
directory would look like:
$ tree dist
dist
├── commands
│ ├── build
│ │ └── index.html
│ └── runserver
│ └── index.html
├── configuration
│ ├── blurry.toml
│ │ └── index.html
│ ├── environment-variables
│ │ └── index.html
│ └── settings
│ └── index.html
├── content
│ ├── images
│ │ └── index.html
│ └── markdown
│ └── index.html
├── getting-started
│ ├── introduction
│ │ └── index.html
│ └── quick-start
│ └── index.html
├── images
│ ├── schema.org-logo-285.avif
│ ├── schema.org-logo-285.png
│ ├── schema.org-logo-354.avif
│ ├── schema.org-logo-354.png
│ ├── schema.org-logo.avif
│ └── schema.org-logo.png
├── index.html
├── sitemap.xml
└── templates
├── context
│ └── index.html
└── syntax
└── index.html
18 directories, 19 files
Usage
$ blurry build
. .
|-.| . ..-..-.. .
`-''-'-'' ' '-|
`-'
┏━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
┃ Markdown Plugins ┃ HTML Plugins ┃ Jinja Plugins ┃
┡━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━┩
│ container │ minify_html │ body_to_cards │
│ punctuation │ │ headings │
│ python_code │ │ url_path │
│ python_code_in_list │ │ blurry_image │
└─────────────────────┴──────────────┴───────────────┘
Blurring 22 Markdown files and 6 other files
Built site in 2.576354 seconds
Options
clean
: cleans the build directory before building.
Usage:
blurry build --clean