You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: lectures/software_engineering/tools_editors.md
+9-11Lines changed: 9 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,7 @@ kernelspec:
24
24
:depth: 2
25
25
```
26
26
27
-
While Jupyter notebooks are a great way to get started with the language, eventually you will want to use more powerful tools. Visual Studio Code (VS Code) in particular, is the most popular open source editor for programming, and has a huge set of extensions and strong industry support.
27
+
While Jupyter notebooks are a great way to get started with the language, eventually you will want to use more powerful tools. Visual Studio Code (VS Code) in particular, is the most popular open source editor for programming - with a huge set of extensions and strong industry support.
28
28
29
29
While you can use source code control, run terminals and the REPL ("Read-Evaluate-Print Loop"), without VS Code, we will concentrate on using it as a full IDE for all of these features.
30
30
@@ -42,11 +42,10 @@ See the [Julia VS Code Documentation](https://www.julia-vscode.org/docs/dev/gett
42
42
43
43
If you have done a typical Julia installation, then this may be all that is needed and no configuration may be necessary. However, if you have installed Julia in a non-standard location you may need to manually set the executable path. See [here](https://www.julia-vscode.org/docs/dev/gettingstarted/#Configuring-the-Julia-extension-1) for instructions if it errors when starting Julia terminals.
44
44
45
-
See [here](optional_extensions) for other useful extensions when using VS Code.
46
-
47
-
45
+
```{note}
46
+
While the general [VS Code documentation](https://code.visualstudio.com/docs/getstarted/userinterface) is excellent, we will review a few of the key concepts directly. In addition, see [here](optional_extensions) for other useful extensions when using VS Code not directly connected to these lectures.
47
+
```
48
48
49
-
See the [VS Code documentation](https://code.visualstudio.com/docs/getstarted/userinterface) for an introduction.
50
49
51
50
### Command Palette
52
51
@@ -217,7 +216,7 @@ The Julia Debugger runs some of the code in an interpreted mode that might be fa
217
216
218
217
(repl_main)=
219
218
## The REPL
220
-
Even if you are working primarily in `.jl` and/or Jupyer Notebooks in Julia, you will need to become comfortable with the REPL. We saw some initial use of this when [adding packages](adding_packages) and exploring the code above, but the REPL has many [more features](https://docs.julialang.org/en/v1/stdlib/REPL/#The-Julia-REPL).
219
+
Even if you are working primarily in `.jl` and/or Jupyter Notebooks in Julia, you will need to become comfortable with the REPL. We saw some initial use of this when [adding packages](adding_packages) and exploring the code above, but the REPL has many [more features](https://docs.julialang.org/en/v1/stdlib/REPL/#The-Julia-REPL).
221
220
222
221
### Starting a REPL
223
222
There are several ways to start the REPL.
@@ -245,12 +244,12 @@ First, with `julia --threads auto` we see that the globally installed packages a
245
244
```
246
245
247
246
Next, with `julia --threads auto --project` the project is automatically activated
248
-
```{figure} /_static/figures/repl_1.png
247
+
```{figure} /_static/figures/repl_2.png
249
248
:width: 100%
250
249
```
251
250
252
251
253
-
Finally, if you choose the `--project` option in a folder which doesn't have an existing project file, it will create them as requierd.
252
+
Finally, if you choose the `--project` option in a folder which doesn't have an existing project file, it will create them as required.
254
253
255
254
A few other features of the REPL include,
256
255
@@ -300,14 +299,13 @@ The following are some optional choices, not all directly connected to Julia.
300
299
301
300
While not required for these lectures, consider installing the following extensions. As before, you can search for them on the Marketplace or choose `Install` from the webpages themselves.
302
301
303
-
1.[Jupyter](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter): VS Code increasingly supports Jupyter notebooks directly, and this extension provides the ability to open and edit `.ipynb` notebook files wihtout running `jupyter lab`, etc.
302
+
1.[Jupyter](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter): VS Code increasingly supports Jupyter notebooks directly, and this extension provides the ability to open and edit `.ipynb` notebook files without installing Conda and running `jupyter lab`.
304
303
1.[GitLens](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens): An extension that provides an enormous amount of detail on exact code changes within github repositories (e.g., seamless information on the time and individual who [last modified](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens#current-line-blame-) each line of code)
305
304
2.[GitHub Pull Requests and Issues](https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github): while VS Code supports the git {doc}`version control <../software_engineering/version_control>` natively, these extension provides additional features for working with repositories on GitHub itself.
306
305
3.[Markdown All in One](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one): For editing the markdown format, such as `README.md` and similar files.
307
-
4. Finally, VS Code has an excellent [latex editor](https://github.com/James-Yu/LaTeX-Workshop#manual)!
306
+
4. Finally, VS Code has an excellent [latex editor](https://github.com/James-Yu/LaTeX-Workshop#manual)
308
307
- Install a recent version of miktex or texlive for your platform
309
308
- Install [LaTeX Workshop](https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop) and (optionally) the [Code Spell Checker](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker) for spell checking
310
-
-
311
309
- To get started, just add magic comments at the top of the latex file (removing the `!BIB` line if there is no bibtex reference) and then `F5` or the equivalent command to compile:
0 commit comments