3df90fc9b8
Are you looking for something? Here is all of the GitHub Docs history in one single commit. Enjoy! 🎉
3.3 KiB
title, intro, redirect_from, product, permissions, versions
| title | intro | redirect_from | product | permissions | versions | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Configuring a publishing source for your GitHub Pages site | If you use the default publishing source for your {{ site.data.variables.product.prodname_pages }} site, your site will publish automatically. You can also choose to publish your{% if currentVersion ver_lt "enterprise-server@2.23" %} project{% endif %} site from a different branch or folder. |
|
{{ site.data.reusables.gated-features.pages }} | People with admin or maintainer permissions for a repository can configure a publishing source for a {{ site.data.variables.product.prodname_pages }} site. |
|
For more information about publishing sources, see "About {{ site.data.variables.product.prodname_pages }}."
Choosing a publishing source
Before you configure a publishing source, make sure the branch{% if currentVersion ver_lt "enterprise-server@2.23" %} or folder{% endif %} you want to use as your publishing source already exists in your repository.{% if currentVersion ver_lt "enterprise-server@2.23" %} 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 %}
{{ site.data.reusables.pages.navigate-site-repo }}
{{ site.data.reusables.repositories.sidebar-settings }}
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}
3. Under "{{ site.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 "{{ site.data.variables.product.prodname_pages }}", use the Source drop-down menu and select a publishing source.
{% endif %}
Troubleshooting publishing problems with your {{ site.data.variables.product.prodname_pages }} site
{{ site.data.reusables.pages.admin-must-push }}
If you choose the docs folder on {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %}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 {{ site.data.variables.product.prodname_pages }} sites."