README:zh TW

From GeeXboX wiki

Jump to: navigation, search
  ooooo                     oo     o  o               oo     o
 M"   "Mo                    Mo  oM"  M                Mo  oM"
M           oM""Mo  oM""Mo    "Mo"    Mo"""o  oM""Mo    "Mo"
M    """M   MooooMM MooooMM   oMMo    M    "M M    M    oMMo
"o     oM   M    o  M    o   oM  Mo   M    oM M    M   oM  Mo
 "MoooM"M   "MooM"  "MooM"  M"    "M  M"ooo"  "MooM"  M"    "M


Contents

關於

GeeXboX 可以稱為「DivX 盒」軟體，事實上，它是獨立開機光碟以便讓你看電影或聽音樂， 支援很多格式，譬如 avi, mpeg, divx, ogm, rm, mp3, ogg, dvd, vcd, 及 cdda 等， 同時也支援某些常用的搖控器及某些顯示卡上的電視輸出。這份保存庫包含所需的 scripts 用來建立 GeeXboX iso 影像檔。

要求

  1. 要產生 GeeXboX iso 影像檔你將需要下列其中一個環境：
    • 一個 GNU/Linux 系統及 mkisofs 與 mkzftree 工具.
    • 一個 MAC OS X 系統及 mkisofs 與 mkzftree 工具.
    • 一個 M$ Windows 系統.
  2. 要安裝 GeeXboX, 你將只能選擇 :
    • 一個 GNU/Linux system 及 syslinux.
  3. 承上，要建立 GeeXboX, 你將額外需要某些傳統工具：
    1. 一個工作用 GNU/Linux 系統.
    2. gcc C 編譯器.
    3. GNU make
    4. patch 命令.
    5. nasm 組譯器.
    6. bzip2 及 gzip.
    7. mkfs.ext2 及 mkfs.vfat
    8. wget 下載工具(若已具備完整套件則不需要，因為都已下載)
    9. mkisofs 及 mkzftree 用來建立 iso 影像檔.
    10. mkzftree 亦可用來壓縮影像檔中的檔案.
    11. cdrecord 燒錄影像檔.
  4. 還需要額外約 1.2G 的硬碟空間。

客製化(個人化)

當 GeeXboX 已安裝到硬碟或已產生光碟影像檔後，會相當容易客製化。

你可以加入某些適當的 codecs, 像 rv9 或 wmv，只需將之放在 GEEXBOX/codecs 目錄就能輕易達到。你可以在額外 codec中找到。

你也可以透過修改某些文字檔來變更很多選項。

語 言

你可以很容易選擇屬於自己的語言：

  • GNU/Linux 的人:

在執行 generator.sh 前先編輯它，大約在最上面這行 "LANG=en" 改成適當值，譬如 "LANG=zh_TW"。

  • 微軟視窗的人:

這就比較容易，因為執行 generator.exe 的對話框會提示您選擇自己的語言。 

 附註：這跟 DVD 語言無關，關於 DVD 語言請往下看。
  • 想知道有哪些語言可用，請參考 "language" 目錄。
  • 如果你的語言不存在，你可以自行翻譯，請修改 language/menu_語言.conf 及 language/help_語言.txt 及增加"語言"到 language/lang.conf

韌體自動載入器

  • GeeXboX 支援很多免費驅動程式，但是很不幸的是有些需要額外的韌體才能正常運作，而且通常是非免費的，因此未包含進來。韌體是二進位檔，用來在驅動程式載入同時上載到裝置上(如 PCI/USB)。對每個驅動程式而言，其韌體必須是預先定義好名稱的特定檔。
  • 如果你的硬體需求額外的韌體(通常只有 WiFi 及 DVB 卡用得到)，那你將需要到網路上去找 Linux 驅動程式。大部份都會給你一個下載點。有時你需要從微軟視窗驅動程式解出需要的檔以便裝進硬體中(其實它與作業系統或驅動程式無關)。
  • 一旦你取得韌體檔案，只需簡單將之放在 /firmwares 目錄即可，你可以放入任何你想要的韌體檔，而 GeeXboX 會自動找到它們並在趨動程式需要時使用它們。你唯一需要注意的事就是找到「良好」的韌體檔並且重新產生新的 ISO 影像檔。
  • 請注意你也可以用 GeeXboX ISO 產生器替你自動找到韌體檔。你可以選擇所有你要產生器幫你額外增加的二進位韌體檔。當然，小小提醒你，透過產生器找韌體檔必須連網。

