-
Notifications
You must be signed in to change notification settings - Fork 29
Español
- Uso general
- Personalización de la configuración
-
Markdown
- Subelemento
- Impresión de otros formatos renderizados
- Solución de problemas
Hay un par de formas de imprimir.
- Puede imprimir el documento activo, mediante el icono o el menú contextual.
- Puede imprimir una selección del documento activo, mediante el icono o el menú contextual.
- Puede imprimir uno o más archivos directamente desde el panel del explorador de archivos, mediante el menú contextual en una carpeta, archivo o selección múltiple de archivos.
- Los archivos se pueden titular con su ruta de archivo. El título no aparece en el documento, pero algunos navegadores pueden utilizarlo en los encabezados.
- Puede elegir entre los siguientes formatos.
- Sin camino
- Abreviado (como
D:\...\containing-folder\file.ext) - Relativo al espacio de trabajo
- Puede elegir entre los siguientes formatos.
- Los archivos pueden tener su ruta de archivo como un encabezado al principio del documento.
- Una configuración determina si se deben utilizar rutas de archivo relativas o absolutas.
- Los archivos que no son de espacio de trabajo siempre usan absolute.
- Las rutas absolutas se convierten en rutas de tilde cuando están dentro del directorio principal del usuario.
- Un ajuste determina si aparece un encabezado de ruta de archivo al principio de los archivos impresos individualmente.
- Las listas de exclusión se aplican tanto a las selecciones de carpetas como a las de archivos. El propósito de estos es ignorar los archivos binarios no imprimibles.
Los documentos Markdown se pueden representar y diseñar con estilo. Esto se detalla en la sección Markdown.
Para imprimir el documento activo, simplemente haga clic en el icono de la impresora a la derecha de las pestañas del documento. Asegúrate de no tener varias líneas de texto seleccionadas. De lo contrario, imprimirá la selección, no todo el documento. El control del tamaño del papel, los márgenes y la orientación de la página se encuentra en el cuadro de diálogo de impresión.
Seleccione un bloque de texto de varias líneas en el documento activo. A continuación, haga clic en el icono de la impresora situado a la derecha de las pestañas del documento o haga clic con el botón derecho del ratón en la selección y elija ESC_CODESPAN_CLOSE Imprimir en el menú contextual. Cuando aparece el menú contextual, ESC_CODESPAN_OPEN Imprimir aparece en la parte superior, inferior o en ninguna parte (o cerca de) la parte superior, inferior o en ninguna parte, según la configuración Imprimir: Posición del elemento del menú contextual del editor .
Los números de línea de la impresión se alinean con los números de línea del editor, tanto si son visibles como si no. Por lo tanto, si está discutiendo una línea de código numerada 1145 en una revisión de código y abre el archivo para modificarlo, escribir Ctrl+G y luego 1145 [Enter] colocará el cursor directamente en la línea de código en cuestión.
Para imprimir un archivo que no sea el documento activo, búsquelo en el panel EXPLORADOR y haga clic con el botón derecho del ratón sobre él. En el menú contextual del archivo, Imprimir siempre aparece en la parte superior del menú o cerca de él. Esto imprime todo el archivo.
Si presiona ESC_CODESPAN_CLOSE F1 y escribe ESC_CODESPAN_OPEN carpeta de impresión encontrará que puede imprimir todos los archivos imprimibles en la carpeta que contiene el documento activo. Se crea un único trabajo de impresión con todos los archivos separados por encabezados que muestran sus nombres.
La mayoría de estos ajustes personalizan la experiencia del usuario (icono, ubicación del menú, etc.). Para encontrar esta configuración, abra el panel de configuración de VS Code y vaya a Extensiones/Impresión o simplemente busque "impresión".
A continuación se muestra una lista de los nombres de configuración disponibles tal y como aparecen en el archivo de configuración.
-
print.alternateBrowser: habilitar/deshabilitar un navegador alternativo -
print.browserPath: la ruta a un navegador web -
print.colourScheme: la hoja de estilo utilizada para colorear la sintaxis -
print.editorContextMenuItemPosition: la posición de ESC_CODESPAN_OPEN ESC_CODESPAN_CLOSE de impresión en el menú contextual del editor -
print.editorTitleMenuButton: muestra el botón de impresión en el menú de título del editor -
print.fontSize: el tamaño de la fuente (opciones de 6 a 13 pt) -
print.formatMarkdown: renderizar Markdown como HTML con estilo al imprimir -
print.lineNumbers: activar, desactivar o heredar (del editor) -
print.lineSpacing: simple, línea y media o doble espaciado -
print.printAndClose: después de imprimir, cierre el navegador -
print.folder.include: patrón para los archivos que se van a incluir. El vacío coincide con todo. -
print.folder.exclude: patrones a excluir -
print.folder.maxFiles: el número máximo de archivos para los que se procesa el contenido al imprimir una carpeta -
print.folder.maxLines: se ignorarán los archivos que contengan más líneas que este umbral -
print.logLevel: controla el nivel de detalle que entra en el archivo de registro -
print.filepathAsDocumentHeading: controla el uso de la ruta del archivo como encabezado al principio de un documento -
print.filepathAsDocumentTitle: controla el uso de la ruta del archivo como título del documento (utilizado por algunos navegadores en el encabezado de la página) -
print.filepathHeadingForIndividuallyPrintedDocuments: controla si el encabezado de la ruta del archivo aparece al principio de los documentos impresos individualmente
Puede controlar si el icono de impresión aparece en la barra de herramientas al enfocar un panel del editor. Esta configuración se denomina botón del menú Título del editor.
Puede controlar si el elemento de menú "Imprimir" aparece en la parte superior, inferior o en ninguna parte de los menús contextuales utilizando la configuración de ESC_CODESPAN_CLOSE Posición del elemento del menú contextual del editor ESC_CODESPAN_OPEN.
Cuando se marca la opción Imprimir y cerrar, al imprimir algo se abrirá automáticamente el cuadro de diálogo Imprimir del navegador y, a continuación, se cerrará automáticamente el navegador después de imprimir o cancelar. Al desactivar esta opción, se abrirá el navegador con el documento renderizado listo para su inspección. Si, a continuación, abre manualmente el cuadro de diálogo Imprimir, imprimirlo o cancelarlo no cerrará el navegador.
En el momento de esta versión, los problemas con el enrutamiento de comandos provocaban que la impresión desde espacios de trabajo remotos volviera a utilizar la impresora predeterminada. El servicio completo se restablecerá lo antes posible.
De forma predeterminada, la impresión utilizará su navegador predeterminado. Sin embargo, la impresión funciona mejor con un navegador derivado de Chromium y es posible que no sea posible o deseable cambiar su navegador predeterminado.
Para permitirle imprimir con un navegador que no sea su navegador predeterminado, puede especificar una ruta a un navegador alternativo, y también hay una casilla de verificación que le permite activarla y desactivarla sin perder la ruta.
Estos ajustes se etiquetan ESC_CODESPAN_CLOSE de ruta del navegador y ESC_CODESPAN_OPEN de navegador alternativo, respectivamente.
La ruta al navegador alternativo se entrecoja automáticamente en Windows, y en las plataformas basadas en Unix los espacios se escapan. Desafortunadamente, esto es incompatible con el suministro de opciones de línea de comandos.
Si necesita proporcionar opciones de línea de comandos, cree un archivo por lotes (o un archivo de script bash) que especifique las opciones y consulte el archivo de script bash en la ruta de acceso alternativa del navegador.
Con la configuración ESC_CODESPAN_CLOSE Esquema de color ESC_CODESPAN_OPEN, puede especificar el esquema de color utilizado para el coloreado de la sintaxis. Las opciones se limitan a temas claros porque las impresoras utilizan papel blanco.
Si imprime el documento activo y hay una selección de varias líneas, solo se imprime la selección.
El tipo de letra viene determinado por la configuración del editor de VS Code. Si ves el Código Fira en la pantalla, eso es lo que se imprimirá.
El ESC_EM_CLOSE de tamaño ESC_EM_OPEN del texto impreso es un ajuste de impresión, ya que es posible que el tamaño que mejor funcione en pantalla no sea el que mejor funciona en papel.
Si te preguntas por qué lo llamamos tipo de letra y no fuente, es porque una fuente es un tipo de letra particular en un tamaño y tratamiento específicos. "12pt Times italic" es una fuente. "Times" es un tipo de letra. No ayuda que el Selector de fuentes de Windows (que ESC_EM_OPEN ESC_EM_CLOSE elige una fuente, sino que debe especificar el tipo de letra, el tamaño y el tratamiento) etiquete erróneamente el tipo de letra como "Fuente".
Es probable que desee que los trabajos de impresión de Markdown se representen y se les dé estilo, y este es el comportamiento predeterminado. Si desea imprimir Markdown como código fuente, puede desmarcar la configuración Imprimir: Renderizar Markdown .
Para la impresión de código fuente, las hojas de estilo están agrupadas y se pueden elegir por nombre de una lista. Las opciones se limitan a hojas de estilo ligeras porque el papel de la impresora es blanco y las tintas y tóneres de la impresora están diseñados para el papel blanco.
- Puede incrustar una etiqueta de enlace de hoja de estilo directamente en Markdown. Esto es específico del documento.
- Hay una configuración llamada
markdown.styles. Esta es una lista de URLs. Tanto la vista previa de Markdown incorporada como la impresión respetarán esta lista. Puede usar direcciones URL absolutas, direcciones URL relativas al área de trabajo o direcciones URL relativas al documento, como se muestra en el ejemplo siguiente.
"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"
]Las direcciones URL relativas al espacio de trabajo son la mejor manera de compartir recursos entre documentos. Están en el espacio de trabajo para que se puedan controlar en código fuente junto con los documentos, y debido a que la URL es relativa al espacio de trabajo en lugar del documento, puede organizar (y reorganizar) los documentos en carpetas sin romper las URL. Tenga en cuenta que esto se aplica no solo a las hojas de estilo, sino también a los recursos de archivos de imagen.
La asignación de Markdown a HTML generado es obvia. Las tablas se convierten en ESC_CODESPAN_CLOSE de tabla, ESC_CODESPAN_OPEN éstas y td elementos. Los encabezados están H1 a H9. Los párrafos se P elementos, las viñetas y los números son ul y ol elementos.
No olvides que puedes incrustar HTML en Markdown, por lo que no hay nada que te impida usar div o span para aplicar una clase CSS a un bloque o ejecución de Markdown.
El servidor web integrado solo se enlaza a la dirección de bucle invertido y solo acepta conexiones que especifican.
Katex depende de CSS y fuentes de la web. Para que la impresión funcione, debe agregar la hoja de estilo requerida a su configuración. Si encuentra que una o dos cosas funcionan en la vista previa pero no están impresas, determine la versión actual del sitio web de KaTeX y actualice la URL.
"markdown.styles": [
"https://cdn.jsdelivr.net/npm/[email protected]/dist/katex.min.css"
]Si desea cortar el cable, importe los recursos de Katex en el proyecto como se describe en la sección anterior y utilice una referencia relativa al espacio de trabajo.
A continuación, se muestran algunos ejemplos que le ayudarán a comprobar la configuración.``` $$ \begin{alignedat}{2} 10&x+ &3&y = 2 \ 3&x+&13&y = 4 \end{alignedat} $$ and thus
## Markdown renderizado y espacios de trabajo remotos
Para trabajar con áreas de trabajo remotas, una extensión de Markdown debe ejecutarse en el host remoto, ya que ahí es donde se ejecuta la canalización de representación de Markdown. Las extensiones como Print, diseñadas para su uso con espacios de trabajo remotos, se pueden implementar en el host remoto con un solo clic. La mayoría de las extensiones de Markdown son capaces de funcionar así, pero no están configuradas para ello.
Desafortunadamente, las extensiones de Markdown normalmente no están configuradas para uso remoto; Los diseñadores esperaban que funcionaran localmente.
### Parches de bricolaje de extensiones Markdown
Si su necesidad es urgente, puede parchear las extensiones usted mismo.
1. Busque las extensiones donde están instaladas en su estación de trabajo en `ESC_CODESPAN_CLOSE ~/.vscode/extensions (en Windows, sustituya ESC_CODESPAN_OPEN %userprofile%` por `~`)
2. Edite los archivos `package.json` de las extensiones Markdown que desea utilizar en hosts remotos. Agregue el `extensionKind` como atributo de nivel raíz.
3. Cuando haya editado todas las extensiones de Markdown, reinicie VS Code.
4. Instale la extensión en el host remoto y aplique un parche a la extensión en el host remoto de la misma manera.
```json
...
"extensionKind": [
"workspace"
],
...
Los parches de este tipo se perderán en la próxima actualización de una extensión, por lo que si el parche se ha realizado correctamente, es posible que desee enviar una solicitud de incorporación de cambios al editor.
Se han registrado problemas al solicitar la impresión renderizada de formatos distintos de Markdown. Algunos ejemplos son las partituras del marcado de música ABC y Jupyter Notebooks. Para admitir esto sin asumir la carga inmanejable de mantenerse al día con cada formato de documento basado en texto que se usa con VS Code, hemos expuesto una API y publicado un SDK que permite a los mantenedores incorporar la impresión en su capacidad de vista previa.
Como resultado, si desea que se imprima para un formato determinado para el que ya tiene una extensión que proporciona una vista previa, plantee un problema al editor de esa extensión. Explique su deseo de imprimir y refiéralos para que se impriman y refiéralos a
- Comience por asegurarse de que puede imprimir una página web desde su navegador.
- El usuario con el que se ejecuta VS Code debe ser capaz de establecer un socket de escucha.
- Parece que no pasa nada: reinicie VS Code.
- El navegador se inicia pero no se carga la página: compruebe los permisos de red.
- El navegador muestra un mensaje de error que indica que no se encuentra un archivo CSS: lo instaló desde un VSIX que no fue preparado por nosotros. Obtenga el paquete oficial de ESC_LINK_OPEN ESC_LINK_SPLIT aHR0cHM6Ly9tYXJrZXRwbGFjZS52aXN1YWxzdHVkaW8uY29tL2l0ZW1zP2l0ZW1OYW1lPXBkY29uc2VjLnZzY29kZS1wcmludA ESC_LINK_CLOSE e inténtelo de nuevo.
Si algo más está mal, o tienes una idea de mejora, te invitamos a registrar un problema en el repositorio de GitHub.
El navegador utilizado afectará a su experiencia.
Para obtener los mejores resultados de impresión, instale un navegador basado en Chromium o Firefox. Si no desea que este sea su navegador predeterminado, aproveche la configuración del navegador alternativo. En el momento de esta versión, los problemas con el enrutamiento de comandos provocaban que la impresión desde espacios de trabajo remotos volviera a utilizar la impresora predeterminada. El servicio completo se restablecerá lo antes posible.
Se sabe que los siguientes funcionan bien.- Valiente
- Cromo
- Cromo
- Borde
- Firefox (en inglés)
- Edge Classic ya no es compatible.
- Internet Explorer no es compatible.
Para usar Imprimir con un host remoto, debe instalarlo en el de host remoto.
Para obtener el beneficio de una extensión Markdown al imprimir un documento desde un host remoto, la extensión Markdown debe compilarse con un ESC_CODESPAN_CLOSE extensionKind de ESC_CODESPAN_OPEN de espacio de trabajo y debe instalarse en el host remoto.
La mayoría de estas extensiones no están diseñadas para espacio de trabajo. Se pueden arreglar trivialmente modificando su package.json. Desafortunadamente, es probable que este parche manual se pierda cada vez que se actualice la extensión, por lo que debe plantear un problema al autor de las extensiones que parchea.
En el momento de esta versión, los problemas con el enrutamiento de comandos provocaban que la impresión desde espacios de trabajo remotos volviera a utilizar la impresora predeterminada. El servicio completo se restablecerá lo antes posible.
No se pueden proporcionar opciones de línea de comandos en la ruta de acceso del explorador alternativo. En Windows, colocamos automáticamente comillas alrededor de su ruta en caso de espacios en los nombres de archivos o carpetas. En otras plataformas, los espacios se escapan automáticamente.
Tanto las comillas automáticas como el escape de espacios son incompatibles con el uso de las opciones de la línea de comandos. La solución es crear un archivo por lotes (o script de shell) que inicie el navegador con opciones de línea de comandos y proporcione la ruta de acceso al archivo por lotes (o script de shell).
Es posible que Chrome conserve la impresora, el tamaño del papel y las selecciones de márgenes entre trabajos de impresión. Algunas opciones de la línea de comandos de Chrome hacen que se notifiquen errores, aunque la impresión se realice correctamente.
Algunos complementos de Chrome interfieren con el estilo de los trabajos de impresión. Si bien es posible suprimir complementos con --disable-plugins esto no funciona cuando ya hay una instancia en ejecución de Chrome. El modificador --incognito suprime los complementos cuando hay una instancia en ejecución, pero tiene sus propios problemas.
Si aún ESC_EM_OPEN ESC_EM_CLOSE no puede hacer que Print funcione, plantear un problema en el repositorio. Intentaremos ayudarte.
Es posible que le pidamos que aumente su nivel de registro, reproduzca el problema y luego nos envíe el registro.
Establezca el nivel de registro con la configuración Imprimir: Nivel de registro. Esto de forma predeterminada es ESC_CODESPAN_CLOSE de error (registro mínimo), pero puede aumentarlo hasta ESC_CODESPAN_OPEN de depuración que es muy detallado, o incluso ESC_CODESPAN_OPEN ESC_CODESPAN_CLOSE tonto que incluso registrará las llamadas al recolector de elementos no utilizados.