gitdevr/index.qmd at main · dieghernan/gitdevr · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
---
format: gfm
default-image-extension: ''
knitr:
  opts_chunk:
    collapse: true
    comment: '#>'
    fig.path: "man/figures/README-"
    out.width: "100%"
---

<!-- index.md is generated from index.qmd. Please edit that file -->

# gitdevr <a href="https://dieghernan.github.io/gitdevr/"><img src="man/figures/logo.png" alt="gitdevr website" align="right" height="139"/></a>

<!-- badges: start -->

[![Lifecycle:
experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html#experimental)
[![.github/workflows/check-simple.yaml](https://github.com/dieghernan/gitdevr/actions/workflows/check-simple.yaml/badge.svg)](https://github.com/dieghernan/gitdevr/actions/workflows/check-simple.yaml)

<!-- badges: end -->

## Overview

**gitdevr** provides a custom [pkgdown](https://pkgdown.r-lib.org) template
based on the [GitDev skin](https://dieghernan.github.io/chulapa/skins/gitdev)
provided with my Jekyll theme [chulapa](https://dieghernan.github.io/chulapa/).

See a preview of the template in <https://dieghernan.github.io/gitdevr/>

## Installation

You can install the developing version of **gitdevr** with:

```{r}
#| eval: false
pak::pak("dieghernan/gitdevr")
```

Alternatively, you can install **gitdevr** using the
[r-universe](https://dieghernan.r-universe.dev/gitdevr):

```{r}
#| eval: false

# Install gitdevr in R:
install.packages(
  "gitdevr",
  repos = c(
    "https://dieghernan.r-universe.dev",
    "https://cloud.r-project.org"
  )
)
```

## Usage

After the successful installation, if you already have your **pkgdown** setup
ready, you only need to specify the `template` parameter as follow. Then, as
before, you can build your site using `pkgdown::build_site()`.

:::: code-with-filename
::: code-with-filename-file
```{=html}
<pre><strong>.pkgdown.yaml</strong></pre>
```

``` yaml
template:
  bootstrap: 5
  package: gitdevr
```
:::
::::

```{=html}
<div class="callout callout-style-default callout-important callout-titled">
<div class="callout-header d-flex align-content-center">
<div class="callout-icon-container"><i class="callout-icon"></i></div>
<div class="callout-title-container flex-fill">Important</div>
</div>
<div class="callout-body-container callout-body">
```

Keep in mind that you should NOT use `default_assets: false` when you change the
default template. **gitdevr** relies on some of the **pkgdown** assets and
templates.

```{=html}
</div>
</div>
```

It is recommended to add the following line to your `DESCRIPTION`:

:::: code-with-filename
::: code-with-filename-file
```{=html}
<pre><strong>DESCRIPTION</strong></pre>
```

```
Config/Needs/website: dieghernan/gitdevr
```
:::
::::

By doing so, when using [r-lib
actions](https://github.com/r-lib/actions/tree/v2-branch/setup-r-dependencies)
for deploying your site, the github action would install the package for you
automatically.