231001: Migration to Quatro
Closed this issue · 1 comments
Is your feature request related to a problem? Please describe.
Lua-filters are being retired. See https://github.com/pandoc/lua-filters
Describe the solution you'd like
To migrate your academic-pandoc-template
repository to use quarto-actions
, you'll need to do the following:
Steps:
-
Add Quarto Configuration: Create a
quarto.yml
file in your repository to specify the Quarto build settings. This is similar to your existingMakefile
. -
GitHub Actions Workflow: Create a
.github/workflows/quarto-publish.yml
file in your repository. You can base it on the example fromquarto-actions
:name: Quarto Publish on: push: branches: - main jobs: publish: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - uses: quarto-dev/quarto-actions/setup@v1 - uses: quarto-dev/quarto-actions/render@v1 - uses: quarto-dev/quarto-actions/publish@v1 with: publish_dir: _site
-
Dependencies: If your project relies on specific system dependencies, you might need to add a step in the GitHub Actions workflow to install them.
-
Test Locally: Before pushing the changes, test the Quarto build locally to make sure everything works as expected.
-
Push and Monitor: Once you're confident, push the changes to GitHub and monitor the Actions tab to ensure the workflow runs successfully.
Notes:
-
The
quarto-actions
repository provides various examples for different use-cases like freezing code, specifying dependencies, etc. You might want to look into those based on your project's needs. -
The
quarto-actions
repository uses three main actions:setup
,render
, andpublish
. These are specified in theaction.yml
files within their respective directories.
Describe alternatives you've considered
None
Additional context
None
Stale issue message