https://github.com/puria/tgapp-placeholder
tgapp-placeholder is a Pluggable application for TurboGears2 that allows placeholder images generation on the fly.
https://github.com/puria/tgapp-placeholder
Last synced: 3 months ago
JSON representation
tgapp-placeholder is a Pluggable application for TurboGears2 that allows placeholder images generation on the fly.
- Host: GitHub
- URL: https://github.com/puria/tgapp-placeholder
- Owner: puria
- License: wtfpl
- Created: 2014-04-08T18:02:13.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2018-03-29T05:59:46.000Z (about 7 years ago)
- Last Synced: 2025-02-22T13:35:55.175Z (4 months ago)
- Language: Python
- Size: 42 KB
- Stars: 1
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: COPYING
Awesome Lists containing this project
README
+------------+------------+-----------+-----------+
| |ph| | |nc| | |pm| | |ss| |
+------------+------------+-----------+-----------+
.. |ph| image:: http://placehold.it/200
.. |nc| image:: http://www.placecage.com/gif/200/200
.. |pm| image:: http://www.fillmurray.com/200/200
.. |ss| image:: https://www.stevensegallery.com/200/200
.. image:: https://img.shields.io/pypi/v/tgapp-placeholder.svg
:alt: PyPI
:target: https://pypi.org/project/tgapp-placeholder/
About tgapp-placeholder
-------------------------
**tgapp-placeholder** is a Pluggable application for `TurboGears2 `_ that allows placeholder images generation on the fly.
Inspired by http://dummyimage.com/ and https://github.com/darkrho/django-dummyimage.
Installing
-------------------------------
placeholder can be installed both from pypi or from github::
pip install tgapp-placeholder
should just work for most of the users
Plugging placeholder
----------------------------
In your application *config/app_cfg.py* import **plug**::
from tgext.pluggable import plug
Then at the *end of the file* call plug with placeholder::
plug(base_config, 'placeholder')
You will be able to access the plugged application at
*http://localhost:8080/placeholder*.
Using placeholder
-----------------
You are now able to get your fake images by calling::
http://you-application/placeholder/{width} #for a square image
http://you-application/placeholder/{width}x{height}
http://you-application/placeholder/{width}x{height}?text={some text value}
actually the parameters you can play with are:
* **text** : a custom online text wich size is calculated to fit your image width
* **bgcolor** : the background color in HEX rgb form (default set to 'DDDDDD')
* **color** : the text color in HEX rgb form (default set to '888888')
* **format** : available formats available `here `_ (default set to PNG)
* **font_size** : font_size of the eventtual text. If none is provided it is automagically calculated to fit the whole text in the image width.
Moviestars
----------
Your movie stars by placeholder! Now you can generate custom-size placeholder images of Bill Murray, Steven Seagal and the
greatest artist of all times Nicolas Cage!
Just add the name of you movie hero in the URL, like::
http://you-application/placeholder/stevenseagal/{width} #for a square image
http://you-application/placeholder/nicolascage/{width}x{height}
http://you-application/placeholder/billmurray/{width}x{height}
No text, bgcolor, color, format or font size needed! Just the name of an hero, and see the magic!
EXTRA: Nicolas Cage
*******************
Nicolas The Great Cage images supports the gray or the gif mode. Just add the *mode* in your URL::
http://you-application/placeholder/nicolascage/g/{width}x{height}
http://you-application/placeholder/billmurray/gif/{width}x{height}
Available modes:
* **g** : gray mode
* **gif**: gif mode
* **c**: Wanna see some crazy stuff? Try the crazy Cage mode!
Based on famous placeholder generator by Dave Cowart (*http://www.placecage.com*,
*https://www.stevensegallery.com/*, *http://www.fillmurray.com*)