Hinzufügen von Emojis zu Ihrer Konsole - Spectre Console Series

Einführung: Überblick über die Spectre-Konsole Emoji

Zu Beginn der Lektion erklärt Tim, dass Spectre Console es Ihnen ermöglicht, "Ihre C#-Konsolenanwendungen in optisch ansprechende, informative Anwendungen zu verwandeln." Er weist darauf hin, dass der Quellcode für seine Demo über den Link in der Videobeschreibung auf GitHub verfügbar ist, was die Installation des Pakets und das Mitmachen erleichtert.

Tim sagt, dass wir in dieser Lektion lernen werden, wie wir Emojis zu unserer Konsolenausgabe hinzufügen können. Er weist darauf hin, dass er eine URL zur offiziellen Liste der Emojis und weitere Dokumentation zu ihrer Verwendung beigefügt hat. Das ist entscheidend, sagt er, weil es drei verschiedene Möglichkeiten gibt, Emojis in Spectre Console anzuzeigen, und zwei davon erfordern die Kenntnis des tatsächlichen Zeichenkettennamens des Emojis.

Dies knüpft direkt an die Idee von Markdown Hints und Spectre Console Markup an, die Tim in seiner Demonstration ausgiebig verwendet.

Methode 1: Verwendung von Spectre Console Markup Emoji Strings

Tims erste Demonstration zeigt die einfachste Art, Emojis anzuzeigen, indem er Emoji-Namen in Spectre Console Markup einbettet. Er verwendet AnsiConsole.MarkupLine, um eine Zeile mit Emoji-Platzhaltern zu schreiben:

AnsiConsole.MarkupLine("I like :baseball: :american_football:");

AnsiConsole.MarkupLine("I like :baseball: :american_football:");

Tim erklärt, dass das Auszeichnungssystem die Doppelpunkte als Anfang und Ende einer Emoji-Zeichenfolge erkennt und sie durch die tatsächlichen Emoji-Zeichen ersetzt. Wenn Sie diesen Code innerhalb Ihrer statischen void Main in einer einfachen Klasse Program ausführen, zeigt die Konsole Baseball- und American Football-Emojis direkt in Ihrer Ausgabe an.

Tim warnt jedoch vor der Syntax: Wenn Sie den Emoji-Namen falsch eingeben (z. B. :football: statt :american_football:), zeigt das Terminal nur den Text :football: an. Er weist darauf hin, dass Sie die Emoji-Zeichenfolge genau wie in der Emoji-Liste definiert eingeben müssen.

Dieses Beispiel zeigt auch, wie sich die Ausgabekodierung und die Unterstützung von Konsolenschriften auf die Anzeige auswirken. Tim sagt, dass das zugrundeliegende System, die Schriftart und das Terminal (Windows Terminal, PowerShell, cmd usw.) bestimmen, wie oder ob diese Zeichen gerendert werden.

Methode 2: Verwendung des Emoji.Known-Objekts zum leichteren Nachschlagen

Tim geht dann zu seinem zweiten Ansatz über: die Verwendung des Objekts Emoji.Known. Dieser Ansatz vermeidet das Auswendiglernen von Emoji-Namen und ermöglicht es, sie aus einer von der Bibliothek bereitgestellten Liste auszuwählen. Er schreibt:

AnsiConsole.WriteLine($"Hello {Emoji.Known.WorldMap}");

AnsiConsole.WriteLine($"Hello {Emoji.Known.WorldMap}");

Tim merkt an, dass dies die programmatische Auswahl von Emojis erleichtert. In der IDE können Sie alle allgemeinen Emojis sehen, die Spectre.Console unterstützt, wie z. B. Banane, Avocado, Gesichter und mehr, die eingefügt werden können, ohne dass Sie durch Doppelpunkte getrennte Namen eingeben müssen.

Er erklärt auch, warum Sie diesen Ansatz bevorzugen könnten. Dieser Stil lässt sich leichter in eine Datenbank oder eine externe Quelle einfügen. Später, wenn Sie Ihre Konsolenausgabe rendern, ziehen Sie einfach die Objektreferenz (z. B. Emoji.Known.Banana) und zeigen sie an. Dies ist auch eine gute Möglichkeit, SpectreDemoEmoji in einer stark typisierten Form zu erhalten, anstatt sich auf Strings zu verlassen.

Methode 3: Ersetzen von Emoji-Strings aus externen Quellen

Der dritte Ansatz von Tim simuliert das Abrufen von Daten aus einer Datenbank. Er schreibt:

