Static site generator for Grav CMS
Clone or download
Latest commit f4bbb39 Jul 26, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
cli Remove unused Jul 26, 2018
vendor/RollingCurl v0.10.0: Bug fixes Mar 12, 2018
.gitignore Ignore .idea Jul 26, 2018 v1.0.0-beta.1 - GUI and Taxonomy Jul 26, 2018 v0.10.0: Bug fixes Mar 12, 2018 v1.0.0-beta.1 - GUI and Taxonomy Jul 26, 2018
blackhole.php Remove unused Jul 26, 2018
blackhole.yaml Blackhole enabled Apr 6, 2018
blueprints.yaml v1.0.0-beta.1 - GUI and Taxonomy Jul 26, 2018
functions.php v1.0.0-beta.1 - GUI and Taxonomy Jul 26, 2018

Blackhole Plugin

The Blackhole Plugin is for Grav CMS.


Why Blackhole? Grav is a space term, so I think this plugin should follow suit. Time stops at the event horizon of a black hole, which is exactly what this plugin does to your website. It freezes it in a state. By Increasing gravity to infinity you get a static black hole, or in this case you generate a static html copy of your Grav website.

Pagination not currently supported.


GPM Installation

The simplest way to install this plugin is via the Grav Package Manager (GPM). From the root of your Grav install type: bin/gpm install blackhole

Manual Installation

If you can't use GPM you can manually install this plugin. Download the zip version of this repository and unzip it under /your/site/grav/user/plugins, then rename the folder to blackhole.


Absolute URLs must be enabled in Grav System Configuration.

Generate Command

The generate command can be used from the command line or directly in the Grav Admin Panel. Generate your static site. generate can also be written as gen or g.

  • Input URL (required) - Enter the URL to your live Grav site.
bin/plugin blackhole generate http://localhost/grav


  • Output URL --output-url or -d The URL of your static site. This determines the domain used in the absolute path of your links.

  • Output Path --output-path or -p The directory to which your static site will be written (relative to Grav root).

    --output-path ../build
  • Routes --routes or -r Limit generation to a select list of page routes.

    --routes home,about,about/contact
  • Simultaneous Limit --simultaneous or -s Determine how many files will generate at the same time (default: 10).

    --simultaneous 10
  • Assets --assets or -a Copy assets to the output path.

  • Taxonomy --taxonomy or -t Process the taxonomy map.

  • Force --force or -f Overwrite previously generated files.