Felhasználói kézikönyv
Internet-beállítások
Az internetes beállítások konfigurálása nem triviális feladat, de lehetővé teszi az alkalmazáson belüli internetről származó tartalom keresését, ha megfelelően van beállítva. Az OnSong nem tudja ezeket a beállításokat biztosítani, mivel szükséges, hogy Ön elfogadja és a webhely tartalmát a webhely használati feltételeivel összhangban használja. Ha ezek a beállítások üresen maradnak, az alkalmazáson belüli internetkeresési funkció letiltott, és helyette az Add To OnSong Safari Extension alkalmazást kell használnia.
Megjegyzés: Az OnSong egy mintaorientált programozási nyelvű Regular Expressions alkalmazást használ az importálandó tartalom meghatározásához. Helyesen megírt karakterláncok olyan mintákat alkotnak, amelyek szöveget tudnak kinyerni egy weboldal tartalmából. A Regular Expressions-t az alábbiakban felsorolt mintakezelésekben használják.
Az OnSong-ot úgy konfigurálhatja, hogy különböző webhelyeken keressen a következő mezők segítségével:
Keresési paraméterek
Az OnSong a Microsoft Bing szolgáltatást használja az internetről származó tartalom kereséséhez. Bár a keresési lekérdezést közvetlenül a keresőmotornak átadja, a kereséshez további paramétereket, például a keresendő tartományt is megadhat. Az alábbi példa a keresést egy adott webhely akkordkönyvtárára korlátozza:
site:http://www.domain.com/chords
Tudjon meg többet a Bing speciális keresési paramétereivel kapcsolatban
Cím minta
A cím minta a talált oldaltartalom cím attribútuma ellen hajtódik végre, és a dal címének kinyerésére szolgál. Az alábbi példa a Brown Eyed Girl címet nyeri ki az weboldal teljes címéből, Brown Eyed Girl By Van Morrison.
(.+?)(?=(( +Chords)|( +By)))
Byline minta
A byline minta a talált oldaltartalom cím attribútuma ellen hajtódik végre, és a dal byline-jának vagy művészének kinyerésére szolgál. Az alábbi példa a Van Morrision nevet nyeri ki az weboldal teljes címéből, Brown Eyed Girl - Van Morrison.
(?<=[\-])(.+?)(?=\|+\s*)
Tartalom minta
A tartalom minta a dal tartalmának kinyerésére szolgál a weboldal teljes HTML-tartalmából. Ezt a tartalmat általában HTML <pre></pre> címkékben helyezik el. Az alábbi példa a tartalmat a talált weboldal HTML-tartalmában lévő pre elemekből nyeri ki.
(?<=<pre>)(.+?)(?=</pre>)
Akkord minta
Egyes esetekben az akkordok HTML-jelölésűek. Az OnSong reguláris kifejezési mintával is megkeresheti az akkordokat. Ebben a példában HTML <u></u> címkéket használnak az akkordok jelölésére a HTML-ben. Az alábbi minta ezeket az értékeket és szögletes zárójelbe helyezett akkordokká konvertálja.
<u>(.+?)</u>
Akkord stílus
Amikor tartalommal találkozunk, lehet, hogy szögletes zárójelbe van téve, vagy lehet, hogy sima szöveg, amely akkordokat tartalmaz dalszövegek felett. Itt konfigurálhatja a webhely által várt formátumot. Például, ha a szögletes zárójelbe helyezettget választunk, és az előző akkordmintát használjuk, a talált akkordok szögletes zárójelek között szerepelnek.
HTML-címkék eltávolítása
Bár a legtöbb weboldali akkordtábla sima szövegként jön létre <pre></pre> címkék között, néha tartalmaznak extra HTML-címkéket. Ennek az opciónak az aktiválásával távolítsa el a felesleges HTML-címkéket. Alapértelmezettként ki van kapcsolva.
