Guia B\xE1sico do SPIP

SPIP \xE9 um Sistema de Publica\xE7\xE3o Para Internet distribuido sob a licen\xE7a GPL, ou seja, pode ser usado livremente por qualquer website, pessoa e ou empresa, podendo ser modificado, alterado e redistribu\xEDdo.

O presente tutorial n\xE3o tem a prente\xE7\xE3o de descrever todas as funcionalidades do sistema, mas sim ser uma introdu\xE7\xE3o para seu uso. Por isso este texto se limita somente a mostrar as fun\xE7\xF5es b\xE1sicas do sistema, o que ser\xE1 suficiente para a cria\xE7\xE3o um sitio de noticias ou um sitio de conte\xFAdo dinamico.

"Se queremos liberdade para criar, devemos exigir que nossas ferramentas sejam livres"

\xCDndice

Instala\xE7\xE3o

Pr\xE9 requesitos : apache, php4 e mysql

Pegue o pacote no site oficial do projeto (www.spip.net) ou por wget

wget http://www.spip.net/spip-dev/DISTRIB/SPIP-vx-x-x.zip (x corresponde ao n\xFAmero da vers\xE3o)

Copie o arquivo zip para /var/www ou em algum local que esteja previamente configurado no apache.

#cp SPIP-vx-x-x.zip /var/www

Descompacte o arquivo

# unzip SPIP-vx-x-x.zip

renomeie a pasta com o nome do seu projeto

# mv SPIP-vx-x-x projeto

entre na pasta e d\xEA permiss\xE3o para as pastas CACHE, IMG, ecrire e ecrire/data

# cd projeto
# chmod 777 -R CACHE IMG ecrire ecrire/data

O SPIP tem um sistema de instala\xE7\xE3o via web com uma interface muito simples. Abra o navegador web de sua prefer\xEAncia.

digite no navegador

http://localhost/projeto/ecrire

Primeira tela: Voc\xEA opta pelo idioma de sua pref\xEArencia, no caso Portugu\xEAs;

Segunda tela: \xC9 a configura\xE7\xE3o do mysql, ele pede o local do servidor, que normalmente \xE9 localhost, usu\xE1rio e senha;

Terceira tela: Apenas confirma\xE7\xE3o;

Quarta tela: Ap\xF3s a configura\xE7\xE3o o mysql, voc\xEA pode usar um banco de dados previamente criado ou criar um banco de dados com o nome do seu projeto no pr\xF3prio sistema de instala\xE7\xE3o.

Quinta tela: Apenas confirma\xE7\xE3o;

Sexta tela: Aqui voc\xEA configura o primeiro/a usu\xE1rio/a (no caso administrador/a do sistema), colocando nome, correio eletr\xF4nico, login e senha;

S\xE9tima tela: Confirma\xE7\xE3o de sucesso na instala\xE7\xE3o;

Oitava tela: Tela de acesso, coloque seu login;

Nona tela: Sua senha;

D\xE9cima tela: Interface do sistema de publica\xE7\xE3o.

Para acessar novamente o sistema de publica\xE7\xE3o, use seudominio/ecrire, ou seja, www.seudominio.org/ecrire e aparecer\xE1 a tela de acesso.

Sintaxe

O Spip trabalha de um forma simples: a partir de um desenho de um s\xEDtio em html, onde j\xE1 est\xE1 estabelecido o espa\xE7o em que ficar\xE3o as noticias din\xE2micas, voc\xEA insere uma sintaxe do programa que buscar\xE1 as informa\xE7\xF5es solicitadas no banco de dados, dados esses que s\xE3o inseiridos por meio do publicador.

O Spip organiza as informa\xE7\xF5es atrav\xE9s de rubricas, que s\xE3o as caixinhas aonde voc\xEA guardar\xE1 as informa\xE7\xF5es (ex.: suponha que voc\xEA queira ter uma se\xE7\xE3o artigos e outras noticias, ent\xE3o voc\xEA criar\xE1 duas se\xE7\xF5es, com os respectivos nomes, certinho?!), e quando voc\xEA quiser alguma informa\xE7\xE3o pe\xE7a para ele buscar nessa caixinha tal informa\xE7\xE3o.

Antes de mais nada vamos aprender a criar uma rubrica.

Entre no sistema de publica\xE7\xE3o, e na primeira tela voc\xEA encontrar\xE1 a op\xE7\xE3o "Atalhos". Clique em "Criar uma nova rubrica";

Na segunda tela surgir\xE1 um caixa de di\xE1logo. Na op\xE7\xE3o "T\xEDtulo" voc\xEA coloca o nome da rubrica; na op\xE7\xE3o "Dentro da Rubrica" voc\xEA pode criar sub-rubricas, mas no caso iremos criar uma rubrica chamada "conte\xFAdo" e ela deve ficar na "Raiz". Use o campo "Texto explicativo" se houver necessidade (se por acaso outras pessoas al\xE9m de voc\xEA usarem o sistema). Clique em validar. Pronto!, est\xE1 criada a nossa primeira rubrica. Agora crie outra rubrica chamada "noticias".

Conhecendo as sintaxes

Como citado acima, o Spip trabalha dentro de um html comum que usa as suas sintaxes. Vamos agora conhecer as principais:

#TITRE - para t\xEDtulo
#CHAPO - para cabe\xE7alho
#SOUSTITRE - para sub-t\xEDtulo
#NOM - para autor
#DATE - para data
#TEXTE - para texto
#LOGO_ARTICLE - para logo do artigo
#URL_ARTICLE - para link para o artigo

