Tutorial sobre Skinning

[ Índice do Elemento ] - [ Manifesto ] - [ Compatibilidade da Direita pra Esquerda ] - [ Skinning Remoto ] - [ Distribuindo Skins ]

Criando Skins para o Shareaza

Criar skins para o Shareaza é fácil. Você pode fazer skins tão simples ou complexas quanto você quiser. Estas páginas fornecem um tutorial simples e uma detalhada referência para a capacidade de skinning do Shareaza.  Com este tutorial você será capaz de fazer:

  • Skins visuais - Muda o tema visual e ou personaliza os botões/layout do programa.
  • Idiomas das skins - Traduz o texto num idioma diferente.

Sendo Iniciado

Este tutoria vai em partes. Uma ótima maneira de aprender é ir através de elemento-por-elemento e construir sua própria skin!

  • As skins são armazenados na pasta: C:\Arquivos de Programas\Shareaza\Skins
  • Cada skin tem sua própria pasta, tal como C:\Arquivos de Programas\Shareaza\Skins\MySkin
  • Cada pasta contém o arquivo da skin principal e os arquivos de suporte, tais como imagens ou ícones.

Cada skin tem um arquivo de definição de skin, o qual está no formato XML. XML é um formato de texto fácil de ler ao contrário do HTML, mas para um uso de propósito mais geral. É recomendado, mas não requerido, que um editor de texto com realce de sintaxe XML seja usado. Exemplos são Notepad++ ou EmEditor. O arquivo de definição da skin diz ao Shareaza sobre a skin - coisas como quem a criou, quais partes da interface mudar e como mudá-las.

Aqui está uma skin muito simples, chamada MySimpleSkin.xml:

<?xml version="1.0" encoding="UTF-8"?>
<skin xmlns="http://www.shareaza.com/schemas/Skin.xsd" version="1.0">
<manifest name="My Simple Skin" author="Me" type="Skin"/>
<watermarks>
<watermark target="CCoolMenuBar" path="MyWatermark.bmp"/>
</watermarks>
</skin>

Esta skin especifica o nome e autor, e acrescenta uma imagem de marca d'água para a barra do menu principal. Fácil! Skins são assim mesmo: você pode mudar tanto ou tão pouco como você quiser.

Nota : As primeiras duas linhas desse exemplo devem sempre ser usadas sem modificação. As tags xmlns e versão são importantes e não devem ser editadas de modo algum. Esta é a versão do core da skinning, não a versão da sua skin.

O Elemento Manifesto

O exemplo acima incluiu um <manifest> elemento, o qual especificou o nome da skin.  É importante incluir algumas boas meta-informações sobre a sua skin para que outros possam identificá-la e procurar por ela. Aqui está uma referência completa para o elemento <manifest>:

<manifest
name="O nome da skin"
author="A pessoa ou organização que a criou"
updatedBy="A pessou que a atualizou"
description="Uma descrição mais longa da skin, se desejado"
link="http://uma.url.para.a.skin.com/se/aplicavel/"
email="um@exemplo.de.endereco.de.email.com"
version="1.5"
type="Skin"
dir="ltr"
/>

Todos os atributos exceto o nome são opcionais:

  • name - O nome da skin.
  • author - A pessoa que criou a skin.
  • updatedBy - A pessoa que atualizou/melhorou a skin.
  • description - Uma descrição mais longa do tema.
  • link - Uma URL da web opcional para mais informações.
  • email - Um endereço de email opcional para contactar para mais informações.
  • version - O número de revisão da skin.
  • type - A maioria dos skins deve definir isto como "skin". As exceções são skins de tradução do idioma, as quais definiriam isto como "language".
  • language - Só incluir se o tipo está definido como "idioma" acima. Ele especifica o código do idioma o qual a tradução fornece, por exemplo "en".
  • dir - A maioria das skins podem omitir isso. Os valores podem ser: "ltr" para idiomas da esquerda pra direita e "rtl" para idiomas da direita pra esquerda.

Guia Visual

