diff -Nru tilitoli-0.8~ppa3/debian/changelog tilitoli-0.8~ppa4/debian/changelog --- tilitoli-0.8~ppa3/debian/changelog 2011-09-02 13:25:29.000000000 +0000 +++ tilitoli-0.8~ppa4/debian/changelog 2011-09-02 14:21:07.000000000 +0000 @@ -1,4 +1,4 @@ -tilitoli (0.8~ppa3) lucid; urgency=high +tilitoli (0.8~ppa4) lucid; urgency=high * Végleges Változat Binary files /tmp/Veyc7fjPx1/tilitoli-0.8~ppa3/tilitoli/csere.pyc and /tmp/8qC9uQkxZK/tilitoli-0.8~ppa4/tilitoli/csere.pyc differ diff -Nru tilitoli-0.8~ppa3/tilitoli/docs/en.html tilitoli-0.8~ppa4/tilitoli/docs/en.html --- tilitoli-0.8~ppa3/tilitoli/docs/en.html 2011-09-01 15:44:46.000000000 +0000 +++ tilitoli-0.8~ppa4/tilitoli/docs/en.html 2011-09-02 14:17:50.000000000 +0000 @@ -57,7 +57,7 @@

2.2.2. Linux

-Before installing the game, Python ) and the correct version of Pygame should be installed. In certain Linux distributions the 'sudo apt-get' command can be used, such as 'sudo apt-get install python' and 'sudo apt-get install python pygame'. Some distributions however use a different command line package manager. Please see the appropriate manual page. In other cases Python comes built in with the operating system, such as in Ubuntu. +Before installing the game, Python ) and the correct version of Pygame should be installed. In certain Linux distributions the 'sudo apt-get' command can be used, such as 'sudo apt-get install python' and 'sudo apt-get install python-pygame'. Some distributions however use a different command line package manager. Please see the appropriate manual page. In other cases Python comes built in with the operating system, such as in Ubuntu. To extract Sliding Puzzle, you can se the 'unzip' command, e.g. 'unzip SlidingPuzzleVersionNumber.zip'. (VersionNumber means the version of the game, e.g. 0.8). When the extraction is complete, enter the directory of the game ('cd FolderName') and type 'python tilitoli.py' and press enter to run it.

