Skip to content

Русский

Jump to bottom
Peter Wone edited this page Mar 24, 2024 · 2 revisions
  1. Общее использование
  2. Настройка
  3. Уценка
    1. Подэлемента
  4. Печать других форматов, визуализированных
  5. Устранение неполадок

Общее использование

Существует несколько способов печати.

  • Вы можете распечатать активный документ с помощью значка или контекстного меню.
  • Вы можете распечатать выделенный фрагмент из активного документа, с помощью значка или контекстного меню.
  • Вы можете распечатать один или несколько файлов прямо из панели проводника, с помощью контекстного меню папки, файла или множественного выбора файлов.
  • Файлы могут быть озаглавлены с указанием пути к файлу. Заголовок не отображается в документе, но может использоваться в заголовках в некоторых браузерах.
    • Вы можете выбрать один из следующих форматов.
      • Нет пути
      • Сокращённо (например, D:\...\containing-folder\file.ext)
      • Относительная рабочая область
  • Путь к файлам может отображаться в виде заголовка в начале документа.
    • Параметр определяет, следует ли использовать относительные или абсолютные пути к файлам.
    • В файлах, не относящихся к рабочей области, всегда используется absolute.
    • Абсолютные пути преобразуются в пути тильды, когда они находятся в домашнем каталоге пользователя.
  • Параметр определяет, будет ли заголовок пути к файлу отображаться в начале отдельных напечатанных файлов.
  • Списки исключений применяются как к папкам, так и к файлам. Они предназначены для того, чтобы игнорировать непечатаемые двоичные файлы.

Документы Markdown могут быть визуализированы и стилизованы. Это подробно описано в разделе Markdown.

Печать активного документа

Чтобы распечатать активный документ, просто нажмите на значок принтера справа от вкладок документа. Убедитесь, что у вас не выделено несколько строк текста. В противном случае будет напечатан выделенный фрагмент, а не весь документ. Управление размером бумаги, полями и ориентацией страницы осуществляется в диалоговом окне печати.

Печать выделенного фрагмента в активном документе

Выделите многострочный блок текста в активном документе. Затем щелкните значок принтера справа от вкладок документа или щелкните правой кнопкой мыши выделенный фрагмент и выберите Печать из контекстного меню. Когда появляется контекстное меню, Print отображается вверху, внизу или нигде (или рядом) в зависимости от параметра Print: Editor Context Menu Position .

Номера строк в распечатке выравниваются с номерами строк в редакторе, независимо от того, видны они или нет. Таким образом, если вы обсуждаете строку кода с номером 1145 в обзоре кода и открываете файл, чтобы изменить ее, набрав Ctrl+G, а затем 1145 [Enter], поместите курсор прямо на нужную строку кода.

Печать файла, не открывая его

Чтобы распечатать файл, отличный от активного документа, найдите его на панели ПРОВОДНИК и щелкните по нему правой кнопкой мыши. В контекстном меню файла Print всегда отображается в верхней части меню или рядом с ней. При этом будет распечатан весь файл.

Печать всех файлов в папке

Если вы нажмете F1 и введете папку вы обнаружите, что можете распечатать все файлы для печати в папке, содержащей активный документ. Создается одно задание на печать со всеми файлами, разделенными заголовками с указанием их имен.

Настройка

Большинство из этих настроек настраивают пользовательский интерфейс (значок, расположение меню и т. д.). Чтобы найти эти параметры, откройте панель параметров VS Code и перейдите в раздел Расширения/Печать или просто выполните поиск по запросу "печать".

