Quantcast
Channel: jQuery Brasil
Viewing all articles
Browse latest Browse all 10

Como publicar um plugin no novo repositório do jQuery

$
0
0

Depois de meses fora do ar, finalmente o novo repositório oficial de plugins jQuery está no ar!

jq

Muita coisa mudou para você que já cria plugins jQuery e esse artigo está aqui para lhe ensinar como publicar seu plugin por lá.

Passo 0 – Crie seu plugin

Isso mesmo, se você caiu de paraquedas nesse artigo e nunca criou um plugin, essa é sua chance de começar. Use o jQuery Boilerplate e seja feliz :)

Passo 1 – Crie um Package Manifest

Crie um arquivo chamado nomeDoSeuPlugin.jquery.json, ele irá listar todas as informações sobre o seu plugin.

Fique à vontade para seguir o seguinte modelo:

{
  "name": "boilerplate",
  "title": "jQuery Boilerplate",
  "description": "A jump-start for jQuery plugins development.",
  "keywords": [
    "jquery",
    "boilerplate",
    "plugins"
  ],
  "version": "3.2.0",
  "author": {
    "name": "Zeno Rocha",
    "url": "https://github.com/zenorocha"
  },
  "maintainers": [
    {
      "name": "Zeno Rocha",
      "email": "zno.rocha@gmail.com",
      "url": "https://github.com/zenorocha"
    },
    {
      "name": "Addy Osmani",
      "url": "https://github.com/addyosmani"
    }
  ],
  "licenses": [
    {
      "type": "MIT",
      "url": "http://www.opensource.org/licenses/mit-license.php"
    }
  ],
  "bugs": "https://github.com/jquery-boilerplate/boilerplate/issues",
  "homepage": "http://jqueryboilerplate.com",
  "docs": "https://github.com/jquery-boilerplate/boilerplate#readme",
  "download": "https://github.com/jquery-boilerplate/boilerplate/archive/master.zip",
  "dependencies": {
    "jquery": ">=1.4"
  }
}

Se tiver qualquer dúvida sobre os atributos dele, visite esse link.

Passo 2 – Crie um repositório público no Github

Pode parecer estranho, mas esse é um passo obrigatório hoje. Eles assumiram que é preciso incorporar uma ferramenta de versionamento de código (Git) no processo de desenvolvimento. O que, por sinal, eu acho ótimo.

Então se você ainda não criou, vai lá e crie!

Passo 3 – Adicione um Post-Receive Hook

Agora que você tem seu repositório criado no Github, será preciso fazer uma configuração bem fácil por lá.

3.1 – Abre seu repositório no Github e vá para página “Settings”

3.2 – Clique em “Service Hooks”

3.3 – Clique em “WebHook URLs”

3.4 – Entre com a URL http://plugins.jquery.com/postreceive-hook e clique em “Update Settings”

Passo 4 – Publique uma versão

Novamente outro passo muito simples se você já é familiarizado com Git.

Basta criar uma tag com a versão:

git tag 0.1.0
git push origin --tags

Se você fez todos os passos direitinho, agora você já poderá ver seu plugin por lá \o/

Sempre que for atualizar seu plugin, basta publicar uma nova tag.

Problemas?

Se encontrar algum problema pelo caminho, consulte os canais oficiais de suporte:

  • Canal IRC: #jquery-content no freenode;
  • Email: plugins@jquery.com;

Mais informações


Viewing all articles
Browse latest Browse all 10