Help:Contents/pt-br

Bem vindo ao Referata! Referata é um serviço de hospedagem para wikis semânticos; esses são wikis que contém dados, e não apenas texto - dados que podem ser consultados, agregados, mapeados, exportados, etc. Em outras palavras, você pode pensar um wiki semântico como sendo um banco de dados colaborativo.

A maior parte desta página de ajuda é destinada a administradores de sites, não a usuários. Se você é um simples usuário, adicionar ou editar informação num wiki Referata pode ser, para você, até mais fácil do que num wiki comum, uma vez que tende a ser menos texto livre e mais dados estruturados; muitas vezes haverão formas de ajudar você com a edição.

Ajuda específica da aplicação
Referata usa a aplicação wiki chamada MediaWiki, juntamente com algumas de suas extensões.

Para um visão geral da aplicação MediaWiki, veja aqui.

Para ajuda com edição MediaWiki, veja o guia de edição básico e o guia de edição avançado.

Para ajuda com extensões individuais usadas por Referata, veja suas respectivas páginas de ajuda (todas em inglês):


 * Semantic MediaWiki
 * Semantic Result Formats
 * Semantic Forms
 * Semantic Drilldown
 * Semantic Google Maps
 * Widgets
 * Header Tabs
 * Replace Text

Confira também o Guia de Referência Rápida Semantic MediaWiki, disponibilizado como uma ou como um.

Para uma lista completa das extensões usadas em Referata, veja Special:Version.

Páginas para administradores
Se você é o administrador, ou um dos administradores, de um site Referata, você verá dois links adicionais no topo de qualquer página do site: "Site settings" (ainda não traduzido para português) e "Ligações para administradores". Cada um deles levará você a uma página especial que oferece funções administrativas.

A página "Site settings"
Esta página, localizada em /Special:SiteSettings, permite que você configure vários aspectos do site, tais como: nome, idioma, tema padrão, logo, etc.

Ela também permite que você defina diferentes níveis de privacidade: se o site pode ser lido por qualquer pessoa, ou se apenas por usuários registrados; se qualquer pessoa pode se auto-registrar, ou se o cadastramento pode ser feito apenas mediante convite; e se qualquer um pode editar páginas, ou apenas usuários, ou apenas administradores.

Na página também existem configurações relacionadas à extensão Semantic MediaWiki. Por exemplo, se o semantic infobox deverá ser mostrado na parte inferior de todas as páginas.

Por último, ainda é dada a possibilidade de você atualizar o nível de serviço do site, usando PayPal para realizar o pagamento.

A página "Ligações para administradores"
Esta página, localizada em /Special:AdminLinks, fornece links para criar ou visualizar propriedades, predefinições, categorias, formulários e filtros, além de outros links importantes, incluindo:


 * um link para editar a barra lateral de seu wiki; para mais ajuda com isto, veja a página sobre como editar a barra lateral
 * um link para editar o arquivo CSS global, para fazer mudanças no estilo
 * um link para mudar o nome da página principal de seu wiki (que por padrão é "Página principal")
 * um link "Criar um utilizador", para adicionar novos usuários (especialmente importante se você tem um wiki privado, sendo a única forma de adicionar usuários a seu site)
 * links para gerenciar usuários existentes, incluindo configurar suas permissões
 * um link "Substituir texto", que leva você a uma página onde se pode pesquisar e substituir texto globalmente, em todo o wiki

