DOC: Add instructions for installation from conda-forge

[matthewfeickert]

Resolves #49

• Add instructions based on https://carpentries.github.io/workbench/#installation.
  • As group-tabs are failing in learners/setup.md, fall back to distinguishing between Pixi and conda instructions by using subsections.
• Give Pixi as the preferred method as it requires fewer commands, is significantly faster, and is fully reproducible.
• Fix typo 'or the Workbench' -> 'for the Workbench'.

[github-actions]

🆗 Pre-flight checks passed 😃

This pull request has been checked and contains no modified workflow files or spoofing.

It should be safe to Approve and Run the workflows that need maintainer approval.

[matthewfeickert]

High-level comments for the reviewers.

[matthewfeickert]

I'm raising the difference between local installation using conda-forge tooling and the operating system specific approaches. Both are "manual", though both involve package managers at some levle.

[matthewfeickert]

Adding an anchor that matches the style used elsewhere.

[matthewfeickert]

Typo fix: "or the Workbench" -> "for the Workbench".

[matthewfeickert]

I had tried to encompass the With Pixi and With Conda using group-tab

:::: group-tab

...

::::

but this raises pandoc and sandpaper errors

Details:

$ pixi run start
✨ Pixi task (serve): Rscript -e "sandpaper::serve()": (Serve the lesson)                                                                                                               ! There were errors in 8/109 links and images
◌ Some link anchors for relative links (e.g. [anchor]: link) are missing
◌ Some linked internal files do not exist <https://carpentries.github.io/sandpaper/articles/include-child-documents.html#workspace-consideration>
◌ Avoid uninformative link phrases <https://webaim.org/techniques/hypertext/link_text#uninformative>
◌ Avoid single-letter or missing link text <https://webaim.org/techniques/hypertext/link_text#link_length>

learners/setup.md:311 [link text too short]: [R](https://cran.rstudio.org/)
learners/setup.md:381 [missing anchor]: [we recommend using RStudio for your lesson](#recommend)
learners/setup.md:511 [missing file]: [](fig/rstudio-mac-install.png)
learners/devcontainer.md:15 [uninformative link text]: [link](https://code.visualstudio.com/)
learners/devcontainer.md:89 [missing file]: [Lesson Content and Styling](episodes/02-content-styling.md)
learners/devcontainer.md:89 [missing file]: [Additional Lesson Content](03-additional-content.md)
learners/devcontainer.md:93 [missing file]: [Packages and renv](episodes/04-r-and-renv.md)
learners/devcontainer.md:97 [missing file]: [Internationalisation](episodes/05-il8n.md)
── Initialising site ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
✔ Congratulations! '/home/feickert/Code/GitHub/forks/workbench-docs/CITATION.cff' is valid
Error: 
! in callr subprocess.
Caused by error: 
! pandoc document conversion failed with error 83
---
Standard error:
[WARNING] Note with key 'workspace' defined at /tmp/RtmpabpLeN/file1e2cf1211c00e.md line 871 column 1 but not used.
Error running filter /home/feickert/Code/GitHub/forks/workbench-docs/.pixi/envs/default/lib/R/library/sandpaper/rmarkdown/lua/lesson.lua:
...default/lib/R/library/sandpaper/rmarkdown/lua/lesson.lua:330: attempt to concatenate a nil value (field '?')
stack traceback:
	...default/lib/R/library/sandpaper/rmarkdown/lua/lesson.lua:419: in function <...default/lib/R/library/sandpaper/rmarkdown/lua/lesson.lua:418>
	[C]: in ?
	[C]: in function 'pandoc.walk_block'
	...default/lib/R/library/sandpaper/rmarkdown/lua/lesson.lua:451: in function 'tab_block'
	...default/lib/R/library/sandpaper/rmarkdown/lua/lesson.lua:661: in function 'handle_our_divs'
stack traceback:
	...default/lib/R/library/sandpaper/rmarkdown/lua/lesson.lua:451: in function 'tab_block'
	...default/lib/R/library/sandpaper/rmarkdown/lua/lesson.lua:661: in function 'handle_our_divs'
---
Backtrace:
1. sandpaper::serve()
2. local rend(this_path)
3. sandpaper::build_lesson(f, preview = FALSE, quiet = quiet)
4. sandpaper:::build_site(path = path, quiet = quiet, preview = preview, override = override, …
5. sandpaper:::build_home(pkg, quiet = quiet, next_page = home_next)
6. sandpaper:::render_html(setup)
7. callr::r(function(d, v, ...) { …
8. callr:::get_result(output = out, options)
9. callr:::throw(callr_remote_error(remerr, output), parent = fix_msg(remerr[[3]]))
---
Subprocess backtrace:
1. rmarkdown::pandoc_convert(...)
2. rmarkdown:::stop2("pandoc document conversion failed with error ", result)
3. base::stop(..., call. = FALSE)
4. | base::.handleSimpleError(function (e) …
5. global h(simpleError(msg, call))
Warning message:
There are missing timings from 1 episode.
• 01-first-lesson.md
ℹ The default value of 5 minutes will be used for teaching and exercises. 
Execution halted

As a fall back, revert to using subsections of the same heading level e.g.

### With Pixi (recommended)

...

### With conda

Working instances of group-tab use with the Workbench can be seen in https://github.com/carpentries-incubator/reproducible-ml-workflows, so this seems to point to an issue with the structure of https://github.com/carpentries/workbench-docs.

[matthewfeickert]

This is carpentries/sandpaper#708.

[matthewfeickert]

This has been resolved in carpentries/sandpaper#709 and is released in sandpaper v0.20.0 which now allows for group-tabs to work

[matthewfeickert]

This section exists only to match the other installation methods, as PATH manipulation is controlled by environment activation (or run, in the case of Pixi). If additional checks are desired please recommend them.

[matthewfeickert]

@froggleston @tobyhodges this is ready for review. Please let me know if you have any questions. 👍

[matthewfeickert]

Aside: How is rmarkdown::pandoc_version of 3.10.2

workbench-docs/learners/setup.md

Lines 689 to 699 in 8085699

	```r
	rmarkdown::pandoc_version()
	tmp <- tempfile()
	sandpaper::no_package_cache()
	sandpaper::create_lesson(tmp, open = FALSE)
	sandpaper::build_lesson(tmp, preview = FALSE, quiet = TRUE)
	fs::dir_tree(tmp, recurse = 1)
	```
	```output
	[1] '3.10.2'

possible when the latest release is pandoc v3.9 (as of 2026-02-04)?

[froggleston]

Thanks for this @matthewfeickert ! We can take a look over the next few days.

To be perfectly honest, I have no idea. Some part of my mind remembers that there were 3.10 releases, and then everywhere that I might have those versions, they're all sub 3.9 so .... I guess I made a typo after a copy paste?

[matthewfeickert]

We can take a look over the next few days.

Sounds good, thanks!

I guess I made a typo after a copy paste?

I wasn't thinking fully when I asked about that earlier, but a typo makes more sense than a bug. That's luckily a very easy fix. 👍

[matthewfeickert]

I've found that if I had With Pixi (recommended), the presence of the () broke group-tabs, so I have noted the (recommended) in the line below.

[matthewfeickert]

This is carpentries/sandpaper#711

[froggleston]

I'll merge this now as it's looking good, and we can do a more thorough review when @tobyhodges and I next discuss the plan for these docs. Thanks as always @matthewfeickert !

[matthewfeickert]

Thanks @froggleston!