User Manual
Internet Settin's
Settin' Internet settin's be no trivial task, matey, but it do allow in-app searchin' o' content from th' Internet if configured proper-like. OnSong cannot provide these settin's fer ye since it be requirin' that ye agree and use th' content o' th' web site in accordance with th' web site's terms o' use. Arrr! If these settin's be left blank, th' in-app Internet search feature be disabled and ye will need t' use th' Add T' OnSong Safari Extension instead, savvy?
Note: OnSong uses a pattern-oriented programmin' language called Regular Expressions t' define content t' import. When written correctly, these strings o' characters comprise patterns that can extract text from th' content o' a web page. Regular Expressions be used in th' pattern properties below.
Ye can configure OnSong t' search different websites usin' th' followin' fields, me hearty:
Search Parameters
OnSong uses Microsoft Bing t' search fer content on th' Internet. While th' query o' yer search be passed directly t' th' search engine, additional parameters fer th' search can be passed here such as th' domain t' be searched. Th' followin' example limits th' search t' th' chords directory o' a specific website:
site:http://www.domain.com/chords
Learn more about advanced Bing search parameters
Title Pattern
Th' title pattern be performed against th' title attribute o' th' found page content and be used t' extract th' title o' th' song. Th' followin' example extracts Brown Eyed Girl out o' th' full title o' th' web page, Brown Eyed Girl By Van Morrison.
(.+?)(?=(( +Chords)|( +By)))
Byline Pattern
Th' byline pattern be performed against th' title attribute o' th' found page content and be used t' extract th' byline or artist o' th' song. Th' followin' example extracts Van Morrision out o' th' full title o' th' web page, Brown Eyed Girl - Van Morrison.
(?<=[\-])(.+?)(?=\|+\s*)
Content Pattern
Th' content pattern be used t' extract th' content o' th' song from th' full HTML content o' th' web page. Typically this content be placed in HTML <pre></pre> tags. Th' followin' example extracts th' content from th' pre elements in th' HTML content o' th' found web page.
(?<=<pre>)(.+?)(?=</pre>)
Chord Pattern
In some cases, chords be marked up usin' HTML. OnSong can locate chords usin' a regular expression pattern as well, ye scallywag. In this example, HTML <u></u> tags be used t' denote chords in th' HTML. Th' followin' pattern will extract those values and convert them into bracketed chords.
<u>(.+?)</u>
Chord Style
When content be encountered, it may be bracketed, or it may be plain text usin' chords over lyrics. Ye can configure th' format that be expected from th' web site here. Fer instance, if we choose bracketed and th' previous chord pattern be used, th' found chords be surrounded by square brackets.
Strip HTML Tags
While most chord charts in web pages be created as plain text within <pre></pre> tags, sometimes they contain extraneous HTML tags. Turn this option on t' strip out extraneous HTML tags. Default be off.
