Felhasználói kézikönyv
Internetbeállítások
Az Internet-beállítások konfigurálása nem triviális feladat, de lehetővé teszi az alkalmazáson belüli Internet-tartalom keresését, ha megfelelően van konfigurálva. Az OnSong nem tudja biztosítani ezeket a beállításokat Ön számára, mivel szükséges, hogy elfogadja és a weboldal tartalmaát a weboldal használati feltételeivel összhangban használja. Ha ezek a beállítások üresen maradnak, az alkalmazáson belüli Internet-keresési funkció letiltva lesz, és a helyette a OnSong hozzáadása Safari-bővítmény használatára lesz szüksége.
Megjegyzés: Az OnSong egy mintaorientált programozási nyelvet használ, amelyet Reguláris kifejezéseknek neveznek, az importálandó tartalom meghatározásához. Helyesen megírva, ezek a karakterláncok olyan mintákat alkotnak, amelyek szöveget tudnak kinyerni egy weboldal tartalmából. A Reguláris kifejezéseket az alább található mintulajdonságok használják.
Az OnSong konfigurálható úgy, hogy különböző weboldalakon keressen az alábbi mezők segítségével:
Keresési paraméterek
Az OnSong a Microsoft Bingot használja az Internet tartalmának kereséséhez. Bár a keresési lekérdezés közvetlenül átadódik a keresőmotornak, további keresési paraméterek, például a keresendő tartomány is átadható itt. A következő példa a keresést egy adott weboldal akkord könyvtárára korlátozza:
site:http://www.domain.com/chords
Tudjon meg többet a fejlett Bing keresési paraméterekről
Cím minta
A cím mintát az encontrado oldal tartalmának cím attribútuma ellen hajtják végre, és a dal címének kinyerésére szolgál. A következő példa a „Brown Eyed Girl" kifejezést nyeri ki a weboldal teljes címéből, amely „Brown Eyed Girl By Van Morrison".
(.+?)(?=(( +Chords)|( +By)))
Szerzői minta
A szerzői mintát az encontrado oldal tartalmának cím attribútuma ellen hajtják végre, és a dal szerzői sorait vagy előadóját nyeri ki. A következő példa a „Van Morrison" kifejezést nyeri ki a weboldal teljes címéből, amely „Brown Eyed Girl - Van Morrison".
(?<=[\-])(.+?)(?=\|+\s*)
Tartalom minta
A tartalom mintát a dal tartalmának kinyerésére használják a weboldal teljes HTML-tartalmából. Jellemzően ez a tartalom HTML <pre></pre> címkékbe van helyezve. A következő példa az encontrado weboldal HTML-tartalmában szereplő pre elemekből nyeri ki a tartalmat.
(?<=<pre>)(.+?)(?=</pre>)
Akkord minta
Egyes esetekben az akkordok HTML segítségével vannak megjelölve. Az OnSong reguláris kifejezés minta segítségével is megkeresi az akkordokat. Ebben a példában HTML <u></u> címkék jelölik az akkordokat a HTML-ben. Az alábbi minta ezeket az értékeket kivonja és szögletes zárójelbe helyezett akkordokká alakítja.
<u>(.+?)</u>
Akkord stílus
Ha tartalomra kerül sor, lehet zárójelezve, vagy lehet egyszerű szöveg akkordokkal a dalszöveg felett.ここで a weboldaltól várt formátumot konfigurálhatja. Ha például a szögletes zárójelet választjuk és az előző akkord mintát használjuk, a talált akkordok szögletes zárójelek közé kerülnek.
HTML címkék eltávolítása
Míg a legtöbb akkordia weboldalak egyszerű szövegként kerülnek a <pre></pre> címkék közé, néha fölösleges HTML-címkéket tartalmaznak. Kapcsolja be ezt az opciót a fölösleges HTML-címkék eltávolításához. Az alapértelmezés az „ki" (off).