[[Vorlage(Getestet, bionic)]]

{{{#!vorlage Wissen
[:Terminal: ein Terminal öffnen]
[:Editor:einen Editor öffnen]
}}}

[[Inhaltsverzeichnis()]]

[github:joowani/colorpedia:Colorpedia] ist eine in [:Python:] geschriebene Terminalanwendung, mit der sich Farben zwischen verschiedenen [wikipedia:Farbraum:Farbräumen] umrechnen lassen. Des weiteren können Abstufung für Farben von dunkel nach hell ausgegeben sowie verschiedene Farbpaletten angezeigt werden.

Farbe können in Colorpedia für die folgenden Farbräume / Farbbeschreibung angegeben und umgerechnet werden:

 * [wikipeda:RGB-Farbraum:RGB]
 * [wikipedia:HSV-Farbraum:HSV]
 * [wikipedia_en:HSL_and_HSV:HSL]
 * [wikipedia:CMYK-Farbmodell:CMYK]
 * Hexadezimal (z.B. bei bei HTML und CSS üblich)
 * als englischer Name (z.B. "red")

Damit Colorpedia genutzt werden kann, wird ein True Color und UTF-8 fähiger Terminal vorausgesetzt. Das trifft auf viele [:Terminal:Terminalemulatoren] der Desktopumgebungen zu, aber ggf. nicht, wenn man sich z.B. per SSH auf einen reinen Textterminal einloggt.

= Installation =
Colorpedia ist nicht in den Paketquellen enthalten, kann aber via [:pip:] installiert werden:

[[Vorlage(pipinstallation, colorpedia)]]

= Nutzung =
Der Aufruf erfolgt über den Befehl `color` im Terminal[1]. Die allgemeine Syntax lautet:

{{{#!vorlage Befehl
color BEFEHL WERT [OPTION]
}}}

Beispiel: der Befehl

{{{#!vorlage Befehl
color name red
}}}

ergibt die Ausgabe:

{{{
Name : red
Hex  : #FF0000
RGB  : R:255 G:0   B:0  
HSL  : H:0   S:100 L:50 
HSV  : H:0   S:100 V:100
CMYK : C:0   M:100 Y:100 K:0
}}}

Zusätzlich wird noch ein 20x20 Zeichen großes Quadrat in der angegebenen Farbe ausgegeben.

Colorpedia kennt die folgenden Befehle:

{{{#!vorlage Tabelle
<-2 tableclass="zebra_start2" rowclass="titel" :>Befehle von Colorpedia
+++
<rowclass="kopf" :>Befehl
<:>Erklärung
+++
`name NAME`
Die Farbe `NAME` wird als englisches Wort angegeben, z.B. `red`, `tan` oder `darkgreen`. Als `NAME` sind die gemäß CSS3 Spezifikation [https://developer.mozilla.org/de/docs/Web/CSS/Farben definierten Namen erlaubt] {en}.
+++
`hex XXXXXX`
Die Farbe wird hexadezimal angegeben, entweder als 6-stellige Hexadezimalzahl (wie z.B. `hex 9400d3` für dunkelviolet) oder als 3-stellige Zahl (wie z.B. `hex f00` für rot).
+++
`rbg X X X`
Die Farbe wird im RGB Farbraum mit drei Zahlen zwischen 0 und 255 angegeben, die Zahlen werden durch ein Leerzeichen getrennt (wie z.B. `75 0 130` für indigo oder `rgb 0 0 255` für blau)
+++
`hsv X X X`
Die Farbe wird im HSV Farbraum mit drei Zahlen angegeben: Die erste Zahl steht für den Farbwert, die zweite für Sättigung und die dritte für den Hellwert. Die Zahlen werden durch Leerzeichen getrennt. Beispiel: `hsv 240 100 100` ergibt blau.
+++
`hsl X X X`
Die Farbe wird im HSV Farbraum mit drei Zahlen angegeben: Die erste Zahl steht für den Farbwert, die zweite für Sättigung und die dritte für die Helligkeit. Die Zahlen werden durch Leerzeichen getrennt. Beispiel: `hsl 60 100 50` ergibt gelb.
+++
`cmyk X X X X`
Die Farbe wird im CMYK Farbraum mit vier Zahlen zwischen 0 und 100 angegeben: Die 1. Zahl ist der Cyan-Anteil, die 2. Zahl der Magenta-Anteil, der 3. Zahl der Gelb-Anteil und die 4. Zahl der Schwarzanteil.
+++
`palette FARBE`
Gibt alle Farben aus, die zur Farbe `FARBE` gehören. So gibt z.B. `palette red` alle Rottöne aus.
}}}

Des Weiteren kennt Colorpedia eine Reihe von Optionen:

{{{#!vorlage Tabelle
<-2 tableclass="zebra_start2" rowclass="kopf" :>Optionen von Colorpedia
+++
<rowclass="titel" :>Option
<:>Erklärung
+++
`--json`
Die Ausgabe erfolgt ins [https://www.json.org/json-de.html JSOn] {de} Format
+++
`--units`
Die Zahlenangaben bei den verschiedenen Farbräumen wird mit angegeben, z.B. ° und % bei HSV und HSL.
+++
`--shades [ANZAHL]`
Für die angegeben Farbe werden verschiedene Abstufung von dunkel nach hell angegeben. Wird `ANZAHL` nicht angegeben, sind es 15. Werden weniger Abstufungen benötigt, kann man diese über `ANZAHL` angegeben.
}}}

Eine kurze Erklärung zu Colorpedia erhält man über den Aufruf von

{{{#!vorlage Befehl
color -h
}}}

== Konfiguration ==
Möchte man das Standardverhalten von Colorpedia ändern, kann man dies über eine Konfigurationsdatei machen.

Diese muss zuerst angelegt werde:

{{{#!vorlage Befehl
color config init
}}}

Die Konfigurationsdatei befindet sich unter '''/home/BENUTZERNAME/.config/colorpedia/config.json'''. Möchte man das Standardverhalten ändert, z.B. das die Ausgabe immer nach JSON erfolgt, öffnet man die Datei mit einem Editor[2] und nimmt die gewünschten Anpassung vor.

#tag: Grafik, Shell