Can bitbucket.io be used to serve html pages from another branch?

[clx-evento-efhg]

I use "bitbucket.io" as described in https://confluence.atlassian.com/bitbucket/publishing-a-website-on-bitbucket-cloud-221449776.html to present static html pages to our users. these contain API reference documentation. I link to those pages from markdown documentation pages.

This works OK for the master branch. However, I also have other branches, representing previous versions of the API. Is it possible to refer to documents in other branches? I was hoping something like "https://clx-evento-efhg.bitbucket.io/{branchname}/ref/webframe.html" would work, but it doesn't. It just gives me a file not found error.

[Daniel Eads]

This question is pretty old but just confirming that we don't currently support publishing from a non-Master branch to bitbucket.io. The docs should be updated shortly to clarify this.

[Razoxane]

The documentation says it uses the main (master) branch of the repo for the pages.

If you change the main branch setting in Repository Details to a different branch, does the publishing use master, or the branch selected as the main for the repo? 

The wording of the documentation is ambiguous and open to interpretation.

If it is ONLY master, then the "main branch" wording needs to be removed

If it is whatever the "main branch" for the repo is, then the "master" wording needs to be removed.

[Daniel Eads]

Hey Jade,

You're correct - if you change the Main branch from the repository settings, whatever is selected as the main branch will be what's published. By default this is master, which is probably why it's worded the way it is now.

We'll have a technical writer take a look to try and clarify this in the documentation.

Cheers,
Daniel

[Razoxane]

Hi Daniel,

Thanks for clarifying.

Not sure if that helps the original poster, but for others, I changed my main branch to Develop, and the site used that branch in the .io site, so it works as you say above.

I'm using the main branch (set to Develop) as a staging site, and have just set up a deployment Pipeline to deploy to the FTP site whenever Master is committed to - exactly the setup I needed!