Skip to content

bbusschots/bartificer_linkToolkit_js

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bartificer.linkToolkit.js

A collection of utility functions for manipulating links in HTML pages.

Full documentation can be found at https://bbusschots.github.io/bartificer_linkToolkit_js/.

Requirements

Be sure to inlude the jQuery library into the HTML document before including bartificer.linkToolkit.js.

Some functions also require that URI.js (including its optional jQuery plugin) be included in the HTML document.

Usage

You can use a local copy of the API by uploading a copy of lib/bartificer.linkToolkit.js from this repository to your web server and including it into your pages with a <script> tag.

-or-

You can access the latest version of the API directly via the RawGit CDN as follows:

<script type="text/javascript" src="https://cdn.rawgit.com/bbusschots/bartificer_linkToolkit_js/master/lib/bartificer.linkToolkit.js"></script>

Example (all code within the head of the HTML document)

<!-- Include jQuery and URI.js from CDNs -->
<script type="text/javascript" src="https://code.jquery.com/jquery-3.1.1.min.js" integrity="sha256-hVVnYaiADRTO2PzUGmuLJr8BLUSjGIZsDYGmIJLv2b8=" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/URI.js/1.18.3/URI.min.js" integrity="sha256-F0EBsZw531Ic566O5qfXoMLeSRgH2lkS5GYuUn+jkiY=" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/URI.js/1.18.3/jquery.URI.min.js" integrity="sha256-oXQ7kOcuQWuS1Haoc7SRvZm/Vid3a8Kf+jAvtUSJrqE=" crossorigin="anonymous"></script>

<!-- Include the latest version of the API from the Raw Git CDN -->
<script type="text/javascript" src="https://cdn.rawgit.com/bbusschots/bartificer_linkToolkit_js/master/lib/bartificer.linkToolkit.js"></script>

<!-- Add a jQuery Document Ready Event Handler -->
<script type="text/javascript">
  $(function(){
  	// add a rel of noopener to all links with a target of _blank in the entire document
  	bartificer.linkToolkit.noopenerFix();
  	
  	// externalise all links that leave the site within a given container, explicitly
  	// ignoring links to certain domains
  	bartificer.linkToolkit.autoExternalise(
  	  $('#main_content'),
  	  {
  	  	ignoreDomains: ['bartb.ie', 'www.bartb.ie']
  	  }
  	);
  });
</script>

Development

To edit the library yourself, download the repo, then change to the folder, and run the following command to install all the dev requirements:

npm install

To generate the public documentation:

npm run generate-docs

To generate the developer documentation (including private members and functions);

npm run generate-docs-dev

About

A collection of utility functions for manipulating links in HTML pages.

Resources

License

Stars

Watchers

Forks

Packages

No packages published