Skip to content

Commit b244aa8

Browse files
authored
update linux install
1 parent 858edc6 commit b244aa8

File tree

1 file changed

+20
-24
lines changed

1 file changed

+20
-24
lines changed

learners/setup.md

Lines changed: 20 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -167,7 +167,7 @@ its website at <https://pandoc.org/installing.html>
167167

168168
#### Test your installation
169169

170-
We will wait to test the pandoc installation after we install the
170+
We will wait to test the pandoc installation after we have installed the
171171
infrastructure packages, to make sure it's discoverable by R.
172172

173173
### Infrastructure R packages
@@ -289,7 +289,7 @@ follow the instructions to install pandoc on your computer.
289289

290290
#### Test your installation
291291

292-
We will wait to test the pandoc installation after we install the
292+
We will wait to test the pandoc installation after we have installed the
293293
infrastructure packages, to make sure it's discoverable by R.
294294

295295
### Infrastructure R packages
@@ -311,20 +311,18 @@ install.packages(c("sandpaper", "varnish", "pegboard"))
311311

312312
## Installing on Linux {#linux}
313313

314-
A lot of the documentation for Linux is nuanced because it assumes that if you
315-
use Linux, then you automatically know how to install things by the command
316-
line. I will be providing instructions as best I can for Ubuntu Linux and point
317-
to resourced for other distributions. For Ubuntu/Debian, the default `apt`
318-
repository is often out of date, so you will need to use a
314+
Instructions for installing on Linux are nuanced due to the variety and availability of
315+
libraries and dependencies for each distribution, e.g. Ubuntu is Debian based whereas
316+
Fedora is Red Hat based. These instructions will use Ubuntu as the preferred distribution.
317+
The default `apt` repository is often out of date, so you will need to use a
319318
[Personal Package Archive aka PPA](https://itsfoss.com/ppa-guide/) to install
320-
the latest version of a particular software, which I will include in these
319+
the latest version of a particular software, which will be included in these
321320
instructions.
322321

323322
### Git
324323

325-
You should have git pre-installed on your computer, but it will likely be
326-
outdated. It's okay if this is the case, but if you want to update via `apt`,
327-
you can add the git-core ppa:
324+
Many distributions include git by default, but it is often outdated.
325+
It is useful to try to update in case a newer version is available:
328326

329327
```bash
330328
sudo add-apt-repository ppa:git-core/ppa
@@ -345,9 +343,9 @@ git version 2.31.1
345343

346344
### R
347345

348-
To install R, you can visit <https://cran.r-project.org/bin/linux/> to check if
349-
your platform is supported. For Ubuntu, there are detailed instructions at:
350-
<https://cran.r-project.org/bin/linux/ubuntu/>. Here are the commands to register
346+
To install R, you can visit [CRAN's Linux page](https://cran.r-project.org/bin/linux/) to check if
347+
your platform is supported. Detailed instructions exist [for Ubuntu](https://cran.r-project.org/bin/linux/ubuntu/).
348+
Here are the commands to register
351349
the PPA on your machine and then install R:
352350

353351
```bash
@@ -393,11 +391,11 @@ There are two ways to install pandoc:
393391

394392
#### Via RStudio (recommended)
395393

396-
Since pandoc comes bundled with RStudio, you can install it by installing the
397-
latest version of RStudio. You can [download the installer from the RStudio
394+
Pandoc comes bundled with RStudio. You can [download the installer from the RStudio
398395
website][RStudio]. When installing RStudio for Linux, your distribution may not
399-
be shown on the landing page (e.g. Ubuntu 20.04). In this case, choose the most
400-
recent version and download it to your Downloads folder or install it directly.
396+
be shown on the landing page. If your Ubuntu version is not listed, check the
397+
[RStudio Previous Versions](https://docs.posit.co/previous-versions/rstudio.html) page
398+
to see if there are builds available.
401399

402400
::::::::::: callout
403401

@@ -411,15 +409,13 @@ instructions at <https://posit.co/code-signing/>.
411409

412410
#### Via the pandoc website
413411

414-
If are more comfortable using R from the command line, then you can install
415-
pandoc by clicking the "Download the latest installer" button at
416-
<https://pandoc.org/installing.html>. This will bring you to the release page
417-
on GitHub with a list of installers, and you should choose one of the ones that
418-
says "linux" according to what chip architecture you have (AMD vs ARM).
412+
If you are more comfortable using R from the command line, then you can install
413+
pandoc from the [releases page](https://pandoc.org/installing.html). From the list on the GitHub page,
414+
for Ubuntu, choose the appropriate `.deb` file for your chip architecture (i.e. AMD64 or ARM64).
419415

420416
#### Test your installation
421417

422-
We will wait to test the pandoc installation after we install the
418+
We will wait to test the pandoc installation after we have installed the
423419
infrastructure packages, to make sure it's discoverable by R.
424420

425421
### Infrastructure R packages

0 commit comments

Comments
 (0)