Ниже приведен список доступных имен настроек в том виде, в котором они отображаются в конфигурационном файле.

  • print.alternateBrowser : включить/выключить альтернативный браузер
  • print.browserPath : путь к веб-браузеру
  • print.colourScheme : таблица стилей, используемая для раскрашивания синтаксиса
  • print.editorContextMenuItemPosition : позиция Print в контекстном меню редактора
  • print.editorTitleMenuButton : показать кнопку печати в меню заголовка редактора
  • print.fontSize : размер шрифта (варианты от 6 до 13 пт)
  • print.formatMarkdown : отображать Markdown в виде стилизованного HTML при печати
  • print.lineNumbers : вкл., выкл или наследовать (из редактора)
  • print.lineИнтервал : одинарный, полуторный или двойной интервал
  • print.printAndClose : после печати закройте браузер
  • print.folder.include: шаблон для включаемых файлов. Пустое соответствует всему.
  • print.folder.exclude: шаблоны для исключения
  • print.folder.maxFiles: максимальное количество файлов, для которых отображается содержимое при печати папки
  • print.folder.maxLines: файлы, содержащие больше строк, чем это пороговое значение, будут игнорироваться
  • print.logLevel: управляет уровнем детализации файла журнала.
  • print.filepathAsDocumentHeading: управляет использованием пути к файлу в качестве заголовка в начале документа.
  • print.filepathAsDocumentTitle: управляет использованием пути к файлу в качестве заголовка документа (используется некоторыми браузерами в заголовке страницы)
  • print.filepathHeadingForIndividuallyPrintedDocuments: определяет, будет ли заголовок пути к файлу отображаться в начале отдельно напечатанных документов

Настройка пользовательского интерфейса

Можно указать, будет ли значок печати отображаться на панели инструментов при фокусировке на панели редактора. Этот параметр помечен кнопки меню заголовка редактора.

Вы можете контролировать, будет ли пункт меню «Печать» отображаться вверху, внизу или нигде в контекстных меню, с помощью настройки ESC_CODESPAN_CLOSE «Положение пункта контекстного меню редактора ESC_CODESPAN_OPEN».

Если установлен флажок Печать и закрытие, при печати что-либо автоматически откроется диалоговое окно браузера Печать, а затем браузер будет автоматически закрыт после печати или отмены. При отключении этого параметра откроется браузер с визуализированным документом, готовым к проверке. Если затем вручную открыть диалоговое окно «Печать», его печать или отмена не закроют браузер.

Использование определенного браузера для печати

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

По умолчанию для печати используется браузер по умолчанию. Тем не менее, печать лучше всего работает с браузером, производным от Chromium, и может быть невозможно или нежелательно изменить браузер по умолчанию.

Чтобы разрешить печать с помощью браузера, который не является браузером по умолчанию, можно указать путь к альтернативному браузеру, а также установить флажок, позволяющий включать и выключать этот браузер без потери пути.

Эти параметры помечены ESC_CODESPAN_CLOSE пути браузера и ESC_CODESPAN_OPEN альтернативного браузера соответственно.

Путь к альтернативному браузеру автоматически заключен в кавычки в Windows, а на платформах на основе Unix пробелы экранируются. К сожалению, это несовместимо с предоставлением параметров командной строки.

Если вам нужно указать параметры командной строки, создайте пакетный файл (или файл сценария bash), в котором указаны параметры, и обратитесь к файлу сценария bash в альтернативном пути браузера.

Печать исходного кода

С помощью ESC_CODESPAN_CLOSE настройки ESC_CODESPAN_OPEN Цветовая схема можно указать цветовую схему, используемую для раскрашивания синтаксиса. Выбор ограничен светлыми темами, так как принтеры используют белую бумагу.

При печати активного документа с многострочным выделением печатается только выделенная область.

Тип начертания и размер

Гарнитура шрифта определяется настройками редактора VS Code. Если вы видите Fira Code на экране, это то, что будет напечатано.

Размер ESC_EM_OPEN ESC_EM_CLOSE печатного текста является параметром Печать, так как размер, который лучше всего подходит для экрана, может не совпадать с размером, который лучше всего подходит для бумаги.

Если вам интересно, почему мы называем его шрифтом, а не шрифтом, то это потому, что шрифт — это определенный шрифт определенного размера и обработки. "12pt Times italic" - это шрифт. «Times» — это шрифт. Не помогает и то, что средство выбора шрифтов Windows (которое ESC_EM_OPEN ESC_EM_CLOSE выбирает шрифт, вам нужно указать гарнитуру, размер и обработку) неправильно помечает гарнитуру как «Шрифт».

Печать Markdown

Вы, вероятно, хотите, чтобы задания печати Markdown отображались и стилизовывались, и это поведение по умолчанию. Если вы хотите распечатать Markdown в качестве исходного кода, вы можете снять флажок Print: Render Markdown .

