The hardware and bandwidth for this mirror is donated by METANET, the Webhosting and Full Service-Cloud Provider.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]metanet.ch.

readme2vignette

The goal of readme2vignette is to attempt to install a package directly GitHub or CRAN with convert README.md to Vignette during Package installation.

Based on remotes::install_github() and remotes::install_cran() that remotes version 2.4.2.

Installation

You can install the released version of readme2vignette from CRAN with:

install.packages("readme2vignette")

You can install the development version of readme2vignette like so:

install.packages("remotes")
remotes::install_github("indenkun/readme2vignette")

Example

install_cran_with_readme()

The basic usage is the same as remotes::install_cran().

If you try to install a package with README.md but no vignette from CRAN Repository using readme2vignette::install_cran_with_readme(), by default the argument readme_to_vignette is TRUE and the contents of README.md becomes a vignette called README.

Installation from binary packages is not supported. Installation must always be done from the sourceco package.

readme2vignette::install_github_with_readme("MissMech")

Therefore, the contents of README.md can be referenced in the local environment by vignette("README", package = "packagename").

vignette("README", package = "MissMech")

install_github_with_reademe()

The basic usage is the same as remotes::install_github().

If you try to install a package with README.md but no vignette from GitHub using readme2vignette::install_github_with_readme(), by default the argument readme_to_vignette is TRUE and the contents of README.md becomes a vignette called README.

readme2vignette::install_github_with_readme("indenkun/MissMech")

Therefore, the contents of README.md can be referenced in the local environment by vignette("README", package = "packagename").

vignette("README", package = "MissMech")

Note

The remotes package on which this code is based was created by the author of remotes and is now released at MIT.

The author of the remotes package is currently listed as Developed by Gábor Csárdi, Jim Hester, Hadley Wickham, Winston Chang, Martin Morgan, Dan Tenenbaum, Posit Software, PBC.

See r-lib/remote for detailed authorship.

Under the current specification, the images in the README.md are copied for the figures in the directories under man/figures/, but not for the images in other directories, which are missing.

License

MIT

Imports packages

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.