Pacotes

Um pacote nada mais é que uma pasta que contém arquivos de configuração ou scripts que, por sua vez, servem para personalizar e estender as funcionalidades do Sublime Text. A finalidade de um pacote é apenas organizar o conjunto de arquivos necessários para implementar uma funcionalidade.

De que é feito um pacote?

Cada tipo de arquivo que pode estar contido em um pacote é responsável por definir um aspecto da funcionalidade. Alguns desses tipos de arquivo são:

  • Configurações (.sublime-settings)

  • Temas (.sublime-theme)

  • Plugins (.py)

  • Snippets (.sublime-snippet)

  • Macros (.sublime-macro)

  • Menus (.sublime-menu)

  • Mapeamentos de teclas (.sublime-keymap)

  • Definições de sintaxe (.tmLanguage)

  • Preferências de sintaxe (.tmPreferences)

  • Configurações de build (.sublime-build)

Um pacote pode conter um ou mais tipos de arquivos acima, a depender do que for necessário para implementar os novos recursos personalizados. Para entender melhor, vale a pena dar uma olhada nos arquivos dos diversos pacotes disponíveis no Package Control (ver capítulo Package Control).

Localização

Os pacotes ficam guardados na pasta <pasta_de_dados_do_sublime>/Packages. Para saber qual é pasta correspondente na sua instalação, selecione o menu Preferences | Browse packages. Dentro desta pasta os arquivos de cada pacote estão agrupados em seu subdiretório correspondente.

A depender do seu sistema operacional essa pasta será algo como:

  • Windows: %APPDATA%\Sublime Text 3

  • OS X: ~/Library/Application Support/Sublime Text 3

  • Linux: ~/.config/sublime-text-3

Distribuição

Para facilitar a distribuição, os arquivos que formam um pacote também podem ser armazenados em um único arquivo do tipo .sublime-package. Arquivos desse tipo nada mais são que um arquivo compactado no formato zip, contendo a estrutura de pastas do pacote.

Para os pacotes zipados, ou seja, do tipo .sublime-package, a localização dos pacotes muda. Nesse caso, eles ficam na pasta <pasta_de_dados_do_sublime>/Installed Packages.

Pacotes especiais

Default

Contém os pacotes padrão que acompanham a instalação do Sublime Text. Este pacote fica localizado em <pasta_de_instalação_do_sublime>/Packages.

User

Normalmente, arquivos avulsos são armazenados nesse pacote, que é uma pasta localizada em <pasta_de_dados_do_sublime>/Packages. Se você tem pequenas macros ou snippets soltos, este pode ser o lugar ideal para colocá-los.

O que torna esses pacotes especiais é a ordem em que cada um deles é processado pelo Sublime Text. O pacote Default é sempre lido primeiro, enquanto que User é sempre lido por último.

Na prática, isso significa que o Sublime sempre leva em consideração, por exemplo, um arquivo de configuração que esteja em Default, a menos que haja outro com o mesmo nome em outro pacote. Por sua vez, se este arquivo estiver em User suas configurações sempre prevalecem sobre todas as demais.

Instalando um pacote

No dia-a-dia, são poucas as situações nas quais você precisará instalar um pacote manualmente. A maioria dos pacotes de terceiros pode ser instalada por meio do Package Control (ver capítulo Package Control).

No entanto, pode ser necessário instalar um pacote que não foi publicado no Package Control ou mesmo um que tenha sido criado localmente pelo próprio usuário.

Existem duas maneiras de instalar um pacote:

  • Criando/copiando uma nova pasta dentro de <pasta_de_dados_do_sublime>/Packages e colocando nele os arquivos, scripts e demais recursos que fazem parte do pacote.

  • Copiando um arquivo .sublime-package na pasta <pasta_de_dados_do_sublime>/Installed Packages.