O guia visual é uma coleção de fotos e outros visuais demonstrando quais partes da skin padrão que correspondem a quais IDs.

Default.xml e Definitions.xml mostra uma lista de ícones padrão do Shareaza e seus IDs correspondentes para ajudar a descobrir como modificar um certo ícone. A documentação em commandImages deve ser consultada para a sintaxe exata para substituir ícones.

Elementos da Skin

Esta seção lista todos os elementos diferentes que você pode incluir em um arquivo de skin, com links para descrições mais detalhadas.

Elemento Descrição Usado Para
<colourScheme> Especifica o esquema de cor da interface de usuário usado durante o programa. Skinning
<watermarks> Adiciona imagens de marca d'água a partes da interface. Skinning
<windowSkins> Muda drasticamente a aparência das janelas. Skinning
<commandImages> Muda as imagens exibidas nas barras de ferramentas, menus e janelas. Skinning
<menus> Define os menus no programa. Skinning
<toolbars> Define as barras de ferramentas no programa. Skinning
<fonts> Muda as fontes usadas na interface. Skinning
<documents> Fornece o RichDoc exibido na aba Home. Skinning
<tipMap> mapa da controlTip. Tradução
<controlTips> Muda o texto exibido nas dicas de ferramentas para vários diálogos. Tradução
<dialogs> Muda o texto exibido nos diálogos. Tradução
<commandTips> Muda o texto exibido nas dicas de ferramentas e das mensagens de ajuda dos comandos. Tradução
<strings> Muda o texto usado em todas as outras mensagens. Tradução
<listColumns> Muda o texto exibido na lista das visualizações. Tradução

Adicionando Compatibilidade RTL (da direita pra esquerda)

Para que as pessoas em todo o mundo possam apreciar sua skin você deve ter certeza de que é Compatível com RTL (da direita para a esquerda). Isto é para os idiomas que começam na direita e se lêem para a esquerda como Hebraico e Árabe.

Skinning Remoto do Shareaza

Uma vez que você aprendeu os elementos do Skinning do Shareaza, dê ao skinning remoto uma tentativa!


Distribuindo Suas Skins

Uma vez que você criou ums skin legal, não há muito ponto em mantê-la apenas pra si mesmo, certo? Distribuir skins do shareaza é fácil, mas há algumas dicas as quais são de valor mencionar.

  • Tenha certeza de que a skin está preparada para o horário nobre.
    Teste se funciona sem quaisquer resultados estranhos.  Se possível teste num computador diferente.

  • Tenha certeza de que tudo está tão bacana & e pequeno quanto possível.
    Se você criou arquivos de imagens, converta-os para 8-bit, bitmaps de 256 cores.

  • Verifique seu elemento manifesto.
    Isto deve fornecer um nome exato para a skin, o tipo de skin e qualquer outra informação que você acha que é relevante.

O melhor modo de empacotar e distribuir uma skin do Shareaza é ZIPAR todos os arquivos e tomar vantagem do instalador automático de skins que vem com o Shareaza.

Para fazer isto:
  • ZIP a pasta da skin.
  • Renomeie seu arquivo .ZIP para um arquivo .SKS.

Os arquivos da skin do Shareaza (.sks) são automaticamente descompactados e instalados no local correto quando eles são abertos pelos usuários finais.

Shareaza skin library - Finally, be sure to submit your skin here, and share it on Shareaza! Sharing skins on Shareaza is very important, as it will allow everyone to download them faster. After all, that's what we're about!

Conseguindo Ajuda

Need help with skinning? Want to talk to others about it, or make an announcement about your new skin? If so, visit the: Skinning Forum


  • en
  • es
  • fr
  • de
  • hr
  • it
  • lt
  • nl
  • nb
  • pl
  • pt
  • sl
  • tr
  • el
  • he
  • ja
  • zh-tw
  • en
  • ca
  • fa
  • ru
Muitas pessoas contribuem com o tempo delas e esforço para o Shareaza. Por favor veja nossa página de reconhecimento.
Visit Shareaza's Project Page at SourceForge.net
< Topo da Página | Contacte-nos >