Configurando o plugin PHPDocumentor do Sublime text 2 em ambiente Windows

Olá pessoal

Uma dica simples para configurar o PHPDocumentor no Sublime Text 2:

1. Instalando o PHPDocumentor

– Baixe o projeto via PYRUS/PEAR

PYRUS

php pyrus.phar install pear/PhpDocumentor

PEAR

pear install phpdoc/phpDocumentor-alpha

– Baixe o projeto via git

git clone https://raw.github.com/phpDocumentor/phpDocumentor2/develop/installer.php

– Baixe o projeto via composer

No arquivo composer.json insira

"require": "phpdocumentor/phpdocumentor": "dev-develop"

2. Acesse o arquivo install.php

php installer.php

3. Vá no Sublime Text 2 > Preferences > Packages Settings >phpDocumentor > Settings - User e insira o código

"executable_path": "php pasta-onde-está-o-php-documentor\bin\\phpdoc.php"

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!

Espero ter ajudado.

Mini-curso: sublime text + git + github

Olá pessoal.

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.

Segue o slide da apresentação.

Obrigado pessoal e até mais!

Git + Github : Versionamento nunca foi tão simples!

Olá.

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

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'

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

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:

http://rogerdudler.github.com/git-guide/index.pt_BR.html

Valeu galera e até mais!