KTuberling Priročnik

# KTuberling Priročnik

Éric Bischoff `<e.bischoff@noos.fr>`

Paul E. Ahlquist, Jr. `<pea@ahlquist.org>`

Eugene Trounev `<eugene.trounev@gmail.com>`

Recenzent: Lauri Watts
Prevod: Matjaž Jeran
Različica KDE Gear 21.08 (04.10.2021)

Pravna zaščita © 1999, 2000, 2002, 2006 Éric Bischoff

Pravna zaščita © 2001 Paul E. Ahlquist, Jr.

Pravno sporočilo

Potato Guy je igra namenjena majhnim otrokom.

Seznam tabel

4.1. Gumbi orodne vrstice

Poglavje 1. Uvod
Uvod

# Poglavje 1. Uvod

Vrsta igre: Igrača

Število možnih igralcev: en

Potato Guy je preprosta konstruktorska igra, primerna za otroke in odrasle. Ideja igre temelji na nekoč priljubljenem konceptu izdelave lutk. Krompir je bil okrašen z različnimi majhnimi artefakti, da bi bil bolj podoben majhnemu človeku. Potato Guy vendar gre veliko dlje v smislu vsebine in dodaja presenetljivo raznolikost različnih tem.

Poglavje 2. Kako igrati
Kako igrati

# Poglavje 2. Kako igrati

Potato Guy je igra namenjena majhnim otrokom. Seveda je lahko primeren za odrasle, ki so ostali mladi po srcu.

Je “urejevalnik krompirja”. To pomeni, da lahko povlečete in spustite oči, usta, brke in druge dele obraza ter dobrote na krompirju podobnega tipa. Podobno imate druga igrišča z različnimi temami.

V igri ni zmagovalca. Edini namen je narediti čim bolj smešne obraze.

Potato Guy lahko tudi “govori”. Izpisalo bo ime predmetov, ki jih povlečete in spustite. “Govoril bo” v jeziku, ki ga lahko izberete. Uporabite ga lahko celo za učenje delčka besedišča v tujih jezikih.

Poglavje 3. Pravila in nasveti
Pravila in nasveti

# Poglavje 3. Pravila in nasveti

## Delovanje miške

V glavnem oknu sta dve področji:

- Območje “Igrišče”.

- Območje “Predmeti”, kjer izberete predmete, ki jih želite postaviti na svoje igrišče.

### Opomba

Dejanski videz zaslona aplikacije se lahko spremeni glede na izbrano “igrišče”.

### Postavitev predmeta

Če želite povleči predmet, premaknite kazalec miške na območje “predmetov” in kliknite nanj. Nato ga premaknite na “igrišče” in znova kliknite.

### Opomba

Velikost predmetov se lahko med vlečenjem spreminja. Nekateri preveliki predmeti so bili pomanjšani za prileganje v območju “predmetov”.

### Premikanje predmeta

Ko predmet spustite v “igrišče”, ga lahko premaknete. Preprosto kliknite na predmet, da ga izberete, premaknete na novo mesto in znova kliknete, da ga spustite. Ko ga spustite, gre na druge predmete, ki so ga delno skrivali. Ta trik je uporaben za pravilno namestitev očal in oči.

### Odstranjevanje predmeta

Če želite odstraniti predmet, ki je bil padel v območje “igrišče”, ga povlecite nazaj iz območja “igrišče” v območje “predmetov”.

Poglavje 4. Pregled vmesnika
Pregled vmesnika

# Poglavje 4. Pregled vmesnika

## Orodna vrstica

V orodni vrstici so gumbi za pogosto uporabljene funkcije.

Tabela 4.1. Gumbi orodne vrstice

Gumb | Ime | Enakovreden meni | Dejavnost
--- | --- | --- | ---
| Nova | Igra → Nova | Ponastavi območje “igrišče”. S tem očistite vse dele igrišča, da lahko ustvarite novo dekoracijo.
| Naloži… | Igra → Naloži… | Odpre obstoječo datoteko `.tuberling` z diska.
| Shrani | Igra → Shrani | Shrani vaše ustvarjanje v domačo mapo ali v drugo mapo na disku. `.tuberling` se shrani v majhno datoteko, kjer so shranjeni le položaji predmetov.
| Natisni… | Igra → Natisni… | Natisne vašo sliko.
| Razveljavi | Uredi → Razveljavi | Razveljavi zadnjo operacijo.
| Ponovi | Uredi → Ponovi | Ponovno izvede zadnjo operacijo.

Elementi menija
Elementi menija

## Elementi menija

### Meni igre

Igra → Nova (Ctrl+N)

  Počisti območje “igrišča”.

Igra → Naloži… (Ctrl+O)

  Odpre obstoječo datoteko `.tuberling` z vašega diska.

