Etapa 3: Configurar o GitHub

Este texto foi traduzido usando IA. Se você deseja ver o texto original em inglês, clique aqui.

Recomendamos criar um repositório no GitHub para cada projeto em que você estiver trabalhando — seja um tema, um plugin ou um site completo. Você pode criar uma conta gratuita no GitHub e depois configurar quantos repositórios públicos ou privados quiser. O GitHub oferece a flexibilidade do controle de versão e pode sincronizar facilmente com seu site de produção ou staging no WordPress.com.

Existem várias formas de adicionar seu código a um repositório no GitHub, como usar a linha de comando. No entanto, recomendamos usar o GitHub Desktop, um aplicativo gratuito que funciona como uma interface gráfica para seus commits e pull requests. Ele permite que você interaja de forma prática com os arquivos do seu site local e os repositórios do GitHub por meio de uma interface visual intuitiva.

Os tutoriais abaixo abordam esse fluxo de trabalho.

Se você está trabalhando em um novo tema

Primeiro, você precisará criar um repositório local dentro da pasta do seu tema:

1. No GitHub Desktop, clique no botão “Create a New Repository on your Local Drive…” (Criar um Novo Repositório no seu Drive Local…) ou navegue até File > New Repository (Arquivo > Novo Repositório).
2. No campo “Repository Name” (Nome do Repositório), digite o nome do tema que você está desenvolvendo. Ele deve corresponder ao nome do tema na sua pasta wp-content/themes/.
3. No campo “Local Path” (Caminho Local), selecione a pasta wp-content/themes/ no seu site Studio (o caminho será algo como: /Users/user_name/Studio/site_name/wp-content/themes).
4. Clique em “Create Repository” (Criar Repositório).

Ao clicar no botão “Create Repository” (Criar Repositório), você terá criado um repositório local. Dois arquivos ocultos serão adicionados à pasta individual do seu tema (.git e .gitattributes). 

Agora você pode criar seu tema dentro deste repositório local.

Para publicar seu repositório local no GitHub:

1. Acesse o GitHub Desktop e clique no botão “Publish repository“.
2. Se você ainda não estiver conectado, será solicitado que faça login na sua conta do GitHub.
3. Dê um nome ao seu repositório público; você pode escolher qualquer nome, mas é uma boa ideia manter o mesmo nome da pasta do tema. Você também pode selecionar se deseja que seu código seja público ou privado usando a caixa de seleção fornecida. 
4. Clique em “Publish Repository“.

Após a publicação, você poderá ver seu repositório com o código do tema no GitHub.

Se você está trabalhando em um novo plugin

Primeiro, você precisará criar um repositório local dentro da pasta do seu plugin:

1. No GitHub Desktop, clique no botão “Create a New Repository on your Local Drive…” ou navegue até File > New Repository.
2. No campo “Repository Name“, digite o nome do plugin que você está desenvolvendo. Ele deve corresponder ao nome do plugin na sua pasta wp-content/plugins/.
3. No campo “Local Path“, selecione a pasta wp-content/plugins/ no seu site Studio (o caminho será algo como: /Users/user_name/Studio/site_name/wp-content/plugins).
4. Clique em “Create Repository“.

Ao clicar no botão “Create Repository“, você terá criado um repositório local. Dois arquivos ocultos serão adicionados à pasta individual do seu tema (.git e .gitattributes).

Para publicar seu repositório local no GitHub:

1. Acesse o GitHub Desktop e clique no botão “Publish Repository” (Publicar Repositório).
2. Dê um nome ao seu repositório público; você pode escolher qualquer nome, mas é uma boa ideia manter o mesmo nome da pasta do tema. Você também pode selecionar se deseja que seu código seja público ou privado usando a caixa de seleção disponível.
3. Clique em “Publish Repository” (Publicar Repositório).

Após a publicação, você poderá ver seu repositório com o código do plugin no GitHub.

Se você quiser sincronizar todos os arquivos de wp-content

Se você não está trabalhando em um plugin ou tema específico e deseja colocar um site completo sob controle de versão, recomendamos rastrear apenas o que está dentro da pasta wp-content. É nela que ficam armazenadas todas as suas personalizações que tornam seu site único. A maioria dos arquivos do núcleo do WordPress geralmente permanece inalterada e pode ser baixada novamente se necessário. O arquivo wp-config.php é uma exceção, pois contém detalhes essenciais de configuração, principalmente para a conexão com o banco de dados.

Primeiro, você precisará criar um repositório local na pasta wp-content do seu site:

1. No WordPress Studio, selecione seu site e clique na aba Visão geral.
2. Na seção “Abrir em…“, abra a pasta do site no editor de código de sua preferência.
3. Crie um arquivo chamado .gitignore dentro da pasta wp-content.
4. Adicione os seguintes nomes de pastas e arquivos a este novo arquivo .gitignore para evitar rastreá-los no seu repositório. Isso excluirá os plugins necessários pelo Studio, seu banco de dados SQLite e sua pasta de uploads. Por esse motivo, seus posts, páginas e imagens do site local não serão enviados ao seu site de produção.

mu-plugins
database
db.php
uploads

4. No GitHub Desktop, clique no botão “Create a New Repository on your Local Drive…” (Criar um Novo Repositório no seu Disco Local…) ou navegue até File > New Repository (Arquivo > Novo Repositório).
5. No campo “Repository Name” (Nome do Repositório), digite wp-content, para corresponder ao nome da sua pasta wp-content.
6. No campo “Local Path” (Caminho Local), selecione a pasta do seu site no Studio (o caminho será algo como: /Users/user_name/Studio/site_name).
7. Clique em “Create Repository” (Criar Repositório).

Depois de clicar no botão “Criar Repositório“, você terá criado um repositório local. Dois arquivos ocultos serão adicionados à pasta do seu tema individual (.git e .gitattributes).

Para publicar seu repositório local no GitHub:

1. Acesse o GitHub Desktop e clique no botão “Publish Repository” (Publicar Repositório).
2. Dê um nome ao seu repositório público; você pode escolher qualquer nome. Também é possível selecionar se deseja que seu código seja público ou privado usando a caixa de seleção disponível. 
3. Clique em “Publish Repository” (Publicar Repositório).