digitalcarleton / omekafootnotesjs

An Omeka plugin to add interactive JavaScript footnotes to exhibit pages and simple pages by extending the TinyMCE wysiwyg HTML editor.

OmekaFootnotesJS

Summary

An Omeka plugin to add interactive JavaScript footnotes to exhibit pages and simple pages by extending the TinyMCE wysiwyg HTML editor.

This plugin uses Bigfoot.js version 2.1.4

Footnotes in action:

Installation

1. Make sure you have ExhibitBuilder and SimplePages installed in your Omeka site

2. Install the OmekaFootnotesJS plugin

3. Add '*.id' to Allowed HTML Attributes in Omeka security settings and save changes.

Use Instructions

1. To add/edit footnotes:

a. Position your cursor in the place you'd like to add a footnote, then press the "Add Footnote" button on the toolbar. A footnote link will be inserted at that point, and a footnote text snippet will appear at the end of the text block.

b. To change the content of the footnote, edit the text snippet at the bottom of the editor that corresponds to your numbered footnote. If citing a source, best practice is to do so in a standard bibliographic format for your discipline and apply a link if it can be accessed online.

c. Refer to (3) to update the order of your footnotes if necessary (in most cases, this should be handled automatically).

2. To remove a footnote:

a. Highlight the footnote link in the text. You may highlight multiple footnotes at the same time, but note that all footnotes you highlight will be deleted.

b. Press the "Delete Selected Footnotes" button on the toolbar. The footnotes you selected, along with their associated text snippets, will be removed.

c. Refer to (3) to update the order of your footnotes if necessary (in most cases, this should be handled automatically).

3. To reorder footnotes:

a. Press the "Update Footnotes" button on the toolbar. This will reorder your footnotes in order of appearance.

License

This plugin is published under GNU/GPL.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

Contact

Maintained by Digital Humanities @ Carleton College

omekafootnotesjs's Issues

Error with .load() calls in Omeka 3 and jquery 3

Exhibit page edit screens are throwing "e.indexOf is not a function" errors.

Omeka 3 upgraded to jquery 3 which deprecated the .load() method

Per that page, we need to replace the calls to .load() in OmekaFootnotes.js with .on("load",callback)..

Add tooltip option for all buttons.

Add the tooltip button property to all buttons with short help text, following this example.

Especially useful on delete, for explaining what to highlight, e.g. "Delete selected superscript and note"

OmekaFootnotesJS/views/admin/javascripts/OmekaFootnotes.js

Line 19 in ec3137a

onclick: function () {

Broken image links on Omeka site

Footnote hidden by new content block

Long footnotes are cut off/covered up by new content blocks.

Plugin does not have the same funtionality in Omeka 3.0.1

The plugin does not have the same functionality in Omeka 3.0.1. There isn't a bubble around the footnote number and it does not display the footnote in a popup message.

Remove space and period added after FN number

OmekaFootnotesJS/views/admin/javascripts/OmekaFootnotes.js

Line 278 in ebeb47c

var str7 = '</a> </sup>.';

Footnote toolbar working on exhibit pages but not simple pages