Pengaturan profil tampilan di Terminal Windows

2024-10-29

Pengaturan yang tercantum di bawah ini memengaruhi pengaturan visual setiap profil secara terpisah. Jika Anda ingin pengaturan diterapkan ke semua profil, Anda dapat menambahkannya ke defaults bagian di atas daftar profil dalam file settings.json Anda.

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

Teks

Skema warna

Ini adalah nama skema warna yang digunakan dalam profil. Skema warna ditentukan dalam schemes objek. Informasi lebih rinci dapat ditemukan di halaman Skema warna.

Selain nama skema warna tunggal, properti ini dapat menerima sepasang nama skema warna sebagai berikut:

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

Ketika ditentukan dengan cara ini, Terminal akan secara otomatis beralih di antara dua skema warna yang diberikan tergantung pada tema aplikasi. Terminal akan mengikuti theme.applicationTheme properti tema terminal yang dipilih. Jika diatur applicationTheme ke system, maka ini akan menggunakan skema warna yang cocok dengan tema OS.

Nama properti: colorScheme

Kebutuhan: Opsional

Terima: Nama skema warna sebagai string, atau objek dengan light properti dan dark

Nilai Default: "Campbell"

Font

Ini adalah struktur di mana pengaturan font lainnya harus ditentukan. Contoh seperti apa ini dalam file JSON ditunjukkan di bawah ini.

Nama properti: font

Kebutuhan: Opsional

Wajah font

Ini adalah nama wajah font yang digunakan dalam profil. Terminal akan mencoba mundur ke Consolas jika ini tidak dapat ditemukan atau tidak valid. Untuk mempelajari tentang varian font default lainnya, Cascadia Mono, kunjungi halaman Kode Kascadia.

Nama properti: face (ditentukan dalam font objek)

Kebutuhan: Opsional

Terima: Nama font sebagai string

Nilai Default: "Cascadia Mono"

Ukuran font

Ini mengatur ukuran font profil dalam poin.

Nama properti: size (ditentukan dalam font objek)

Kebutuhan: Opsional

Terima: Bilangan bulat

Nilai Default: 12

Ketebalan fon

Ini mengatur berat (ringan atau berat goresan) untuk font profil.

Nama properti: weight (ditentukan dalam font objek)

Kebutuhan: Opsional

Menerima: "normal", , "thin", "extra-light""light", "semi-light", "medium", "semi-bold", "bold", "extra-bold", "black", "extra-black", , atau bilangan bulat yang sesuai dengan representasi numerik dari bobot font OpenType

Nilai Default: "normal"

Contoh font

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

Penting

Objek ini font hanya tersedia di Terminal Windows versi 1.10+. Sebelum versi tersebut fontFace, Anda harus menggunakan properti , , fontSizedan fontWeight secara terpisah, seperti:

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

Fitur font

Ini mengatur fitur font OpenType untuk font yang diberikan.

Nama properti: features (ditentukan dalam font objek)

Kebutuhan: Opsional

Terima: Properti fitur dalam format: "string": integer

Contoh:

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

Sumbu font

Ini mengatur sumbu font OpenType untuk font yang diberikan.

Nama properti: axes (ditentukan dalam font objek)

Kebutuhan: Opsional

Menerima: Properti sumbu dalam format: "string": integer

Contoh:

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

Pemformatan teks intens

