Панель предпросмотра

Нажатие A (либо Enter или двойной щелчок) на файле открывает встроенный предпросмотр справа от списка файлов — по одному предпросмотру на вкладку. Панель занимает долю ширины окна, поэтому остаётся просторной для медиафайлов и PDF.

Что можно просмотреть

Текст и код — с прокруткой.
Изображения — PNG, JPEG, GIF, WebP, BMP — по ширине.
HEIC / AVIF / JXL — если установлен конвертер изображений (sips поставляется с macOS; heif-convert, ImageMagick или vips на Linux/Windows).
SVG.
HTML и Markdown — отображаются как статическое представление без JavaScript (скрипты никогда не выполняются, так что предпросмотр не может делать ничего активного).
PDF — постранично.

Для SVG, HTML и Markdown можно посмотреть необработанный исходный код вместо отрисованного вида — кнопкой </> в заголовке (или X на геймпаде / F2). Markdown показывает свой исходный текст .md, а не преобразованный HTML.

Вправо переходит в панель предпросмотра. Что делают остальные кнопки, зависит от вида файла:

Текст / изображение / SVG / HTML / Markdown — Вверх / Вниз прокручивают; A открывает файл в приложении ОС по умолчанию.
PDF — Вверх / Вниз листают страницы; Home / End переходят к первой и последней странице; A открывает файл во внешнем приложении.

Уровни: X идёт глубже, B возвращает

Панель — это небольшой стек, и две кнопки движутся по нему в противоположные стороны. X делает шаг ближе к необработанным байтам файла; B (или Escape) поднимается на шаг назад и закрывает панель только на самом верху.

Файл	X идёт глубже →
Текст	чтение → редактирование → закрыто
SVG, HTML, Markdown	отрисовка → исходный код → редактирование → закрыто
Изображение, PDF	закрыто

У текстового файла нет вида исходного кода, поэтому первое же X начинает редактирование. Разметке нужны два нажатия: одно — показать исходный код, другое — начать его править. ✕ в заголовке всегда закрывает сразу, на каком бы уровне вы ни были.

Редактирование текстовых файлов

Текстовый предпросмотр можно редактировать прямо на месте. Карандаш в заголовке панели — или X на геймпаде — превращает его в редактируемое поле; Esc или повторное нажатие кнопки выходит из режима. Редактируется только текст: остальные виды — это отрисованные представления, а не буферы. Поэтому X никогда не конфликтует с переключателем исходного кода: у текстового файла нет представления исходного кода.

Ctrl/Cmd+S сохраняет и работает даже тогда, когда фокус вернулся к списку файлов. На геймпаде A сохраняет, как только есть что сохранять, а если нечего — как обычно открывает файл во внешнем приложении. Точка рядом с именем файла отмечает несохранённые изменения, а рядом в заголовке появляется кнопка Сохранить.

На Steam Deck X поднимает экранную клавиатуру над полем, а кнопка B в Steam закрывает её и возвращает вас к навигации по панелям.

Файл записывается обратно в том виде, в каком был найден

DeckCrate запоминает, как прочитал файл, и сохраняет его так же:

Кодировка — файл, прочитанный как устаревший Latin-1 («ANSI»), сохраняется в Latin-1, а не перекодируется молча в UTF-8. Если вы введёте символ, который Latin-1 не вмещает — например, эмодзи, — файл будет преобразован в UTF-8, и уведомление сообщит об этом.
Концы строк — файл с CRLF сохраняет CRLF, в том числе в только что набранных строках.
Идентичность — запись выполняется на месте, поэтому символьная ссылка остаётся ссылкой, а права доступа, владелец и расширенные атрибуты переживают правку.

Разметка правится через исходный код

SVG, HTML и Markdown тоже можно редактировать — но только из вида исходного кода, где и появляется карандаш. Отрисованный вид не является буфером: от свёрстанной страницы нет пути обратно к файлу, поэтому вы правите саму разметку.

Всё сказанное выше действует без изменений, включая гарантии по кодировке и концам строк. Два момента характерны именно для разметки:

При сохранении .md записывается Markdown, а не HTML, в который он был преобразован.
Отрисованный вид обновляется при сохранении, поэтому, выйдя из редактора, вы увидите новое содержимое, а не ту версию, что лежала на диске при открытии.

Возврат к отрисованному виду с несохранёнными правками показывает сохранённую версию, а точка остаётся на месте — это то, что на диске, а точка говорит, что есть ещё что-то.

Несохранённые изменения

Всё, что отбросило бы отредактированный буфер, сначала спрашивает и предлагает Сохранить, Отбросить или Отмена (A, Y и B на геймпаде):

закрытие панели,
предпросмотр другого файла,
открытие терминала, который делит место с предпросмотром,
уменьшение числа вкладок ниже вкладки с несохранёнными изменениями,
выход через меню команд или панель инструментов.

У каждой вкладки свой буфер, поэтому переключение вкладок никогда не стоит вам набранного текста — точка остаётся, пока вы не сохраните или не отбросите правки.

Отключение отрисовки

Настройки → Предпросмотр → Отрисованный предпросмотр включён по умолчанию. Выключите его — и SVG, HTML и Markdown будут открываться на исходном коде: одно X сразу начинает редактирование, кнопка </> исчезает, а B закрывает панель, вместо того чтобы показать отрисованный вид. Для таких файлов отрисованного уровня попросту нет.

Текст, изображения и PDF не затрагиваются. Настройка действует на предпросмотры, открытые после неё; уже открытая панель сохраняет свой уровень.

Когда файл нельзя просмотреть

Двоичные файлы, неподдерживаемые форматы и слишком большие файлы просмотреть нельзя. Вместо этого DeckCrate предлагает открыть их в приложении ОС по умолчанию. Из этого же запроса можно нажать Y, чтобы выбрать конкретное приложение (см. Открыть файл с помощью…).

Открытие в приложении по умолчанию

Любой файл можно открыть в его приложении по умолчанию кнопкой A на панели предпросмотра — или напрямую для любого файла, который нельзя просмотреть.

Открыть файл с помощью…

Для одного подсвеченного файла пункт Открыть файл с помощью… в меню команд показывает список установленных приложений с навигацией геймпадом, отсортированный по алфавиту. A / Enter подтверждает, B / Esc отменяет. Он также предлагается по кнопке Y в запросе «нельзя просмотреть». Работает на macOS, Linux и Windows.