Pomocník programu PE Builder (v3)      Slovak  (Translated by Marián Hikaník)
Tabuľka s obsahom

Formát súboru s prídavným modulom


  1. Privítanie
  2. Vytvorenie pluginu
  3. Sekcia PEBuilder
  4. Sekcia WinntDirectories
  5. Sekcia SourceDisksFiles
  6. Sekcia SourceDisksFolders
  7. Sekcia Software.AddReg
  8. Sekcia Software.DelReg
  9. Sekcia SetupReg.AddReg
  10. Sekcia Default.AddReg
  11. Sekcia Default.DelReg
  12. Sekcia AddLine
  13. Sekcia DelLine
  14. Sekcia SetValue
  15. Sekcia Append
  16. Premenné

Privítanie

Tento návod Vám má pomôcť pri vytváraní alebo modifikovaní pluginov pre program PE Builder. Hlavným .inf súborom programu PE Builder je súbor pebuilder.inf. Prosíme Vás, neupravujte tento súbor! Ak chcete niečo zmeniť, použite na to radšej nový súbor s pluginom. Všetky pluginy sú umiestnené v priečinku plugin. Každý súbor .inf v priečinku plugin (a nielen v tomto priečinku), ktorý obsahuje sekciu "pebuilder" je považovaný za platný prídavný modul programu PE Builder. Ak chcete prídavný modul vypnúť/zapnúť, použite na to tlačidlo Zapnúť/Vypnúť.

Vytvorenie pluginu

Súbor s pluginom vo formáte .inf musí byť ASCII súborom, nesmie používať kódovanie Unicode. Riadky začínajúce ";" (bodkočiarkou) sú ignorované (používajú sa na zapísanie komentára).

Každý súbor s pluginom by sa mal začínať takto:

; PE Builder v3 plug-in INF file
; Created by Bart Lagerweij
; http://www.nu2.nu/pebuilder/
;
; Krátka poznámka o funkcii prídavného modulu...

[Version]
Signature= "$Windows NT$"

[PEBuilder]
Name="NázovPluginu"
Enable=0
Help="pluginhelp.htm"
Prosím nezabudnite nato, že musíte vložiť aj časť [Version] Signature= "$Windows NT$". Inak by funkcia programu PE Builder nemohla otvoriť súbor .inf. Pre pridanie ďalších sekcií do súboru s pluginom, čítajte ďalej...

Sekcia PEBuilder

Ak vytvárate prídavný modul, jeho .inf súbor musí obsahovať sekciu [PEBuilder]!
NameNázov prídavného modulu
Enablestav prídavného modulu (zapnutý/vypnutý)
0 - Vypnutý
1 - Zapnutý
HelpNázov súboru, ktorý obsahuje pomocníka k prídavnému modulu. Tu môže byť textový súbor, html-, doc-, pdf-, alebo akýkoľvek iný typ súboru. PE Builder používa funkciu ShellExecute(), ktorá otvorí dokument v predvolenom programe.
ConfigNázov konfiguračného súboru.

Sekcia WinntDirectories (priečinky Winnt)

Sekcia WinntDirectories musí byť zapísaná podľa vzoru:
directoryID=dirname[, attribute]

pričom platí, že...
directoryIDje identifikačným číslom priečinka (označované aj ako ID)
V súbore .inf sa dajú použiť premenné 'a'-'z' pre dynamické prideľovanie čísla...
dirnameje názvom priečinka. Ak názov obsahuje medzery, dajte ho do "úvodzoviek".
attributenumerická hodnota udávajúca zapnutie/vypnutie funkcie
Hodnota:
1 = Vždy vytvoriť tento priečinok (aj keď bude prázdny)
2 = Z výstupných súborov vytvoriť priečinok mimo hlavného priečinka (teda nie v priečinku \i386)
Hodnoty je možné medzi sebou vzájomne kombinovať...
Ak nezadáte žiadnu hodnotu, predvolená hodnota bude 0.

Príklad:
[WinntDirectories]
; Vždy vytvoriť podpriečinok v hlavnom priečinku s názvom "Bart"
a="Bart",3
; Vytvoriť podpriečinok v hlavnom priečinku s názvom "Project\Bart\Source"
b="Project\Bart\Source",3
; Vytvoriť podpriečinok s názvom "extra\files" v priečinku i386
c="extra\files",1

Tu je zoznam (najčastejšie používaných) ID čísel priečinkov:
IDPriečinokPoznámka
30000[root]Hlavný výstupný priečinok programu PE Builder
1\SystemRoot (na CD je to napr. priečinok \i386 folder, na disku to býva priečinok \minint)
2system32
3system32\config
4system32\drivers
5system
17system32\drivers\etc
20inf
21Help
22Fonts
24msagent\intl
52msagent
124WinSxS
125WinSxS\Manifests
252WinSxS\Policies