多媒體播放器 - MPlayer

  • 這是你可以做大部份設定的地方，選項在 packages/MPlayer/config/mplayer.conf 檔中，也許你要修改像 OSD 字型大小(subfont-text-scale)的選項。
  • 你也可以加大量像 DVD 預設語言的選項，而關於選項最佳來源就是 MPlayer 的手冊，若是 Linux 環境請用 man -l build/MPlayer-*/DOCS/mplayer.1，或者直接看 MPlayer 線上頁。
  • 另一個你可以修改的檔是 packages/i18n-texts/config/menu.conf。對於你不需要的選項你可以直接移除(或註解)，而要的部份你可以翻譯成你的語言。
  • 最後一個你應該看的檔是 packages/MPlayer/build，它包含編譯時期的選項。也就是若想改變，必須重新編譯 MPlayer。

電視輸出

  • 啟動電視輸出功能會得到一些不同電視卡的專用小工具的輔力。目前有 atitvout 給 ATI 卡，s3switch 給 S3 卡，而 nvtv 給 nVidia 卡(支援部份 Intel i810 及 3dfx 卡)。其設定組態在 packages/tvout/config/tvout。
  • 你可以選擇電視標準如 Pal, NTSC 等，以及修改 nvtv 特殊選項。 
   # TV Output Standard (ntsc/pal/secam)
   TVOUT_STANDARD=pal
  • 你也可以定義輸出比例(4:3 或 16:9)，'TVOUT_ASPECT="4:3"'，這個參數可以用在 TVOut 及正常 CRT/TFT 顯示器上。
  • 若你用的是非正常螢幕如寬螢幕或投影機，也可以指定高度/寬度值及水平與垂直頻率。要修改它請編輯 /etc/mplayer/mplayer.conf 檔。預設參數如下(若你要修改頻率，請拿掉註解並修改)： 
   screenw=800
   screenh=600
   #monitor-hfreq=31.5k-50k
   #monitor-vfreq=50-90

搖控器

  • 透過修改 GEEXBOX/etc/remote 你可以選擇支援的遙控器。若你還想要修改搖控器按鍵對應，請瞧瞧 GEEXBOX/etc/lirc/lircrc_REMOTE。

網路

  • 要修改網路組態，設定檔在 GEEXBOX/etc/network。
  • 預設是用 DHCP，若失敗則設為 192.168.0.54，你可以修改成固定 IP。請見該檔的註解。
  • 此外你可以指定網路芳鄰要用的登入名稱與密碼，預設是 anonymous 分享。
  • 你也可以修改 GEEXBOX/etc/nfs 來指定 NFS 掛載點。

無線網路

  • GeeXboX 預設試著自動偵測你的網路設定，若你有傳統網卡及 WiFi 卡，只有後一項需要設定，必須修改 /etc/network 來滿足你的網路設定。
  • 其中有四行跟無線網路有關： 
   * PHY_TYPE="auto"      # Network physical type (auto|ethernet|wifi)
   * WIFI_MODE="managed"  # Wifi working mode (managed|ad-hoc)
   * WIFI_WEP=""          # Wifi WEP key
   * WIFI_ESSID="any"     # Wifi SSID
  • 這四行讓你設定大部份無線網路相關組態，你可以啟用自動偵測或強迫設定 ethernet/WiFi。這也讓你有機會選擇 Managed 或 Ad-Hoc 模式，當然也可以設定 WEP key 及 SSID。

