feat: add support for ROR in package documentation

Author: maelle

DESCRIPTION

@@ -7,7 +7,8 @@ Authors@R: c(
     person("Peter", "Danenberg", , "[email protected]", role = c("aut", "cph")),
     person("Gábor", "Csárdi", , "[email protected]", role = "aut"),
     person("Manuel", "Eugster", role = c("aut", "cph")),
-    person("Posit Software, PBC", role = c("cph", "fnd"))
+    person("Posit Software, PBC", role = c("cph", "fnd"),
+           comment = c(ROR = "03wc8by49"))
   )
 Description: Generate your Rd documentation, 'NAMESPACE' file, and
     collation field using specially formatted comments. Writing

NEWS.md

@@ -1,5 +1,7 @@
 # roxygen2 (development version)
 
+* Package documentation now converts ROR IDs into a useful link (#1698, @maelle).
+
 * The check for unexported S3 methods was improved, so it does not hang any more
   if a largish data object is in the package (#1593, @jranke).
 

R/object-package.R

@@ -66,6 +66,16 @@ author_desc <- function(x) {
       }
       x$comment <- x$comment[!names(x$comment) %in% "ORCID"]
     }
+    if (has_name(x$comment, "ROR")) {
+      ror <- x$comment[["ROR"]]
+
+      if (grepl("https?://", ror)) {
+        desc <- paste0(desc, " (\\href{", ror, "}{ROR})")
+      } else {
+        desc <- paste0(desc, " (\\href{https://ror.org/", ror, "}{ROR})")
+      }
+      x$comment <- x$comment[!names(x$comment) %in% "ROR"]
+    }
 
     if (length(x$comment) > 0) {
       desc <- paste0(desc, " (", x$comment, ")")

man/roxygen2-package.Rd

@@ -23,6 +23,19 @@
       person_desc(comment = c(ORCID = "1234", "extra"))
     Output
       [1] "H W \\email{[email protected]} (\\href{https://orcid.org/1234}{ORCID}) (extra)"
+    Code
+      # ROR comments
+      person_desc(comment = c(ROR = "03wc8by49"))
+    Output
+      [1] "H W \\email{[email protected]} (\\href{https://ror.org/03wc8by49}{ROR})"
+    Code
+      person_desc(comment = c(ROR = "https://ror.org/03wc8by49"))
+    Output
+      [1] "H W \\email{[email protected]} (\\href{https://ror.org/03wc8by49}{ROR})"
+    Code
+      person_desc(comment = c(ROR = "03wc8by49", "extra"))
+    Output
+      [1] "H W \\email{[email protected]} (\\href{https://ror.org/03wc8by49}{ROR}) (extra)"
 
 # useful message if Authors@R is corrupted
 

tests/testthat/_snaps/object-package.md

@@ -15,6 +15,11 @@ test_that("person turned into meaningful text", {
     person_desc(comment = c("ORCID" = "1234"))
     person_desc(comment = c("ORCID" = "https://orcid.org/1234"))
     person_desc(comment = c("ORCID" = "1234", "extra"))
+
+    "ROR comments"
+    person_desc(comment = c("ROR" = "03wc8by49"))
+    person_desc(comment = c("ROR" = "https://ror.org/03wc8by49"))
+    person_desc(comment = c("ROR" = "03wc8by49", "extra"))
   })
 })