You are here

README.txt in AutoFloat 6.2

Same filename and directory in other branches
  1. 8 README.txt
  2. 6 README.txt
  3. 7.2 README.txt
  4. 7 README.txt
Name: AutoFloat (autofloat)
Author: Martin Postma ('lolandese', http://drupal.org/user/210402)
Drupal: 6.x


-- SUMMARY --

A text format filter that wraps images in a span with odd/even classes to make
them float alternately left and right.

Configurable:
* the starting side
* exclude the module's CSS to use your theme's style.css 
* add classes to target a 'span', e.g. in case a caption is displayed
* add classes to exclude a 'div', e.g. a set of thumbnails. 


-- EXAMPLE --

The filter turns:
  ‹img src="/path/photo.jpg"›
into:
  ‹span class="autofloat-odd"›‹img src="/path/photo.jpg"›‹/span›


-- FEATURES --

Generates an organized layout of images in a text automatically.

Easy for the less technical users.

Saves time.

Avoids inline styling.

Inserting images later doesn't mess up the alternating floating.


-- INSTALLATION AND CONFIGURATION --

Extract the package in your modules directory, e.g. '/sites/all/modules'.

Enable the module under '/admin/modules'.

Add the autofloat filter to one of your text formats under 
'/admin/settings/filters'. Put it below other image related filters in
the 'Arrange' tab.

Configure under '/admin/settings/autofloat'.

Re-save existing nodes you want to apply AutoFloat to. If you still can't see
any changes, try clearing both your site and browser cache as well.


-- USAGE --

Images will float unless they have the class 'nofloat'.

A 'span' with the class 'float' will float the image and other containing 
content, e.g. a caption under it.

Images in a 'div' with the class 'nofloat' do NOT float, e.g. a set of 
thumbnails.

Avoid adding classes manually by defining classes added by other 
modules/filters. Use your browser's inspector to find them.

The class 'nofloat' of a nested element has priority over classes set in the 
parent, thus makes that the parent will not float.

Remember an element floats within the block-element containing it. If that 
doesn't cover the full width, the image might not float as expected. 
Check your CSS before submitting an issue.


-- CSS --

The autofloat.css and autofloat-rtl.css files add a right-margin to left
floating images and a left-margin to right floating images. 

If your images won't float your theme might not use the id or class "content"
to target the node body. Adjust the id or class used in the modules' css files
accordingly.

You can exclude the module's CSS on the configuration page to use your
customized theme's style.css.

File

README.txt
View source
  1. Name: AutoFloat (autofloat)
  2. Author: Martin Postma ('lolandese', http://drupal.org/user/210402)
  3. Drupal: 6.x
  4. -- SUMMARY --
  5. A text format filter that wraps images in a span with odd/even classes to make
  6. them float alternately left and right.
  7. Configurable:
  8. * the starting side
  9. * exclude the module's CSS to use your theme's style.css
  10. * add classes to target a 'span', e.g. in case a caption is displayed
  11. * add classes to exclude a 'div', e.g. a set of thumbnails.
  12. -- EXAMPLE --
  13. The filter turns:
  14. ‹img src="/path/photo.jpg"›
  15. into:
  16. ‹span class="autofloat-odd"›‹img src="/path/photo.jpg"›‹/span›
  17. -- FEATURES --
  18. Generates an organized layout of images in a text automatically.
  19. Easy for the less technical users.
  20. Saves time.
  21. Avoids inline styling.
  22. Inserting images later doesn't mess up the alternating floating.
  23. -- INSTALLATION AND CONFIGURATION --
  24. Extract the package in your modules directory, e.g. '/sites/all/modules'.
  25. Enable the module under '/admin/modules'.
  26. Add the autofloat filter to one of your text formats under
  27. '/admin/settings/filters'. Put it below other image related filters in
  28. the 'Arrange' tab.
  29. Configure under '/admin/settings/autofloat'.
  30. Re-save existing nodes you want to apply AutoFloat to. If you still can't see
  31. any changes, try clearing both your site and browser cache as well.
  32. -- USAGE --
  33. Images will float unless they have the class 'nofloat'.
  34. A 'span' with the class 'float' will float the image and other containing
  35. content, e.g. a caption under it.
  36. Images in a 'div' with the class 'nofloat' do NOT float, e.g. a set of
  37. thumbnails.
  38. Avoid adding classes manually by defining classes added by other
  39. modules/filters. Use your browser's inspector to find them.
  40. The class 'nofloat' of a nested element has priority over classes set in the
  41. parent, thus makes that the parent will not float.
  42. Remember an element floats within the block-element containing it. If that
  43. doesn't cover the full width, the image might not float as expected.
  44. Check your CSS before submitting an issue.
  45. -- CSS --
  46. The autofloat.css and autofloat-rtl.css files add a right-margin to left
  47. floating images and a left-margin to right floating images.
  48. If your images won't float your theme might not use the id or class "content"
  49. to target the node body. Adjust the id or class used in the modules' css files
  50. accordingly.
  51. You can exclude the module's CSS on the configuration page to use your
  52. customized theme's style.css.