Difference between revisions of "Help:Contents/pt-br"

From Referata
Jump to: navigation, search
(Ajuda específica da aplicação: Marcações {{EN}})
(Category:Translations in progress)
Line 1: Line 1:
{{languages|Help:Contents}}
 
 
<big><strong>Bem vindo ao Referata!</strong></big> 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.
 
<big><strong>Bem vindo ao Referata!</strong></big> 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.
  
Line 131: Line 130:
  
 
You then add this filter to the "Authors" category, using the "Has filter" property.
 
You then add this filter to the "Authors" category, using the "Has filter" property.
 +
 +
{{languages|Help:Contents}}
 +
 +
[[Category:Translations in progress]]

Revision as of 13:43, February 2, 2011

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 EN, 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 EN.

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

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

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

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 diferente 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 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 diversos links importantes, incluindo:

  • um link para editar a barra lateral de seu wiki; para mais ajuda com isto, veja Editando 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 (isto é especialmente importante se você tem um wiki privado, pois nesse caso é a única maneira 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 propriedade. 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. Once the structure is in place, you can customize all you want - changing the look-and-feel of the entire wiki, of the various templates, and of the forms, and adding and changing fields. You should also add data to the site (using your new forms), to make sure that everything is displaying the way you would want it to.

For more help on data structure issues, see the Semantic Forms documentation; they are all explained further there.

Once you have some data on your site, you can also help users find data more easily:

  • Create filters. Your site will have an automatic drilldown page at 'Special:BrowseData'. By default, this page shows a list of all categories on the site, their subcategories, and the pages they each contain. However, you can add additional filters, to allow users to drill down on various properties of the pages in each category, like country, year, genre, theme, etc. The easiest way to create filters is to use the 'Special:CreateFilter' page.

For more help on the drilldown, see the Semantic Drilldown documentation.

An example

Let's go through a specific example of setting up a wiki from scratch. Let's say that you want to create a wiki that shows all the books you have at home. We'll go through the steps previously specified.

Figure out the data structure. You want two kinds of pages on your wiki: one for books, and one for authors. You decide that each book page should hold a title, an author name, a genre (or genres), a year of publication, and a number of pages; and that each author page should hold the author name, their country of origin, and a list of all the books they have written that are in your library.

Create properties. Properties are the basic building blocks of a semantic wiki - they hold a single value for a page.

Book Example

For books, we want to represent a book's title, author(s), genre(s), year of publication, and number of pages. That is five fields, also there is no need to create a property for the title, since the title of each page representing a book will be the title of that book. That leaves four fields, each of which require a defined property:

  • Author - using the "Create a property" page, you create a property called "Was written by", of type "Page" (since each author will have his/her own page).
  • Genre - you create a property called "Has genre", of type "String", and give it the following allowed values: "Art, Cookbook, Fiction, History, Poetry, Science".
  • Year of publication - you create a property called "Was published in year", of type "Number".
  • Number of pages - you create a property called "Has number of pages", of type "Number".

Author Example

For author pages, you only need to create one more property:

  • Country of origin - you create a property called "Is from country", of type "String".

Templates

You need to create two templates, one for books and one for authors:

Book Templates

Using the "Create a template" page, you create a template called "Book", and set it to define the category "Books". You add to it four fields, and for each field you specify three values: its field name in the template source code, its display label on each page, and the semantic field it populates. For the first field, you set the field name to be "Author", the label to be "Author" and the semantic field to be "Was written by"; for the second field, you set the three values to be "Genre", "Genre" and "Has genre"; for the third, you set the values to be "Year", "Year of publication" and "Was published in year"; and for the fourth field, you set them to be "Number of pages", "Number of pages" and "Has number of pages". For the "Genre" field, you also check the box saying that the field can hold a list of values, since you want to be able to select more than one genre for a given book.

Author Templates

Using the "Create a template" page, you create a template called "Author", and set it to define the category "Authors". You add to it a field for which you set the three values to be "Country", "Country of origin" and "Is from country". For this template, you also fill out the "aggregation" fields in the form, since you want each author page to list all the books the author has written. Under "Semantic property", you select "Was written by", and for "Title for list" you put "Books by this author".

Creating Forms

You need to create two forms, one for books and one for authors:

  • Books - using the "Create a form" page, you make a form called "Book", and add to it the template "Book". You do not do any further customizations on this form, but just save the form once you have created it.
  • Authors - using the "Create a form" page, you make a form called "Author", and add to it the template "Author". As before, you do not do any further customizations - you just save the page.

Creating Categories

You need to create two categories, one for books and one for authors; you have already specified these categories' names before:

  • Books - using the "Create a category" page, you make a category called "Books", and give it the default form "Book".
  • Authors - using the "Create a category" page, you make a category called "Authors", and give it the default form "Author".

Enable links to forms. You add the text "This property uses the form [[Has default form::Form:Author]]." to the "Was written by" property's page.

Add data. Using the new "Book" form, you create pages for some books; you check to make sure that both the form and the resulting pages look alright. Each book page will now have a red link to its author, that should point to the "Author" form for adding that author (you may need to refresh the page for the right link to show up). You can then add a few authors, either through these links or on the form page directly, to make sure that this setup works correctly too. Each created author's page should show a list of the books you've saved that have that person as the author.

Add links on sidebar and elsewhere. Your structures are now all set up, and you can add links to the sidebar for easy adding and viewing. You can add links to the "Book" and "Author" forms to make it easy to add new ones, and links to the "Books" and "Authors" categories to be able to see the full list of either one at a glance. See Help:Editing the sidebar for how to do this. You can also add these links to the main page and elsewhere.

Customize. You edit the form and template pages to make them more in look nicer, more in line with what you want the overall look of your site to be, and more informative.

Create filters. Using the "Create a filter" page, you create new filters to improve the drilldown in the "View data" page:

  • Books - you create four new filters:
    • "Author" - this filter covers the property "Was written by", and gets its values from the category "Authors".
    • "Genre" - this filter covers the property "Has genre", and gets its values from that property's enumerated values.
    • "Year" - this filter covers the property "Was published in year", and uses the time period "Year" for its values.
    • "Number of pages" - this filter covers the property "Has number of pages", and you specify the following values for it: "< 100", "101-200", "201-400", and "> 400".

You then add these four filters to the "Books" category, using the "Has filter" property.

  • Authors - you create one new filter:
    • "Country" - this filter covers the property "Is from country", and you specify for it the values of whatever countries you want.

You then add this filter to the "Authors" category, using the "Has filter" property.

Idioma: English  • français • português do Brasil