Просмотр файлов, изображений и PDF
После выбора файла File Inspector определяет способ его отображения. Текстовые файлы показываются в режиме чтения кода, изображения — как изображение, PDF — во встроенном просмотре браузера.
Текстовые файлы
Для текстового файла в верхней части выводятся расширение, размер, дата изменения, количество строк и символов. Сам текст открывается только для чтения. Чтобы изменить содержимое, перейдите на вкладку «Редактор».
Параметр max_bytes_per_file ограничивает объём текста, который File Inspector читает для просмотра. Значение по умолчанию — 524288 байт. Если файл больше, модуль возвращает только начало и добавляет отметку о том, что содержимое обрезано.
Не редактируйте обрезанный большой файл как обычный: встроенный редактор предназначен прежде всего для файлов, которые полностью помещаются в установленный лимит.
Бинарные файлы
PNG, JPG, GIF, WebP, SVG-подобные изображения и PDF не читаются как текст. Для них используется отдельный механизм предпросмотра. Архивы, шрифты, аудио и видео не следует ожидать увидеть как исходный текст.
[Скриншот 1: предпросмотр изображения в File Inspector]
Скачивание файла
Для выбранного файла доступно скачивание через служебный endpoint модуля. Путь всё равно проверяется относительно разрешённого корня, поэтому через эту функцию нельзя скачать произвольный файл вне настроенного каталога.
Если предпросмотр не открывается
- проверьте, что файл существует и доступен для чтения;
- убедитесь, что его расширение разрешено настройками;
- для PDF проверьте, разрешает ли браузер встроенный просмотр;
- для очень больших файлов учитывайте лимит предпросмотра;
- после изменения настроек нажмите «Обновить».
[Скриншот 2: просмотр PDF или текстового файла с метаданными]