44 lines
3.2 KiB
Markdown
44 lines
3.2 KiB
Markdown
---
|
|
title: Configuring a publishing source for your GitHub Pages site
|
|
intro: 'If you use the default publishing source for your {% data variables.product.prodname_pages %} site, your site will publish automatically. You can also choose to publish your{% ifversion ghes < 3.0 %} project{% endif %} site from a different branch or folder.'
|
|
redirect_from:
|
|
- /articles/configuring-a-publishing-source-for-github-pages/
|
|
- /articles/configuring-a-publishing-source-for-your-github-pages-site
|
|
- /github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site
|
|
product: '{% data reusables.gated-features.pages %}'
|
|
permissions: 'People with admin or maintainer permissions for a repository can configure a publishing source for a {% data variables.product.prodname_pages %} site.'
|
|
versions:
|
|
fpt: '*'
|
|
ghes: '*'
|
|
ghae: '*'
|
|
topics:
|
|
- Pages
|
|
shortTitle: Configure publishing source
|
|
---
|
|
|
|
For more information about publishing sources, see "[About {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)."
|
|
|
|
## Choosing a publishing source
|
|
|
|
Before you configure a publishing source, make sure the branch{% ifversion ghes < 3.0 %} or folder{% endif %} you want to use as your publishing source already exists in your repository.{% ifversion ghes < 3.0 %} For example, before you can publish your project site from the `/docs` folder on the `master` branch of your repository, you or a collaborator must create a `/docs` folder on the default `master` branch of your repository.{% endif %}
|
|
|
|
{% data reusables.pages.navigate-site-repo %}
|
|
{% data reusables.repositories.sidebar-settings %}
|
|
{% data reusables.pages.sidebar-pages %}
|
|
{% ifversion fpt or ghes > 2.22 or ghae %}
|
|
3. Under "{% data variables.product.prodname_pages %}", use the **None** or **Branch** drop-down menu and select a publishing source.
|
|
|
|
4. Optionally, use the drop-down menu to select a folder for your publishing source.
|
|
|
|
5. Click **Save**.
|
|
{% else %}
|
|
3. Under "{% data variables.product.prodname_pages %}", use the **Source** drop-down menu and select a publishing source.
|
|
|
|
{% endif %}
|
|
|
|
## Troubleshooting publishing problems with your {% data variables.product.prodname_pages %} site
|
|
|
|
{% data reusables.pages.admin-must-push %}
|
|
|
|
If you choose the `docs` folder on {% ifversion fpt or ghes > 2.22 or ghae %}any{% else %}the `master`{% endif %} branch as your publishing source, then later remove the `/docs` folder from that branch in your repository, your site won't build and you'll get a page build error message for a missing `/docs` folder. For more information, see "[Troubleshooting Jekyll build errors for {% data variables.product.prodname_pages %} sites](/articles/troubleshooting-jekyll-build-errors-for-github-pages-sites#missing-docs-folder)."
|