Skip to content

Commit ef0c6bd

Browse files
committed
Add environment management dropdown
1 parent 49f5146 commit ef0c6bd

File tree

1 file changed

+25
-0
lines changed
  • modules/05-sharing-and-publishing

1 file changed

+25
-0
lines changed

modules/05-sharing-and-publishing/index.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -207,6 +207,31 @@ At the top-right is a button with the text "Rebuild".
207207

208208
### 💪 Exercise B: Build a MyST website _from scratch_ in JupyterLab
209209

210+
:::{important} Not covered: _Environment management!_
211+
:class: dropdown
212+
213+
Environment management is an important part of reproducible research.
214+
Always include an environment manifest or specification alongside your publication.
215+
216+
This exercise works as shown on CryoCloud because CryoCloud has MySTMD and many other
217+
dependencies pre-installed.
218+
When working on your own, you may encounter an error like:
219+
220+
```
221+
Command 'myst' not found
222+
```
223+
224+
We highly recommend that you try [pixi](https://pixi.sh/) as a dependency manager:
225+
it's fast, user-friendly, and makes following best practices easy or automatic.
226+
227+
```bash
228+
pixi init
229+
pixi add mystmd
230+
pixi run myst start
231+
```
232+
:::
233+
234+
210235
#### Create a new empty GitHub repository
211236

212237
In the GitHub UI, click the `+` icon at the top-right. Select "New repository".

0 commit comments

Comments
 (0)