From ed4fd895ecefa66071ef202b4e60988c132d0f92 Mon Sep 17 00:00:00 2001 From: Jan De Dobbeleer Date: Tue, 3 Nov 2020 15:21:02 +0100 Subject: [PATCH] chore: add next steps information --- docs/docs/installation.mdx | 34 +++++++++++++++++++++++++++++++++- 1 file changed, 33 insertions(+), 1 deletion(-) diff --git a/docs/docs/installation.mdx b/docs/docs/installation.mdx index 36a928cc2129..3520f650ce7e 100644 --- a/docs/docs/installation.mdx +++ b/docs/docs/installation.mdx @@ -324,7 +324,37 @@ Restart nu shell for the changes to take effect. -### 5. Profit +### 5. Next steps + +At this point you're good to go. The `jandedobbeleer.json` theme displays most common use-cases +in your prompt so 9/10 you'll be more than happy with it. However, if you want to explore additional +functionality, going through the additional steps below will help you get started. + +#### Change the theme + +We downloaded all the themes and set `jandedobbeleer.json` as the one to use. +However, there are a lot more to be discovered and maybe there are some you like better. + +Adjust your configuration to use any other theme from the folder we created (`~/.poshthemes`). + +#### Override the theme settings + +Maybe there's a theme you like, but you don't fancy the colors. Or, maybe there's a segment you +want to tweak/add, or replace some of the icons with a different one. Whatever the case, read through all +available options first, by starting with the [configuration guide][configuration]. + +Afterwards, the easiest way to go about this is to print the current config and store it elsewhere first (for example `~/.mytheme.json`). + +```bash +oh-my-posh --print-config +``` + +This will write the current configuration in your shell, allowing you to copy paste it in a new file +and store it somehwere. Once adjusted to your liking, [change the prompt setting][prompt] to use the newly created file. + +```bash +oh-my-posh -config ~/.mytheme.json +``` 🎉🎉🎉 @@ -336,3 +366,5 @@ Restart nu shell for the changes to take effect. [powershell]: /docs/powershell [themes]: https://github.com/JanDeDobbeleer/oh-my-posh3/tree/main/themes [scoop]: /docs/scoop +[prompt]: /docs/installation#4-replace-your-existing-prompt +[configuration]: /docs/configure