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]!

Name | Názov prídavného modulu
Enable | stav prídavného modulu (zapnutý/vypnutý) 0 - Vypnutý 1 - Zapnutý
Help | Ná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.
Config | Ná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...

directoryID | je 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...
dirname | je názvom priečinka. Ak názov obsahuje medzery, dajte ho do "úvodzoviek".
attribute | numerická 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:

ID | Priečinok | Pozná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)
2 | system32
3 | system32\config
4 | system32\drivers
5 | system
17 | system32\drivers\etc
20 | inf
21 | Help
22 | Fonts
24 | msagent\intl
52 | msagent
124 | WinSxS
125 | WinSxS\Manifests
252 | WinSxS\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.

Build | Verzia
--- | ---
2600 | Windows XP
3790 | Server 2003

Sekcia SourceDisksFiles musí byť zapísaná podľa vzoru:
`filename=directoryID[, filenameRenamed][, attribute]`
pričom platí, že...

`filename` | je názvom toho súboru, ktorý je určený na skopírovanie.
`directoryID` | je čí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.
`filenameRenamed` | je novým názvom súboru, ktorý sa použije ak bude potrebné súbor premenovať.
`attribute` | je 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...

`sourcepath` | je zdrojovou cestou/priečinkom, z ktorého sa bude kopírovať. Toto je presná kópia priečinka, nič nie je dekomprimované alebo extrahované!
`directoryID` | je čí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...

regType | urč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)!
regKey | zadá názov kľúča ako príkaz.
regValue | zadá názov hodnoty ako príkaz.
regData | aktuá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...

regKey | určuje názov kľúča (vrátane všetkých jeho hodnôt), ktorý sa ako príkaz vymaže.
regValue | urč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...

Filename | je názvom toho súboru, ktorý sa pridá do linky.
Section | je názov sekcie.
LineToAdd | je 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...

Filename | je názvom toho súboru, ktorý sa pridá do linky.
Section | je názvom sekcie.
StringToDel | je 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...

Filename | je názvom toho súboru, ktorý sa dosadí do hodnoty.
Section | je názvom sekcie.
Key | je kľúčom, ktorému sa daná hodnota priradí.
Value | dá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...

Filename | je názvom toho súboru, ku ktorému sa pripoja dáta.
FilenameToAppend | je 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...

variable | rozbalí do...
--- | ---
Program | Názov programu použitého na zostavenie (predvolené je to PE-Builder)
Version | Verzia zostavovacieho programu
IsoFile | Plná cesta a názov k .ISO obrazu
OutDir | Plná cesta a názov k výstupnému priečinku
SourcePath | Plná cesta k zdrojovému priečinku
PluginDir | Plná cesta k aktuálnemu priečinku s prídavným modulom
PluginFile | Plná cesta a názov súboru v aktuálnom priečinku s prídavným modulom
Language | Aktuálne používaný jazyk
Verbose | Konverzač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é.