Skip to content

mmlacak/crochess

Repository files navigation

Download the book! Thank you for your donations! Read it all on the blog! Thank you for your donations!

Croatian Chess - book and console application

Croatian Chess is a collection of various chess variants, starting as a simple and natural enhancement to classical chess and growing ever more complex with each new variant.

Versions

Book version can be seen in a colophon (4th page), under Source section.
The most recent book version is:

Version: 20240511.050952

Large number is actually date and time of the last commit, converted to UTC for easier comparison.

Application and library versions can be seen in an application, using version command.
The latest versions are:

Application: 0.0.1.534:966+20240511.171740
Library: 0.0.1.534:966+20240511.171740

Versioning used is Natural Versioning 1.2, with meta data containing the same format as the book version.

Getting Started

To read the book, click download PDF file.

To compile book yourself, you'll need to generate images, and then compile text and those images into PDF file.

Prerequisites

To make images used in the book, install these:

  • Python 3 (3.8.5)
  • pycairo (1.18.2)
  • GTK+ cairo (1.16.0)

Versions in brackets are those I was using, newer versions also work.
Older versions should work, since nothing too fancy was used from those dependencies.

To compile book itself into PDF, you'll need minimal LaTeX installation, with following packages:

  • inputenc
  • charter
  • helvet
  • geometry
  • graphicx
  • wrapfig
  • hyperref
  • multirow
  • booktabs
  • alltt

Installing

First, clone repository with:

git clone https://github.com/mmlacak/crochess.git

Or, you could just unpack downloaded zip file into a folder.

Compiling the book

Open terminal in folder where you've cloned/unzipped repository, and type:

./gfx.sh

This will generate all the images used in the book.

Next, compile PDF file:

./pdf.sh

If everything goes well, the new book will be created under book folder.

Deployment

Now that you have PDF book, just copy it over to other PC, tablet, phone, ...

Authors

  • Mario Mlačak - Initial work - mmlacak

Contributing

GitHub sponsors

Patreon

Thank you for your donations!

For non-monetary contributions, please contact me via email first.

Socials

Croatian Chess Blog

License

This project is licensed under the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version, see LICENSING, COPYING files in root folder for details.

The book is published as Public Domain work, under CC0 1.0 Universal Public Domain Dedication, see LICENSING, COPYING files in book folder for details.

Acknowledgments

  • Dennis R.
  • Ken T.
  • Simon P. J.
  • Alessandro M.
  • Tomaso G. A.
  • O. Claude M.
  • and many, many others

Thank you all!

Playlist

A collection of songs for your listening pleasure while reading the book:

YouTube playlist featuring all listed songs: Croatian Chess soundtrack.

Outtakes:

YouTube playlist featuring all listed songs + outtakes: Croatian chess soundtrack + outtakes.

Footnotes

  1. Unfortunately, complete concerto (which also works on Linux) is not available anymore.

About

Croatian Chess is a collection of various chess variants, starting as a simple and natural enhancement to classical chess and growing ever more complex with each new variant.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published