string displayText = "I am totally normal :zany_face:\n";
AnsiConsole.Write(displayText);

string displayText = "I am totally normal :zany_face:\n";
AnsiConsole.Write(displayText);

Wenn Sie diesen Code ausführen, wird in der Konsole kein Emoji angezeigt. Stattdessen wird :zany_face: wörtlich übersetzt. Tim zeigt, dass Sie Emoji-Namen explizit durch echte Emojis ersetzen müssen, indem Sie die Methode Emoji.Replace verwenden:

AnsiConsole.Write(Emoji.Replace(displayText));

AnsiConsole.Write(Emoji.Replace(displayText));

Diese Methode wandelt die aus einer externen Quelle stammende Zeichenkette in eine Zeichenkette um, die mit tatsächlichen Emojis gerendert wird. Laut Tim ist dies besonders wichtig, wenn der Text vom Benutzer eingegebene Emoji-Platzhalter oder Markdown-Hinweise enthält.

Emojis in anderen Funktionen der Spectre-Konsole

Tim bemerkt, dass Emojis nicht nur für statischen Text geeignet sind. Einige der in Spectre.Console integrierten Widgets und Spinner verwenden bereits intern Emojis. Er erwähnt eine Wetterdrehscheibe, die zwischen sonnigen, bewölkten und regnerischen Gesichtern wechselt. Dies zeigt, dass Funktionen, Methoden und Aufgaben in Spectre.Console Emojis verwenden können, um ihre Anzeigen ausdrucksstärker zu machen.

Terminals und Betriebssystemunterstützung

Nachdem er gezeigt hat, wie cool Emojis aussehen können, erklärt Tim eine wichtige Einschränkung: Die Unterstützung von Emojis hängt von Ihrem Betriebssystem, der Konsolenschriftart und der Ausgabekodierung ab.

Er demonstriert die Ausführung desselben Codes im Windows Terminal, in der Konsole von Visual Studio und in der klassischen cmd-Shell. In einigen Fällen werden Sie anstelle von Emojis Fragezeichen sehen. Das liegt daran, dass die Konsole die Unicode-Zeichen nicht verarbeiten kann.

Tim warnt, dass Sie Ihre Konsolenausgabe so gestalten müssen, dass sie auch dann noch Sinn macht, wenn die Emojis nicht gerendert werden. Wenn Sie zum Beispiel "I like ⚾ 🏈" zeigen und die Emojis nicht erscheinen, wird daraus "I like ? ?" und der Benutzer weiß nicht mehr, wovon Sie sprechen. Aber wenn Sie "Ich mag Baseball ⚾" anzeigen, dann vermittelt der Text auch ohne Emoji noch eine Bedeutung.

Er betont, dass Emojis Ihre Spectre.Console-App zwar aufpeppen können, aber nicht die einzige Kommunikationsmethode sein sollten.

Mehr Emoji-Hilfe und sichere Entscheidungen

Tim schließt mit einem Verweis auf die von ihm angegebene URL. Dieser Link enthält die vollständige Liste der unterstützten Emojis, Markdown-Hinweise und Informationen darüber, welche Emojis auf verschiedenen Endgeräten am sichersten sind. Er empfiehlt, die Seite auf weitere Emoji-Hilfen, Beispiele und Aktualisierungen zu überprüfen. Hier finden Sie definierte Namen für Bananen, Avocados, Gesichter und andere lustige Symbole sowie Informationen zur Browser- oder Systemkompatibilität.

Abschluss

Abschließend fasst Tim Corey die drei wichtigsten Möglichkeiten der Verwendung von Emojis in Spectre.Console zusammen:

• Spectre Console Markup mit durch Doppelpunkte getrennten Namen.

• Das Objekt Emoji.Known zum einfachen Nachschlagen.

• Die Methode Emoji.Replace für Zeichenketten aus externen Quellen.

Er weist außerdem darauf hin, dass die Schriftartunterstützung, die Ausgabekodierung und das Terminal oder Betriebssystem des Benutzers (cmd, PowerShell, Windows Terminal) die Anzeige von Emojis beeinflussen. Fügen Sie immer Text neben Emojis ein und testen Sie Ihre Konsolenausgabe in mehreren Shells, um Kompatibilität zu gewährleisten.

Wenn Sie Tims Video folgen, können Sie ganz einfach Spectre.Console-Apps erstellen, installieren und ausführen, die Emojis verwenden, um die Konsolenausgabe freundlicher und informativer zu gestalten - ohne die Übersichtlichkeit zu verlieren, wenn die Emoji-Unterstützung begrenzt ist.