Kullanıcı Kılavuzu
İnternet Ayarları
İnternet ayarlarını yapılandırmak önemsiz bir görev değildir, ancak düzgün bir şekilde yapılandırıldığında uygulamada İnternet'ten içerik aramasına olanak tanır. OnSong bu ayarları sizin için sağlayamaz çünkü web sitesinin şartlarına ve kullanım koşullarına uygun olarak web sitesinin içeriğini kabul etmeniz ve kullanmanız gerekir. Bu ayarlar boş bırakılırsa, uygulamada İnternet arama özelliği devre dışı bırakılır ve bunun yerine OnSong'a Safari Uzantısı Ekle özelliğini kullanmanız gerekir.
Not: OnSong, içeri aktarılacak içeriği tanımlamak için Normal İfadeler adlı bir desen odaklı programlama dili kullanır. Doğru yazıldığında, bu karakter dizileri bir web sayfasının içeriğinden metin çıkarabilen desenler oluşturur. Normal İfadeler aşağıdaki desen özelliklerinde kullanılır.
OnSong'u aşağıdaki alanları kullanarak farklı web sitelerinde arama yapacak şekilde yapılandırabilirsiniz:
Arama Parametreleri
OnSong, İnternet'te içerik aramak için Microsoft Bing'i kullanır. Aramanızın sorgusu doğrudan arama motoruna iletilirken, aranacak etki alanı gibi arama için ek parametreler buraya iletilir. Aşağıdaki örnek aramaları belirli bir web sitesinin akorlar dizinine sınırlar:
site:http://www.domain.com/chords
Bing gelişmiş arama parametreleri hakkında daha fazla bilgi edinin
Başlık Deseni
Başlık deseni, bulunan sayfa içeriğinin başlık özniteliğine karşı uygulanır ve şarkının başlığını çıkarmak için kullanılır. Aşağıdaki örnek, web sayfasının tam başlığı olan Brown Eyed Girl By Van Morrison'dan Brown Eyed Girl başlığını çıkarır.
(.+?)(?=(( +Chords)|( +By)))
Byline Deseni
Byline deseni, bulunan sayfa içeriğinin başlık özniteliğine karşı uygulanır ve şarkının byline'ını veya sanatçısını çıkarmak için kullanılır. Aşağıdaki örnek, web sayfasının tam başlığı olan Brown Eyed Girl - Van Morrison'dan Van Morrision başlığını çıkarır.
(?<=[\-])(.+?)(?=\|+\s*)
İçerik Deseni
İçerik deseni, web sayfasının tam HTML içeriğinden şarkının içeriğini çıkarmak için kullanılır. Genellikle bu içerik HTML <pre></pre> etiketleri içine yerleştirilir. Aşağıdaki örnek, bulunan web sayfasının HTML içeriğindeki pre öğelerinden içeriği çıkarır.
(?<=<pre>)(.+?)(?=</pre>)
Akord Deseni
Bazı durumlarda akorlar HTML kullanılarak işaretlenir. OnSong ayrıca normal bir ifade deseni kullanarak akorları da bulabilir. Bu örnekte, HTML içinde akorları belirtmek için <u></u> etiketleri kullanılır. Aşağıdaki desen bu değerleri çıkaracak ve bunları parantez içine alınmış akorlara dönüştürecektir.
<u>(.+?)</u>
Akord Stili
İçerik bulunduğunda, parantez içine alınabilir veya lirik üzerinde akorlar kullanılarak düz metin olabilir. Web sitesinden beklenen biçimi burada yapılandırabilirsiniz. Örneğin, parantez içine alınmış seçeneğini seçersek ve önceki akord deseni kullanılırsa, bulunan akorlar köşeli parantezlerle çevrelenir.
HTML Etiketlerini Kaldır
Web sayfalarındaki çoğu akord tablosu <pre></pre> etiketleri içinde düz metin olarak oluşturulsa da, bazen gereksiz HTML etiketleri içerirler. Gereksiz HTML etiketlerini kaldırmak için bu seçeneği açın. Varsayılan değer kapalıdır.