::Por Daniel Marquez Lisboa
Antes de nos aventurar no How To, umas breves FAQS:
O que é o Community Wiki?
Muito além dos foros existentes sobre o GeneXus e sua família de produtos, é o lugar que Artech criou, disponibilizou e automatizou para tornar a comunicação mais simples entre a companhia e seus usuários. De fato, é o web site mais importante para conseguir a informação mais atualizada sobre a família de produtos GeneXus. O Community Wiki não é nem mais nem menos que uma aplicação escrita com a GeneXus X Evolution 1, e já conta com sua terceira versão.
O que posso encontrar no Community Wiki?
É possível encontrar uma completa informação sobre o GeneXus, começando pela sua versão 9.0, especialmente, profusão de informações a respeito da GeneXus X e todas as funcionalidades de suas versões posteriores. Mas isso não é tudo: também é possível se achar documentos que explicam, passo a passo, como implementar essas funcionalidades. A Artech dispõe de uma equipe que está permanentemente atualizando e criando informações sobre as funcionalidades. Tudo está aí.
Qualquer usuário pode participar, colaborar?
Pode sim. É só se registrar com um nome de usuário, chave e mail e já está pronto para participar. Depois disso, vem a etapa da edição, da imaginação, da contribuição nas quais poder compartilhar com a Comunidade.
Entrando no How To, como faço para escrever um artigo?
Embora um Wiki possa ser considerado como um lugar anárquico, onde cada qual pode expor suas ideias e discussões de forma desordenada, o Community Wiki tem como finalidade “falar” sobre o GeneXus e suas ferramentas. Assim, para evitar que se instale essa tão temível “anarquia” e em benefício dos leitores, é recomendável ter claro o tema do que vais ser publicado. Depois, um bom título é fundamental, esse é o segundo passo para a criação de um documento; como exigência indispensável, o primeiro é se Logar com seu usuário e senha; depois, é com você.
Para criar um artigo novo, simplesmente pulse o link New Page e depois selecione o tipo de edição que deseja. E o que é isso? No Community Wiki, e entre os tipos mais importantes, você poderá criar:
Article:é um documento no qual expressar suas ideias; normalmente, a maioria das publicações num Wiki são artigos.
Image: quando você tiver necessidade de incluir uma imagem dentro de um artigo, ou simplesmente incorporá-la ao Community Wiki, deverá selecionar esta opção, embora esta não seja a única forma de fazê-lo, como poderá ver abaixo. Leve em conta que levantar uma imagem (bmp. jpg, etc.) avulsa, não contribui muito; normalmente será para embebê-la depois num artigo.
File:se você quiser incorporar um documento de formato forâneo, esta é a forma, e responde às mesmas recomendações que para o tipo Image.Você pode subir documentos de texto, de Word, Excel, etc.Felizmente para você, todos ficarão armazenados e protegidos na base de dados do Community Wiki.
Category::talvez este seja um dos pontos mais especiais dos Wikies.As categorias permitem aninhar Artigos dentro delas, e serão dependentes das mesmas.Em outras palavras, estarão pendurados na árvore da categoria.Por exemplo, você poderia criar a categoria “Specifications of User Controls” e depois categorizar aqueles documentos inerentes com esta categoria.Por sua vez, poderá haver categorias dentro de categorias, mas nenhuma perde sua prevalência por si mesma; ou seja, uma categoria pode estar dentro de outra e, por sua vez, ser categoria única de outro grupo de artigos:veja, por exemplo, o caso da categoria “Environment Preferences”; ela em si mesma é uma Categoria, mas por sua vez se encontra categorizada na categoria “Environments”.A categoria “Environment” tem dezenas de artigos e outras categorias pendurada a ela, e por sua vez, a categoria “Environment Preferences” também.Não existe impedimento nenhum a esse respeito.
Vídeo: ao igual que com as imagens e arquivos, você poderá levantar um vídeo no Community Wiki simplesmente. Neste caso, o vídeo deverá se hospedar em um site dedicado a este propósito, como o Youtube, Vimeo, Google Vídeo, e do Wiki simplesmente é copiada a informação para poder embeber o vídeo e uma página Wiki.
Editando
Quando você está criando ou alterando um artigo ou categoria, irá se apresentar uma caixa de texto que todo IT sabe usar. Escreva livremente e faça o formato do seu documento à discrição, utilizando a toolbar disponível (fonts, negrito, itálica, cores, etc.). Essa caixa de texto de que você dispõe não é nem mais nem menos que o tipo de dado FCKEditor que pode atribuir a um controle character no GeneXus (não esqueça que o Community Wiki é uma aplicação criada com a GeneXus X).
Na edição, você pode criar tanto links para outros documentos do próprio Community Wiki, como para o exterior (a web). Por exemplo, se você quiser pôr um link a outro artigo do tipo:
“Você pode obter maiores informações sobre isto aqui”.
e deseja que “aqui” seja o link ao artigo desejado, simplesmente clique no ícone Wiki Link da toolbar, depois na célula Type da janela que se abrirá selecione a que tipo de documento deseja fazer referência (Article, Category, etc; suponhamos que é um artigo). Depois, na célula Name, comece a escrever o nome do artigo (irão se mostrando os artigos existentes no Community Wiki com esse padrão à medida que escreve); suponha que deseja incluir “Environment Preferences”; selecione-o, e depois insira “aqui” na célula Description. Pronto.Você verá que é inserido o seguinte string no site onde estava situado o cursor:
[[Environment Preferences|aqui]]
Se “Environment Preferences” fosse uma categoria, o link inserido seria:
[[category:Environment Preferences|aqui]]
Se “aqui” tivesse que ser um link à web, escreva o texto íntegro no editor, depois ressalte a palavra “aqui” e pulse sobre o ícone “Insert/Edit Link”; depois insira a URL do site correspondente. Isso é tudo, GeneXus se encarregará do resto.
Mas, isso é tudo?
No que se refere a criar, é quase tudo o mais importante. De mais está dizer que você dispõe de um grupo de links, no topo do site, que o irão informando sobre as últimas páginas visitadas, as mais recentes, etc.
Mas também dispõe de um Search muito potente que lhe permitirá fazer as buscas que precisar. Tenha em conta o seguinte link que lhe ajudará a encontrar conteúdo de interesse.
http://wiki.gxtechnical.com/commwiki/servlet/hwikibypageid?6733
Resumindo
Enfim, vá em frente. Colabore com a comunidade, esclareça suas dúvidas; tudo, tudo está no Community Wiki. Isso foi apenas uma sinopse de como começar, sem entrar em maiores detalhes. Nas seguintes News, iremos complementado de forma mais profunda e detalhada as ações a levar adiante para que você possa obter documentos de alta qualidade.