TaxonWorks Docs
Guide
Develop
About
Start a project
Cite
API
Bug report
Contact
  • Docs
  • Code
  • API
  • English
  • Español
Guide
Develop
About
Start a project
Cite
API
Bug report
Contact
  • Docs
  • Code
  • API
  • English
  • Español
  • Develop
    • Overview
    • Contributing
    • Install
      • Development
        • Overview
        • Native
          • Operating Systems
          • Arch Linux
          • macOS
          • Ubuntu 22.04
          • Ubuntu 24.04
          • Windows 10 with WSL2
        • Docker
          • Build and push the development container to Docker
          • Docker
          • Windows 10 with WSL2
      • Production
        • Overview
        • Kubernetes
          • Overview
        • Capistrano
          • Overview
      • Overview
    • Code
      • Overview
      • Development Environment
      • Features
        • Scenarios
        • Scaffolding
        • Help bubbles
        • Rake task
        • Radial
        • TaxonWorks task
        • Tests
      • Conventions
      • Contributing
      • Troubleshoot
      • Roadmap
    • Data
      • Overview
      • Models
      • Tables
This site uses VuePress, a static site generator

Help bubbles

Help bubbles are available through Taxonworks's orange help button on the right side of the screen.

Help bubbles are available on certain UI features, which guide users on certain features. This includes utilization of interface elements, unique vocabulary, and other elements that would otherwise not be immediately clear to the user.

Adding help bubbles

Method 1: Data-help property

  • For the desired element, add the data-help property and set it equal to your help string
<div data-help="Help string"></div>

Method 2: HtmLerb Data help

  • For the desired element, add the data property that conforms to the following syntax:
   <%= data: {help: 'Help string'} %>

Method 3: Separate help file

Help bubbles require certain framework to be included in a page. First, the HelpSystem library must be imported into the main.js file of the desired project.

import HelpSystem from '@/plugins/help/help'
import en from './help/en'

In the initApp function, you should include the following code. This is to tell the program to use the HelpSystem library.

app.use(HelpSystem, {
    languages: {
        en
    }
})
  • Make a folder titled Help. Inside, make an en.js (where en is the language code) file where you will contain your help.
  • For the element you want to add the help onto, add v-help.yourcontainer.yourname as a property to the desired element(s).
  • Inside of the en.js file, include the following. These will add help which links to the properties made in the previous step.
export default {
    yourcontainer: {
      yourname: 'Help string',
    }
  }
Edit this page
Last Updated:
Contributors: lc-art1, jlpereira
Prev
Scaffolding
Next
Rake task