Цветовая гамма

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

Уценка

Стилизация Markdown

Применение файлов CSS к документу Markdown

  • Тег ссылки таблицы стилей можно встраивать непосредственно в Markdown. Это относится к конкретному документу.
  • Есть параметр markdown.styles. Это список URL-адресов. Как встроенная предварительная версия Markdown, так и печать будут учитывать этот список. Можно использовать абсолютные URL-адреса, относительные URL-адреса рабочей области или относительные URL-адреса документов, как показано в следующем примере.
"markdown.styles": [
    "https://cdn.jsdelivr.net/npm/[email protected]/dist/katex.min.css",
    "path/to/document/relative/custom.css",
    "workspace.resource/path/to/stylesheet.css"
]

Относительные URL-адреса рабочей области — лучший способ совместного использования ресурсов между документами. Они находятся в рабочей области, поэтому их можно контролировать вместе с документами, а поскольку URL-адрес относится к рабочей области, а не к документу, вы можете упорядочивать (и реорганизовывать) документы в папках, не нарушая URL-адреса. Обратите внимание, что это относится не только к таблицам стилей, но и к ресурсам файлов изображений.

Связывание стиля с Markdown

Сопоставление Markdown с сгенерированным HTML очевидно. Таблицы становятся ESC_CODESPAN_CLOSE таблицы, ESC_CODESPAN_OPEN и td элементами. Заголовки H1 до H9. Абзацы P элементы, маркеры и цифры ul и ol элементы.

Не забывайте, что вы можете встраивать HTML в Markdown, поэтому ничто не мешает вам использовать div или span применить класс CSS к блоку или запуску Markdown.

Веб-сервер

Встроенный веб-сервер привязывается только к адресу замыкания на себя и принимает только указанные соединения.

Расширения Katex Markdown

Katex зависит от CSS и шрифтов из Интернета. Для того, чтобы печать работала, необходимо добавить требуемую таблицу стилей в настройки. Если вы обнаружите, что одна или две вещи работают в предварительном просмотре, но не в печати, определите текущую версию на веб-сайте KaTeX и обновите URL-адрес.

"markdown.styles": [
    "https://cdn.jsdelivr.net/npm/[email protected]/dist/katex.min.css"
]

Если вы хотите отрезать шнур, импортируйте ресурсы Katex в свой проект, как описано в предыдущем разделе, и используйте ссылку, относящуюся к рабочей области.

Вот несколько примеров, которые помогут вам проверить конфигурацию.``` $$ \begin{alignedat}{2} 10&x+ &3&y = 2 \ 3&x+&13&y = 4 \end{alignedat} $$ and thus

$$ x = \begin{cases} a &\text{if } b \\ c &\text{if } d \end{cases} $$


## Визуализированный Markdown и удаленные рабочие области

Для работы с удаленными рабочими областями расширение Markdown должно выполняться на удаленном узле, так как именно там выполняется конвейер отрисовки Markdown. Такие расширения, как Print, предназначенные для использования с удаленными рабочими местами, можно развернуть на удаленном узле одним щелчком мыши. Большинство расширений Markdown способны работать таким образом, но они не настроены на это.

К сожалению, расширения Markdown обычно не настроены для удаленного использования; Проектировщики ожидали, что они будут работать локально. 

### Самостоятельное исправление расширений Markdown

Если вам нужно срочно, вы можете самостоятельно пропатчить расширения. 

1. Найдите расширения, где они установлены на вашей рабочей станции, в `~/.vscode/extensions` (в Windows замените `%userprofile%` на `~`)
2. Отредактируйте `package.json` файлы для расширений Markdown, которые вы хотите использовать на удаленных хостах. Добавьте `extensionKind` в качестве атрибута корневого уровня. 
3. После редактирования всех расширений Markdown перезапустите VS Code.
4. Установите расширение на удаленном узле и исправьте расширение на удаленном узле таким же образом.


```json
...
"extensionKind": [
  "workspace"
],
...

Патчи, подобные этому, будут потеряны при следующем обновлении расширения, поэтому, если ваш патч был успешным, вы можете отправить запрос на вытягивание издателю.

Визуализация печати в других форматах

