The CONFIGURATION section is basically wrong.

CONFIGURATION
-------------
1. The general GeSHi Filter settings can be found by navigating to:
administer > site configuration > geshifilter.
Set the path to the GeSHi library on that page, if it is not detected
automatically already.
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 . This requires you have the
'help' module enabled.

1. Should be:

Home » Administration » Configuration » Content authoring » Text formats
/admin/config/content/formats/geshifilter

Probably should also add:

Check the Languages tab to verify all the languages you want to use are enabled.

/admin/config/content/formats/geshifilter/languages

Click 'All' to find other languages to enable.

2.

There is no 'help' link on the configuration page

/?q=admin/help/geshifilter works, but . . . It has better pathing, but it's so general it's not much use.

And unfortunately the help link on the Modules page gets overwritten by the Advanced help module (if installed), which only shows the README.

There should be a 3. describing how to configure it into the existing text formats

3.

After enabling the GeSHi Filter module and checking the configuration in 1., you need to enable the GeSHi filter in each Text format you want to use it in.

Home » Administration » Configuration » Content authoring » Text formats
/admin/config/content/formats

As an example, for Filtered HTML, click configure on the above page (/admin/config/content/formats/filtered_html) and in the section Enabled filters, check GeSHi filter and then in the section Filter processing order, move GeSHi filter to the either the last slot or just above 'Correct faulty and chopped off HTML.'

4. ??

Possibly also add a note that the 'Convert URLs into links' filter will screw up URLs in the code section.

# # #

Truly the existing REAME and Help /?q=admin/help/geshifilter need to be merged together. Both have bits and pieces of the needed information to get the module to work, but neither has an entire working set of instructions.

Specifically Categorized as 'Bug' as following just the README instructions will not get the module to work.

Installed Info:
# drush pmi geshifilter
Extension : geshifilter
Project : geshifilter
Type : module
Title : GeSHi Filter
Description : Provides a filter to highlight source code using the GeSHi library (Generic Syntax Highlighter)
Version : 7.x-1.2
Package : Filters
Core : 7.x
PHP : 5.2.4
Status : enabled
Path : sites/all/modules/geshifilter
Schema version : 7100
Files : geshifilter.test
Requires : libraries (>=2.0)
Required by : geshifield

Comments

Michael-IDA’s picture

Michael-IDA CreditAttribution: Michael-IDA commented

PS: Add this where appropriate.

$ cd sites/all/libraries
$ wget -c "http://sourceforge.net/projects/geshi/files/latest/download?source=files" -O "geshi.tar.gz"
$ tar -zxf geshi.tar.gz

Should make it a bit easier installing the library correctly.

ip6li’s picture

ip6li CreditAttribution: ip6li as a volunteer commented

And more confusion with Drupal 8.2.4 and geshifilter-8.x-1.0.tar.gz

How to get it running:

apt install php-geshi
mkdir -p ${DRUPAL_ROOT}/vendor/geshi/geshi
ln -s /usr/share/php-geshi src

Documentation needs really an update or config should offer an option to set an absolute path to Geshi installation.

yukare’s picture

yukare CreditAttribution: yukare commented

I did an update to drupal 8, and put a link to it in the project page. And i working on a site with documentation for geshi, as it will show the code and the result in same page(i can not do this on drupal.org) please view it at http://geshifilter.jaguaribe.net.br
Soon i will make an effort in 7 issues as i am working on 8. If you want, please use the new readme.txt in drupal 8 as base and make your changes for drupal 7, i will review and commit. You can put the entire file if do not want/know about patchs.

@ip6li you can do the same way as in drupal 7. This thing to place under vendor is about composer, so you can download the library just with composer require geshi/geshi but the new readme show this better now.