{"id":13858070,"url":"https://github.com/jennybc/excelgesis","last_synced_at":"2025-04-15T12:31:32.157Z","repository":{"id":16294522,"uuid":"79679137","full_name":"jennybc/excelgesis","owner":"jennybc","description":"Critical explanation or interpretation of ... Excel spreadsheets","archived":false,"fork":false,"pushed_at":"2023-07-12T22:34:52.000Z","size":1787,"stargazers_count":29,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-28T21:02:55.208Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://jennybc.github.io/excelgesis/","language":"R","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/jennybc.png","metadata":{"files":{"readme":"README.Rmd","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2017-01-21T23:17:57.000Z","updated_at":"2025-03-24T22:26:42.000Z","dependencies_parsed_at":"2024-02-09T02:00:26.123Z","dependency_job_id":"bdf2be2a-cfa8-40aa-bd3b-625634a6eaa9","html_url":"https://github.com/jennybc/excelgesis","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jennybc%2Fexcelgesis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jennybc%2Fexcelgesis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jennybc%2Fexcelgesis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jennybc%2Fexcelgesis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jennybc","download_url":"https://codeload.github.com/jennybc/excelgesis/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249072211,"owners_count":21208141,"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":[],"created_at":"2024-08-05T03:01:55.750Z","updated_at":"2025-04-15T12:31:31.108Z","avatar_url":"https://github.com/jennybc.png","language":"R","readme":"---\noutput: github_document\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r, echo = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"README-\"\n)\n```\n\n[![lifecycle](https://img.shields.io/badge/lifecycle-works_for_me-ff69b4.svg)](https://blog.codinghorror.com/the-works-on-my-machine-certification-program/)\n\n# excelgesis\n\nThe goal of excelgesis is to make the XML files inside Excel's `.xlsx` files navigable in a web browser. It's a helper package for the development and debugging of [readxl](http://readxl.tidyverse.org). excelgesis itself is intended for strictly for personal, diagnostic, and recreational use.\n\nDespite zero planning on my part, it works equally well for other Office Open XML File Formats, like Word and PowerPoint. A happy fact pointed out to me [on Twitter](https://twitter.com/tonmcg/status/977214628240408578).\n\nYou can explore some unpacked Excel workbooks here, drawn from the readxl [example](https://github.com/tidyverse/readxl/tree/master/inst/extdata) and [test](https://github.com/tidyverse/readxl/tree/master/tests/testthat/sheets) sheets:\n\n\u003chttps://jennybc.github.io/excelgesis/\u003e\n\nThose same workbooks are available in `.xlsx` form in the excelgesis package. Use `xg_example()` to gain access.\n\nThe definitive reference for `.xlxs` is Standard ECMA-376 Office Open XML File Formats:\n\n  * \u003chttp://www.ecma-international.org/publications/standards/Ecma-376.htm\u003e\n\n## Installation\n\nYou can install excelgesis from github with:\n\n```{r gh-installation, eval = FALSE}\n# install.packages(\"devtools\")\ndevtools::install_github(\"jennybc/excelgesis\")\n```\n\n## Usage\n\nList the included examples.\n\n```{r}\nlibrary(excelgesis)\nxg_example()\n```\n\nBrowse around the underlying XML inside those xlsx workbooks:\n\n\u003chttps://jennybc.github.io/excelgesis/\u003e\n\nHere's how to do the same locally for the example workbook about Clippy:\n\n```{r include = FALSE, error = TRUE}\ntry(fs::dir_delete(\"clippy\"))\ntry(fs::file_delete(\"clippy.xlsx\"))\n```\n\n```{r}\nxg_example(\"clippy\") %\u003e%\n  fs::file_copy(new_path = \".\") %\u003e% \n  xg_inspect()\n```\n\n```{r include = FALSE, error = TRUE}\ntry(fs::dir_delete(\"clippy\"))\ntry(fs::file_delete(\"clippy.xlsx\"))\n```\n\nIn an interactive session, clippy's landing page will open in your browser for  XML browsing fun times.\n\nThe convenience function `xg_inspect()` wraps up three operations:\n\n  * Unzip the ZIP archive -- `xg_unzip()`\n  * Make the unpacked files more pleasant for browsing -- `xg_linkify()`\n  * Visit the top-level 'index.html' in your default browser -- `xg_browse()`\n\nHere's one last worked example using the individual functions.\n\n```{r include = FALSE}\ntry(fs::dir_delete(\"datasets\"))\ntry(fs::file_delete(\"datasets.xlsx\"))\n```\n\n```{r}\n(mg \u003c- xg_example(\"datasets\"))\nmg %\u003e% \n  fs::file_copy(new_path = \".\") %\u003e% \n  xg_unzip() %\u003e% \n  xg_linkify() %\u003e% \n  xg_browse()\n```\n\n```{r include = FALSE}\ntry(fs::dir_delete(\"datasets\"))\ntry(fs::file_delete(\"datasets.xlsx\"))\n```\n\nYou haven't really seen iris or mtcars until you've seen them as XML.\n","funding_links":[],"categories":["R"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjennybc%2Fexcelgesis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjennybc%2Fexcelgesis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjennybc%2Fexcelgesis/lists"}