0. Go to the repo I prepared: https://github.com/maptv/USERNAME.github.io
1. Copy “USERNAME.github.io”
2. Click “Use this template” and then “Create new repository”
3. Paste “USERNAME.github.io” in as the repository name
4. Copy your GitHub username and paste it in place of “USERNAME” in “USERNAME.github.io”
5. Click “Create repository”
6. Copy the web address (url)
7. Go to https://posit.cloud
8. Click “New Project” and then “New Project from Git Repository”
9. Paste the repo url you copied in Step 3 and click “OK”
10. In the Files tab of the bottom right pane, select git.R
11. Edit the user.name and user.email values in git.R and click the diskette icon to save
12. When you see a yellow banner above git.R, click "Install" and wait for installation to complete in the background
13. Click “Source” in the upper right corner of the upper left pane (the one that is displaying git.R)
14. If you already have a Personal Access Token (PAT), close the new browser tab that opened. Otherwise, enter a note, click “Generate Token”, and click the copy button.
15. Make at least one change to at least one file, such as the edits to git.R above
16. Click the "Git" tab in the top right pane of Posit Cloud
17. Click the check box next to the file you changed
18. Click "Commit" to open a popup window (modal)
19. Enter a commit message in the upper right corner of the modal and click "Commit"
20. Close all modals and click the green up arrow labeled "Push" to push your commit to GitHub
21. Push at least one commit to your repo using the instructions above so that the credentials manager has your username and PAT
22. Click on the "publi.sh" file in the "File" tab of the bottom right pane, click "Run" in the upper right corner of the upper left pane, then type "y" in the terminal, press Enter or Return
After the first time you complete Step 22, you can click "Run Script" instead of "Run" and publish with the need to confirm by entering "y" in the terminal.
You may prefer to show the preview of your presentation in the Viewer tab of the lower right pane instead of a separate window.
You can always click "Present in an external browser" if you want to dedicate a whole browser tab to the preview.
The template repo I created has the quarto-revealjs-editable extension by Emil Hvitfeldt already installed so that you can make edits like in Powerpoint or Google Slides.
Depending on what you add to your site, you may need to install additional dependencies in Posit Cloud and modify the .github/workflows/publish.yml file so that you do not need to run publi.sh each time you want to update your site.