https://quarto.org/docs/publishing/github-pages.html
https://randomrealizations.com/posts/blogging-with-quarto-and-jupyter/
Install quarto.
Run:
$ quarto create-project tpofto --type website:blog
- Edit _quarto.yaml for social media, github, etc.
- Update blog title’
- Select bootstrap theme (cosmo by default, full list here: https://bootswatch.com/)
- Edit about.qmd to introduce yourself.
- Add image of yourself in directory which will show up on your About page
- Create a file named .gitignore in blog folder. Add the following:
# .gitignore file
.gitignore
/.quarto/
/_site/
.*
Run: quarto create-project tpofto –type website:blog
Create a directory named tpofto. This is the blog top-level.
Add .gitignore with the following:
.gitignore
/.quarto/
/_site/
.*
Create new github repository (jtrive84.github.io). Local directory doesn’t have to have the same name as jtrive84.github.io.
Add new directory with .ipynb file in posts folder. Each folder should be a separate
cleaner.
Use quarto publish to publish content to github pages: https://quarto.org/docs/publishing/github-pages.html
Ensure all changes have been committed to your repository, then create a gh-pages branch:
git checkout –orphan gh-pages git reset –hard # make sure all changes are committed before running this! git commit –allow-empty -m “Initialising gh-pages branch.” git push origin gh-pages
Switch back to master branch (make sure not on gh-pages branch). Run:
quarto publish gh-pages
Themes:
https://quarto.org/docs/output-formats/html-code.html
Booststrap themes
BOOTSTRAP_THEME = “Darkly”
BOOTSTRAP_THEME = “Flatly”
BOOTSTRAP_THEME = “Simplex”
BOOTSTRAP_THEME = “Slate”
BOOTSTRAP_THEME = “Lumen”
BOOTSTRAP_THEME = “Journal”
BOOTSTRAP_THEME = “spacelab”
BOOTSTRAP_THEME = “Superhero”
BOOTSTRAP_THEME = “cyborg”
BOOTSTRAP_THEME = “cerulean”
BOOTSTRAP_THEME = “cosmo” # BOOTSTRAP_THEME = “Sandstone” # BOOTSTRAP_THEME = “United” # BOOTSTRAP_THEME = “yeti”
Bad Themes.
BOOTSTRAP_THEME = “Minty”
BOOTSTRAP_THEME = “Litera”
BOOTSTRAP_THEME = “Materia”
BOOTSTRAP_THEME = “Pulse”
BOOTSTRAP_THEME = “Sketchy”
BOOTSTRAP_THEME = “Solar”
BOOTSTRAP_THEME = “Pulse”
To check changes, # run: quarto preview