Revision history for App-Dapper
1.10 2026-11-16
Images load faster, Markdown gains components, drafts and scheduled
posts work, dapper check looks for accessibility and SEO problems,
and dapper import brings in a WordPress, Jekyll, Hugo or Medium
site. See "Upgrading from 1.0" in the README.
Changed: pages with draft: true, and pages dated in the future, are
no longer published by dapper build or dapper deploy. dapper serve
shows them, as do build, watch and check with --drafts. Set
future: true in _config.yml to publish pages dated in the future.
Added: images in _config.yml gives every image width and height,
lazy loading after the first on a page, resized copies listed in a
srcset, and WebP copies in a <picture>. Resizing uses ImageMagick
or libvips when one is installed, and copies are kept in
.dapper/images.
Added: components in Markdown, without template code: callouts
(note, tip, info, warning, caution, important), details, gallery,
youtube, vimeo, button, figure and map. Themes and sites can add
their own, or restyle the built-in ones, with templates in
_layout/components.
Added: dapper check warns about images without alt text, skipped
heading levels, a page with no language, links with no text or
only "click here", and missing, duplicate or overlong titles and
descriptions. check: { accessibility: false, seo: false } turns
them off. Its report lists the drafts and scheduled pages it left
out.
Added: dapper import wordpress|jekyll|hugo|medium, which brings a
site's pages into the source directory, keeping their addresses,
dates, categories, tags and drafts, converting what it can
(captions, embeds, Liquid, shortcodes) and listing what it can't.
Pages are fitted to the _schema.yml of the folder they land in:
in the blog starter, posts get the blog category and their own
categories become tags.
Changed: the default starter's layout sets <html lang="en">, and the
blog starter's home page has a description.
Changed: an HTML page's first paragraph is its excerpt, as a
Markdown page's is, so it also gives the page a description.
An HTML page with template code has none.
Fixed: AGENTS.md and CLAUDE.md, written by dapper init, were copied
into the output directory and published with the site.
Fixed: a page without a date (which takes its file's modified time)
was given the wrong time when the site's time zone differs from the
computer's, which in this release would also have held it back as
scheduled.
Fixed: a file without front matter (in the source directory, or at
the top of the project) silently replaced a page written to the
same place. It is now an error, like two pages writing one file.
Fixed: dapper check ignored links that came before a skipped
heading, treated a link to another site whose address starts with
the site's own (example.com.other.org) as a page of the site,
named a copied HTML file by its temporary path, and reported
<img alt> as having no alt text.
Fixed: a code block could be closed by a shorter fence, and text
that happened to match Dapper's internal placeholders was replaced.
Fixed: a list or map given as a category ended up in the URL, and
a list given as a time zone crashed the build. A symbolic link to
nothing at the top of the project stopped the build; it is now
skipped with a warning. Settings set to JSON false through MCP
counted as on.
Fixed: the MCP server's write_page wrote empty front matter that
Dapper couldn't read, and followed symbolic links out of the source
directory. Valid JSON that isn't a request now gets an Invalid
Request error instead of a parse error.
Fixed: a deploy command that couldn't be started reported a
nonsense exit status; a file:// template address was taken for a
folder; and AGENTS.md named _data/redirects.yml even when data
files are elsewhere.
Fixed: in dapper import, WordPress ?p= links became the home
page's address and category names kept &; Jekyll posts with
published: false, a date with a time zone offset, no front matter,
or a category with a space were read wrongly; Hugo shortcodes with
escaped quotes were cut off, a ref to the home page became //, and
Markdown files inside a page bundle became pages; Medium stories
with no title were written as .html. The TOML reader now handles
comments, \u escapes, multi-line strings, nested arrays and dotted
keys.
Fixed: images with an upper-case extension (PHOTO.JPG) got resized
copies with a lower-case extension, which srcset didn't name. Maps
of places with accented or non-Latin names had a broken address,
and more forms of Vimeo address are recognized.
The test suite grows from 220 to over 5,000 checks, covering 98% of
the code.
1.00 2026-11-13
Dapper 1.0 makes page content safe by default, adds what a modern
static site needs (schemas, data files, pagination, feeds,
sitemaps, SEO tags), and makes sites easy for AI tools to read and
for AI assistants to work on. It adds starter themes and makes
publishing one command. See "Upgrading to 1.0" in the README.
Changed: page content is no longer run as template code unless the
page sets template: true. Layouts always are. Set
templates_in_content: true in _config.yml for the old behavior,
where content and _config.yml values were templates too.
Added: front matter schemas. A _schema.yml in a source directory
lists required fields and types, allowed values, patterns and
limits, and every problem on every page is reported at once.
Added: data files. YAML and JSON files in _data are available as
site.data.
Added: tags (site.tags), pagination (paginate in front matter, with
a paginator), and generated category and tag pages
(category_pages and tag_pages in _config.yml).
Added: a sitemap (/sitemap.xml), an Atom feed (feed in
_config.yml), and page.seo with a description, canonical link,
Open Graph and Twitter tags and JSON-LD structured data.
Added: a Markdown copy of each Markdown page next to its HTML, and
/llms.txt and /llms-full.txt listing them, for AI tools.
Added: dapper check, which finds broken links, front matter and
schema problems, missing layouts, template errors and pages
written to the same file, without touching the output directory.
--json prints the report for scripts and AI assistants.
Added: dapper mcp, a Model Context Protocol server that lets AI
assistants list, read, write (checked against schemas), check and
build pages.
Added: dapper init --template blog, a complete starter blog.
Added: fenced code blocks (```perl ... ```) with language-* classes
for client-side highlighting, which Text::MultiMarkdown did not
support, and search with Pagefind (search: true).
Added: builds remove files left over from earlier builds (only
files Dapper wrote; clean: false turns it off), and dapper serve
reloads pages in the browser after each rebuild.
Added: -C/--directory to run in another directory.
Added: new ways to install: a single file that runs with any Perl
5.10+ (attached to each GitHub release), a Docker image
(ghcr.io/markdbenson/dapper) and a Homebrew formula.
Added: AGENTS.md. dapper init writes a guide to the project for AI
coding agents, generated from the project (commands, folders,
layouts, the rules in every schema, categories and tags in use),
and a CLAUDE.md that points Claude Code at it. dapper agents
updates it, keeping notes outside its markers. Layouts can
describe themselves with a description in their front matter.
Added: MCP prompts (new_site, write_post, audit_site), resources
(dapper://guide, dapper://config, dapper://schemas), and tools:
rename_page (adds a redirect from the old URL), read_layout and
write_layout (a layout is parsed before it is saved).
Added: redirects, from redirects in _config.yml or
_data/redirects.yml, written as small pages at the old URLs.
Added: three themes alongside blog: portfolio, business (services,
hours and contact details from one data file, with LocalBusiness
structured data) and docs (a sidebar from a data file, with
previous and next links). dapper init --template also takes a
directory or a git URL, and dapper templates lists the built-ins.
Added: dapper deploy, which builds, checks and publishes the site
to Amazon S3 (with the AWS CLI, and an optional CloudFront
invalidation), GitHub Pages (keeping the branch's history), or a
command of your own. It refuses to deploy a site with errors unless
--force is given; --dry-run shows what would happen.
Added: ROADMAP.md.
Fixed: files with accented letters in their names were skipped or
copied to the wrong name.
Fixed: two pages writing the same output file is now an error.
0.22 2026-10-29
Fixed: settings in _config.yml (source, output, layout) are now
honoured by every command. Command line options override the
config file, which overrides the defaults. (GitHub #8)
Fixed: pages with their own urlpattern are written to the path
their URL describes, not the source file name. URLs ending in /
become index files using the page extension. Empty tokens such as
:category are dropped, and :slug falls back to the file name when a
page has no title. page.url is now correct for plain pages too.
(GitHub #5)
Documented every site.* and page.* variable. Replaced the old
Liquid syntax in the POD with the template syntax Dapper uses.
(GitHub #4)
Moved continuous integration from Travis CI to GitHub Actions,
testing Perl 5.10 to 5.40 on Linux and macOS. (GitHub #11)
Fixed: files are copied by Dapper itself instead of the shell, so
names with spaces or shell characters work and cannot run commands.
The output, source and layout directories are never copied into
the output.
Fixed: files in the source directory without front matter (images,
zip files, plain text) are copied as they are instead of crashing
the build.
Fixed: front matter must start on the first line and close on a
line of its own, so "---" inside a value no longer breaks a page.
Empty front matter is allowed. Parse errors name the file.
Fixed: dates in the pre-0.19 "2014-05-02 10:30:00" format and plain
dates are accepted again, and a bad date names the file.
Dates written without a time zone are now in the page's timezone
setting, the new site-wide timezone setting, or the local time zone
(xmlschema used to label them UTC).
Fixed: layouts can be nested any number of levels, loops are
reported, and front matter is removed from top-level layouts.
Fixed: categories may be a list, and pages are processed in sorted
path order so site.pages and page.id are the same on every machine.
(page.id values may differ from 0.21, which used directory order.)
Fixed: the replace_last filter now receives its arguments and
matches literally, and smart handles adjacent dashes. The built-in
json method ([% page.json(1) %], [% x | json %]) no longer
double-encodes non-ASCII text. Removed Dapper's own json filter,
which the built-in json always took precedence over. Dates gained
an xmlschema method ([% page.date.xmlschema %]) because filters do
not apply to dates.
Fixed: watch now notices the config file and added or removed
files, and keeps running when a rebuild fails.
Fixed: unknown commands and options exit with an error, and failed
builds exit non-zero. Added -q/--quiet, --help and --version.
Removed dependencies on CGI, Data::Dumper::HTML, File::Monitor,
Getopt::Mixed, Template::Toolkit (Template::Constants), Text::Markdown
and Test. Removed the unused App::Dapper::Serve module. The minimum
Perl version is now 5.10.
Replaced the placeholder tests with a real test suite.
Documentation: added a table of contents, a step-by-step blog
tutorial, sections on source file types, assets, drafts and clean
builds, limitations, upgrading from 0.21, troubleshooting and
contributing, and refreshed the deployment instructions.
0.21 2025-01-22
Added CGI to list of module dependencies.
0.20 2025-01-21
Removed dependency on YAML::Tiny from test framework
0.19 2025-01-20
Changed to Net::HTTPServer for local webserver use. This is a much
better forking webserver to use than HTML::Brick and better supported.
Enabled EVAL_PERL for embedding perl code in templates. Set EVAL_PERL
to "true" to use (e.g. export EVAL_PERL=true). Then use [% perl %] blocks
in templates to use embedded perl in your templates. See README for more.
Changed timestamp format to use the ISO 8601 style date/time format.
In previous versions of Dapper, the date format for posts that was accepted
was (\d\d\d\d)-(\d\d)-(\d\d) (\d\d)\:(\d\d)\:(\d\d).
Updated YAML processor from YAML::Tiny to YAML::PP. Now, Dapper supports
YAML 1.2. See the documentation for the YAML spec and/or the YAML::PP
documentation for more information on exactly what features are supported.
0.18 2014-05-02
Adopted the TT3 mini-language as provided by Template::Alloy
Added urlpattern and extension variables to site and page definitions
Added consistent handling of urlpattern, and output file extensions
0.17 2014-04-15
Clarified JSON Perl module dependency in Makefile.PL
0.16 2014-04-15
Added README content for config files, source files, and layouts.
Added 'json' filter for dumping Liquid variables to JSON for debug.
0.15 2014-04-07
Added command-line option to specify web server port number.
Dapper now works with Perl installations as old as v5.8.
0.14 2014-04-02
Added deploy instructions to README and a getting started guide.
Changed MIN_PERL_VERSION from v-string to string to eliminate NetBSD errors.
0.13 2014-04-27
Added explicit hash derefs in attempt to support Perl 5.19.{8-10}.
0.12 2014-04-26
Added explicit hash deref to avoid experimental warning in Perl 5.19.
0.11 2014-04-26
Added auto-reload of files while serving local webserver.
Changed format of post IDs from their URL to a global incrementing integer.
0.10 2014-03-05
Improved README narrative.
Watch routine now watches everything except contents of the _output dir.
0.09 2014-02-20
Added 5.14.0 minimum perl version requirement.
0.08 2014-02-20
Eliminated some tests (init, build) that were causing CI failures.
0.07 2014-02-20
Added Getopt::Mixed to list of build options.
0.06 2014-02-20
Added DateTime::Format::XSD dependency to resolve test errors.
0.05 2014-02-19
Updated Makefile.PL dependencies to resolve errors for cpantesters.org.
0.04 2014-02-18
Removed unicode characters from App::Dapper pod.
Added references to source and issue tracking on github.
0.03 2014-02-18
Added significant documentation to App::Dapper and bin/dapper.
Simplified default _config.yml file.
0.02 2014-02-17
Added documentation link from App::Dapper to bin/dapper.
Fixed FreeBSD testing error as reported by cpantesters.org.
0.01 2014-02-01
First version.
Keyboard Shortcuts
Global
s
Focus search bar
?
Bring up this help dialog
GitHub
gp
Go to pull requests
gi
Go to GitHub issues (only if GitHub is preferred repository)