---+ IndexGen Add-On

This plugin enables you to drag and drop multiple topics from one or
more webs, arrange them in the order you prefer and export them as an
indexed pdf document. Covers can also be chosen (from a seperate
'covers' web).



---++ Usage
This is an extension of the Generate PDF Add-On (GenPdf). It requires GenPdf but will not effect GenPdfs normal functions.

see [[http://www.flossmanuals.net/remix]] for a working example

1.   set webs (comma separated) you want to from the remix function with REMIXWEBEXCLUDE (in Main/WebPreferences)
2.   set topics (comma separated) you want to exclude from all webs with REMIXTOPICEXCLUDE (in Main/WebPreferences)
3.   change the pdfarrange.tmpl to the look and feel of your site.
4.   add some topics to ManualCover web (created with this plugin) with cover designs. These will appear in the dropdown box in step 6. (hint : you can use '%MANUAL_TITLE%' in a cover and it will print the title given in step 6 on the cover).
5.   go to http://[your url]/bin/remix

6.   On this page you can choose from the listed webs via a drop down menu, and then drag chapters to the box on the left. Then press 'export'. You must then fill in the document title, choose a cover, and then press 'export' again.  The document will be exported to an indexed PDF with the chapters in the order you chose, with the cover you choose.

This plugin originally developed for [[http://www.flossmanuals.net]]

---+++ General Configuration

The following table shows the various configuration variables and their meaning. The first column shows the variable to use if using a TWiki
preference variable (i.e. Set VARIABLE = ). The third column gives the default value if TWiki preference variable is not used.


%TABLE{ cellpadding="3" columnwidths="15%, 15%, 15%, 40%"}%
| *Twiki Preference Variable* | *Default Value* | *Example* | *Explanation* |
| REMIXWEBEXCLUDE | | TWiki,Main | List of webs we want to ignore. |
| REMIXTOPICEXCLUDE | WebAtom,WebTopics | | List of topics we want to ignore. |


---++ Add-On Installation Instructions

__Note:__ You do not need to install anything on the browser to use this add-on. The following instructions are for the administrator who ins
talls the add-on on the server where TWiki is running.

   * Download the ZIP file from the Add-on Home (see below)
   * Unzip ==%TOPIC%.zip== in your twiki installation directory. Content:
     | *File:* | *Description:* |
     | ==data/TWiki/%TOPIC%.txt== | Add-on topic |
     | ==data/TWiki/%TOPIC%.txt,v== | Add-on topic repository |
     | ==data/ManualCover/Default.txt== | Default cover |
     | ==data/Main/Credits.txt== | Credits topic |
     | ==pub/TWiki/MochiKit/==     | MochiKit library |
     | ==bin/remix== | Add-on script |
     | ==templates/remix.tmpl==  | Template   |

---++ Add-On Info

   * Set SHORTDESCRIPTION = Helps you remix and export your Web.

   |  Add-on Author: | TWiki:Main.AleksandarErkalovic |
   |  Copyright: | &copy; 2007, TWiki:Main.AleksandarErkalovic |
   |  License: | GPL ([[http://www.gnu.org/copyleft/gpl.html][GNU General Public License]]) |
   |  Add-on Version: |  29 May 2007 (V1.000) |
   |  Change History: | <!-- versions below in reverse order -->&nbsp; |
   |  29 May 2007: | Initial version |
   |  TWiki Dependency: | $TWiki::Plugins::VERSION 1.1 (TWiki 4.0) |
   |  CPAN Dependencies: | List::Compare::Functional |
   |  Perl Version: | 5.005 or above |
   |  Add-on Home: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC% |
   |  Feedback: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev |
   |  Appraisal: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Appraisal |

__Related Topic:__ %TWIKIWEB%.TWikiAddOns

-- TWiki:Main/%USERNAME% - %DATE%




