Documentation

Import and export blog content

Use these commands to move Off the Shelf articles between the database and the version-controlled JSON files in content/off-the-shelf/.

Import articles

Validate an import without changing the database first:

php artisan blog:import --dry-run

Import articles that do not already exist:

php artisan blog:import

Overwrite database articles with matching slugs:

php artisan blog:import --force

Use a different content directory:

php artisan blog:import --path=/absolute/path/to/content --dry-run

The command reports how many articles it created, updated, and skipped. Without --force, an existing article with the same slug is skipped.

Export the database’s current articles to the default version-controlled directory:

php artisan blog:export

Or export to another directory:

php artisan blog:export --path=/absolute/path/to/content

Review the resulting JSON changes with Git before committing them.