如何用 RStudio 發表 Quarto 網站到 github

To deploy a Quarto website to GitHub using the usethis package in RStudio on Ubuntu 20.04, follow these steps:

1. Install Required Packages: Ensure you have the usethis and quarto packages installed. You can install them using the following commands in RStudio:

   install.packages("usethis")
   install.packages("quarto")
   

2. Create a New Quarto Project: Create a new Quarto project in RStudio. You can do this by navigating to File > New Project > New Directory > Quarto Website.

3. Initialize Git: Initialize a Git repository in your project directory:

   usethis::use_git()
   

4. Create a GitHub Repository: Use usethis to create a GitHub repository and link it to your local project:

   usethis::use_github()
   

5. Configure Quarto for GitHub Pages: Modify your _quarto.yml file to specify the output directory as docs:

   project:
     type: website
     output-dir: docs
   

6. Add .nojekyll File: Add a .nojekyll file to the root of your repository to prevent GitHub Pages from processing your site with Jekyll:

   touch .nojekyll
   

7. Render and Deploy Your Site: Render your Quarto site and push the changes to GitHub:

   quarto render
   git add docs
   git commit -m "Publish site to docs/"
   git push
   

8. Configure GitHub Pages: Go to your GitHub repository settings and configure GitHub Pages to publish from the docs directory of the main branch.