quarto template for group wiki/websites

numbats / numbathackathon

Repository for the NUMBAT Hackathon, 2020

1 stars 0 forks source link

quarto template for group wiki/websites #31

Open cynthiahqy opened 1 year ago

cynthiahqy commented 1 year ago

loosely connected to #19 update (though that is external facing websites)

Could be nice to produce a template to create a wiki-style websites (research logs, etc.) using quarto. I put this together for another phd student -- https://github.com/cynthiahqy/template_phd-log

Resources:

https://quarto.org/docs/extensions/starter-templates.html

cynthiahqy commented 1 year ago

Would be cool to get it working with https://github.com/hamelsmu/oauth-tutorial

cynthiahqy commented 1 year ago

Template needs defaults for:

[x] navigation setup
[x] navbar auto-listings (YAML)
[x] margin references & notes (bibliography)
[x] "log" style page -- meeting notes etc.
[x] "listing" style page & folder setup
[x] roadmap / project overview ("about page")
[x] sample extra pages (glossary, how-to tricks)
[ ] add example content -- pdf, image

Extra feature:

[x] authentication via https://github.com/hamelsmu/oauth-tutorial

cynthiahqy commented 1 year ago

Also want to do confirmation slides template!

[ ] make extension for from https://github.com/numbats/monash/tree/master/inst/rmarkdown/templates/revealjs/skeleton
[ ] visual-mode bug --

cynthiahqy commented 1 year ago

Starter Templates are example content, with all project options easily modifiable by the end user in the project level file _quarto.yml
Project Type Extensions are stricter in the sense that they "contribute" YAML options (stored in _extensions/ABCwebsite/_extension.yml) to the project when rendering via the project: type: ABCwebsite)

cynthiahqy commented 1 year ago

🎉 Finished template, with GitHub OAuth files & link to tutorial: https://github.com/cynthiahqy/quarto-wiki-template.git
✨ GitHub OAuth live demo ~ https://github.com/settings/applications/2119935
🙃 Google OAuth live demo: private.cynthiahqy.com, https://github.com/cynthiahqy/oauth-render-quarto

cynthiahqy commented 1 year ago

GitHub OAuth instructions are a bit broken -- https://github.com/cynthiahqy/oauth-tutorial/blob/main/simple/README.md

just need a rendered _site/ folder, deploy on Render, then add CNAME DNS record from custom domain to .onrender.com server generated by Render

cynthiahqy commented 1 year ago

Google OAuth doesn't work in Incognito mode, but GitHub OAuth does. Google error:

cynthiahqy commented 1 year ago

Another hosting option: https://www.pythonanywhere.com