{"id":13852581,"url":"https://github.com/eddelbuettel/tint","last_synced_at":"2025-05-15T09:06:53.544Z","repository":{"id":54623183,"uuid":"68542638","full_name":"eddelbuettel/tint","owner":"eddelbuettel","description":"Tint is not Tufte","archived":false,"fork":false,"pushed_at":"2025-03-27T23:07:40.000Z","size":7447,"stargazers_count":265,"open_issues_count":3,"forks_count":25,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-04-14T15:01:04.103Z","etag":null,"topics":["cran","markdown","r-package","vignette"],"latest_commit_sha":null,"homepage":"","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eddelbuettel.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-09-18T19:28:03.000Z","updated_at":"2025-03-28T01:37:07.000Z","dependencies_parsed_at":"2024-10-30T16:00:45.451Z","dependency_job_id":"785c4737-3308-4c9f-9e43-c7400e48cc46","html_url":"https://github.com/eddelbuettel/tint","commit_stats":{"total_commits":117,"total_committers":6,"mean_commits":19.5,"dds":0.0854700854700855,"last_synced_commit":"c39e9c41f0feea1747b620d808d0c87e201e9936"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eddelbuettel%2Ftint","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eddelbuettel%2Ftint/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eddelbuettel%2Ftint/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eddelbuettel%2Ftint/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eddelbuettel","download_url":"https://codeload.github.com/eddelbuettel/tint/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254310515,"owners_count":22049469,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cran","markdown","r-package","vignette"],"created_at":"2024-08-04T22:01:27.105Z","updated_at":"2025-05-15T09:06:53.521Z","avatar_url":"https://github.com/eddelbuettel.png","language":"R","funding_links":[],"categories":["R"],"sub_categories":[],"readme":"## tint: Tint is not Tufte\n\n[![CI](https://github.com/eddelbuettel/tint/workflows/ci/badge.svg)](https://github.com/eddelbuettel/tint/actions?query=workflow%3Aci)\n[![Package-License](https://img.shields.io/badge/license-GPL--3-brightgreen.svg?style=flat)](https://www.gnu.org/licenses/gpl-3.0.html) \n[![CRAN](https://www.r-pkg.org/badges/version/tint)](https://cran.r-project.org/package=tint) \n[![Dependencies](https://tinyverse.netlify.app/badge/tint)](https://cran.r-project.org/package=tint) \n[![Downloads](https://cranlogs.r-pkg.org/badges/tint?color=brightgreen)](https://www.r-pkg.org/pkg/tint)\n[![Last Commit](https://img.shields.io/github/last-commit/eddelbuettel/tint)](https://github.com/eddelbuettel/tint)\n\n### Motivation\n\nThe (html and pdf) styles provided by the [tufte](https://cran.r-project.org/package=tufte) package\nmake it very easy and convenient to create documents in the celebrated style of\n[Edward Tufte](https://www.edwardtufte.com/).\n\nThe clear layout, focused use of white space and unparalleled use of the margin for complementary\ninformation, including graphs, offer a novel and very valuable resource for typesetting.\n\nYet at the same time, not everybody is a fan of the yellow tint, and the fonts.  I had been looking\nfor a while for an alternative, and came across \n[envisioned css](https://github.com/nogginfuel/envisioned-css) by Jef Lippiat.  It gets a few things\nvery right: use of the beautiful \n[Roboto Condensed font](https://fonts.google.com/specimen/Roboto+Condensed) along with\na closer-to-white background.  So I _mixed_ this with the code framework provided by JJ and Yihui to\nmake it an [RMarkdown](https://rmarkdown.rstudio.com/) template you can use just by installing this\npackage. Among the small changes I made were the removal of _italics_ in subheaders and the title.\n\nSimilarly, LaTeX styles exists and the\n[tufte](https://cran.r-project.org/package=tufte) package supports both pdf\nhandouts and a book format.  We first supported the pdf handout\noutput only, and added support for a pdf book format in release 0.1.0.\n\n\n### Example\n\n#### HTML\n\nA quick screenshot of the html variant is below:\n\n![](https://eddelbuettel.github.io/tint/tintHtmlScreenshot.png)\n\nand the full underlying document is [available too](https://eddelbuettel.github.io/tint/).  Its sources \nare included in the packages as\n[html/skeleton.Rmd](https://github.com/eddelbuettel/tint/blob/master/inst/rmarkdown/templates/tintHtml/skeleton/skeleton.Rmd).\n\n#### PDF\n\nAnother screenshot shows the pdf handout variant:\n\n![](https://eddelbuettel.github.com/tint/tintPdfScreenshot.png)\n\nand its underlying sources are included as \n[pdf/skeleton.Rmd](https://github.com/eddelbuettel/tint/blob/master/inst/rmarkdown/templates/tintPdf/skeleton/skeleton.Rmd).\n\nHere is a screenshot of the book format (which was added with release 0.1.0), showing a chapter-opening page on the left:\n\n![](https://eddelbuettel.github.io/tint/tintBookScreenshot.png)\n\n#### PDF Font Variants\n\nSince release 0.1.1 additional fonts can be specified in the YAML header.  Using the following lines\nin the YAML header \n\n```yaml\nlatexfonts: \n  - package: newtxmath\n    options: \n      - cmintegrals\n      - cmbraces\n  - package: ebgaramond-maths\n  - package: nimbusmononarrow\n```\n\nyields output as in the following screenshot of the first two vignette pages:\n\n![](https://eddelbuettel.github.io/tint/tintPDFGaramond.png)\n\nA second example is using \n\n```yaml\nlatexfonts: \n  - package: lato\n    options: default\n  - package: FiraMono\nlinkcolor: \"0.3,0.3,0.6\"\n```\n\nwhich also show the `linkcolor` option resulting in\n\n![](https://eddelbuettel.github.io/tint/tintPDFLato.png)\n\n\n### Status\n\nThe package is now on [CRAN](https://cran.r-project.org/package=tint) and\nsupports both pdf and html output for handouts, as well as pdf format for\nbook-length documents.  This latter style can be used with `rmarkdown` or \n`bookdown`.\n\n### Usage \n\nInstall from [CRAN](https://cran.r-project.org) as any other package via\n\n```r\nR\u003e install.packages(\"tint\")\n```\n\nand then use as a Markdown template via RStudio, or call `rmarkdown::render()` directly.\nWe have also used the book-length format via `bookdown::render_book()`.\n\n### Requirements\n\nBeyond the R package dependencies, a working `pandoc` binary is needed. RStudio installs\nits own copy, otherwise do what is needed on your OS (_i.e._, something like `sudo apt-get\ninstall pandoc pandoc-citeproc`).\n\nThe pdf mode requires a fairly complete LaTeX installation.  On Debian/Ubuntu, the\nfollowing packages should provide a working set:\n\n```\ntexlive-base\ntexlive-binaries\ntexlive-fonts-extra\ntexlive-fonts-recommended\ntexlive-generic-recommended\ntexlive-humanities\ntexlive-latex-base\ntexlive-latex-extra\ntexlive-latex-recommended\ntexlive-pictures\n```\n\n### See Also\n\n#### Other RMarkdown Packages\n\n- [binb](https://github.com/eddelbuettel/binb): Binb is not Beamer: Stylish pdf Presentations from RMarkdown\n- [linl](https://github.com/eddelbuettel/linl): Linl is not Letter: LaTeX letters from RMarkdown\n- [pinp](https://github.com/eddelbuettel/pinp): Pinp is not PNAS: Snazzy one-or two column short papers or vignettes \n\nand the [minm](https://github.com/eddelbuettel/minm) package installing all of them.\n\n#### Sidenotes\n\n[Gwern Branwen](https://gwern.net/sidenote) has a wide-ranging overview of [sidenotes in web design](https://gwern.net/sidenote).\n\n### Authors\n\nDirk Eddelbuettel and Jonathan Gilligan, borrowing heavily from JJ and Yihui in\n[tufte](https://cran.r-project.org/package=tufte), Dave Liepman in the underlying\n[tufte-css](https://github.com/edwardtufte/tufte-css), Jef Lippiat in\n[envisioned css](https://github.com/nogginfuel/envisioned-css) and also relying on the work\nof the [Tufte-LaTeX](https://tufte-latex.github.io/tufte-latex/) authors.\n\n### License\n\nGPL-3 for our parts and the code from [tufte](https://cran.r-project.org/package=tufte),\nmostly MIT for what comes from Dave Liepman and Jef Lippiat.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feddelbuettel%2Ftint","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feddelbuettel%2Ftint","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feddelbuettel%2Ftint/lists"}