Criação de um site Referata
Uma vez que seu site Referata está ativado, é hora de criar as estruturas para manter, mostrar e habilitar adição e edição de seus dados. Felizmente tudo isso pode ser feito simplesmente criando várias páginas wiki. Você pode dar os passos seguintes:


 * Descobrir a sua estrutura de dados. Quais tipos de páginas seu site terá? Quais são os dados que estão contidos em cada um deles? Você pode mudar tudo isso mais tarde, mas para começar é bom ter um plano.


 * Criar propriedades. Os blocos de construção básicos de qualquer site semântico são as conexões entre os dados, que são conhecidas como propriedades. Uma propriedade é usada para especificar uma peça única de informação dentro do assunto da página. Toda propriedade usada deve ser definida em sua própria página, no namespace "Propriedade:", em seu wiki. A maneira mais fácil de fazer isto é usar a página Especial:Criar propriedade, que pode ser alcançada a partir da página "Ligações para administradores". Você também pode entrar diretamente a URL, adicionando Especial:Criar propriedade depois de .../wiki/ na URL de seu site.


 * Criar predefinições. Uma predefinição configura a exibição do dado numa página, estabelece a marcação usada para transformar os dados em informação semântica real, agrega dados relevantes de outras páginas, e (muitas vezes) define a página como sendo de uma determinada categoria, e portanto de um certo tipo de página. Geralmente se tem uma predefinição por tipo de página, embora algumas vezes um único tipo de página tenha mais de uma predefinição, especialmente quando alguns campos podem ter mais de um valor. A maneira mais fácil de criar predefinições é usar a página Especial:Criar modelo, que pode ser alcançada a partir da página "Ligações para administradores".


 * Criar formulários. Agora você pode criar formulários para permitir que usuários facilmente adicionem e editem páginas de vários tipos. Deve haver um formulário por tipo de página. Um formulário deve popular a predefinição ou as predefinições que este tipo de página tiver. Existe uma página especial para se criar novos formulários: Especial:Criar formulário; você pode alcançá-la a partir da página "Ligações para administradores".


 * Habilitar links para formulários. Uma vez que você tenha os formulários em algum lugar, você precisa ter maneiras para os usuários acessá-los. Essas incluem: adicionar links para adicionar dados, na barra lateral ou em outro lugar; habilitar a função que faz com que for editável com um formulário tenha uma aba 'editar com o formulário', no topo; e fazer com que os links vermelhos para páginas que não existem apontem para um formulário para criá-las.


 * Adicionar agregação. Você pode adicionar agregação para diferentes predefinições - mostrando todas as páginas que tiverem o mesmo relacionamento com a página ou um conjunto de valores. A página Especial:Criar modelo ajuda com adição de agregação, mas você pode sempre adicionar mais. Para mais informação sobre como fazer isso, veja a página consultas inline na Documentação Semantic MediaWiki.


 * Customizar. Uma vez que a estrutura esteja no lugar, você pode customizar tudo que você quiser - mudar o visual do wiki inteiro, das várias predefinições, e dos formulários, e adicionar ou mudar campos. Você também deverá adicionar dados aos site (usando seus novos formulários), para se certificar de que tudo esteja sendo mostrado da maneira que você quer que seja mostrado.

Para mais ajuda em questões sobre estruturas de dados, veja a documentação da extensão Semantic Forms; elas estão todas explicadas lá.

Uma vez que você tenha dados em seu site, você pode ajudar os usuários a encontrá-los mais facilmente:


 * Criar filtros. Seu site terá um página de exploração e detalhamento de dados, em  Especial:BrowseData </tt>. Por padrão, esta página mostra uma lista de todas as categorias existentes no site, suas subcategorias, e as páginas que cada uma delas contém. Portanto, você pode adicionar filtros, para permitir que os usuários façam detalhamento de dados em vários níveis, das propriedades das páginas de cada categoria, tais como país, ano, gênero, temas, etc. A maneira mais fácil de criar filtros é usando a página  Especial:Criar filtro </tt>.

Para mais ajuda sobre exploração e detalhamento de dados (drilldown), veja a documentação da extensão Semantic Drilldown.

Um exemplo
Vamos analisar um exemplo específico de criar um banco de dados wiki a partir do ZERO.

Vamos dizer que você queira criar um banco de dados wiki que mostre todos os livros que você tem em casa. Seguiremos os passos especificados anteriormente:

Descubra a estrutura de dados. Você quer dois tipos de páginas em seu wiki: um para livros, e outro para autores. Você decide que cada página de livro deve conter o nome de título, o nome do autor do livro, um gênero ao qual pertença o livro (ou vários gêneros), o ano da publicação, e o número de páginas que o livro tem; e você decide que cada página de autor deve conter o nome do autor, o país de origem do autor, e uma lista dos livros desse autor que estiverem em sua biblioteca.

Crie propriedades. Propriedades são os blocos de construção básicos de um wiki semântico - elas armazenam um único valor para uma determinada página.

Exemplo Livro
Para livros, queremos representar o título do livro, o(s) autor(es), o(s) gênero(s), o ano de publicação, e o número de páginas. Cinco campos.

Mas não é necessário criar uma propriedade para o título, já que o título de cada página que representa um livro será o título daquele livro. Assim, na realidade, teremos quatro campos na estrutura abstrata do banco de dados, cada um deles exigindo que uma propriedade seja definida:


 * Autor - usando a página "Especial:Criar uma propriedade", crie uma propriedade chamada "Escrito por", do tipo Page</tt>
 * Obs.: escolhemos o tipo Page</tt> por que cada autor terá sua própria página.


 * Gênero - crie uma propriedade chamada "Tem gênero", do tipo String</tt>
 * Dê à propriedade os seguinte valores permitidos: "Arte, Livro de receitas, Ficção, História, Poesia, Ciência".


 * Ano de publicação - crie uma propriedade chamada "Publicado no ano", do tipo Number</tt>.
 * Número de páginas - crie uma propriedade chamada "Tem o número de páginas", do tipo Number</tt>.