Ini mengontrol bagaimana teks "intens" diformat di terminal. Teks "Intens" adalah teks yang diformat dengan urutan \x1b[1mescape .

Nama properti: intenseTextStyle

Kebutuhan: Opsional

Menerima: "none", "bold", "bright", "all"

"all": merender teks intens sebagai tebal dan cerah
"bold": merender teks intens sebagai tebal, tetapi tidak cerah
"bright": merender teks intens cerah, tetapi tidak tebal
"none": terminal tidak akan melakukan sesuatu yang istimewa untuk teks intens

Nilai Default: "bright"

Efek terminal retro

Ketika ini diatur ke true, terminal akan meniru tampilan CRT klasik dengan garis pemindaian dan tepi teks buram. Ini adalah fitur eksperimental dan keberadaannya yang berkelanjutan tidak dijamin.

Jika experimental.pixelShaderPath diatur, pengaturan ini akan diambil alih.

Nama properti: experimental.retroTerminalEffect

Kebutuhan: Opsional

Menerima: true, false

Nilai Default: false

Terminal Windows efek terminal retro eksperimental Konfigurasi: Perintah Retro

Kursor

Bentuk kursor

Ini mengatur bentuk kursor untuk profil. Kursor yang mungkin adalah sebagai berikut: "bar" ( ┃ ), "vintage" ( ▃ ), "underscore" ( _ ), "filledBox" ( █ ), "emptyBox" ( ▯ ), "doubleUnderscore" ( ̳ )

Nama properti: cursorShape

Kebutuhan: Opsional

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

Nilai Default: "bar"

Tinggi kursor

Ini mengatur tinggi persentase kursor mulai dari bawah. Ini hanya akan berfungsi ketika cursorShape diatur ke "vintage".

Nama properti: cursorHeight

Kebutuhan: Opsional

Terima: Bilangan bulat dari 1-100

Gambar dan ikon latar belakang

Terminal Windows memungkinkan Anda menentukan gambar dan ikon latar belakang kustom menggunakan menu antarmuka pengguna pengaturan atau file settings.json untuk setiap profil baris perintah Anda, memungkinkan Anda untuk mengonfigurasi/merek/gaya masing-masing profil Anda secara independen satu sama lain. Untuk melakukannya, tentukan pilihan Anda backgroundImage, posisikan menggunakan backgroundImageAlignment, atur keburamannya dengan backgroundImageOpacity, dan/atau tentukan bagaimana gambar Anda akan mengisi ruang yang tersedia menggunakan backgroundImageStretchMode.

Contohnya:

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

Anda dapat dengan mudah menjelajah koleksi gambar dan ikon di semua komputer Anda dengan menyimpan ikon dan gambar Anda di OneDrive (seperti yang ditunjukkan di atas).

Jalur gambar latar belakang

Ini mengatur lokasi file gambar untuk menggambar di atas latar belakang jendela. Gambar latar belakang dapat berupa file .jpg, .png, atau .gif. "desktopWallpaper" akan mengatur gambar latar belakang ke wallpaper desktop.

Nama properti: backgroundImage

Kebutuhan: Opsional

Terima: Lokasi file sebagai string atau "desktopWallpaper"

Disarankan agar gambar dan ikon kustom disimpan di folder yang disediakan sistem dan dirujuk menggunakan skema URI yang benar. Skema URI menyediakan cara untuk mereferensikan file yang independen dari jalur fisik mereka (yang dapat berubah di masa mendatang). Skema URI yang paling berguna untuk diingat saat menyesuaikan gambar dan ikon latar belakang adalah:

Skema URI	Jalur fisik yang sesuai	Gunakan / deskripsi
`ms-appdata:///Local/`	`%localappdata%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\`	File per komputer
`ms-appdata:///Roaming/`	`%localappdata%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState\`	File umum

Peringatan

Jangan mengandalkan referensi file menggunakan skema URI ms-appx (yaitu ikon). File-file ini dianggap sebagai detail implementasi internal dan dapat mengubah nama/lokasi atau dapat dihilangkan di masa mendatang.

Ikon

Terminal Windows menampilkan ikon untuk setiap profil yang dihasilkan terminal untuk shell bawaan apa pun, misalnya: PowerShell Core, PowerShell, dan distribusi Linux/WSL yang diinstal. Setiap profil mengacu pada ikon stok melalui skema URI ms-appx. Anda dapat merujuk ke Anda sendiri ikon kustom dengan memasukkan jalur dalam file settings.json Anda:

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

Ikon harus berukuran 32x32px dalam format gambar raster yang sesuai (misalnya .PNG, .GIF, atau . ICO) untuk menghindari harus menskalakan ikon Anda selama runtime (menyebabkan penundaan yang nyata dan hilangnya kualitas).

Jika tidak ada ikon yang ditentukan untuk baris perintah yang telah Anda instal, Terminal Windows akan default ke glyph ini dari font Fasih Segoe:

Glyph	Titik Unicode	Deskripsi
	e756	CommandPrompt

Mode peregangan gambar latar belakang

Ini mengatur bagaimana gambar latar belakang diubah ukurannya untuk mengisi jendela.

Nama properti: backgroundImageStretchMode

Kebutuhan: Opsional

Menerima: "none", "fill", "uniform", "uniformToFill"

Nilai Default: "uniformToFill"

Terminal Windows mode peregangan gambar latar belakang Sumber gambar latar belakang

Perataan gambar latar belakang

Ini mengatur bagaimana gambar latar belakang selaras dengan batas jendela.

Nama properti: backgroundImageAlignment

Kebutuhan: Opsional

Menerima: "center", , "left", "top""right", "bottom", "topLeft", , "topRight", , "bottomLeft""bottomRight"

Nilai Default: "center"

Terminal Windows perataan gambar latar belakang Sumber gambar latar belakang

Keburaman gambar latar belakang

Ini mengatur transparansi gambar latar belakang.

Nama properti: backgroundImageOpacity

Kebutuhan: Opsional

Terima: Angka sebagai nilai titik mengambang dari 0-1

Nilai Default: 1.0

Transparansi

Opacity

Ini mengatur transparansi jendela untuk profil. Ini menerima nilai bilangan bulat dari 0-100, mewakili "persen buram". 100 "sepenuhnya buram", 50 semi transparan, dan 0 sepenuhnya transparan.

Ketika useAcrylic diatur ke true, jendela akan menggunakan bahan akrilik untuk membuat latar belakang kabur untuk terminal. Ketika useAcrylic diatur ke false, terminal akan menggunakan opasitas yang tidak terkirim.

Pengguna dapat memilih nilai opasitas yang berbeda untuk jendela yang fokus dan tidak fokus yang memungkinkan penyesuaian.

Nama properti: opacity

Kebutuhan: Opsional

Terima: Angka sebagai nilai bilangan bulat dari 0-100

Nilai Default: 100

Terminal Windows keburaman akrilik

Penting

Sebelum Terminal Windows versi 1.12, pengaturan ini adalah , adalah acrylicOpacityfloat yang menerima 0,0-1,0 yang default ke 0,5, dan opasitas hanya akan berlaku jika useAcrylic diatur ke true. Pada 1.12+, acrylicOpacity akan terus berfungsi sebagai nilai yang setara opacity .

Penting

Opasitas yang tidak dibentuk ("useAcrylic": false) hanya berfungsi pada Windows 11.

Penting

Ketika Mica diaktifkan dalam pengaturan tema, Mica akan muncul di bawah konten Terminal saat opacity Terminal diatur ke nilai <100.

Aktifkan akrilik

Ketika ini diatur ke true, jendela akan memiliki latar belakang akrilik. Ketika diatur ke false, jendela akan memiliki latar belakang yang polos dan tidak tereksturasi. Bergantung pada Enable Unfocused Acrylic pengaturan global, transparansi berlaku untuk jendela yang tidak fokus sebagai jendela yang difokuskan ketika diatur ke true atau hanya berlaku untuk jendela yang difokuskan ketika diatur ke false.

Nama properti: useAcrylic

Kebutuhan: Opsional

Menerima: true, false

Nilai Default: false

updated_acrylic_toggle_doc

Jendela

Padding

Ini mengatur padding di sekitar teks di dalam jendela. Ini akan menerima tiga format berbeda: "#" dan # mengatur padding yang sama untuk semua sisi, "#, #" mengatur padding yang sama untuk kanan kiri dan atas-bawah, dan "#, #, #, #" mengatur padding satu per satu untuk kiri, atas, kanan, dan bawah.

Nama properti: padding

Kebutuhan: Opsional

Menerima: Nilai sebagai string dalam format berikut: "#", , "#, #""#, #, #, #" atau nilai sebagai bilangan bulat:#

Nilai Default: "8, 8, 8, 8"

Terminal Windows padding

Visibilitas bilah gulir

Ini mengatur visibilitas bilah gulir.

Nama properti: scrollbarState

Kebutuhan: Opsional

Menerima: "visible", , "hidden"(Mulai rilis 1.17, "always" akan disertakan)

Setelan warna

Warna tab

Ini mengatur warna tab profil. Menggunakan pemilih warna tab akan mengambil alih warna ini.

Nama properti: tabColor

Kebutuhan: Opsional

Menerima: Warna sebagai string dalam format hex: "#rgb" atau "#rrggbb"

Warna latar depan

Ini mengubah warna latar depan profil. Penimpaan foreground ini diatur dalam skema warna jika colorScheme diatur.

Nama properti: foreground

Kebutuhan: Opsional

Menerima: Warna sebagai string dalam format hex: "#rgb" atau "#rrggbb"

Warna latar belakang

Ini mengubah warna latar belakang profil dengan pengaturan ini. Penimpaan background ini diatur dalam skema warna jika colorScheme diatur.

Nama properti: background

Kebutuhan: Opsional

Menerima: Warna sebagai string dalam format hex: "#rgb" atau "#rrggbb"

Warna latar belakang pilihan

Ini mengatur warna latar belakang pilihan dalam profil. Ini akan mengambil alih selectionBackground set dalam skema warna jika colorScheme diatur.

Nama properti: selectionBackground

Kebutuhan: Opsional

Menerima: Warna sebagai string dalam format hex: "#rgb" atau "#rrggbb"

Menyesuaikan warna yang tidak dapat dibedakan

Pengaturan ini menyesuaikan warna latar depan untuk membuatnya lebih terlihat, berdasarkan warna latar belakang. Ketika diatur ke always, warna akan selalu disesuaikan. Ketika diatur ke indexed, warna hanya akan disesuaikan jika warna tersebut adalah bagian dari skema warna. Ketika diatur ke never, warna tidak akan pernah disesuaikan.

Nama properti: adjustIndistinguishableColors

Kebutuhan: Opsional

Menerima: always, indexed, never

Warna kursor

Ini mengatur warna kursor profil. Ini akan mengambil alih cursorColor set dalam skema warna jika colorScheme diatur.

Nama properti: cursorColor

Kebutuhan: Opsional

Menerima: Warna sebagai string dalam format hex: "#rgb" atau "#rrggbb"

Pengaturan tampilan yang tidak fokus

Objek yang dapat Anda tambahkan ke profil yang menerapkan pengaturan ke profil saat tidak fokus. Pengaturan ini hanya menerima pengaturan tampilan.

Nama properti: unfocusedAppearance

Kebutuhan: Opsional

Menerima: , , backgroundImageAlignment, backgroundImageOpacitybackgroundImageStretchMode, cursorHeight, , cursorShape, cursorColorcolorScheme, foreground, background, , opacity, selectionBackground, useAcrylic, experimental.retroTerminalEffectbackgroundImageexperimental.pixelShaderPath

Contoh:

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

Efek shader piksel

Pengaturan ini memungkinkan pengguna untuk menentukan jalur ke shader piksel kustom untuk digunakan dengan konten terminal. Ini adalah fitur eksperimental dan keberadaannya yang berkelanjutan tidak dijamin. Untuk detail selengkapnya tentang penulisan shader piksel kustom untuk terminal, lihat dokumentasi ini.

Jika diatur, ini akan mengambil experimental.retroTerminalEffect alih pengaturan.

Nama properti: experimental.pixelShaderPath

Kebutuhan: Opsional

Menerima: Jalur ke .hlsl file shader, sebagai string

Bagikan melalui

Pengaturan profil tampilan di Terminal Windows

Teks

Skema warna

Font

Wajah font

Ukuran font

Ketebalan fon

Contoh font

Fitur font

Sumbu font

Pemformatan teks intens

Efek terminal retro

Kursor

Bentuk kursor

Tinggi kursor

Gambar dan ikon latar belakang

Jalur gambar latar belakang

Ikon

Mode peregangan gambar latar belakang

Perataan gambar latar belakang

Keburaman gambar latar belakang

Transparansi

Opacity

Aktifkan akrilik

Jendela

Padding

Visibilitas bilah gulir

Setelan warna

Warna tab

Warna latar depan

Warna latar belakang

Warna latar belakang pilihan

Menyesuaikan warna yang tidak dapat dibedakan

Warna kursor

Pengaturan tampilan yang tidak fokus

Efek shader piksel

Saran dan Komentar

Sumber Daya Tambahan: