Merge pull request #198 from arnauddupuis/arnauddupuis/issue197

Add several missing fonts and their documentation

docs/source/assets.rst

@@ -9,3 +9,4 @@ a nice default set of assets to build games. But the library can work without it
 
 .. toctree::
     graphics
+    fonts

docs/source/fonts.rst

@@ -0,0 +1,32 @@
+.. _assets_fonts-module:
+
+Fonts
+=====
+
+Fonts in the pygamelib are nothing more than a specially organized sprite collection.
+
+The way to use it is extremely simple: you instantiate a Font object and ask it to load the data from a specific font.
+
+For example to load the 8bits font, you do:
+
+Example::
+    from pygamelib.gfx import core
+
+    my_font = core.Font('8bits')
+
+That's it! The you can use it to format Text objects.
+
+.. toctree::
+
+    pygamelib.assets.fonts.8bits.rst
+    pygamelib.assets.fonts.figlet-caligraphy.rst
+    pygamelib.assets.fonts.figlet-doom.rst
+    pygamelib.assets.fonts.figlet-graffiti.rst
+    pygamelib.assets.fonts.figlet-mirror.rst
+    pygamelib.assets.fonts.figlet-pepper.rst
+    pygamelib.assets.fonts.figlet-poison.rst
+    pygamelib.assets.fonts.figlet-puffy.rst
+    pygamelib.assets.fonts.figlet-rounded.rst
+    pygamelib.assets.fonts.figlet-stampatello.rst
+    pygamelib.assets.fonts.figlet-univers.rst
+    pygamelib.assets.fonts.figlet-wavy.rst

docs/source/pygamelib.assets.fonts.8bits.rst

@@ -0,0 +1,25 @@
+8bits
+=====
+
+.. versionadded:: 1.3.0
+
+
+How to use?
+-----------
+
+Example::
+
+    from pygamelib.gfx.core import Font
+    from pygamelib.base import Text
+
+    my_font = Font("8bits")
+    my_text = Text("Lorem Ipsum", font=my_font)
+    my_text.print_formatted()
+
+What does it look like?
+-----------------------
+
+.. image:: font-example-8bits.png
+    :alt: Example
+    :align: center
+

docs/source/pygamelib.assets.fonts.figlet-caligraphy.rst

@@ -0,0 +1,35 @@
+figlet-caligraphy
+=================
+
+.. versionadded:: 1.3.0
+
+
+How to use?
+-----------
+
+Example::
+
+    from pygamelib.gfx.core import Font
+    from pygamelib.base import Text
+
+    my_font = Font("figlet-caligraphy")
+    my_text = Text("Lorem Ipsum", font=my_font)
+    my_text.print_formatted()
+
+What does it look like?
+-----------------------
+
+.. image:: font-example-figlet-caligraphy.png
+    :alt: Example
+    :align: center
+
+More
+----
+
+Please visit the FIGlet project: http://www.figlet.org/
+
+The fonts prefixed by "figlet-" are but a small portion of what's available here.
+
+To easily convert FIGlet fonts to the pygamelib's format you can you the figlet-to-pygamelib script available here: https://github.com/pygamelib/figlet-to-pygamelib
+
+

docs/source/pygamelib.assets.fonts.figlet-doom.rst

@@ -0,0 +1,35 @@
+figlet-doom
+===========
+
+.. versionadded:: 1.3.0
+
+
+How to use?
+-----------
+
+Example::
+
+    from pygamelib.gfx.core import Font
+    from pygamelib.base import Text
+
+    my_font = Font("figlet-doom")
+    my_text = Text("Lorem Ipsum", font=my_font)
+    my_text.print_formatted()
+
+What does it look like?
+-----------------------
+
+.. image:: font-example-figlet-doom.png
+    :alt: Example
+    :align: center
+
+More
+----
+
+Please visit the FIGlet project: http://www.figlet.org/
+
+The fonts prefixed by "figlet-" are but a small portion of what's available here.
+
+To easily convert FIGlet fonts to the pygamelib's format you can you the figlet-to-pygamelib script available here: https://github.com/pygamelib/figlet-to-pygamelib
+
+

docs/source/pygamelib.assets.fonts.figlet-graffiti.rst

@@ -0,0 +1,35 @@
+figlet-graffiti
+===============
+
+.. versionadded:: 1.3.0
+
+
+How to use?
+-----------
+
+Example::
+
+    from pygamelib.gfx.core import Font
+    from pygamelib.base import Text
+
+    my_font = Font("figlet-graffiti")
+    my_text = Text("Lorem Ipsum", font=my_font)
+    my_text.print_formatted()
+
+What does it look like?
+-----------------------
+
+.. image:: font-example-figlet-graffiti.png
+    :alt: Example
+    :align: center
+
+More
+----
+
+Please visit the FIGlet project: http://www.figlet.org/
+
+The fonts prefixed by "figlet-" are but a small portion of what's available here.
+
+To easily convert FIGlet fonts to the pygamelib's format you can you the figlet-to-pygamelib script available here: https://github.com/pygamelib/figlet-to-pygamelib
+
+

docs/source/pygamelib.assets.fonts.figlet-mirror.rst

@@ -0,0 +1,35 @@
+figlet-mirror
+===============
+
+.. versionadded:: 1.3.0
+
+
+How to use?
+-----------
+
+Example::
+
+    from pygamelib.gfx.core import Font
+    from pygamelib.base import Text
+
+    my_font = Font("figlet-mirror")
+    my_text = Text("Lorem Ipsum", font=my_font)
+    my_text.print_formatted()
+
+What does it look like?
+-----------------------
+
+.. image:: font-example-figlet-mirror.png
+    :alt: Example
+    :align: center
+
+More
+----
+
+Please visit the FIGlet project: http://www.figlet.org/
+
+The fonts prefixed by "figlet-" are but a small portion of what's available here.
+
+To easily convert FIGlet fonts to the pygamelib's format you can you the figlet-to-pygamelib script available here: https://github.com/pygamelib/figlet-to-pygamelib
+
+

docs/source/pygamelib.assets.fonts.figlet-pepper.rst

@@ -0,0 +1,35 @@
+figlet-pepper
+=============
+
+.. versionadded:: 1.3.0
+
+
+How to use?
+-----------
+
+Example::
+
+    from pygamelib.gfx.core import Font
+    from pygamelib.base import Text
+
+    my_font = Font("figlet-pepper")
+    my_text = Text("Lorem Ipsum", font=my_font)
+    my_text.print_formatted()
+
+What does it look like?
+-----------------------
+
+.. image:: font-example-figlet-pepper.png
+    :alt: Example
+    :align: center
+
+More
+----
+
+Please visit the FIGlet project: http://www.figlet.org/
+
+The fonts prefixed by "figlet-" are but a small portion of what's available here.
+
+To easily convert FIGlet fonts to the pygamelib's format you can you the figlet-to-pygamelib script available here: https://github.com/pygamelib/figlet-to-pygamelib
+
+

docs/source/pygamelib.assets.fonts.figlet-poison.rst

@@ -0,0 +1,35 @@
+figlet-poison
+=============
+
+.. versionadded:: 1.3.0
+
+
+How to use?
+-----------
+
+Example::
+
+    from pygamelib.gfx.core import Font
+    from pygamelib.base import Text
+
+    my_font = Font("figlet-poison")
+    my_text = Text("Lorem Ipsum", font=my_font)
+    my_text.print_formatted()
+
+What does it look like?
+-----------------------
+
+.. image:: font-example-figlet-poison.png
+    :alt: Example
+    :align: center
+
+More
+----
+
+Please visit the FIGlet project: http://www.figlet.org/
+
+The fonts prefixed by "figlet-" are but a small portion of what's available here.
+
+To easily convert FIGlet fonts to the pygamelib's format you can you the figlet-to-pygamelib script available here: https://github.com/pygamelib/figlet-to-pygamelib
+
+

docs/source/pygamelib.assets.fonts.figlet-puffy.rst

@@ -0,0 +1,35 @@
+figlet-puffy
+=============
+
+.. versionadded:: 1.3.0
+
+
+How to use?
+-----------
+
+Example::
+
+    from pygamelib.gfx.core import Font
+    from pygamelib.base import Text
+
+    my_font = Font("figlet-puffy")
+    my_text = Text("Lorem Ipsum", font=my_font)
+    my_text.print_formatted()
+
+What does it look like?
+-----------------------
+
+.. image:: font-example-figlet-puffy.png
+    :alt: Example
+    :align: center
+
+More
+----
+
+Please visit the FIGlet project: http://www.figlet.org/
+
+The fonts prefixed by "figlet-" are but a small portion of what's available here.
+
+To easily convert FIGlet fonts to the pygamelib's format you can you the figlet-to-pygamelib script available here: https://github.com/pygamelib/figlet-to-pygamelib
+
+

docs/source/pygamelib.assets.fonts.figlet-rounded.rst

@@ -0,0 +1,35 @@
+figlet-rounded
+==============
+
+.. versionadded:: 1.3.0
+
+
+How to use?
+-----------
+
+Example::
+
+    from pygamelib.gfx.core import Font
+    from pygamelib.base import Text
+
+    my_font = Font("figlet-rounded")
+    my_text = Text("Lorem Ipsum", font=my_font)
+    my_text.print_formatted()
+
+What does it look like?
+-----------------------
+
+.. image:: font-example-figlet-rounded.png
+    :alt: Example
+    :align: center
+
+More
+----
+
+Please visit the FIGlet project: http://www.figlet.org/
+
+The fonts prefixed by "figlet-" are but a small portion of what's available here.
+
+To easily convert FIGlet fonts to the pygamelib's format you can you the figlet-to-pygamelib script available here: https://github.com/pygamelib/figlet-to-pygamelib
+
+

docs/source/pygamelib.assets.fonts.figlet-stampatello.rst

@@ -0,0 +1,35 @@
+figlet-stampatello
+==================
+
+.. versionadded:: 1.3.0
+
+
+How to use?
+-----------
+
+Example::
+
+    from pygamelib.gfx.core import Font
+    from pygamelib.base import Text
+
+    my_font = Font("figlet-stampatello")
+    my_text = Text("Lorem Ipsum", font=my_font)
+    my_text.print_formatted()
+
+What does it look like?
+-----------------------
+
+.. image:: font-example-figlet-stampatello.png
+    :alt: Example
+    :align: center
+
+More
+----
+
+Please visit the FIGlet project: http://www.figlet.org/
+
+The fonts prefixed by "figlet-" are but a small portion of what's available here.
+
+To easily convert FIGlet fonts to the pygamelib's format you can you the figlet-to-pygamelib script available here: https://github.com/pygamelib/figlet-to-pygamelib
+
+