[documentation] Free beta screencapture software for Drupal Documentation

[Steven Peck]

Hmmm.... sort of not quite, almost
http://drupal.org/node/762

> -----Original Message-----
> From: documentation-bounces at drupal.org [mailto:documentation-
> bounces at drupal.org] On Behalf Of Kent Bye
> Sent: Saturday, June 02, 2007 2:09 PM
> To: A list for documentation writers
> Subject: Re: [documentation] Free beta screencapture software for
> Drupal Documentation
> 
> > The reason we don't have a lot of screenies in the handbook is that
> > displaying images require the page to be at Full HTML input format
> > (which can present a security issue if given to everyone).  Once a
> > page is on this format only site admins can edit the page - normal
> > users, who create pages, and handbook maintainers, who create and
> > edit, won't be able to touch them anymore.  So, while pics are great,
> > they limit the number of people who can help and therefor need to be
> > used carefully.
> Hey Addi,
> Thanks for this additional info.
> I had no idea.
> 
> My gut reaction is "Wow. It's 2007, and the Drupal CMS doesn't feel
> comfortable allowing pictures to be posted on their flagship site!"

Generally images are uploaded via upload module to a specific node, then the
img tag is used.  So in order for people to upload pictures they need upload
module rights, this gives them rights to upload files to any content type
(except comments).

There is a documented way to get images on handbook pages.  It also doesn't
help that the current theme does not make images for the handbook something
that comes out looking nice on a consistent basis.

> My next reaction is, "Where do we need to push in order to make this
> possible?"

Me.  I've been thinking about ways to solve this off and on.  I get
distracted and wander off occasionally with other things.

> I mean, why not just create a new Input Format called something like
> "Filtered HTML w/ Images" that has the "<img>" tag included in the
> "Allowed HTML tags"? It doesn't have to be admin-only Full HTML.
> 
>   * Create a new Input Filter type for registered users
>   * Enable the HTML, Line break converter & URL filters.
>   * Goto drupal.org/admin/settings/filters/??/configure
>   * And set the Allowed HTML tags to:
>    "<a> <em> <strong> <cite> <code> <ul> <ol> <li> <dl> <dt> <dd>
> <img>"

Haven't decided on doing this yet.  Where do the images go?  Do we have
space.  

> Am I missing something else here?
> Like would it a problem to have photos hosted on third party photo
> sharing sites like Flickr?

Hosting images on a third party site produces a drag on the site performance
as requests go to third party site and if that site is having issues then
drupal.org is perceived to be having issues.  Drupal.org has enough
performance issues right now ;D

> I know Moshe has the <img> tag enabled over at groups.drupal.org, and I
> know I've used filter_xss() for some stuff that needed to have full
> HTML enabled.

I shall have to look at how Moshe has configured this.

> 
> Is this a legacy decision or has Drupal evolved to the point where it
> can handle photos?

Legacy decision on time and maintenance with the theme considerations and
upload module issues I mentioned.  Drupal can and always has been able to
handle photos.

http://drupal.org/image

> IMHO having pictures can be a powerful and quick way to transfer
> information. And I know a lot of the flowcharts and visualizations in
> the Pro Drupal Development add a ton of value to the learning process.
> It seems a shame to not have more of these types of photos easily
> accessible throughout the drupal.org site.

Pictures are fine.  See link at top of page.  I will give this more thought
and see how Moshe configured groups.

> Thanks,
> -Kent.

A further consideration is I will have to find out how much space we have
available on the drives right now.  Images take up space and I am not sure
they were configured for a lot of storage.

-sepeck