Configuración del perfil de apariencia en Terminal Windows

La configuración que se muestra a continuación afecta a la configuración visual de cada perfil por separado. Si quiere que una configuración se aplique a todos los perfiles, puede agregarla a la sección defaults, encima de la lista de perfiles del archivo settings.json.

"defaults":
{
    // SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
    // PROFILE OBJECTS
]

Texto

Combinación de colores

Nombre de la combinación de colores que se usa en el perfil. Las combinaciones de colores se definen en el objeto schemes. Encontrará más información en la página Combinaciones de colores.

Además de un único nombre de combinación de colores, esta propiedad puede aceptar un par de nombres de combinaciones de colores de la siguiente manera:

"colorScheme":
{
    "light": "One Half Light",
    "dark": "One Half Dark",
},

Cuando se especifica de esta manera, el Terminal cambiará automáticamente entre las dos combinaciones de colores dadas en función del tema de la aplicación. El Terminal seguirá la propiedad theme.applicationTheme del tema seleccionado del Terminal. Si ese valor de applicationTheme se establece en system, se usará en su lugar la combinación de colores que coincida con el tema del sistema operativo.

Nombre de la propiedad: colorScheme

Necesidad: Opcional

Acepta: nombre de la combinación de colores como una cadena o un objeto con una propiedad light y dark.

Valor predeterminado: "Campbell"

Fuente

Esta es la estructura en la que se debe definir la otra configuración de fuente. A continuación se muestra un ejemplo de cómo podría ser esto en el archivo JSON.

Nombre de la propiedad: font

Necesidad: Opcional

Fuente

Nombre de la fuente que se usa en el perfil. Si no se puede encontrar o no es válido, el terminal intentará utilizar la fuente de reserva Consolas. Para más información sobre las demás variantes de la fuente predeterminada, Cascada Mono, visite la página sobre codificación con Cascade.

Nombre de propiedad: face (definido dentro del font objeto)

Necesidad: Opcional

Acepta: nombre de fuente como una cadena.

Valor predeterminado: "Cascadia Mono"

Tamaño de fuente

Establece el tamaño de fuente del perfil, en puntos.

Nombre de propiedad: size (definido dentro del font objeto)

Necesidad: Opcional

Acepta: Entero

Valor predeterminado: 12

Espesor de la fuente

Establece el espesor (delgadez o grosor de los trazos) de la fuente del perfil.

Nombre de propiedad: weight (definido dentro del font objeto)

Necesidad: Opcional

Acepta: "normal", "thin", "extra-light", "light", "semi-light", "medium", "semi-bold", "bold", "extra-bold", "black", "extra-black" o un entero correspondiente a la representación numérica del espesor de la fuente OpenType.

Valor predeterminado: "normal"

Ejemplo de fuente

"font": {
    "face": "Cascadia Mono",
    "size": 12,
    "weight": "normal"
}

"fontFace": "Cascadia Mono",
"fontSize": 12,
"fontWeight": "normal"

Características de fuente

Esto establece las características de fuente OpenType para la fuente determinada.

Nombre de propiedad: features (definido dentro del font objeto)

Necesidad: Opcional

Acepta: propiedades de características en el formato de: "string": integer

Ejemplo:

// Enables ss01 and disables ligatures
"font": {
    "face": "Cascadia Code",
    "features": {
        "ss01": 1,
        "liga": 0
    }
}

Ejes de fuente

Esto establece los ejes de fuente OpenType para la fuente determinada.

Nombre de propiedad: axes (definido dentro del font objeto)

Necesidad: Opcional

Acepta: ejes de características en el formato de: "string": integer

Ejemplo:

// Sets the font to italic
"font": {
    "face": "Cascadia Code",
    "axes": {
        "ital": 1
    }
}

Formato de texto intenso