Program PE Builder používa identifikačné čísla priečinkov, začínajúce od čísla 30000. Ak je ident. číslo 30000 už používané pre hlavný výstupný priečinok, čísla 30001 a vyššie sú dynamicky prideľované programom PE Builder.

Sekcia SourceDisksFiles (súbory zdrojového disku)

SourceDisksFiles[.build]
Táto sekcia sa používa na kopírovanie súborov. Ak pridáte za názov sekcie číslo verzie, táto sekcia sa použije iba v prípade, ak má zdrojové médium rovnaké číslo verzie.

BuildVerzia
2600Windows XP
3790Server 2003


Sekcia SourceDisksFiles musí byť zapísaná podľa vzoru:
filename=directoryID[, filenameRenamed][, attribute]

pričom platí, že...
filenameje názvom toho súboru, ktorý je určený na skopírovanie.
directoryIDje číslom cieľového priečinka. Pozrite si aj Sekciu WinntDirectories, ak potrebujete získať zoznam ident. čísel štandardných priečinkov systému Windows.
filenameRenamedje novým názvom súboru, ktorý sa použije ak bude potrebné súbor premenovať.
attributeje numerická hodnota zapnutia/vypnutia niektorých funkcií
Hodnota:
1 = sa používa pre kontrolu pluginu. Konkrétne ju využíva funkcia pluginCheck(). Pred zadaním tejto hodnoty sa presvedčite, že zadaný súbor naozaj existuje a je umiestnený v rovnakom priečinku ako .inf súbor.
2 = nedekomprimovať súbor.
4 = len skopírovať súbor, ak existuje. Neupozorňovať, ak súbor neexistuje.
Ak nezadáte žiadnu inú hodnotu, použije sa predvolená hodnota 0.

Sekcia SourceDisksFolders (priečinky zdrojového disku)

SourceDisksFolders[.build]

Táto sekcia sa používa na kopírovanie celých priečinkov a súborov. Sekcia SourceDisksFolders musí byť zapísaná podľa vzoru:
sourcepath=directoryID

pričom platí, že...
sourcepathje zdrojovou cestou/priečinkom, z ktorého sa bude kopírovať. Toto je presná kópia priečinka, nič nie je dekomprimované alebo extrahované!
directoryIDje číslom cieľového priečinka. Pozrite si aj sekciu WinntDirectories, ak potrebujete zoznam ident. čísel štandardných priečinkov systému Windows.

Príklad:
[WinntDirectories]
a="Programs\openoffice",2

[SourceDisksFolders]
; ak je v priečinku s pluginmi umiestnený aj podpriečinok openoffice
openoffice=a

[SourceDisksFolders]
; ak je priečinok openoffice umiestnený na disku c:\
c:\openoffice=a

Sekcia Software.AddReg

Software.AddReg[.build]

Slúži pre pridanie registračných kľúčov do reg. vetvy "Software". Táto sekcia musí byť zapísaná podľa vzoru:
regType, regKey, regValue, regData

pričom platí, že...
regTypeurčuje typ alebo informáciu, ktorá sa uloží do registrov ako hodnota. Tento parameter môže mať jednu z nasledujúcich hodnôt:
0x0, (REG_NONE) = vytvoriť len kľúč, nie hodnotu
0x1, (REG_SZ) = príkaz (string)
0x2, (REG_EXPAND_SZ) príkaz (s variabilnými referenciami prostredia)
0x3, (REG_BINARY) binárne dáta
0x4, (REG_DWORD) 32-bitové číslo
0x7, (REG_MULTI_SZ) viacnásobné príkazy
* Poznámka: regType musí vždy začínať hodnotou "0x" (s malými písmenami)!
regKeyzadá názov kľúča ako príkaz.
regValuezadá názov hodnoty ako príkaz.
regDataaktuálne dáta.

Príklad:
0x1, "Microsoft\Windows NT\CurrentVersion\Fonts", "Tahoma (TrueType)","TAHOMA.TTF"
0x2, "Control Panel\desktop", "WallPaper", "%systemroot%\system32\nu2.bmp"
0x3, "ControlSet001\Control\TimeZoneInformation", "DaylightStart",\
	00,00,04,00,00,01,00,02,00,00,00,00,00,00,00,00
0x4, "ControlSet001\Control\GraphicsDrivers\DCI", "Timeout", 0x7
0x7, "ControlSet001\Services\VgaSave\Device0", "InstalledDisplayDrivers","vga", "framebuf", "vga256", "vga64k"

