4. Faça o teste! Com o plugin “SideBarEnhancements” instalado, clique na pasta do projeto no sublime text com o botão direito e escolha a opção phpDocumentor > Generate Documentation e pronto! Código de documentação gerada!
Em uma iniciativa com um grupo de amigos montamos um grupo de estudos onde todos que participam trocarão conhecimentos. A coisa está fluindo divinamente com vários outros conteúdos como web semântica, ferramentas para gerenciamento de projetos, dentre outros.
Nesta sexta-feira tive a satisfação de ministrar um mini-curso sobre o editor sublime text + git + github, demonstrando a instalação do sublime text com a instalação do plugin de gerenciamento de pacotes, atalhos importantes do editor, criação de snippets e um setup inicial de trabalho com alguns plugins já instalados, mostrando as facilidades que cada um proporciona para o desenvolvimento e como instalálos diretamente via github e pelo plugin de gerenciador de pacotes.
Falei também sobre o conceito de versionamento distribuído do git e sua integração com o github, criando a chave ssh e cadastrando no perfil do github a chave gerada, disponibilizando um repositório para um projeto fictício e enviando alguns arquivos para o github, dentre outras coisas.
Tive algumas dificuldades em alguns projetos no quesito versionamento: Ou o sistema de versionamento não atendia as espectativas do grupo de desenvolvimento, ou o versionamento ocorria de forma precária, ou ele nem mesmo existia.
Pesquisando outras formas de versionamento que encontrei o GIT, uma ferramenta de versionamento de forma distribuída interessante, apesar do trocadilho com o nome (“git” em inglês britânico é uma gíria referente à “estúpido”) grandes projetos estão utilizando esta ferramenta. Juntamente com o Github, que foi criado com o objetivo de atender o versionamento dos projetos que usam o controle de versionamento do GIT, acabou tornando-se uma importante ferramenta de ajuda colaborativa.
Mas agora nos perguntamos: “Mas como é que isto funciona”? Pois bem, vamos pôr a mão na massa agora:
Primeiro vamos no site do git http://git-scm.com/download e fazemos o download do software (faça visando o seu sistema operacional.). No meu caso fiz o download do software para o Windows:
Site do projeto GIT
Com o download feito iremos instalar o git no computador. Utilizaremos a instalação padrão dele. Existe um roteiro inicial para a instalação disponível no link: http://help.github.com/win-set-up-git/
Este link passa o conteúdo de forma mastigada, então não entrarei em detalhes sobre este procedimento.
Agora em sua conta no github você vai criar um diretório com o nome de sua escolha ( EX: “diretorio-teste” ). Será nele que enviaremos o conteúdo do nosso projeto.
Criando diretório
Vamos abrir o GIT e vamos digitar os comandos:
cd “C:\Users\O-seu-usuario-no-computador\Desktop”
mkdir “diretorio-teste”
cd “diretorio-teste”
git init
O comando mkdir foi utilizado para criarmos a pasta com o nome “diretorio-teste” e o comando git init foi usado para iniciarmos o repositório GIT. Pronto! Iniciamos o nosso projeto. A partir daqui iremos fazer todas as modificações necessárias.
Basta clicar com o botão direito do mouse dentro da pasta e aparecerá a opção “Git Init Here” (usuários Windows)
Iniciando versionamento com ‘Git init Here’
Após isto você pode clicar clicar com o botão direito na opção ‘git gui’, que mostrará a visualização das alterações feitas no seu projeto.
Inicializando o Git GUI
Segue um vídeo que encontrei no youtube feito pelo ‘vedovelli‘ com o título ‘ Instalação do GIT no Windows 7 e primeiros passos no GitHub ‘
Agora segue um link em português que explica algumas operações básicas sobre o GIT: