cfonts

     ██████╗ ███████╗  ██████╗  ███╗   ██╗ ████████╗ ███████╗
    ██╔════╝ ██╔════╝ ██╔═══██╗ ████╗  ██║ ╚══██╔══╝ ██╔════╝
    ██║      █████╗   ██║   ██║ ██╔██╗ ██║    ██║    ███████╗
    ██║      ██╔══╝   ██║   ██║ ██║╚██╗██║    ██║    ╚════██║
    ╚██████╗ ██║      ╚██████╔╝ ██║ ╚████║    ██║    ███████║
     ╚═════╝ ╚═╝       ╚═════╝  ╚═╝  ╚═══╝    ╚═╝    ╚══════╝

这是控制台中性感的ANSI字体的愚蠢的小命令行工具。给您的CLI一些爱。

实施

锈

在Rust文件夹中阅读更多。

nodejs

在nodejs文件夹中阅读更多信息。

安装

锈

自制

brew install cfonts

ARCH用户存储库

yay -S cfonts

软呢帽

sudo dnf install cfonts

尼克斯

nix-env -iA nixos.cfonts

Macports

sudo port install cfonts

货物

cargo install cfonts

nodejs

NPM

npm i cfonts -g

纱

yarn global add cfonts

用法

使用CLI很容易。

 Usage: cfonts  "<value>" [option1] <input1> [option2] <input1>,<input2> [option3] etc...

在任何时候，您都可以运行帮助命令以获取完整的命令列表以及如何使用它们。

$ cfonts --help

受支持的字符

A	P	4	$
B	Q	5	%
C	R	6	&
D	S	7	(
E	T	8	)
F	U	9	/
G	V	!	:
H	W	?	;
I	X	.	,
J	Y	+	'
K	Z	-	"
L	0	_	（空间）
M	1	=
N	2	@
O	3	#

|角色将被换行替换

选项

-h， - 螺旋

类型： <command>
默认值： none

这显示了所有可用选项的列表。

$ cfonts --help

-v， - version

类型： <command>
默认值： none

这显示了已安装的版本。

$ cfonts --version

文本

类型： <string>
默认值： ""

这是要转换为不错的字体的“文本输入”。
|角色将被围栏替换。

$ cfonts " Hello world " 

-f， - font

类型： <string>
默认值： "block"

这是您要使用的字体面孔。到目前为止

$ cfonts " text " --font " chrome "

• block [颜色：2] （默认）
• slick [颜色：2]
• tiny [颜色：1]
• grid [颜色：2]
• pallet [颜色：2]
• shade [颜色：2]
• chrome [颜色：3]
• simple [颜色：1]
• simpleBlock [颜色：1]
• 3d [颜色：2]
• simple3d [颜色：1]
• huge [颜色：2]
• console [颜色：1]

-a， - Align

类型： <string>
默认值： "left"

您可以将文本与终端对齐。使用以下关键字：

• left （默认）
• center
• right
• top （如果与无间隔选项一起使用，将被忽略）
• bottom （如果与无间隔选项一起使用，将被忽略）

$ cfonts " text " --align " center " 

-c， - 色

类型： <string list>
默认值： ['system']

使用此设置，您可以为字体设置颜色。使用以下颜色字符串或十六进制颜色。
在逗号分隔的字符串中提供颜色，例如： red,blue 。 （没有空间）
如果使用十六进制颜色，请确保包括#前缀。 （在大多数终端中，用引号包裹了十六进制）
system颜色落回端子的系统颜色。

有一些环境变量会影响终端中颜色的显示。

• system （默认）
• black
• red
• green
• yellow
• blue
• magenta
• cyan
• white
• gray
• redBright
• greenBright
• yellowBright
• blueBright
• magentaBright
• cyanBright
• whiteBright
• #ff8800 （任何有效的十六进制颜色）
• #f80 （也支持简短的形式）

$ cfonts " text " --colors white, " #f80 " 

-g， - 成绩

类型： <string list>
默认值： false