Gateway

  • GeeXboX 支援存取網路，因此你必須取得連線到網路的能力，與你的多媒體盒分享，使用路由器或匣道器。為了這項設定，請簡單的在 /etc/network 檔中定義匣道器 IP 位址。 
   GATEWAY=""     # Gateway IP ("" for DHCP 或無網路)

DNS

  • 假如你要存取網路，GeeXboX 也許需要一個 DNS(網域名稱伺服器)的 IP 位址，若你使用 DHCP 通常會自動設定，若你設定成使用固定網址，那你也得手動提供，檔案在 /etc/network，設定只需要一行如下： 
   DNS_SERVER=""     # DNS IP ("" for DHCP or none)

電視組態

  • GeeXboX 支援電視輸入及 Tuners。系統很難試著自動偵測相關硬體，因此通常得由你強迫設定並跳過嚐試自動偵測。請編輯 /etc/tvcard： 
# TV CARD/TUNER Model (AUTO for 自動偵測或參考下面 urls)
# http://www.linuxhq.com/kernel/v2.6/2/Documentation/video4linux/CARDLIST.bttv
# http://www.linuxhq.com/kernel/v2.6/2/Documentation/video4linux/CARDLIST.tuner
   TV_CARD=AUTO
   TV_TUNER=AUTO
   TVIN_STANDARD=ntsc
  • 若想自動偵測，就保留上述關於 TV_CARD, TV_TUNER 兩項為 AUTO，若想指定確切硬體，請根據上面的網址文件內容指定數字來設定。請特別小心求證你的硬體是否在文件內再設定方能正確使用。
  • 一旦做完設定，你應該可以使用你的電視卡上的電視輸入(Composite 及 S-VHS)。若你使用 Tuner 來看電視，那你還得設定你所屬區域及電視頻道的頻率，請編輯 /etc/tvcard 檔： 
   # TV Channels
   # Syntax : CHAN="Channel Frequency:Channel Title"
   # Example :
   # CHAN="26:France 2"
   # CHAN="K08:Canal +"
   # TV Channels List
   # Available : france, europe-east, europe-west, us-bcast, us-cable
   CHANLIST=france
  • 當你在編輯頻道頻率時請小心，並且使用相同於上面的電視卡的設定語法設定 Tuner 卡。

聲音組態

  • GeeXboX 透過正常 JACK 連結頭及 RCA SPDIF 可以支援類比與數位兩種聲音輸出。預設輸出設定成類比，你也可以修改 /etc/audio 檔來改變： 
   # 使用 SPDIF 輸出(yes/no), no for 類比輸出(預設)
   SPDIF=no
  • 記住若你要連接你的音效卡到外部放大器來解 AC3/DTS 輸出(使用 passthrough 模式)，你將需要設定你的輸出至 SPDIF

影像後置處理

  • 後置處理是一個軟體方式，用來獲得較平滑、正確的影片輸出品質。這會花費大量 CPU 運算時間，但是會獲得較佳的視覺效果。若用 MPlayer 內建的過濾器來後置處理，GeeXboX lets you make h/v deblocking, deringing and auto luminance to enhance your image. 預設後置處理是關掉的以避免遲頓，要打開只需編輯 /etc/mplayer/mplayer.conf 檔： 
   # 設定後置處理 (h deblock, v deblock, dering, auto luminance)
   # 很花 CPU 運算能力, 預設是關閉, 拿掉註解就會啟動內建
   #vf=pp=hb:a/vb:a/dr:a/al:a

電視卡

  • 使用者若有這類的硬體解壓卡，就可以不需要顯示卡或音效卡就可以用 GeeXboX。缺點是，DXR3 電視卡(無 CRT 輸出)只能用 tvout 連接頭。
  • 你也許必須在 /etc/tvout 檔中設定影像種類(PAL/NTSC)，以及在 /etc/audio 檔中設定音效輸出種類(類比或數位)。

