Changes between Version 10 and Version 11 of ExcelXlstViewerPlugin


Ignore:
Timestamp:
Sep 8, 2017, 7:58:15 PM (7 years ago)
Author:
Ryan J Ollos
Comment:

Add troubleshooting section.

Legend:

Unmodified
Added
Removed
Modified
  • ExcelXlstViewerPlugin

    v10 v11  
    77This plugin allows uploaded Excel files on the Wiki or in tickets to be viewed in the web browser as a HTML table. It allows users to easily view the files without downloading and saving the Excel files and without even requiring Microsoft Excel.
    88
    9 As a use case, upload an Excel document from an up-to-date version of Microsoft Excel as an attachment. As long as it is in the new xlst format the plugin will work. If it doesn't work, then verify that openpyxl is installed correctly by running Python and entering "import openpyxl". You should see no error. Also ensure that ''mime_map'' is set properly as documented in the Installation steps.
    10 
    11 This plugin depends on the [https://openpyxl.readthedocs.io/en/default/ openpyxl] library, which itself is MIT/Expat licensed.
     9As a use case, upload an Excel document from an up-to-date version of Microsoft Excel as an attachment. As long as it is in the new xlst format the plugin will work.
    1210
    1311== Bugs/Feature Requests
     
    3129== Installation
    3230
    33 First install the openpyxl library: `pip install openpyxl`.
     31First install the [https://openpyxl.readthedocs.io/en/default/ openpyxl] library: `pip install openpyxl`.
    3432
    3533General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.
     
    3937After installation add the following to the ''mime_map'' property in your `trac.ini` file to tell Trac which types of file work with the plugin:
    4038
    41 {{{#!sh
     39{{{#!ini
    4240application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:xlsx,application/vnd.ms-excel.sheet.macroEnabled.12:xlsm
    4341}}}
    4442
    4543To make this plugin work on Trac 0.12, use the workaround described [th:#9945 here].
     44
     45== Troubleshooting
     46
     47If it doesn't work, then verify that openpyxl is installed correctly by running Python and entering `import openpyxl`. You should see no error. Also ensure that ''mime_map'' is set properly as documented in the Installation steps.
    4648
    4749== Recent Changes