Sekcia SetupReg.AddReg

SetupReg.AddReg[.build]

Slúži pre pridanie registračných kľúčov do reg. vetvy "SetupReg.hiv". Syntax je rovnaká, ako v sekcii Software.AddReg

Sekcia Default.AddReg

Default.AddReg[.build]

Slúži pre pridanie registračných kľúčov do reg. vetvy "Default". Syntax je rovnaká ako v sekcii Software.AddReg

Sekcia Software.DelReg

Software.DelReg[.build]

Slúži na vymazanie registračných kľúčov z vetvy "Software". Táto sekcia musí byť zapísaná podľa vzoru: regKey[, regValue]

pričom platí, že...
regKeyurčuje názov kľúča (vrátane všetkých jeho hodnôt), ktorý sa ako príkaz vymaže.
regValueurčuje názov hodnoty, ktorá sa ako príkaz vymaže.

Sekcia Default.DelReg

Default.DelReg[.build]

Slúži na vymazanie registračných kľúčov z reg. vetvy "Default". Syntax je rovnaká ako v sekcii Software.DelReg

Sekcia AddLine (pridať linku)

AddLine[.build]

Pridáva linky do sekcie. Riadok v tejto sekcii musí byť zapísaný podľa vzoru:
Filename,Section,StringToAdd

pričom platí, že...
Filenameje názvom toho súboru, ktorý sa pridá do linky.
Sectionje názov sekcie.
LineToAddje linkou na pridanie.

Príklad:
"netmscli.inf", "MSClient.DelReg", "HKLM, Software\Microsoft\Rpc\SecurityService, 9"

Sekcia DelLine (vymazať linku)

DelLine[.build]

Vymazáva linky zo súboru. Riadky v tejto sekcii musia byť zapísané podľa vzoru: :
Filename,Section,StringToDel

pričom platí, že...
Filenameje názvom toho súboru, ktorý sa pridá do linky.
Sectionje názvom sekcie.
StringToDelje linkou, ktorá sa vymaže. Ak linku neurčíte presne, zmažú sa všetky linky, začínajúce slovami "StringToDel".

Príklad:
"netmscli.inf", "MSClient.Browser.AddReg", "HKR, Parameters, MaintainServerList,"

Sekcia SetValue (nastaviť hodnotu)

SetValue[.build]

Zapíše hodnotu do súboru. Linky v tejto sekcii musia byť zapísané podľa vzoru:
Filename,Section,Key,Value

pričom platí, že...
Filenameje názvom toho súboru, ktorý sa dosadí do hodnoty.
Sectionje názvom sekcie.
Keyje kľúčom, ktorému sa daná hodnota priradí.
Valuedáta.

Príklad:
"netmscli.inf", "Alerter_Service_Inst", "StartType", "3"

Ak chcete odstrániť kľúč, vyplňte časti Filename,Section,Key
Ak chcete odstrániť celú sekciu, vyplňte časti Filename,Section

Sekcia Append (pripojiť dáta)

Append[.build]

Pripojí súbor k inému súboru. Riadky v tejto sekcii musia byť zapísané podľa vzoru:
Filename,FilenameToAppend

pričom platí, že...
Filenameje názvom toho súboru, ku ktorému sa pripoja dáta.
FilenameToAppendje názvom toho súboru, ktorý obsahuje dáta, ktoré sa budú pripájať.

Príklad:
nu2menu.xml, penero_nu2menu.xml

Premenné

Väčšina políčok s príkazom v súbore s prídavným modulom, môže obsahovať špeciálne premenné programu PE-Builder:
Syntax: @premenná@

kde...
variablerozbalí do...
ProgramNázov programu použitého na zostavenie (predvolené je to PE-Builder)
VersionVerzia zostavovacieho programu
IsoFilePlná cesta a názov k .ISO obrazu
OutDirPlná cesta a názov k výstupnému priečinku
SourcePathPlná cesta k zdrojovému priečinku
PluginDirPlná cesta k aktuálnemu priečinku s prídavným modulom
PluginFilePlná cesta a názov súboru v aktuálnom priečinku s prídavným modulom
LanguageAktuálne používaný jazyk
VerboseKonverzačný mód (0 - vypnutý, 1 - zapnutý)
BuildČíslo verzie systému Windows (2600 = XP, 3790 = Server 2003)

Príklad:
[SourceDisksFiles]
program.exe=2,,3
lang\@language@.lng=2,,3

Kde sa súbor lang\@language@.lng rozbalí do lang\german.lng (po vybratí nemeckého jazyka).

Tabuľka s obsahom

PE Builder Copyright (c) 2002-2006 Bart Lagerweij. Všetky práva vyhradené.