Difference between revisions of "MIRC Powerpoint Tool"

From MircWiki
Jump to: navigation, search
(Installation)
(Powerpoint 2003)
 
(27 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
PPT2MIRC is a Powerpoint plug-in that saves a Powerpoint presentation as a MIRCdocument on a MIRC site, allowing the presentation to be found through normal MIRC queries. It was written by Scott Keller, based on work done by Prof. Amilcare Gentili of UCSD.
 
PPT2MIRC is a Powerpoint plug-in that saves a Powerpoint presentation as a MIRCdocument on a MIRC site, allowing the presentation to be found through normal MIRC queries. It was written by Scott Keller, based on work done by Prof. Amilcare Gentili of UCSD.
 +
 +
PPT2MIRC requires Windows XP or better to run because it uses the system zip folder feature. It has only been tested on Powerpoint 2003, although it may run on older versions.
 +
 +
PPT2MIRC now works <u>only</u> with MIRC T33e or later. The reason is that in order to improve the performance when converting large Powerpoint presentations, it was necessary to change the structure of the zip file that is transmitted from the Powerpoint application to MIRC. Older versions of MIRC will reject this file because it contains a subdirectory.
  
 
PPT2MIRC creates a page-mode document containing standard MIRC elements (title, author, abstract, etc.), a link to the presentation itself, images of each of the slides, and an invisible section containing the text from all the slides and notes pages, allowing the presentation to be found by searching for any of the text on any of the slides or notes pages. The link to the presentation allows the user to retrieve the original Powerpoint presentation from the MIRC site.  
 
PPT2MIRC creates a page-mode document containing standard MIRC elements (title, author, abstract, etc.), a link to the presentation itself, images of each of the slides, and an invisible section containing the text from all the slides and notes pages, allowing the presentation to be found by searching for any of the text on any of the slides or notes pages. The link to the presentation allows the user to retrieve the original Powerpoint presentation from the MIRC site.  
  
 
==Installation==
 
==Installation==
After downloading [http://mirc.rsna.org/PPT2MIRC/PPT2MIRC.zip the Powerpoint Tool zip file], open the file and extract <b>PPT2MIRC.ppa</b>.  
+
After downloading [http://mirc.rsna.org/download/PPT2MIRC.zip the Powerpoint Tool zip file], open the file and extract <b>PPT2MIRC.ppa</b>.  
  
Before it can be used, PPT2MIRC.ppa must be registered with Powerpoint as an add-in. The default location where Powerpoint looks for add-ins is <b>C:\Documents and Settings\USERNAME\Application Data\Microsoft\AddIns</b>, where <b>USERNAME</b> is to be replaced by your actual username.
+
Before it can be used, PPT2MIRC.ppa must be registered with Powerpoint as an add-in. Installing the add-in is a little different in the various versions of Powerpoint.
 +
 
 +
===Powerpoint 2007 and 2010===
 +
# Launch PowerPoint.
 +
# Click the File tab and select Options.
 +
# In the PowerPoint Options dialog, clickthe Add-ins in the left pane.
 +
# In the right pane, select 'PowerPoint Add-ins' from the Manage drop down and click 'Go...'
 +
# On the Add-ins dialog, click 'Add New...' .
 +
# Navigate to the PPT2MIRC.ppa file and click on OK.
 +
# If a macro virus warning appears, enable the macros.
 +
 
 +
When the Add-in is properly loaded, it will display a tick against the add-in name.
 +
 
 +
===Powerpoint 2003===
 +
The default location where Powerpoint 2003 looks for add-ins is <b>C:\Documents and Settings\USERNAME\Application Data\Microsoft\AddIns</b>, where <b>USERNAME</b> is to be replaced by your actual username.
  
 
After placing the file in the AddIns directory, you must set the security level for macros and then enable the add-in.  
 
After placing the file in the AddIns directory, you must set the security level for macros and then enable the add-in.  
Line 12: Line 30:
 
To set the security level:
 
To set the security level:
  
* Run Powerpoint.
+
# Run Powerpoint.
* In the menu bar, select <b>Tools / Options</b>.
+
# In the menu bar, select <b>Tools / Options</b>.
* In the Options dialog, click the <b>Security</b> tab.
+
# In the Options dialog, click the <b>Security</b> tab.
* Click the <b>Macro Security...</b> button.
+
# Click the <b>Macro Security...</b> button.
* In the Security dialog, click the <b>Security Level</b> tab.
+
# In the Security dialog, click the <b>Security Level</b> tab.
* Click the <b>Medium</b> radio button.
+
# Click the <b>Medium</b> radio button.
* Click the <b>OK</b> button on the Security dialog.
+
# Click the <b>OK</b> button on the Security dialog.
* Click the <b>OK</b> button on the Options dialog.
+
# Click the <b>OK</b> button on the Options dialog.
 
<center>
 
<center>
[[Image:MIRC2PPTa.JPG]]
+
[[Image:PPT2MIRCa.JPG]]
[[Image:MIRC2PPTb.JPG]]
+
[[Image:PPT2MIRCb.JPG]]
 
</center>
 
</center>
[[Image:MIRC2PPTc.JPG|frame|]]
+
 
  
  
Line 30: Line 48:
  
 
* In the menu bar, select <b>Tools / Add-ins</b>.
 
* In the menu bar, select <b>Tools / Add-ins</b>.
* In the Add-Ins dialog, check the <b>PPT2MIRC</b> box if it appears; otherwise, click the <b>Add New...</b> button and navigate to the PPT2MIRC.ppa file.
+
* In the Add-Ins dialog, check the <b>PPT2MIRC</b> box if it appears; otherwise, click the <b>Add New...</b> button and navigate to the <b>PPT2MIRC.ppa</b> file.
 
* Click the <b>Close</b> button.
 
* Click the <b>Close</b> button.
 
+
<center>
[[Image:MIRC2PPT2.JPG|frame|]]
+
[[Image:PPT2MIRCc.JPG]]
 +
</center>
 +
[[Image:PPT2MIRC2.JPG |frame|]]
  
 
==Operation==
 
==Operation==
 
To use PPT2MIRC, open a presentation in Powerpoint. In the <b>Tools</b> menu, select <b>Convert to MIRC</b>. A window will be displayed as shown to the right.
 
To use PPT2MIRC, open a presentation in Powerpoint. In the <b>Tools</b> menu, select <b>Convert to MIRC</b>. A window will be displayed as shown to the right.
  
Set the MIRC Address field to point to the MIRC site to which you want to submit the MIRCdocument. The default setting points to a storage service named <b>storage</b> on a MIRC site running on your local computer (<b>localhost</b>) on port <b>8080</b>. Change these parameters as required. (If you aren't sure what the values should be, go to the query page for the site, click the <b>Submit Service</b> button, and look in the browser's address bar.)
+
Fill in any of the fields you want.
 +
*The title field is automatically set to the title of the Powerpoint presentation. If you want to change the title of the MIRCdocument, edit this field.
 +
*Enter any text in the abstract field. This field is displayed in query results, so it is good form to place a short description of the document in this field.
 +
*Set the author and the various keywords fields so that the MIRCdocument reflects the presentation when it is included in query results.  
 +
*In the Owner field, enter the username of the MIRC user who is to be the owner of the document.
 +
*Set the three access fields to determine whether others can read, update, or export the document.  
  
Next, fill in any of the fields you want. Pay special attention to these fields:
+
Set the MIRC Address field to point to the MIRC site to which you want to submit the MIRCdocument. The form of the URL depends on whether the MIRC site is running on Tomcat or CTP.
  
*Set the title, author and abstract fields so that the MIRCdocument reflects the presentation when it is included in query results.  
+
;<b>Tomcat/MIRC:</b>
*Make sure you put your MIRC username in the owner field. This is important to ensure that you will have control over the document when it is stored on the MIRC site.  
+
:The MIRC Address of a Tomcat/MIRC site has the form: <b><tt>http://IP:port/storage/submit/doc?ppt</tt></b>, where <b>storage</b> is the name of the storage service intended to store the document. (If you aren't sure what the name of your storage service is, go to the query page for the site, select the Submit Service for the desired Storage Service, and look in the browser's address bar.)
*Set the three access fields to determine whether others can read, update, or export the document.  
+
 
 +
;<b>CTP/MIRC:</b>
 +
:The MIRC Address of a CTP/MIRC site has the form: <b><tt>http://IP:port/submit/ss1?ppt</tt></b>, where <b>ss1</b> is the ID of the storage service intended to store the document. Each Storage Service (called a library in the latest versions) has a unique ID in the form <b><tt>ss</tt></b> followed by an integer. You can find the ID of a library by looking at the URL of a document that it contains.
 +
 
 +
<b>IMPORTANT:</b> <em>For both Tomcat/MIRC and CTP/MIRC sites, the MIRC Address field <u>must</u> include the <b>ppt</b> query parameter.</em>
  
 
When you have set all the fields the way you want, click the <b>Send</b> button on the MIRC Address line.  
 
When you have set all the fields the way you want, click the <b>Send</b> button on the MIRC Address line.  
  
PPT2MIRC will then create the MIRCdocument and the images of the slides and then submit everything to the MIRC site. The result will be displayed in the results field of the window as shown. You can click the link in the results field to go directly to the MIRCdocument on the site.
+
PPT2MIRC will then create the MIRCdocument and the images of the slides and then challenge you for your username and password on the MIRC site. PPT2MIRC will then submit everything to the MIRC site. The result will be displayed in the dialog window.
  
If you entered your MIRC username in the owner field, you will be able to edit the MIRCdocument through the author service on the MIRC site.
+
Once the document is on the MIRC site, you can find it by searching for any text in the slides, and you can edit it using the author service.

Latest revision as of 14:27, 19 January 2012

PPT2MIRC is a Powerpoint plug-in that saves a Powerpoint presentation as a MIRCdocument on a MIRC site, allowing the presentation to be found through normal MIRC queries. It was written by Scott Keller, based on work done by Prof. Amilcare Gentili of UCSD.

PPT2MIRC requires Windows XP or better to run because it uses the system zip folder feature. It has only been tested on Powerpoint 2003, although it may run on older versions.

PPT2MIRC now works only with MIRC T33e or later. The reason is that in order to improve the performance when converting large Powerpoint presentations, it was necessary to change the structure of the zip file that is transmitted from the Powerpoint application to MIRC. Older versions of MIRC will reject this file because it contains a subdirectory.

PPT2MIRC creates a page-mode document containing standard MIRC elements (title, author, abstract, etc.), a link to the presentation itself, images of each of the slides, and an invisible section containing the text from all the slides and notes pages, allowing the presentation to be found by searching for any of the text on any of the slides or notes pages. The link to the presentation allows the user to retrieve the original Powerpoint presentation from the MIRC site.

1 Installation

After downloading the Powerpoint Tool zip file, open the file and extract PPT2MIRC.ppa.

Before it can be used, PPT2MIRC.ppa must be registered with Powerpoint as an add-in. Installing the add-in is a little different in the various versions of Powerpoint.

1.1 Powerpoint 2007 and 2010

  1. Launch PowerPoint.
  2. Click the File tab and select Options.
  3. In the PowerPoint Options dialog, clickthe Add-ins in the left pane.
  4. In the right pane, select 'PowerPoint Add-ins' from the Manage drop down and click 'Go...'
  5. On the Add-ins dialog, click 'Add New...' .
  6. Navigate to the PPT2MIRC.ppa file and click on OK.
  7. If a macro virus warning appears, enable the macros.

When the Add-in is properly loaded, it will display a tick against the add-in name.

1.2 Powerpoint 2003

The default location where Powerpoint 2003 looks for add-ins is C:\Documents and Settings\USERNAME\Application Data\Microsoft\AddIns, where USERNAME is to be replaced by your actual username.

After placing the file in the AddIns directory, you must set the security level for macros and then enable the add-in.

To set the security level:

  1. Run Powerpoint.
  2. In the menu bar, select Tools / Options.
  3. In the Options dialog, click the Security tab.
  4. Click the Macro Security... button.
  5. In the Security dialog, click the Security Level tab.
  6. Click the Medium radio button.
  7. Click the OK button on the Security dialog.
  8. Click the OK button on the Options dialog.
Error creating thumbnail: Unable to save thumbnail to destination
Error creating thumbnail: Unable to save thumbnail to destination


To enable the add-in:

  • In the menu bar, select Tools / Add-ins.
  • In the Add-Ins dialog, check the PPT2MIRC box if it appears; otherwise, click the Add New... button and navigate to the PPT2MIRC.ppa file.
  • Click the Close button.
Error creating thumbnail: Unable to save thumbnail to destination
Error creating thumbnail: Unable to save thumbnail to destination

2 Operation

To use PPT2MIRC, open a presentation in Powerpoint. In the Tools menu, select Convert to MIRC. A window will be displayed as shown to the right.

Fill in any of the fields you want.

  • The title field is automatically set to the title of the Powerpoint presentation. If you want to change the title of the MIRCdocument, edit this field.
  • Enter any text in the abstract field. This field is displayed in query results, so it is good form to place a short description of the document in this field.
  • Set the author and the various keywords fields so that the MIRCdocument reflects the presentation when it is included in query results.
  • In the Owner field, enter the username of the MIRC user who is to be the owner of the document.
  • Set the three access fields to determine whether others can read, update, or export the document.

Set the MIRC Address field to point to the MIRC site to which you want to submit the MIRCdocument. The form of the URL depends on whether the MIRC site is running on Tomcat or CTP.

Tomcat/MIRC:
The MIRC Address of a Tomcat/MIRC site has the form: http://IP:port/storage/submit/doc?ppt, where storage is the name of the storage service intended to store the document. (If you aren't sure what the name of your storage service is, go to the query page for the site, select the Submit Service for the desired Storage Service, and look in the browser's address bar.)
CTP/MIRC:
The MIRC Address of a CTP/MIRC site has the form: http://IP:port/submit/ss1?ppt, where ss1 is the ID of the storage service intended to store the document. Each Storage Service (called a library in the latest versions) has a unique ID in the form ss followed by an integer. You can find the ID of a library by looking at the URL of a document that it contains.

IMPORTANT: For both Tomcat/MIRC and CTP/MIRC sites, the MIRC Address field must include the ppt query parameter.

When you have set all the fields the way you want, click the Send button on the MIRC Address line.

PPT2MIRC will then create the MIRCdocument and the images of the slides and then challenge you for your username and password on the MIRC site. PPT2MIRC will then submit everything to the MIRC site. The result will be displayed in the dialog window.

Once the document is on the MIRC site, you can find it by searching for any text in the slides, and you can edit it using the author service.