-
Notifications
You must be signed in to change notification settings - Fork 29
Italiano
- Uso generale
- Personalizzazione della configurazione
-
Markdown
- Elemento secondario
- Stampa di altri formati renderizzati
- Risoluzione dei problemi
Ci sono un paio di modi per stampare.
- È possibile stampare il documento attivo, tramite l'icona o il menu contestuale.
- È possibile stampare una selezione dal documento attivo, tramite l'icona o il menu contestuale.
- È possibile stampare uno o più file direttamente dal pannello Esplora file, tramite il menu contestuale su una cartella, un file o una selezione multipla di file.
- I file possono essere intitolati con il loro percorso. Il titolo non viene visualizzato nel documento, ma può essere utilizzato nelle intestazioni da alcuni browser.
- È possibile scegliere tra i seguenti formati.
- Nessun percorso
- Abbreviato (come
D:\...\containing-folder\file.ext) - Area di lavoro relativa
- È possibile scegliere tra i seguenti formati.
- Il percorso dei file può essere visualizzato come intestazione all'inizio del documento.
- Un'impostazione determina se utilizzare percorsi di file relativi o assoluti.
- I file non appartenenti all'area di lavoro usano sempre absolute.
- I percorsi assoluti vengono convertiti in percorsi tilde quando si trovano all'interno della home directory dell'utente.
- Un'impostazione determina se un'intestazione del percorso del file viene visualizzata all'inizio dei singoli file stampati.
- Gli elenchi di esclusione si applicano sia alla selezione di cartelle che di file. Lo scopo di questi è quello di ignorare i file binari non stampabili.
È possibile eseguire il rendering e lo stile dei documenti Markdown. Questo è descritto in dettaglio nella sezione Markdown.
Per stampare il documento attivo è sufficiente fare clic sull'icona della stampante a destra delle schede del documento. Assicurati di non aver selezionato più righe di testo. In caso contrario, verrà stampata la selezione, non l'intero documento. Controllo del formato carta, dei margini e dell'orientamento della pagina si trova nella finestra di dialogo di stampa.
Selezionare un blocco di testo su più righe nel documento attivo. Quindi fare clic sull'icona della stampante a destra delle schede del documento o fare clic con il pulsante destro del mouse sulla selezione e scegliere ESC_CODESPAN_CLOSE di stampa dal menu contestuale. Quando viene visualizzato il menu contestuale, ESC_CODESPAN_OPEN Stampa viene visualizzato in alto (o vicino) in alto, in basso o in nessun altro punto, a seconda dell'impostazione Stampa: Posizione della voce del menu contestuale dell'editor .
I numeri di riga nella stampa sono allineati con i numeri di riga nell'editor, indipendentemente dal fatto che siano visibili o meno. Quindi, se si sta discutendo di una riga di codice numerata 1145 in una revisione del codice e si apre il file per modificarlo, digitando CTRL+G e poi 1145 [Invio] posizionerà il cursore direttamente sulla riga di codice in questione.
Per stampare un file diverso dal documento attivo, trovarlo nel riquadro EXPLORER e fare clic con il pulsante destro del mouse su di esso. Nel menu contestuale del file Stampa viene sempre visualizzato nella parte superiore del menu o vicino a esso. In questo modo viene stampato l'intero file.
Se si preme ESC_CODESPAN_CLOSE F1 e si digita ESC_CODESPAN_OPEN cartella di stampa si noterà che è possibile stampare tutti i file stampabili nella cartella che contiene il documento attivo. Viene creato un singolo processo di stampa con tutti i file separati da intestazioni che ne riportano i nomi.
La maggior parte di queste impostazioni personalizza l'esperienza dell'utente (icona, posizione del menu, ecc.). Per trovare queste impostazioni, aprire il riquadro delle impostazioni di VS Code e passare a Estensioni/Stampa o cercare semplicemente "stampa".
Di seguito è riportato un elenco dei nomi delle impostazioni disponibili così come vengono visualizzati nel file di configurazione.
-
print.alternateBrowser: abilita/disabilita un browser alternativo -
print.browserPath: il percorso di un browser web -
print.colourScheme: il foglio di stile usato per colorare la sintassi -
print.editorContextMenuItemPosition: la posizione di ESC_CODESPAN_OPEN ESC_CODESPAN_CLOSE di stampa nel menu contestuale dell'editor -
print.editorTitleMenuButton: mostra il pulsante di stampa nel menu del titolo dell'editor -
print.fontSize: la dimensione del carattere (opzioni da 6 a 13 pt) -
print.formatMarkdown: esegue il rendering di Markdown come HTML in stile durante la stampa -
print.lineNumbers: attivato, disattivato o eredita (dall'editor) -
print.lineSpacing: interlinea singola, riga e mezza o doppia spaziatura -
print.printAndClose: dopo la stampa, chiudere il browser -
print.folder.include: modello per i file da includere. Il vuoto corrisponde a tutto. -
print.folder.exclude: modelli da escludere -
print.folder.maxFiles: il numero massimo di file per i quali viene eseguito il rendering del contenuto durante la stampa di una cartella -
print.folder.maxLines: i file contenenti più righe di questa soglia verranno ignorati -
print.logLevel: controlla il livello di dettaglio del file di log -
print.filepathAsDocumentHeading: controlla l'uso del percorso del file come intestazione all'inizio di un documento -
print.filepathAsDocumentTitle: controlla l'uso del percorso del file come titolo del documento (utilizzato da alcuni browser nell'intestazione della pagina) -
print.filepathHeadingForIndividuallyPrintedDocuments: controlla se l'intestazione del percorso del file viene visualizzata all'inizio dei documenti stampati singolarmente
È possibile controllare se l'icona di stampa viene visualizzata nella barra degli strumenti quando si attiva un riquadro dell'editor. Questa impostazione è etichettata pulsante del menu Titolo dell'editor.
È possibile controllare se la voce di menu "Stampa" viene visualizzata in alto, in basso o da nessuna parte nei menu contestuali utilizzando l'impostazione ESC_CODESPAN_CLOSE posizione della voce del menu contestuale dell'editor ESC_CODESPAN_OPEN.
Quando l'impostazione Stampa e chiudi è selezionata, la stampa di un elemento aprirà automaticamente la finestra di dialogo Stampa del browser e quindi chiuderà automaticamente il browser dopo la stampa o l'annullamento. Disattivando questa opzione, si aprirà il browser con il documento di cui è stato eseguito il rendering pronto per l'ispezione. Se si apre manualmente la finestra di dialogo Stampa, la stampa o l'annullamento non chiuderà il browser.
Al momento di questa versione, i problemi con l'instradamento dei comandi causavano il fallback della stampa da aree di lavoro remote all'utilizzo della stampante predefinita. Il servizio completo verrà ripristinato il prima possibile.
Per impostazione predefinita, la stampa utilizzerà il browser predefinito. Tuttavia, la stampa funziona meglio con un browser derivato da Chromium e potrebbe non essere possibile o desiderabile modificare il browser predefinito.
Per consentire la stampa utilizzando un browser diverso da quello predefinito, è possibile specificare un percorso per un browser alternativo ed è inoltre disponibile una casella di controllo che consente di attivare e disattivare questa opzione senza perdere il percorso.
Queste impostazioni sono etichettate rispettivamente ESC_CODESPAN_CLOSE del percorso del browser e ESC_CODESPAN_OPEN del browser alternativo.
Il percorso del browser alternativo viene citato automaticamente su Windows e sulle piattaforme basate su Unix gli spazi vengono preceduti da caratteri di escape. Sfortunatamente questo è incompatibile con la fornitura di opzioni della riga di comando.
Se è necessario fornire opzioni della riga di comando, creare un file batch (o un file di script bash) che specifichi le opzioni e fare riferimento al file di script bash nel percorso alternativo del browser.
Utilizzando l'impostazione Combinazione di colori è possibile specificare la combinazione di colori utilizzata per la colorazione della sintassi. Le scelte sono limitate ai temi chiari perché le stampanti utilizzano carta bianca.
Se si stampa il documento attivo ed è presente una selezione su più righe, viene stampata solo la selezione.
Il carattere tipografico è determinato dalle impostazioni dell'editor di VS Code. Se vedi il codice Fira sullo schermo, questo è ciò che verrà stampato.
La ESC_EM_CLOSE di dimensione ESC_EM_OPEN del testo stampato è un'impostazione di stampa perché la dimensione che funziona meglio sullo schermo potrebbe non essere la dimensione che funziona meglio su carta.
Se ti stai chiedendo perché lo chiamiamo carattere tipografico e non font, è perché un font è un carattere tipografico particolare in una dimensione e un trattamento specifici. "12pt Times italic" è un font. "Times" è un carattere tipografico. Non aiuta il fatto che il Selettore di caratteri di Windows (che sceglie un carattere, è necessario specificare il carattere tipografico, la dimensione e il trattamento) etichetta erroneamente il carattere tipografico come "Carattere".
Probabilmente si desidera eseguire il rendering e lo stile dei processi di stampa Markdown, e questo è il comportamento predefinito. Se si desidera stampare Markdown come codice sorgente, è possibile deselezionare l'impostazione Stampa: Render Markdown .
Per la stampa del codice sorgente, i fogli di stile sono raggruppati e possono essere scelti per nome da un elenco. Le scelte sono limitate ai fogli di stile leggeri perché la carta della stampante è bianca e gli inchiostri e i toner della stampante sono progettati per la carta bianca.
- È possibile incorporare un tag di collegamento al foglio di stile direttamente nel Markdown. Questo è specifico per il documento.
- C'è un'impostazione chiamata
markdown.styles. Questo è un elenco di URL. Sia l'anteprima Markdown incorporata che la stampa rispetteranno questo elenco. È possibile utilizzare URL assoluti, URL relativi all'area di lavoro o URL relativi al documento, come illustrato nell'esempio seguente.
"markdown.styles": [
"https://cdn.jsdelivr.net/npm/katex@0.15.1/dist/katex.min.css",
"path/to/document/relative/custom.css",
"workspace.resource/path/to/stylesheet.css"
]Gli URL relativi all'area di lavoro sono il modo migliore per condividere le risorse tra i documenti. Si trovano nell'area di lavoro in modo che possano essere controllati dal codice sorgente insieme ai documenti e, poiché l'URL è relativo all'area di lavoro anziché al documento, è possibile organizzare (e riorganizzare) i documenti in cartelle senza interrompere gli URL. Si noti che questo vale non solo per i fogli di stile, ma anche per le risorse dei file immagine.
La mappatura da Markdown all'HTML generato è ovvia. Le tabelle diventano ESC_CODESPAN_CLOSE tabella, ESC_CODESPAN_OPEN e td elementi. Le intestazioni vanno ESC_CODESPAN_CLOSE H1 a ESC_CODESPAN_OPEN H9. I paragrafi sono elementi P, gli elenchi puntati e i numeri sono ESC_CODESPAN_CLOSE ul e ESC_CODESPAN_OPEN elementi.
Non dimenticare che puoi incorporare HTML in Markdown, quindi non c'è nulla che ti impedisca di utilizzare div o span per applicare una classe CSS a un blocco o a un'esecuzione di Markdown.
Il server Web incorporato esegue l'associazione solo all'indirizzo di loopback e accetta solo le connessioni specificate.
Katex dipende dai CSS e dai font del web. Per far funzionare la stampa, è necessario aggiungere il foglio di stile richiesto alle impostazioni. Se trovi una o due cose che funzionano nell'anteprima ma non in stampa, determina la versione corrente dal sito web di KaTeX e aggiorna l'URL.
"markdown.styles": [
"https://cdn.jsdelivr.net/npm/katex@0.15.1/dist/katex.min.css"
]Se si desidera tagliare il cavo, importare le risorse Katex nel progetto come descritto nella sezione precedente e utilizzare un riferimento relativo all'area di lavoro.
Di seguito sono riportati alcuni esempi che consentono di controllare la configurazione.``` $$ \begin{alignedat}{2} 10&x+ &3&y = 2 \ 3&x+&13&y = 4 \end{alignedat} $$ and thus
## Markdown di cui è stato eseguito il rendering e aree di lavoro remote
Per usare le aree di lavoro remote, è necessario eseguire un'estensione Markdown nell'host remoto perché è lì che viene eseguita la pipeline di rendering Markdown. Le estensioni come Print, progettate per l'uso con aree di lavoro remote, possono essere distribuite all'host remoto con un solo clic. La maggior parte delle estensioni Markdown sono in grado di funzionare in questo modo, ma non sono configurate per questo.
Sfortunatamente, le estensioni Markdown non sono normalmente configurate per l'uso remoto; I progettisti si aspettavano che funzionassero localmente.
### Patching fai-da-te delle estensioni Markdown
Se la tua esigenza è urgente, puoi applicare tu stesso le patch alle estensioni.
1. Trova le estensioni in cui sono installate sulla tua workstation in `~/.vscode/extensions` (su Windows sostituisci `%userprofile%` con `~`)
2. Modificare i file `package.json` per le estensioni Markdown che si desidera utilizzare sugli host remoti. Aggiungere il `extensionKind` come attributo di livello radice.
3. Dopo aver modificato tutte le estensioni Markdown, riavviare VS Code.
4. Installare l'estensione sull'host remoto e applicare l'applicazione di patch all'estensione sull'host remoto nello stesso modo.
```json
...
"extensionKind": [
"workspace"
],
...
Patch come questa andranno perse al prossimo aggiornamento di un'estensione, quindi se la patch ha avuto successo potresti voler inviare una richiesta pull all'editore.
Sono stati registrati problemi che richiedono la stampa renderizzata di formati diversi da Markdown. Gli esempi includono gli spartiti del markup musicale ABC e Jupyter Notebooks. Per supportare questa operazione senza assumersi l'onere ingestibile di tenere il passo con ogni formato di documento basato su testo utilizzato con VS Code, abbiamo esposto un'API e pubblicato un SDK che consente ai manutentori di incorporare la stampa nella loro capacità di anteprima.
Di conseguenza, se si desidera eseguire il rendering della stampa per un particolare formato per il quale si dispone già di un'estensione che fornisce l'anteprima, sollevare un problema con l'editore di tale estensione. Spiegate il vostro desiderio di stamparli e fateli riferimento per la stampa e fate riferimento a
- Inizia assicurandoti di poter stampare una pagina web dal tuo browser.
- L'utente con cui viene eseguito VS Code deve essere in grado di stabilire un socket di ascolto.
- Sembra che non succeda nulla: riavviare VS Code.
- Il browser si avvia ma non viene caricato la pagina: controlla le autorizzazioni di rete.
- Il browser visualizza un messaggio di errore relativo all'impossibilità di trovare un file CSS: è stato installato da un VSIX che non è stato preparato da noi. Scarica il pacchetto ufficiale ESC_LINK_OPEN ESC_LINK_SPLIT aHR0cHM6Ly9tYXJrZXRwbGFjZS52aXN1YWxzdHVkaW8uY29tL2l0ZW1zP2l0ZW1OYW1lPXBkY29uc2VjLnZzY29kZS1wcmludA ESC_LINK_CLOSE e riprova.
Se c'è qualcos'altro che non va o hai un'idea di miglioramento, ti invitiamo a segnalare un problema nel repository GitHub.
Il browser utilizzato influenzerà la tua esperienza.
Per ottenere i migliori risultati di stampa, installare un browser basato su Chromium o Firefox. Se non vuoi impostarlo come browser predefinito, sfrutta le impostazioni del browser alternativo. Al momento di questa versione, i problemi con l'instradamento dei comandi causavano il fallback della stampa da aree di lavoro remote all'utilizzo della stampante predefinita. Il servizio completo verrà ripristinato il prima possibile.
Quanto segue è noto per funzionare bene.- Coraggioso
- Cromo
- Cromo
- Bordo
- Collegamento con Firefox
- Edge Classic non è più supportato.
- Internet Explorer non è supportato.
Per utilizzare Stampa con un host remoto, è necessario installarlo sul host remoto.
Per ottenere i vantaggi di un'estensione Markdown durante la stampa di un documento da un host remoto, l'estensione Markdown deve essere compilata con un extensionKind di ESC_CODESPAN_OPEN ESC_CODESPAN_CLOSE dell'area di lavoro e deve essere installato nell'host remoto.
La maggior parte di queste estensioni non è stata creata per ESC_CODESPAN_CLOSE dell'area di lavoro. Possono essere banalmente risolti modificandone ESC_CODESPAN_OPEN package.json. Sfortunatamente è probabile che questa patch manuale vada persa ogni volta che l'estensione viene aggiornata, quindi dovresti sollevare un problema con l'autore delle estensioni che patchi.
Al momento di questa versione, i problemi con l'instradamento dei comandi causavano il fallback della stampa da aree di lavoro remote all'utilizzo della stampante predefinita. Il servizio completo verrà ripristinato il prima possibile.
Non è possibile specificare opzioni della riga di comando nel percorso alternativo del browser. Su Windows, inseriamo automaticamente le virgolette intorno al percorso in caso di spazi nei nomi di file o cartelle. Su altre piattaforme, gli spazi vengono automaticamente preceduti da caratteri di escape.
Sia le virgolette automatiche che l'escape degli spazi sono incompatibili con l'uso delle opzioni della riga di comando. La soluzione consiste nel creare un file batch (o script di shell) che avvii il browser con le opzioni della riga di comando e fornisca il percorso del file batch (o script di shell).
Chrome potrebbe mantenere la stampante, il formato carta e le selezioni dei margini tra un processo di stampa e l'altro. Alcune opzioni della riga di comando di Chrome causano la segnalazione di errori, anche se la stampa ha esito positivo.
Alcuni plug-in di Chrome interferiscono con lo stile dei processi di stampa. Sebbene sia possibile eliminare i plug-in con --disable-plugins questo non funziona quando è già presente un'istanza di Chrome in esecuzione. L'opzione --incognito sopprime i plug-in quando c'è un'istanza in esecuzione, ma ha i suoi problemi.
Se ancora non riesci a far funzionare la stampa, sollevare un problema sul repository. Cercheremo di aiutarti.
Potremmo chiederti di aumentare il livello di registrazione, riprodurre il problema e quindi inviarci il registro.
Impostare il livello di registrazione con l'impostazione Stampa: Livello di registrazione. Per impostazione predefinita, ESC_CODESPAN_CLOSE di errore (registrazione minima), ma è possibile attivarlo fino a ESC_CODESPAN_OPEN di debug molto dettagliato, o anche ESC_CODESPAN_OPEN ESC_CODESPAN_CLOSE sciocco che registrerà persino le chiamate al garbage collector.