Wikibooks:Nomenclaturas

De Wikibooks

Com o objectivo de manter livros distintos, e evitar que este projecto se desorganize, o nome de cada página deve seguir as convenções apresentadas neste módulo. Em primeiro lugar, você pode imaginar a estrutura de um wikilivro da seguinte forma:

Índice

Introdução

Capítulo 1

Sub-capítulo 1.1

Sub-capítulo 1.2

Capítulo 2

Sub-capítulo 2.1

Esteja atento para os ítens em verde, pois eles indicam qual é a forma mais simples de organizar um wikilivro: Criar um índice, e distribuir o conteúdo em vários capítulos.

Alguns wikilivros têm a capa e o índice em uma mesma página, de modo que sua estrutura fique um pouco mais compacta:

Introdução

Capítulo 1

Sub-capítulo 1.1

Sub-capítulo 1.2

Capítulo 2

Sub-capítulo 2.1

Antes de iniciar a distribuição do conteúdo pelas páginas do projeto, é importante escolher um nome adequado para cada módulo do wikilivro, e somente depois disso criar as páginas propriamente ditas.

Uma forma de manter os diferentes módulos de um livro relacionados entre si é usar delimitadores. Os delimitadores servem para separar o nome de um módulo em "pedaços" que refletem a organização mostrada no exemplo acima.

[editar] Uso dos delimitadores

Em alguns livros mais antigos, você poderá encontrar módulos organizados com ":" (dois pontos):

Nome do livro: Índice

Nome do livro: Nome do capítulo

Nome do livro: Nome do capítulo: Nome do sub-capítulo

ou com uma mistura de ":" (dois pontos) e "-" (hífen):

Nome do livro: Índice

Nome do livro: Nome do capítulo

Nome do livro: Nome do capítulo-Nome do sub-capítulo

Note que após os dois pontos há um espaço em branco (que é opcional, embora aconselhável), mas em volta do hífen, não.

Alternativamente, se a capa e o índice ocupam uma mesma página:

Nome do livro: Nome do capítulo

Nome do livro: Nome do capítulo: Nome do sub-capítulo

No entanto, por motivos apresentados nesta discussão, ficou decidido pela comunidade que os novos livros e módulos devem utilizar como delimitador a barra ("/"). A principal vantagem é que, ao usar este delimitador, uma estrutura básica de navegação é criada automaticamente.

Com a mudança, antes de editar uma página existente, que possua os delimitadores ":" ou "-" e seja considerada orfã (ou esteja sem edição a algum tempo), deve-se movê-la para uma página que siga o padrão descrito a seguir:

• Para as capas: se houver uma capa, ela deve ter o próprio nome do livro.

Exemplo: História Europeia

• Para os índices:

Nome do livro/Índice (Neste caso, não se coloca espaço entre o nome e o tópico.)

• Para os capítulos:

Nome do livro/Nome do capítulo

• Para as diferentes partes do capítulo, se houver mais de uma:

Nome do livro/Nome do capítulo/Nome do tópico/Nome da secção/.../.../...

Exemplo: Biologia/Biologia celular/Células vegetais/Parede de células de celulose.

A adoção de uma convenção para as nomenclaturas facilita muito a organização e consulta do material no Wikilivros.

[editar] Criação de Wikilivros

Observemos como criar um livro dentro do projeto, para isso tomemos o seguinte conjunto de definições para o livro que pretende-se criar:

• Nome -> Nome do livro;
• Capítulos -> Índice, Capitulo 1, ... , Capitulo n.

Note que os capítulos devem começar com letra maiúscula.

Usando o formato recomendado, exposto no tópico acima, devemos seguir o seguinte procedimento:

Dentro da biblioteca devemos colocar os links para definir o nome do livro a ser editado futuramente da seguinte forma:

[[Nome do livro]] ou [[Nome do livro: Índice|Nome do livro]]

Na forma mais adequada, o link para [[Nome do livro]] é reservado para a capa quando não se usa o delimitador "/", conforme já explicado.

Para cada link de wikilivro, adota-se o indicador de progresso da edição, que consiste de uma imagem que fornece uma indicação da qualidade e densidade do conteúdo dentro do livro; esta imagem pode ser uma das seguintes:

[[Imagem:00%.svg]]

[[Imagem:25%.svg]]

[[Imagem:50%.svg]]

[[Imagem:75%.svg]]

[[Imagem:100%.svg]]

Que têm o seguinte significado:

Etapas de desenvolvimento do livro - 5 fases
Quase nenhum texto:	Texto em criação:	Texto em maturação:	Texto desenvolvido:	Texto abrangente:

