[ Element Index ] - [ Manifest ] - [ 由右至左顯示相容性 ] - [ Remote Skinning ] - [ 散怖外觀 ]

製作 Shareaza 的外觀

製作 Shareaza 是很簡單的. 您能夠製作簡易外觀, 也可以弄得十分地複雜. 這些頁面記載了一個簡單的教學與Shareaza 外觀製作功能的詳細參考資料.  利用這個教學, 您能夠做出:

• Visual skins - Changes visual theme and or customizes buttons/layout of program.
• Language skins - 將文字翻譯為另一種語言.

This tutorial goes in parts. A great way to learn is to go through element-by-element and build your own skin!

• Skins are stored in the C:\Program Files\Shareaza\Skins folder.
• Each skin has its own folder, such as C:\Program Files\Shareaza\Skins\MySkin.
• Each folder contains the main skin file and support files, such as images or icons.

Every skin has a skin definition file, which is in XML format. XML is an easy to read text format not unlike HTML, but for more general purpose use. It is recommended, but not required, that a text editor with XML syntax highlighting be used. Examples are Notepad++ or EmEditor. The skin definition file tells Shareaza about the skin -- things like who created it, which parts of the interface to change, and how to change them.

這裡是一個很簡單的外觀檔, 稱為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>

This skin specifies its name and author, and adds a watermark image to the main menu bar.  Easy! Skins are just like this: you can change as much or as little as you want.

Note: The first two lines of this example should always be used without modification. The xmlns and version tags are important, and should not be edited at all. This is the version of the skinning core, not the version of your skin.

上方的範例包括了一個<manifest> 元件, 用於指定外觀的名稱. 重要的是, 請輸入一些好的解釋資料, 這樣子別人可以辨識與搜尋它.  這邊是一個完整的<manifest> 元件的參考資料:

<manifest name="外觀名稱" author="製作它的個人或是組織" updatedBy="更新它的人" description="A longer description of the skin, if desired" link="http://a.url.for.the.skin.com/if/applicable/" email="an@email.address.example.com" version="1.5" type="Skin" dir="ltr" />

All of the attributes except for name are optional:

• name - 外觀的名稱
• author - 製作這個外觀的作者
• updatedBy - 改進/更新這個外觀的人.
• description - 這個外觀的更詳細敘述.
• link - 一個非必要的網際網路 URL, 讓其他人參觀得知更多資訊.
• email - 一個非必要的電子郵件地址, 用於聯繫以取得更多資訊.
• version - The revision number of the skin.
• type - Most skins should set this to "skin". The exception is language translation skins, which would set this to "language".
• language - Only include if the type is set to "language" above. It specifies the language code which the translation provides, for example "en".
• dir - Most skins can omit this. The values can be: "ltr" for left-to-right languages and "rtl" for right-to-left languages.

The visual guide is a collection of screenshots and other visuals demonstrating what parts of the default skin correspond to which IDs.

Default.xml and Definitions.xml show a list of Shareaza's default icons and their corresponding IDs to help in figuring out how to modify a certain icon. The documentation on commandImages should be consulted for the exact syntax for replacing icons.

This section lists all of the different elements you can include in a skin file, with links to more detailed descriptions.

元件	敘述	使用於
<colourScheme>	Specifies the user interface colour scheme used throughout the program.	外觀
<watermarks>	Adds watermark images to parts of the interface.	外觀
<windowSkins>	徹底改變視窗的外觀.	外觀
<commandImages>	改變 工具列, 選單與視窗之中的圖片顯示.	外觀
<menus>	定意程式中的選單.	外觀
<toolbars>	定義程式中的工具列.	外觀
<fonts>	改變介面的字體	外觀
<documents>	Provides the RichDoc displayed on the Home tab.	外觀
<tipMap>	controlTip map.	翻譯
<controlTips>	Changes the text displayed in tooltips for various dialogs.	翻譯
<dialogs>	改變在對話框中顯示的文字.	翻譯
<commandTips>	Changes the text displayed in tooltips and command help messages.	翻譯
<strings>	Changes the text used in all other messages.	翻譯
<listColumns>	Changes the text displayed in list views.	翻譯

So that people all around the world can enjoy your skin you should make sure it is RTL (Right-to-Left) compatible. This is for languages that start on the right and read to the left like Hebrew and Arabic.

Once you've learned the elements of Shareaza skinning, give skinning the remote a try!

在您製作了一個很酷的外觀後, 只保留給自己使用似乎沒有任何道理, 不是嗎? 散怖 Shareaza 外觀很簡單, 不過請注意以下的提示:

• Make sure the skin is ready for prime-time.
  請測試您的外觀, 確定不會產生任何奇怪的結果.  如果可行的話, 在不同的電腦上測試.
  
  
• 請確認每一個項目都盡可能地簡潔與細小.
  如果您已經製作了圖片檔, 轉換它們至 8 位元, 256 色 的點陣圖.
  
  
• 檢查您的 manifest 元件.
  This should provide an accurate name for the skin, the type of skin, and any other information you think is relevant.

The best way to package and distribute a Shareaza skin is to ZIP up all the files, and take advantage of the automatic skin installer that comes with Shareaza.

步驟:

• 將外觀資料夾做成壓縮檔.
• 重新命名您的.ZIP 檔 至 a .SKS 檔.

Shareaza skin (.sks) files are automatically unzipped and installed into the correct location when they are opened by end-users.

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!

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