-
Notifications
You must be signed in to change notification settings - Fork 27
Català
- Ús general
- Personalització de la configuració
-
Markdown
- Subítem
- Impressió d'altres formats renderitzats
- Solució de problemes
Hi ha un parell de maneres d'imprimir.
- Podeu imprimir el document actiu, per icona o menú contextual.
- Podeu imprimir una selecció des del document actiu, per icona o menú contextual.
- Podeu imprimir un o més fils directament des del plafó de l'explorador de fitxers, mitjançant el menú contextual d'una carpeta, fitxer o selecció múltiple de fitxers.
- Els fitxers es poden titular amb el seu camí de fitxer. El títol no apareix al document, però alguns navegadors poden utilitzar-lo a les capçaleres.
- Podeu triar entre els formats següents.
- Sense camí
- Abreujat (com
D:\...\containing-folder\file.ext) - Espai de treball relatiu
- Podeu triar entre els formats següents.
- Els fitxers poden fer que la seva ruta de fitxer aparegui com una capçalera a l'inici del document.
- Un paràmetre determina si s'han d'utilitzar camins de fitxer relatius o absoluts.
- Els fitxers que no són d'espai de treball sempre utilitzen absolut.
- Els camins absoluts es converteixen en camins de tilde quan es troben dins del directori d'inici de l'usuari.
- Un paràmetre determina si una capçalera del camí d'accés del fitxer apareix al començament dels fitxers impresos individualment.
- Les llistes d'exclusió s'apliquen tant a les seleccions de carpetes com de fitxers. El propòsit d'aquests és ignorar els fitxers binaris imprimibles.
Els documents Markdown es poden representar i estilitzar. Això es detalla a la secció Markdown.
Per imprimir el document actiu només cal que feu clic a la icona de la impressora a la dreta de les pestanyes del document. Assegureu-vos que no hàgiu seleccionat diverses línies de text. En cas contrari, imprimireu la selecció, no tot el document. Control de la mida del paper, els marges i l'orientació de la pàgina es troba en el diàleg d'impressió.
Seleccioneu un bloc de text de diverses línies al document actiu. A continuació, feu clic a la icona de la impressora a la dreta de les pestanyes del document o feu clic amb el botó dret a la selecció i trieu Imprimeix al menú contextual. Quan aparegui el menú contextual, ESC_CODESPAN_CLOSE d'impressió apareix a (o gairebé) a la part superior, inferior o enlloc en funció de la configuració ESC_CODESPAN_OPEN Imprimeix: Editor Posició de l'element del menú contextual .
Els números de línia de la impressió estan alineats amb els números de línia de l'editor, tant si són visibles com si no. Per tant, si esteu discutint una línia de codi numerada 1145 en una revisió de codi i obriu el fitxer per modificar-lo, escrivint Ctrl+G i, a continuació, 1145 [Intro] posarà el cursor directament a la línia de codi en qüestió.
Per imprimir un fitxer que no sigui el document actiu, cerqueu-lo a la subfinestra EXPLORER i feu-hi clic amb el botó dret. Al menú contextual del fitxer Imprimeix sempre apareix a la part superior del menú o a prop. Això imprimeix tot el fitxer.
Si premeu F1 i escriviu carpeta d'impressió trobareu que podeu imprimir tots els fitxers imprimibles a la carpeta que conté el document actiu. Es crea un únic treball d'impressió amb tots els fitxers separats per encapçalaments que mostren els seus noms.
La majoria d'aquests paràmetres personalitzen l'experiència de l'usuari (icona, ubicació del menú, etc.). Per trobar aquests paràmetres, obriu el panell de configuració del VS Code i navegueu a Extensions / Impressió o simplement cerqueu "impressió".
Aquí teniu una llista dels noms de configuració disponibles tal com apareixen al fitxer de configuració.
-
print.alternateBrowser: habilitar/desactivar un navegador alternatiu -
print.browserPath: el camí cap a un navegador web -
print.colourScheme: el full d'estil utilitzat per acolorir la sintaxi -
print.editorContextMenuItemPosition: la posició de ESC_CODESPAN_OPEN ESC_CODESPAN_CLOSE d'impressió al menú contextual de l'editor -
print.editorTitleMenuButton: mostra el botó d'impressió al menú del títol de l'editor -
print.fontSize: la mida de la lletra (opcions de 6 a 13 pt) -
print.formatMarkdown: renderitzeu Markdown com a HTML d'estil quan imprimiu -
print.lineNumbers: encès, desactivat o heretat (de l'editor) -
print.lineEspaiat: a un espaiat simple, lineal i mig o doble -
print.printAndClose: després d'imprimir, tanqueu el navegador -
print.folder.include: patró per incloure fitxers. El buit ho coincideix tot. -
print.folder.exclude: patrons per excloure -
print.folder.maxFiles: el nombre màxim de fitxers per als quals es representa el contingut en imprimir una carpeta -
print.folder.maxLines: s'ignoraran els fitxers que continguin més línies que aquest llindar -
print.logLevel: controla el nivell de detall que entra al fitxer de registre -
print.filepathAsDocumentHeading: controla l'ús de la ruta del fitxer com a encapçalament a l'inici d'un document -
print.filepathAsDocumentTitle: controla l'ús de la ruta del fitxer com a títol del document (utilitzat per alguns navegadors a la capçalera de la pàgina) -
print.filepathHeadingForIndividuallyPrintedDocuments: controla si la capçalera del camí d'accés del fitxer apareix a l'inici dels documents impresos individualment
Podeu controlar si la icona d'impressió apareix a la barra d'eines quan enfoqueu un tauler d'editor. Aquest paràmetre s'etiqueta Botó del menú Títol de l'editor.
Podeu controlar si l'element de menú "Imprimeix" apareix a la part superior, inferior o enlloc dels menús contextuals mitjançant la configuració ESC_CODESPAN_CLOSE de la posició de l'element del menú contextual de l'editor de l'ESC_CODESPAN_OPEN.
Quan l'opció Imprimeix i tanca està marcada, imprimir alguna cosa obrirà automàticament el diàleg Imprimeix del navegador i, a continuació, tancarà automàticament el navegador després d'imprimir o cancel·lar. Si desactiveu aquesta opció, s'obrirà el navegador amb el document renderitzat llest per a la inspecció. Si a continuació, obriu manualment el diàleg Imprimeix, imprimir-lo o cancel·lar-lo no tancarà el navegador.
En el moment d'aquest llançament, els problemes amb l'encaminament d'ordres feien que la impressió des d'espais de treball remots tornés a utilitzar la impressora predeterminada. El servei complet es restablirà el més aviat possible.
De manera predeterminada, la impressió utilitzarà el navegador predeterminat. Tanmateix, la impressió funciona millor amb un navegador derivat de Chromium i és possible que no sigui possible o desitjable canviar el navegador predeterminat.
Per permetre-us imprimir amb un navegador que no sigui el vostre navegador predeterminat, podeu especificar un camí a un navegador alternatiu i també hi ha una casella de selecció que us permet activar-lo i desactivar-lo sense perdre el camí.
Aquestes opcions de configuració s'etiqueten ESC_CODESPAN_CLOSE del camí del navegador i ESC_CODESPAN_OPEN del navegador alternatiu, respectivament.
El camí cap al navegador alternatiu es cita automàticament a Windows, i a les plataformes basades en Unix els espais s'escapen. Malauradament, això és incompatible amb el subministrament d'opcions de línia d'ordres.
Si necessiteu proporcionar opcions de línia d'ordres, creeu un fitxer per lots (o un fitxer de script bash) que especifiqui les opcions i consulteu el fitxer de script bash al camí alternatiu del navegador.
Amb l'opció ESC_CODESPAN_CLOSE "Esquema de colors ESC_CODESPAN_OPEN" podeu especificar l'esquema de colors utilitzat per a la coloració de la sintaxi. Les opcions es limiten a temes lleugers perquè les impressores utilitzen paper blanc.
Si imprimiu el document actiu i hi ha una selecció de diverses línies, només s'imprimeix la selecció.
La tipografia està determinada per la configuració de l'editor VS Code. Si veus el Codi Fira a la pantalla, això és el que s'imprimirà.
La mida ESC_EM_OPEN ESC_EM_CLOSE del text imprès és una configuració d'impressió perquè la mida que funciona millor a la pantalla pot no ser la mida que funciona millor en paper.
Si t'estàs preguntant per què l'anomenem tipografia i no tipus de lletra, és perquè un tipus de lletra és una tipografia particular en una mida i tractament específics. "12pt Times cursiva" és un tipus de lletra. "Times" és una tipografia. No ajuda que el selector de tipus de lletra de Windows (que ESC_EM_OPEN ESC_EM_CLOSE triar un tipus de lletra, heu d'especificar la tipografia, la mida i el tractament) etiqueti malament la tipografia com a "Tipus de lletra".
És probable que vulgueu representar i estilitzar els treballs d'impressió de Markdown, i aquest és el comportament predeterminat. Si voleu imprimir Markdown com a codi font, podeu desmarcar la configuració Imprimeix: Renderitza Markdown .
Per a la impressió de codi font, els fulls d'estil s'inclouen i es poden triar pel nom d'una llista. Les opcions es limiten als fulls d'estil lleugers perquè el paper de la impressora és blanc i les tintes i tòners de la impressora estan dissenyats per al paper blanc.
- Podeu incrustar una etiqueta d'enllaç del full d'estil directament al fitxer Markdown. Això és específic del document.
- Hi ha una configuració anomenada
markdown.styles. Aquesta és una llista d'URL. Tant la vista prèvia integrada de Markdown com la impressió respectaran aquesta llista. Podeu utilitzar URL absoluts, URL relatius a l'espai de treball o URL relatius a documents, com es mostra a l'exemple següent.
"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"
]Els URL relatius a l'espai de treball són la millor manera de compartir recursos entre documents. Es troben a l'espai de treball perquè es puguin controlar les fonts juntament amb els documents, i com que l'URL és relatiu a l'espai de treball en lloc del document, podeu organitzar (i reorganitzar) els documents en carpetes sense trencar els URL. Tingueu en compte que això s'aplica no només als fulls d'estil, sinó també als recursos de fitxers d'imatge.
L'assignació de Markdown a HTML generat és òbvia. Les taules esdevenen ESC_CODESPAN_CLOSE de la taula, ESC_CODESPAN_OPEN i td elements. Els encapçalaments són H1 a H9. Els paràgrafs són P elements, les vinyetes i els nombres són ul i ol elements.
No oblideu que podeu incrustar HTML a Markdown, de manera que no hi ha res que us impedeixi utilitzar div o abastar aplicar una classe CSS a un bloc o execució de Markdown.
El servidor web incrustat només s'uneix a l'adreça de bucle i només accepta connexions que especifiquen.
Katex depèn de CSS i fonts de la web. Perquè la impressió funcioni, heu d'afegir el full d'estil necessari a la configuració. Si trobeu que una o dues coses funcionen a la vista prèvia encara no impreses, determineu la versió actual del lloc web de KaTeX i actualitzeu l'URL.
"markdown.styles": [
"https://cdn.jsdelivr.net/npm/[email protected]/dist/katex.min.css"
]Si voleu tallar el cable, importeu els recursos Katex al vostre projecte tal com es descriu a la secció anterior i utilitzeu una referència relativa a l'espai de treball.
Aquí teniu alguns exemples que us ajudaran a comprovar la vostra configuració.``` $$ \begin{alignedat}{2} 10&x+ &3&y = 2 \ 3&x+&13&y = 4 \end{alignedat} $$ and thus
## Renderitzat Markdown i espais de treball remots
Per treballar amb espais de treball remots, s'ha d'executar una extensió Markdown a l'amfitrió remot, perquè és on s'executa la canonada de representació Markdown. Extensions com Print dissenyades per utilitzar-les amb espais de treball remots es poden desplegar a l'amfitrió remot amb un sol clic. La majoria de les extensions Markdown poden funcionar així, però no estan configurades per a això.
Malauradament, les extensions Markdown normalment no es configuren per a ús remot; Els dissenyadors esperaven que funcionessin localment.
### Pegat de bricolatge d'extensions Markdown
Si la vostra necessitat és urgent, podeu apedaçar les extensions vosaltres mateixos.
1. Cerqueu les extensions on estan instal·lades a la vostra estació de treball a `ESC_CODESPAN_CLOSE ~/.vscode/extensions (a Windows substitueix ESC_CODESPAN_OPEN %userprofile%` per a `~`)
2. Editeu els fitxers `package.json` de les extensions Markdown que vulgueu utilitzar en amfitrions remots. Afegiu l'extensió `Kind` com a atribut de nivell arrel.
3. Quan hàgiu editat totes les extensions de Markdown, reinicieu VS Code.
4. Instal·leu l'extensió a l'amfitrió remot i apedaçeu l'extensió a l'amfitrió remot de la mateixa manera.
```json
...
"extensionKind": [
"workspace"
],
...
Pegats com aquest es perdran a la propera actualització d'una extensió, de manera que si el vostre pegat ha tingut èxit, és possible que vulgueu enviar un PR a l'editor.
S'han registrat problemes sol·licitant la impressió renderitzada de formats diferents de Markdown. Alguns exemples inclouen partitures del marcatge de música ABC i Jupyter Notebooks. Per donar suport a això sense assumir la càrrega inmanejable de mantenir-se al dia amb cada format de document basat en text utilitzat amb VS Code, hem exposat una API i publicat un SDK que permet als mantenidors incorporar la impressió a la seva capacitat de vista prèvia.
Com a resultat, si voleu imprimir renderitzats per a un format concret per al qual ja teniu una extensió que proporcioni una visualització prèvia, plantegeu un problema amb l'editor d'aquesta extensió. Expliqueu el vostre desig d'imprimir-los i remeteu-los per imprimir-los i referir-los a
- Comenceu per assegurar-vos que podeu imprimir una pàgina web des del navegador.
- L'usuari com s'executa VS Code ha de ser capaç d'establir un sòcol d'escolta.
- Sembla que no passa res: reinicieu el codi VS.
- S'inicia el navegador, però no es carrega la pàgina: comproveu els permisos de xarxa.
- El navegador mostra un missatge d'error sobre no trobar un fitxer CSS: heu instal·lat des d'un VSIX que no hem preparat nosaltres. Obteniu el paquet oficial ESC_LINK_OPEN ESC_LINK_SPLIT aHR0cHM6Ly9tYXJrZXRwbGFjZS52aXN1YWxzdHVkaW8uY29tL2l0ZW1zP2l0ZW1OYW1lPXBkY29uc2VjLnZzY29kZS1wcmludA ESC_LINK_CLOSE i torneu-ho a provar.
Si alguna cosa més no va bé, o teniu una idea de millora, us convidem a registrar un problema al repositori de GitHub.
El navegador utilitzat afectarà la vostra experiència.
Per obtenir els millors resultats d'impressió, instal·leu un navegador basat en Chromium o Firefox. Si no voleu que aquest sigui el vostre navegador predeterminat, aprofiteu la configuració del navegador alternatiu. En el moment d'aquest llançament, els problemes amb l'encaminament d'ordres feien que la impressió des d'espais de treball remots tornés a utilitzar la impressora predeterminada. El servei complet es restablirà el més aviat possible.
Se sap que els següents funcionen bé.- Valent
- Crom
- Cromar
- Vora
- Firefox
- Edge Classic ja no és compatible.
- Internet Explorer no és compatible.
Per utilitzar Print amb un host remot, heu d'instal·lar-lo al de l'amfitrió remot.
Per obtenir el benefici d'una extensió Markdown en imprimir un document des d'un host remot, l'extensió Markdown s'ha de construir amb una extensió ESC_CODESPAN_CLOSE d'ESC_CODESPAN_OPEN espai de treball i s'ha d'instal·lar a l'amfitrió remot.
La majoria d'aquestes extensions no estan dissenyades per a espai de treball. Es poden arreglar trivialment modificant el seu package.json. Malauradament, és probable que aquest pedaç manual es perdi cada vegada que s'actualitza l'extensió, de manera que hauríeu de plantejar un problema amb l'autor de les extensions que pedaçeu.
En el moment d'aquest llançament, els problemes amb l'encaminament d'ordres feien que la impressió des d'espais de treball remots tornés a utilitzar la impressora predeterminada. El servei complet es restablirà el més aviat possible.
No podeu proporcionar opcions de línia d'ordres al camí alternatiu del navegador. Al Windows, col·loquem cometes automàticament al camí d'accés en cas d'espais als noms dels fitxers o carpetes. En altres plataformes, els espais s'escapen automàticament.
Tant la cotització automàtica com l'escapament d'espais són incompatibles amb l'ús d'opcions de línia d'ordres. La solució és crear un fitxer per lots (o script de l'intèrpret d'ordres) que iniciï el navegador amb opcions de línia d'ordres i subministri la ruta al fitxer per lots (o script de l'intèrpret d'ordres).
És possible que Chrome conservi les seleccions d'impressora, mida de paper i marge entre treballs d'impressió. Algunes opcions de la línia d'ordres de Chrome fan que s'informi d'errors, encara que la impressió tingui èxit.
Alguns connectors de Chrome interfereixen amb l'estil de la impressió. Tot i que és possible suprimir connectors amb --disable-plugins això no funciona quan ja hi ha una instància de Chrome en execució. El commutador --incògnit suprimeix connectors quan hi ha una instància en execució, però té els seus propis problemes.
Si encara ESC_EM_OPEN ESC_EM_CLOSE no podeu aconseguir que Print funcioni, plantegeu un problema al repositori. Intentarem ajudar-te.
És possible que us demanem que augmenteu el vostre nivell de registre, reproduïu el problema i després ens envieu el registre.
Definiu el nivell de registre amb la configuració ESC_CODESPAN_CLOSE Print: Log Level . Per defecte, ESC_CODESPAN_OPEN d'error (registre mínim), però podeu convertir-lo fins a ESC_CODESPAN_CLOSE de depuració molt detallada, o fins i tot ESC_CODESPAN_OPEN ximple que fins i tot registrarà trucades al recol·lector d'escombraries.