glance

Tipos de arquivo suportados

• Código -fonte (com destaque da sintaxe de Chroma): .cpp , .js , .json , .py , .swift , .yml e muito mais

  

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

  

• Arquivo : .tar , .tar.gz , .zip

  

• Notebook Jupyter (renderizado usando NBTOHTML): .ipynb

  

• Valores separados por guia (analisado usando SwiftCSV): .tab , .tsv

  

Perguntas frequentes

Existem aplicativos de aparência rápida para alguns dos tipos de arquivos suportados. Por que criar outro?

• Glance combina os recursos de muitos plugins em um e fornece visualizações consistentes e bonitas.
• O olhar é totalmente compatível com o modo escuro.
• Alguns plugins ainda usam a API de gerador de aparência rápida depreciada e podem parar de funcionar no futuro.
• O olhar pode ser facilmente estendido para suportar outros tipos de arquivo.

Por que o olhar exige permissões de rede?

O Glance renderiza algumas visualizações em um WKWebView . Todos os ativos são armazenados localmente e o acesso à rede está desativado, mas, infelizmente, as visualizações da Web ainda precisam do com.apple.security.network.client Direito da função.

Por que o aplicativo não está disponível no MacOS 10.14 ou mais?

O aplicativo usa a nova API Quick Look que foi introduzida em 10.15, por isso infelizmente não funcionará com versões mais antigas do macOS.

Por que as imagens nos meus arquivos de marcação não estão carregando?

Olha bloqueia ativos remotos. Além disso, o aplicativo só tem acesso ao arquivo que está sendo visualizado. Os arquivos de imagem local referenciados do Markdown não são, portanto, carregados.

Por que o [tipo de arquivo] não é suportado?

Sinta -se à vontade para abrir um problema ou contribuir! Ao abrir um problema, descreva que tipo de visualização você esperaria para o seu arquivo.

Observe que o MacOS não permite o manuseio de alguns tipos de arquivos (por exemplo .plist , .ts e .xml ).

Você afirma suportar [tipo de arquivo], mas as visualizações não estão aparecendo.

Observe que Glance ignora visualizações para arquivos grandes para evitar desacelerar o seu Mac.

É possível que a extensão ou a ITU do seu arquivo não esteja associado ao olhar. Você pode verificar facilmente o seguinte:

1. Verifique se a extensão do arquivo é correspondida com a classe correta no PreviewVCFactory.swift .
2. Encontre o UTI do seu arquivo executando mdls -name kMDItemContentType /path/to/your/file . Verifique se a UTI está listada no QLSupportedContentTypes em Info.plist .
3. Se estiver faltando uma associação, sinta -se à vontade para adicioná -lo e enviar um PR.

Contribuindo

Sugestões e contribuições são sempre bem -vindas! Discuta alterações maiores (por exemplo, adicionando suporte para um novo tipo de arquivo) por meio de um problema antes de enviar uma solicitação de tração.

Xcode, Swift e vá precisar ser instalados para criar o aplicativo localmente.

Para adicionar visualizações para uma nova extensão de arquivo, siga estas etapas:

1. Crie uma nova classe para o seu tipo de arquivo neste diretório. Ele deve implementar o protocolo Preview . Veja os outros arquivos no diretório para obter exemplos.
2. Combine a extensão do arquivo à sua classe no PreviewVCFactory.swift .
3. Encontre o UTI do seu arquivo executando mdls -name kMDItemContentType /path/to/your/file . Adicione -o ao QLSupportedContentTypes em Info.plist .
4. Atualize README.md , SupportedFilesWC.xib , A App Store Descrição e Credits.rtf (se você introduziu uma nova biblioteca).