User:Fpuelz: Difference between revisions

From KDE UserBase Wiki
m (Changed the "using the dictionary" section to "managing...")
No edit summary
 
(18 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Template:I18n/Language Navigation Bar|KrossWordPuzzle}}
 


{|style="text-align:center;" cellpadding="2"
{|style="text-align:center;" cellpadding="2"
Line 7: Line 7:
==Introduction==
==Introduction==
You can use KrossWordPuzzle to play crosswords or to create new crosswords. It can open and save *.puz-files (AcrossLite) and it's own *.kwp files (which are XML files) or *.kwpz (which are compressed *.kwp files). You can download lots of crosswords from within the game.
You can use KrossWordPuzzle to play crosswords or to create new crosswords. It can open and save *.puz-files (AcrossLite) and it's own *.kwp files (which are XML files) or *.kwpz (which are compressed *.kwp files). You can download lots of crosswords from within the game.
KrossWordPuzzle is a community app {{Community-app}}.


==Screenshots==
==Screenshots==
[[Image:krosswordpuzzle_play_print.jpg|thumb]]
'''TODO: More screenshots'''
[[Image:krosswordpuzzle_play_print.jpg|350px|center|thumb]]


==Features==
==Features==
::* '''Different crossword types:''' American, Swedish, Number Puzzle and Crossnumber. User defined types are also possible based on a set of rules. Barred crosswords can be played/designed (bars added automatically).
::* '''Many crossword types:'''
::* A '''library''', to store crosswords in
::** ''American''
::* Load different file formats (.puz, .kwp, .kwpz)
::** ''Swedish''
::* Export to many file formats (.puz, .kwp, .kwpz, .pdf, .ps, .png, .jpg)
::** ''Number Puzzle''
::* Download lots of PUZ-files from the Internet.
::** ''Crossnumber''
::* '''Thumb creator''' for crossword files. It's used to get thumbnails for crosswords in the library. Can also be enabled for crossword files in dolphin.
::** ''User defined'' crossword types based on a set of rules
 
::** ''Barred crosswords'' can be played/designed in each type (bars added automatically)
::* '''Print''' crosswords, print preview.
::** See [[User:Fpuelz/Crossword_Types|Crossword Types]] for a detailed description of the different crossword types
::* Export to PDF, Postscript, PNG, JPEG.
 
::* Themes. There are currently three themes available: Default, Scribble and an Egyptian theme.
::* Give hints, check and solve crosswords.
::* Set confidence values for filled out letter cells.
::* Image cells, which can be stretched across multiple cells. Can display local or remote images.
::* Double clue cells, two (half) clue cells inside one cell in the crossword grid.
::* A solution word can be defined by converting some letter cells to "solution letter cells" in edit mode. The solution word is displayed in a toolbar, focus and current letters are synchronized between the solution letter cells in the toolbar and the ones in the crossword.
::* Erasor tool to clear letter cells / whole clue answers.
::* Clue list in a dock, which also shows the current answers.
::* '''Edit crosswords''' (edit mode). You can add/remove/change clues and images, change correct letters, convert between crossword types, resize the crossword grid or move all cells in the grid. Clue cells can be hidden or shown with the clue text in it, useful for german/swedish/? crosswords.
::* Undo/redo for all edit actions. The undo stack can also be saved with the crossword in XML files.
::* A '''dictionary''' to find matching answers for new clues. The dictionary database (MySQL) can be filled from plain text dictionaries, crossword files or cvs-files. You can search for answers using wildcard patterns. Those patterns are automatically generated based on the letters that are already in the crossword, therefore matching answers are automatically offered when adding new clues.
::* '''Templates''' for new crosswords.
::* Interactively change answer-lengths by dragging a bar after the last letter cell of a clue.
::* Check for 180 degree rotation symmetry, view statistics.
::* Restore lost crosswords after a crash of the game (hopefully there is none ;)).


==Using KrossWordPuzzle==
::* '''Many cell types:'''
===Library===
::** ''Empty Cells''
The library is shown after the game has started. If it's not shown, you can always switch back to the library by using the Library-tab on top:
::** ''Letter Cells''
::** ''Clue Cells'' (containing the clue text, eg. for swedish crosswords)
::** ''Double Clue Cells'' (two half clue cells inside one cell in the crossword grid)
::** ''Image cells'' (can be stretched across multiple cells, can display local or remote images)
::** ''Solution Letter Cells'' (all solution letter cells of a crossword form it's solution word)


[[Image:krosswordpuzzle_menu.jpg]]
::* A '''Library''', to store crosswords in
::** Add crosswords in ''different file formats'' to the library (.puz, .kwp, .kwpz)
::** ''Download'' lots of .puz-crosswords from the Internet directly into the library
::** ''Export'' to many file formats (.puz, .kwp, .kwpz, .pdf, .ps, .png, .jpg)
::** ''Thumb creator'' for crossword files. It's used to get thumbnails for crosswords in the library. Can also be enabled for crossword files in dolphin.


The library shows all your crosswords. In the toolbar of the library you have some options to fill your library: Download, Import, New Crossword. There are also options to organize your library: Delete, New Folder. Some buttons need a crossword to be selected.
::* '''Print''' crosswords, print preview


[[Image:krosswordpuzzle_library_toolbar.jpg]]
::* '''Themes'''. There are currently three themes available: Default, Scribble and an Egyptian theme.


::* Features in '''Playing Mode''' (edit mode not enabled)
::** Give ''hints'', ''check'' and ''solve'' whole crosswords or single answers/letters
::** Set ''confidence values'' for filled out letter cells
::** ''Clue list'' in a dock, which also shows the current answers
::** ''Eraser tool'' to clear letter cells / whole clue answers
::** ''Context menus'' for all cells
::** ''Easy navigation'' using the mouse and/or the keyboard, there are also navigation commands in the Move menu and in the toolbar
::** ''Fill out crosswords'' by selecting clues and writing the answer with the keyboard directly in the crossword view
::* '''Edit crosswords''' (edit mode)
::** ''Add / remove / change'' clues and images
::** Change ''correct letters''
::** ''Interactively change selected cells'' in a dock (clue texts / orientation / answer offset / dictionary / ..., image sources / cell span / ...)
::** ''Convert'' between crossword types
::** ''Resize'' the crossword grid
::** ''Move all cells'' in the grid
::** Interactively change ''answer-lengths'' by dragging a bar after the last letter cell of a clue
::** Check for ''180 degree rotation symmetry''
::** View ''statistics''
::** ''Templates'' for new crosswords
::** ''Undo / redo'' for all edit actions. The undo stack can also be saved with the crossword in XML files
::** A ''dictionary'' to find matching answers for new clues
::** A ''solution word'' can be defined by converting some letter cells to "solution letter cells". The solution word is displayed in a toolbar
::** ''Context menus'' for editing


====Downloading crosswords====
::* '''Restore lost crosswords''' after a crash of the game (hopefully there is none ;)).
In the library click '''Download''' to open the download dialog. Select a provider to show a list of offered crosswords. A preview is shown for the selected crossword. To find a specific crossword you can use the search line.
You can change the target folder for downloaded crosswords at the bottom of the download dialog.
Click '''Ok''' to download the selected crossword.
 
::[[Image:krosswordpuzzle_dialog_download.jpg|thumb|The download dialog]]
 
 
====Importing crosswords====
In the library click '''Import''' to import local crossword files to your library. You can also add crosswords to the library by dropping files, eg. from dolphin. The following file formats are supported:
::* '''.puz''' (AcrossLite)
::* '''.kwp''' (for '''k'''ross-'''w'''ord-'''p'''uzzle)
::* '''.kwpz''' (compressed .kwp-files)
 
 
====Exporting crosswords====
In the library click '''Export''' to export the selected crossword. The following file formats are supported for exporting:
::* '''.puz''' (AcrossLite)
::* '''.kwp''' (for '''k'''ross-'''w'''ord-'''p'''uzzle)
::* '''.kwpz''' (compressed .kwp-files)
::* '''.pdf''' (Acrobat Reader, Okular, ...)
::* '''.ps''' (Post script)
::* '''.png''' (Image format)
::* '''.jpg''' (Image format)
 
 
====Creating new crosswords====
In the library click '''New Crossword''', which will open a dialog. In the '''General''' tab you can choose a crossword type and set some information like the authors name (you) or the size of the crossword. You can also create user defined crossword types. All settings can be changed later via '''Edit -> Crossword Properties...'''.
 
::[[Image:krosswordpuzzle_dialog_newcrossword_1.jpg|thumb|The general tab of the create new dialog]]
 
 
In the '''Template''' tab you can choose to use a template. Templates are complete crosswords, but without clue texts or answer letters. You can use them to quickly create new crosswords by just filling in the clues. If you have a good [[#Using_the_Dictionary|dictionary]] this can be really easy.
 
::[[Image:krosswordpuzzle_dialog_newcrossword_2.jpg|thumb|The template tab of the create new dialog]]
 
After clicking '''Ok''' the new crossword is created and shown in edit mode. See [[#Editing_Crosswords|Editing Crosswords]] to see how to edit that new crossword.
 
 
====Organize your library====
In the library click '''Delete''', to delete the selected crossword from the library. You can also delete a folder from the library. This will delete all contained crosswords in that folder.
To create new folders click '''New Folder''', which will ask you for a name for the new folder.
 
 
 
===Playing Crosswords===
::{|cellpadding="2"
|[[Image:Im-status-message-edit.png]]||'''TODO'''||Write text here :)
|}
 
 
===Editing Crosswords===
::{|cellpadding="2"
|[[Image:Im-status-message-edit.png]]||'''TODO'''||Write text here :)
|}
 
 
====Managing the Dictionary====
First you need to have a MySQL server installed and running. '''TODO: More text here...'''
 
You can open the dictionary dialog via '''Settings -> Dictionary...'''.


::[[Image:krosswordpuzzle_dialog_dictionary.jpg|thumb|The dictionary dialog]]
==More Help is on these Pages==
* [[User:Fpuelz/Using_KrossWordPuzzle|Using KrossWordPuzzle]] - Solve crosswords or create new ones


On the right of the dialog you can see a list of all words in your dictionary. Each word can have an associated clue text.
==[[User:Fpuelz/Using_KrossWordPuzzle|Using KrossWordPuzzle]]==
On the left you can see a toolbox with three sections: '''Fill Dictionary''', '''Edit''' and '''Backup'''.
{{info|This chapter explains the '''use''' of KrossWordPuzzle as game and as crossword creator/editor.  


To add words with their clue texts from existing crosswords you can use '''Extract From Library''', which extracts all words from all crosswords in your library or '''Extract From Crosswords...''', which lets you choose crossword files to extract words from. You can also add words (without clue texts) from plain text dictionary files using '''Add Words From Dictionary...'''. Normally /usr/dict or /usr/share/dict contains such dictionaries.
[[User:Fpuelz/Using_KrossWordPuzzle|Go to this chapter]]}}
'''TODO: Higher resolution'''
[[Image:krosswordpuzzle_use_screenie.png|550px|center|thumb]]


To add single words use '''Add Entry''' from the '''Edit''' section. Change the word directly in the list. To remove all selected words from the dictionary use '''Remove Selected''', to clear the dictionary use '''Clear Dictionary'''.
==[[User:Fpuelz/Settings|Settings]]==
{{info|This chapter explains the '''settings''' of KrossWordPuzzle.


The '''Backup''' section contains two buttons: '''Import (CSV)...''' and '''Export (CSV)...'''. These can be used to import/export the dictionary to/from comma seperated files (CSV). CSV-Files can also be imported with spread sheet applications. You can use those files as backup or to share your dictionary with others.
[[User:Fpuelz/Settings|Go to this chapter]]}}
'''TODO: Higher resolution'''
[[Image:krosswordpuzzle_settings_screenie.png|400px|center|thumb]]


==[[User:Fpuelz/Crossword_Types|Crossword Types]]==
{{info|This chapter gives an '''overview of supported crossword types''' and information on how to '''create a custom crossword type''' based on a set of rules.


====Using the Dictionary====
[[User:Fpuelz/Crossword_Types|Go to this chapter]]}}
'''TODO: Description of adding clues using the dictionary'''
'''TODO: Higher resolution'''
[[Image:krosswordpuzzle_types_screenie.png|550px|center|thumb]]






==Crossword Types==
::{|cellpadding="2"
|[[Image:Im-status-message-edit.png]]||'''TODO'''||Write text here :)
|}




'''KrossWordPuzzle has a page on ''[http://kde-apps.org/content/show.php?content=111726 kde-apps.org]''''', where you can download the latest sources and binary packages for various distributions.
{{Community-app-footnote}}
{{Community-app-footnote}}


[[Category:Games]]
[[Category:Games]]

Latest revision as of 15:54, 16 June 2011


KrossWordPuzzle is a crossword playing game and editor.

Introduction

You can use KrossWordPuzzle to play crosswords or to create new crosswords. It can open and save *.puz-files (AcrossLite) and it's own *.kwp files (which are XML files) or *.kwpz (which are compressed *.kwp files). You can download lots of crosswords from within the game.

KrossWordPuzzle is a community app  See footnote .

Screenshots

TODO: More screenshots

Features

  • Many crossword types:
    • American
    • Swedish
    • Number Puzzle
    • Crossnumber
    • User defined crossword types based on a set of rules
    • Barred crosswords can be played/designed in each type (bars added automatically)
    • See Crossword Types for a detailed description of the different crossword types
  • Many cell types:
    • Empty Cells
    • Letter Cells
    • Clue Cells (containing the clue text, eg. for swedish crosswords)
    • Double Clue Cells (two half clue cells inside one cell in the crossword grid)
    • Image cells (can be stretched across multiple cells, can display local or remote images)
    • Solution Letter Cells (all solution letter cells of a crossword form it's solution word)
  • A Library, to store crosswords in
    • Add crosswords in different file formats to the library (.puz, .kwp, .kwpz)
    • Download lots of .puz-crosswords from the Internet directly into the library
    • Export to many file formats (.puz, .kwp, .kwpz, .pdf, .ps, .png, .jpg)
    • Thumb creator for crossword files. It's used to get thumbnails for crosswords in the library. Can also be enabled for crossword files in dolphin.
  • Print crosswords, print preview
  • Themes. There are currently three themes available: Default, Scribble and an Egyptian theme.
  • Features in Playing Mode (edit mode not enabled)
    • Give hints, check and solve whole crosswords or single answers/letters
    • Set confidence values for filled out letter cells
    • Clue list in a dock, which also shows the current answers
    • Eraser tool to clear letter cells / whole clue answers
    • Context menus for all cells
    • Easy navigation using the mouse and/or the keyboard, there are also navigation commands in the Move menu and in the toolbar
    • Fill out crosswords by selecting clues and writing the answer with the keyboard directly in the crossword view
  • Edit crosswords (edit mode)
    • Add / remove / change clues and images
    • Change correct letters
    • Interactively change selected cells in a dock (clue texts / orientation / answer offset / dictionary / ..., image sources / cell span / ...)
    • Convert between crossword types
    • Resize the crossword grid
    • Move all cells in the grid
    • Interactively change answer-lengths by dragging a bar after the last letter cell of a clue
    • Check for 180 degree rotation symmetry
    • View statistics
    • Templates for new crosswords
    • Undo / redo for all edit actions. The undo stack can also be saved with the crossword in XML files
    • A dictionary to find matching answers for new clues
    • A solution word can be defined by converting some letter cells to "solution letter cells". The solution word is displayed in a toolbar
    • Context menus for editing
  • Restore lost crosswords after a crash of the game (hopefully there is none ;)).

More Help is on these Pages

Using KrossWordPuzzle

Information

This chapter explains the use of KrossWordPuzzle as game and as crossword creator/editor. Go to this chapter

TODO: Higher resolution

Settings

Information

This chapter explains the settings of KrossWordPuzzle. Go to this chapter

TODO: Higher resolution

Crossword Types

Information

This chapter gives an overview of supported crossword types and information on how to create a custom crossword type based on a set of rules. Go to this chapter

TODO: Higher resolution



KrossWordPuzzle has a page on kde-apps.org, where you can download the latest sources and binary packages for various distributions.


Support for this application can be found from the project's home page