From 1b54f67fb2bc065c9e9dbb66d1e00e407d30456d Mon Sep 17 00:00:00 2001
From: root
Date: Thu, 19 Jun 2014 12:21:24 +0200
Subject: started propoer github maintainence
---
fancybox/README.md | 217 +++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 217 insertions(+)
create mode 100755 fancybox/README.md
(limited to 'fancybox/README.md')
diff --git a/fancybox/README.md b/fancybox/README.md
new file mode 100755
index 0000000..9434893
--- /dev/null
+++ b/fancybox/README.md
@@ -0,0 +1,217 @@
+fancyBox
+========
+
+fancyBox is a tool that offers a nice and elegant way to add zooming functionality for images, html content and multi-media on your webpages.
+
+More information and examples: http://www.fancyapps.com/fancybox/
+
+License: http://www.fancyapps.com/fancybox/#license
+
+Copyright (c) 2012 Janis Skarnelis - janis@fancyapps.com
+
+
+How to use
+----------
+
+To get started, download the plugin, unzip it and copy files to your website/application directory.
+Load files in the
section of your HTML document. Make sure you also add the jQuery library.
+
+
+
+
+
+
+
+Create your links with a `title` if you want a title to be shown, and add a class:
+
+
+
+If you have a set of related items that you would like to group,
+additionally include a group name in the `rel` (or `data-fancybox-group`) attribute:
+
+
+
+
+Initialise the script like this:
+
+
+
+May also be passed an optional options object which will extend the default values. Example:
+
+
+
+Tip: Automatically group and apply fancyBox to all images:
+
+ $("a[href$='.jpg'],a[href$='.jpeg'],a[href$='.png'],a[href$='.gif']").attr('rel', 'gallery').fancybox();
+
+Script uses the `href` attribute of the matched elements to obtain the location of the content and to figure out content type you want to display.
+You can specify type directly by adding classname (fancybox.image, fancybox.iframe, etc) or `data-fancybox-type` attribute:
+
+ //Ajax:
+ Example
+ //or
+ Example
+
+ //Iframe:
+ Example
+
+ //Inline (will display an element with `id="example"`)
+ Example
+
+ //SWF:
+ Example
+
+ //Image:
+ Example
+
+Note, ajax requests are subject to the [same origin policy](http://en.wikipedia.org/wiki/Same_origin_policy).
+If fancyBox will not be able to get content type, it will try to guess based on 'href' and will quit silently if would not succeed.
+(this is different from previsous versions where 'ajax' was used as default type or an error message was displayed).
+
+Advanced
+--------
+
+### Helpers
+
+Helpers provide a simple mechanism to extend the capabilities of fancyBox. There are two built-in helpers - 'overlay' and 'title'.
+You can disable them, set custom options or enable other helpers. Examples:
+
+ //Disable title helper
+ $(".fancybox").fancybox({
+ helpers: {
+ title: null
+ }
+ });
+
+ //Disable overlay helper
+ $(".fancybox").fancybox({
+ helpers: {
+ overlay : null
+ }
+ });
+
+ //Change title position and overlay color
+ $(".fancybox").fancybox({
+ helpers: {
+ title : {
+ type : 'inside'
+ },
+ overlay : {
+ css : {
+ 'background' : 'rgba(255,255,255,0.5)'
+ }
+ }
+ }
+ });
+
+ //Enable thumbnail helper and set custom options
+ $(".fancybox").fancybox({
+ helpers: {
+ thumbs : {
+ width: 50,
+ height: 50
+ }
+ }
+ });
+
+
+### API
+
+Also available are event driven callback methods. The `this` keyword refers to the current or upcoming object (depends on callback method). Here is how you can change title:
+
+ $(".fancybox").fancybox({
+ beforeLoad : function() {
+ this.title = 'Image ' + (this.index + 1) + ' of ' + this.group.length + (this.title ? ' - ' + this.title : '');
+
+ /*
+ "this.element" refers to current element, so you can, for example, use the "alt" attribute of the image to store the title:
+ this.title = $(this.element).find('img').attr('alt');
+ */
+ }
+ });
+
+It`s possible to open fancyBox programmatically in various ways:
+
+ //HTML content:
+ $.fancybox( '
Lorem Lipsum
Lorem lipsum
', {
+ title : 'Custom Title'
+ });
+
+ //DOM element:
+ $.fancybox( $("#inline"), {
+ title : 'Custom Title'
+ });
+
+ //Custom object:
+ $.fancybox({
+ href: 'example.jpg',
+ title : 'Custom Title'
+ });
+
+ //Array of objects:
+ $.fancybox([
+ {
+ href: 'example1.jpg',
+ title : 'Custom Title 1'
+ },
+ {
+ href: 'example2.jpg',
+ title : 'Custom Title 2'
+ }
+ ], {
+ padding: 0
+ });
+
+There are several methods that allow you to interact with and manipulate fancyBox, example:
+
+ //Close fancybox:
+ $.fancybox.close();
+
+There is a simply way to access wrapping elements using JS:
+
+ $.fancybox.wrap
+ $.fancybox.skin
+ $.fancybox.outer
+ $.fancybox.inner
+
+You can override CSS to customize the look. For example, make navigation arrows always visible,
+change width and move them outside of area (use this snippet after including fancybox.css):
+
+ .fancybox-nav span {
+ visibility: visible;
+ }
+
+ .fancybox-nav {
+ width: 80px;
+ }
+
+ .fancybox-prev {
+ left: -80px;
+ }
+
+ .fancybox-next {
+ right: -80px;
+ }
+
+In that case, you might want to increase space around box:
+
+ $(".fancybox").fancybox({
+ margin : [20, 60, 20, 60]
+ });
+
+
+Bug tracker
+-----------
+
+Have a bug? Please create an issue on GitHub at https://github.com/fancyapps/fancyBox/issues
\ No newline at end of file
--
cgit