From 9626f207d91bd859d6b992c317474cbb4cfd4230 Mon Sep 17 00:00:00 2001 From: evanwill Date: Fri, 16 Aug 2024 10:40:44 -0700 Subject: [PATCH] update mac vs code note --- docs/software/texteditor.md | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/docs/software/texteditor.md b/docs/software/texteditor.md index fc208f1..b6ea469 100644 --- a/docs/software/texteditor.md +++ b/docs/software/texteditor.md @@ -6,13 +6,15 @@ nav_order: 2 # Get a Text Editor -Static web projects like CollectionBuilder are really just a folder of plain text files. +Static web projects like CollectionBuilder are just a folder of plain text files. To edit them you will need a good text editor. Code editors will allow you to work on whole folders of files at once (i.e. your Jekyll project repository) and have built in helpers for syntax highlighting, version control, terminals, search, and even spell check. If you don't already have a favorite editor, the CollectionBuilder team suggests the very popular, open-source [Visual Studio Code](https://code.visualstudio.com/){:target="_blank" rel="noopener"} (VS Code). Download VS Code and [follow their instructions](https://code.visualstudio.com/docs/setup/setup-overview) to install with the default options on your computer. -Then tweak the configuration options and extensions listed in the sections below. +(*note to Mac users: be sure to drag the VS Code app from your Downloads to Applications directory to ensure correct installation!*) + +Next, tweak the configuration options and extensions listed in the sections below to better support working on your CB project. If you are unfamiliar with editors, there is pretty good [VS Code documentation](https://code.visualstudio.com/docs) including videos and reference, but you will learn a lot just working through you CB project! @@ -20,11 +22,6 @@ If you are unfamiliar with editors, there is pretty good [VS Code documentation] Many good alternatives exist--if you are looking for a VS Code clone minus Microsoft, check out [VS Codium](https://vscodium.com/) or [Theia IDE](https://theia-ide.org/#theiaide). You can also use a light version of VS Code in your browser without installing anything by opening [vscode.dev](https://vscode.dev/). -*Note to Mac users:* -On macOS Sierra or later, VS Code automatically downloads to the Downloads directory, which can cause problems with updates down the road. -If this applies to you, after installation we recommend moving the VS Code app from Downloads to your Applications directory. -{:.alert .alert-blue} - ## Configuring Visual Studio Code VS Code is incredibly customizable via its settings.