<i>Observação sobre padronização de código no idioma inglês (opcional)

Você pode "preferir", por questões de padronização de código, criar a estrutura de seu banco de dados usando palavras em inglês e sem acentos.

Por exemplo, em inglês, os pares campo/propriedade de nosso projeto-exemplo seriam:


 * Author &larr; "Was written by"
 * Genrer &larr; "Has genre"
 * Year &larr; "Was published in year"
 * Number of pages &larr; "Has number of pages"

Esta é uma boa prática! Torna mais elegante o código a ser usado nos formulários e nas páginas de consulta. Estes, juntamente com as predefinições, são as peças que realmente criam a interface do sistema com o usuário final (as telas). Seriam criadas para o seu idioma (português). E nas predefinições somente os rótulos precisariam estar em português.

Um ponto positivo e relevante, desta prática, é que com ela será mais conveniente para o seu projeto de definição de estruturas de dados ser compartilhado com o mundo, para permitir que outras pessoas aproveitem o seu projeto e o implantem em seus próprios wikis.

Para entender melhor, compare os pares exemplificados acima (em inglês) com as especificações de campos sugeridas para as predefinições deste exemplo.</i>

Exemplo Autor
Para páginas de autores, você somente precisa criar mais uma propriedade (referente ao campo "País de origem"):


 * País de origem - crie uma propriedade chamada "É do país", do tipo String</tt>.

Obs.: usando nomes de propriedades em inglês teríamos a correpondência País de origem &larr; "Is from country".

Predefinições
Você precisa criar duas predefinições, uma para livros e outra para autores:

Predefinição Livro
Usando a página Especial:Criar modelo</tt>, crie uma predefinição chamada "Livro", e configure ela para definir a categoria "Livros".

Adicione os campos da predefinição, especificando três valores em cada um deles:


 * Nome do campo &larr; valor que constará no código fonte da predefinição
 * Exibir rótulo &larr; valor a ser mostrado em cada página
 * Propriedade semântica &larr; valor que é o "campo semântico" populado pelo campo da predefinição

Especificação do 1º campo
Para este exemplo, no primeiro campo adicionado à predefinição Livro, você deve configurar:


 * Nome do campo = Autor</tt>
 * Exibir rótulo = Autor</tt>
 * Propriedade semântica = Escrito por</tt>

Especificação do 2º campo
Para este exemplo, no segundo campo a ser adicionado à predefinição Livro, você deve configurar:


 * Nome do campo = Gênero</tt>
 * Exibir rótulo = Gênero</tt>
 * Propriedade semântica = Tem gênero</tt>

Também marque a caixa que diz "Este campo pode manter uma lista de valores, separados por vírgulas".

Obs.: é necessário marcar essa caixa para que você possa selecionar mais de um gênero para um determinado livro.

Especificação do 3º campo
Para este exemplo, no terceiro campo a ser adicionado à predefinição Livro, você deve configurar:


 * Nome do campo = Ano</tt>
 * Exibir rótulo = <tt>Ano de publicação</tt>
 * Propriedade semântica = <tt>Publicado no ano</tt>

Especificação do 4º campo
Para este exemplo, no quarto campo a ser adicionado à predefinição Livro, você deve configurar:


 * Nome do campo = <tt>Número de páginas</tt>
 * Exibir rótulo = <tt>Número de páginas</tt>
 * Propriedade semântica = <tt>Tem o número de páginas</tt>

Predefinição Autor
Usando a página <tt>Special:CreateTemplate</tt>, crie uma predefinição chamada "Autor", e configure ela para definir a categoria "Autores".

Especificação do 1º campo
Neste exemplo, a predefinição Autor tem apenas um campo. Esse campo você deve configurar assim:


 * Nome do campo = <tt>País</tt>
 * Exibir rótulo = <tt>País de origem</tt>
 * Propriedade semântica = <tt>É do país</tt>

Nota: especificação de campos de predefinições já foi explicado no início da seção "Predefinição Livro", nesta página.

Campo de "agregação"
Você deve configurar o campo de agregação nesta predefinição, já que você quer que cada página de autor liste todos os livros que o autor escreveu e que estão em sua biblioteca.

Preencha a região "Agregração", nessa mesma página de criação de predefinição. Faça assim:


 * Propriedade semântica = <tt>Escrito por</tt>
 * Título para a lista = <tt>Livros deste autor</tt>

