Användarmanual
Internetinställningar
Konfigurering av internetinställningar är ingen trivial uppgift men tillåter sökning av innehål från Internet i appen om det är korrekt konfigurerat. OnSong kan inte tillhandahålla dessa inställningar åt dig eftersom det kräver att du samtycker till och använder webbplatsens innehål i enlighet med webbplatsens användarvillkor. Om dessa inställningar lämnas tomma är funktionen för internetökning i appen inaktiverad och du måste använda Add To OnSong Safari-tillägget istället.
Obs: OnSong använder ett mönsterorienterat programmeringsspråk som kallas Reguljära uttryck för att definiera innehål som ska importeras. När dessa är korrekt skrivna utgör dessa teckensekvenser mönster som kan extrahera text från innehållet på en webbsida. Reguljära uttryck används i mönstergenskaperna nedan.
Du kan konfigurera OnSong för att söka på olika webbplatser med följande fält:
Sökparametrar
OnSong använder Microsoft Bing för att söka efter innehål på Internet. Medan sökfrågan skickas direkt till sökmotorn kan ytterligare parametrar för sökningen skickas här, till exempel domänen som ska sökas. Följande exempel begränsar sökningen till ackordsavsnittet på en specifik webbplats:
site:http://www.domain.com/chords
Läs mer om avancerade Bing-sökparametrar
Titelns mönster
Titelns mönster utförs mot titleattributet för det funna sidinnehållet och används för att extrahera låtens titel. Följande exempel extraherar Brown Eyed Girl från webbsidans fullständiga titel, Brown Eyed Girl By Van Morrison.
(.+?)(?=(( +Chords)|( +By)))
Byline-mönster
Byline-mönstret utförs mot titleattributet för det funna sidinnehållet och används för att extrahera byline eller artistens namn för låten. Följande exempel extraherar Van Morrison från webbsidans fullständiga titel, Brown Eyed Girl - Van Morrison.
(?<=[\-])(.+?)(?=\|+\s*)
Innehållsmönster
Innehållsmönstret används för att extrahera låtens innehål från webbsidans fullständiga HTML-innehål. Vanligtvis placeras detta innehål inom HTML <pre></pre>-taggar. Följande exempel extraherar innehållet från pre-elementen i det funna HTML-innehållet på webbsidan.
(?<=<pre>)(.+?)(?=</pre>)
Ackordsmönster
I vissa fall markeras ackord med HTML. OnSong kan också lokalisera ackord med ett reguljärt uttryck. I det här exemplet används HTML <u></u>-taggar för att beteckna ackord i HTML-koden. Följande mönster extraherar dessa värden och konverterar dem till hakparenteser omgivna ackord.
<u>(.+?)</u>
Acordsstil
När innehål påträffas kan det vara inom hakparenteser eller det kan vara vanlig text med ackord över text. Du kan konfigurera här vilket format som förväntas från webbplatsen. Till exempel, om vi väljer hakparenteser och det tidigare ackordssmönstret används, omges de funna akkorden av hakparenteser.
Ta bort HTML-taggar
Medan de flesta ackordsöversikter på webbsidor skapas som vanlig text inom <pre></pre>-taggar, innehåller de ibland överflödig HTML-kod. Aktivera detta alternativ för att ta bort överflödig HTML-kod. Standardinställningen är av.