Se voc\xEA escreveu um artigo e quer que apare\xE7a na p\xE1gina principal do seu s\xEDtio o nome do artigo e um cabe\xE7alho basta indicar isso no campo separado para essa a\xE7\xE3o. Voc\xEA usar\xE1 a fun\xE7\xE3o:

<BOUCLE_1(ARTICLES){id_rubrique=1}{par date}{inverse}{0,1}>
<a href="#URL_ARTICLE">#TITRE</a>
#CHAPO
</BOUCLE_1>

Traduzindo: <BOUCLE></BOUCLE> \xE9 o comando para abrir a linguagem do publicador. O n\xFAmero \xE9 necess\xE1rio cada vez que um BOUCLE ser\xE1 inserido (mesmo que seja somente um, o que, no caso, ser\xE1 BOUCLE_1). Mas esse n\xFAmero \xE9 somente um exemplo, voc\xEA pode usar, por exemplo, <BOUCLES_artigo1> ou qualquer outro termo. {id_rubrique=1} \xE9 para ele busque na caixinha um que, no caso, \xE9 a rubrica conte\xFAdo. O termo {id_rubrique=2} refere-se \xE0 rubrica not\xEDcias. O termo {par date}{inverse} \xE9 um par\xE2metro para a exibi\xE7\xE3o por ordem de data (da mais recente para a mais antiga). Como termo {0,1} voc\xEA est\xE1 configurando a exibi\xE7\xE3o de somente um artigo. Para que apare\xE7am as cincos not\xEDcias mais recentes voc\xEA deve alterar para {0,5}. Com <a href="#URL_ARTICLE">#TITRE</a> voc\xEA pede para que apare\xE7a o nome do artigo e que este seja um link. Com #CHAPO voc\xEA exibe o cabe\xE7alho, um resumo de seu texto. </BOUCLE_1> fecha a linguagem.

Trabalhando com templates/exemplos

Embora o Spip use o c\xF3digo html comum, na sua configura\xE7\xE3o padr\xE3o as p\xE1ginas t\xEAm um outro nome. Por exemplo: ao inv\xE9s do padr\xE3o para a p\xE1gina inicial ser index.html o nome \xE9 sommaire.html. O termo rubrique.html designa as templates para as rubricas. Para um template alternativo (uma se\xE7\xE3o com desenho diferente da outra) use rubrique=1.html. Pode haver um template para cada rubrica, por exemplo, para ter um desenho espec\xEDfico para rubrica 2 voc\xEA cria uma p\xE1gina html com o nome rubrique=2.html. O mesmo acontece com artigos que usam o nome article.html. Se acaso voc\xEA quiser criar um template para cada article de determinada rubrica, basta cria-la com o nome article=1.html.

Agora vamos inserir dois artigos no publicador e depois trabalhar com o html+sintaxes

Publicando

Para publicar um artigo/noticias entre no sistema de publica\xE7\xE3o, v\xE1 em "Edi\xE7\xE3o do s\xEDtio" e depois em "Artigos" e em "Escrever um novo artigo".

Preencha os campos desejados. \xC9 importante preencher T\xEDtulo, cabe\xE7alho e colocar tudo na rubrica certa. Preenchido os campos basta clicar em validar.

Na tela seguinte, voc\xEA pode inserir um logo para o artigo, se acaso quiser um imagem como acompanhamento do t\xEDtulo e do cabe\xE7alho na p\xE1gina inicial como ilustra\xE7\xE3o. Para que o texto seja publicado do s\xEDtio (pois at\xE9 ent\xE3o ele est\xE1 numa caixinha tempor\xE1ria), voc\xEA deve escolher na op\xE7\xE3o "Este artigo ser\xE1 publicado em linha" e depois clique na op\xE7\xE3o modificar.

Se acaso quiser "modificar este artigo" haver\xE1 uma op\xE7\xE3o para inserir uma imagem no texto (que \xE9 diferente de inserir um logo para o artigo). Existe tamb\xE9m a op\xE7\xE3o para inserir documentos anexos. O Spip suporta mais de 20 formatos diferentes de textos, imagens e audio. Ao inserir um imagem ir\xE1 aparecer abaixo de uma minuatura da imagem algo como <img11|left>, o img11 \xE9 o n\xFAmero da imagem e left/center/right (esquerda/centro/direita) \xE9 a forma que alinhamento que voc\xEA quer que a imagem tenha no artigo.

Dicas

Mais informa\xE7\xF5es sobre o programa voc\xEA pode encontrar no site oficial do projeto, www.spip.net.

Dentro da pasta do projeto, aonde esta o sistema, h\xE1 exemplos do funcionamento do programa. Ele est\xE1 com *-dist.html, ou seja, sommaire-dist.html ou rubrique-dist.html, apenas alterando esse arquivos \xE9 poss\xEDvel entender o funcionamento das sintaxes usadas pelo programa.

Refer\xEAncias

Passeando pela net voc\xEA pode encontrar alguns sitios que usam o SPIP, como o sitio do Centro de Midia Independente de Nice/Fran\xE7a, Planeta Porto Alegre ou a publica\xE7\xE3o que desenvolveu a ferramenta para uso pr\xF3prio necessidade e disponibilizou-a como software livre uZine

SPIP - SYST\xC8ME DE PUBLICATION POUR L'INTERNET Sistema de Publica\xE7\xE3o para Internet www.spip.net

Sobre este manual

Este manual foi escrito por Banto. Este texto \xE9 integralmente regido pela GNU Free Documentation Licence:

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
Texts. A copy of the license is included in the section entitled "GNU
Free Documentation License".

-- VitoR - 03 Apr 2005