收音機組態

  • 假如你的電視卡有內建無線收音機，GeeXboX 可以支援播放無線電。若你想用此項功能你得修改 GEEXBOX/etc/radio 檔打開 "RADIO=yes" 選項。因為無法自動偵測硬體，因此若無此硬體切記不要打開選項，以免多出不必要的選項，而且易造成操作時當機。
  • GEEXBOX/etc/radio 檔也有無線電台定義，檔案中有幾個範例，設定很簡單，格式為「頻率:電台名稱」。值得注意的是選單會出現收音機項目。
  • 因為無線電台應用本身並非 MPlayer 的一部份，因此有另外的音量設定畫面，請注意這邊的音量的加減是主音量，在切回電視或看影片或聽音樂前請重新調整一次。

UPnP 檔案分享

  • UPnP 是 Universal Plug & Play 的縮寫，是一種網路通訊協定，用來提供「在家庭網路中，自動發現裝置與服務」。
  • UPnP A/V(聲音與影像)規範定義幾個 profiles 讓裝置間容易分享多媒體檔案，並讓它們可以播放。
  • The UPnP Media Server profiles represent all of the devices that are able to share files to devices implementing the UPnP Media Player or UPnP Media Renderer profiles.
  • GeeXboX 嵌入一個 UPnP 控制點軟體，用來自動發現你家中網路裡所有 UPnP 媒體伺服器，並且掛載它們的內容在專用掛載點 /mnt/UPnP。
  • 也就是說，你要分享內容只需選一個合適的 UPnP 媒體伺服器，它們就會自動讓 GeeXboX 抓到。
  • UPnP 的進一步資訊與某些媒體伺服器的用法，請至 存取 UPnP 內容。

網路串流

  • Geexbox now gives you the possibility to add some SHOUTcast Radio/TV official playlist as easily as personal playlists (local and remote).
  • SHOUTcast activation is set in "GEEXBOX/etc/network" config file. As SHOUTcast TV sometimes may contain pornographic and subscription-only streams, you can define a "black list" and a "white list" to allow/deny any streams you choose (default keywords for "black list" are : "adult xxx porn ESS SWCTV SWPTV Subscription"). The black/white lists are case-insensitive.
  • "GEEXBOX/etc/netstream" config file can be set to create local and remote playlists (some examples are located in this file). "Remote playlists" refer to "Extended M3U" files.

DVB 卡

  • GeeXboX has a support for various types of DVB cards (Terrestrial, Cable, ATSC and Satellite) either in PCI or USB. Please note that for now, only one DVB adapter is usable at a time.
  • Some DVB devices (especially USB ones) may require an external proprietary firmware to be loaded in the mean time as the driver to be usable. You may have a look at the LinuxTV DVB Wiki to see if you're card requires one or not and if so, which one it is.
  • Some firmwares can be fetched directly from the LinuxTV website, otherwise may be included in the Windows drivers archive. See the GeeXboX firmware loader documentation to see how to get them loaded for you.
  • For each card, the list of channels is available through the MPlayer's open menu. Nevertheless, there's no way to auto-discover these channels.
  • Thus, adding the list of DVB channels to GeeXboX can be done in several ways :
    1. using an existing channel list : MPlayer needs to have a working channels.conf file to use DVB. This file can be generated through the utilities provided by the dvb-apps package. Simply use a Linux box that has a DVB card configured, download the linuxtv-dvb-apps tarball from dvb, compile it and create the config file using the "scan" executable, in "zap" format (which is the default as of dvb-apps 1.1.0). For example, for a DVB-S (Satellite) card using Astra-19.2E as the provider: 
     wget http://www.linuxtv.org/download/dvb/linuxtv-dvb-apps-1.1.0.tar.bz2
     tar jxvf linuxtv-dvb-apps-1.1.0.tar.bz2
     cd linuxtv-dvb-apps-1.1.0/util/scan
     make
     ./scan -x 0 dvb-s/Astra-19.2E > channels.conf
