{"id":13424234,"url":"https://github.com/yihui/xaringan","last_synced_at":"2025-05-14T04:07:33.639Z","repository":{"id":37793672,"uuid":"74937064","full_name":"yihui/xaringan","owner":"yihui","description":"Presentation Ninja 幻灯忍者 · 写轮眼","archived":false,"fork":false,"pushed_at":"2024-03-23T17:53:46.000Z","size":506,"stargazers_count":1509,"open_issues_count":44,"forks_count":282,"subscribers_count":64,"default_branch":"master","last_synced_at":"2025-04-24T06:02:16.397Z","etag":null,"topics":["markdown","naruto","ninja","presentation","presentation-ninja","r","remarkjs","rmarkdown","rstudio","slideshow"],"latest_commit_sha":null,"homepage":"https://slides.yihui.org/xaringan/","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yihui.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","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},"funding":{"github":["yihui"],"patreon":null,"custom":null}},"created_at":"2016-11-28T04:24:46.000Z","updated_at":"2025-04-17T14:35:03.000Z","dependencies_parsed_at":"2023-12-30T01:24:50.668Z","dependency_job_id":"7eff0366-4090-4413-aa6b-50454efc76f6","html_url":"https://github.com/yihui/xaringan","commit_stats":{"total_commits":401,"total_committers":46,"mean_commits":8.717391304347826,"dds":"0.18703241895261846","last_synced_commit":"8dcfa3f9a0d7f921176d9fde90e2a765c76ee8e7"},"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yihui%2Fxaringan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yihui%2Fxaringan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yihui%2Fxaringan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yihui%2Fxaringan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yihui","download_url":"https://codeload.github.com/yihui/xaringan/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254069216,"owners_count":22009511,"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":["markdown","naruto","ninja","presentation","presentation-ninja","r","remarkjs","rmarkdown","rstudio","slideshow"],"created_at":"2024-07-31T00:00:50.505Z","updated_at":"2025-05-14T04:07:33.598Z","avatar_url":"https://github.com/yihui.png","language":"CSS","funding_links":["https://github.com/sponsors/yihui"],"categories":["CSS","2017","Rmarkdown Templates"],"sub_categories":["Book/monograph Lists and Reviews","Slide"],"readme":"# xaringan\n\n\u003cimg src=\"https://user-images.githubusercontent.com/163582/45438104-ea200600-b67b-11e8-80fa-d9f2a99a03b0.png\" align=\"right\" alt=\"Sharingan\" width=\"180\" /\u003e\n\n[ʃaː.'riŋ.ɡan]\n\n\u003c!-- badges: start --\u003e\n[![R-CMD-check](https://github.com/yihui/xaringan/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/yihui/xaringan/actions/workflows/R-CMD-check.yaml)\n[![CRAN release](https://www.r-pkg.org/badges/version/xaringan)](https://cran.r-project.org/package=xaringan)\n[![Codecov test coverage](https://codecov.io/gh/yihui/xaringan/branch/master/graph/badge.svg)](https://app.codecov.io/gh/yihui/xaringan?branch=master)\n\u003c!-- badges: end --\u003e\n\nAn R package for creating slideshows with [remark.js](https://remarkjs.com) through R Markdown. The package name **xaringan** comes from [Sharingan](https://naruto.fandom.com/wiki/Sharingan), a dōjutsu in Naruto with two abilities: the \"Eye of Insight\" and the \"Eye of Hypnotism\". A presentation ninja should have these basic abilities, and I think remark.js may help you acquire these abilities, even if you are not a member of the Uchiha clan.\n\nPlease see the full documentation as a [presentation here](https://slides.yihui.org/xaringan/) ([中文版在此](https://slides.yihui.org/xaringan/zh-CN.html)). The [remark.js](https://remarkjs.com) website provides a quick introduction to the underlying syntax upon which **xaringan** builds. If you prefer reading a book, **xaringan** is also documented in [the R Markdown book (Chapter 7)](https://bookdown.org/yihui/rmarkdown/xaringan.html). You can use **remotes** to install the package:\n\n```r\nremotes::install_github('yihui/xaringan')\n```\n\nIf you use RStudio, it is easy to get started from the menu `File -\u003e New File -\u003e R Markdown -\u003e From Template -\u003e Ninja Presentation`, and you will see an R Markdown example. Press the `Knit` button to compile it, or use the RStudio Addin `Infinite Moon Reader` to live preview the slides (every time you update and save the Rmd document, the slides will be automatically reloaded; make sure the Rmd document is on focus when you click the addin). Please see the [issue #2](https://github.com/yihui/xaringan/issues/2) if you do not see the template or addin in RStudio.\n\nThe main R Markdown output format in this package is `moon_reader()`. See the R help page `?xaringan::moon_reader` for all possible configurations.\n\n## Slide formatting\n\nThe [remark.js Wiki](https://github.com/gnab/remark/wiki) contains detailed documentation about how to format slides and use the presentation (keyboard shortcuts). The **xaringan** package has simplified several things compared to the official remark.js guide, e.g. you don't need a boilerplate HTML file, you can set the autoplay mode via an option of `moon_reader()`, and LaTeX math basically just works (TM). Please note that remark.js does not support Pandoc's Markdown, so you will not be able to use any fancy Pandoc features, but that is probably fine for presentations. BTW, you can use raw HTML when you feel there is something you desperately want but cannot get from the basic Markdown syntax (e.g. `knitr::kable(head(iris), 'html')`).\n\nAs the package title indicates, this package is designed for ninja. If you are a beginner of HTML/CSS, you may have to stick with the default CSS (which is not bad). The more you know about CSS, the more you can achieve with this package. The sky is your limit.\n\nWe have a [wiki](https://github.com/yihui/xaringan/wiki) that might help you to use CSS to alter the appearance of your presentation. \nMake sure to check it out before opening an issue. \nYou might also consider posting simple usage questions on [stackoverflow](https://stackoverflow.com/questions/tagged/xaringan) using the `#xaringan`tag.\nWe will read all questions with the `#xaringan` tag so please be patient if we don't answer within a day :smile:\n\nDo not forget to try [the option `yolo: true`](https://github.com/yihui/xaringan/issues/1) under `xaringan::moon_reader` in the YAML metadata of your R Markdown document. Big thanks to [Karl Broman](https://slides.yihui.org/xaringan/karl.html)!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyihui%2Fxaringan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyihui%2Fxaringan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyihui%2Fxaringan/lists"}