Были зарегистрированы проблемы, запрашивающие визуализированную печать форматов, отличных от Markdown. В качестве примера можно привести ноты из разметки ABC Music и Jupyter Notebooks. Чтобы поддержать это, не беря на себя непосильную нагрузку по поддержанию всех текстовых форматов документов, используемых с VS Code, мы предоставили API и опубликовали пакет SDK, позволяющий сопровождающим включать печать в свои возможности предварительного просмотра.

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

Устранение неполадок

Необходимые условия

  • Начните с того, что убедитесь, что вы можете распечатать веб-страницу из браузера.
  • Пользователь, от имени которого запускается VS Code, должен иметь возможность установить прослушивающий сокет.

Проблемы с первым запуском

  • Кажется, ничего не происходит — перезапустите VS Code.
  • Браузер запускается, но страница не загружается — проверьте сетевые разрешения.
  • Браузер выдает сообщение об ошибке о том, что вы не нашли CSS-файл — вы установили его с VSIX, который не был подготовлен нами. Получите официальный пакет и повторите попытку.

Если что-то еще не так или у вас есть идеи по улучшению, мы приглашаем вас зарегистрировать проблему в репозитории GitHub.

Выбор браузера

Используемый браузер повлияет на вашу работу.

Рекомендуется для печати

Для достижения наилучших результатов печати установите браузер на основе Chromium или Firefox. Если вы не хотите делать этот браузер браузером по умолчанию, воспользуйтесь настройками альтернативного браузера. Во время этого выпуска проблемы с маршрутизацией команд приводили к тому, что печать из удаленных рабочих мест возвращалась к использованию принтера по умолчанию. Полный сервис будет восстановлен в кратчайшие сроки.

Известно, что хорошо работают следующие.- Храбрый

  • Хром
  • Хром
  • Край
  • Браузер Firefox

НЕ рекомендуется для печати

  • Edge Classic больше не поддерживается.
  • Internet Explorer не поддерживается.

Расширения Markdown и удаленное взаимодействие

Чтобы использовать печать с удаленным узлом, необходимо установить его на удаленного узла.

Чтобы воспользоваться преимуществами расширения Markdown при печати документа с удаленного узла, расширение Markdown должно быть создано с ESC_CODESPAN_CLOSE extensionKind ESC_CODESPAN_OPEN рабочей области, и оно должно быть установлено на удаленном узле.

Большинство таких расширений не предназначены для рабочих. Их можно тривиально исправить, изменив их package.json. К сожалению, этот ручной патч, скорее всего, будет потерян при обновлении расширения, поэтому вам следует сообщить об этом автору расширений, которые вы исправляете.

Альтернативный браузер

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

Вы не можете указать параметры командной строки в альтернативном пути браузера. В Windows мы автоматически заключаем путь в кавычки в случае пробелов в именах файлов или папок. На других платформах пробелы экранируются автоматически.

Как автоматическое заключение в кавычки, так и экранирование пробелов несовместимы с использованием параметров командной строки. Решение состоит в том, чтобы создать командный файл (или сценарий оболочки), который запускает браузер с параметрами командной строки, и указать путь к пакетному файлу (или скрипту оболочки).

Chrome и плагины

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

Некоторые плагины Chrome мешают стилизации заданий печати. Хотя можно подавить плагины с помощью --disable-plugins, это не работает, когда уже есть запущенный экземпляр Chrome. Ключ --incognito подавляет плагины при наличии запущенного экземпляра, но имеет свои проблемы.

Сообщение о проблеме

Если вы по-прежнему ESC_EM_OPEN ESC_EM_CLOSE не можете заставить Print работать, сообщить о проблеме в репозитории. Мы постараемся вам помочь.

Мы можем попросить вас повысить уровень ведения журнала, воспроизвести проблему, а затем отправить нам журнал.

Лесозаготовка

Задайте уровень ведения журнала с помощью параметра Печать: Уровень журнала. По умолчанию это ESC_CODESPAN_CLOSE ошибок (минимальное ведение журнала), но вы можете включить его вплоть до ESC_CODESPAN_OPEN отладки, который очень подробный, или даже глупый, который даже будет регистрировать вызовы сборщика мусора.

Clone this wiki locally