Skip to content

v4#4

Merged
ArnaudLigny merged 13 commits into
masterfrom
v4
May 22, 2026
Merged

v4#4
ArnaudLigny merged 13 commits into
masterfrom
v4

Conversation

@ArnaudLigny
Copy link
Copy Markdown
Member

@ArnaudLigny ArnaudLigny commented May 22, 2026

This pull request introduces significant updates to the Cecil GitHub Action, modernizing its configuration, improving flexibility, and streamlining the workflow for building and deploying Cecil sites to GitHub Pages. Key improvements include a new unified options input for Cecil CLI flags, enhanced artifact upload support, and updated documentation and workflow examples to match these changes.

Action input and workflow improvements:

  • Replaced the separate config and args inputs with a single options input in action.yml, allowing users to specify all Cecil CLI options in one place [1] [2].
  • Added a new step to resolve the output directory dynamically based on the options input, ensuring correct artifact upload regardless of custom output paths.
  • Integrated artifact upload directly into the action using actions/upload-pages-artifact@v5, making it easier to deploy to GitHub Pages.

Documentation and example updates:

  • Updated README.md to reflect the new options input, the artifact upload step, and the latest recommended usage patterns, including updated workflow examples and GitHub Action versions [1] [2].
  • Changed the deploy step in the example workflow to use actions/deploy-pages@v5 for compatibility with the latest GitHub Pages deployment process.

General enhancements and cleanup:

  • Improved input validation and error handling for the Cecil version input.
  • Added a step for PHP setup and ensured all necessary PHP extensions are installed before building the site.
  • Cleaned up formatting and descriptions in action.yml for better consistency and readability.

Rename input 'args' to 'options' and normalize input defaults/quoting; make config default empty and install_themes boolean. Add validation steps for Cecil version and config file, add PHP setup, and improve step names. Add Pages setup and artifact upload (upload-pages-artifact) and include baseurl during build. Update workflow examples and bump referenced actions (configure-pages, upload-pages-artifact, deploy-pages) and action usage to v4.
Remove the separate `config` input and simplify how options are passed to Cecil. action.yml: drop the `config` input and its validation, always run php cecil.phar with `inputs.options` plus the Pages base URL, and rename the Pages step to "Setup GitHub Pages". README and .github/workflows/test.yml: update examples to show passing `--config` via the `options` string, adjust workflow branches to include both main and master, and simplify the example workflow to match the action changes.
Update README formatting and refactor action.yml: normalize inputs, move PHP setup earlier (remove duplicate), and add a step to resolve the output directory from inputs.options (parses --output and -o variants, defaults to _site) exporting it via GITHUB_OUTPUT. Adjust upload-pages-artifact path to use the resolved output. Minor workflow/readme whitespace cleanups.
@ArnaudLigny ArnaudLigny changed the title refactor: rename args, add validation & Pages v4 May 22, 2026
@ArnaudLigny ArnaudLigny marked this pull request as ready for review May 22, 2026 22:13
Copilot AI review requested due to automatic review settings May 22, 2026 22:13
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Modernizes the Cecil GitHub Action for v4 by unifying CLI configuration into a single options input and integrating GitHub Pages artifact upload into the composite action, with corresponding documentation and workflow updates.

Changes:

  • Replace config + args inputs with a single options input.
  • Add PHP setup, Pages configuration, dynamic output directory resolution, and Pages artifact upload inside the action.
  • Update README and test workflow to reflect the new v4 interface and updated Pages deployment usage.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

File Description
README.md Updates usage and workflow examples for the new options input and v4 action usage.
action.yml Implements new inputs and embeds build + Pages artifact upload logic into the composite action.
.github/workflows/test.yml Updates CI workflow to use options instead of config/args.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread action.yml Outdated
Comment thread action.yml Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread action.yml Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
ArnaudLigny and others added 6 commits May 23, 2026 00:18
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Agent-Logs-Url: https://github.com/Cecilapp/Action/sessions/eb1f0927-869f-4c24-b085-c46d34ee6056

Co-authored-by: ArnaudLigny <80580+ArnaudLigny@users.noreply.github.com>
Agent-Logs-Url: https://github.com/Cecilapp/Action/sessions/eb1f0927-869f-4c24-b085-c46d34ee6056

Co-authored-by: ArnaudLigny <80580+ArnaudLigny@users.noreply.github.com>
@ArnaudLigny ArnaudLigny merged commit 52e96cf into master May 22, 2026
3 of 4 checks passed
@ArnaudLigny ArnaudLigny deleted the v4 branch May 22, 2026 22:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants