/* $Id: README.txt,v 1.9 2008/08/17 15:24:46 sun Exp $ */
-- SUMMARY --
Inline module allows you to display files uploaded with the current node
inline, i.e. with a link to the original file, using special tags. The tags
will be replaced with links to the corresponding files. If a tag refers to an
image, it will be replaced with the image.
Inline module does not attempt to resize a images. It assumes that the user
will optimize the size and resolution of images prior to uploading it. A
configuration setting of this module allows to specify the maximum display
width and height for inline images. If the original image is not bigger than
the maximum width and height, it will be displayed as-is, otherwise its
dimensions will be recalculated, maintaining the same aspect ratio.
For a full description visit the project page:
http://drupal.org/project/inline
Bug reports, feature suggestions and latest developments:
http://drupal.org/project/issues/inline
-- REQUIREMENTS --
* Upload module (Drupal core)
* ImageCache (optional)
-- INSTALLATION --
* Install as usual, see http://drupal.org/node/70151 for further information.
-- CONFIGURATION --
* Enable "Inline filter" in the input formats you intend to use. To do this, go
to Administer >> Input formats and click on one of the "Configure" links. For
instance, you can click on the "Configure" link for "Filtered HTML" and then
you will see a list of filters including "inline file filter". Turn that on
and click on "Save".
* Go to Administer >> Site configuration >> Inline and edit the maximum width
and height for inline images. If an image exceeds those dimensions, it will
be displayed as text link to download (like any other attachment than images).
Please note that this configuration setting no longer applies if the optional
ImageCache module is installed.
* Add to the CSS stylesheet you're using in your theme (usually style.css) the
following lines which you can tune to your needs. This style will be used by
the module to display images.
.inline {
float: left;
display: inline;
margin: 0 1em 1em 0;
padding: 4px 4px;
}
-- USAGE --
* For more details on using the module, see the help text by clicking:
/filter/tips/1#filter-inline after you install it.
[inline:#=title]
or
[inline:filename=title]
You can specify the file you want to display in two ways:
- specifying #, which will display the #th uploaded file
- specifying filename
If the file is not found, a 'NOT FOUND' message will be output.
Specifying the file by number can cause problems if files are deleted or
changed. In this case, specifying by name is recommended.
You can also specify a title for the file, by using an optional '=Title'
parameter. In this case, it will be used as a title for the file link or as
an ALT tag for an image. If no title is specified, the file name is used as
title.
-- EXAMPLES --
* Suppose you uploaded three files (in this order):
- imag1.png (referred as file #1)
- file1.pdf (referred as file #2)
- imag2.png (referred as file #3)
* [inline:2] or
[inline:file1.pdf]
will be replaced with file1.pdf
* [inline:1=test] or
[inline:imag1.png=test]
will be replaced with
-- CONTACT --
Current maintainers:
* Daniel F. Kudwien (sun) - dev@unleashedmind.com
Previous maintainers:
* Richard Archer (Richard Archer) - http://www.juggernaut.com.au
* Matteo Ferrari (matteo) - webmaster@cantincoro.org
This project has been sponsored by:
* UNLEASHED MIND
Specialized in consulting and planning of Drupal powered sites, UNLEASHED
MIND offers installation, development, theming, customization, and hosting
to get you started. Visit http://www.unleashedmind.com for more information.