Skip to content

Commit fa0bbcf

Browse files
committed
pkgdown website edits + README
1 parent 356185e commit fa0bbcf

5 files changed

Lines changed: 107 additions & 14 deletions

File tree

.github/workflows/R-CMD-check.yaml

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# Workflow derived from https://github.com/r-lib/actions/tree/v2/examples
2+
# Need help debugging build failures? Start at https://github.com/r-lib/actions#where-to-find-help
3+
on:
4+
push:
5+
branches: [main, master]
6+
pull_request:
7+
8+
name: R-CMD-check.yaml
9+
10+
permissions: read-all
11+
12+
jobs:
13+
R-CMD-check:
14+
runs-on: ${{ matrix.config.os }}
15+
16+
name: ${{ matrix.config.os }} (${{ matrix.config.r }})
17+
18+
strategy:
19+
fail-fast: false
20+
matrix:
21+
config:
22+
- {os: macos-latest, r: 'release'}
23+
- {os: windows-latest, r: 'release'}
24+
- {os: ubuntu-latest, r: 'devel', http-user-agent: 'release'}
25+
- {os: ubuntu-latest, r: 'release'}
26+
- {os: ubuntu-latest, r: 'oldrel-1'}
27+
28+
env:
29+
GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
30+
R_KEEP_PKG_SOURCE: yes
31+
32+
steps:
33+
- uses: actions/checkout@v4
34+
35+
- uses: r-lib/actions/setup-pandoc@v2
36+
37+
- uses: r-lib/actions/setup-r@v2
38+
with:
39+
r-version: ${{ matrix.config.r }}
40+
http-user-agent: ${{ matrix.config.http-user-agent }}
41+
use-public-rspm: true
42+
43+
- uses: r-lib/actions/setup-r-dependencies@v2
44+
with:
45+
extra-packages: any::rcmdcheck
46+
needs: check
47+
48+
- uses: r-lib/actions/check-r-package@v2
49+
with:
50+
upload-snapshots: true
51+
build_args: 'c("--no-manual","--compact-vignettes=gs+qpdf")'

.gitignore

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,3 +52,5 @@ docs
5252
inst/doc
5353
/doc/
5454
/Meta/
55+
56+
/.quarto/

README.Rmd

Lines changed: 19 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,31 @@ output: github_document
66
knitr::opts_chunk$set(echo = TRUE)
77
```
88

9-
# o2ools <a href="https://cygei.github.io/o2ools/"><img src="man/figures/logo.png" align="right" height="138" alt="o2ools website" /></a>
9+
<!-- badges: start -->
10+
[![R-CMD-check](https://github.com/CyGei/o2ools/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/CyGei/o2ools/actions/workflows/R-CMD-check.yaml)
11+
[![CodeFactor](https://www.codefactor.io/repository/github/cygei/o2ools/badge)](https://www.codefactor.io/repository/github/cygei/o2ools)
12+
<!-- badges: end -->
1013

11-
Tools to process the results of [outbreaker2](https://github.com/reconhub/outbreaker2).
14+
# o2ools <a href="https://cygei.github.io/o2ools/"><img src="man/figures/logo.png" alt="o2ools website" align="right" height="242"/></a>
15+
16+
Tools to process the results of [`outbreaker2`](https://github.com/reconhub/outbreaker2).
1217

1318
## Installation
1419

20+
Install the package from [CRAN](https://cran.r-project.org/web/packages/o2ools/index.html):
21+
1522
```{r, eval=FALSE}
16-
# install.packages("devtools")
17-
devtools::install_github("CyGei/o2ools")
23+
install.packages("o2ools")
1824
library(o2ools)
1925
```
2026

21-
## Documentation
27+
Or the development version from GitHub:
28+
29+
```{r, eval=FALSE}
30+
devtools::install_github("cygei/o2ools")
31+
```
32+
33+
## Information
2234

23-
For more information, check the vignettes on its dedicated website: [o2ools](https://cygei.github.io/o2ools/)
35+
The inference of transmission chains from genomic, epidemiological and contact data is central to outbreak investigations. [`outbreaker2`](https://github.com/reconhub/outbreaker2) and other popular models use Bayesian inference to reconstruct who infected whom. However, the results of these models are difficult to interpret and visualise.
36+
`o2ools` provides tools to analyse and visualise the results of `outbreaker2`. To get started, check the package [vignette](https://cygei.github.io/o2ools/articles/o2ools.html).

README.md

Lines changed: 27 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,38 @@
11

2-
# o2ools <a href="https://cygei.github.io/o2ools/"><img src="man/figures/logo.png" align="right" height="138" alt="o2ools website" /></a>
2+
<!-- badges: start -->
3+
4+
[![R-CMD-check](https://github.com/CyGei/o2ools/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/CyGei/o2ools/actions/workflows/R-CMD-check.yaml)
5+
[![CodeFactor](https://www.codefactor.io/repository/github/cygei/o2ools/badge)](https://www.codefactor.io/repository/github/cygei/o2ools)
6+
<!-- badges: end -->
7+
8+
# o2ools <a href="https://cygei.github.io/o2ools/"><img src="man/figures/logo.png" alt="o2ools website" align="right" height="242"/></a>
39

410
Tools to process the results of
5-
[outbreaker2](https://github.com/reconhub/outbreaker2).
11+
[`outbreaker2`](https://github.com/reconhub/outbreaker2).
612

713
## Installation
814

15+
Install the package from
16+
[CRAN](https://cran.r-project.org/web/packages/o2ools/index.html):
17+
918
``` r
10-
# install.packages("devtools")
11-
devtools::install_github("CyGei/o2ools")
19+
install.packages("o2ools")
1220
library(o2ools)
1321
```
1422

15-
## Documentation
23+
Or the development version from GitHub:
24+
25+
``` r
26+
devtools::install_github("cygei/o2ools")
27+
```
28+
29+
## Information
1630

17-
For more information, check the vignettes on its dedicated website:
18-
[o2ools](https://cygei.github.io/o2ools/)
31+
The inference of transmission chains from genomic, epidemiological and
32+
contact data is central to outbreak investigations.
33+
[`outbreaker2`](https://github.com/reconhub/outbreaker2) and other
34+
popular models use Bayesian inference to reconstruct who infected whom.
35+
However, the results of these models are difficult to interpret and
36+
visualise. `o2ools` provides tools to analyse and visualise the results
37+
of `outbreaker2`. To get started, check the package
38+
[vignette](https://cygei.github.io/o2ools/articles/o2ools.html).

_pkgdown.yml

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,11 @@
11
url: https://cygei.github.io/o2ools/
22
template:
33
bootstrap: 5
4-
4+
bslib:
5+
bootswatch: lux
6+
pkgdown-nav-height: 100px
7+
repo:
8+
url:
9+
home: https://github.com/CyGei/o2ools
10+
issue: https://github.com/CyGei/o2ools/issues
11+
user: https://github.com/CyGei

0 commit comments

Comments
 (0)