[documentation] [Documentation feature] Documentation needed on inline images

[karldied]

Issue status update for 
http://drupal.org/node/115075
Post a follow up: 
http://drupal.org/project/comments/add/115075

 Project:      Documentation
 Version:      <none>
 Component:    Customization and Theming Guide
 Category:     feature requests
 Priority:     normal
 Assigned to:  Senpai
 Reported by:  joachim
 Updated by:   karldied
 Status:       active

There is also:
Image and Acidfree [1] (and Video)


I would really value documentation comparing the different options:
what various applications are best addressed by each option;
capabilities and limitations of the options; advantages; disadvantages;
and maybe history on why they came to be (help explain the differences).



I think Drupal documentation would be well-served by "overview"
documentation when there appears to be multiple ways to implement a
solution, that gives a clue (1) what the different options _are_ and (2)
which option to pursue . (I'm working on a similar article for access
control.)
[1] http://drupal.org//project/acidfree




karldied



Previous comments:
------------------------------------------------------------------------

Thu, 01 Feb 2007 18:02:36 +0000 : joachim

I've not been able to find anything in the handbooks on how to set up
drupal to put images within nodes -- the way you would on a plain web
page.


Searching the forum has yielded a few interesting threads:
http://drupal.org/node/113813
http://drupal.org/node/107622


-- but these suggest several different approaches, don't fully explain
the options and benefits, and don't have complete instructions.


This seems to be a common need that isn't documented.




------------------------------------------------------------------------

Thu, 01 Feb 2007 22:27:44 +0000 : karldied

Try:
http://drupal.org/node/762, Screenshots and uploading images. I updated
the title (it's been on my to-do list) to include the word images. This
page addresses how to add them inline to drupal.org handbook
documentation pages. Getting them on pages of your own Drupal-powered
web site is another Q...




------------------------------------------------------------------------

Fri, 02 Feb 2007 15:08:14 +0000 : joachim

Thanks.
But I don't see where that page says how to upload an image.


The scenario is this: users of the drupal site I am setting up will
need to be able to upload images to the webserver and then embed them in
page text, all via drupal.


I've done a fair bit of research on this over the last couple of days,
and I'm going to be trying out a few combinations.
If I can figure out how to start a new handbook page to share what I
find, I will.


BTW, are there any plans to put image handling into core?




------------------------------------------------------------------------

Fri, 02 Feb 2007 18:51:17 +0000 : sepeck

Any registered user can start a new handbook page.


Only those with Site-Maintainer role can upload files/images to a page.
 Upload module has site wide permissions so granting book maintainer
role upload permission would be granting them upload permission across
drupal.org.


If you need/want to include images with a page, create you page. 
Submit a documentation issue with the attached images and a request for
them to be added to the page.


Keep in mind that the current site theme has issues with large images
that do not fit between two columns so keep images small.




------------------------------------------------------------------------

Fri, 02 Feb 2007 18:52:58 +0000 : sepeck

sigh.  I need to pay more attention.


Two ways.  upload a file to the node.  Look at the file path.  Use IMG
SRC=./files/image.jpg or equiv.  


Use image module per: http://drupal.org/node/47357




------------------------------------------------------------------------

Sat, 03 Feb 2007 22:49:39 +0000 : sepeck

Attachment: http://drupal.org/files/issues/upload_example.png (10.74 KB)

see attached image for example.  If you upload an image to a node then
you have a path to that image that you can use.  This probably does need
to be better documented.




------------------------------------------------------------------------

Sat, 03 Feb 2007 23:07:00 +0000 : Senpai

I'll try and tackle this one. I have a somewhat vested interest in
getting some step-by-step documentation on this basic procedure anyway.




------------------------------------------------------------------------

Mon, 05 Feb 2007 13:53:07 +0000 : joachim

Here's the different combinations of modules I've found so far.
They all have their pros and cons, though I've not tested all of them:


image and imageattach -- a bit yucky. can't remove attached images
image and img_assist -- not bad, but interface of popup box a bit
cluttered
iamge and inline -- simple
image and plain old html tags -- too complex for many site users
upload and node_images -- images are only attached to the node, not
nodes themselves.
upload and Node Image Block http://drupal.org/node/48676 -- don't know
upload_image -- don't know
gallery -- don't know