Igra → Shrani (Ctrl+S)

  Shrani vašo kreacijo. Tuberling se shrani v majhno datoteko, kjer so shranjeni le položaji predmetov.

Igra → Shrani kot sliko…

  Ustvari grafično datoteko, ki vsebuje sliko vašega tuberlinga.

Igra → Natisni… (Ctrl+P)

  Natisne vašo sliko gomoljev.

Igra → Zapri (Ctrl+Q)

  Zapri Potato Guy.

### Meni Urejanje

Uredi → Razveljavi (Ctrl+Z)

  Razveljavi zadnjo postavitev “predmeta”.

Uredi → Ponovi (Ctrl+Dvigalka+Z)

  Ponovno naredi zadnjo postavitev “predmeta”. Ta možnost menija je aktivna le, če ste že uporabili Razveljavi.

Uredi → Kopiraj (Ctrl+C)

  Kopiraj območje “igrišča” na odložišče.

### Meni Pogled

Pogled → Celozaslonski način (Ctrl+Dvigalka+F)

  Preklopi grafični vmesnik v celozaslonski način.

### Meni igrišča

Igrišče → Zakleni razmerje stranic

  Ta možnost ohrani razmerje stranic igrišča pri spreminjanju velikosti Potato Guy okna. Če se razmerje stranic igrišča ne ujema z razmerjem stranic okna, se ozadje zapolni s tistim, ki je določeno v temi.

Igrišče → `Ime igrišča`

  Preklopi na igrišče.

Vseboval bo igrišča, nameščena v vašem sistemu.

Potato Guy si zapomni zadnje izbrano igrišče ob naslednjem zagonu.

### Meni Govor

Govor → Brez zvoka

  Izklopi zvok.

Govor → `Ime jezika`

  Vklopi zvok in govori izbrani jezik.

Potato Guy si zapomni to možnost ob naslednjem zagonu.

### Meniji Nastavitve in Pomoč

Dodatno Potato Guy ima skupno KDE Elemente menija Nastavitve in Pomoč, za več informacij preberite razdelke o meniju z nastavitvami in meni Pomoč v KDE Osnove.

Poglavje 5. Pogosto zastavljena vprašanja
Pogosto zastavljena vprašanja

# Poglavje 5. Pogosto zastavljena vprašanja

5.1. Želim spremeniti videz te igre. Ali lahko?
5.2. Ali lahko uporabljam tipkovnico za igranje te igre?
5.3. Naredil sem odlično sliko in jo želim deliti s prijatelji. Ali jo lahko shranim kot sliko?

5.1. | Želim spremeniti videz te igre. Ali lahko?
| Da, lahko. Za podrobnosti glejte ta razdelek »Pregled vmesnika«.
5.2. | Ali lahko uporabljam tipkovnico za igranje te igre?
| Ne. Te igre ni mogoče igrati s tipkovnico.
5.3. | Naredil sem odlično sliko in jo želim deliti s prijatelji. Ali jo lahko shranim kot sliko?
| Da. Če želite shraniti trenutno sejo kot sliko, glejte ta razdelek 'Pregled vmesnika' za podrobnosti.

Poglavje 6. Tehnične reference
Tehnične reference

# Poglavje 6. Tehnične reference

Éric Bischoff

Prevod: Matjaž Jeran
Različica KDE Gear 21.08 (04.10.2021)

KTuberling ponuja nežen in nagrajujoč uvod v KDE prilagajanje in programiranje. Aplikacijo je mogoče razširiti. Na primer, brez kodiranja je mogoče dodati nova igrišča s spreminjanjem grafičnih datotek. Z dodajanjem ustreznih zvočnih datotek lahko prevajalci spremenijo zvoke v svoj materni jezik!

Če razširite ali dodate igro, razmislite o pošiljanju svojih dodatkov vzdrževalcu Alex Fiestas za vključitev v prihodnje izdaje.

## Za umetnike

Če želite ustvariti nov KTuberling igrišče morate:

- Narisati igrišče v SVG datoteko, tam morate:

  - Poimenovati prostor, kamor lahko elemente povlečete “ozadje”.

  - Poimenovati vsak element, ki ga je mogoče povleči, z edinstvenim imenom.

- Ustvariti datoteko `.theme`, slediti mora tej shemi:

      <playground gameboard="yourSVGFile" name="theDesktopFile">
      <object name="itemName" sound="soundName" scale="someValue" />
      ...
      ...
      ...
      </playground>

  - `yourSVGFile` je ime datoteke SVG datoteke, ki vsebuje risbo.

  - `theDesktopFile` je ime datoteke namizja, ki ima ime teme.

  - Za vsak predmet potrebujete vnos `<object>`. `itemName` je edinstveno ime, ki ste ga uporabili v datoteki SVG `soundName` je ime zvoka, ki se bo predvajal, ko ga povlečete, za več informacij glejte datoteko `sounds/soundthemes.HOWTO` iz izvorne kode.

  - `scale` je neobvezen in `someValue` je faktor merila, ki bo uporabljen pri risanju tega predmeta zunaj skladišča, če ni naveden, je 1.

