This is just my own environment, please don't consider this as an official development guide. Operating systems and software will vary for your own needs. Please consult the internet for any installation help.
- Windows 11 Pro, 64 Bit
- Windows Subsystem for Linux (WSL2) running Debian 12
- GitHub Desktop
- Create a project folder for your GitHub repositories, e.g.
C:\Users\Username\Documents\GitHub\ - In GitHub desktop, clone the official Yellow extensions repository into this folder so that it becomes a subdirectory (should already be the default setting), e.g.
C:\users\username\Documents\GitHub\yellow-extensions\. - It is recommended to create individual repositories for each of your extensions. Use
yellow-nameas a pattern, where name is the name of your extension.
- Install PHP. Please check available guides how to do this. I'm using the Sury repository to always have the latest version. To avoid installing the apache web server, install php with fpm support.
- Install required PHP modules:
sudo apt update && apt install php-curl php-gd php-mbstring php-zip - Install Git:
sudo apt update && sudo apt install git - Clone the Datenstrom Yellow repository somewhere in your WSL home directory:
git clone https://github.com/datenstrom/yellow.git yellow-dev - As we don't need a configured edit extension in this installation, change into the
yellow-devdirectory and run:php yellow.php skip installation - Install the publish extension:
php yellow.php install publish - In your
system/extensions/yellow-system.ini, add/changePublishSourceCodeDirectoryto your GitHub projects folder, e.g.:PublishSourceCodeDirectory: /mnt/c/users/Username/Documents/Github/ - Now you can follow the remaining guidelines given in the publish documentation to upload and publish your extensions.
Happy coding! 🙂