diff -Nru tilitoli-0.8~ppa3/tilitoli/docs/en.txt tilitoli-0.8~ppa4/tilitoli/docs/en.txt --- tilitoli-0.8~ppa3/tilitoli/docs/en.txt 2011-09-01 15:44:46.000000000 +0000 +++ tilitoli-0.8~ppa4/tilitoli/docs/en.txt 1970-01-01 00:00:00.000000000 +0000 @@ -1,118 +0,0 @@ -Sliding puzzle (Tilitoli) manual -Created by Aron Ocsvari -Corrected by Robert Osztolykan - - - - -+ Introduction + - - -++ Sliding puzzle rules ++ - - -Sliding puzzle is a singleplayer logical game, which can be played on 3x3, 4x4, 5x5 or custom boards. Generally on a board there are numbers and an empty square, which needs to be swapped with one of its neighbours. When the game starts, the order of the fields is random, thus almost any combination is possible. The player's task is to sort the numbers provided in ascending order, by moving the empty square around the board. Once this result is achieved, the board is complete and the player wins. - -++ About the boards ++ - -The game comes with three boards by default, however an unlimited number of custom boards can be added to make the game more challenging. It is worth noting that the board is not restricted to numbers, it can contain any element. Thus, a custom board can include tasks such as pairing (i.e. capitals with countries, bird sounds with their names), musical notes (i.e. to produce a certain melody), etc. - -In order to create a board, an xml document should be created containing predefined fields (xml elements), forming the board's rules. The value of these fields is a sound file, which needs to be created for each field. - -If the xml document contains less than 24 items, the program fills the remaining ones with joker fields. When sorting the fields, the order of the joker fields is not important, however they must follow the normal fields. The last item of every board should always be the empty field. - -+ Getting started + - -++ System requirements ++ - -Since Sliding Puzzle is an audio game, a set of speakers or headphones are necessary. An additional 10 mb free diskspace should be available when installing, and further space for any custom boards (size may varry). - -In order to run the game properly, a minimum of 50 MB RAM and 1 GHz processor required, 128 mb and a 2 GHZ recommended. - -Please note, under linux the diskspace requirement can be different, as the Python interpreter plus additional modules should be installed (see 2.2.2). -Under Windows XP, if the [Microsoft Visual C++ 2008 Redistributable Package http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=29] is not installed, the game won't start. - -++ Installation ++ - -+++ Windows +++ - -For the installation, follow the instructions of the installer. The player can change destination folder, create a desktop and start menu icons, etc. Start of the game, use these icons. - -+++ Linux +++ - -Before installing the game, Python ) and the correct version of Pygame should be installed. In certain Linux distributions the 'sudo apt-get' command can be used, such as 'sudo apt-get install python' and 'sudo apt-get install python pygame'. Some distributions however use a different command line package manager. Please see the appropriate manual page. In other cases Python comes built in with the operating system, such as in Ubuntu. -To extract Sliding Puzzle, you can se the 'unzip' command, e.g. 'unzip SlidingPuzzleVersionNumber.zip'. (VersionNumber means the version of the game, e.g. 0.8). When the extraction is complete, enter the directory of the game ('cd FolderName') and type 'python tilitoli.py' and press enter to run it. - -++ Main menu ++ - - -When the appropriate file is executed the game starts. The intro of the game appears. It is possible to skip it using the escape key. This is followed by the music of the main menu and the name of the first menu item (New game). Use the up and down arrow keys to move between menu items, and the enter key to select. Although the menu is not visible on the screen, the virtual cursor moves, and the current menu item is spoken accordingly. - -There are five menu items in the main menu: - -- New game: by pressing enter here, the user gets to the board selection menu (which is outlined in the next chapter). -- Speaker test: In this game, it is highly important to know which direction a sound is coming from. This menu item is especially useful if the user has earphones, as the left and right ones can be easily confused. -- Language selection: In this menu, the user can change language of the game. The Sliding puzzle uses the operation system's default language when it starts. -- Load saved game: If the player activates this menu by pressing enter, the last saved game wil be loaded. If there is no saved game, the cursor will go back to the main menu. -- Quit: When this menu item is selected the music fades and the program closes. -- - -++ Board selection menu ++ - -By selecting the 'New game' menu item the list of available boards appear. The user can navigate between the available boards with the up and down arrow keys and start the game by pressing enter. At this point the menu music fades, the board loads and the game is ready to play. - -++ language selection menu ++ - -If the user activates this menu, list of available languages appears. This submenu works like the main menu, so the user can move with up and down arrow keys, and activate a language with the enter key. In this case, the game swiches to the selected language, and the cursor goes back in the main menu. The game doesn't save this option when it closes. - -++ Gameplay ++ - -Navigating on the board can be achieved by moving the cursor with the arrow keys. The up and down arrows move between rows, while the left and right arrows move from column to column. I also tried to illustrate movement on the board via sounds: if the user moves to the left or to the right of the board, the balance between the two speaker's volume shifts to the corresponding side. For example, if the cursor is positioned at the extreme left, only the left speaker can be heard. - -A beeping sound marks the empty space, so that it can be easily distinguished from other fields. If the virtual cursor stands on a neighbour block and the user presses enter, the block changes place with the empty space. To help players, successful swaps are also indicated by a distinct sound. A certain sound can be also heard when the user is at the edges of the board. This sharper, snapping sound might be disturbing on a 3x3 board but it really comes in handy if the user is playing on a 5x5 board. - -If you outed the correct order, you'd hear your number of steps (How many times you swapped the empty square with its neighbours). If you haven't finished the game, but you'd like to carry on later, you can save it with pressing v key. The Sliding puzzle can be saved only one board, so when the user saves another board, the previous one will be overwritten. - -+ Creating xml files + - -Xml files are stored in the folder of languages named xmls (e.g. locale/en/xmls). For each xml file belongs an .ogg file with the same name, these contain the name of the board. If any of the two files is missing, the board will not be displayed in the list of available boards. The program currently uses only the 'ID' and 'Sound' elements of the xml file. The content of the 'Sound' element is the folder of the file and the name of the board, e.g. 3x3/3.ogg. It is important to note that Pygame recognises the / symbol (slash) as a path separator character instead of \ (backslash). The audio files of the game must be copied into the 'audio' folder. - -+ Keyboard Shortcuts + - -For easier usability here are all the keys used to control the game: - -|| Control key | Description | -| home | In the menus, the cursor jumps to the first menu item, on the board it jumps to the left edge column. | -| end | In the menus, the cursor jumps to the last menu item, on the board, it junps to the right edge column. | -| enter | activates the selected menu items in the menu and swaps the selected and the empty block in the game if the move is possible | -| up arrow | moves up in the menu and one row up on the board in the game | -| down arrow | moves down in the menu and one row down on the board in the game | -| left arrow | moves one column left on the board in the game | -| right arrow | moves one column right on the board in the game | -| Page up | The cursor jumps to the first row of the board (the column's coordinate does not change). | -| Page down | The cursor jumps to the last row of the board (the column's coordinate does not change). | -| r | plays the number of the row where the virtual cursor stands on the board | -| c | plays the number of the column where the virtual cursor stands on the board | -| e | repeats the value of the field where the virtual cursor stands | -| s | Announces number of steps | -| o | plays the correct order. | -| v | Saves the game, and closes the board | -| F2 | Pauses the background music. | -| f3 | Resumes play the background music. | -| escape | Quits the game if pressed in the main menu, otherwise closes the opened board | - -+ Possible improvements in the future + - -I have countless ideas concerning the game's future development, although I could not implement these so far due to my studies. I considered multiplayer competition, which means in practice that after a successfully completed game, the program would send statistics, such as how many moves they needed, how long it took for them to complete a board, etc.) to a server, where they would be assessed by a program. - -The idea of involving 5.1 sound also emerged, as it would allow much subtler sound effects on larger boards. As I have already prepared the way for this version with the sound playing function, I would like to realize this plan in the near future. A computer game that has an amazing graphic display caters for the amusement of sighted users, while an audio game that sounds good, and exploits the potential of stereo and multiple speaker setups can also offer a high-quality gaming experience and intriguing programming options. In my opinion, games of this kind can have significance not only for the blind but also for the sighted users, especially in situations when they, too, can only rely on their hearing. - -To facilitate the creation of boards, I am planning to incorporate an xml editor in the program. This way, even those could design boards easily who are not familiar with the language. - -As users can freely create their own boards, I also intend to launch an interactive webpage where they could upload them and so spare others the unnecessary work of designing boards that already exist. - -+ Updates + - -The Sliding puzzle latest version can be downloaded [from this website http://audiopuzzle.googlecode.com] - -E-mail: oaron1@gmail.com diff -Nru tilitoli-0.8~ppa3/tilitoli/docs/hu.html tilitoli-0.8~ppa4/tilitoli/docs/hu.html --- tilitoli-0.8~ppa3/tilitoli/docs/hu.html 2011-09-02 11:40:38.000000000 +0000 +++ tilitoli-0.8~ppa4/tilitoli/docs/hu.html 2011-09-02 14:17:50.000000000 +0000 @@ -1,383 +1,229 @@ - - - - - Tilitoli (Sliding puzzle) dokumentáció - - - - - - - -

Tilitoli (Sliding puzzle) dokumentáció

-

Készítette: Ócsvári Áron

-

1. Bevezetés

-

1.1. Tilitoli szabályai

-

A „Tilitoli” egy egyszemélyes logikai játék, amit 3x3, 4x4, -vagy 5x5-ös méretû táblán játszanak. A táblán a mérettől -függően, 9-25 mező található. A mezőkön egészszámok -találhatóak, (1-8 1-15, 1-24) között, ezen felül egy üres mező. -Az üres mezővel felcserélhetőek a körülötte lévő mezők. A -játék kezdetekor a mezők elhelyezkedése véletlenszerû. A -feladat az, hogy a számokat sorfolytonosan rendezze úgy, hogy az -üres mező a tábla jobb alsó sarkában helyezkedjen el. -

-

1.2. A játékról

-

Az alapvető szabályok itt is megmaradtak, vagyis csak az üres -mező mozgatásával lehet sorba rendezni a mezőket. A programban -alapértelmezetten háromféle méretû tábla található. Ezekhez -egy-egy teszt pálya tartozik, a többi a felhasználók által -készült, amire ez a dokumentáció nem tér ki. -

-

A 3X3 táblán az 1-8 közötti számok találhatóak, -összekeverve. A kilencedik mező az a bizonyos üres mező, aminek -mozgatásával sorba kell rendezni a mezőkön található számokat. -A négyszer négyes és ötször ötös táblák sem sokban -különböznek az elsőtől, a négyszer négyesen 15, az ötször -ötösön 24 számot kell sorba rendezni. -

-

Plusz kiegészítés, hogy a játékos is létrehozhat táblákat. -Ehhez csak egy XML fájlt kell készítenie, megadott szabályok -szerint. Az egyes mezőkön nem csak számok szerepelhetnek, hanem -bármilyen szöveg/hang, amihez valamilyen sorrendet lehet társítani. -Jó alternatív példa erre Budapest kerületeinek neve, ahol a -sorrendet a kerület száma adja meg. De egy dallam is kirakható -sorrendet képez. -

-

A tábla maximum ötször ötös lehet, ennél nagyobb játéktér -már átláthatatlan lenne. Ha az XML fájl kevesebb, mint 24 elemet -tartalmaz, a táblára felkerül megfelelő számú joker mező, ami -a hiányzó elemek kiegészítésére szolgál. A sorba rendezéskor -csak arra kell figyelni, hogy az utolsó normál mező után a -jokerek következzenek és mindenképp a tábla utolsó eleme legyen -az üres mező. Könnyítés viszont, hogy ha több joker mező is -található a táblán, azokat nem kell sorrendbe állítani, a fő -kritérium csak annyi, hogy egymást kövessék, és a sorba -rendezendő mezők után következzenek. -

-

A mezők értékei hangfájlokban tárolódnak, így új típusú -tábla létrehozásakor a játékosnak minden értéket rögzítenie -kell egy-egy hangfájlban. Ugyanígy a játék üzenetei is egy-egy -hangfájlban találhatóak, ezért nyitott a lehetőség a Tilitoli -más nyelvekre való lefordítására, vagy a háttérzene és egyéb -hangok megváltoztatására. -

-

2. A program használata

-

2.1. Rendszerkövetelmények

-

Az egyik talán legfontosabb kellék, a sztereo hangszóró, vagy -fül/fejhallgató, ez elengedhetetlen a játékhoz. Fontos még -minimum 50 megabájtnyi memória, és minimum 1 ghz processzor. -

-

Windows XP használatakor a játék csak akkor indul el, ha fel -van telepítve a Microsoft -Visual C++ 2008 Redistributable Package. -

-

2.2. Telepítés

-

2.2.1. Windows

-

A telepítő üzeneteit végigolvasva feltelepíthető a játék. -Kiválasztható a parancsikonok létrehozása az asztalon, -megváltoztatható a program főkönyvtára is. A telepítés után a -parancsikonok segítségével elindítható a játék. -

-

2.2.2. Linux

-

A játékhoz elengedhetetlen a Python és a Pygame ugyanezen -verzióinak megléte, a telepítést a terminálban a sudo apt-get -install python, és sudo apt-get install python-pygame parancsokkal -teheti meg. -

-

A letöltött zip fájlt az unzip tilitoli0.x.x.zip paranccsal -tömörítheti ki (a .x.x az aktuális verziószámot jelzi). -

-

Miután belépett a játék mappájába (cd mappanév), a python -tilitoli.py parancs kiadásával indíthatja el a játékot. -

-

2.3. Főmenü

-

A játék indulásakor egy intró köszönti a játékost, amin -bármely billentyû lenyomásával továbbugorhat. Ekkor felhangzik a -főmenü zenéje, és az első menüpont neve (Új játék). A -menüben a fel és le nyilakkal mozoghat, ami ugyan a képernyőn nem -látszik, de a „virtuális kurzor” mozog. Egy menüpontot -enterrel nyithat meg. A főmenüben öt menüpont található: -

- -

2.4. Pályaválasztó menü

-

Az „Új játék” menüpont aktiválásával az elérhető -pályák listája „jelenik” meg. Itt is a fel és le nyíllal -mozoghat, az enterrel indíthatja el a játékot. Ekkor a menü -zenéje elhalkul, és betöltődik a pálya. -

-

2.5. A nyelvválasztó menü

-

A menüpont aktiválásakor megjelenik az elérhető nyelvek -listája. Itt a fel és le nyilakkal mozoghat, egy nyelvet az enter -billentyûvel aktiválhat. Ekkor visszatér a főmenübe, és a játék -az adott nyelven fog megszólalni. A beállítás a játék -bezárásáig vagy annak megváltoztatásáig érvényes, az újbóli -indításkor az operációs rendszer alapértelmezett nyelvén szólal -meg. -

-

2.6. A pályákról

-

A táblán való mozgás a kurzormozgató billentyûkkel -lehetséges. A fel és le nyíllal soronként, a bal és jobbra -nyíllal oszloponként mozog a virtuális kurzor. Igyekeztem ezt -hanghatásokkal is szimulálni, így ha jobbra-balra mozog, az egyes -oldalon a hangszórók hangereje változik, vagyis pl. teljesen -baloldalon csak a bal hangszóróból jön a hang. Az üres mezőt -egy élesebb hanggal jelölöm, így egyértelmûen meg lehet -különböztetni a többitől. Ha az üres mező valamelyik -szomszédján áll a „virtuális kurzor”, az enter lenyomására -helyet cserél az üres mezővel. A sikeres cserét egy jól -megkülönböztethető hang jelzi, ezzel segítve a felhasználót. -Ha a tábla szélén mozog, egy élesebb, csappanó hangot hall. Ez a -háromszor hármas táblánál zavaró lehet, de ötször ötösnél -nagyon hasznos. -

-

Ha sikeresen kirakta a jó sorrendet, a végén megtudhatja hány -lépésből sikerült megcsinálni. A lépések számát -meghallgathatja az s billentyû lenyomásával is. -

-

Ha még nem végzett a játékkal, de szeretné máskor folytatni, -a v billentyû lenyomásával elmentheti azt. Figyelem, egyszerre -csak egy tábla állásait tárolja a program! -

-

3. XML fájl elkészítése

-

Az XML fájlok minden nyelv mappájában (pl. locale\hu, -locale\en, stb.) az xmls mappában találhatók. Minden fájlhoz -hozzátartozik egy ugyanolyan nevû .ogg fájl is, ami a pálya nevét -tartalmazza. Ha valamelyik fájl nem található, a pálya nem kerül -bele a pályák listájába. -

-

Jelenleg a program az XML fájlból csak az ID és a Sound mezőket -használja. A sound értéke a pálya könyvtára/a mező neve, pl. a -háromszor hármasnál <sound>3x3/3.ogg</sound>. Fontos, -hogy a Python a \ helyett /-t vár könyvtár elválasztó jelként. -

-

4. Billentyûparancsok a játékban

-

Az átláthatóság kedvéért, itt megtalálható az összes -billentyûparancs, ami használható a játékban. -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-

Billentyûparancs

- 		-

leírás

-
-

Home

- 		-

A menükben a legfelső menüpontra ugrik, a táblán a bal - szélső oszlopra.

-
-

end

- 		-

A menükben a legutolsó elemre ugrik, a táblán a jobb szélső - oszlopra.

-
-

enter

- 		-

A menükben aktiválja a kijelölt menüpontot, a játékban az - üres és az adott mezőt kicseréli, ha lehetséges.

-
-

Fel nyíl

- 		-

Felfelé mozog a menüben és a játéktáblán.

-
-

Le nyíl

- 		-

Lefelé mozog a menüben és a játéktáblán.

-
-

Balra nyíl

- 		-

A játéktáblán az oszlopokon lépked bal irányban.

-
-

Jobbra nyíl

- 		-

A játéktáblán az oszlopokon lépked jobb irányban.

-
-

Page up

- 		-

A játéktáblán a legfelső sorra ugrik.

-
-

Page down

- 		-

A játéktáblán a legalsó sorra ugrik

-
-

r

- 		-

Elhangzik a tábla azon sorának száma, ahol a „virtuális - kurzor áll.

-
-

c

- 		-

Elhangzik a tábla azon oszlopának száma, ahol a „virtuális - kurzor áll.

-
-

e

- 		-

Megismétli a „virtuális kurzornál” lévő mező értékét.

-
-

s

- 		-

Bemondja az eddigi cserék számát.

-
-

o

- 		-

Végigmondja az elemeket, a helyes sorrendben.

-
-

v

- 		-

Elmenti a pálya aktuális állását.

-
-

f2

- 		-

Megállítja a háttérzene lejátszását.

-
-

F3

- 		-

Folytatja a háttérzene lejátszását.

-
-

Escape

- 		-

Bezárja a pályát, a főmenüben megnyomva kilép a játékból.

-
-

5. Továbbfejlesztési lehetőségek

-

Rengeteg ötletem van még, amivel fejleszthetném a játékot, -viszont tanulmányaimból kifolyólag ezek eddig még nem valósultak -meg. Felmerült a játékosok versenyeztetése, vagyis a program egy -sikeres játék után elküldené egy szervernek az eredményeket -(hány lépésből rakta ki a felhasználó, mennyi idő alatt, stb), -amit egy program kiértékelne. -

-

Az 5.1-es hangzás ötlete is felvetődött, így a nagyobb -pályákon való mozgáskor még jobb hanghatásokat lehetne vele -elérni. Ezt már előkészíti a hang lejátszó függvény, így a -közeljövőben szeretném ezt megvalósítani. -

-

A könnyebb pályaszerkesztés segítésére tervben van egy xml -szerkesztő beleépítése a játékba, így akik nem ismerik ezt a -nyelvet, ők is nagyon egyszerûen tudnának pályákat készíteni. -

-

Mivel a felhasználókra van bízva a pályák elkészítése, -szeretnék egy interaktív weboldalt is csinálni, ahova feltölthetik -a játékosok a saját készítésû pályákat, így másoknak nem -kellene feleslegesen dolgozniuk. -

-

6. Elérhetőségek

-

A Tilitoli legfrissebb verzióját innen -töltheti le. -

-

E-mail: oaron1@gmail.com -

-



-

- - + + + + +Tilitoli (Sliding puzzle) dokumentci + +
+

Tilitoli (Sliding puzzle) dokumentci

+Ksztette: csvri ron
+
+ + +

1. Bevezets

+ +

1.1. Tilitoli szablyai

+ +

+A Tilitoli egy egyszemlyes logikai jtk, amit 3x3, 4x4, vagy 5x5-s mret tbln jtszanak. A tbln a mrettl fggen, 9-25 mez tallhat. A mezkn egszszmok tallhatak, (1-8 1-15, 1-24) kztt, ezen fell egy res mez. Az res mezvel felcserlhetek a krltte lv mezk. A jtk kezdetekor a mezk elhelyezkedse vletlenszer. A feladat az, hogy a szmokat sorfolytonosan rendezze gy, hogy az res mez a tbla jobb als sarkban helyezkedjen el. +

+ +

1.2. A jtkrl

+ +

+Az alapvet szablyok itt is megmaradtak, vagyis csak az res mez mozgatsval lehet sorba rendezni a mezket. A programban alaprtelmezetten hromfle mret tbla tallhat. Ezekhez egy-egy teszt plya tartozik, a tbbi a felhasznlk ltal kszlt, amire ez a dokumentci nem tr ki. +

+

+A 3X3 tbln az 1-8 kztti szmok tallhatak, sszekeverve. A kilencedik mez az a bizonyos res mez, aminek mozgatsval sorba kell rendezni a mezkn tallhat szmokat. A ngyszer ngyes s tszr ts tblk sem sokban klnbznek az elstl, a ngyszer ngyesen 15, az tszr tsn 24 szmot kell sorba rendezni. +

+

+Plusz kiegszts, hogy a jtkos is ltrehozhat tblkat. Ehhez csak egy XML fjlt kell ksztenie, megadott szablyok szerint. Az egyes mezkn nem csak szmok szerepelhetnek, hanem brmilyen szveg/hang, amihez valamilyen sorrendet lehet trstani. J alternatv plda erre Budapest kerleteinek neve, ahol a sorrendet a kerlet szma adja meg. De egy dallam is kirakhat sorrendet kpez. +

+

+A tbla maximum tszr ts lehet, ennl nagyobb jtktr mr tlthatatlan lenne. Ha az XML fjl kevesebb, mint 24 elemet tartalmaz, a tblra felkerl megfelel szm joker mez, ami a hinyz elemek kiegsztsre szolgl. A sorba rendezskor csak arra kell figyelni, hogy az utols norml mez utn a jokerek kvetkezzenek s mindenkpp a tbla utols eleme legyen az res mez. Knnyts viszont, hogy ha tbb joker mez is tallhat a tbln, azokat nem kell sorrendbe lltani, a f kritrium csak annyi, hogy egymst kvessk, s a sorba rendezend mezk utn kvetkezzenek. +

+

+A mezk rtkei hangfjlokban troldnak, gy j tpus tbla ltrehozsakor a jtkosnak minden rtket rgztenie kell egy-egy hangfjlban. Ugyangy a jtk zenetei is egy-egy hangfjlban tallhatak, ezrt nyitott a lehetsg a Tilitoli ms nyelvekre val lefordtsra, vagy a httrzene s egyb hangok megvltoztatsra. +

+ +

2. A program hasznlata

+ +

2.1. Rendszerkvetelmnyek

+ +

+Az egyik taln legfontosabb kellk, a sztereo hangszr, vagy fl/fejhallgat, ez elengedhetetlen a jtkhoz. Fontos mg minimum 50 megabjtnyi memria, s minimum 1 ghz processzor. +

+

+Windows XP hasznlatakor a jtk csak akkor indul el, ha fel van teleptve a Microsoft Visual C++ 2008 Redistributable Package. +

+ +

2.2. Telepts

+ +

2.2.1. Windows

+ +

+A telept zeneteit vgigolvasva feltelepthet a jtk. Kivlaszthat a parancsikonok ltrehozsa az asztalon, megvltoztathat a program fknyvtra is. A telepts utn a parancsikonok segtsgvel elindthat a jtk. +

+ +

2.2.2. Linux

+ +

+A jtkhoz elengedhetetlen a Python s a Pygame ugyanezen verziinak meglte, a teleptst a terminlban a sudo apt-get install python, s sudo apt-get install python-pygame parancsokkal teheti meg. +

+

+A letlttt zip fjlt az unzip tilitoli0.x.x.zip paranccsal tmrtheti ki (a .x.x az aktulis verziszmot jelzi). +

+

+Miutn belpett a jtk mappjba (cd mappanv), a python tilitoli.py parancs kiadsval indthatja el a jtkot. +

+ +

2.3. Fmen

+ +

+A jtk indulsakor egy intr ksznti a jtkost, amin brmely billenty lenyomsval tovbbugorhat. Ekkor felhangzik a fmen zenje, s az els menpont neve (j jtk). A menben a fel s le nyilakkal mozoghat, ami ugyan a kpernyn nem ltszik, de a virtulis kurzor mozog. Egy menpontot enterrel nyithat meg. A fmenben t menpont tallhat: +

+ + + +

2.4. Plyavlaszt men

+ +

+Az j jtk menpont aktivlsval az elrhet plyk listja jelenik meg. Itt is a fel s le nyllal mozoghat, az enterrel indthatja el a jtkot. Ekkor a men zenje elhalkul, s betltdik a plya. +

+ +

2.5. A nyelvvlaszt men

+ +

+A menpont aktivlsakor megjelenik az elrhet nyelvek listja. Itt a fel s le nyilakkal mozoghat, egy nyelvet az enter billentyvel aktivlhat. Ekkor visszatr a fmenbe, s a jtk az adott nyelven fog megszlalni. A bellts a jtk bezrsig vagy annak megvltoztatsig rvnyes, az jbli indtskor az opercis rendszer alaprtelmezett nyelvn szlal meg. +

+ +

2.6. A plykrl

+ +

+A tbln val mozgs a kurzormozgat billentykkel lehetsges. A fel s le nyllal soronknt, a bal s jobbra nyllal oszloponknt mozog a virtulis kurzor. Igyekeztem ezt hanghatsokkal is szimullni, gy ha jobbra-balra mozog, az egyes oldalon a hangszrk hangereje vltozik, vagyis pl. teljesen baloldalon csak a bal hangszrbl jn a hang. +Az res mezt egy lesebb hanggal jellm, gy egyrtelmen meg lehet klnbztetni a tbbitl. Ha az res mez valamelyik szomszdjn ll a virtulis kurzor, az enter lenyomsra helyet cserl az res mezvel. A sikeres csert egy jl megklnbztethet hang jelzi, ezzel segtve a felhasznlt. Ha a tbla szln mozog, egy lesebb, csappan hangot hall. Ez a hromszor hrmas tblnl zavar lehet, de tszr tsnl nagyon hasznos. +

+

+Ha sikeresen kirakta a j sorrendet, a vgn megtudhatja hny lpsbl sikerlt megcsinlni. A lpsek szmt meghallgathatja az s billenty lenyomsval is. +

+

+Ha mg nem vgzett a jtkkal, de szeretn mskor folytatni, a v billenty lenyomsval elmentheti azt. Figyelem, egyszerre csak egy tbla llsait trolja a program! +

+ +

3. XML fjl elksztse

+ +

+Az XML fjlok minden nyelv mappjban (pl. locale\hu, locale\en, stb.) az xmls mappban tallhatk. Minden fjlhoz hozztartozik egy ugyanolyan nev .ogg fjl is, ami a plya nevt tartalmazza. Ha valamelyik fjl nem tallhat, a plya nem kerl bele a plyk listjba. +

+

+Jelenleg a program az XML fjlbl csak az ID s a Sound mezket hasznlja. A sound rtke a plya knyvtra/a mez neve, pl. a hromszor hrmasnl <sound>3x3/3.ogg</sound>. Fontos, hogy a Python a \ helyett /-t vr knyvtr elvlaszt jelknt. +

+ +

4. Billentyparancsok a jtkban

+ +

+Az tlthatsg kedvrt, itt megtallhat az sszes billentyparancs, ami hasznlhat a jtkban. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Billentyparancslers
HomeA menkben a legfels menpontra ugrik, a tbln a bal szls oszlopra.
endA menkben a legutols elemre ugrik, a tbln a jobb szls oszlopra.
enterA menkben aktivlja a kijellt menpontot, a jtkban az res s az adott mezt kicserli, ha lehetsges.
Fel nylFelfel mozog a menben s a jtktbln.
Le nylLefel mozog a menben s a jtktbln.
Balra nylA jtktbln az oszlopokon lpked bal irnyban.
Jobbra nylA jtktbln az oszlopokon lpked jobb irnyban.
Page upA jtktbln a legfels sorra ugrik.
Page downA jtktbln a legals sorra ugrik
rElhangzik a tbla azon sornak szma, ahol a virtulis kurzor ll.
cElhangzik a tbla azon oszlopnak szma, ahol a virtulis kurzor ll.
eMegismtli a virtulis kurzornl lv mez rtkt.
sBemondja az eddigi cserk szmt.
oVgigmondja az elemeket, a helyes sorrendben.
vElmenti a plya aktulis llst.
f2Meglltja a httrzene lejtszst.
F3Folytatja a httrzene lejtszst.
EscapeBezrja a plyt, a fmenben megnyomva kilp a jtkbl.
+ +

5. Tovbbfejlesztsi lehetsgek

+ +

+Rengeteg tletem van mg, amivel fejleszthetnm a jtkot, viszont tanulmnyaimbl kifolylag ezek eddig mg nem valsultak meg. Felmerlt a jtkosok versenyeztetse, vagyis a program egy sikeres jtk utn elklden egy szervernek az eredmnyeket (hny lpsbl rakta ki a felhasznl, mennyi id alatt, stb), amit egy program kirtkelne. +

+

+Az 5.1-es hangzs tlete is felvetdtt, gy a nagyobb plykon val mozgskor mg jobb hanghatsokat lehetne vele elrni. Ezt mr elkszti a hang lejtsz fggvny, gy a kzeljvben szeretnm ezt megvalstani. +

+

+A knnyebb plyaszerkeszts segtsre tervben van egy xml szerkeszt beleptse a jtkba, gy akik nem ismerik ezt a nyelvet, k is nagyon egyszeren tudnnak plykat kszteni. +

+

+Mivel a felhasznlkra van bzva a plyk elksztse, szeretnk egy interaktv weboldalt is csinlni, ahova feltlthetik a jtkosok a sajt kszts plykat, gy msoknak nem kellene feleslegesen dolgozniuk. +

+ +

6. Elrhetsgek

+ +

+A Tilitoli legfrissebb verzijt innen tltheti le. +

+

+E-mail: oaron1@gmail.com +

+ + + + diff -Nru tilitoli-0.8~ppa3/tilitoli/docs/hu.txt tilitoli-0.8~ppa4/tilitoli/docs/hu.txt --- tilitoli-0.8~ppa3/tilitoli/docs/hu.txt 2011-09-02 11:43:00.000000000 +0000 +++ tilitoli-0.8~ppa4/tilitoli/docs/hu.txt 1970-01-01 00:00:00.000000000 +0000 @@ -1,115 +0,0 @@ -Tilitoli (Sliding puzzle) dokumentáció -Készítette: Ócsvári Áron - -+ Bevezetés + -++ Tilitoli szabályai ++ - -A „Tilitoli” egy egyszemélyes logikai játék, amit 3x3, 4x4, vagy 5x5-ös méretû táblán játszanak. A táblán a mérettől függően, 9-25 mező található. A mezőkön egészszámok találhatóak, (1-8 1-15, 1-24) között, ezen felül egy üres mező. Az üres mezővel felcserélhetőek a körülötte lévő mezők. A játék kezdetekor a mezők elhelyezkedése véletlenszerû. A feladat az, hogy a számokat sorfolytonosan rendezze úgy, hogy az üres mező a tábla jobb alsó sarkában helyezkedjen el. - -++ A játékról ++ - -Az alapvető szabályok itt is megmaradtak, vagyis csak az üres mező mozgatásával lehet sorba rendezni a mezőket. A programban alapértelmezetten háromféle méretû tábla található. Ezekhez egy-egy teszt pálya tartozik, a többi a felhasználók által készült, amire ez a dokumentáció nem tér ki. - -A 3X3 táblán az 1-8 közötti számok találhatóak, összekeverve. A kilencedik mező az a bizonyos üres mező, aminek mozgatásával sorba kell rendezni a mezőkön található számokat. A négyszer négyes és ötször ötös táblák sem sokban különböznek az elsőtől, a négyszer négyesen 15, az ötször ötösön 24 számot kell sorba rendezni. - -Plusz kiegészítés, hogy a játékos is létrehozhat táblákat. Ehhez csak egy XML fájlt kell készítenie, megadott szabályok szerint. Az egyes mezőkön nem csak számok szerepelhetnek, hanem bármilyen szöveg/hang, amihez valamilyen sorrendet lehet társítani. Jó alternatív példa erre Budapest kerületeinek neve, ahol a sorrendet a kerület száma adja meg. De egy dallam is kirakható sorrendet képez. - -A tábla maximum ötször ötös lehet, ennél nagyobb játéktér már átláthatatlan lenne. Ha az XML fájl kevesebb, mint 24 elemet tartalmaz, a táblára felkerül megfelelő számú joker mező, ami a hiányzó elemek kiegészítésére szolgál. A sorba rendezéskor csak arra kell figyelni, hogy az utolsó normál mező után a jokerek következzenek és mindenképp a tábla utolsó eleme legyen az üres mező. Könnyítés viszont, hogy ha több joker mező is található a táblán, azokat nem kell sorrendbe állítani, a fő kritérium csak annyi, hogy egymást kövessék, és a sorba rendezendő mezők után következzenek. - -A mezők értékei hangfájlokban tárolódnak, így új típusú tábla létrehozásakor a játékosnak minden értéket rögzítenie kell egy-egy hangfájlban. Ugyanígy a játék üzenetei is egy-egy hangfájlban találhatóak, ezért nyitott a lehetőség a Tilitoli más nyelvekre való lefordítására, vagy a háttérzene és egyéb hangok megváltoztatására. - -+ A program használata + - -++ Rendszerkövetelmények ++ - -Az egyik talán legfontosabb kellék, a sztereo hangszóró, vagy fül/fejhallgató, ez elengedhetetlen a játékhoz. Fontos még minimum 50 megabájtnyi memória, és minimum 1 ghz processzor. - -Windows XP használatakor a játék csak akkor indul el, ha fel van telepítve a [Microsoft Visual C++ 2008 Redistributable Package http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=29]. - -++ Telepítés ++ - -+++ Windows +++ - -A telepítő üzeneteit végigolvasva feltelepíthető a játék. Kiválasztható a parancsikonok létrehozása az asztalon, megváltoztatható a program főkönyvtára is. A telepítés után a parancsikonok segítségével elindítható a játék. - -+++ Linux +++ - -A játékhoz elengedhetetlen a Python és a Pygame ugyanezen verzióinak megléte, a telepítést a terminálban a sudo apt-get install python, és sudo apt-get install python-pygame parancsokkal teheti meg. - -A letöltött zip fájlt az unzip tilitoli0.x.x.zip paranccsal tömörítheti ki (a .x.x az aktuális verziószámot jelzi). - -Miután belépett a játék mappájába (cd mappanév), a python tilitoli.py parancs kiadásával indíthatja el a játékot. - -++ Főmenü ++ - -A játék indulásakor egy intró köszönti a játékost, amin bármely billentyû lenyomásával továbbugorhat. Ekkor felhangzik a főmenü zenéje, és az első menüpont neve (Új játék). A menüben a fel és le nyilakkal mozoghat, ami ugyan a képernyőn nem látszik, de a „virtuális kurzor” mozog. Egy menüpontot enterrel nyithat meg. A főmenüben öt menüpont található: - -- Új játék: Ha erre egy entert nyom, a pályaválasztó menübe jut (erről a következő fejezetben írok). -- Hangszóró teszt: A játékban fontos, hogy tudjuk, merről szól a bal, és a jobb hangszóró. Ez főleg fülhallgatónál lehet fontos, ahol könnyen összecserélhető a két oldal. -- Nyelvválasztás: Itt a nyelvet állíthatja át másikra, ami a játék bezárásáig vagy az újbóli megváltoztatásig érvényben marad. -- Az elmentett játék visszatöltése: Ha elmentett egy állást, a menüpont aktiválásával visszatöltheti. -- Kilépés: A menüpont aktiválásakor lehalkul a zene, és bezárul a program. -- - -++ Pályaválasztó menü ++ - -Az „Új játék” menüpont aktiválásával az elérhető pályák listája „jelenik” meg. Itt is a fel és le nyíllal mozoghat, az enterrel indíthatja el a játékot. Ekkor a menü zenéje elhalkul, és betöltődik a pálya. - -++ A nyelvválasztó menü ++ - -A menüpont aktiválásakor megjelenik az elérhető nyelvek listája. Itt a fel és le nyilakkal mozoghat, egy nyelvet az enter billentyûvel aktiválhat. Ekkor visszatér a főmenübe, és a játék az adott nyelven fog megszólalni. A beállítás a játék bezárásáig vagy annak megváltoztatásáig érvényes, az újbóli indításkor az operációs rendszer alapértelmezett nyelvén szólal meg. - -++ A pályákról ++ - -A táblán való mozgás a kurzormozgató billentyûkkel lehetséges. A fel és le nyíllal soronként, a bal és jobbra nyíllal oszloponként mozog a virtuális kurzor. Igyekeztem ezt hanghatásokkal is szimulálni, így ha jobbra-balra mozog, az egyes oldalon a hangszórók hangereje változik, vagyis pl. teljesen baloldalon csak a bal hangszóróból jön a hang. -Az üres mezőt egy élesebb hanggal jelölöm, így egyértelmûen meg lehet különböztetni a többitől. Ha az üres mező valamelyik szomszédján áll a „virtuális kurzor”, az enter lenyomására helyet cserél az üres mezővel. A sikeres cserét egy jól megkülönböztethető hang jelzi, ezzel segítve a felhasználót. Ha a tábla szélén mozog, egy élesebb, csappanó hangot hall. Ez a háromszor hármas táblánál zavaró lehet, de ötször ötösnél nagyon hasznos. - -Ha sikeresen kirakta a jó sorrendet, a végén megtudhatja hány lépésből sikerült megcsinálni. A lépések számát meghallgathatja az s billentyû lenyomásával is. - -Ha még nem végzett a játékkal, de szeretné máskor folytatni, a v billentyû lenyomásával elmentheti azt. Figyelem, egyszerre csak egy tábla állásait tárolja a program! - -+ XML fájl elkészítése + - -Az XML fájlok minden nyelv mappájában (pl. locale\hu, locale\en, stb.) az xmls mappában találhatók. Minden fájlhoz hozzátartozik egy ugyanolyan nevû .ogg fájl is, ami a pálya nevét tartalmazza. Ha valamelyik fájl nem található, a pálya nem kerül bele a pályák listájába. - -Jelenleg a program az XML fájlból csak az ID és a Sound mezőket használja. A sound értéke a pálya könyvtára/a mező neve, pl. a háromszor hármasnál 3x3/3.ogg. Fontos, hogy a Python a \ helyett /-t vár könyvtár elválasztó jelként. - -+ Billentyûparancsok a játékban + - -Az átláthatóság kedvéért, itt megtalálható az összes billentyûparancs, ami használható a játékban. -|| Billentyûparancs | leírás | -| Home | A menükben a legfelső menüpontra ugrik, a táblán a bal szélső oszlopra. | -| end | A menükben a legutolsó elemre ugrik, a táblán a jobb szélső oszlopra. | -| enter | A menükben aktiválja a kijelölt menüpontot, a játékban az üres és az adott mezőt kicseréli, ha lehetséges. | -| Fel nyíl | Felfelé mozog a menüben és a játéktáblán. | -| Le nyíl | Lefelé mozog a menüben és a játéktáblán. | -| Balra nyíl | A játéktáblán az oszlopokon lépked bal irányban. | -| Jobbra nyíl | A játéktáblán az oszlopokon lépked jobb irányban. | -| Page up | A játéktáblán a legfelső sorra ugrik. | -| Page down | A játéktáblán a legalsó sorra ugrik -| r | Elhangzik a tábla azon sorának száma, ahol a „virtuális kurzor áll. | -| c | Elhangzik a tábla azon oszlopának száma, ahol a „virtuális kurzor áll. | -| e | Megismétli a „virtuális kurzornál” lévő mező értékét. | -| s | Bemondja az eddigi cserék számát. | -| o | Végigmondja az elemeket, a helyes sorrendben. | -| v | Elmenti a pálya aktuális állását. | -| f2 | Megállítja a háttérzene lejátszását. | -| F3 | Folytatja a háttérzene lejátszását. | -| Escape | Bezárja a pályát, a főmenüben megnyomva kilép a játékból. | - -+ Továbbfejlesztési lehetőségek + - -Rengeteg ötletem van még, amivel fejleszthetném a játékot, viszont tanulmányaimból kifolyólag ezek eddig még nem valósultak meg. Felmerült a játékosok versenyeztetése, vagyis a program egy sikeres játék után elküldené egy szervernek az eredményeket (hány lépésből rakta ki a felhasználó, mennyi idő alatt, stb), amit egy program kiértékelne. - -Az 5.1-es hangzás ötlete is felvetődött, így a nagyobb pályákon való mozgáskor még jobb hanghatásokat lehetne vele elérni. Ezt már előkészíti a hang lejátszó függvény, így a közeljövőben szeretném ezt megvalósítani. - -A könnyebb pályaszerkesztés segítésére tervben van egy xml szerkesztő beleépítése a játékba, így akik nem ismerik ezt a nyelvet, ők is nagyon egyszerûen tudnának pályákat készíteni. - -Mivel a felhasználókra van bízva a pályák elkészítése, szeretnék egy interaktív weboldalt is csinálni, ahova feltölthetik a játékosok a saját készítésû pályákat, így másoknak nem kellene feleslegesen dolgozniuk. - -+ Elérhetőségek + - -A Tilitoli legfrissebb verzióját [innen töltheti le. http://audiopuzzle.googlecode.com] - -E-mail: oaron1@gmail.com - diff -Nru tilitoli-0.8~ppa3/tilitoli/docs/txt2tags.py tilitoli-0.8~ppa4/tilitoli/docs/txt2tags.py --- tilitoli-0.8~ppa3/tilitoli/docs/txt2tags.py 2011-09-01 10:48:32.000000000 +0000 +++ tilitoli-0.8~ppa4/tilitoli/docs/txt2tags.py 1970-01-01 00:00:00.000000000 +0000 @@ -1,5987 +0,0 @@ -#!/usr/bin/env python -# txt2tags - generic text conversion tool -# http://txt2tags.org -# -# Copyright 2001-2010 Aurelio Jargas -# -# License: http://www.gnu.org/licenses/gpl-2.0.txt -# Subversion: http://svn.txt2tags.org -# Bug tracker: http://bugs.txt2tags.org -# -######################################################################## -# -# BORING CODE EXPLANATION AHEAD -# -# Just read it if you wish to understand how the txt2tags code works. -# -######################################################################## -# -# The code that [1] parses the marked text is separated from the -# code that [2] insert the target tags. -# -# [1] made by: def convert() -# [2] made by: class BlockMaster -# -# The structures of the marked text are identified and its contents are -# extracted into a data holder (Python lists and dictionaries). -# -# When parsing the source file, the blocks (para, lists, quote, table) -# are opened with BlockMaster, right when found. Then its contents, -# which spans on several lines, are feeded into a special holder on the -# BlockMaster instance. Just when the block is closed, the target tags -# are inserted for the full block as a whole, in one pass. This way, we -# have a better control on blocks. Much better than the previous line by -# line approach. -# -# In other words, whenever inside a block, the parser *holds* the tag -# insertion process, waiting until the full block is read. That was -# needed primary to close paragraphs for the XHTML target, but -# proved to be a very good adding, improving many other processing. -# -# ------------------------------------------------------------------- -# -# These important classes are all documented: -# CommandLine, SourceDocument, ConfigMaster, ConfigLines. -# -# There is a RAW Config format and all kind of configuration is first -# converted to this format. Then a generic method parses it. -# -# These functions get information about the input file(s) and take -# care of the init processing: -# get_infiles_config(), process_source_file() and convert_this_files() -# -######################################################################## - -#XXX Python coding warning -# Avoid common mistakes: -# - do NOT use newlist=list instead newlist=list[:] -# - do NOT use newdic=dic instead newdic=dic.copy() -# - do NOT use dic[key] instead dic.get(key) -# - do NOT use del dic[key] without has_key() before - -#XXX Smart Image Align don't work if the image is a link -# Can't fix that because the image is expanded together with the -# link, at the linkbank filling moment. Only the image is passed -# to parse_images(), not the full line, so it is always 'middle'. - -#XXX Paragraph separation not valid inside Quote -# Quote will not have

inside, instead will close and open -# again the
. This really sux in CSS, when defining a -# different background color. Still don't know how to fix it. - -#XXX TODO (maybe) -# New mark or macro which expands to an anchor full title. -# It is necessary to parse the full document in this order: -# DONE 1st scan: HEAD: get all settings, including %!includeconf -# DONE 2nd scan: BODY: expand includes & apply %!preproc -# 3rd scan: BODY: read titles and compose TOC info -# 4th scan: BODY: full parsing, expanding [#anchor] 1st -# Steps 2 and 3 can be made together, with no tag adding. -# Two complete body scans will be *slow*, don't know if it worths. -# One solution may be add the titles as postproc rules - - -############################################################################## - -# User config (1=ON, 0=OFF) - -USE_I18N = 1 # use gettext for i18ned messages? (default is 1) -COLOR_DEBUG = 1 # show debug messages in colors? (default is 1) -BG_LIGHT = 0 # your terminal background color is light (default is 0) -HTML_LOWER = 0 # use lowercased HTML tags instead upper? (default is 0) - -############################################################################## - - -# These are all the core Python modules used by txt2tags (KISS!) -import re, os, sys, time, getopt - -# The CSV module is new in Python version 2.3 -try: - import csv -except ImportError: - csv = None - -# Program information -my_url = 'http://txt2tags.org' -my_name = 'txt2tags' -my_email = 'verde@aurelio.net' -my_version = '2.6' - -# i18n - just use if available -if USE_I18N: - try: - import gettext - # If your locale dir is different, change it here - cat = gettext.Catalog('txt2tags',localedir='/usr/share/locale/') - _ = cat.gettext - except: - _ = lambda x:x -else: - _ = lambda x:x - -# FLAGS : the conversion related flags , may be used in %!options -# OPTIONS : the conversion related options, may be used in %!options -# ACTIONS : the other behavior modifiers, valid on command line only -# MACROS : the valid macros with their default values for formatting -# SETTINGS: global miscellaneous settings, valid on RC file only -# NO_TARGET: actions that don't require a target specification -# NO_MULTI_INPUT: actions that don't accept more than one input file -# CONFIG_KEYWORDS: the valid %!key:val keywords -# -# FLAGS and OPTIONS are configs that affect the converted document. -# They usually have also a --no-