Käyttöopas
Internet-asetukset
Internetin asetuksien määrittäminen ei ole triviaali tehtävä, mutta se mahdollistaa sisällön etsimisen Internetistä sovelluksessa, jos se on määritetty oikein. OnSong ei voi tarjota näitä asetuksia sinulle, koska se edellyttää, että hyväksyt ja käytät verkkosivuston sisältöä verkkosivuston käyttöehtojen mukaisesti. Jos nämä asetukset jätetään tyhjiksi, sovelluksessa oleva Internet-hakutoiminto on poistettu käytöstä ja sinun on käytettävä Lisää OnSong Safari -laajennukseen -toimintoa.
Huomio: OnSong käyttää säännöllistä lauseketta nimeltä ohjelmoitu Säännölliset lausekkeet määrittääkseen tuotavaa sisältöä. Kun ne on kirjoitettu oikein, nämä merkkijonot muodostavat malleja, jotka voivat poimia tekstiä verkkosivun sisällöstä. Säännöllisiä lausekkeita käytetään alla olevissa mallinnusominaisuuksissa.
Voit määrittää OnSongin etsimään eri verkkosivustoista seuraavien kenttien avulla:
Hakuparametrit
OnSong käyttää Microsoft Bingiä sisällön etsimiseen Internetistä. Vaikka hakukyselysi lähetetään suoraan hakukoneelle, hakuparametreja voidaan välittää myös täällä, kuten haettava verkkotunnus. Seuraava esimerkki rajoittaa haun tietyn verkkosivuston sointujen hakemistoon:
site:http://www.domain.com/chords
Lue lisää Bingin edistyneistä hakuparametreista
Otsikkomalli
Otsikkokuviota käytetään löydetyn sivun sisällön otsikko-ominaisuuksiin ja sitä käytetään laulun otsikon poimimiseen. Seuraava esimerkki poimii Brown Eyed Girl -tekstin verkkosivun täydestä otsikosta Brown Eyed Girl By Van Morrison.
(.+?)(?=(( +Chords)|( +By)))
Tekijöinnin malli
Tekijöinnin kuviota käytetään löydetyn sivun sisällön otsikko-ominaisuuksiin ja sitä käytetään laulun tekijöinnin tai artistin poimimiseen. Seuraava esimerkki poimii Van Morrision -tekstin verkkosivun täydestä otsikosta Brown Eyed Girl - Van Morrison.
(?<=[\-])(.+?)(?=\|+\s*)
Sisältömallia
Sisältömallia käytetään laulun sisällön poimimiseen verkkosivun täydestä HTML-sisällöstä. Yleensä tämä sisältö sijoitetaan HTML-tunnisteiden <pre></pre> sisälle. Seuraava esimerkki poimii sisällön löydetyn verkkosivun HTML-sisällön pre-elementeistä.
(?<=<pre>)(.+?)(?=</pre>)
Sointi malli
Joissakin tapauksissa soinnut on merkitty HTML-muodossa. OnSong voi paikantaa sointuja myös säännöllisen lausekkeen mallin avulla. Tässä esimerkissä HTML-tunnisteet <u></u> käytetään HTML:ssä sointujen merkitsemiseen. Seuraava malli poimii nämä arvot ja muuntaa ne suluissa oleviksi sointuiksi.
<u>(.+?)</u>
Sointi -tyyli
Kun sisältöä kohdataan, se voidaan sulkea hakasulkeisiin tai se voi olla pelkkää tekstiä, jossa on sointuja lyriikan yli. Voit määrittää tässä verkkosivustoista odotetun muodon. Esimerkiksi jos valitsemme sulkumerkit ja käytämme edellistä sointi-kuviota, löydetyt soinnut ympäröidään hakasulkeiden kanssa.
Poista HTML-tunnisteet
Vaikka useimmat verkkosivujen sointukaaviot luodaan pelkkää tekstiä varten <pre></pre>-tunnisteisiin, ne sisältävät joskus turhia HTML-tunnisteita. Ota tämä vaihtoehto käyttöön, jos haluat poistaa turhia HTML-tunnisteita. Oletusarvo on pois.