The "-x 0" flag is here to restrict the scan to Free To Air channels only. Please always do so, as MPlayer do not support encrypted DVB channels.
According to your type of DVB card, choose either a file from the "dvb-s", "dvb-c", "dvb-t" or "atsc" directories and ask for a scan.
Then, simply copy the channels.conf file you've just created to the /etc/mplayer directory in the GeeXboX generator tree, and rebuild away.
    1. using an existing transponder list : the procedure is highly similar to the one defined just before but with no scan. This time, the scan will be done at GeeXboX boot but this way, you do no more require another Linux system to generate the channels.conf file. To do so, you simpy have to check at dvb scan。According to your DVB card type (S/T/C/ATSC), check for the good directory and grab the transponder frequency list that fit your needs. Then simply rename the file to dvb.conf and copy it to /etc. Then, rebuild a new ISO using the generator. A bootup, if GeeXboX detects a valid transponder file in /etc/dvb.conf, it will be used to scan for DVB channels and will generate the /etc/mplayer/channels.conf file itself.
    • WARNING : Scanning can be slow according to the number of devices to be scanned and will be done each time you boot GeeXboX if using it as a LiveCD. It is highly recommended that you do it once only, then copy the generated /etc/mplayer/channels.conf file somewhere else and rebuild an ISO using generator, following the first method or to install it on disk.
    1. using installator : this is for sure the easiest solution but requires you to install GeeXboX to disk. During the installation process, if a valid DVB device is recognized by the system, the installator script will ask you if you want to scan for DVB channels.
    • The installator contains the complete list of transponders frequencies. That way, you just have to select your DVB device type and the transponder file you want to use for GeeXboX to scan. The channels.conf file will then be automatically generated.

DVD 瀏覽選單

  • GeeXboX 允許二種 DVD 播放模式：
    1. 直接電影播放(預設)，
    2. DVD 瀏覽選單支援(實驗性質)。
  • 第一種可以安全地受信任來播任何 DVD。一旦有光碟片插入，系統就會自動偵測到，MPlayer 會試著播它認為是電影的部份，這主要的優點是有可能跳過 Copyright, 廣告，以及DVD選單部份而直接播放電影。有些 DVD 有多重選單或多重 title 會無法正確偵測，那就有可能不能正確看電影。
  • 第二種雖然還在實驗中，但是是解決上述問題的機會，會讓你的 GeeXboX 就像真正的 DVD Player 一樣的操作。
  • 你可以透過 GeeXboX 選單來切換播放模式。通常是第一種失效再換即可。當然，也可以透過 ISO generator 來選擇預設的播放方法。

