developing-locally.md

Developing locally

Option 1: Using Dev Containers (Recommended)

The easiest way to get started is using VS Code Dev Containers or GitHub Codespaces:

1. Install VS Code and the Dev Containers extension
2. git clone https://github.com/benbalter/wordpress-to-jekyll-exporter
3. Open the folder in VS Code
4. Click "Reopen in Container" when prompted
5. Wait for the container to build and dependencies to install
6. Access WordPress at http://localhost:8088

The devcontainer includes:

• Pre-configured WordPress and MySQL
• All PHP extensions and Composer dependencies
• VS Code extensions for PHP development, debugging, and testing
• WordPress coding standards configured

See .devcontainer/README.md for more details.

Option 2: Manual Setup

Prerequisites

1. sudo apt-get update
2. sudo apt-get install composer
3. sudo apt-get install php7.3-xml
4. sudo apt-get install php7.3-mysql
5. sudo apt-get install php7.3-zip
6. sudo apt-get install php-mbstring
7. sudo apt-get install subversion
8. sudo apt-get install mysql-server
9. sudo apt-get install php-pear
10. sudo pear install PHP_CodeSniffer

Bootstrap & Setup

1. git clone https://github.com/benbalter/wordpress-to-jekyll-exporter
2. cd wordpress-to-jekyll-exporter
3. script/bootstrap
4. script/setup

Option 3: Docker Compose Only

1. git clone https://github.com/benbalter/wordpress-to-jekyll-exporter
2. docker-compose up
3. open localhost:8088

Running tests

script/cibuild