From ab69e8079c465bae74e0f1fb863bcc22246d6495 Mon Sep 17 00:00:00 2001 From: Will McGugan Date: Wed, 18 Jan 2023 19:22:32 +0000 Subject: [PATCH] update faq --- .faq/FAQ.md | 4 +++- FAQ.md | 8 ++++++-- questions/why-no-ansi-themes.question.md | 6 ++++-- 3 files changed, 13 insertions(+), 5 deletions(-) diff --git a/.faq/FAQ.md b/.faq/FAQ.md index 4bccdc848..6adf000a7 100644 --- a/.faq/FAQ.md +++ b/.faq/FAQ.md @@ -1,5 +1,7 @@ + + -# Frequently Asked Questions +# Frequently Asked Questions {%- for question in questions %} - [{{ question.title }}](#{{ question.slug }}) diff --git a/FAQ.md b/FAQ.md index 5b4b0f54f..d2d7e7b35 100644 --- a/FAQ.md +++ b/FAQ.md @@ -1,3 +1,5 @@ + + # Frequently Asked Questions - [Does Textual support images?](#does-textual-support-images) @@ -96,9 +98,11 @@ Textual will not generate escape sequences for the 16 themeable *ANSI* colors. This is an intentional design decision we took for for the following reasons: - Not everyone has a carefully chosen ANSI color theme. Color combinations which may look fine on your system, may be unreadable on another machine. There is very little an app author or Textual can do to resolve this. Asking users to simply pick a better theme is not a good solution, since not all users will know how. -- ANSI colors can't be manipulated in the way Textual can do with other colors. Textual can blend colors with alpha transparency and produce light and dark shades from an original color. This is not possible when generating ANSI colors. +- ANSI colors can't be manipulated in the way Textual can do with other colors. Textual can blend colors and produce light and dark shades from an original color, which is used to create more readable text and user interfaces. Color blending will also be used to power future accessibility features. -Textual has a design system which guarantees colors will be readable on all platforms and terminals. There is currently light and dark version of the design system, but more are planned. It will also be possible for users to customize the source colors on a per-app or per-system basis. This means that in the future if it is really important to you that Textual apps blend in with your terminal, you will be able to get very close. +Textual has a design system which guarantees apps will be readable on all platforms and terminals, and produces better results than ANSI colors. + +There is currently a light and dark version of the design system, but more are planned. It will also be possible for users to customize the source colors on a per-app or per-system basis. This means that in the future you will be able to modify the core colors to blend in with your chosen terminal theme.
diff --git a/questions/why-no-ansi-themes.question.md b/questions/why-no-ansi-themes.question.md index 13550e5c6..bd908ed8d 100644 --- a/questions/why-no-ansi-themes.question.md +++ b/questions/why-no-ansi-themes.question.md @@ -10,6 +10,8 @@ Textual will not generate escape sequences for the 16 themeable *ANSI* colors. This is an intentional design decision we took for for the following reasons: - Not everyone has a carefully chosen ANSI color theme. Color combinations which may look fine on your system, may be unreadable on another machine. There is very little an app author or Textual can do to resolve this. Asking users to simply pick a better theme is not a good solution, since not all users will know how. -- ANSI colors can't be manipulated in the way Textual can do with other colors. Textual can blend colors with alpha transparency and produce light and dark shades from an original color. This is not possible when generating ANSI colors. +- ANSI colors can't be manipulated in the way Textual can do with other colors. Textual can blend colors and produce light and dark shades from an original color, which is used to create more readable text and user interfaces. Color blending will also be used to power future accessibility features. -Textual has a design system which guarantees colors will be readable on all platforms and terminals. There is currently light and dark version of the design system, but more are planned. It will also be possible for users to customize the source colors on a per-app or per-system basis. This means that in the future if it is really important to you that Textual apps blend in with your terminal, you will be able to get very close. +Textual has a design system which guarantees apps will be readable on all platforms and terminals, and produces better results than ANSI colors. + +There is currently a light and dark version of the design system, but more are planned. It will also be possible for users to customize the source colors on a per-app or per-system basis. This means that in the future you will be able to modify the core colors to blend in with your chosen terminal theme.