- Ustvarite datoteko `.desktop`, slediti mora tej shemi:

      [KTuberlingTheme]
      Name=themeName

  - `themeName` je ime, ki identificira temo in bo prikazano v meniju Playground.

- Če temo dodajate v KTuberling repozitorij dodajte datoteke `.svg`, `.theme` in `.desktop` `FILES` v `CMakeLists.txt` v mapo `pics/`.

- Če ga želite namestiti zase, postavite `.svg`, `.theme` in `. desktop` v mapo `ktuberling/pics` v `qtpaths `--paths GenericDataLocation``

Za prevajalce
Za prevajalce

## Za prevajalce

Poleg običajnega mehanizma datotek `.po` za prevajanje programskih oznak in pozivov je mogoče lokalizirati tudi zvoke.

Če želite ustvariti novo zvočno temo KTuberling, jo morate:

- Posneti zvoke v formatu datoteke OGG Vorbis rc3.

- Ustvarite datoteko ``yourLanguageTwoLetterCode`.soundtheme`, slediti mora tej shemi:

      <language code="yourLanguageTwoLetterCode">
      <sound name="soundName" file="relativePath" />
      ...
      ...
      ...
      </language>

  - `yourLanguageTwoLetterCode` je dvočrkovna koda vašega jezika, na primer gl za galicijščino.

  - Za vsak zvok vnos `<sound>`. `soundName` se mora ujemati z soundName, določenim v temi igrišča (glejte `pics/themes.HOWTO` iz izvorne kode). `relativePath` mora biti relativna pot, na katero boste namestili datoteko s tem zvokom, običajno bo to ``someUniquePath`/`soundName`. `format`` (`someUniquePath` je lahko na primer dvočrkovna koda vašega jezika).

- Če dodajate zvočno temo v KTuberling v vaši jezikovni mapi:

  - Dodajte zvočne datoteke in datoteke `.soundtheme` v mapo `data/kdegames/ktuberling` vaših jezikovnih prevodov.

  - V tem istem imeniku potrebujete datoteko `CMakeLists.txt`, ki opisuje, kako namestiti datoteke, običajno bo tako.

        FILE( GLOB oggfiles *.ogg )
        INSTALL( FILES ${oggfiles} DESTINATION ${KDE_INSTALL_DATADIR}/ktuberling/sounds/yourLanguageTwoLetterCode )
        INSTALL( FILES yourLanguageTwoLetterCode.soundtheme DESTINATION ${KDE_INSTALL_DATADIR}/ktuberling/sounds/ )

- Če ga želite namestiti sami:

  - Postavite datoteko ``yourLanguageTwoLetterCode`.soundtheme` v mapo `ktuberling/sounds` v `qtpaths `--paths GenericDataLocation``

  - Postavite svoje zvočne datoteke v mapo `ktuberling/sounds/`someUniquePath`` v `qtpaths `--paths GenericDataLocation``

Informacije o tem, kako delati s prevajalskimi mehanizmi v KDE je na voljo v The KDE Translation HOWTO.

Za programerje
Za programerje

## Za programerje

KTuberling za programerje res ni težko razširiti.

### razredi C++

`Najvišji nivo`

  Okno najvišje ravni in osnovno upravljanje programa.

`Igrišče`

  Opis ene od ravni igre.

`Risati`

  Opis enega od grafičnih “predmetov”, ki jih je treba narisati.

`SoundFactory`

  Opis enega od jezikov in njegovih zvokov.

`Akcija`

  Ena od uporabnikovih manipulacij v skladu za razveljavitev/ponovitev.

Poglavje 7. Zasluge in licenca
Zasluge in licenca

# Poglavje 7. Zasluge in licenca

KTuberling

- Alex Fiestas `(alex AT eyeos.org)` - trenutni vzdrževalec

- John Calhoun - Izvirna ideja, izvirne slike in angleški zvoki

- Éric Bischoff `(e.bischoff AT noos.fr)` - KDE Programiranje

- François-Xavier Duranceau `(duranceau AT free.fr)` - Testi, nasveti in pomoč

- Peter Silva `(peter.silva AT videotron.ca)` - Lektoriranje dokumentacije

- Paul E. Ahlquist, Jr. `(pea AT ahlquist.org)` - Izboljšanje dokumentacije

Prevod: Matjaž Jeran`(matjaz.jeran AT amis.net)`

Dokumentacija je objavljena pod pogoji GNU Free Documentation License.

Pogoji uporabe programa so določeni v GNU General Public License.