diff options
author | gregory guy <[email protected]> | 2019-11-01 11:46:21 +0100 |
---|---|---|
committer | Michele Calgaro <[email protected]> | 2019-11-04 22:15:53 +0900 |
commit | a5293a4305b4cefdbd8827a3248915f08c958918 (patch) | |
tree | 951fe4bce963c896be0c80f270599c9db7b961f8 /doc | |
parent | ec3ad1da018999fc627db82f9778ebf28da0aedf (diff) | |
download | knights-a5293a4305b4cefdbd8827a3248915f08c958918.tar.gz knights-a5293a4305b4cefdbd8827a3248915f08c958918.zip |
Drop automake build support.
Add basic cmake build instructions in the INSTALL file.
Rework of README file and the help page.
The History file has been removed, the content added to the
ChangeLog file.
The file CreatingThemes has moved in the doc folder.
Cosmetic changes in CMakeLists.txt .
Signed-off-by: gregory guy <[email protected]>
(cherry picked from commit 873d0e4138a1569d2a8dfa061d0338b6d017dd3b)
Diffstat (limited to 'doc')
-rw-r--r-- | doc/CreatingThemes | 176 | ||||
-rw-r--r-- | doc/Makefile.am | 6 | ||||
-rw-r--r-- | doc/en/Makefile.am | 2 | ||||
-rw-r--r-- | doc/en/index.docbook | 35 |
4 files changed, 183 insertions, 36 deletions
diff --git a/doc/CreatingThemes b/doc/CreatingThemes new file mode 100644 index 0000000..f19cc9a --- /dev/null +++ b/doc/CreatingThemes @@ -0,0 +1,176 @@ +==================== + Creating Themes +==================== + +This document is your guide to creating themes for the Knights chess +interface. + +----------------------- +1. Anatomy of a Theme: +----------------------- + +A theme is a collection of images, sounds, and settings which create a +unique representation of a chess environment. Typically, this theme is in the +form of a gzipped tarball. + +There are three types of themes for Knights: Chessboard themes, Chessmen +themes, and Audio themes. + +------------------------ +2. Tarball Information: +------------------------ + +Themes must be stored in tarballs. Knights will use any type of tarball that +KDE supports. A good test is to try loading it in Konqueror using a +tar://mytarball URL. Generaly speaking, using the standard gzipped tarball +( with a '.tar.gz' extension ) will be fine. + +The first two letters of your filename must be 'KB', 'KC', or 'KS' depending on +the type of theme it is. KB tells Knights that it is a Chessboard theme, +and KC represents Chessmen themes. KS is a sound theme. This is +case-sensitive. + +Between the prefix and the extension comes your theme's name. Write it exactly +how you want it displayed in Knights, except use underscores instead of spaces. +So if you want your theme to be called "My Uber Chessmen" within Knights, you'd +have the following filename: KCMy_Uber_Chessmen.tar.gz + +As a general rule, you should remove write and execute permissions on the +files, and either remove Owner/Group attributes, or make them something +harmless ( like nobody:users ) + +--------------------------- +3. theme.conf Information: +--------------------------- + +Every theme must contain a text file called 'theme.conf'. Here's a +sample theme.conf file: + +################################ +# A Sample theme.conf file +################################ +[General] +Type=Board +Name=Default +Version=1.0 +Author=Troy Corbin Jr. +AuthorWWW=http://knights.sourceforge.net +Notes=This is the default chessboard for Knights. It was made with the Gimp. + +[2DWhite] +King=white.king.png +Queen=white.queen.png +Bishop=white.bishop.png +Knight=white.knight.png +Rook=white.rook.png +Pawn=white.pawn.png + +[2DBlack] +King=black.king.png +Queen=black.queen.png +Bishop=black.bishop.png +Knight=black.knight.png +Rook=black.rook.png +Pawn=black.pawn.png + +[2DBoard] +Light=square.light.png +Dark=square.dark.png +Motion=square.motion.png +Select=square.select.png +Danger=square.danger.png + +[Coordinates] +TextColor=255,255,255 +ShadowColor=0,0,0 + +[Audio] +Select=select.wav +Move=move.wav +Check=check.wav +MatchOver=matchover.wav +Challenge=notify.wav +Tell=tell.wav +Notification=notify.wav +DrawOffer=draw.wav +Say=tell.wav +Promote=promote.wav +################################ + +Nothing too tough to figure out. 'Type' must be one of the following: + +- Board +- Chessmen +- Audio +- 3DBoard ( For future use ) +- 3DChessmen ( For future use ) + +'Name' is your theme's name and 'Version' is the version of your theme. Author, +AuthorEmail, and AuthorWWW should be self explanitory. Notes are any comments +you want to add. + +The '2DWhite' and '2DBlack' sections are required in Chessman themes. Each line +specifies the file to be used for each different piece type. + +'2DBoard' and 'Coordinates' are required in Chessboard themes. 'Light' and +'Dark' specify the file to be used for each color square on the board. 'Motion' +is the highlight used to indicate that a piece moved, 'Select' is the selection +highlight, and 'Danger' indicates an attacked piece. The 'Coordinates' are +standard 8bit RGB colors. These are the colors that Knights will use for board +coordinates. Try to use colors that contrast with the board itself. + +New in Knights 0.5.6 are Chessboard borders. They are not required, but they +can greatly enhance the appearance of your chessboard. If you'd like to use one +then under '2DBoard' add the following lines: + +HaveBorder=true +Border=border.png +BorderLightOn=light_on.png +BorderLightOff=light_off.png + +----------------------- +4. Pixmap Information: +----------------------- + +Your pixmaps can be in any format that Qt supports, as long as it supports an +alpha channel. For this reason you are strongly encouraged to stick with PNG +images. Note that there are a few exceptions to this in Chessboard themes. The +'Light', 'Dark', and 'Border' pixmaps constitute the lowest layer of graphics, +and so they will never be transparent. Therefore, for these items you can use +non-transparent file types ( like JPEG ). + +Knights will scale your pixmaps to the current theme size. This means you can +supply any sized images you want and Knights will make it work. However, when +Knights has to enlarge a pixmap, the resulting image tends to be of poor +quality. To keep this from happening to your themes, you should make all your +pixmaps 144 pixels by 144 pixels. This ensures that your images will never be +enlarged, and it's not so large that it's wasteful. + +Borders are an exception to the size rule. The 'Border' itself needs to be 9 +times the size of your other images. So if you use the recommended 144 pixel +image size, the 'Border' needs to be 1296 pixels. Likewise, the 'BorderLightOn' +and 'BorderLightOff' images need to be half the size of your other images. So +a regular size image of 144 pixels required that the lights be 72 pixels. + +---------------------- +5. Audio Information: +---------------------- + +Like pixmaps, you can supply your audio using any file format that aRts +supports. I recommend you stick with .wav and .ogg, although the last time +I checked aRts' Ogg Vorbis support was flaky with short sounds. Also, for +very short sounds, .wav files are actually smaller. It's best to try both +and see which works best with your paticular sounds. + +---------------------- +6. Copyrights: +---------------------- + +If you're planning to share your themes with the Knights Project, you must be +the copyright owner on all the material contained in the theme. As much as I'd +love to see the heads of Neo and Agent Smith flying around the board, I don't +want to recieve any nasty letters from Warner Brothers. + +Your material must also be released under a GNU or similar license. If you're +in doubt, contact us and we'll work it out. diff --git a/doc/Makefile.am b/doc/Makefile.am deleted file mode 100644 index 23a795e..0000000 --- a/doc/Makefile.am +++ /dev/null @@ -1,6 +0,0 @@ -# the SUBDIRS is filled automatically by am_edit. If files are -# in this directory they are installed into the english dir - -KDE_LANG = en -KDE_DOCS = knights -SUBDIRS = $(AUTODIRS) diff --git a/doc/en/Makefile.am b/doc/en/Makefile.am deleted file mode 100644 index 20beda9..0000000 --- a/doc/en/Makefile.am +++ /dev/null @@ -1,2 +0,0 @@ -KDE_DOCS = knights -KDE_LANG = en diff --git a/doc/en/index.docbook b/doc/en/index.docbook index 99b75a3..4719246 100644 --- a/doc/en/index.docbook +++ b/doc/en/index.docbook @@ -43,12 +43,12 @@ </releaseinfo> <abstract> <para> - Knights is a graphical chess interface for &kde;. It supports chess matches against computer engines like GNUChess and Crafty, watching two computer engines play against each other, solitaire chess, matches played via Internet Chess Servers, and reviewing matches saved in Portable Game Notation. + Knights is a graphical chess interface for &tde;. It supports chess matches against computer engines like GNUChess and Crafty, watching two computer engines play against each other, solitaire chess, matches played via Internet Chess Servers, and reviewing matches saved in Portable Game Notation. </para> </abstract> <keywordset> <keyword>knights</keyword> - <keyword>KDE</keyword> + <keyword>TDE</keyword> <keyword>game</keyword> <keyword>chess</keyword> <keyword>gnuchess</keyword> @@ -589,46 +589,25 @@ <sect1 id="installation-obtain-knights"> <title>How to obtain Knights</title> <para> - The Knights Project is located at <ulink url="http://knights.sourceforge.net/">http://knights.sourceforge.net</ulink>. It will usually contain the most up-to-date information on Knights available. + The Knights Project is holded at <ulink url="http://trinitydesktop.org/">http://trinitydesktop.org</ulink>. It will usually contain the most up-to-date information on Knights available. </para> <note> <para> - If you're using the <ulink url="http://www.opennic.org/">OpenNIC</ulink> root service, then you can reach the Knights Project at <ulink url="http://www.knights.oss/">http://www.knights.oss</ulink>. + A developer area is available at <ulink url="https://mirror.git.trinitydesktop.org/gitea">TDE Gitea Workspace (TGW)</ulink>. + A translator area is available at <ulink url="https://mirror.git.trinitydesktop.org/weblate/">TDE Weblate Translation Workspace (TWTW)</ulink>. </para> </note> </sect1> <sect1 id="installation-requirements"> <title>Requirements</title> <para> - Before you can install Knights, you must have the Trinity Desktop Environment installed on your system. Knights also requires that you have <ulink url="http://www.gnu.org/directory/Software_development/Program_build_automation/autoconf.html">Autoconf</ulink> version 2.5 and <ulink url="http://www.gnu.org/directory/Software_development/Program_build_automation/automake.html">Automake</ulink> version 1.6. + Before you can install Knights, you must have the Trinity Desktop Environment installed on your system. Knights also requires that you have cmake (version >= 2.8) as building tool. </para> </sect1> <sect1 id="installation-compilation"> <title>Compilation and Installation</title> <para> - Knights uses <application>autoconf</application> and <application>automake</application> to ensure that compiling is easy. If for some reason Knights won't compile for you, help is available at the Knights Project website located at <ulink url="http://knights.sourceforge.net/">http://knights.sourceforge.net</ulink>. - </para> - <para> - You must have the TDEDIR environment variable defined before you begin the installation. Without this, Knights will not be able to access it's resources! To add the TDEDIR environment variable, you need to edit your /etc/profile ( or ~/.bash_profile ) and add the line: - </para> - <para> - <userinput><command>export TDEDIR="/usr"</command></userinput> - </para> - <para> - ...where /usr is your KDE's base directory. - </para> - <para> - Now, change the present working directory to the location where you unarchived Knights and type the following: - </para> -<informalexample> -<screen width="40"> -<prompt>%</prompt> <userinput><command>./configure</command></userinput> -<prompt>%</prompt> <userinput><command>make</command></userinput> -<prompt>%</prompt> <userinput><command>make</command> <option>install</option></userinput> -</screen> -</informalexample> - <para> - Knights should now be installed and ready to go. You can type <userinput><command>knights</command></userinput> in a terminal to start the game, or create an icon for it and select that. + Knights uses cmake to ensure that compiling is easy. Please read the INSTALL file for the basics and the suggested default options. </para> </sect1> </appendix> |