Skip to content

Commit

Permalink
Add UTF8 note
Browse files Browse the repository at this point in the history
Resolves #339
  • Loading branch information
mattwojo authored Jan 21, 2022
1 parent fdd2685 commit 223fd23
Showing 1 changed file with 8 additions and 0 deletions.
8 changes: 8 additions & 0 deletions TerminalDocs/json-fragment-extensions.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,14 @@ In the `"schemes"` list, a new color scheme called "Postmodern Tango Light" is d

Of course, if the developer only wishes to add/modify profiles without adding color schemes (and vice-versa), only the relevant list needs to be present and the other list can be omitted.

> [!NOTE]
> If you plan to use PowerShell to generate fragments, you must use `-Encoding Utf8`:
> `# BAD: PowerShell uses UTF16LE by default`
> `Write-Output $fragmentJson > $fragmentPath`
> `# GOOD: Uses UTF8, so Terminal will read this`
> `Write-Output $fragmentJson | Out-File $fragmentPath -Encoding Utf8`
> If you are using VS Code to edit the JSON, UTF8 is the default, but you can confirm in the bottom status bar.
## Profile GUIDs

As previously stated profile GUIDs are a way to reference profiles and let users update and extend them without worrying about location or name changes. The only profiles that can be modified through fragments are the default profiles, Command Prompt and PowerShell, as well as [dynamic profiles](./dynamic-profiles.md). Providing a GUID is optional, however, strongly encouraged.
Expand Down

0 comments on commit 223fd23

Please sign in to comment.