Skip to content

Commit

Permalink
Built site for gh-pages
Browse files Browse the repository at this point in the history
  • Loading branch information
@mjfrigaard
mjfrigaard committed Feb 17, 2024
1 parent 731da8f commit 2c811f0
Show file tree
Hide file tree
Showing 48 changed files with 5,700 additions and 3,928 deletions.
2 changes: 1 addition & 1 deletion .nojekyll
View file
Original file line number Diff line number Diff line change
@@ -1 +1 @@
42f3f7e9
d22ad08e
58 changes: 55 additions & 3 deletions Entanglement.qmd
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Entanglement {#sec-entanglement}
# Dependency hell {#sec-entanglement}

[Tools to avoid [dependency hell](https://en.wikipedia.org/wiki/Dependency_hell)]{style="font-size: 1.40em; font-style: italic"}
[Mastering dependency management]{style="font-size: 1.40em; font-style: italic"}

```{r}
#| eval: true
Expand All @@ -23,7 +23,59 @@ co_box(
)
```

This chapter covers a few packages and tools to help explore, understand and keep track of your app-package dependencies. It's not likely you'll build an application that *only* relies on `shiny`, so it's important to 1) know the packages and versions required for your application to function, and 2) ensure these packages are included in the correct `DESCRIPTION` field (or `NAMESPACE`).
This chapter covers a few packages and tools to help explore, understand and keep track of your app-package dependencies.[^depends-hell] It's not likely you'll build an application that *only* relies on `shiny`, so it's important to 1) know the packages and versions required for your application to function, and 2) ensure these packages are included in the correct `DESCRIPTION` field (or `NAMESPACE`).

[^depends-hell]: Try to avoid [dependency hell](https://en.wikipedia.org/wiki/Dependency_hell).

:::: {.callout-tip collapse='true' appearance='simple'}

## [Accessing applications]{style='font-weight: bold; font-size: 1.15em;'}

::: {style='font-size: 0.95em; color: #282b2d;'}

I've created the [`shinypak` R package](https://mjfrigaard.github.io/shinypak/) In an effort to make each section accessible and easy to follow:

Install `shinypak` using `pak` (or `remotes`):

```{r}
#| code-fold: false
#| message: false
#| warning: false
#| eval: false
# install.packages('pak')
pak::pak('mjfrigaard/shinypak')
```

Review the chapters in each section:

```{r}
#| code-fold: false
#| message: false
#| warning: false
#| collapse: true
library(shinypak)
list_apps(regex = '^06')
```

Launch the app:

```{r}
#| code-fold: false
#| eval: false
launch(app = "<branch>")
```

Download the app:

```{r}
#| code-fold: false
#| eval: false
get_app(app = "<branch>")
```

:::

::::

## Exploring dependencies

Expand Down
607 changes: 330 additions & 277 deletions app_data.html
View file

Large diffs are not rendered by default.

80 changes: 43 additions & 37 deletions app_packages.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -280,81 +280,93 @@
</li>
<li class="sidebar-item sidebar-item-section">
<div class="sidebar-item-container">
<a href="./deploy.html" class="sidebar-item-text sidebar-link">
<span class="menu-text">Deploy</span></a>
<a href="./code.html" class="sidebar-item-text sidebar-link">
<span class="menu-text">Code</span></a>
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-4" aria-expanded="true" aria-label="Toggle section">
<i class="bi bi-chevron-right ms-2"></i>
</a>
</div>
<ul id="quarto-sidebar-section-4" class="collapse list-unstyled sidebar-section depth1 show">
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./docker.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">15</span>&nbsp; <span class="chapter-title">Docker</span></span></a>
<a href="./css.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">15</span>&nbsp; <span class="chapter-title">CSS</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./cicd.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">16</span>&nbsp; <span class="chapter-title">CI/CD</span></span></a>
<a href="./js.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">16</span>&nbsp; <span class="chapter-title">JavaScript</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./python.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">17</span>&nbsp; <span class="chapter-title">Python</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./style.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">18</span>&nbsp; <span class="chapter-title">Style</span></span></a>
</div>
</li>
</ul>
</li>
<li class="sidebar-item sidebar-item-section">
<div class="sidebar-item-container">
<a href="./frameworks.html" class="sidebar-item-text sidebar-link">
<span class="menu-text">Frameworks</span></a>
<a href="./deploy.html" class="sidebar-item-text sidebar-link">
<span class="menu-text">Deploy</span></a>
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-5" aria-expanded="true" aria-label="Toggle section">
<i class="bi bi-chevron-right ms-2"></i>
</a>
</div>
<ul id="quarto-sidebar-section-5" class="collapse list-unstyled sidebar-section depth1 show">
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./golem.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">17</span>&nbsp; <span class="chapter-title"><code>golem</code></span></span></a>
<a href="./docker.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">19</span>&nbsp; <span class="chapter-title">Docker</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./leprechaun.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">18</span>&nbsp; <span class="chapter-title"><code>leprechaun</code></span></span></a>
<a href="./cicd.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">20</span>&nbsp; <span class="chapter-title">CI/CD</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./rhino.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">19</span>&nbsp; <span class="chapter-title"><code>rhino</code></span></span></a>
<a href="./pkgdown.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">21</span>&nbsp; <span class="chapter-title">pkgdown</span></span></a>
</div>
</li>
</ul>
</li>
<li class="sidebar-item sidebar-item-section">
<div class="sidebar-item-container">
<a href="./non_r_code.html" class="sidebar-item-text sidebar-link">
<span class="menu-text">Non-R code</span></a>
<a href="./frameworks.html" class="sidebar-item-text sidebar-link">
<span class="menu-text">Frameworks</span></a>
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-6" aria-expanded="true" aria-label="Toggle section">
<i class="bi bi-chevron-right ms-2"></i>
</a>
</div>
<ul id="quarto-sidebar-section-6" class="collapse list-unstyled sidebar-section depth1 show">
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./css.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">20</span>&nbsp; <span class="chapter-title">CSS</span></span></a>
<a href="./golem.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">22</span>&nbsp; <span class="chapter-title">golem</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./js.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">21</span>&nbsp; <span class="chapter-title">JavaScript</span></span></a>
<a href="./leprechaun.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">23</span>&nbsp; <span class="chapter-title">leprechaun</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./python.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">22</span>&nbsp; <span class="chapter-title">Python</span></span></a>
<a href="./rhino.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">24</span>&nbsp; <span class="chapter-title">rhino</span></span></a>
</div>
</li>
</ul>
Expand All @@ -371,25 +383,25 @@
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./debugging.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">23</span>&nbsp; <span class="chapter-title">Debugging</span></span></a>
<span class="menu-text"><span class="chapter-number">25</span>&nbsp; <span class="chapter-title">Debugging</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./app_data.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">24</span>&nbsp; <span class="chapter-title">App data</span></span></a>
<span class="menu-text"><span class="chapter-number">26</span>&nbsp; <span class="chapter-title">App data</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./stack_traces.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">25</span>&nbsp; <span class="chapter-title">Stack traces</span></span></a>
<span class="menu-text"><span class="chapter-number">27</span>&nbsp; <span class="chapter-title">Stack traces</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./entanglement.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">26</span>&nbsp; <span class="chapter-title">Entanglement</span></span></a>
<span class="menu-text"><span class="chapter-number">28</span>&nbsp; <span class="chapter-title">Dependency hell</span></span></a>
</div>
</li>
</ul>
Expand Down Expand Up @@ -438,17 +450,11 @@
<a href="./comparisons.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">F</span>&nbsp; <span class="chapter-title">Comparisons</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./style.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">G</span>&nbsp; <span class="chapter-title">Style</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./rhino_cicd.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">H</span>&nbsp; <span class="chapter-title">Rhino CI/CD</span></span></a>
<span class="menu-text"><span class="chapter-number">G</span>&nbsp; <span class="chapter-title">Rhino CI/CD</span></span></a>
</div>
</li>
</ul>
Expand Down Expand Up @@ -504,19 +510,19 @@ <h1 class="title"><span id="sec-app-pkgs" class="quarto-section-identifier">App-


<div class="callout callout-style-simple callout-note no-icon callout-titled">
<div class="callout-header d-flex align-content-center" data-bs-toggle="collapse" data-bs-target=".callout-1-contents" aria-controls="callout-1" aria-expanded="true" aria-label="Toggle callout">
<div class="callout-header d-flex align-content-center" data-bs-toggle="collapse" data-bs-target=".callout-1-contents" aria-controls="callout-1" aria-expanded="false" aria-label="Toggle callout">
<div class="callout-icon-container">
<i class="callout-icon no-icon"></i>
</div>
<div class="callout-title-container flex-fill">
<span style="font-weight: bold; font-size: 1.10em;">Contribute</span>
<span style="font-weight: bold; font-size: 1.10em;">See a typo, error, or something missing?</span>
</div>
<div class="callout-btn-toggle d-inline-block border-0 py-1 ps-1 pe-0 float-end"><i class="callout-toggle"></i></div>
</div>
<div id="callout-1" class="callout-1-contents callout-collapse collapse show">
<div id="callout-1" class="callout-1-contents callout-collapse collapse">
<div class="callout-body-container callout-body">
<div style="font-size: 0.95em; color: #282b2d;">
<p>See a typo, error, or something missing? Please open an issue on <a href="https://github.com/mjfrigaard/shiny-app-pkgs/issues/new">GitHub</a></p>
<p>Please open an issue on <a href="https://github.com/mjfrigaard/shiny-app-pkgs/issues/new">GitHub</a></p>
</div>
</div>
</div>
Expand Down
Loading

0 comments on commit 2c811f0

Please sign in to comment.