https://github.com/cecilapp/action
This GitHub Action builds a static site with Cecil.
https://github.com/cecilapp/action
action cecil github-actions static-site
Last synced: 24 days ago
JSON representation
This GitHub Action builds a static site with Cecil.
- Host: GitHub
- URL: https://github.com/cecilapp/action
- Owner: Cecilapp
- License: mit
- Created: 2019-06-14T22:11:26.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2025-03-19T11:32:50.000Z (about 1 year ago)
- Last Synced: 2025-06-09T07:09:44.224Z (about 1 year ago)
- Topics: action, cecil, github-actions, static-site
- Homepage: https://github.com/marketplace/actions/cecil-action
- Size: 72.3 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Cecil build Action
This GitHub Action builds a [_Cecil_](https://cecil.app) site and uploads a GitHub Pages artifact.
[](https://github.com/Cecilapp/Action/actions/workflows/test.yml)
## Usage
```yaml
- name: Build site
uses: Cecilapp/Cecil-Action@v4
# optional
with:
version: 8.0.0 # default: latest version
install_themes: "yes" # default: "yes"
options: -v --config=config.yml # default: "-v" (verbose)
```
### Workflow example
The following workflow:
1. runs on pushes to the `main` and `master` branches
2. checkout source
3. setup PHP
4. downloads Cecil
5. installs theme(s)
6. runs Cecil build
7. upload pages artifact
8. deploys to GitHub Pages
```yaml
name: Build and deploy to GitHub Pages
on:
push:
branches: [main, master]
workflow_dispatch:
concurrency:
group: pages
cancel-in-progress: true
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout source
uses: actions/checkout@v6
- name: Build site
uses: Cecilapp/Cecil-Action@v4
deploy:
needs: build
permissions:
pages: write
id-token: write
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v5
```
## License
_Cecil build Action_ is a free software distributed under the terms of the MIT license.
© [Arnaud Ligny](https://arnaudligny.fr)