Changes between Version 4 and Version 5 of SearchAttachmentsPlugin

Timestamp:

May 9, 2007, 3:27:43 PM (17 years ago)

Author:

anonymous

Comment:

--

SearchAttachmentsPlugin

@@ -26 +26 @@
 
 ==   How to install?   ==
-
+ 
   * Install swish-e, http://swish-e.org/
 
-  * Install filter tools for the formats you want to index, for instance
+  * Install filter tools for the formats you want to index:
     * `catdoc` and `catppt`, http://www.45.free.net/~vitus/software/catdoc/
     * `pdftotext`, http://www.foolabs.com/xpdf/
 
-  * Download the plugin from xxxx
+  * Download the code from http://trac-hacks.org/wiki/SearchAttachmentsPlugin[[BR]]
+    to YOUR_SOURCE_DIR
 
   * Install the plugin
 {{{
-    python set-up bdist_egg
-    cp searchattachmpents.egg YOUR_TRAC_ENV/plugins
-}}}
-
-  * Configure the [attachment] section of trac.ini
-
-`[components]`[[BR]]
-`searchattachments.* = enabled`
-[[BR]][[BR]]
-`[attachment]`[[BR]]
-`swish = /usr/bin/local/swish-e`[[BR]]
-`filter.doc = /usr/local/bin/catdoc -b "%s" > "%s"`[[BR]]
-`filter.ppt = /usr/local/bin/catppt "%s" > "%s"`[[BR]]
-`filter.pdf = /usr/bin/pdftotext "%s" "%s"`[[BR]]
-[[BR]]
-''swish''
-  path to the swish-e command on your system.
-
-''filter.*''
-  command to use for converting a non-text format to text. The command takes a file as input (first ''%s'') and writes the generated a text file in a file (second ''%s''):
-
-
-  There is no need to declare a filter command for .txt or .text. Text files are handled
-  natively. To index a new non-text format, just add a filter.* entry using the appropriate
-  command line tool for this format.
-{{{
-   filter.myEXT = my_command -infile "%s" -outfile "%s"
+    python setup.py bdist_egg
+    cp dist/TracSearchAttachmentsPlugin-0.1-py2.4.egg /path/to/your/env/plugins/
 }}}
 
   * Trac 10.x and 11.x source code must be manually modified for SEAT plugin to work.
-    The file to modify is '''attachment.py'''. On a Linux Fedora system, it is located in
+    The file to modify is '''attachment.py''', on a Linux Fedora system, it is located in
     /usr/lib/python2.4/site-packages/trac
 
@@ -96 +72 @@
 203                 db.commit()
 204
-   205             targetfile.close() # << Line to add for SEAT plugin
+205             targetfile.close() # << Line to add for SEAT plugin
 206
 207             for listener in AttachmentModule(self.env).change_listeners:
@@ -106 +82 @@
 
 
-  * Add the trac-seat utility to your path. For instance, copy trac-seat to /usr/local/bin.
-  * Use trac-seat to convert existing attachments to text files and index these.
+  * Use the trac-seat utility to index existing attachments:
 {{{
-trac-seat /path/to/your/env meta
-trac-seat /path/to/your/env index -c
+    cp YOUR_SOURCE_DIR/searchattachmentsplugin/0.10/trac-seat /path/to/your/env/index
+    cd /path/to/your/env/index
+    chmod +x trac-seat
+    ./trac-seat /path/to/your/env meta
+    ./trac-seat /path/to/your/env index -c
+    cd ..
+    chown -R apache:apache /path/to.your/env/index
 }}}
 
-  * '''restart''' the trac server ( /etc/init.d/httpd restart)
+  * Configure trac.ini
+{{{
+
+   [components]
+   ....
+   searchattachments.* = enabled
+
+   [attachments]
+   ...
+   # This is the path to the swish-e command on your system
+   swish = /usr/local/bin/swish-e
+   seat  = /path/to/your/env/trac-seat
+
+   # The first %s is the absolute path of the input file.
+   # The second %s is the absolute path of the text file generated by the command.
+   filter.doc = /usr/local/bin/catdoc -b "%s" > "%s"
+   filter.ppt = /usr/local/bin/catppt "%s" > "%s"
+   filter.pdf = /usr/bin/pdftotext "%s" "%s"
+}}}
+
+  There is no need to declare a filter command for .txt or .text. Text files are handled
+  natively. To index a new non-text format, just add a filter.* entry using the appropriate
+  command line tool for this format.
+{{{
+   filter.EXTENSION = path_to_EXTENSION_to_text_command -infile "%s" -outfile "%s"
+}}}
+
+  * '''restart''' the trac server
+