From ac3291dbb80e2733758fa29fa89a7000e72eb4a1 Mon Sep 17 00:00:00 2001 From: Juhani Numminen Date: Thu, 8 Jul 2021 16:37:32 +0300 Subject: [PATCH] Update docs --- README.md | 26 ++++++++++++-------------- docs/README.SOURCE | 17 ++++++++++++----- 2 files changed, 24 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 21683ab2..7dfdb529 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -

StretchView

+

PySol FC logo

# PySol Fan Club edition @@ -7,7 +7,7 @@ of Card Solitaire/Patience games written in Python. Its homepage is https://pysolfc.sourceforge.io/. The maintenance branch of PySol FC on GitHub by [Shlomi -Fish](http://www.shlomifish.org/) and by some other +Fish](https://www.shlomifish.org/) and by some other people, has gained official status, ported the code to Python 3, and implemented some other enhancements. @@ -27,7 +27,7 @@ can be implemented. # Screenshots -![Image]() +![Screenshot of PySol FC](https://i.imgur.com/jQkTGwf.jpg) ## Requirements. @@ -36,20 +36,18 @@ can be implemented. - For sound support (optional) - PySol-Sound-Server fork: https://github.com/shlomif/pysol-sound-server (mp3, wav, tracker music) - - (or: ) PyGame: http://www.pygame.org/ (mp3, ogg, wav, midi, tracker music) + - (or: ) PyGame: https://www.pygame.org/ (mp3, ogg, wav, midi, tracker music) - Other packages (optional): - - Tile (ttk): http://tktable.sourceforge.net/tile/ (0.8.0 or later) - - PIL (Python Imaging Library): http://www.pythonware.com/products/pil - - Freecell Solver: http://fc-solve.shlomifish.org/ . - - [Black Hole Solitaire Solver](http://www.shlomifish.org/open-source/projects/black-hole-solitaire-solver/) + - Pillow (Python Imaging Library): https://pillow.readthedocs.io/ + - Freecell Solver: https://fc-solve.shlomifish.org/ + - [Black Hole Solitaire Solver](https://www.shlomifish.org/open-source/projects/black-hole-solitaire-solver/) ## Installation. -We provide an [installer for Windows](https://sourceforge.net/projects/pysolfc/files/PySolFC/) (requires Windows XP SP3 or higher) -as well as an Android package on F-droid. - -For installation from source, see: http://www.python.org/doc/current/inst/ +We provide an [installer for Windows](https://sourceforge.net/projects/pysolfc/files/PySolFC/) +(requires Windows XP SP3 or higher) as well as an +[Android package on F-droid](https://f-droid.org/packages/org.lufebe16.pysolfc/). ### Running from source without installation. @@ -189,7 +187,7 @@ python pysol.py --kivy ### Configuring Freecell Solver If you want to use the solver, you should configure freecell-solver -( http://fc-solve.shlomifish.org/ ) by passing the following options +( https://fc-solve.shlomifish.org/ ) by passing the following options to its CMake-based build-system: `-DMAX_NUM_FREECELLS=8 -DMAX_NUM_STACKS=20 -DMAX_NUM_INITIAL_CARDS_IN_A_STACK=60`. @@ -239,7 +237,7 @@ To facilitate coordination about contributing to PySol, please join us for a real time Internet chat on the ##pysol chat room on [Freenode](http://freenode.net/) (note the double -octothorpe/hash-sign/pound-sign) . We may set up +octothorpe/hash-sign/pound-sign). We may set up chat rooms on different services in the future. In addition, we set up a diff --git a/docs/README.SOURCE b/docs/README.SOURCE index 6dcf410a..f9c48456 100644 --- a/docs/README.SOURCE +++ b/docs/README.SOURCE @@ -22,7 +22,7 @@ compatibility with saved games of older PySol versions (<= 3.00). Prerequisites ------------- First of all you will need the Python development environment, which -is freely available from http://www.python.org +is freely available from https://www.python.org. Source code introduction @@ -119,10 +119,17 @@ The toolkit layer of a runtime option. The preferred toolkit is Tcl/Tk using the Tkinter bindings which - ship with every Python installation, but a very experimental version - for Gnome (using the pygnome and pygtk bindings) exists as well. + ship with every Python installation. - A more exciting idea is to use JPython to make PySol run under a + The Kivy UI adapts PySol for mobile devices and is mainly used for + PySolFC's Android port. See README.kivy for more details. + + A very experimental version for GTK+ 2 (using the pygnome and pygtk + bindings) did exist as well. Due to pygnome and pygtk being obsoleted, + a rewrite against GObject Introspection Python API would be needed + to make the abandoned code work with GTK+ 3 or 4. + + Another exciting idea is to use JPython to make PySol run under a Java VM using Swing as the toolkit. Because Tkinter is the "main" interface other toolkit layers have @@ -223,7 +230,7 @@ Contributing ------------ Apart from contributing new games you can also help by improving the interface - e.g. some fancy statistics dialogs would be very nice. -See the main README.md for more ideas. +See the main README.md and CONTIRBUTING.md for more ideas. Have fun,