Through much trial and error I got GeSHi up and running, but there were some missing pieces from the documentation:

geshifilter/README.txt points the user to http://qbnz.com/highlighter where, after finding the download page, the dev version is highlighted in a big green "download" button, while the 1.0.x versions are tucked away. This led me to believe that 1.1.x was encouraged. It took me half an hour to discover that 1.1.x isn't supported.

The documentation doesn't seem to have a step-by-step "how to get started" guide. I spent a lot of time trying to figure out why my
and tags weren't changing the text in my nodes, only to find out that I have to specially enable "GeSHi filter" in the "Input formats" admin panel.

CommentFileSizeAuthor
#1 GeSHi help.png187.24 KBsoxofaan

Comments

soxofaan’s picture

StatusFileSize
new187.24 KB

geshifilter/README.txt points the user to http://qbnz.com/highlighter where, after finding the download page, the dev version is highlighted in a big green "download" button, while the 1.0.x versions are tucked away. This led me to believe that 1.1.x was encouraged. It took me half an hour to discover that 1.1.x isn't supported.

The link to a better download page was already fixed in #640892: Cannot Install Geshi Filter module by http://drupal.org/cvs?commit=302008

The fact that only 1.0.x is supported is already in some places: on the project page http://drupal.org/project/geshifilter and in the README file. Where would you suggest to put it or stress it more?

About the step by step documentation: in the README file, under configuration, point 2:

2. Further configuration instructions can be found by following the
"more help..." link at the top of that general settings page, which leads
to www.example.com/?q=admin/help/geshifilter .

on this page you have a step by step explanation of how it works (see attached screenshot). Putting this information there instead of in the README, makes it possible to use handy links to the pages where you have to be.

boombatower’s picture

Status: Active » Closed (cannot reproduce)

Seems fixed, please reopen with further details if still relevant.