Esto controla el formato del texto "intenso" en el terminal. El texto "intenso" tiene formato de texto con la secuencia de escape \x1b[1m.

Nombre de la propiedad: intenseTextStyle

Necesidad: opcional

Acepta: "none", "bold", "bright", "all"

• "all": representa texto intenso en negrita y brillante.
• "bold": representa texto intenso en negrita, pero no brillante.
• "bright": represente texto intenso brillante, pero no en negrita.
• "none": el terminal no hará nada especial para el texto intenso.

Valor predeterminado: "bright"

Efectos de terminal retro

Cursor

Forma del cursor

Establece la forma del cursor del perfil. Los posibles cursores se indican a continuación: "bar" ( ┃ ), "vintage" ( ▃ ), "underscore" ( ▁ ), "filledBox" ( █ ), "emptyBox" ( ▯ ), "doubleUnderscore" ( ‗ )

Nombre de la propiedad: cursorShape

Necesidad: opcional

Acepta: "bar", "vintage", "underscore", "filledBox", , "emptyBox""doubleUnderscore"

Valor predeterminado: "bar"

Alto del cursor

Establece la altura porcentual del cursor empezando por abajo. Solo funciona cuando cursorShape está establecido en "vintage".

Nombre de la propiedad: cursorHeight

Necesidad: Opcional

Acepta: entero de 1 a 100

Iconos e imágenes de fondo

Terminal Windows permite especificar iconos e imágenes de fondo personalizados mediante el menú de configuración de la interfaz de usuario o el archivo settings.json para cada uno de los perfiles de la línea de comandos, lo que le permite configurar cada uno de los perfiles independientemente entre sí, o bien asignarles marca o estilo. Para ello, especifique su backgroundImage preferido, pónganlo con backgroundImageAlignment, establezca su opacidad con backgroundImageOpacity o especifique cómo rellenará la imagen el espacio disponible mediante backgroundImageStretchMode.

Por ejemplo:

    "backgroundImage": "C:\\Users\\username\\OneDrive\\WindowsTerminal\\bg-ubuntu-256.png",
    "backgroundImageAlignment": "bottomRight",
    "backgroundImageOpacity": 0.1,
    "backgroundImageStretchMode": "none"

Puede recorrer fácilmente la colección de imágenes e iconos en todas las máquinas almacenando los iconos e imágenes en OneDrive (como se muestra anteriormente).

Ruta de acceso de la imagen de fondo

Establece la ubicación del archivo de imagen que se va a dibujar en el fondo de la ventana. La imagen de fondo puede ser un archivo. jpg,. png o. gif. "desktopWallpaper" establecerá la imagen de fondo en el fondo del escritorio.

Nombre de la propiedad: backgroundImage

Necesidad: Opcional

Acepta: ubicación del archivo como cadena o "desktopWallpaper"

Se recomienda que las imágenes personalizadas y los iconos se almacenen en carpetas proporcionadas por el sistema y se haga referencia al uso de los esquemas de URI correctos. Los esquemas de URI proporcionan una manera de hacer referencia a archivos independientemente de sus rutas de acceso físicas (que pueden cambiar en el futuro). Los esquemas de URI más útiles que se deben recordar al personalizar iconos e imágenes de fondo son:

Iconos

Terminal Windows muestra iconos para cada perfil que el terminal genera para los shells integrados, por ejemplo: PowerShell Core, PowerShell y cualquier distribución Linux/WSL instalada. Cada perfil hace referencia a un icono de existencias a través del esquema de URI ms-appx. Para hacer referencia a sus propios iconos personalizados, escriba una ruta de acceso en el archivo settings.json:

    "icon" : "C:\\Users\\username\\OneDrive\\WindowsTerminal\\icon-ubuntu-32.png",

Los iconos deben tener un tamaño de 32 x 32 píxeles en un formato de imagen de trama adecuado (por ejemplo, .PNG, .GIF o .ICO) para evitar tener que escalar los iconos durante el tiempo de ejecución (lo que provoca un retraso apreciable y una pérdida de calidad).

Si no se especifica ningún icono para una línea de comandos que haya instalado, el Terminal Windows tendrá como valor predeterminado este glifo con la fuente Segoe Fluent:

Glifo	Punto de código Unicode	Descripción
	e756	CommandPrompt

Modo de ajuste de la imagen de fondo

Alineación de la imagen de fondo

Opacidad de la imagen de fondo

Nombre de la propiedad: backgroundImageOpacity

Necesidad: Opcional

Acepta: Número como valor de punto flotante de 0 a 1.

Valor predeterminado: 1.0

Transparencia

Opacidad

Habilitar acrílico

Periodo

Espaciado interno

Visibilidad de la barra de desplazamiento

Establece la visibilidad de la barra de desplazamiento.

Nombre de la propiedad: scrollbarState

Necesidad: opcional

Acepta: "visible", , "hidden"(a partir de la versión 1.17, "always" se incluirá)

Configuración del color

Color de las pestañas

Establece el color de la pestaña del perfil. El uso del selector de colores de las pestañas invalidará este color.

Nombre de la propiedad: tabColor

Necesidad: Opcional

Acepta: Color como una cadena en formato hexadecimal: "#rgb" o "#rrggbb"

Color de primer plano

Define el color de primer plano del perfil. Invalida el valor de foreground establecido en la combinación de colores si colorScheme está establecido.

Nombre de la propiedad: foreground

Necesidad: Opcional

Acepta: Color como una cadena en formato hexadecimal: "#rgb" o "#rrggbb"

Color de fondo

Cambia el color de fondo del perfil por este valor. Invalida el valor de background establecido en la combinación de colores si colorScheme está establecido.

Nombre de la propiedad: background

Necesidad: Opcional

Acepta: Color como una cadena en formato hexadecimal: "#rgb" o "#rrggbb"

Color de fondo de selección

Establece el color de fondo de una selección en el perfil. Invalida el valor de selectionBackground establecido en la combinación de colores si colorScheme está establecido.

Nombre de la propiedad: selectionBackground

Necesidad: Opcional

Acepta: Color como una cadena en formato hexadecimal: "#rgb" o "#rrggbb"

Ajuste de colores indistinguibles

Esta opción permite ajustar el color de primer plano para que sea más visible, en función del color de fondo. Si se establece en always, los colores se ajustarán siempre. Si se establece en indexed, los colores solo se ajustarán si esos colores forman parte de la combinación de colores. Si se establece en never, los colores no se ajustarán nunca.

Nombre de la propiedad: adjustIndistinguishableColors

Necesidad: opcional

Acepta: always, indexed, never

Color del cursor

Establece el color del cursor del perfil. Invalida el valor de cursorColor establecido en la combinación de colores si colorScheme está establecido.

Nombre de la propiedad: cursorColor

Necesidad: Opcional

Acepta: Color como una cadena en formato hexadecimal: "#rgb" o "#rrggbb"

Configuración de apariencia desenfocada

Objeto que se puede agregar a un perfil que aplica la configuración al perfil cuando se desenfoca. Esta configuración solo acepta la configuración de apariencia.

Nombre de la propiedad: unfocusedAppearance

Necesidad: opcional

Acepta: , , backgroundImageAlignmentbackgroundImageStretchModebackgroundImageOpacitycursorShapecolorSchemeforegroundbackgroundcursorColorcursorHeight, , opacity, , selectionBackgrounduseAcrylic, , experimental.retroTerminalEffectbackgroundImageexperimental.pixelShaderPath

Ejemplo:

// Sets the profile's background image opacity to 0.3 when it is unfocused
"unfocusedAppearance":
{
    "backgroundImageOpacity": 0.3
},

Efectos del sombreador de píxeles

Esta configuración permite al usuario especificar la ruta de acceso a un sombreador de píxeles personalizado que se va a usar con el contenido del terminal. Es una característica experimental y no se garantiza su continuidad. Para más información sobre la creación de sombreadores de píxeles personalizados para el terminal, consulte esta documentación.

Si se establece, invalidará la configuración experimental.retroTerminalEffect.

Nombre de la propiedad: experimental.pixelShaderPath

Necesidad: Opcional

Acepta: ruta de acceso a un archivo de sombreador .hlsl, como una cadena