Etapas de desenvolvimento do livro - 9 fases
Início:	Básico:	Criação:	Desenvolvimento:	Maturação:	Revisão:	Desenvolvido:	Finalização:	Finalizado:

[editar] Páginas organizadas com ":"

Devemos, então, criar um índice, para isso criamos, dentro da capa ou na biblioteca, um link para o índice:

[[Nome do livro: Índice|Nome do livro]] [[Imagem:00%.svg]]

Ao abrirmos este, para edição, colocamos os ítens como descrito abaixo:

#[[Nome do livro: Capítulo 1|Capítulo 1]]

.

.

.

.

#[[Nome do livro: Capítulo n|Capítulo n]]

Para cada '#' o servidor irá associar um número seqüencial, assim o índice é automaticamente enumerado.

[editar] Páginas organizadas com "/"

Devemos, então, criar um índice; para isso criamos, na biblioteca, um link para a Capa:

[[Nome do livro]] [[Imagem:00%.svg]]

Ao abrirmos este, para edição, colocamos os itens como descrito abaixo:

#[[Nome do livro/Capítulo 1|Capítulo 1]]

.

.

.

.

#[[Nome do livro/Capítulo n|Capítulo n]]

Quando adotamos um índice para o livro teremos, na biblioteca:

[[Nome do livro]] [[Imagem:00%.svg]]

ou

[[Nome do livro/Índice|Nome do livro]] [[Imagem:00%.svg]]

Colocamos dentro do índice os links:

#[[Nome do livro/Índice/Capítulo 1|Capítulo 1]]

.

.

.

.

#[[Nome do livro/Índice/Capítulo n|Capítulo n]]

Para cada '#' o servidor irá associar um número seqüencial, assim o índice é automaticamente enumerado.

Poupando tempo e trabalho:

Uma interessante e útil característica deste formato nos permite poupar tempo na elaboração de páginas, se criarmos links no índice da seguinte forma:

#[[/Capítulo 1/]]

.

.

.

.

#[[/Capítulo n/]]

O servidor coloca automaticamente a página Capítulo n dentro da estrutura [[Livro/Índice/Capítulo n]]; o mesmo acontece para links colocados dentro de capítulos e subcapítulos.

[editar] Categorização

Recomenda-se também a adição de categorias aos livros. De maneira geral, a categorização segue o padrão abaixo:

[[Categoria:Nome_da_categoria|Rótulo_do_indexador]]

O que nos habilita a fazer, por exemplo:

[[Categoria: Nome_da_categoria | Nome_da_subcategoria ]]

[[Categoria: Nome_da_subcategoria | Nome_do_livro ]]

[[Categoria: Nome_do_livro | Nome_do_capítulo ]]

[[Categoria: Nome_do_livro | N ]] 

• Note que, embora este último utilize como rótulo a letra inicial do nome que deseja-se indexar, ele tem o mesmo efeito que os anteriores.

No índice (ou na capa_índice) de cada Wikilivro, deve-se usar um caractere curinga (ou asterisco) (*):

[[Categoria: Nome_da_categoria | * ]]

[[Categoria: Nome_da_subcategoria | * ]]

[[Categoria: Nome_do_livro | * ]]

Processo:

O que fazemos normalmente é criar uma categoria para cada especialidade dentro de cada área, o índice, geralmente, deve conter todas as categorias (tanto a mestra como as especialidades) para facilitar o acesso a informação por parte de quem procura.

Exemplo:

O livro hipotético "Cadeias neurais" pode ser categorizado da seguinte maneira:

• No Índice: colocamos [[Categoria: Medicina | * ]], [[Categoria: Neurologia | * ]] e [[Categoria: Cadeiras neurais | * ]].

Veja que todas as categorias que enquadram o assunto a ser abordado no livro podem ser colocadas no mesmo. Aqui temos Medicina como a categoria mestra, mas também podemos colocar Neurologia dentro da definição da categoria Medicina.

• Nos capítulos: colocamos [[Categoria: Neurologia | Neurotransmissores ]] e [[Categoria: Cadeiras neurais | Neurotransmissores ]].

O efeito disso é que a categoria será indexada pelos rótulos "Índice", "biópsia", "Células","Neurônios", "Neurotransmissores"... e não pelo título do livro.

• Caso existam subcapítulos: podem ser criadas subcategorias para cada um, porém a critério do editor. No geral, se a densidade de tópicos do subcapítulo não for substancialmente grande não será necessária a criação de uma subcategoria específica para o subcapítulo; nestes casos coloca-se a página do subcapítulo na categoria do capítulo ao qual ele pertence