使用此设置，您可以将梯度设置为输出。
此设置取代颜色打开。
梯度需要两种颜色，一个开始颜色和从左到右的最终颜色。
（如果要为梯度设置自己的颜色，请使用过渡选项。）
然后， cfonts将通过尽可能多的颜色产生梯度，以使输出最令人印象深刻。
在逗号分隔的字符串中提供两种颜色，例如： red,blue 。 （没有空间）
如果使用十六进制颜色，请确保包括#前缀。 （在终端中包裹着六角形）

• black
• red
• green
• yellow
• blue
• magenta
• cyan
• white
• gray
• grey
• #ff8800 （任何有效的十六进制颜色）
• #f80 （也支持简短的形式）

$ cfonts " text " --gradient red, " #f80 " 

-i， - 独立的毕业者

类型： <boolean>
默认值： false

设置此选项，以重新计算每条新行的梯度颜色。
仅与梯度选项结合使用。

$ cfonts " text|next line " --gradient red, " #f80 " --independent-gradient

-t， - 过渡级别

类型： <boolean>
默认值： false

设置此选项以生成自己的梯度。然后将梯度选项中的每个颜色设置为直接过渡到。此选项使您可以为梯度指定两种颜色。
仅与梯度选项结合使用。

$ cfonts " text " --gradient red, " #f80 " ,green,blue --transition-gradient

-b， - 背景

类型： <string>
默认值： "transparent"

使用此设置，您可以为输出设置背景颜色。使用以下颜色字符串。从下面支持的列表中提供背景颜色，例如：“白色”

• transparent （默认）
• black
• red
• green
• yellow
• blue
• magenta
• cyan
• white
• blackBright
• redBright
• greenBright
• yellowBright
• blueBright
• magentaBright
• cyanBright
• whiteBright
• #ff8800 （任何有效的十六进制颜色）
• #f80 （也支持简短的形式）

$ cfonts " text " --background " Green " 

-l， - letter间距

类型： <integer>
默认值： 1

设置此选项以扩大字符之间的空间。

$ cfonts " text " --letter-spacing 2

-Z， - 线高

类型： <integer>
默认值： 1

设置此选项以扩大线条之间的空间。

$ cfonts " text " --line-height 2

-s， - 无间隙

类型： <boolean>
默认值： false

如果您不希望插件在顶部和输出底部插入两个空线路，则将此选项设置为False。

$ cfonts " text " --spaceless

-m， - 最大长度

类型： <integer>
默认值： 0

此选项设置将在一行上打印的最大字符。
cfonts检测到终端的大小，但您可以选择退出并确定自己的最大宽度。
0表示没有最大宽度，文本将在终端窗口的边缘中断。

$ cfonts " text " --max-length 15

-r， - -RAW模式

类型： <boolean>
默认值： false

设置此选项CRLF以确保在默认的LF （ n ）线路断裂上使用cfonts （ rn ）使用。
这对于终端RAW模式或较旧的Windows机器可能很有用。

 use crossterm :: terminal ;
use std :: io :: Write ;
use cfonts ;

fn main ( ) -> std :: io :: Result < ( ) > {
	terminal :: enable_raw_mode ( ) ? ;

	cfonts :: say ( cfonts :: Options {
		text : String :: from ( "Hello|world" ) ,
		raw_mode : true ,
		..cfonts :: Options :: default ( )
	} ) ;

	std :: io :: stdout ( ) . flush ( ) ? ;
	terminal :: disable_raw_mode ( ) ? ;
	Ok ( ( ) )
} 

-e，-env

类型： <string>
默认值： cli

此选项使您可以使用cfonts生成HTML而不是ANSI代码。
请注意， max-length将设置为非常大。

$ cfonts " text " --env browser

一致性

cfonts检测到平台上支持哪些颜色。它自动设置支持水平。在cfonts中，您可以通过将其传递到FORCE_COLOR环境变量来覆盖这一点。

FORCE_COLOR=3 cfonts " hello world " -c " #0088ff "

您还可以使用NO_COLOR环境变量为CI等环境设置未设置颜色输出。

NO_COLOR= " " cfonts " hello world " -c " #0088ff "

FORCE_COLOR如果两者都设置了NO_COLOR 。

执照

CopyLeft（C）2023 Dominik Wilkowski。在GNU GPL-3.0或陪同下获得许可。