glance

Tipos de archivos compatibles

• Código fuente (con resaltado de sintaxis de Chroma): .cpp , .js , .json , .py , .swift , .yml y muchos más

  

• Markdown (renderizado usando Goldmark): .md , .markdown , .mdown , .mkdn , .mkd , .Rmd

  

• Archivo : .tar , .tar.gz , .zip

  

• Notebook Jupyter (renderizado usando NBTOHTML): .ipynb

  

• Valores separados por pestañas (analizados usando swiftcsv): .tab , .tsv

  

Preguntas frecuentes

Existen aplicaciones de aspecto rápido existentes para algunos de los tipos de archivos compatibles. ¿Por qué crear otro?

• Glance combina las características de muchos complementos en uno y proporciona vistas previas consistentes y hermosas.
• La mirada es completamente compatible con el modo oscuro.
• Algunos complementos aún usan la desactivada API del generador de aspecto rápido y podrían dejar de funcionar en el futuro.
• La mirada se puede extender fácilmente para admitir otros tipos de archivos.

¿Por qué la mirada requiere permisos de red?

Glance representa algunas vistas previas en una WKWebView . Todos los activos se almacenan localmente y el acceso a la red está deshabilitado, pero las vistas web desafortunadamente aún necesitan el com.apple.security.network.client derecho a la función.

¿Por qué la aplicación no está disponible en MacOS 10.14 o más?

La aplicación utiliza la nueva API de aspecto rápido que se introdujo en 10.15, por lo que desafortunadamente no funcionará con versiones más antiguas de MacOS.

¿Por qué las imágenes en mis archivos de Markdown no se cargan?

Glance bloquea los activos remotos. Además, la aplicación solo tiene acceso al archivo que se está previendo. Por lo tanto, los archivos de imagen locales a los que se hace referencia desde Markdown no se cargan.

¿Por qué no es compatible con [tipo de archivo]?

¡No dude en abrir un problema o contribuir! Al abrir un problema, describa qué tipo de vista previa esperaría para su archivo.

Tenga en cuenta que MacOS no permite el manejo de algunos tipos de archivos (por ejemplo, .plist , .ts y .xml ).

Usted afirma admitir [tipo de archivo], pero las vistas previas no están apareciendo.

Tenga en cuenta que Glance omite las vistas previas para archivos grandes para evitar ralentizar su Mac.

Es posible que la extensión o la infección urinaria de su archivo no sean asociadas con la mirada. Puede verificar fácilmente esto:

1. Compruebe si la extensión del archivo coincide con la clase correcta en PreviewVCFactory.swift .
2. Encuentre la UTI de su archivo ejecutando mdls -name kMDItemContentType /path/to/your/file . Compruebe si la UTI se enumera en QLSupportedContentTypes en Info.plist .
3. Si falta una asociación, no dude en agregarla y enviar un PR.

Que contribuye

¡Las sugerencias y las contribuciones son siempre bienvenidas! Discuta los cambios más grandes (por ejemplo, agregando soporte para un nuevo tipo de archivo) a través del problema antes de enviar una solicitud de extracción.

Xcode, Swift y Go deben instalarse para construir la aplicación localmente.

Para agregar vistas previas para una nueva extensión de archivo, siga estos pasos:

1. Cree una nueva clase para su tipo de archivo en este directorio. Debería implementar el protocolo Preview . Vea los otros archivos en el directorio para ver ejemplos.
2. Haga coincidir la extensión del archivo con su clase en PreviewVCFactory.swift .
3. Encuentre la UTI de su archivo ejecutando mdls -name kMDItemContentType /path/to/your/file . Agrégalo a QLSupportedContentTypes en Info.plist .
4. Actualizar README.md , SupportedFilesWC.xib , la descripción de la tienda de aplicaciones y Credits.rtf (si introdujo una nueva biblioteca).