錄影能力

  • GeeXboX 允許你對你正在看的串流錄影，甚至是你使用時光回朔功能(如暫停)。不幸地，這項操作非常耗 CPU 運算時間(尤其是同時播放串流與錄影)，因此也許你得找一台相當新的電腦來做這樣的事。
  • 錄影專用的控制子選單允許你監看錄影狀態(on/off)，檢查錄影後目標檔，也開始/停止錄影程序，並選擇錄影 profile。錄影程序也可以由鍵盤快速鍵 'i' 開始或停止，或由遙控器控制。
  • 很不幸地，錄影能力必須具備幾項要求：
    1. 你需要有空間儲存錄影下來的檔案，這當然可以透過內部或外部硬碟，甚至是 NFS/Samba 分享的空間，唯一需要注意的是它必須能在 linux 下可以寫入(例如 NTFS 就不行)。你可能得知道在錄影時，存放硬碟(或其他空間)會重新掛載成可寫入。
    2. 一旦錄影程序結束，GeeXboX 應該重新掛載硬碟為唯讀模式以確保硬碟安全，只是這項或許不能運作。
    3. 強烈建議你若要好好使用錄影功能，你必須每次都照規矩關機，以免檔案系統鎖住或資料衝突(通常就是指要用 fsck 修復硬碟)。我們並沒有對資料遺失負任何責任。
  • 錄影目標檔路徑必須在安裝時指定。或在 ISO 產生器裡的 /etc/recorder 組態裡指定，例如 SAVE_PATH="/tmp"(預設值)。
  • 預設是存在 /tmp 目錄，但是若用光碟開機，這是 RAMdisk，GeeXboX 夠聰明不會讓你存錄影檔在此目錄，因此請您照上述兩種方式之一指定明確目錄來存放。
  • 以相同方式你可以指定錄影時的預設錄影 profile，在錄影選單裡可以隨時變更，有一些 profiles 範例，而在 /etc/mplayer/mencoder.conf 檔有完整說明，而這些範例通常是因不同錄影品質或速度而不同。你可以一個一個挑來試試，順便測試一下ＣＰＵ所能承載的速度與品質。根據輸入串流(低解析度 WebTV, 正規類比電視, 數位 HDTV ....等)，某一 profile 也許比其也更適合，因此得好好挑選。底下是個非互斥的簡單 profiles 列表
    1. MPEG 1
    2. MPEG 2
    3. Video CD (PAL/NTSC)
    4. Super Video CD (PAL/NTSC)
    5. DVD Video (PAL/NTSC)
    6. Stream Dump (可以安全地用在 DVB MPEG-TS 串流，避免重錄程序).
  • 預設錄影 profile 必須在 /etc/recorder 組態檔裡指定，如： RECORD_PROFILE="mpeg1"
  • 除非你正確地知道你在做什麼，否則極力勸你用 ISO generator 選擇預設的 profile.
  • 在看 TV 串流時，開始錄影程序時 GeeXboX 畫面可能會停頓個幾秒(因為 MEncoder 要開始錄影)，此時你可以回播錄影檔。若你的 CPU 不怎麼高檔，回播肯定是斷斷續續的，此時你只有兩種解法：
    1. 使用一個高檔的 HTPC。
    2. 使用一個較快(通常是指較低的錄影品質)的錄影 profile。
  • 當停止錄影程序時，GeeXboX 將會停止 MEncoder 並且重新載入原來的輸入串流。

產生

  • 首先請見上面客製化一節
  • 基本上你可以在 Linux 下透過叫用 ./generator.sh 或者在 Windows 下叫用 generator.exe 產生 iso 影像檔。

安裝

  • 首先你得產生 FAT16/32 或 Ext2/3 分割區，至少 16M 可用空間。
  • 然後你可以在 Linux 下透過叫用 ./installator.sh 安裝 GeeXboX。
  • 當然，安裝過程要回答所有問題，請仔細看好問題再回答，最好是把問題看兩次再回答，若不懂題意，建議立即停止安裝程序。
  • 但是最容易的方法卻是燒到光碟，用光碟開機，在開機時 "boot:" 提示符號下打 install 即可安裝。

無碟開機(PXE)

  • 是的，GeeXboX 有能力在無碟系統中從網路來開機，當然得具備下列：
    1. DHCP server
    2. TFTP server
    3. NFS server
    4. 具 PXE 能力的工作站
  • 請參考 GeeXboX 無碟開機

建立 GeeXboX

  • 首先請花點時間瞧瞧組態一節(至少是整體設定那段)。
  • 設定好組態之後，建立 iso 的方式基本有二：make 與 make burn。
  • 若完成建立 iso 影像檔或燒錄之後，可以透過 make clean 或 make distclean 來節省硬碟空間，後者甚至會將下載的 source 清掉。
  • 有些進階命你也許會想用：
    1. scripts/get package 下載套件
    2. scripts/unpack package 解壓並準備好套件
    3. scripts/build package 建立套件
    4. scripts/install package 安裝套件到 $INSTALL 目錄
    5. scripts/clean package 清除套件建立樹
    6. scripts/clean --full package 清除套件建立樹與源碼樹
    7. make exec 直接叫用 GeeXboX，此功能還在測試
  • 如果你已產生自己的 GeeXboX, 你可以輕易的建立一個較小的壓縮檔: make dist，或一個含所有源碼的完整 tar 檔: make fulldist，或只產生 GeeXboX 產生器: make generator，或安裝器: make installator 或 PXE: make pxe