Criando formulários
Você precisa criar dois formulários, um para livros e outro para autores:


 * Livros - usando a página <tt>Special:CreateForm</tt>, faça um formulário chamado "Livro", adicionando a ele a predefinição "Livro".
 * Você não precisa fazer qualquer customização nesse formulário, apenas salve a página.


 * Autores - Usando a página <tt>Special:CreateForm</tt>, faça um formulário chamado "Autor", adicionando a ele a predefinição "Autor".
 * Você não precisa fazer qualquer customização nesse formulário, apenas salve a página.

Criando categorias
Você precisa criar duas categorias, uma para livros e outra para autores; você já especificou aqueles nomes de categorias antes:


 * Livros - usando a página <tt>Special:CreateCategory</tt>, faça uma categoria chamada "Livros", atribuindo a ela o formulário padrão "Livro".
 * Autores - usando a página <tt>Special:CreateCategory</tt>, faça uma categoria chamada "Autores", atribuindo a ela o formulário padrão "Autor".

Habilite links para formulários. Adicione o texto "Está propriedade usa o formulário Has default form::Form:Autor." à página da propriedade "Escrito por".

Adicione dados. Usando o novo formulário "Livro", crie páginas para alguns livros; certifique-se de tanto o formulário como as páginas de resultado pareçam direitos. Cada página de livro agora terá um link vermelho para seu autor, que deve apontar para o formulário "Autor", para que se possa adicionar aquele autor (talvez você precise atualizar a página para que o link seja mostrado direito). Você pode então adicionar alguns autores, ou através daqueles links ou acessando uma página com o formulário diretamente, para se certificar de que estas configurações estão funcionando corretamente. Cada página de autor que é criada deve mostrar uma de livros - aqueles que você salvou e que têm esta pessoa como o autor.

Adicione links na barra lateral e em outros lugares. Suas estruturas de dados estão agora configuradas, e você pode adicionar links à barra lateral, para facilmente editá-las ou visualizá-las. Você pode adicionar links para os formulários "Livro" e "Autor", para tornar fácil as pessoas acharem como adicionar novos autores ou novos links, e você pode adicionar links para as categorias "Livros" e "Autores", para possibilitar que as pessoas tenham acesso fácil a listas completas de livros ou autores. Veja como editar a barra lateral para saber como fazer isso. Você também pode adicionar aqueles links à página principal ou em outros lugares.

Customize. Edite o formulário e as páginas de predefinição para dar a eles um visual mais agradável, de acordo com a aparência que você quer dar ao seu site, e mais informativo.

Criando filtros
Crie filtros. Usando a página <tt>Especial:Criar filtro</tt>, crie novos filtros para melhorar a exploração/detalhamento de seu dados - o drilldrown - na página "Navegar pelo dados":

Filtros para Livros
Crie quatro filtros novos:


 * "Autor" - este filtro abrange a propriedade "Escrito por", e obtém seus valores a partir da categoria "Autores".
 * Ou seja, você deve optar por "Obter valores de filtro a partir desta categoria", escolhendo "Autores"


 * "Gênero" - este filtro abrange a propriedade "Tem gênero", e usa todos valores desta propriedade.
 * Ou seja, você deve optar por "Usar todos os valores desta propriedade no filtro".


 * "Ano" - este filtro abrange a propriedade "Publicado no ano", e usa intervalos de datas no período de tempo "Ano"
 * Ou seja, você deve optar por "Usar intervalos de datas para este filtro com este período de tempo", escolhendo "Ano".


 * "Número de páginas" - este filtro abrange a propriedade "Tem o número de páginas", e possui os seguintes valores: "< 100", "101-200", "201-400", and "> 400".
 * Ou seja, opte por "Introduza valores para o filtro manualmente (os valores devem ser separados por vírgulas - se um valor contém uma vírgula, substitua-a por "\,")" e entre os valores pelos quais você quer permitir filtrar. Sugestão: <tt>"<100", "101-200", "201-400", ">400"</tt>.

Então adicione aqueles quatro filtros à categoria "Livros", usando a propriedade "Has filter". Isso pode ser feito adicionando, no código da página da categoria, o seguinte:

Filtros para Autores
Crie um filtro novo:


 * "País" - este filtro abrange a propriedade "É do país", e possui os valores de sua preferência.
 * Ou seja, opte por "Introduza valores para o filtro manualmente (os valores devem ser separados por vírgulas - se um valor contém uma vírgula, substitua-a por "\,")" e entre os nomes dos países que você quer que o filtro possibilite filtrar. Por exemplo: <tt>"Brasil", "Agentina", "Estados Unidos", "França"</tt>.

Então adicione o filtro à categoria "Autores", usando a propriedade "Has filter", adicionando, no código da página da categoria, o seguinte: <tt> Has filter::Number of pages </tt>