Gebruikershandleiding
Internetinstellingen
Het configureren van internetinstellingen is geen triviale taak, maar het stelt je in staat om in de app naar inhoud op internet te zoeken als het correct is geconfigureerd. OnSong kan deze instellingen niet voor je instellen omdat het vereist dat je akkoord gaat met en de inhoud van de website gebruikt in overeenstemming met de gebruiksvoorwaarden van de website. Als deze instellingen leeg worden gelaten, is de in-app zoekfunctie voor internet uitgeschakeld en moet je in plaats daarvan de Add To OnSong Safari Extension gebruiken.
Opmerking: OnSong gebruikt een patroon-georiënteerde programmeertaal genaamd Regular Expressions om inhoud te definiëren die moet worden geïmporteerd. Wanneer deze correct zijn geschreven, vormen deze tekenreeksen patronen die tekst uit de inhoud van een webpagina kunnen extraheren. Regular Expressions worden gebruikt in de patroon eigenschappen hieronder.
Je kunt OnSong configureren om verschillende websites te doorzoeken met behulp van de volgende velden:
Zoekparameters
OnSong gebruikt Microsoft Bing om naar inhoud op internet te zoeken. Hoewel de query van je zoekopdracht rechtstreeks naar de zoekmachine wordt doorgegeven, kunnen hier aanvullende parameters voor de zoekopdracht worden doorgegeven, zoals het domein dat moet worden doorzocht. Het volgende voorbeeld beperkt de zoekopdracht tot de akkoorden directory van een specifieke website:
site:http://www.domain.com/chords
Meer informatie over geavanceerde Bing zoekparameters
Titelpatroon
Het titelpatroon wordt uitgevoerd tegen het title kenmerk van de gevonden pagina-inhoud en wordt gebruikt om de titel van het nummer te extraheren. Het volgende voorbeeld extraheert Brown Eyed Girl uit de volledige titel van de webpagina, Brown Eyed Girl By Van Morrison.
(.+?)(?=(( +Chords)|( +By)))
Byline-patroon
Het byline-patroon wordt uitgevoerd tegen het title kenmerk van de gevonden pagina-inhoud en wordt gebruikt om de byline of artiest van het nummer te extraheren. Het volgende voorbeeld extraheert Van Morrision uit de volledige titel van de webpagina, Brown Eyed Girl - Van Morrison.
(?<=[\-])(.+?)(?=\|+\s*)
Inhoudspatroon
Het inhoudspatroon wordt gebruikt om de inhoud van het nummer uit de volledige HTML-inhoud van de webpagina te extraheren. Deze inhoud wordt meestal in HTML <pre></pre> tags geplaatst. Het volgende voorbeeld extraheert de inhoud uit de pre elementen in de HTML-inhoud van de gevonden webpagina.
(?<=<pre>)(.+?)(?=</pre>)
Akkoorden-patroon
In sommige gevallen worden akkoorden gemarkeerd met HTML. OnSong kan akkoorden ook lokaliseren met behulp van een regular expression patroon. In dit voorbeeld worden HTML <u></u> tags gebruikt om akkoorden in de HTML aan te duiden. Het volgende patroon extraheert die waarden en converteert ze naar accolade akkoorden.
<u>(.+?)</u>
Akkoordenstijl
Wanneer inhoud wordt aangetroffen, kan deze tussen accolades staan, of het kan gewone tekst zijn met akkoorden boven teksten. Je kunt hier de indeling configureren die van de website wordt verwacht. Als we bijvoorbeeld accolades kiezen en het vorige akkoorden patroon wordt gebruikt, worden de gevonden akkoorden omgeven door vierkante haakjes.
HTML-tags verwijderen
Hoewel de meeste akkoordenschema's op webpagina's als gewone tekst binnen <pre></pre> tags zijn gemaakt, bevatten ze soms overbodig HTML-tags. Schakel deze optie in om overbodig HTML-tags te verwijderen. Standaard uit.
