Manual do utilizador
Definições de Internet
Configurar as definições de Internet não é uma tarefa trivial, mas permite pesquisar conteúdo da Internet na aplicação se configurado corretamente. OnSong não pode fornecer estas definições para si, uma vez que requer que concorde e utilize o conteúdo do site de acordo com os termos de utilização do site. Se estas definições forem deixadas em branco, a funcionalidade de pesquisa de Internet na aplicação fica desactivada e terá de utilizar a Extensão Safari Adicionar ao OnSong em alternativa.
Nota: OnSong utiliza uma linguagem de programação orientada por padrões chamada Expressões Regulares para definir conteúdo a importar. Quando escritas corretamente, estas cadeias de caracteres constituem padrões que podem extrair texto do conteúdo de uma página web. As Expressões Regulares são utilizadas nas propriedades de padrão abaixo.
Pode configurar OnSong para pesquisar em diferentes sites utilizando os seguintes campos:
Parâmetros de Pesquisa
OnSong utiliza Microsoft Bing para pesquisar conteúdo na Internet. Enquanto a consulta da sua pesquisa é passada diretamente para o motor de busca, parâmetros adicionais da pesquisa podem ser passados aqui, como o domínio a ser pesquisado. O exemplo seguinte limita a pesquisa ao diretório de acordes de um site específico:
site:http://www.domain.com/chords
Saiba mais sobre parâmetros avançados de pesquisa no Bing
Padrão de Título
O padrão de título é executado contra o atributo de título do conteúdo da página encontrada e é utilizado para extrair o título da canção. O exemplo seguinte extrai Brown Eyed Girl do título completo da página web, Brown Eyed Girl By Van Morrison.
(.+?)(?=(( +Chords)|( +By)))
Padrão de Assinatura
O padrão de assinatura é executado contra o atributo de título do conteúdo da página encontrada e é utilizado para extrair a assinatura ou artista da canção. O exemplo seguinte extrai Van Morrision do título completo da página web, Brown Eyed Girl - Van Morrison.
(?<=[\-])(.+?)(?=\|+\s*)
Padrão de Conteúdo
O padrão de conteúdo é utilizado para extrair o conteúdo da canção do conteúdo HTML completo da página web. Tipicamente este conteúdo é colocado em etiquetas HTML <pre></pre>. O exemplo seguinte extrai o conteúdo dos elementos pre no conteúdo HTML da página web encontrada.
(?<=<pre>)(.+?)(?=</pre>)
Padrão de Acordes
Em alguns casos, os acordes são marcados utilizando HTML. OnSong pode localizar acordes utilizando um padrão de expressão regular também. Neste exemplo, etiquetas HTML <u></u> são utilizadas para denotar acordes no HTML. O padrão seguinte extrairá esses valores e convertê-los-á em acordes entre parêntesis retos.
<u>(.+?)</u>
Estilo de Acordes
Quando o conteúdo é encontrado, pode estar entre parêntesis retos, ou pode ser texto simples utilizando acordes sobre letras. Pode configurar o formato que é esperado do site aqui. Por exemplo, se escolhermos entre parêntesis retos e o padrão de acordes anterior for utilizado, os acordes encontrados são rodeados por parêntesis retos.
Remover Etiquetas HTML
Embora a maioria dos diagramas de acordes em páginas web sejam criados como texto simples dentro de etiquetas <pre></pre>, por vezes contêm etiquetas HTML desnecessárias. Ative esta opção para remover etiquetas HTML desnecessárias. A predefinição está desactivada.