Any name (or chunk of text being treated as a name) can be translated into a standardized "key."  Keys are comprised solely of lowercase alphanumeric characters, underscores, and asterisks.


The key is used primarily in detecting name variants.


Some examples:

  • Apples — apple
  • TedErnst — ted_ernst
  • Joe's Blog Entries — joe_s_blog_entry

The default Wagn algorithm for key generation is as follows.

  1. decode any HTML
  2. add a space before any upper case letter followed by a lower case letter (this splits CamelCase into words)
  3. make all upper case into lower case
  4. replace any non-alphanumeric character (except *) with a space
  5. break the name into words, and make each word singular if it's plural
  6. rejoin those words with underscores (instead of spaces)


NOTE: At present the above algorithm has an English bias, because the singularization algorithm is based on English patterns.  In coming releases, this will be addressed in attempts to make Wagn more completely international.


tickets relevant to keys