Merge pull request #52 from miraisolutions/feature/26-revise-target-blank

Revise default target blank

Author: riccardoporreca

index.Rmd

@@ -8,11 +8,8 @@ site: bookdown::bookdown_site
 output:
   bookdown::gitbook:
     css: styles.css
-    includes:
-      in_header: target-blank.html
-    pandoc_args: ["--number-offset=0"]
-    # disable alt text rendered as figure caption
     split_by: section
+    # disable alt text rendered as figure caption
     fig_caption: false
     config:
       sharing:
@@ -31,7 +28,7 @@ mod_date_envir <- list2env(list(knitr_current_input = knitr::current_input()))
 cat(knitr::knit_child("mod-date.Rmd", quiet = TRUE, envir = mod_date_envir))
 ```
 
-[**Mirai Solutions**](https://mirai-solutions.ch/) is a Zurich-based software development and consultancy firm, delivering cutting-edge technology and best practices to the industry, helping companies elevate their data analytics and operations.
+[**Mirai Solutions**](https://mirai-solutions.ch/){target="_blank"} is a Zurich-based software development and consultancy firm, delivering cutting-edge technology and best practices to the industry, helping companies elevate their data analytics and operations.
 
 We are an interdisciplinary team of data scientists, software engineers, business consultants and IT architects with specialist knowledge ranging from finance and risk management to math/stats techniques to software development and project management.
 
@@ -49,4 +46,4 @@ In this e-book, we share technical guidelines, how-tos and best practices around
 
 ![Python Logo](python-logo-only.png)
 
-If instead you are more interested in **Python**, you can access our free Python training material [**here**](https://mirai-solutions.ch/py-techguides).
+If instead you are more interested in **Python**, you can access our free Python training material [**here**](https://mirai-solutions.ch/py-techguides){target="_blank"}.

renv.Rmd

@@ -9,7 +9,7 @@ mod_date_envir <- list2env(list(knitr_current_input = knitr::current_input()))
 cat(knitr::knit_child("mod-date.Rmd", quiet = TRUE, envir = mod_date_envir))
 ```
 
-For production readiness --- and project safety --- it is important to control the dependencies of a piece of development. This can be done at project level using the package [`renv`](https://rstudio.github.io/renv/).
+For production readiness --- and project safety --- it is important to control the dependencies of a piece of development. This can be done at project level using the package [`renv`](https://rstudio.github.io/renv/){target="_blank"}.
 
 In an `renv` project, dependencies are resolved and tracked in a lock-file. As a new R session starts, `renv` detects whether installed dependencies are out of sync compared to the lock-file, ensuring the same virtual environment applies each time the project is opened.
 
@@ -27,7 +27,7 @@ install.packages("renv")
 
 ## Set-up an `renv` project
 
-In order resolve and track dependencies of a project, `renv` needs to discover what the required packages are. Although `renv` supports discovering dependencies by scanning all files in the project (_implicit mode_), we strongly advise to define the required dependencies in a `DESCRIPTION` file, and rely on `renv`'s _explicit mode_ (see ['Snapshot types'](https://rstudio.github.io/renv/reference/snapshot.html#snapshot-types) in the documentation for details).
+In order resolve and track dependencies of a project, `renv` needs to discover what the required packages are. Although `renv` supports discovering dependencies by scanning all files in the project (_implicit mode_), we strongly advise to define the required dependencies in a `DESCRIPTION` file, and rely on `renv`'s _explicit mode_ (see ['Snapshot types'](https://rstudio.github.io/renv/reference/snapshot.html#snapshot-types){target="_blank"} in the documentation for details).
 
 To initialize `renv` for a project where dependencies are explicitly stated in the `DESCRIPTION` file, run:
 
@@ -93,7 +93,7 @@ If the `DESCRIPTION` file does not request a specific package version, `renv` wi
 options(repos = "https://packagemanager.posit.co/cran/2024-01-02")
 ```
 
-Date-based CRAN snapshots have built-in support in `renv` with [`renv::checkout()`](https://rstudio.github.io/renv/reference/checkout.html), w/o the need for `(options(repos = ...))`:
+Date-based CRAN snapshots have built-in support in `renv` with [`renv::checkout()`](https://rstudio.github.io/renv/reference/checkout.html){target="_blank"}, w/o the need for `(options(repos = ...))`:
 
 ```{r , echo = TRUE, eval = FALSE}
 # check out packages from PPM using the date '2023-01-02'

roxygen-guidelines.Rmd

@@ -20,8 +20,8 @@ This is based on:
 
 - **roxygen2** vignettes: `browseVignettes("roxygen2")`, in particular
 [Generating Rd
-files](https://cran.r-project.org/web/packages/roxygen2/vignettes/rd.html).
-- The [tidyverse style guide](https://style.tidyverse.org/documentation.html).
+files](https://cran.r-project.org/web/packages/roxygen2/vignettes/rd.html){target="_blank"}.
+- The [tidyverse style guide](https://style.tidyverse.org/documentation.html){target="_blank"}.
 - Package development experience.
 
 Examples are provided to show the concrete application of the described
@@ -94,7 +94,7 @@ bottom and in this order.
     - For **un-exported** objects documented for internal purposes, specify
     `@keywords internal` instead of `@export`.
 - Use
-[**markdown**](https://cran.r-project.org/web/packages/roxygen2/vignettes/rd-formatting.html):
+[**markdown**](https://cran.r-project.org/web/packages/roxygen2/vignettes/rd-formatting.html){target="_blank"}:
 If not done at package level, `@md` should be the last element (so it can easily
 be removed when moving to package-level).
 - Do not use `@rdname` if not documenting multiple objects (see below).
@@ -135,7 +135,7 @@ Several techniques and tools are available to enable and support a more
 consistent and maintainable documentation.
 
 This can be described in detail in the [Do repeat
-yourself](https://cran.r-project.org/web/packages/roxygen2/vignettes/rd.html#do-repeat-yourself)
+yourself](https://cran.r-project.org/web/packages/roxygen2/vignettes/rd.html#do-repeat-yourself){target="_blank"}
 section of vignette _Generating Rd files_, and are summarized as follows
 
 - Cross-link documentation files with `@seealso` and `@family`.
@@ -174,7 +174,7 @@ man-roxygen/ex-<FUNCTION_NAME>.R`.
 
 Tags `@rdname` and `@describeIn` are a convenient way to document multiple
 functions in the same file. See the roxygen2 vignette [Generating Rd
-files](https://cran.r-project.org/web/packages/roxygen2/vignettes/rd.html)
+files](https://cran.r-project.org/web/packages/roxygen2/vignettes/rd.html){target="_blank"}
 (`vignette("rd", package = "roxygen2")`) for more detail.
 
 In both case, not that `@title` should be specified only for the _main_