{"id":29625215,"url":"https://github.com/novartis/rdocx","last_synced_at":"2025-07-21T06:07:40.690Z","repository":{"id":261826825,"uuid":"874342577","full_name":"Novartis/rdocx","owner":"Novartis","description":"Create and edit reporting documents using R","archived":false,"fork":false,"pushed_at":"2024-11-15T17:02:24.000Z","size":18570,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-15T17:40:20.151Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://opensource.nibr.com/rdocx/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Novartis.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,"publiccode":null,"codemeta":null}},"created_at":"2024-10-17T16:51:13.000Z","updated_at":"2024-11-15T16:59:54.000Z","dependencies_parsed_at":"2024-11-08T17:39:07.473Z","dependency_job_id":null,"html_url":"https://github.com/Novartis/rdocx","commit_stats":null,"previous_names":["novartis/rdocx"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Novartis/rdocx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Novartis%2Frdocx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Novartis%2Frdocx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Novartis%2Frdocx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Novartis%2Frdocx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Novartis","download_url":"https://codeload.github.com/Novartis/rdocx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Novartis%2Frdocx/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266248501,"owners_count":23899056,"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":"2025-07-21T06:07:40.254Z","updated_at":"2025-07-21T06:07:40.679Z","avatar_url":"https://github.com/Novartis.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r, include = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"man/figures/README-\",\n  out.width = \"100%\"\n)\n```\n\n# rdocx\n\n# rdocx \u003cimg src=\"man/figures/hex-rdocx.png\" align=\"right\" width=\"80\" alt=\"rdocx website\" /\u003e\u003c/a\u003e\n\n\u003c!-- badges: start --\u003e\n[![R-CMD-check.yaml](https://github.com/Novartis/rdocx/actions/workflows/check_package.yml/badge.svg)](https://github.com/Novartis/rdocx/actions/workflows/check_package.yml)\n[![pkgdown](https://github.com/Novartis/rdocx/actions/workflows/pkgdown.yml/badge.svg)](https://github.com/Novartis/rdocx/actions/workflows/pkgdown.yml)\n\u003c!-- badges: end --\u003e\n\n\n## Introduction\n\nIn clinical trials we work in interdisciplinary teams where the discussion of outputs is often facilitated using static documents. We wanted to bring the advantages of modern tools (R, markdown, git) and software development practices to the production of company documents. We used an object-oriented approach to create classes for report items with a suite of tests. Finally, the report is rendered programmatically in docx format using a company template. This enables our statisticians to work in a truly end to end fashion within a GxP environment with the end product in a format suitable for interdisciplinary collaboration.\n\nFor the open-source version of our package we have replaced our company template/s with a generic template that demonstrates the functionality of the package. In most cases, you prefer to provide a custom template to enforce your desired formatting. In that case, please ensure that the classes are compatible with your template and adjust as needed. \n\n## The use cases\n\nAs for now, there are two main applications of **{rdocx}**:\n\n-   [Generic Report](https://opensource.nibr.com/rdocx/articles/generic_report.html): As our first use case, the Generic Report Rmd template allows the user to create a report in RMarkdown and render it directly from R into a Word document following the style of the Generic Report Word template that is used as a reference document by the Generic Report Rmd template.\n\n-   [Automated Reporting](https://opensource.nibr.com/rdocx/articles/automated_reporting.html): Allows the user to automatically update all or selected tables/figures in a Word document.\n\n## Installation\n\n**{rdocx}** can be installed from Gitlab using (update before pushing to Github)\n\n```{r, eval=FALSE}\ndevtools::install_github(\"Novartis/rdocx\",\n                         ref='main',\n                         build_vignettes=TRUE,\n                         lib='~/R')\n```\n\nRemember to set the parameter `lib` to the desired location for installation, as \nit will be installed in your local directory.\n\n## Usage\n\n```{r, eval=FALSE}\nlibrary('rdocx', lib.loc=\"~/R\")\n```\n\nFor quick access to the documentation, visit [rdocx site](https://opensource.nibr.com/rdocx/index.html). Read the vignettes on how to use the package with step-by-step examples online:\n\n-   [Generic Report](https://opensource.nibr.com/rdocx/articles/generic_report.html) \n\n-   [Automated Reporting](https://opensource.nibr.com/rdocx/articles/automated_reporting.html)\n\n\nOr call the vignettes directly in R:\n\n```{r, eval=FALSE}\nvignette(\"generic_report\", package = \"rdocx\")\n```\n\n```{r, eval=FALSE}\nvignette(\"automated_reporting\", package = \"rdocx\")\n```\n\n\n## Class Structure Overview\n\nThe structure of the package is displayed in a simplified format below. Note that \nfurther helper and checking functions exist that are not visualised here for simplicity.\n\n![](https://mermaid.ink/img/pako:eNqtlVFr2zAQx7-K0dPG2n6A0JeywR432j4axEW-2AJZ8qRTXVPy3SdbTuLIclhhDgRb99Pp_n-d7A8mTIVsx4QC535IqC20pS7C9RM1WimesTOWisf7--JVksLfUOMW8L0BXaMy9Svs1Sb1JEi-SRpuQi-y1kDeoltgT55MC4RVBKWuJzY8KRD4y1PnyRWRva6leHx4SIaeTR_JZKkJTcbObPyfzEqK_oihY6mXTKbiC5gmPPt7YsbrmyM7TrNTAk4js45W2IGlFjWtY458NWxNjEHt2z3aXDSY4Nbjb2idNDpTR9C6Ht17xyeJi9BB4TtNfovTtnC6bHXCuPN-rKAaZ1d4F6z78nXT3qQjlh5DVXFr-tPkS96R_OeUoUtyO5f3ZNPCvhm47_KT-gaIR7-qRVRjvyhyWWDa2_9D9Pps5FRraD_Zp4nka1FpEVcvkdz6MAPrSAtSc_DUGMvzVUZiTsDzW_FH3M4xxjcy3DZ5qTJ5s2VkErYBIeSVEe_8IBXmyzExRTgj1GSsNyLM1aBuZBjabHQUI6Cj0MvhbBoesKuOiq3MQSk-17BSPf7YHWvRBuOr8DGadJaMGgxLsV24rfAAXlHJSn0MaHDevAxasB1Zj3fMGl83bHcA5cJTXHL-mEXk-BeGPjNY?type=png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnovartis%2Frdocx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnovartis%2Frdocx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnovartis%2Frdocx/lists"}