as

Author: raphateixeira

.github/workflows/publish.yml

@@ -1,30 +1,50 @@
+# .github/workflows/publish.yml
+
+on:
+  # Aciona o workflow quando há um push (envio de código) para o branch 'main'
+  push:
+    branches: [main]
+  
+  # Permite a execução manual do workflow pela interface do GitHub (Botão 'Run workflow')
+  workflow_dispatch:
+
+name: Quarto Publish
+
 jobs:
   build-publish:
+    # O workflow será executado em um servidor virtual Ubuntu
     runs-on: ubuntu-latest
+    
+    # Permissões necessárias para que o workflow possa escrever e publicar no Pages
     permissions:
       contents: write
+      pages: write
+      id-token: write
+
     steps:
-      - name: Check out repository
-        uses: actions/checkout@v3
+      - name: 📥 Check out repository
+        uses: actions/checkout@v4
 
-      - name: Set up Quarto
+      - name: ⚙️ Set up Quarto
+        # Instala o Quarto CLI no ambiente de execução do GitHub Actions
         uses: quarto-dev/quarto-actions/setup@v2
 
-      - name: Install Python and Quarto Dependencies
-        uses: actions/setup-python@v4
+      - name: 🐍 Set up Python and install dependencies
+        # Instala a versão 3.10 do Python e o cache de pacotes
+        uses: actions/setup-python@v5
         with:
           python-version: '3.10'
           cache: 'pip' 
-      
-      # Opcional: Se você usa R, adicione este bloco
-      # - name: Install R
-      #   uses: r-lib/actions/setup-r@v2
-
-      # Instalar pacotes Python necessários (ex: pandas, numpy, etc.)
+          
+      # Exemplo de instalação de pacotes comuns de Data Science
       - name: Install dependencies
-        run: pip install pandas numpy jupyterlab
+        run: |
+          pip install pandas numpy jupyterlab jupyter_client 
+          # Use um arquivo requirements.txt se sua lista for longa!
 
+      # 💻 Renderiza e Publica
       - name: Render and Publish
+        # Este passo executa 'quarto render' e envia o resultado para o GitHub Pages
         uses: quarto-dev/quarto-actions/publish@v2
         with:
           target: github-pages