Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Quarto articles? #2210

Closed
ldecicco-USGS opened this issue Oct 13, 2022 · 9 comments · Fixed by #2656
Closed

Quarto articles? #2210

ldecicco-USGS opened this issue Oct 13, 2022 · 9 comments · Fixed by #2656
Labels
articles ✍️ feature a feature request or enhancement
Milestone

Comments

@ldecicco-USGS
Copy link

I write many "vignettes" that I promptly add to the .Rbuildignore. I don't want to send them to CRAN, but love adding helpful articles to the pkgdown site. Any chance that there will be support for quarto articles (not vignettes)?

@maelle maelle added feature a feature request or enhancement articles ✍️ labels Oct 20, 2022
@JosiahParry
Copy link

Related to suggestion in r-lib/usethis#1671.

I agree with @ldecicco-USGS :) There are some very nice handy dandy features made avaialble by quarto that I would like in my articles but not vignettes.

@hadley
Copy link
Member

hadley commented Oct 5, 2023

Quarto is now available on CRAN, so this is moving up the priority list.

@tripartio
Copy link

Quarto is now available on CRAN, so this is moving up the priority list.

@hadley Could you please give us the documentation for how to create Quarto articles with our CRAN packages? Or is it as simple as using .qmd files where we used to use .Rmd?

@dmurdoch
Copy link
Contributor

dmurdoch commented Feb 6, 2024

@tripartio, see here: quarto-dev/quarto-cli#2307

@tripartio
Copy link

@tripartio, see here: quarto-dev/quarto-cli#2307

Thanks! I'll follow that thread, then.

@DanChaltiel
Copy link

@tripartio also see here: quarto-dev/quarto-r#57
I could not find online documentation, but the procedure is described in vignette("hello", package = "quarto").
I was not able to make real quarto syntax (like tabs) work yet though.

@hadley
Copy link
Member

hadley commented Jun 13, 2024

I've implemented a first pass at this, which covers the features that seemed most critical to me. Please try it out and let me know what doesn't work!

@DanChaltiel
Copy link

Hi @hadley, thanks a lot for the feature!
I gave it a try, and it works perfectly on my computer (local) (even pkgdown::build_site_github_pages(new_process = FALSE, install = FALSE)).
However, I could not manage to make it work on GH actions.
For instance, this is the last run I had:
https://github.com/DanChaltiel/EDCimport/actions/runs/10092641396/job/27907083693#step:7:393
image
Here is the workflow: https://github.com/DanChaltiel/EDCimport/actions/runs/10092641396/workflow
I hope I did it correctly, but at least I can say that the error message is not specific enough to let me debug this.
Note that my vignette uses tabsets.min.js to have tabs.

About the vignette, it would be nice to reference a minimal reproducible example so that we could simply grab the vignette .qmd file, test that it runs on our setup, and then incrementally change it to make what we want.

Also, the vignette has a bug where the formula is not shown properly:
image

@hadley
Copy link
Member

hadley commented Jul 25, 2024

@DanChaltiel can you please file a new issue?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
articles ✍️ feature a feature request or enhancement
Projects
None yet
Development

Successfully merging a pull request may close this issue.

7 participants