組態

  • 整體選項 : 這是你試著建立 GeeXboX 之前第一件要注意的事，位置在 config/options 檔案中，裡頭註解會說明設定。
  • Linux : 這是傳統 Linux 核心組態檔，在 packages/linux/linux.i386.conf。你可以手動編輯它，或者執行 scripts/unpack linux，然後 make menuconfig -C build/linux-*(不一定用 menuconfig, 可以選擇你比較喜歡的方式)，然後將 build/linux-*/.config 複製並取代 packages/linux/linux.conf.
  • Lirc : Lirc 允許你使用遙控器來操作 GeeXboX。首先你必須選擇在 build/lirc-*/remotes 目錄中相對應於你的硬體的適當的描述檔到 packages/lirc/install 目錄中，該檔若不存在，可以執行 scripts/unpack lirc。然後你應該選擇裝置，預設是 /dev/ttyS0(COM1)，以及選擇 lirc 驅動程式並將它們放在 packages/lirc/config/lircd_$REMOTE 中。
  • 接下來你可以選擇你的按鍵對應，在檔案 packages/lirc/config/lircrc_$REMOTE. 對每個對應而言，你必須選擇一個按鍵，並將之關聯到一個動作上，所謂動作是 MPlayer 動作之一，請見 build/MPlayer-*/DOCS/documentation.html#commands.

破解系統

  • 第一件事你應該瞧瞧那些初始程序 scripts。事實上有兩個這樣的檔，一個在 packages/initrd/scripts/linuxrc，不過這個檔你最好別動。
  • 第二個是在 config/options 這邊剛好讓你做客製化工作。首先你得選擇你要建立 GeeXboX 的硬體架構(i386或PPC)，之後你可以透過精選 CPU 種類來最佳化(如 386, pentium, athlon)。
  • 接下來也許你會對產生新"套件"有興趣。要產生一個新套件你只需遵循某些制式化規則來產生一套 scripts 就完成了。所有這些 scripts 必須放在 packages 目錄下相對的套件目錄內，請參考現在套件。
  • 底下是你必須產生的 scripts 列表：
    1. url : 取得源碼的 url, 你可以設定成較靠近(通常是指較快)你的站台
    2. unpack : 解開取得的源碼的方法。這並不包括補丁。
    3. need_build : 當套件解開而在建立好之前呼叫，用來確定套件相依性。若你想重建，記得將 ./stamps/套件/build 移除。
    4. build : 所有用來建立程式的步驟。
    5. install : 用來安裝程式的所有步驟。安裝前置路徑是 $INSTALL。
  • 此外，套件主目錄也許還包括一些子目錄("packages/套件"下)：
    1. config : 放套件的組態檔，也許用在建立程序的編譯時期，或是安裝時放到 /etc 目錄。
    2. scripts : 放一些執行時初始化的 scripts，這通常由安裝 script 放到適當位置。
    3. patches : 這個目錄放一些解壓後建立前的補丁工作。
    4. sources : 檔案放在這兒會被自動複製到套件源碼中。這動作通常在「取得」、「解壓」之後作，在 unpack script 中。意思就是，若您沒給源碼 url，程式完全由您寫的，可以放這邊，但是不可以壓縮。
    5. init.d : 包含系統開機時初始化 scripts, 通常放 /etc/rc?.d 或 /etc/init.d
  • 你也必須記得軟體在 GeeXboX 上執行得經由 uClibc gcc 編譯過。很幸運的，GeeXboX 工具集夠聰明幫您自動建立符合這要求的程序。
  • Do not forget to ask for your package's compilation and installation by explicitely asking for it in the scripts/gentree build script.
  • 最後，製作套件最佳之道是看別的套件怎麼做。

版權

  • 所有被 GeeXboX 引用到的程式由他們各自的版權聲明所保護，他們全都是免費軟體，而且大部份也是在 GNU GPL 保護之下。
  • 而 GeeXboX 本身，也就是用來建立 GeeXboX 程序的那些 scripts, 則全部屬 Gnu GPL 版權保護。
Retrieved from "http://www.geexbox.org/wiki/index.php/README:zh_TW"
Personal tools