This is a new Quarto-based website which updates and supersedes the original website here:
R Consortium Blog - How to upload your blog post to a quarto-based website
This website is being built members of the R Consortium, R-Ladies Gaborone and other volunteer contributors. Thank you! If you want to help contribute to the site, please use the following workflow.
Make a branch and edit your branch locally.
To preview the website locally you can execute this quarto command in your terminal:
Make your changes locally save them and commit them. Be sure to make your commit message descriptive of the work you did.
Do a pull request from your local copy to make sure branch is in sync with the website branch. We will review your Pull Request!
The R Consortium, Inc. is a group organized under an open source governance and foundation model to support the worldwide community of users, maintainers and developers of R software. Its members include leading institutions and companies dedicated to the use, development and growth of R.
The R language is an open source environment for statistical computing and graphics. The R community has enjoyed significant growth, with more than 2 million users worldwide. A broad range of organizations have adopted the R language as a data science platform, including biotech, finance, research and high technology industries. The R language is often integrated into third-party analysis, visualization and reporting applications, and runs on a wide variety of computing platforms.
The R Consortium’s mission is to promote the R language and to develop the technical and social infrastructure required to support the R ecosystem and the R Community. Its activities and programs include:
Promoting the growth and development of R as a leading platform for data science and statistical computing.
Members of the R Consortium are recognized as supporters of the R Project and the R community, and the R Consortium represents its members to the R community and to the media.
Supporting and collaborating with the R Foundation, the governing body of the R Project.
The R Foundation maintains a permanent seat on the board of the R Consortium, as an open communication channel for R Consortium members.
Funding projects to enhance R and support its users.
Projects are proposed by the R community at large, and selected for funding by the Infrastructure Steering Committee. R Consortium members nominate the selection committee and provide funds for project grants with their membership dues. (Here is a list of projects funded by the R Consortium to date.)
Fostering the continued growth of R community and the data science ecosystem.
The R Consortium sponsors R-related conferences (including useR!), meetings (including SatRDays and RLadies), and local user groups worldwide.
Enabling the use of R in commercial environments, and fostering collaboration between companies investing in R.
R Consortium committees are developing programs for R language certification and training, consulting, and employment.
The mission of the R Consortium is formally defined in the R Consortium bylaws (PDF) and the Infrastructure Steering Committee charter (PDF).
Main Site: https://www.r-consortium.org/
News: https://www.r-consortium.org/news
Blog: https://www.r-consortium.org/news/blog
Join: https://www.r-consortium.org/about/join
Twitter: https://twitter.com/rconsortium?lang=en
LinkedIn: https://www.linkedin.com/company/r-consortium/
Mastodon: https://fosstodon.org/@RConsortium
Live site here: https://oppkeyquarto.netlify.app/
Clone repo
Use quarto preview
to run locally. Ensure you are in the root directory of the Quarto project where the _quarto.yml file is located.
If you use quarto serve
you may get the error:
ERROR: No input passed to serve. If you are attempting to preview a website or book use the quarto preview command instead.
Install R using sudo apt-get install r-base and sudo apt-get install r-base-dev
Install R packages on Linux; type R in console and then install.packages('rmarkdown')
GGPLOT2 installation: install.packages("ggplot2")
dygraphs installation : install.packages("dygraphs")
The .gitignore of this project is setup to ignore _site/
and .quarto/
-
_site/
is also known asdocs/
in other quarto projects -
_site
was specified as netlify publish directory on the website
Make sure you have R Studio installed
Clone down this Github repo (public repo). Make sure to pull down the new changes on main.
Open the quarto-blog-dev project in R Studio (File → Open Project). Ensure that you’ve switched to a new branch. git checkout -b name_branch
Install renv with install.packages(“renv”)
in console
Run renv::restore()
in console
Open a file for testing. Make edits to the file and run render
in R studio to view the updates.
See Final Steps.
If you’re using VS Code, start R.
Install R languageserver
when prompted
Install packages for R extension on Visual Studio Code
Run install.packages("renv")
and renv::restore()
in the terminal
Make edits to a file and run quarto render
and quarto preview
to see the changes.
See Final Steps.
Once finished with editing, run git add, git commit, and git push to the branch.
Make a pull request and assign a reviewer. The reviewer should test the request locally by switching to the test branch. Runquarto render
and quarto preview
to view the site locally.
Once the pull request is accepted, view the workflow status run in GitHub actions.
Once the workflow status is completed, view the updated changes to the site on Live Site
-
Only the freeze directory is needed when hosting on netlify using the plugin
-
Can use the "local only" ignoring files strategy. Each person adds
_freeze/
to the exclude file and only have one person who is reponsible for rendering and uploading to netlify
- When adding a new post these are the files that are added and the ones that are modified, I manually modified README.md and _quarto.yml
- Second time after initial setup these are the files that need to be added, my observation from this is that it's possible that only during initial setup merge conflicts are a problem due to
site_libs/
directory. I thinksite_libs/
is modified only when someone sets up quarto. I can try git_ignoring that directory and see if it causes a build failure or not on netlify. Maybe when someone is setting up R and the libraries on their computer it downloads and modifies this directory.