-
Notifications
You must be signed in to change notification settings - Fork 27
日本語
- ESC_LINK_OPEN IzE ESC_LINK_CLOSE ESC_LINK_SPLIT一般的な使用
- ESC_LINK_OPEN IzI ESC_LINK_CLOSE ESC_LINK_SPLITセットアップをカスタマイズする
-
Markdown
- サブアイテム
- ESC_LINK_OPEN IzQ ESC_LINK_CLOSE ESC_LINK_SPLITレンダリングされた他のフォーマットの印刷
- ESC_LINK_OPEN IzU ESC_LINK_CLOSE ESC_LINK_SPLITトラブルシューティング
印刷する方法はいくつかあります。
- アクティブなドキュメントは、アイコンまたはコンテキストメニューで印刷できます。
- 作業中のドキュメントから、アイコンまたはコンテキスト メニューを使用して選択範囲を印刷できます。
- 1つ以上のファイルをファイルエクスプローラーパネルから直接印刷したり、フォルダー、ファイル、またはファイルの複数選択のコンテキストメニューから印刷したりできます。
- ファイルには、ファイルパスでタイトルを付けることができます。タイトルはドキュメントには表示されませんが、一部のブラウザーではヘッダーで使用される場合があります。
- 次の形式から選択できます。
- パスなし
- 省略形 (例:
D:\...\containing-folder\file.ext) - ワークスペースの相対
- 次の形式から選択できます。
- ファイルのファイルパスは、ドキュメントの先頭に見出しとして表示できます。
- 設定によって、相対ファイルパスと絶対ファイルパスのどちらを使用するかが決まります。
- ワークスペース以外のファイルでは、常に絶対値が使用されます。
- 絶対パスは、ユーザーのホームディレクトリ内にある場合、チルダパスに変換されます。
- 設定によって、個別に印刷されるファイルの先頭にファイルパスの見出しを表示するかどうかが決まります。
- 除外リストは、フォルダとファイルの両方の選択に適用されます。これらの目的は、印刷できないバイナリファイルを無視することです。
Markdownドキュメントは、レンダリングおよびスタイルを設定できます。これについては、Markdownセクションで詳しく説明します。
アクティブなドキュメントを印刷するには、ドキュメントタブの右側にあるプリンタアイコンをクリックします。複数行のテキストが選択されていないことを確認します。それ以外の場合は、ドキュメント全体ではなく、選択範囲が印刷されます。ESC_STRONG_OPEN 用紙サイズ、余白、ページの向きのコントロールは、印刷ダイアログにあります。ESC_STRONG_CLOSE
作業中の文書で複数行のテキストブロックを選択します。次に、ドキュメントタブの右側にあるプリンターアイコンをクリックするか、選択範囲を右クリックして、コンテキストメニューからESC_CODESPAN_OPEN印刷ESC_CODESPAN_CLOSEを選択します。コンテキストメニューが表示されるESC_CODESPAN_OPEN、印刷: エディタのコンテキストメニュー項目の位置ESC_CODESPAN_CLOSEの設定に応じて、印刷ESC_CODESPAN_CLOSEが上部、下部、またはどこにも表示されないESC_CODESPAN_OPEN表示されます。
印刷出力の行番号は、表示されているかどうかに関係なく、エディターの行番号と一致します。したがって、コードレビューで 1145 という番号のコード行について議論していて、ファイルを開いて修正する場合、Ctrl+G ESC_CODESPAN_CLOSE ESC_CODESPAN_OPENと入力してから [Enter] 1145を入力すると、カーソルが問題のコード行に直接置かれます。
アクティブなドキュメント以外のファイルを印刷するには、エクスプローラーペインでファイルを見つけて右クリックします。ファイルのコンテキスト メニューではESC_CODESPAN_OPEN印刷ESC_CODESPAN_CLOSEは常にメニューの上部または近くに表示されます。これにより、ファイル全体が印刷されます。
F1 ESC_CODESPAN_CLOSEキー ESC_CODESPAN_OPEN ESC_CODESPAN_OPEN印刷フォルダESC_CODESPAN_CLOSEを入力すると、作業中のドキュメントを含むフォルダ内のすべての印刷可能なファイルを印刷できます。1 つの印刷ジョブが作成され、すべてのファイルが見出しで区切られ、名前が表示されます。
これらの設定のほとんどは、ユーザーエクスペリエンス(アイコン、メニューの場所など)をカスタマイズします。これらの設定を見つけるには、VS Code の設定ウィンドウを開き、[拡張機能] / [印刷] に移動するか、単に "印刷" を検索します。
以下は、構成ファイルに表示される使用可能な設定名の一覧です。
-
print.alternateBrowser: 代替ブラウザを有効/無効にする -
print.browserPath: Web ブラウザーへのパス -
print.colourScheme: 色付け構文に使用されるスタイルシート -
print.editorContextMenuItemPosition: エディタのコンテキストメニューにおけるPrintの位置 -
print.editorTitleMenuButton: エディタのタイトルメニューに印刷ボタンを表示 -
print.fontSize: フォントサイズ (6 から 13 ポイントまでのオプション) -
print.formatMarkdown: 印刷時にMarkdownをスタイル付きHTMLとしてレンダリングする -
print.lineNumbers: on, off, inherit (from editor) (英語) -
print.lineSpacing: シングル、ライン、ハーフ、ダブルスペース -
print.printAndClose: 印刷後、ブラウザを閉じます -
print.folder.include: インクルードするファイルのパターン。empty はすべてに一致します。 -
print.folder.exclude: 除外するパターン -
print.folder.maxFiles:フォルダの印刷時にコンテンツがレンダリングされるファイルの最大数 - print.folder.maxLines ESC_CODESPAN_CLOSE ESC_CODESPAN_OPEN:このしきい値を超える行数を含むファイルは無視されます
-
print.logLevel: ログファイルに入る詳細レベルを制御します -
print.filepathAsDocumentHeading: ドキュメントの先頭の見出しとしてのファイルパスの使用を制御します -
print.filepathAsDocumentTitle: ドキュメントタイトルとしてのファイルパスの使用を制御します(一部のブラウザではページヘッダーで使用されます) -
print.filepathHeadingForIndividuallyPrintedDocuments: 個別に印刷されるドキュメントの先頭にファイルパスヘッダーを表示するかどうかを制御します
エディターペインにフォーカスを置いたときにツールバーに印刷アイコンを表示するかどうかを制御できます。この設定には、エディタESC_CODESPAN_OPENタイトル メニュー ボタン ESC_CODESPAN_CLOSE というラベルが付けられています。
「印刷」メニュー項目をコンテキストメニューの上部、下部、またはどこにも表示しないかどうかは、ESC_CODESPAN_OPEN エディタのコンテキストメニュー項目の位置ESC_CODESPAN_CLOSE設定を使用して制御できます。
[ESC_CODESPAN_OPEN印刷して閉じるESC_CODESPAN_CLOSE]設定がオンになっている場合、何かを印刷すると、ブラウザの[印刷]ダイアログが自動的に開き、印刷またはキャンセルするとブラウザが自動的に閉じます。これをオフにすると、ブラウザが開き、レンダリングされたドキュメントを検査する準備が整います。その後、手動で [印刷] ダイアログを開いた場合、印刷またはキャンセルしてもブラウザーは閉じません。
ESC_STRONG_OPEN このリリースの時点では、コマンドルーティングの問題により、リモートワークスペースからの印刷がデフォルトプリンターの使用にフォールバックしていました。フルサービスはできるだけ早く復旧します。ESC_STRONG_CLOSE
既定では、印刷は既定のブラウザーを使用します。ただし、印刷は Chromium から派生したブラウザーで最適に機能し、既定のブラウザーを変更できない、または望ましくない場合があります。
既定のブラウザーではないブラウザーを使用して印刷できるようにするには、別のブラウザーへのパスを指定し、パスを失うことなくこのオンとオフを切り替えることができるチェックボックスもあります。
これらの設定にはESC_CODESPAN_OPEN、それぞれ [ブラウザー パス ESC_CODESPAN_CLOSE] と [代替ブラウザー] というラベルが付けられています。
代替ブラウザへのパスは、Windowsでは自動引用符で囲まれ、Unixベースのプラットフォームではスペースがエスケープされます。残念ながら、これはコマンドラインオプションの提供と互換性がありません。
コマンドラインオプションを指定する必要がある場合は、オプションを指定するバッチファイル(またはbashスクリプトファイル)を作成し、代替ブラウザパスでbashスクリプトファイルを参照します。
ESC_CODESPAN_OPEN の配色ESC_CODESPAN_CLOSE設定を使用して、シンタックスの色分けに使用する配色を指定できます。プリンターは白い用紙を使用するため、選択肢は明るいテーマに限定されます。
作業中の文書を印刷するときに複数行の選択範囲がある場合は、選択範囲のみが印刷されます。
書体は、VS Code エディターの設定によって決まります。画面にFiraコードが表示されている場合は、それが印刷されます。
印刷されるテキストのESC_EM_OPENサイズESC_EM_CLOSEは、画面上で最適に機能するサイズが用紙上で最適に機能するサイズとは異なる可能性があるため、印刷設定です。
なぜフォントではなく書体と呼ぶのか疑問に思われるかもしれませんが、それはフォントが特定のサイズと処理の特定の書体だからです。「12pt Times italic」はフォントです。「Times」は書体です。Windowsフォントピッカー(フォントを選択するESC_EM_OPEN、書体、サイズ、および処理を指定する必要があるESC_EM_CLOSE)が書体を「フォント」と誤ってラベル付けすることは役に立ちません。
おそらくMarkdownの印刷ジョブをレンダリングしてスタイルを設定したいでしょうが、これはデフォルトの動作です。Markdownをソースコードとして印刷したい場合は、 印刷:Markdown ESC_CODESPAN_CLOSEをレンダリングESC_CODESPAN_OPEN設定のチェックを外すことができます。
ソースコードの印刷には、スタイルシートがバンドルされており、リストから名前で選択できます。プリンタの用紙は白であり、プリンタのインクとトナーは白い用紙用に設計されているため、選択肢は明るいスタイルシートに限定されます。
- スタイルシートのリンクタグを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 はドキュメントではなくワークスペースを基準にしているため、URL を壊すことなくフォルダー内のドキュメントを整理 (および再編成) できます。これはスタイルシートだけでなく、画像ファイルリソースにも適用されることに注意してください。
Markdownから生成されたHTMLへのマッピングは明白です。テーブルはテーブルESC_CODESPAN_CLOSE ESC_CODESPAN_OPENになり、ESC_CODESPAN_OPEN番目のESC_CODESPAN_CLOSEとtd要素になります。見出しは H1 ESC_CODESPAN_CLOSE から H9 ESC_CODESPAN_CLOSE ESC_CODESPAN_OPENです。段落は P 要素ESC_CODESPAN_OPEN、箇条書きと番号は ul ESC_CODESPAN_CLOSE 要素と ol要素ESC_CODESPAN_OPEN。
MarkdownにHTMLを埋め込むことができるので、divまたはESC_CODESPAN_OPENスパンESC_CODESPAN_CLOSEを使用してCSSクラスをMarkdownのブロックまたは実行に適用することを妨げるものは何もありません。
組み込み Web サーバは、ループバック アドレスにのみバインドし、指定した接続のみを受け入れます。
Katexは、WebのCSSとフォントに依存しています。印刷を機能させるには、必要なスタイルシートを設定に追加する必要があります。プレビューでは機能しているのに印刷物では機能しないものが 1 つまたは 2 つある場合は、KaTeX の Web サイトから現在のバージョンを確認し、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
## レンダリングされた Markdown とリモート ワークスペース
リモート ワークスペースを操作するには、Markdown レンダリング パイプラインが実行される場所であるため、リモート ホストで Markdown 拡張機能を実行する必要があります。リモートワークスペースで使用するために設計されたPrintなどの拡張機能は、1回のクリックでリモートホストにデプロイできます。ほとんどのMarkdown拡張機能はこのように動作できますが、設定されていません。
残念ながら、Markdown拡張機能は通常、リモートで使用するように構成されていません。設計者は、それらがローカルで動作することを期待していました。
### Markdown拡張機能のDIYパッチ適用
緊急に必要な場合は、拡張機能に自分でパッチを適用できます。
1. ワークステーションにインストールされている拡張機能を ~/.vscode/extensions ESC_CODESPAN_CLOSE ESC_CODESPAN_OPEN見つけます (Windows では、`~` を ESC_CODESPAN_OPEN%userprofile% ESC_CODESPAN_CLOSE に置き換えてください)
2. リモートホストで使用するMarkdown拡張機能の`package.json`ファイルを編集します。extensionKind ESC_CODESPAN_OPEN ESC_CODESPAN_CLOSEをルート レベルの属性として追加します。
3. すべての Markdown 拡張機能を編集したら、VS Code を再起動します。
4. リモートホストに拡張機能をインストールし、同じ方法でリモートホストに拡張機能にパッチを適用します。
```json
...
"extensionKind": [
"workspace"
],
...
このようなパッチは拡張機能の次の更新で失われるため、パッチが成功した場合は、発行元に PR を送信することをお勧めします。
Markdown以外の形式のレンダリング印刷を要求する問題がログに記録されています。例としては、ABC music マークアップの楽譜や Jupyter Notebook などがあります。VS Code で使用されるすべてのテキストベースのドキュメント形式に追いつくという管理不能な負担を負うことなくこれをサポートするために、メンテナがプレビュー機能に印刷を組み込めるように API を公開し、SDK を公開しました。
そのため、プレビューを提供する拡張機能が既にある特定の形式でレンダリング印刷する場合は、その拡張機能の発行元に問題を提起してください。印刷したいという希望を説明し、印刷のために参照し、参照してください
<a name="5"です>
- まず、ブラウザからWebページを印刷できることを確認します。
- VS Code を実行するユーザーは、リッスン ソケットを確立できる必要があります。
- 何も起こらないようです—VSCodeを再起動します。
- ブラウザは起動するが、ページが読み込まれない — ネットワークの権限を確認してください。
- ブラウザーに、CSS ファイルが見つからないというエラー メッセージが表示されます — Microsoft が準備していない VSIX からインストールしました。aHR0cHM6Ly9tYXJrZXRwbGFjZS52aXN1YWxzdHVkaW8uY29tL2l0ZW1zP2l0ZW1OYW1lPXBkY29uc2VjLnZzY29kZS1wcmludA ESC_LINK_CLOSE ESC_LINK_SPLIT ESC_LINK_OPEN公式パッケージを入手して、もう一度やり直してください。
他に何か問題がある場合、または改善のアイデアがある場合は、GitHub リポジトリに問題を記録することをお勧めします。
使用するブラウザは、エクスペリエンスに影響します。
最良の印刷結果を得るには、Chromium ベースのブラウザーまたは Firefox をインストールしてください。これを既定のブラウザーにしたくない場合は、代替ブラウザーの設定を利用します。ESC_STRONG_OPEN このリリースの時点では、コマンドルーティングの問題により、リモートワークスペースからの印刷がデフォルトプリンターの使用にフォールバックしていました。フルサービスはできるだけ早く復旧します。ESC_STRONG_CLOSE
以下がうまくいくことがわかっています。- 勇ましい
- クロム
- クロム
- 端
- Firefoxの
- Edge Classic はサポートされなくなりました。
- Internet Explorerには対応していません。
リモートホストで Print を使用するには、リモートホストESC_STRONG_CLOSEに Print をESC_STRONG_OPENインストールする必要があります。
リモート ホストからドキュメントを印刷するときに Markdown 拡張機能の利点を得るには、Markdown 拡張機能をワークスペース ESC_CODESPAN_CLOSE ESC_EM_OPENの extensionKindでビルドしESC_CODESPAN_OPEN ESC_EM_CLOSEリモート ホストにインストールする必要があります。
このような拡張機能のほとんどは、ワークスペースESC_CODESPAN_CLOSE用に構築されていませんESC_CODESPAN_OPEN。これらは、package.jsonを変更することで簡単に修正できます。残念ながら、この手動パッチは拡張機能が更新されるたびに失われる可能性が高いため、パッチを適用する拡張機能の作成者に問題を提起する必要があります。
ESC_STRONG_OPEN このリリースの時点では、コマンドルーティングの問題により、リモートワークスペースからの印刷がデフォルトプリンターの使用にフォールバックしていました。フルサービスはできるだけ早く復旧します。ESC_STRONG_CLOSE
代替ブラウザー・パスにコマンド・ライン・オプションを指定することはできません。Windowsでは、ファイル名またはフォルダ名にスペースが含まれている場合、パスを自動的に引用符で囲みます。他のプラットフォームでは、スペースは自動的にエスケープされます。
スペースの自動引用符とエスケープはどちらも、コマンドラインオプションの使用と互換性がありません。解決策は、コマンドラインオプションでブラウザを起動するバッチファイル(またはシェルスクリプト)を作成し、バッチファイル(またはシェルスクリプト)へのパスを指定することです。
Chrome では、プリンタ、用紙サイズ、余白の選択が印刷ジョブ間で保持される場合があります。一部のChromeコマンドラインオプションでは、印刷が成功してもエラーが報告されます。
一部のChromeプラグインは、印刷ジョブのスタイル設定に干渉します。--disable-pluginsでプラグインを抑制することは可能ですが、Chromeの実行中のインスタンスがすでにある場合は機能しません。--incognitoスイッチは、実行中のインスタンスがある場合にプラグインを抑制しますが、独自の問題があります。
それでもESC_EM_OPEN ESC_EM_CLOSE Printを機能させることができない場合は、ESC_LINK_SPLITリポジトリで問題を提起しESC_LINK_OPEN aHR0cHM6Ly9naXRodWIuY29tL1BEQ29uU2VjL3ZzYy1wcmludC9pc3N1ZXM ESC_LINK_CLOSE。私たちはあなたを助けようとします。
ログレベルを上げて問題を再現し、ログを送信するようにお願いする場合があります。
[ESC_CODESPAN_OPEN印刷:ログレベルESC_CODESPAN_CLOSE]設定でログレベルを設定します。これはデフォルトでESC_CODESPAN_OPENエラー ESC_CODESPAN_CLOSE(最小限のログ記録)になりますが、非常に詳細なデバッグESC_CODESPAN_CLOSEや、ガベージコレクタへの呼び出しをログに記録するばかげたESC_CODESPAN_CLOSE ESC_CODESPAN_OPEN ESC_CODESPAN_OPENまで上げることができます。